XuqmGroup-PrivateDeploy/CHANGELOG.md

更新日志

2026.06.18-private.1

修复

Flyway 迁移校验和不匹配导致服务 crash-loop

• 所有服务的 application.yml 添加 spring.flyway.validate-on-migrate: false
• 升级后即使迁移文件被修改，服务也能正常启动，不会因 checksum 不匹配而崩溃
• 故障排查文档补充 Flyway checksum mismatch 处理说明

升级方法

在私有化服务器上执行：

bash scripts/update.sh

---

2026.05.21-private.2

变更

授权管理（License）

• 最大设备数配置迁移至租户平台（/services/license/:appKey），租户可自行修改，无需联系运营
• 移除了运营后台的授权管理入口

Android SDK

• 版本升级至 1.0.1，新增 serverUrl 参数
• XuqmSDK.initialize(context, appKey, serverUrl = "https://your-server.com") 即可完成私有化初始化，SDK 内部自动配置所有服务端点及 License 服务指向，无需额外调用

私有化部署配置修复

• 修复 config/xuqm.env 缺少 LICENSE_PUBLIC_BASE_URL 的问题：此前生成的 license.xuqm 中 baseUrl 指向公有云地址，导致 SDK 通过 license.xuqm 自动初始化时 License 请求打到公有云服务器
• scripts/update.sh 和 scripts/deploy.sh 均已补充此配置项，升级脚本会自动将其更新为私有服务器地址

升级方法

在私有化服务器上执行：

bash scripts/update.sh

升级脚本会自动拉取最新镜像并重启受影响容器，全程无需停机迁移。

---

2026.05.21-private.1

• 新增 scripts/reset.sh 容器重置脚本，解决 nginx 502 / crash-loop / 镜像不生效等问题
• 完善故障排查文档（docs/runbook.md）
• 修正各服务端口文档

---

2026.05.18-private.1

• 初始版本