今天写一个叫 MaxKB 的开源项目，之前我在别的地方提过它，一直没单独写过，最近看它在 GitHub 上已经过了 22k Star，全网下载量有 47 万多次，更新也一直没断过，我觉得是时候拿出来说说了。

这个项目是做 1Panel 的那个团队开发的，1Panel 搞运维的应该不少人都装过。网上还有报道说，华莱士这种连锁餐饮公司也在用它搭内部知识库。一个做服务器面板的团队，跑来做智能体平台，还做成了，这个我挺好奇的，下载玩了玩。

这是个什么项目

MaxKB 的全称是 Max Knowledge Brain，翻译过来就是最大知识脑。官方给的说法是强大易用的企业级智能体平台。

说简单点，就是把公司里的各种文档、操作手册、网页资料传给它，然后再接一个大模型，就能做出来一个专门回答公司内部问题的 AI 助手。像智能客服、内部知识库问答、员工助手这些常见的场景，都可以用它来做。

项目是 GPLv3 开源的，社区版不要钱，代码都放在 GitHub 上。技术栈是后端 Python 加 Django，前端 Vue，想改代码的自己拉下来看就行。

它能干什么

传文档就能建知识库

先说最基本的用法，建知识库。我们把 PDF、Word、TXT、Markdown 这些格式的文档直接传上去就行，如果资料在某个网站上，也可以把网址填进去，它会自己去爬。

传完以后文档会被拆成一段一段的，每一段我们都看得到，觉得拆得不对的地方可以自己动手改。表格和图片里的内容它也能处理。

这个页面就是文档拆完以后的样子，每一段多少字都标出来了。

文档进了知识库，问答就有依据了。以前我们直接问大模型公司内部的事情，它不知道就会瞎编。现在它是拿着我们传进去的资料来回答，靠谱了不少。

这是对话界面的样子，官方拿 DataEase 小助手做的演示，每次回答下面还标着用了多少 token、花了多少时间。

不会写代码也能编排工作流

除了直接问答，它还有工作流。这个东西是可视化的，打开一个画布，把节点拖上去，用线连起来，整个过程不用写代码。像问题分类、敏感词过滤、查数据库、调外部接口这些操作，都是现成的节点，拖上来就能用。

另外它还支持函数库和 MCP 工具调用。MCP 现在用的人挺多的，Claude Code、Cursor 这些工具都支持，MaxKB 也跟上了。

流程画出来就是这个样子，每一步走到哪都能看清楚。公司里的业务如果比较复杂，比如客户咨询要先分类、再转给不同的人处理，用工作流就能拼出来。

接什么模型自己说了算

模型这块它不绑定任何一家，接什么由我们自己定。

如果公司对数据安全有要求，不想让数据出门，可以用 Ollama 或者 vLLM 在自己的服务器上跑 DeepSeek、Llama、Qwen 这些开源模型，然后接进来。

如果没有这个要求，直接接公共模型也行，国内的通义千问、腾讯混元、豆包、百度千帆、智谱 AI、Kimi 都支持，国外的 OpenAI、Claude、Gemini 也有。填个 API Key 就完事了。

模型设置页面里能加的供应商有一大串，常见的名字基本都能找到。

做好的助手能嵌进现有系统

应用做好以后，还得让别人能用上。MaxKB 会生成一段嵌入代码，我们把这段代码贴到公司的网站或者系统里，页面右下角就会出现一个问答浮窗，也可以整个页面嵌进去。

如果公司在用企业微信、钉钉、飞书，或者想在微信公众号里用，也都能接。国外的同类项目比如 Dify，接微信这些国内平台就比较麻烦，MaxKB 在这方面是原生支持的，不用额外折腾。

不只文字，图片音频视频也支持

除了文字，图片、音频、视频也支持输入输出。比如做客服的时候，客户发一张截图过来问问题，这种情况它也能处理。

一条命令跑起来

安装很简单，服务器上装了 Docker 的话，执行下面这条命令就行：

docker run -d --name=maxkb --restart=always -p 8080:8080 -v ~/.maxkb:/var/lib/postgresql/data -v ~/.python-packages:/opt/maxkb/app/sandbox/python-packages registry.fit2cloud.com/maxkb/maxkb

这条命令用的是国内镜像，下载不会卡。跑起来以后，浏览器打开 http://服务器IP:8080，用户名 admin，密码 MaxKB@123..，第一次登录记得把默认密码改掉。

如果服务器上装了 1Panel，还能更省事，直接在 1Panel 的应用商店里搜 MaxKB，点一下安装就完事。公司内网不能联网的话，官方社区里有离线安装包可以下载。

我的看法

用了这段时间，我觉得它最大的好处就是省事。装完、传文档、开始问答，半天就能搞定，文档和社区都是中文的，遇到问题去论坛问也有人回。公司里如果没有专门搞算法的人，用它来做知识库问答，比自己从零开始搭要划算得多。

不满意的地方也有，社区版在知识库数量、应用数量、用户数上都有限制，公司人多了就要考虑买专业版，官网上有版本对比，建议先看清楚再决定。

总的来说，想给公司做一个知识库问答或者智能客服，MaxKB 是可以直接上手的选择。想改得更深，代码都在 GitHub 上，后端是 Python，搞 Java 的人看起来也不算费劲。

开源地址

https://github.com/1Panel-dev/MaxKB