用途:处理 Zeabur 环境变量的全部操作,包括创建、列出、更新、删除和排障。
主要能力与用法:始终使用 npx zeabur@latest 调用 Zeabur CLI,不要直接使用 zeabur 或其他安装方式;若没有 npx,先安装 Node.js。有效子命令只有 create、update、delete、env、list,set、add 等不存在且会静默失败。
创建:npx zeabur@latest variable create --id <service-id> -k "KEY1=value1" -k "KEY2=value2" -y -i=false,键已存在会报错,需改用 update。更新:npx zeabur@latest variable update --id <service-id> -k "KEY1=new_value1" -y -i=false,只更新指定键。删除:npx zeabur@latest variable delete --id <service-id> --delete-keys "KEY1" -y -i=false,只删除指定键。列出:npx zeabur@latest variable list --id <service-id> -i=false。从 .env 加载:npx zeabur@latest variable env --id <service-id> -f .env,会替换服务上的全部变量,文件中没有的现有变量将被移除,执行后需手动重启服务。
限制与已知问题:使用 --id 而非 --name,名称查找不可靠。${VAR} 可能为空,因为 shell 在 CLI 接收前已展开,应使用单引号;但 CLI 的 -k 使用 Cobra StringToStringVar 解析器,即使单引号也可能截断或清空含 ${} 的值。跨服务变量引用(如 ${POSTGRES_CONNECTION_STRING},Zeabur 使用扁平命名空间,无需服务前缀)建议在 Zeabur Dashboard 中设置,或使用 GraphQL API 的 updateEnvironmentVariable(data: Map!) mutation,直到 CLI 缺陷修复。