MaxKB：企业级 RAG 智能体平台 Docker 部署与使用指南

一、项目官方信息

MaxKB = Max Knowledge Brain，是开源的企业级智能体平台，集成 RAG 检索增强流水线、工作流引擎与 MCP 工具调用能力。广泛应用于智能客服、企业内部知识库、学术研究与教育。

二、官方图片

上图为 MaxKB 仓库在 GitHub 上的官方 Logo。

三、环境要求

• Docker 与 Docker Compose；
• 内存建议 4GB+；
• 可对接私有模型（DeepSeek、Llama、Qwen）或公有模型（OpenAI、Claude、Gemini）。

四、部署步骤

1. 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 \
  1panel/maxkb

2. 访问 Web

浏览器打开 http://服务器IP:8080，默认账号 admin / MaxKB@123..。

3. 配置模型

在「模型设置」中填入 OpenAI 兼容接口或私有模型地址。

4. 新建知识库

上传文档或在线爬取，系统自动切片、向量化。

5. 创建应用

基于知识库编排问答机器人，嵌入网站或企业系统。

五、使用方法

• RAG 流水线：文档上传/爬取，自动切分、向量化，降低幻觉；
• Agent 工作流：可视化编排，函数库与 MCP 工具；
• 零代码集成：嵌入第三方业务系统；
• 模型无关：支持 DeepSeek、Llama、Qwen、OpenAI 等；
• 多模态：支持文本、图片、音视频。

六、常见问题 FAQ

1. MaxKB 是什么？ 企业级开源 RAG 智能体平台，用于搭建知识库问答。

2. 默认账号？ admin / MaxKB@123..。

3. 支持哪些模型？ 私有模型（DeepSeek、Llama、Qwen）与公有模型（OpenAI、Claude、Gemini）。

4. 数据怎么存？ 内置 PostgreSQL，挂载到本地目录持久化。

5. 可以嵌入网站吗？ 提供零代码嵌入式聊天窗口。

6. 怎么升级？ 拉取新镜像重新启动即可。

七、跳转链接

• GitHub 仓库：1Panel-dev/MaxKB
• 中文文档：README_CN
• 镜像：Docker Hub