WeKnora 部署指南3 条命令本地跑通 LLM 知识库的完整路径【免费下载链接】WeKnoraOpen-source LLM knowledge platform: turn raw documents into a queryable RAG, an autonomous reasoning agent, and a self-maintaining Wiki.项目地址: https://gitcode.com/GitHub_Trending/we/WeKnoraWeKnora 是一个开源 LLM 知识平台能把原始文档变成可检索的 RAG、能自主推理的 Agent、以及自我维护的 Wiki。如果你的文档散落在各个角落、想找一份历史资料全靠人肉翻这套 Docker 化部署方案值得花 15 分钟跑一遍。一条命令跑通最小服务先说结论不需要手动建.env。启动脚本检测到没有.env时会自动从.env.example复制一份默认配置。所以最短路径就三步git clone https://gitcode.com/GitHub_Trending/we/WeKnora cd WeKnora ./scripts/start_all.sh脚本会依次做这些事检查 Docker 环境 → 从模板生成.env→ 拉取镜像并docker compose up→ 顺带在后台预拉取 Agent Skills 用的 sandbox 镜像不阻塞启动。跑完你该看到什么终端打印两个地址并且持续滚动容器日志前端界面http://localhost:80API 接口http://localhost:8080浏览器打开前端能注册登录、上传文档就算跑通了。确认容器状态随时用docker compose ps想停掉全部服务./scripts/start_all.sh --stop只诊断环境不启动./scripts/start_all.sh --check。值得动的手只有这 3 个配置先别急着翻 700 多行的.env.example绝大多数默认值都能直接用。真正影响日常体验的只有下面三处。1. 向量库驱动RETRIEVE_DRIVER.env默认postgres也就是直接跑在 ParadeDB 里零额外依赖推荐保持不动。如果你已经有 Qdrant 或 Milvus 集群改这一行再启动对应 profile 即可docker compose --profile qdrant up -d2. LLM 地址OLLAMA_BASE_URL.env默认指向http://host.docker.internal:11434即宿主机的 Ollama。start_all.sh没装 Ollama 时会自动装。如果你的模型服务在另一台机器上直接改成远程地址即可脚本检测到非本机地址会自动跳过安装。3. 分块参数config/config.yaml这个文件被直接挂载进 app 容器改完重启 app 生效knowledge_base: chunk_size: 512 # 分块大小 chunk_overlap: 50 # 块间重叠chunk_size调大检索粒度更粗、回答更连贯调小则切分更细、定位更准。默认 512 对中英文混合文档都比较稳没有明确问题就别动。另外两个知道即可的项STORAGE_TYPE默认local文件落在容器卷里要对象存储再开 minio/s3 profile开知识图谱需要NEO4J_ENABLEtrue加docker compose --profile neo4j up -d完整流程见 开启知识图谱指南。高频问题速查端口 80 / 8080 被占了怎么办改 .env 里的 FRONTEND_PORT 或 APP_PORT 后重新 docker compose up -d。先 ss -tlnp | grep :80 确认谁占着端口常见是 Nginx。提示 docker: permission denied把当前用户加进 docker 组sudo usermod -aG docker $USER然后重开终端生效。报 command not found 则是没装 Docker。镜像拉取很慢或网络不通离线/内网环境先在有网机器上 docker compose pull 再 docker save 迁移然后用 ./scripts/start_all.sh --no-pull 启动。构建镜像慢时可以设 APK_MIRROR_ARG / APT_MIRROR 走国内镜像源。app 容器反复重启前端一直打不开app 的 depends_on 要求 postgres 和 docreader 都通过 healthcheck 才启动所以先 docker compose logs docreader postgres 定位是谁不健康。常见原因是 .env 里 DB_PASSWORD 与 postgres 卷里已初始化的库对不上——删掉 postgres-data 卷重来会丢数据慎操作。上传文档后解析卡住或失败看 docker compose logs app再确认 OLLAMA_BASE_URL 可达curl $OLLAMA_BASE_URL/api/tags。批量任务还有 Asynq 队列兜底WEKNORA_DOCUMENT_PROCESS_TIMEOUT 可调任务总超时。生产加固清单从自己玩到给团队用上线前把这 6 项过一遍改掉全部默认密码DB_PASSWORD、REDIS_PASSWORD、MINIO_SECRET_ACCESS_KEY.env.example里都是明文示例值生成真实的SYSTEM_AES_KEY32 字节随机——它加密库里所有 API Key丢失后已加密数据不可恢复DISABLE_REGISTRATIONtrue关闭自助注册按需走邀请或 OIDCGIN_MODErelease保持默认禁 SwaggerLOG_LEVEL调成info前端 80 端口挂 Nginx 反向代理并启用 HTTPS不要裸奔定期备份postgres-data命名卷docker run --rm -v .../postgres-data:/data alpine tar czf /data/backup.tgz ...这是唯一的数据源下一步跑通之后几个自然延伸的方向把config/builtin_models.yaml建好从 example 复制让新空间开箱就有模型可用接 Langfuse 做 LLM 调用观测compose 里已内置 profile以及了解 Lite 版与标准版的差异判断你的场景是否真的需要这套多服务架构。配置全景在 .env.example 里有逐项中文注释遇到具体报错可以先在里面搜关键词。【免费下载链接】WeKnoraOpen-source LLM knowledge platform: turn raw documents into a queryable RAG, an autonomous reasoning agent, and a self-maintaining Wiki.项目地址: https://gitcode.com/GitHub_Trending/we/WeKnora创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考