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/WeKnoraWeKnora 是一个开源 LLM 知识平台能把原始文档变成可检索的 RAG 库、会推理的 Agent 和自动维护的 Wiki。本文只讲一件事用 Docker Compose 在一台机器上把它从克隆代码跑到打开网页能用顺利的话 10 分钟内搞定。先自检机器再动手WeKnora 本身是应用层重活落在文档解析和向量检索上。只要 LLM 走 API一台 4 核 8GB 的机器就够要本机跑 Ollama 大模型内存主要看你加载多大的模型。场景CPU内存本地开发LLM 走 API2 核8GB生产环境4 核16GB本机跑 Ollama 大模型8 核32GB先跑一条命令自检Docker 和 Compose 都能过就行# 检查 CPU、内存、磁盘和 Docker 状态 nproc; free -h; df -h .; docker compose versiondocker compose version报失败多半是 Docker 没装或用户没加组见后面踩坑。四步把核心服务拉起来全程在项目根目录执行只需四条命令。1. 克隆仓库# 克隆 WeKnora 代码仓库并进入目录 git clone https://gitcode.com/GitHub_Trending/we/WeKnora cd WeKnora2. 复制并配置环境变量# 复制环境变量模板文件内每个变量都有中文注释 cp .env.example .env编辑.env时只盯下面关键配置表里那几项其余保持默认。3. 拉镜像并后台启动# 拉取镜像并后台启动核心服务 docker compose pull docker compose up -d首次会拉一堆镜像耐心等。默认只起核心四件套可选组件后面按需叠加。4. 打开浏览器访问# 查看容器状态app 显示 healthy 才算就绪 docker compose ps前端在http://localhostAPI 在http://localhost:8080。首次进入要在系统设置里配一个模型API 或 Ollama 均可。只改这几项 .env 配置.env里有上百个变量但 90% 你都不需要碰。真正要动的是下面五项其余保持默认变量默认值你要做什么DB_PASSWORDpostgres123!#必改换成你的强密码REDIS_PASSWORDredis123!#必改同上SYSTEM_AES_KEY32 字节占位值必改openssl rand -hex 16生成它加密数据库里 API Key 等敏感字段丢了就解不开DISABLE_REGISTRATIONfalse生产设true用户走管理员邀请OLLAMA_BASE_URLhttp://host.docker.internal:11434指向你的 Ollama不用 Ollama 可忽略STORAGE_TYPElocal、RETRIEVE_DRIVERpostgres这两项默认就行别动文件存本地卷最省事向量检索直接复用 ParadeDB 版 Postgres。FRONTEND_PORT80被占用才改。验收看到 healthy 才算跑起来# 逐个确认容器状态 docker compose ps成功标准看两点frontend、app、postgres、redis、docreader全部running其中app状态列出现healthy才算真正就绪它内部每 30 秒探测一次/health。再补一条接口自检更稳# 直接探活后端接口 curl -f http://localhost:8080/health echo OK看到OK浏览器打开http://localhost就是这个登录页按需叠加可选组件默认up -d只起核心服务其余能力用--profile按需叠加可组合# 例同时启用知识图谱和对象存储 docker compose --profile neo4j --profile minio pull docker compose --profile neo4j --profile minio up -dProfile作用full一次拉起全部组件neo4j知识图谱文档语义关联网络minio对象存储图片外链和多模态常用langfuse链路追踪与 token 消耗统计searxng自建网页搜索供 Agent 联网用踩坑速查高频启动问题点我展开Q: 报docker: command not foundA: 装 Docker 后重跑docker compose version复查。Q: 报permission denied连不上 daemonA:sudo usermod -aG docker $USER然后重开终端。Q: 80 端口被占用前端起不来A:.env里FRONTEND_PORT改成8088再docker compose up -d重建。Q: app 容器反复重启A:docker compose logs -f app定位多数是DB_USER/DB_PASSWORD/DB_NAME和 postgres 容器对不上。上线前过一遍安全清单默认配置里不少密码是占位符暴露到公网前务必逐项勾掉改掉DB_PASSWORD和REDIS_PASSWORD的示例值设置SYSTEM_AES_KEY32 字节随机值并离线妥善保管丢了不可恢复设DISABLE_REGISTRATIONtrue关闭公开注册给前端挂 HTTPS反代 nginx/caddy 终止证书即可确认备份方案可用数据都在 Docker 卷里数据库备份一条命令用户名/库名按.env实际值替换# 导出数据库到当日日期命名的 SQL 文件 docker compose exec postgres pg_dump -U postgres -d WeKnora weknora_$(date %F).sql顺手做两处调优稳定后把LOG_LEVEL从debug降到info减少日志噪音机器余量大就把WEKNORA_ASYNQ_CORE_CONCURRENCY从默认 8 提到 16批量导入文档明显变快。改完统一用docker compose up -d app重建生效。升级则走docker compose pull docker compose up -d注意先pull再up否则会复用旧镜像。更多问题参考 常见问题排查。从资源自检、四步启动、按需叠加到这份安全清单走一遍WeKnora 就能从「跑起来」稳定过渡到「长期跑」。下一步就是往知识库里灌第一批文档然后开始提问。【免费下载链接】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），仅供参考