diff --git a/CHANGELOG.md b/CHANGELOG.md
new file mode 100644
index 0000000..b825895
--- /dev/null
+++ b/CHANGELOG.md
@@ -0,0 +1,37 @@
+# 更新日志
+
+## 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 服务指向，无需额外调用
+
+### 升级方法
+
+在私有化服务器上执行：
+
+```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
+
+- 初始版本
diff --git a/VERSION b/VERSION
index 10b798a..e826ca6 100644
--- a/VERSION
+++ b/VERSION
@@ -1 +1 @@
-2026.05.21-private.1
+2026.05.21-private.2
diff --git a/image-manifest.json b/image-manifest.json
index 4aeb5d0..14b66b3 100644
--- a/image-manifest.json
+++ b/image-manifest.json
@@ -1,6 +1,6 @@
 {
   "schemaVersion": 1,
-  "privateVersion": "2026.05.18-private.1",
+  "privateVersion": "2026.05.21-private.2",
   "registry": "registry.example.com/xuqm",
   "images": [
     {"name": "tenant-service", "required": true},