在线升级
这个功能解决什么问题
已安装的私有化部署可以通过界面一键升级到新版本，全程自动备份数据库、失败自动回滚——不需要联系支持人员发放升级令牌（正式许可证维护期内），也不需要手工操作服务器。
升级方式选择
| 方式 | 适用场景 | 前置条件 |
|---|---|---|
| 界面自助升级（推荐） | 许可证维护期内的日常升级 | 平台 ≥ 1.2.0 且含升级代理（1.1.0 后在线安装均含） |
| 界面 + 升级令牌 | 维护期已过期、或离线签发的许可证 | 向支持人员领取一次性升级令牌 |
| 命令行一键升级 | 1.1.0 之前安装的旧部署（最后一次 CLI 升级） | 同样使用升级令牌 |
界面自助升级（免令牌）
打开升级入口
进入「管理中心 → 系统管理 → License」页面。平台会自动检查可用更新。
查看可用版本
有新版本时，升级弹窗直接显示「可升级到 vX.Y.Z」以及当前版本。若提示「已是最新版本」则无需操作。
一键升级
点击「升级到 vX.Y.Z」。升级期间显示全屏进度（校验 → 备份 → 拉取镜像 → 切换服务 → 版本门禁 → 收尾），期间服务会中断数分钟。
自动完成
版本门禁通过后页面自动刷新进入新版本。任何一步失败都会自动回滚到原版本，数据无损。
自助升级的权益来源
自助升级的授权来自当前许可证的维护期：维护期内可自由升级；维护期到期后不再获得新版本（界面会明确提示），续订维护期后恢复。新版本可能采用分批推送——如果你的部署暂未进入当前批次，升级时会看到「正在分批推送」的提示，稍后再试即可。
使用升级令牌
维护期已过期、或使用离线签发许可证的部署，可通过一次性升级令牌升级：
- 向支持人员索取升级令牌（与你的客户身份绑定，一次有效）。
- License 页升级弹窗中点击「使用升级令牌」，粘贴令牌后开始升级。
命令行升级（旧部署）
1.1.0 之前安装的部署没有升级代理，使用命令行完成最后一次 CLI 升级（之后即可使用界面升级）：
curl -sSL "https://download.vortlab.cn/upgrade?t=<升级令牌>" | bash
注意事项
升级前必读
- 升级前会先执行共享预检（数据库、磁盘、网络连通，CUDA 版还会检查 GPU 与驱动状态），并在停止旧容器之前串行拉取全部新版镜像——预检或镜像拉取失败时升级直接中止，旧版本服务不受影响。
- 升级永远保持已部署的设备类型（CPU / CUDA）；需要切换设备类型请联系支持人员走重新安装流程。
- 升级期间服务中断数分钟，请安排在业务空闲时段。
- 升级前系统自动在
/opt/vortlab/backups/创建数据库备份；不要在该目录存放其他文件。 - 升级过程不要关闭页面或断电——即使意外中断，升级代理也会在下次启动时自动回滚到安全状态。
- 确认服务器磁盘剩余空间 ≥ 10GB（新版镜像增量拉取）。