upgrade —— 自升级

自升级 CertiMan 二进制到最新版本。从官方分发地址获取 latest.json，下载对应平台的二进制并校验 SHA256 后，替换当前可执行文件。升级不修改数据目录 ~/.certiman。

Windows 上的旧版本

Windows 无法在运行时直接替换正在执行的 .exe。CertiMan 会把旧版本重命名保留，下次运行 certiman upgrade 时自动清理，用户无需手工处理。

升级链路无条件校验证书

upgrade 获取版本清单与二进制时无条件严格校验证书，CERTIMAN_INSECURE / insecure_skip_verify 对此链路无效。

用法

certiman upgrade [flags]

参数

flag	类型	默认	说明
--check	bool	false	只检查新版本、不安装

示例

# 检查是否有新版本
certiman upgrade --check

# 直接升级到最新版本
certiman upgrade

输出

0已是最新版本（示例）

✔ 已是最新版本 1.x.y(通道 release)

0upgrade --check -o json（示例）

{
  "current_version": "1.x.y",
  "latest_version": "1.x.z",
  "channel": "release",
  "update_available": true,
  "upgraded": false,
  "release_date": "2026-08-07T06:32:35Z",
  "release_notes": "1.x.z",
  "install_url": "https://certiman.trustasia.com/cli/release/install.sh"
}

0升级成功

» 发现新版本 1.x.z(通道 release)
  1.x.z
  安装脚本:https://certiman.trustasia.com/cli/release/install.sh
正在下载 <产物下载地址>
✔ 已升级到 1.x.z
i 建议运行 `certiman doctor` 校验数据与配置的兼容性
i 配置文件的 schema 迁移将在下次运行 doctor 或定时任务时自动完成
项        值
当前版本  1.x.y
最新版本  1.x.z
发布通道  release
有新版    是
发布时间  2026-08-07T06:32:35Z
变更说明  1.x.z

1SHA256 不匹配（不安装）

» 发现新版本 1.x.z(通道 release)
  1.x.z
  安装脚本:https://certiman.trustasia.com/cli/release/install.sh
正在下载 <产物下载地址>
错误: 产物校验未通过,已终止升级且未改动任何文件:<校验详情>

相关命令

• version —— 查看当前版本
• doctor —— 检查升级相关的环境（schema 版本、权限）