快速上手 MaxKB4J：开源企业级 Agentic 工作流系统在 Sealos 上的完整部署指南

🚀 在 Sealos 云平台部署 MaxKB4J 及其依赖数据库（PostgreSQL + MongoDB）

本文将指导您在 Sealos 云平台 上完整部署MaxKB4J应用及其所需的两个数据库服务：PostgreSQL（用于关系型数据存储）和MongoDB（用于非结构化文档存储）。整个过程适用于演示或开发环境。

💡关于 MaxKB4J
MaxKB4J 是一款基于 Java 开发的开源 LLM 工作流与 RAG（检索增强生成）平台，借鉴了 MaxKB、Dify 和 FastGPT 的设计理念，专注于高性能、高稳定性和企业级安全。它广泛应用于智能客服、企业知识库、学术研究与教育等场景。欢迎 Star ⭐ 并参与贡献！

1️⃣ 创建 PostgreSQL 数据库

➡️ 操作路径

登录 Sealos 控制台 →数据库→新建

🔧 配置参数

• 数据库类型：PostgreSQL
• 容器服务名称：postgresql

  ✅ 命名规则：仅支持小写字母、数字和连字符-，且必须以字母开头。

• 资源配置：演示用途建议选择最低配置
• 备份设置：建议关闭（演示环境无需备份）

✅ 部署后记录关键信息（后续配置必需）：

• 用户名：postgres
• 密码：部署完成后页面显示，请妥善保存
• 内网 Host：如postgresql-postgresql.ns-xxxx.svc
• 端口：5432

⚠️重要提示：
默认使用postgres数据库可能导致 Flyway 初始化失败。请进入数据库管理界面，手动创建一个名为maxkb4j的新数据库。

2️⃣ 创建 MongoDB 数据库

➡️ 操作路径

Sealos 控制台 →数据库→新建

🔧 配置参数

• 数据库类型：MongoDB
• 容器服务名称：mongo

  ✅ 同样需符合命名规范：仅含[a-z0-9-]，且以小写字母开头

• 资源配置：演示环境 →全选最低配置
• 备份设置：可关闭

✅ 部署后记录连接信息：

• 用户名：通常为root
• 密码：部署后页面显示，请记录
• 内网 Host：如mongo-mongodb.ns-xxxx.svc
• 端口：27017

💡连接说明：
Sealos 会自动创建admin认证数据库，因此完整的 MongoDB 连接 URI 必须包含?authSource=admin参数。

3️⃣ 部署 MaxKB4J 应用

➡️ 操作路径

Sealos 控制台 →应用→新建应用

🔧 基础配置

• 应用名称：maxkb4j
• 镜像来源：公有
• 镜像地址：

  registry.cn-hangzhou.aliyuncs.com/tarzanx/maxkb4j

• 网络设置：
  • 容器端口：80
  • 开启公有网络（可选绑定已备案域名）
  • 实例数：至少1个
  • CPU：最小0.5核
  • 内存：最小256MB

⚙️ 高级配置 → 环境变量

请根据您实际创建的数据库信息，替换以下占位符：

SPRING_DATASOURCE_URL=jdbc:postgresql://<POSTGRES_HOST>:5432/maxkb4jSPRING_DATASOURCE_USERNAME=postgresSPRING_DATASOURCE_PASSWORD=<POSTGRES_PASSWORD>SPRING_DATA_MONGODB_URI=mongodb://root:<MONGO_PASSWORD>@<MONGO_HOST>:27017/mongo?authSource=adminSERVER_PORT=80

🔑 替换说明：

• <POSTGRES_HOST>：PostgreSQL 的内网地址（如postgresql-postgresql.ns-xxxx.svc）
• <POSTGRES_PASSWORD>：PostgreSQL 部署时生成的密码
• <MONGO_HOST>：MongoDB 的内网地址（如mongo-mongodb.ns-xxxx.svc）
• <MONGO_PASSWORD>：MongoDB 部署时生成的密码

⚠️注意：
请务必使用控制台中显示的实际内网地址。

✅ 完成部署

点击右上角「部署」按钮，等待应用状态变为运行中。首次部署需拉取 Docker 镜像，可能需要几分钟时间。

🎉 部署成功！

部署完成后，Sealos 将提供一个公网访问地址（例如：http://xxx.sealos.run），打开即可使用 MaxKB4J。

🔐 默认登录凭证

• 用户名：admin
• 初始密码：tarzan@123456

📌首次登录后请立即修改密码！

🌐 公开体验地址（有效期约 60 天）

为方便大家快速体验，我已部署了一个公开实例：
🔗 https://oxbasujgpsfa.sealoshzh.site/admin/login

• 超管账号：admin
• 密码：tarzan@1234567

⚠️安全提醒：
该账户为公开共享，请勿用于生产或存储敏感数据。体验完毕后建议及时删除服务，避免潜在风险。

✅ 至此，您已在 Sealos 上成功部署 MaxKB4J 及其全部依赖。如果您觉得这个项目有用，欢迎访问它的开源主页 👉 https://gitee.com/taisan/MaxKB4j ，点个Star ⭐、提 Issue 或贡献代码，一起推动开源 AI 工具的发展！

如有任何问题，欢迎在 Gitee 仓库或评论区交流！