🚀 在 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/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 天）
为方便大家快速体验，我已部署了一个公开实例：
🔗 https://oxbasujgpsfa.sealoshzh.site/admin/login
- 超管账号：
admin - 密码：
tarzan@1234567
⚠️ 安全提醒：
该账户为公开共享，请勿用于生产或存储敏感数据。体验完毕后建议及时删除服务，避免潜在风险。
✅ 至此，您已在 Sealos 上成功部署 MaxKB4J 及其全部依赖。如果您觉得这个项目有用，欢迎访问它的开源主页 👉 https://gitee.com/taisan/MaxKB4j ，点个 Star ⭐、提 Issue 或贡献代码，一起推动开源 AI 工具的发展！
如有任何问题，欢迎在 Gitee 仓库或评论区交流！
浙公网安备 33010602011771号