用途:列出与查看 Zeabur 专用服务器信息,并支持 SSH 登录与远程执行命令。
主要能力:
- 列出全部服务器:npx zeabur@latest server list -i=false,输出 ID、名称、IP、供应商、位置、状态、VM 状态与 OS。
- 仅 ZeaburOS 的机器可承载 Zeabur 项目;Ubuntu 需先安装 ZeaburOS。是否可承载以列表 OS 列为准,不要靠 SSH 判断。
- JSON 输出:npx zeabur@latest server list -i=false --json,其中 os 字段与 OS 列含义一致,需 CLI 0.21.0 或更新;若两者均缺失说明 CLI 较旧,可改用 hasK3s 字段(详见 zeabur-server-ssh 技能,注意其三种状态)。
- 详情:npx zeabur@latest server get <server-id> -i=false,显示 OS、CPU/内存/磁盘用量、供应商、位置、托管状态、创建时间;资源列为 已用/总量,CPU 以毫核计(148/4000 m 即 4 核的 0.15),内存与磁盘以 MB 计,—表示未测量。
- 重启:npx zeabur@latest server reboot <server-id> -y,-y 跳过确认,非交互使用必需。
- SSH:npx zeabur@latest server ssh <server-id>。托管服务器自动获取密码;装了 sshpass 可全自动登录,否则打印密码手动输入。非交互环境用管道:echo 'kubectl get pods -A' | npx zeabur@latest server ssh <server-id> -i=false;多命令用 ; 或 && 分隔。输出含 MOTD 横幅,解析时需过滤。远程命令返回非零退出码时 CLI 会打印 ERROR exit status 1,不代表 SSH 连接失败。heredoc(<<'EOF')不可靠,应使用 echo '...' |。
项目与服务器关系:项目部署在服务器上时 Region.ID 为 server-<server-id>;在 ZeaburOS 上部署服务应使用 zeabur-deploy 技能,而非 SSH 手动配置;SSH 仅用于底层调试(如 kubectl、磁盘、网络诊断)。纯 Ubuntu VPS 上 SSH 是主要使用方式,可自行搭建 docker compose、1Panel、宝塔等,不存在 Zeabur 服务且无 kubectl。
限制:始终用 npx zeabur@latest 调用,不要直接使用 zeabur 或其他安装方式;无 npx 先安装 Node.js。租用服务器默认提供 Ubuntu,需先装 ZeaburOS 才能承载项目,直接安装仅适用于空白机器,已有数据的机器转换需在面板重装并会清空磁盘。