WeKnora部署指南用Docker跑起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 是一个基于大语言模型的开源知识平台能把散落的文档变成可 RAG 查询的知识库同时支持语义检索与 Agent 多步推理。本文带你走通本地 Docker 部署的最小检查、最短启动路径与上线验证帮你尽快拥有一个可用的知识库问答服务。先判断这类任务才适合用它团队有 PDF、Word、网页等成批文档想沉淀成统一问答入口想在自己服务器上搭 RAG 知识库问答而不是采购 SaaS需要“简单问题走检索、复杂任务走推理”查一条事实用 RAG 问答多步骤任务交给 Agent 自主调用工具和网络搜索数据必须留在内网模型厂商、向量数据库、对象存储都可以替换支持私有化部署核心能力它到底帮你解决什么RAG 快速问答文档解析、分块、向量化后入库用户提问直接得到带引用的答案覆盖 PDF、Word、Excel、Markdown 等十余种格式ReAct Agent 推理复杂问题由 Agent 拆解步骤编排知识检索、MCP 工具与网络搜索完成多步任务Wiki 模式Agent 把原始文档蒸馏成相互链接的 Markdown 页面附可视化知识图谱支持人工编辑、版本历史与一键回滚知识管理文件夹树保留上传时的目录结构检索分块可以像文档一样直接编辑、diff 与回滚并自动重建索引多源接入飞书知识库/云盘、Notion、语雀、RSS 可自动同步支持增量与全量集成生态对接企业微信、飞书、Slack、Telegram 等 IM 频道兼容 20 余家模型厂商与多种向量库链路可接入 Langfuse 追踪从文档解析到检索、推理的全流程都是模块化设计任一组件可替换这也是它能落到本地或私有云的原因。启动前最小检查Docker 与 Docker Compose 已安装并可用项目自带docker-compose.yml80 端口Web 界面与 8080 端口后端 API空闲如启用minioprofile 还需 9000/9001建议至少 4GB 可用内存、20GB 以上磁盘镜像加数据网络可拉取 Docker Hub 镜像如计划用本地 Ollama 模型先确认 Ollama 已在运行存在.env文件由.env.example复制而来最短启动路径git clone https://gitcode.com/GitHub_Trending/we/WeKnora cd WeKnora cp .env.example .env # 生成环境文件按注释调整模型提供方等配置 docker compose pull # 拉取各服务镜像 docker compose up -d # 后台启动核心服务五条命令即完成拉代码、备好配置、拉镜像、起服务。启动后打开http://localhost就能看到界面。如果偏好脚本方式./scripts/start_all.sh也封装了同样的流程。不同环境怎么选本地体验只起默认核心服务前端、应用、文档解析、Postgres、Redis即可模型接云端 API 最省事想用本地模型再接 Ollama开发调试LOG_LEVEL默认就是 debug可再设LLM_DEBUG_LOGtrue输出大模型调用细节GIN_MODEdebug开启调试模式生产使用保持GIN_MODErelease禁用 Swagger 文档设DISABLE_REGISTRATIONtrue关闭开放注册按需降低日志级别并规划数据库连接池可选组件用--profile叠加例如--profile neo4j开知识图谱、--profile minio换对象存储、--profile langfuse开链路追踪端口 3000、--profile full全量启动多个 profile 可组合启动后如何验证docker compose ps各容器应为 Up 状态app 容器健康检查通过后才会拉起前端打开http://localhost能看到注册/初始化页面走完初始化并上传一篇文档curl http://localhost:8080/health后端健康检查接口应有正常响应docker compose logs -f app日志尾部无持续性报错成功标准可以定得很具体页面能打开、健康检查有响应、第一轮问答能返回带引用的答案。常见卡点状态、日志、配置三步走先看状态docker compose ps找出没起来或反复重启的容器再看日志docker compose logs -f app或对应容器名定位第一条真实报错最后看配置.env管模型提供方、存储后端等部署级变量config/ 下是应用配置。高频坑是模型 API Key 没填或填错导致界面正常但问答报错数据库连不上则确认 postgres 容器是否就绪可以继续做的事监控与追踪接入 Langfuse 看推理链路与 Token 消耗配合内置运行时任务队列面板排查失败任务权限治理启用空间 RBACOwner / Admin / Contributor / Viewer 四级角色与审计日志知识源接入配置飞书、Notion、语雀、RSS 自动同步减少手动上传对外发布通过网站嵌入 Widget 或 IM 频道把问答能力放进自有站点以编程方式集成使用官方 MCP Server29 个工具或权限范围 API Key常用入口官方产品文档website-docs/API 接口说明docs/api/常见问题排查docs/QA.md知识图谱配置docs/KnowledgeGraph.md部署脚本scripts/MCP 服务器mcp-server/【免费下载链接】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），仅供参考