企业级AI智能体平台MaxKB本地部署教程,帕斯内网穿透实现公网访问智能问答系统
作者
小编
发布时间

项目介绍
MaxKB 是一个强大易用的企业级智能体平台,全称为 Max Knowledge Brain。这是一个开源的企业级智能体构建平台,集成了检索增强生成(RAG)管道,支持强大的工作流程,并提供先进的 MCP 工具使用能力。MaxKB 广泛应用于智能客服、企业内部知识库、学术研究和教育等场景。
该平台具有以下核心特性:
- RAG 管道:支持直接上传文档或自动爬取在线文档,具备自动文本分割、向量化功能,有效减少大模型的幻觉问题,提供卓越的智能问答交互体验
- 智能体工作流:配备强大的工作流引擎、函数库和 MCP 工具使用,能够编排 AI 流程以满足复杂业务场景的需求
- 无缝集成:支持零代码快速集成到第三方业务系统,快速为现有系统配备智能问答能力,提升用户满意度
- 模型无关性:支持各种大模型,包括私有模型(如 DeepSeek、Llama、Qwen 等)和公共模型(如 OpenAI、Claude、Gemini 等)
- 多模态支持:原生支持文本、图像、音频和视频的输入输出
项目地址: 点我跳转
部署安装
如需在外也打开项目需要配置内网穿透使用,点击前往 帕斯内网穿透,先注册好账号备用。
MaxKB 提供了最简单的 Docker 单命令部署方式,非常适合技术小白快速上手。
打开飞牛 NAS 或其他的 NAS 设备 点击本地镜像-添加镜像-从 URL 添加。这一步先添加 docker 镜像

镜像填 1panel/maxkb
等待下载完成后点击启动按钮启动容器

勾选开机自动启动后下一步,端口设置这里。请设置容器内端口为 8080,主机端口也设置为 8080(如果端口冲突可以修改主机端口,比如改为 8081,但容器内端口必须保持 8080)
存储位置这里,需要创建两个文件夹映射:
- 创建一个文件夹(如 maxkb-data)映射到容器的 /var/lib/postgresql/data
用于数据库数据持久化
- 创建另一个文件夹(如 python-packages)映射到容器的 /opt/maxkb/app/sandbox/python-packages
用于 Python 包缓存
环境变量设置:无需设置任何环境变量,MaxKB 使用默认配置即可正常运行。所有配置都可以在 Web 界面中进行设置。
其他的都不用填写,直接下一步启动就好了。
创建成功后可以访问 ip:8080 默认管理员账号:
- 用户名:admin - 密码:MaxKB@123..
到这里就可以正常显示项目了
穿透公网
打开帕斯内网穿透控制台,点击隧道管理-隧道列表

点击创建新隧道
隧道节点可以随便选,一般选个负载低的就可以

接下来填写信息,隧道名称可以随便填写
本地 IP 默认就可以
传输协议可以选择 TCP 也可以选择 HTTP/HTTPS
HTTP 就是域名的形式,教程以使用 TCP 为演示
本项目中如果没有修改端口的话默认是 8080 端口,这里本地端口就填 8080
远程端口可以留空也可以自定义。下图仅做参考,请按照实际项目端口添加。

填写完毕点击确定
点击刚才创建好的隧道,点击获取配置文件

回到飞牛 NAS,点击应用中心下载 frpc 客户端

打开后粘贴刚才复制的配置文件,点击确定即可
复制帕斯内网穿透控制台的访问 IP 和端口
可以看到已经正常穿透成功了
本篇教程结束