WeKnora 零基础部署完整指南：5 步拥有可问答的 RAG 知识库管理平台

WeKnora 零基础部署完整指南5 步拥有可问答的 RAG 知识库管理平台【免费下载链接】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团队文档散落在飞书、网盘和各种 wiki 里找一条知识往往比写它更费时间。WeKnora 是开源的 LLM 知识平台把原始文档变成可问答的 RAG、会推理的 Agent 和自动维护的 Wiki。WeKnora 部署并不复杂装好 Docker敲几条命令就能让整个系统跑在 http://localhost 上。它是怎么工作的容器里各跑着什么先搞清楚每个组件的分工出问题时你才知道该找谁负责。app 主服务端口8080承载全部业务逻辑对外提供 RESTful APIdocreader 解析器解析 PDF、Word、Excel 等十余种格式通过 gRPC 与主服务通信PostgreSQLParadeDB Redis业务数据与向量存储外加缓存、会话与任务队列frontend基于 Vue 的 Web 界面端口80负责知识库管理与问答MinIO、Neo4j、Langfuse 等可选组件可用--profile单独开启默认部署不占额外资源。 WeKnora Docker 安装从环境检查到一键启动读完本节你会得到一个打开浏览器就能用的系统。确认 Docker 环境与端口装好Docker含 Compose和Git确认80、8080端口空闲用本地 Ollama 的话Ollama 服务要能连通。先跑仓库自带的自检./scripts/start_all.sh -c按顺序执行 WeKnora 部署命令git clone https://gitcode.com/GitHub_Trending/we/WeKnora cd WeKnora cp .env.example .env docker compose pull docker compose up -d.env从模板复制而来按需修改数据库、存储与模型up -d拉起全部核心容器首次拉镜像需几分钟。30 秒验证部署是否成功docker compose ps所有容器应为Up主服务状态healthy。浏览器打开 http://localhost 出现登录页即成功后端 API 在 http://localhost:8080。⚙️ 个性化配置开发与生产两种场景读完你能分清开发、生产各该改.env里哪几个变量。开发调试LOG_LEVELdebug输出详细日志LLM_DEBUG_LOGtrue把大模型调用落盘便于对比频繁改代码可用快速开发模式分别起前后端见 快速开发模式说明生产部署DISABLE_REGISTRATIONtrue关闭公开注册配合空间 RBAC 与邀请制控制写入权限WEKNORA_VERSION固定到具体版本号升级先docker compose pull再up -d避免缓存旧镜像⚠️ 常见问题快速诊断读完你能独立处理部署后的多数故障。1. 文档上传成功提问却没回答现象解析正常但问答报错。原因.env没配 LLM 或 Embedding 模型。解决补齐INIT_LLM_MODEL_NAME、INIT_EMBEDDING_MODEL_NAME等变量后重启app容器。2. 回答里图片链接失效现象图片 404。原因MinIO 没启动或MINIO_PUBLIC_ENDPOINT仍指向 localhost。解决加--profile minio启动并把 endpoint 换成本机实际 IP。3. 刚保存的配置又变回去现象保存几秒后页面回退。原因浏览器代理、缓存或插件改写了请求。解决关闭代理与插件换无痕窗口重存。4. 文档长时间卡在「处理中」现象解析任务一直不结束。原因解析、切分或向量化某阶段挂死。解决打开文档 Trace 时间线定位阶段、可中止解析再用docker compose logs -f app看日志。 命令速查日常运维命令复制即用。操作命令环境健康检查./scripts/start_all.sh -c一键启动全部服务./scripts/start_all.sh停止所有服务./scripts/start_all.sh --stop查看容器状态docker compose ps跟踪主服务日志docker compose logs -f app停止并移除容器docker compose down常用目录部署脚本 · 配置目录 · 常见问题排查下一步做什么先上传一个 PDF 问一个问题回答带引用说明解析、向量化、检索、生成整条链路都通了。之后按需加--profile neo4j开知识图谱或--profile langfuse查看调用链路更多细节见 docs/QA.md。【免费下载链接】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），仅供参考