核心功能
MaxKB 由 1Panel 团队开源，定位企业级智能体平台，整合 RAG 检索管线、工作流引擎与 MCP 工具调用。它支持上传文档或抓取在线文档，自动分段与向量化，并能零代码嵌入第三方系统。技术栈为 Django 加 LangChain，向量存储用 PostgreSQL 与 pgvector。
功能亮点
一键部署
单条 docker run 拉起全部服务，数据目录挂载到宿主机 ~/.maxkb
零代码接入
生成嵌入代码挂到第三方业务系统，无需改造原有前端页面
模型不挑食
私有 Qwen、Llama 与公有云 OpenAI、Claude 模型都可接入
多模态问答
原生支持文本、图片、音频与视频的输入输出，不局限于纯文字
自定义模型 / 模型接入
多厂商支持
官方表收录二十余家，含阿里云百炼、DeepSeek、腾讯混元、火山引擎、千帆大模型、讯飞星火、智谱AI；私有部署走Ollama、vLLM或本地模型。
接入方式
- 【模型】页选供应商，点【添加模型】填模型名称、基础模型、API Key
- 模型类型含大语言模型、向量模型、重排模型、语音识别、视觉模型
- 接自建服务选【vLLM】，API 域名填http://IP:8000/v1
- 选【Ollama】，基础模型填模型名，API 域名填服务地址
- 选【本地模型】，基础模型填模型在容器内的绝对路径
支持模型
阿里云百炼DeepSeek腾讯混元火山引擎千帆大模型讯飞星火智谱AISILICONFLOW
bash
接入自建vLLM服务（国产开源模型同理） 打开【模型】页面，在供应商列表中选择【vLLM】 点击【添加模型】，进入模型配置表单填写 模型名称：qwen-local 模型类型：大语言模型 基础模型：下拉选或自定义输入，须与服务端模型名一致 API 域名：http://192.168.20.242:8000/v1 API Key：若没有API Key，输入任意字符即可 保存后在智能体配置的「AI 模型」中选择该模型
适用场景
• 智能客服与售前答疑机器人
• 企业内部制度与手册问答
• 教育与科研资料检索助手
• 给已有业务系统加问答入口
安装配置
bash
# 单条命令启动 MaxKB 容器 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 # 国内拉取镜像失败时参考官方离线安装文档：https://maxkb.cn/docs/installation/offline_installtion/
使用方法
bash
1) 浏览器访问 http://your_server_ip:8080 2) 用默认账号 admin、密码 MaxKB@123.. 登录，首次登录后立刻修改密码 3) 在模型管理中接入 DeepSeek、Qwen、OpenAI 等供应商，分别配置对话模型与向量模型 4) 新建知识库，上传本地文档或填写网址自动抓取，等待自动分段与向量化完成 5) 新建应用并关联该知识库，调试问答效果后复制嵌入代码挂到业务系统页面
优点
- 一条 docker run 即可拉起完整服务，端口 8080 与初始账号密码文档写得很清楚
- 内置工作流引擎、函数库与 MCP 工具调用，不只是单纯的检索问答
- 原生支持文本、图片、音频、视频的多模态输入输出
- 向量检索基于 PostgreSQL 与 pgvector，不必额外部署独立向量数据库
缺点
- 采用 GPL v3 许可，衍生产品对外分发时需同样以 GPLv3 开源，商业集成前要评估合规风险
- SSO 与访问控制等能力标注为专业版（Pro）功能，社区版不提供
- 默认密码 MaxKB@123.. 公开写在文档里，公网部署必须先改密码
- 国内网络常遇到 Docker 镜像拉取失败，需要改走官方离线安装包
- 数据目录默认挂在宿主机 ~/.maxkb，迁移与备份要自己规划