WeKnora Docker 部署实战：10 分钟从零到私有 RAG 知识库

WeKnora Docker 部署实战10 分钟从零到私有 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读完这篇你能用 Docker Compose 在一台机器上把 WeKnora 跑起来克隆仓库、配一份.env10 分钟得到一套私有 RAG 知识库——上传文档提问拿到带引用的回答。机器上装好 Docker 即可无需其他依赖。WeKnora 是开源 LLM 知识平台把原始文档变成可检索的 RAG 知识库、自主推理 Agent 和自动维护的 Wiki。先选路线按场景挑机器WeKnora 本身只是应用层重活是文档解析与向量检索所以机器要求取决于一件事你的 LLM 在哪。模型走云 API 时机器只承担解析和检索本机跑 Ollama本地大模型服务时内存由你加载的模型大小决定。你的场景够用的配置一句话原因本机开发LLM 走云 API2 核 / 8GB / 20GB 盘重推理在云端本机只做解析与检索服务器给团队共用4 核 / 16GB / 100GB批量解析加向量库需要余量本机跑 Ollama 模型8 核 / 32GB / 100GB内存取决于模型大小动手前先做 30 秒自检确认硬件达标且 Compose 可用# 30秒自检CPU、内存、磁盘与 Docker Compose nproc; free -h; df -h .; docker compose version 最后一条失败通常是 Docker 没装或当前用户不在 docker 组先修好再继续。最小闭环部署两条命令完成克隆与配置准备# 克隆仓库并进入目录 git clone https://gitcode.com/GitHub_Trending/we/WeKnora cd WeKnora # 复制环境变量模板每个变量都有中文注释 cp .env.example .env然后编辑.env只需看下表其余保持默认配置项不改会怎样建议改成什么DB_PASSWORD/REDIS_PASSWORD模板示例值等同公开密码你自己的强密码SYSTEM_AES_KEY加密 API Key 的主密钥用了公开值openssl rand -hex 16生成的 32 字节随机值STORAGE_TYPE/RETRIEVE_DRIVER没影响保持默认文件进本地卷向量检索复用同一个 PostgresLOG_LEVEL默认debug日志很吵info可用LOG_PATH落盘OLLAMA_BASE_URL连不上也不阻塞启动仅用本地 Ollama 时改成你的地址拉镜像并启动# 拉取镜像并后台启动核心服务 docker compose pull docker compose up -d默认启动核心五件套frontendNginx 网页界面端口 80、appAPI 与业务逻辑8080、postgresParadeDB 版关系数据与向量数据一体、redis流处理与任务队列不对外、docreader文档解析gRPC 仅容器内网。附加能力用--profile按需叠加可组合# 按需叠加知识图谱(Neo4j) 对象存储(MinIO) docker compose --profile neo4j --profile minio up -d常用有full全部、neo4j知识图谱、minio对象存储、langfuse链路追踪、searxng自建网页搜索完整清单见 README_CN.md 可选服务一节。启动后注册账号、建知识库、上传第一批文档文档列表页长这样三道验收进程、入口、真实提问第一道进程状态。# 查看容器状态 docker compose ps # 探测 API 健康端点 curl http://localhost:8080/health通过标准五个容器全部 Upapp 一行显示healthy健康检查每 30 秒探测一次/healthcurl 返回成功。第二道访问入口。浏览器打开http://localhost出现注册页即通过API 在http://localhost:8080。第三道一次真实端到端请求。前两道只证明容器活着。注册账号在系统设置配置模型云 API 或 Ollama 均可建知识库传一份 PDF等文档解析完成再问一个文档里的问题。通过标准回答基于文档内容并给出来源引用——解析、向量化、检索、生成全链路才算通。排错与提速起不来、慢、效果差起不来类现象docker: command not found或permission denied连不上 daemon原因Docker 没装或当前用户不在 docker 组处置安装 Dockersudo usermod -aG docker $USER加组后重开终端现象80 端口被占前端起不来原因FRONTEND_PORT默认 80 被别的服务占用处置.env里改FRONTEND_PORT8088再docker compose up -d重建现象app 容器反复重启原因多半是DB_USER/DB_PASSWORD/DB_NAME与 postgres 容器对不上处置docker compose logs -f app看报错核对.env三项慢类现象批量文档解析慢原因解析由异步队列驱动主链路默认并发只有 8处置机器余量大就把WEKNORA_ASYNQ_CORE_CONCURRENCY从 8 调到 16模型后台并发WEKNORA_MODEL_MAX_CONCURRENCY默认 32可同步上调注意.env改动不会作用于已运行的容器改完执行docker compose up -d app重建才生效。效果差类现象回答跑题、答非所问原因回答质量九成取决于 LLM模型太弱处置系统设置里换能力更强的模型仍不理想再按 常见问题排查 调检索参数上线前四个风险点占位密码裸奔DB_PASSWORD/REDIS_PASSWORD是仓库示例值服务暴露公网任何人都能登录知识库内容全公开。两处替换后docker compose up -d重建容器。AES 主密钥没保管SYSTEM_AES_KEY加密 API Key 等敏感字段丢了就解不开所有密钥都得重填。openssl rand -hex 16生成并离线保存。注册敞开DISABLE_REGISTRATION默认false任何人都能注册建空间。生产设为true用户走管理员邀请。没有备份数据都在 Docker 卷里磁盘故障即全丢。一条命令导出# 一键导出数据库备份 docker compose exec postgres pg_dump -U postgres -d WeKnora weknora_$(date %F).sql升级永远先拉镜像docker compose pull docker compose up -d只跑up -d会复用旧镜像界面显示的版本和预期对不上。⚠️ 四项都是「现在处理便宜、事后处理贵」的事上线前一次性做完。整条主线就是一条链选路线、配.env、起五件套、三道验收。下一步很具体——把第一批真实文档传进知识库问一个只有这些文档能回答的问题。【免费下载链接】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），仅供参考