Zeabur CLI

Zeabur CLI 让你从终端管理所有 Zeabur 资源——部署服务、查看日志、管理项目，无需打开控制面板。

部署服务

在你的项目目录下运行以下命令：

npx zeabur@latest deploy

CLI 自动检测框架，引导你选择或创建项目。部署完成后，服务 URL 会显示在终端。

工作区（团队）

工作区是指 CLI 当前操作的账号：你的个人账号，或你所属的某个团队。工作区是上下文的最外层范围——切换工作区会清除已保存的项目、环境和服务，因为个人账号与团队之间不共享资源 ID。

默认情况下，CLI 操作的是你的个人账号。在操作团队资源之前，请先切换到该团队的工作区（或传入 --workspace），否则命令会作用于你的个人账号。

列出工作区

显示你的个人工作区以及你所属的每个团队，并标注你在其中的角色。当前工作区会被标记出来。

npx zeabur@latest workspace list

查看当前工作区

npx zeabur@latest workspace current

切换到团队

参数为团队的名称或其 24 位字符 ID。如果某个名称匹配到多个团队，CLI 会列出候选项，供你按 ID 选择。

npx zeabur@latest workspace switch <team-name-or-id>

返回个人工作区

npx zeabur@latest workspace clear

单次覆盖

使用全局 --workspace 标志可以在另一个工作区中运行单条命令，而不改变你已保存的工作区。这在 CI 和脚本中很方便：

npx zeabur@latest --workspace <team-name-or-id> project ls

项目管理

列出项目

npx zeabur@latest project ls

设置项目上下文

npx zeabur@latest context set project

在交互模式下，会列出所有项目供选择。后续命令将自动应用到选定的项目。

服务管理

列出服务

npx zeabur@latest service ls

设置服务上下文

npx zeabur@latest context set service

重启服务

npx zeabur@latest service restart

部署信息和日志

查看部署状态

npx zeabur@latest deployment get

查看运行时日志

npx zeabur@latest deployment log -t=runtime

查看构建日志

npx zeabur@latest deployment log -t=build

切换环境

npx zeabur@latest context set env

在部署环境（如生产、预发布）之间切换。

非交互模式

用于 CI/CD 流水线或自动化脚本，添加 -i=false 禁用交互提示并直接传递参数：

按名称指定项目和服务

npx zeabur@latest context set project --name <project-name>
npx zeabur@latest context set service --name <service-name>
npx zeabur@latest context set env --id <env-id>

按 ID 指定

npx zeabur@latest context set project --id <project-id>
npx zeabur@latest context set service --id <service-id>

一行命令操作

跳过上下文设置，内联传递所有参数：

npx zeabur@latest service restart --env-id <env-id> --service-name <service-name>
npx zeabur@latest deployment get --env-id <env-id> --service-name <service-name>
npx zeabur@latest deployment log -t=runtime --env-id <env-id> --service-name <service-name>

获取帮助

在任何命令后添加 --help 查看用法：

npx zeabur@latest --help
npx zeabur@latest deployment --help

最后更新于 2026年3月26日

用量与账单 Claude Code Skills