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

相关推荐
demo007x5 分钟前
Docling 文档转换以及技术架构分析
前端·后端·程序员
NE_STOP1 小时前
Vide Coding--AI编程工具的选择
java
用户5191495848451 小时前
Windows 渗透测试载荷加载器 POC 工具集
人工智能·aigc
袋鱼不重2 小时前
我的神奇同事,AI 用多了居然写了个 Open In Codex
前端·后端·ai编程
大树882 小时前
金刚石散热越强,管路越先见顶
大数据·运维·服务器·人工智能·ai
用户8356290780512 小时前
使用 Python 操作 Word 内容控件
后端·python
像我这样帅的人丶你还2 小时前
啥? 前端也要会干Java?🛵🛵🛵
后端
Hommy882 小时前
【剪映小助手】添加贴纸接口(Add Sticker)
后端·github·剪映小助手·视频剪辑自动化·剪映api
通信小呆呆2 小时前
当算法有了“五感”:多模态数据融合如何向人体感官协同学习?
人工智能·学习·算法·机器学习·机器人
施小赞2 小时前
普通 RAG vs GraphRAG 核心对比
人工智能·ai