尧图网页设计 
WeKnora 本地部署5 步从空机器到能问答的文档知识库【免费下载链接】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 知识库、能自主检索的 ReAct Agent还有一份自维护的 Wiki。适合想在本地先跑通、或打算给团队搭文档问答服务的人。全程就 3 条命令# 克隆仓库并复制环境变量模板容器启动时读取 .env git clone https://gitcode.com/GitHub_Trending/we/WeKnora cd WeKnora cp .env.example .env # 拉取镜像并启动核心服务frontend、app、postgres、redis、docreader 等 docker compose pull docker compose up -d前提是装好 Docker 和 Docker Compose别的什么都不用装。跑起来的 5 个步骤第 1 步确认 .env 已就位上面的命令已经帮你cp .env.example .env。端口、数据库账号、模型地址全在这一个文件里。不改任何配置也能直接跑因为模板里的默认值本地存储 内置 postgres就是可用的。第 2 步端口冲突才需要改端口默认前端占 80、后端 API 占 8080。如果你的 8080 已被其他服务占用改一下再启动# 把 .env 里的后端端口改成 8000避免和其他服务抢 8080 sed -i s/^APP_PORT8080/APP_PORT8000/ .env第 3 步验证服务健康# 查看容器状态frontend 要等 app 通过健康检查才会放行 docker compose ps另外curl http://localhost:8080/health返回 200 就说明后端起来了。首次启动要拉镜像耐心等一两分钟。第 4 步打开界面上传第一篇文档访问 http://localhost按向导建账号、建知识库随便传一个 PDF 或 Word。等文档解析完成向它提个问题能拿到带引用来源的答案就算跑通了第 5 步可选接本地 Ollama 模型想省云 API 费用、用本地模型的话先起 Ollama# 后台启动 Ollama.env 默认地址指向 Docker 宿主机 ollama serve /dev/null 21 .env里OLLAMA_BASE_URL默认是http://host.docker.internal:11434Ollama 装在别的机器就改成对应地址。最容易配错的 5 个配置项配置项这是什么为什么要关心推荐值APP_PORT/FRONTEND_PORT后端、前端宿主机端口端口冲突时页面 502 或 API 连不上默认 8080 / 80被占就改APP_PORTSTORAGE_TYPE文件存储后端改成minio却不启动 minio profile上传会全部失败本地体验用默认localOLLAMA_BASE_URLOllama 服务地址换机器不改它模型配置必然失败默认值假设 Ollama 和 Docker 同机默认http://host.docker.internal:11434不用本地模型就留空不启用MAX_FILE_SIZE_MB单文件上传上限属部署期配置Go、Nginx、docreader、浏览器四层启动时各读一次改完必须重启全部容器才生效默认 50扫描件大文件可调大WEKNORA_VERSION镜像标签只跑docker compose up -d会复用本地缓存镜像UI 和后端版本会脱节升级时先docker compose pull再up -d出问题了4 个高频故障1. 打开 http://localhost 报 502 或空白页现象frontend 容器显示在跑页面就是打不开原因app 容器还没通过健康检查frontend 默认要等它 healthy解决docker compose logs -f app docreader postgres找 ERROR修好后docker compose restart app2. 文档上传成功但提问报模型错误现象上传流程走完了问答环节直接报错原因对话模型或 Embedding 模型没配置完整解决在.env补齐INIT_LLM_MODEL_NAME、INIT_EMBEDDING_MODEL_NAME含向量维度和模型 ID本地模型再确认 Ollama 在跑然后docker compose up -d重启3. 多模态知识库里的图片不显示现象文档解析出图了界面显示无效链接原因没启用 minio profile或MINIO_PUBLIC_ENDPOINT还是localhost解决docker compose --profile minio up -d要从别的设备访问图片把该变量改成机器实际 IP4. PaddleOCR 在部分平台启动失败现象扫描件或图片文档解析报错docreader 日志有 OCR 启动失败原因OCR_BACKENDpaddle不被当前平台支持解决docreader 服务里改OCR_BACKENDvlm并配外部 VLMOCR_API_BASE_URL/OCR_API_KEY/OCR_MODEL或干脆删掉 OCR 配置再docker compose up -d下一步按需开启可选组件知识图谱docker compose --profile neo4j up -d链路追踪Langfuse端口 3000--profile langfuse--profile full一次全开。多人协作内置空间级 RBACOwner / Admin / Contributor / Viewer 四档角色角色矩阵见 docs/RBAC说明.md。接入你自己的 Agent官方 CLIcli/和 MCP Servermcp-server/都能让编码 Agent 直接检索、问答你的文档库。生产部署设DISABLE_REGISTRATIONtrue关闭自助注册服务放内网别直接暴露公网。跑通之后重点就转向检索质量和权限设计了。排障手册在 docs/QA.md完整产品文档在 website-docs/API 参考在 docs/api/照着往下接就行。【免费下载链接】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），仅供参考 WeKnora 本地部署：5 步从空机器到能问答的文档知识库
WeKnora 本地部署5 步从空机器到能问答的文档知识库【免费下载链接】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 知识库、能自主检索的 ReAct Agent还有一份自维护的 Wiki。适合想在本地先跑通、或打算给团队搭文档问答服务的人。全程就 3 条命令# 克隆仓库并复制环境变量模板容器启动时读取 .env git clone https://gitcode.com/GitHub_Trending/we/WeKnora cd WeKnora cp .env.example .env # 拉取镜像并启动核心服务frontend、app、postgres、redis、docreader 等 docker compose pull docker compose up -d前提是装好 Docker 和 Docker Compose别的什么都不用装。跑起来的 5 个步骤第 1 步确认 .env 已就位上面的命令已经帮你cp .env.example .env。端口、数据库账号、模型地址全在这一个文件里。不改任何配置也能直接跑因为模板里的默认值本地存储 内置 postgres就是可用的。第 2 步端口冲突才需要改端口默认前端占 80、后端 API 占 8080。如果你的 8080 已被其他服务占用改一下再启动# 把 .env 里的后端端口改成 8000避免和其他服务抢 8080 sed -i s/^APP_PORT8080/APP_PORT8000/ .env第 3 步验证服务健康# 查看容器状态frontend 要等 app 通过健康检查才会放行 docker compose ps另外curl http://localhost:8080/health返回 200 就说明后端起来了。首次启动要拉镜像耐心等一两分钟。第 4 步打开界面上传第一篇文档访问 http://localhost按向导建账号、建知识库随便传一个 PDF 或 Word。等文档解析完成向它提个问题能拿到带引用来源的答案就算跑通了第 5 步可选接本地 Ollama 模型想省云 API 费用、用本地模型的话先起 Ollama# 后台启动 Ollama.env 默认地址指向 Docker 宿主机 ollama serve /dev/null 21 .env里OLLAMA_BASE_URL默认是http://host.docker.internal:11434Ollama 装在别的机器就改成对应地址。最容易配错的 5 个配置项配置项这是什么为什么要关心推荐值APP_PORT/FRONTEND_PORT后端、前端宿主机端口端口冲突时页面 502 或 API 连不上默认 8080 / 80被占就改APP_PORTSTORAGE_TYPE文件存储后端改成minio却不启动 minio profile上传会全部失败本地体验用默认localOLLAMA_BASE_URLOllama 服务地址换机器不改它模型配置必然失败默认值假设 Ollama 和 Docker 同机默认http://host.docker.internal:11434不用本地模型就留空不启用MAX_FILE_SIZE_MB单文件上传上限属部署期配置Go、Nginx、docreader、浏览器四层启动时各读一次改完必须重启全部容器才生效默认 50扫描件大文件可调大WEKNORA_VERSION镜像标签只跑docker compose up -d会复用本地缓存镜像UI 和后端版本会脱节升级时先docker compose pull再up -d出问题了4 个高频故障1. 打开 http://localhost 报 502 或空白页现象frontend 容器显示在跑页面就是打不开原因app 容器还没通过健康检查frontend 默认要等它 healthy解决docker compose logs -f app docreader postgres找 ERROR修好后docker compose restart app2. 文档上传成功但提问报模型错误现象上传流程走完了问答环节直接报错原因对话模型或 Embedding 模型没配置完整解决在.env补齐INIT_LLM_MODEL_NAME、INIT_EMBEDDING_MODEL_NAME含向量维度和模型 ID本地模型再确认 Ollama 在跑然后docker compose up -d重启3. 多模态知识库里的图片不显示现象文档解析出图了界面显示无效链接原因没启用 minio profile或MINIO_PUBLIC_ENDPOINT还是localhost解决docker compose --profile minio up -d要从别的设备访问图片把该变量改成机器实际 IP4. PaddleOCR 在部分平台启动失败现象扫描件或图片文档解析报错docreader 日志有 OCR 启动失败原因OCR_BACKENDpaddle不被当前平台支持解决docreader 服务里改OCR_BACKENDvlm并配外部 VLMOCR_API_BASE_URL/OCR_API_KEY/OCR_MODEL或干脆删掉 OCR 配置再docker compose up -d下一步按需开启可选组件知识图谱docker compose --profile neo4j up -d链路追踪Langfuse端口 3000--profile langfuse--profile full一次全开。多人协作内置空间级 RBACOwner / Admin / Contributor / Viewer 四档角色角色矩阵见 docs/RBAC说明.md。接入你自己的 Agent官方 CLIcli/和 MCP Servermcp-server/都能让编码 Agent 直接检索、问答你的文档库。生产部署设DISABLE_REGISTRATIONtrue关闭自助注册服务放内网别直接暴露公网。跑通之后重点就转向检索质量和权限设计了。排障手册在 docs/QA.md完整产品文档在 website-docs/API 参考在 docs/api/照着往下接就行。【免费下载链接】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），仅供参考