WeKnora Docker 部署完全指南:私有 RAG 知识库从环境评估到长期运维
WeKnora Docker 部署完全指南私有 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 部署展开覆盖环境评估、最小启动路径、组件职责、常见故障处理与长期运维要点目标是让一台干净机器上的部署能稳定跑下去。部署前先判断硬件门槛与模型来源WeKnora 本身是应用层资源消耗的大头在两处文档解析docreader 容器做的分块与渲染和向量检索ParadeDB 版 Postgres即带向量扩展的 Postgres。模型走 API 时一台 2 核 8GB 的机器就能跑要在本机推理内存由加载的模型决定别按部署文档估。运行场景建议配置说明模型走 API云端或远程 Ollama2 核 / 8GB / 20GB 磁盘最低可用档适合内网试用生产环境模型走 API4 核 / 16GB / 100GB 磁盘批量导入文档时的推荐档本机跑 Ollama 模型8 核 / 32GB / 100GB 磁盘内存按目标模型的显存/内存需求上浮模型来源推荐两条路线二选一有 GPU 或云端预算直接用 API解析和问答都最省心。纯内网环境用 Ollama 起本地模型。注意容器内访问宿主机要写host.docker.internal而不是localhost这条后面还会再提。核心部署路径从克隆到打开网页第 1 步克隆代码并准备环境变量git clone https://gitcode.com/GitHub_Trending/we/WeKnora cd WeKnora # 复制环境变量模板为本地副本后续只编辑这个副本 cp .env.example .env.env.example 里每个变量都有中文注释但不需要逐行看。第 2 步只改这几处关键配置变量默认值处理建议DB_PASSWORD模板占位值改成自己的强密码REDIS_PASSWORD模板占位值同上STORAGE_TYPElocal文件存本地卷单机场景不用动RETRIEVE_DRIVERpostgres向量检索复用 Postgres单机场景不用动OLLAMA_BASE_URLhttp://host.docker.internal:11434不用 Ollama 可忽略其余变量保持默认即可。模型 API Key 不用写在.env里首次登录后在界面里配见第 3 步。第 3 步拉镜像、启动、验证# 拉取全部核心镜像再后台启动 docker compose pull docker compose up -d # 观察容器状态app 显示 healthy 才算就绪 docker compose ps首次启动后打开http://localhost进入系统设置完成初始化建管理员账户、配对话模型API 或 Ollama、配向量模型。AUTO_MIGRATEtrue默认开启会让数据库结构在每次启动时自动迁移不需要手工建表。仓库里还有一个 scripts/start_all.sh 可以一键拉起并顺带装 Ollama但手动docker compose更可控推荐上面的方式。容器与组件职责速览默认up -d启动的是核心五件套数据全部落在 Docker 卷里容器承担的工作宿主端口frontendNginx 托管的 Web 界面反代到 app80FRONTEND_PORT可调app主应用API、业务逻辑、任务队列8080APP_PORT可调postgresParadeDB同时做关系库和向量库仅容器网络内redis流处理与 Asynq 任务队列仅容器网络内docreader文档解析服务gRPC 端口 50051仅容器网络内核心服务之外compose 用--profile组织了可选组件多个 profile 可以叠加Profile提供的能力默认宿主端口neo4j知识图谱构建与检索7474 / 7687minio对象存储替代 local 文件卷9000 / 9001langfuse模型调用链路追踪3000searxng自建网页搜索后端8888默认仅绑 127.0.0.1qdrant/milvus/weaviate/doris替换或补充向量库见 docker-compose.ymlfull以上全部—组合启用的写法# 例如同时启用知识图谱和对象存储 docker compose --profile neo4j --profile minio pull docker compose --profile neo4j --profile minio up -dWiki 模式下Agent 会从原始文档自治生成带链接的 Markdown 知识库与图谱效果可以见 docs/wiki/ 的说明界面形态参考下图启动阶段的高频问题与处理方式80 端口被占用frontend 起不来。宿主机已有 Nginx 或其他服务占了 80。把.env里FRONTEND_PORT80改成 8088 之类的空闲端口再执行docker compose up -d让端口重新映射。app 容器反复重启。多数是.env里DB_USER/DB_PASSWORD/DB_NAME与 postgres 容器的实际凭证对不上改过密码后容易只改一半。用docker compose logs -f app看具体报错然后把.env和数据库配置对齐重建 app 与 postgres 两个容器。app 报 Ollama 连不上但宿主机上服务明明开着。容器里的localhost指向容器自己。OLLAMA_BASE_URL要写宿主机可达地址compose 已把host.docker.internal映射到宿主机用这个即可远程 Ollama 则填实际服务地址。改完.env没生效。这是环境变量而不是文件监听compose 只在容器创建时注入一次。任何.env改动之后都要执行docker compose up -d app重建容器才生效。镜像版本和预期对不上。只跑up -d会复用本地缓存镜像。先docker compose pull再up -d顺序不能反。稳定性调优、安全核对与日常运维长期运行的三个调优点队列并发。解析任务是异步队列驱动的WEKNORA_ASYNQ_CORE_CONCURRENCY默认 8控制文档解析主链路并发机器余量大就提到 16批量导入明显变快WEKNORA_MODEL_MAX_CONCURRENCY默认 32限制每个模型的后台调用并发防止把 LLM 服务端打爆按对方限流调整。Embedding 并发。调用 embedding 接口频繁出现 429 时把CONCURRENCY_POOL_SIZE默认 5调小。日志。默认LOG_LEVELdebug输出很密稳定后改成info并设LOG_PATH落盘方便事后排查。以上改动都归属.env改完统一用docker compose up -d app生效。上线前安全核对清单 ⚠️DB_PASSWORD、REDIS_PASSWORD已替换为强随机值不保留模板占位符SYSTEM_AES_KEY已设为 32 字节随机值openssl rand -hex 16生成。它负责数据库里 API Key、模型凭证等敏感字段的加密丢了这些数据就永久解不开务必离线备份DISABLE_REGISTRATIONtrue关闭公开注册新用户走管理员邀请前端挂在 HTTPS 之后反向代理 Nginx/Caddy 终止证书备份方案演练过一次确认所有数据都在 Docker 卷里备份、升级与巡检# 数据库备份库名、用户名按 .env 实际值替换 docker compose exec postgres pg_dump -U postgres -d WeKnora weknora_$(date %F).sql# 版本升级先拉新镜像再重建顺序反了会复用旧镜像 docker compose pull docker compose up -d# 日常巡检资源占用 主应用日志 docker stats docker compose logs -f app出现异常时按容器逐个看日志docker compose logs -f docreader、docker compose logs -f postgres文档解析慢、模型超时这类问题基本都能定位到具体容器。更细的排查思路参考 常见问题排查接口级问题查 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),仅供参考

相关新闻

轻量级CRM技术栈实战:Supabase+Next.js+TS+Docker一体化方案

轻量级CRM技术栈实战:Supabase+Next.js+TS+Docker一体化方案

1. DeskcommCRM:一个面向中小团队的轻量级客户关系管理工具DeskcommCRM这个名字乍一看有点拗口,但拆开来看就非常直白:“Desk”代表桌面端、本地化、轻量级的工作环境;“comm”是communication的缩写,强调沟通协同&…

2026/11/16 4:47:57 阅读更多 →
腾讯WorkBuddy深度教程:让AI Agent成为你的电脑操作助手

腾讯WorkBuddy深度教程:让AI Agent成为你的电脑操作助手

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views …

2026/11/16 4:47:59 阅读更多 →
DeepSeek Harness桌面端解析:Agent控制框架与三种接入实操

DeepSeek Harness桌面端解析:Agent控制框架与三种接入实操

这两天圈子里不少人在传一件事:DeepSeek 官方“偷偷”做了一个叫 Harness 的桌面端,我也看到好多人在问能不能装、怎么装。说实话,我第一反应也是去翻官方仓库,翻了半天发现 DeepSeek 官方并没有发过一个叫 “DeepSeek Harness” …

2026/11/16 4:56:38 阅读更多 →

最新新闻

Electron桌面应用开发实战:从环境搭建到打包发布全流程

Electron桌面应用开发实战:从环境搭建到打包发布全流程

做前端这些年,我大部分时间都在跟浏览器标签页打交道,直到第一次把桌面应用跑起来,才发现原来自己一直被限制在地址栏和刷新按钮围起来的框框里。Electron这个词,最开始是在某段时间频繁出现在同事的讨论里,一个用HTML…

2026/11/16 8:22:12 阅读更多 →
滑盖智能锁T109深度解析:结构原理、安装调试与故障排查

滑盖智能锁T109深度解析:结构原理、安装调试与故障排查

简介:亚太天能T109滑盖智能锁产品说明书是一份PDF格式的官方技术文档,主要面向智能锁安装人员、终端用户及售后维护者,帮助快速掌握产品安装、配置与常见故障处理。全包仅1个PDF文件,大小4.37MB,内容结构清晰&#xff…

2026/11/16 6:41:34 阅读更多 →
PMSM弱磁控制原理与Simulink建模:高速AGV驱动系统设计指南

PMSM弱磁控制原理与Simulink建模:高速AGV驱动系统设计指南

上个月我在调试一台高速AGV的驱动系统,整车要求空载跑到8m/s,电机转速已经拉到额定点,驱动器的输出电压也顶到了母线电压极限附近。再往上踩速度指令,转速纹丝不动,三相电流反而开始震荡。那会儿我的第一反应就是&…

2026/11/16 8:22:12 阅读更多 →
C++核心知识点:从内存管理到STL的实战指南

C++核心知识点:从内存管理到STL的实战指南

C 这门语言我前前后后折腾了十几年,用它写过嵌入式驱动、做过游戏服务端,也搭过基础组件库。每次看到新人一头扎进"C 核心知识点"这个搜索词,我其实挺感慨的——这门语言的难点从来不是语法多,而是知识点之间的耦合太深…

2026/11/16 8:22:12 阅读更多 →
T109滑盖智能锁怎么装?安装调试与故障排查全攻略

T109滑盖智能锁怎么装?安装调试与故障排查全攻略

简介:亚太天能T109滑盖智能锁产品说明书以PDF格式发布,适合智能锁用户、安装人员与售后维修人员阅读。内容围绕T109系列指纹密码刷卡锁展开,先介绍前面板、后面板、锁体、机械钥匙、电池盒盖等部件名称与功能,再给出完整安装步骤&…

2026/11/16 7:30:18 阅读更多 →
LLM知识降熵:从信息垄断到理解权下放

LLM知识降熵:从信息垄断到理解权下放

你有没有过这种经历:翻开源码注释、论文摘要或者一份专业报告,每个字都认识,连在一起却像天书。想找人聊聊,身边要么没人懂,要么懂的懒得跟你解释。后来我试着把同一段内容丢给一个大语言模型,几秒钟之后&a…

2026/11/16 8:22:12 阅读更多 →

日新闻

周新闻

月新闻