WeKnora 部署实战：从 clone 到跑通一次完成，附避坑清单

WeKnora 部署实战从 clone 到跑通一次完成附避坑清单【免费下载链接】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 部署跑起来。把 WeKnora 跑起来的最短路径先说结论三条命令剩下的交给脚本。git clone https://gitcode.com/GitHub_Trending/we/WeKnora cd WeKnora cp .env.example .env ./scripts/start_all.shstart_all.sh会自动检查 Docker 环境、补齐缺失的.env然后拉起容器宿主机没装 Ollama 时它也会顺手装上Ollama 是跑本地模型的进程WeKnora 用它做向量化和对话。你唯一要提前想清楚的配置是模型用本地 Ollama还是 UI 里填第三方 API Key。其余默认值都合理第一次跑不用动。启动后怎么确认没出问题别只看容器都起来了给你三个可验证的信号容器状态docker compose ps里 app、frontend、docreader、postgres、redis 都是 runningapp 一栏健康检查显示 healthy——compose 里配了/health探针它过了才算真启动。API 探活curl -i http://localhost:8080/health返回 200。界面可达浏览器打开http://localhost:80看到登录/注册页首次会进初始化向导选模型厂商、填 Key。三个信号都过了上传一份 PDF建知识库问它一句有回答就闭环了。按你的使用场景做三档配置改配置都发生在.env里改完docker compose up -d重启对应容器即可。档位改什么为什么本地试玩不用改存储默认local文件落在data-files卷Ollama 地址默认指向宿主机11434开箱即用小团队共享加 profile 启动docker compose --profile minio --profile neo4j up -d.env里设STORAGE_TYPEminio、NEO4J_ENABLEtrue本地存储挂在单机目录上多人共享换 MinIO 对象存储知识图谱功能依赖 Neo4j 容器生产DB_PASSWORD、REDIS_PASSWORD、JWT_SECRET、SYSTEM_AES_KEY全部换成随机强值SYSTEM_AES_KEY必须 32 字节DISABLE_REGISTRATIONtrue数据库密码和密钥有默认示例值直接对外就是裸奔AES 主密钥丢了库里的加密字段永久无法解密所以要备份好这几个坑最容易被踩1. 80 端口被占用前端起不来现象frontend 容器反复重启浏览器打不开http://localhost:80。 原因机器上已经跑着 Nginx 或其他占 80 端口的服务。 解法.env里改FRONTEND_PORT8081重启 frontend 容器。2. 首次启动等得人心慌现象脚本跑了十几分钟没反应docker compose ps是空的。 原因首次要拉取 app、frontend、docreader、paradedb 等多个大镜像。 解法提前docker compose pull单独拉镜像或用./scripts/start_all.sh -d只起容器、跳过 Ollama 部分。3. 服务全绿但问答没有反应现象知识库建好了提问转圈或报模型错误。 原因Ollama 没起、没拉模型或者 UI 里没绑定对话模型。 解法curl http://localhost:11434/api/tags确认有模型再回 UI 把对话/向量模型配好OLLAMA_OPTIONALtrue默认不阻断启动所以模型没配它也不会报错。4. 数据丢了现象重新部署后知识库全空。 原因用了docker compose down -v-v会连 postgres 数据卷一起删掉。 解法停服务只用docker compose down定期用docker compose exec postgres pg_dumpall备份。接下来可以往哪走开--profile langfuse给每次问答链路加可观测追踪配置见 docs/Langfuse集成.md。接企业微信、飞书、Slack 等 IM 渠道把问答能力推到聊天工具里。申请 API Key 或部署 MCP Server--profile full让你的程序直接调用这套知识库。【免费下载链接】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），仅供参考