用途:在不整体重新部署的情况下更新 Zeabur 服务配置,包括增改环境变量、重启单个服务,以及更新预构建/市场服务的镜像标签来切换版本。
必要用法:始终使用 npx zeabur@latest 调用 Zeabur CLI,不要直接用 zeabur 或其它安装方式;若无 npx,先安装 Node.js。
主要能力与步骤:
- 获取服务 ID:npx zeabur@latest service list --project-id <project-id> -i=false
- 查看当前变量:npx zeabur@latest variable list --id <service-id> -i=false 3a. 新增变量(键已存在会报错):npx zeabur@latest variable create --id <service-id> --key "KEY1=value1" --key "KEY2=value2" -i=false -y 3b. 更新已有变量(仅更新指定键):npx zeabur@latest variable update --id <service-id> --key "KEY1=new_value1" -i=false -y
- 重启服务:npx zeabur@latest service restart --id <service-id> -y -i=false
更新镜像标签(升级/降级版本):这是版本升级或降级的唯一正确路径,不要用 zeabur-deploy 或删除重建流程替代,否则可能孤立或清空服务挂载磁盘。标签更新会触发一次干净的重新部署,卷保持挂载。命令:npx zeabur@latest service update tag --id <service-id> -t <new-tag> -y -i=false。标志:--id(必填,不要用 --name)、-t/--tag(新镜像标签)、--env-id(可选,自动解析)、-y/--yes(跳过确认)。更新标签会触发新部署,服务将以新镜像重启。
适用场景:修复环境变量拼写错误、补充缺失配置、修改端口/URL/凭据、将预构建服务升级到更新版本,无需重新部署整个模板。
限制:${VAR} 引用需在 Dashboard 设置,不能在 CLI 中设置(Shell 会展开为空)。其余如具体权限或计费信息暂未提供。