腾讯开源WeKnora:31K Star的AI知识库,Docker一键部署,文档扔进去就能问

你是不是也遇到过这种尴尬:需求文档在语雀、会议纪要在飞书、方案稿在共享网盘、代码文档在 Confluence,领导突然来一句”上次那个方案最后怎么定的”,你只能默默开始翻十分钟。资料明明都有,就是”找不着、问不出”。

腾讯最近开源的 WeKnora 就是冲着这个问题来的——把你的文档全部喂给它,然后像聊天一样直接提问,它不仅回答,还会告诉你答案出自哪份文档的哪一段。GitHub 上已经 31,489 Star(Go + TypeScript 编写,MIT 协议),今天这篇手把手教你用 Docker 一键部署起来。

WeKnora 封面

一、WeKnora 到底是什么?

一句话:一个装在你自己服务器上的”会思考的团队知识库”。所谓”自托管”,就是程序跑在你自己的机器上,文档不外流,数据留在你自己的环境里。

它把三种能力放在了同一份知识库上:

  • RAG 问答:混合检索 + 多模态解析,回答自带引用来源,能追查到原文出处;
  • 智能体 Agent:能执行多步任务,支持技能沙箱(Docker / E2B)、MCP 工具接入,还能操作你自己的浏览器;
  • 自动 Wiki:文档自动生成并持续维护成知识 Wiki,带知识图谱和版本回滚。

WeKnora RAG 问答界面

二、核心功能一览

能力 说明 新手感知
文档解析 PDF / Word / 图片 / Excel / XMind 等十余种格式,Office 文件进程内解析 文件直接拖进去就能用
数据源同步 飞书知识库、语雀、Notion、Confluence、GitLab、钉钉文档、RSS 自动同步 不用手动导出再导入
检索问答 混合检索 + 引用溯源,可编辑、比对、回滚检索分块 每个答案都能查到出处
模型接入 内置 27 家模型厂商:OpenAI、DeepSeek、Qwen、智谱、混元、Gemini、Ollama 等 用哪家的模型随便换
渠道集成 企业微信、飞书、Slack、Telegram 直接问答,内置 MCP Server 供 Cursor / Claude 连接 问答能力能接到你已在用的工具里
权限运维 多空间 RBAC 四级角色、审计日志、Langfuse 追踪 多人团队也能管得住

WeKnora 文档列表

WeKnora 智能体技能沙箱

三、Docker 一键部署(跟着敲就行)

需要提前装好三样东西:Docker、Docker Compose 和 Git。这三样都是一次性安装,之后所有项目都能复用。

第 1 步:拉取源码

git clone https://github.com/Tencent/WeKnora.git
cd WeKnora

第 2 步:准备配置文件(把官方模板复制一份,想改再改)

cp .env.example .env
# 用 vim/nano 打开 .env,按文件内注释填模型 API Key 等配置

第 3 步:拉镜像 + 启动

docker compose pull     # 拉取最新镜像
docker compose up -d    # 启动核心服务

就这么几行。启动成功后浏览器打开 http://localhost,跟着新手引导走完配置就能用了。

服务 地址
Web 界面 http://localhost
后端 API http://localhost:8080
链路追踪(Langfuse) http://localhost:3000

可选组件按需叠加,加 –profile 就行:

# 知识图谱(Neo4j) + 对象存储(MinIO) 全家桶
docker compose --profile neo4j --profile minio pull
docker compose --profile neo4j --profile minio up -d

四、首次使用:3 步问出第一份答案

  1. 配置模型:进入 Web 界面后先在设置里接入一个大模型——DeepSeek、Qwen 这类国产模型便宜好使;想零成本也可以接本地 Ollama(就是把模型跑在自己电脑上的工具)。
  2. 上传文档:新建知识库 → 拖入 PDF/Word/Excel,或绑定飞书、语雀、Notion 等数据源自动同步,它会自动完成解析和向量化(”向量化”简单说就是把文字变成能被数学计算的坐标,方便秒级检索)。
  3. 开始提问:切到问答界面直接用大白话问,比如”上次方案里预算上限定了多少?”——答案下面会附引用来源,点进去能看原文。

进阶玩法:接 MCP 服务让 Cursor / Claude 直接查你的知识库;开个空间给团队,四级角色权限各看各的。

五、和传统方式比一比

维度 手动翻文档 普通网盘 + 全文搜索 WeKnora
找答案方式 挨个文件点开翻 关键词搜索,命中标题不一定命中内容 自然语言直接问,答案带引用
多格式解析 各软件轮流打开 部分格式搜不到内容 十余种格式统一解析
知识沉淀 靠人脑记 无 自动生成 Wiki + 知识图谱
数据位置 本机 第三方云 自托管,数据留在自己环境
费用 免费 免费/会员 开源免费,模型费自付

六、下载地址

GitHub 直连慢的小伙伴,我已经把 WeKnora v0.8.0 官方源码包(含 docker-compose.yml、.env.example、helm、完整文档)传好了,解压后按上面的步骤部署即可,包里还附了一份 README 部署说明:

夸克网盘下载:https://pan.quark.cn/s/67ef3d7dc1c2(当天所有软件在文件夹内,进入「WeKnora v0.8.0」目录即可)

小提醒:标准版部署需要 4GB 以上内存的机器(NAS / 云服务器 / 电脑虚拟机都行);模型 API Key 需要自己准备,DeepSeek 这类国产模型门槛很低,本地 Ollama 则完全免费。官方文档写得挺全:https://weknora.weixin.qq.com/docs/

说实话,腾讯把这套东西完整开源、连知识图谱和沙箱都一起放出来,还挺意外的。以前搭一套”文档能问答”的系统至少要折腾一周,现在三行命令就起来了——真香。

💬 关注公众号:「实用软技」,在公众号窗口里回复关键字「软件」即可免费获取更多软件

100T高转存免费网盘资源精选【持续更中~~~~】:点击查看

发表回复