快速上手 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

  • 镜像来源公有

  • 镜像地址

    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 仓库或评论区交流!

相关推荐
龙腾AI白云2 小时前
DNN案例一步步构建深层神经网络(二)三、深层神经网络
人工智能·神经网络
爱打代码的小林2 小时前
机器学习(决策树)
人工智能·决策树·机器学习
bybitq2 小时前
string,byte,rune,character?详解Golang编码-UTF-8
开发语言·后端·golang
guslegend2 小时前
SpringSecurity授权原理与实战
java
光羽隹衡2 小时前
机器学习——决策树
人工智能·决策树·机器学习
roman_日积跬步-终至千里2 小时前
【计算机视觉(17)】语义理解-训练神经网络2_优化器_正则化_超参数
人工智能·神经网络·计算机视觉
原来是好奇心2 小时前
深入Spring Boot源码(七):测试框架原理与最佳实践
java·源码·springboot
档案宝档案管理2 小时前
电子会计档案管理系统:档案宝如何发挥会计档案的价值?
大数据·数据库·人工智能·档案·档案管理
无限进步_2 小时前
【C语言】栈(Stack)数据结构的实现与应用
c语言·开发语言·数据结构·c++·后端·visual studio