系统升级

系统平台 → 系统升级，用于升级 ThinkLink 自身（不是网关、不是固件）。

页面顶部显示当前部署的核心版本信息：

字段	含义
mode	部署形态：gw（TKG，网关版） / tke（独立部署版） / tkc（Docker 容器部署）
DB.Ver	当前数据库 schema 版本
P.Ver	当前程序版本

关键：TKG 与 TKE 升级包不通用

后端会根据当前 mode 校验上传包的文件名前缀，传错包会直接被拒：

当前 mode	接受的升级包前缀	示例
gw	tkg 开头	tkg-2.00.020.tar.gz
tke 或 tkc	tke 开头	tke-2.00.020.tar.gz

不要混传

• TKG 包（tkg-*.tar.gz）只能传给 mode=gw 的网关版部署。
• TKE 包（tke-*.tar.gz）可以传给 mode=tke 或 mode=tkc 的部署，独立部署和 Docker 部署共用同一类包。
• 上传错前缀的包会立即报"The upgrade package name is invalid"。

升级流程

1. 备份数据库（强烈建议）。
2. 准备好与当前 mode 匹配的 .tar.gz 升级包。
3. 点页面上的 上传并升级，选择升级包。
4. 后端自动完成以下动作：
   • 把上传的 .tar.gz 解压到升级目录；
   • 校验解压后是否包含 tkl_upgrade.sh，没有就报错回滚；
   • 执行 tkl_upgrade.sh 完成主升级；
   • 如果存在 tkl_post_upgrade.sh，再执行清理脚本（删除上传包、清空升级目录）。
5. 升级过程中 ThinkLink 服务可能重启，页面会短暂不可用。等服务恢复后刷新，查看 P.Ver / DB.Ver 是否变成新版本。

风险提示

• 升级前务必备份数据库，并确认有回退方案。
• 升级期间不要断电、不要 kill 进程。
• 网关上的 TKG 部署在远端时，确保你有 SSH 兜底通道，万一 Web 服务起不来可以从后台干预。
• 大版本之间的 schema 变更不可逆，跨多个版本升级前先看对应版本的 release notes。

与"网关升级包"的区别

	系统升级（本页）	网关升级包
升级谁	ThinkLink 本体（TKG/TKE/TKC）	被纳管的网关设备固件
谁操作	admin 在系统平台直接上传	admin 上传到系统，租户在自己的"网关管理"页下发