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

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

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

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

1️⃣ 创建 PostgreSQL 数据库

➡️ 操作路径

🔧 配置参数

数据库类型 ：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
镜像来源 ：公有

镜像地址 ：

bash 复制代码

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

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

⚙️ 高级配置 → 环境变量

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

bash 复制代码

SPRING_DATASOURCE_URL=jdbc:postgresql://<POSTGRES_HOST>:5432/maxkb4j
SPRING_DATASOURCE_USERNAME=postgres
SPRING_DATASOURCE_PASSWORD=<POSTGRES_PASSWORD>
SPRING_DATA_MONGODB_URI=mongodb://root:<MONGO_PASSWORD>@<MONGO_HOST>:27017/mongo?authSource=admin
SERVER_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 天）

为方便大家快速体验，我已部署了一个公开实例：

🔗 oxbasujgpsfa.sealoshzh.site/admin/login

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

⚠️ 安全提醒 ：

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

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

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