XuqmGroup-PrivateDeploy/CHANGELOG.md

# 更新日志

## 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
bash scripts/update.sh
```

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

---

## 2026.05.21-private.1

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

---

## 2026.05.18-private.1

- 初始版本