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。按本文操作最终画面是浏览器打开http://localhost进入 Web 界面API 在http://localhost:8080导入文档后直接提问——顺利的话 10 分钟走完从克隆代码到打开页面。环境自检一条命令三个数达标即可跑 WeKnora 只看三个数CPU最低 2 核本地开发LLM 走 API内存最低 8GB磁盘最低 20GBLLM 走 API 还是在本机跑模型差距全在内存这一项模型放云端或远程 Ollama8GB 就够本机 Ollama 加载大模型建议 32GB、8 核以上。磁盘按文档量预留长期生产用 100GB 更稳妥。自检命令nproc; free -h; df -h . docker compose version正常输出长这样前三条依次打印核数、内存、磁盘最后一条打印Docker Compose version v2.x.x。四条全有输出就算通过。部署主线四步克隆、改配置、启动、验证第一步克隆代码目标拿到代码和docker-compose.yml。git clone https://gitcode.com/GitHub_Trending/we/WeKnora cd WeKnora正常输出长这样Cloning into WeKnora...之后列出docker-compose.yml、.env.example等文件。第二步配 .env目标把示例环境值改成你自己的。cp .env.example .env文件里每个变量都有中文注释其余保持默认即可只动下面这几项变量默认值为什么要改DB_PASSWORD示例占位数据库密码公网暴露前必须换成强密码REDIS_PASSWORD示例占位同上别用示例值上线STORAGE_TYPElocal文件存本地卷最省事有对象存储需求再换minio/s3等RETRIEVE_DRIVERpostgres向量检索复用 ParadeDB 版 Postgres保持默认不用动OLLAMA_BASE_URLhttp://host.docker.internal:11434指向你的 Ollama不跑本机模型可忽略 密码与数据库容器对不上是 app 起不来的最常见原因改完核对DB_USER/DB_PASSWORD/DB_NAME三项。第三步拉镜像并启动目标把核心服务在后台跑起来。docker compose pull docker compose up -d拉镜像耗时取决于网速完成后无报错输出。嫌手动麻烦可以用仓库里的 scripts/start_all.sh 一键拉起还会顺带安装/启动 Ollama但手动docker compose更可控。第四步验证状态目标确认应用真的就绪而不是启动了。docker compose ps正常输出长这样app一行的 STATUS 列显示healthyfrontend、postgres、redis、docreader 为Up。访问http://localhost出现前端界面、http://localhost:8080能通部署完成。本机用 Ollama 的话先ollama serve再ollama pull一个模型没配 Ollama 不影响启动只是首次进入时要在系统设置里填 API 模型。按需叠加功能profile 对应使用场景默认up -d只跑核心四件套frontendNginxWeb 界面端口 80、app主应用API 业务逻辑端口 8080、postgresParadeDB关系库和向量库二合一、redis流处理与任务队列。另有docreader在容器网络内做文档解析gRPC不占宿主端口。其余能力按场景叠加 profile可以组合要知识图谱 →--profile neo4j要对象存储 →--profile minio要自建网页搜索 →--profile searxng要链路追踪 →--profile langfuse全部都要 →--profile fulldocker compose --profile neo4j --profile minio pull docker compose --profile neo4j --profile minio up -d正常输出长这样额外服务开始Creating/Starteddocker compose ps里多出 neo4j、minio 容器。完整 profile 清单见 README_CN.md 的可选服务一节。常见问题对照表症状、原因、一行修复症状可能原因一行修复docker: command not foundDocker 未安装sudo apt-get install docker-ce docker-ce-cli containerd.io连 Docker daemon 报permission denied当前用户不在 docker 组sudo usermod -aG docker $USER后重开终端前端起不来报 80 端口被占用宿主 80 端口已有服务.env改FRONTEND_PORT8088再docker compose up -d重建app 容器反复重启.env数据库配置与 postgres 容器对不上docker compose logs -f app看报错核对DB_USER/DB_PASSWORD/DB_NAME上线后运维三个问题谁来用安全项默认配置里很多密码是占位符暴露公网前先过一遍改DB_PASSWORD和REDIS_PASSWORD设DISABLE_REGISTRATIONtrue用户改走管理员邀请而不是公开注册给前端挂 HTTPS反代 nginx/caddy 终止证书即可。⚠️SYSTEM_AES_KEY用于数据库里 API Key 等敏感字段的加密丢了就解不开务必离线保管。生成方式openssl rand -hex 16。怎么升级先 pull 再 updocker compose pull docker compose up -d必须先pull再up不拉新镜像的话up会直接复用本地旧镜像看起来升了级其实还是旧版本。改环境变量同理必须重建 app 容器才生效docker compose up -d app。挂了怎么恢复备份加巡检docker compose exec postgres pg_dump -U postgres -d WeKnora weknora_$(date %F).sql正常输出长这样文件生成在仓库目录、体积非零用户名/库名按.env实际值替换。数据都在 Docker 卷里这份 SQL 就是恢复底牌。日常巡检两条命令docker stats看资源占用docker compose logs -f app看报错。跑通之后把机器上的第一批文档传进知识库向它提问这套 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创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考