Zeabur CLI 日志查看指南

March, 2nd 2026 3 min read • Markdown
Zeabur CLI 日志查看指南：终端排查部署问题

项目部署在 Zeabur 上，可通过 CLI 在终端查看运行日志和构建日志。

前置准备

bash
12345 
# 首次使用需登录（浏览器授权）
npx zeabur auth login

# 或用 API Token 登录
npx zeabur auth login --token <YOUR_TOKEN>

项目信息速查

服务Service ID说明
Web (Next.js)<your-web-service-id>API 服务
Bot (DingTalk)<your-bot-service-id>钉钉机器人
Project ID<your-project-id>项目
Environment ID<your-env-id>production

常用命令

1. 查看当前部署状态

bash
1234567891011 
# Web 服务
npx zeabur deployment get \
  --service-id <your-web-service-id> \
  --env-id <your-env-id> \
  -i=false

# Bot 服务
npx zeabur deployment get \
  --service-id <your-bot-service-id> \
  --env-id <your-env-id> \
  -i=false

输出会包含 deployment ID 和状态（DEPLOYING / RUNNING / REMOVED）。

2. 查看运行日志

注意：必须同时传 --deployment-id 和 --service-id，缺一不可。

bash
1234567891011 
# Web 服务运行日志
npx zeabur deployment log \
  --deployment-id <DEPLOY_ID> \
  --service-id <your-web-service-id> \
  -t=runtime -i=false

# Bot 服务运行日志
npx zeabur deployment log \
  --deployment-id <DEPLOY_ID> \
  --service-id <your-bot-service-id> \
  -t=runtime -i=false

3. 实时跟踪日志

加 -w 参数可以 watch 模式实时输出：

bash
1234 
npx zeabur deployment log \
  --deployment-id <DEPLOY_ID> \
  --service-id <your-web-service-id> \
  -t=runtime -w -i=false

4. 查看构建日志

bash
1234 
npx zeabur deployment log \
  --deployment-id <DEPLOY_ID> \
  --service-id <your-web-service-id> \
  -t=build -i=false

5. 列出历史部署

bash
1234 
npx zeabur deployment list \
  --service-id <your-web-service-id> \
  --env-id <your-env-id> \
  -i=false

快捷操作：一行拿到最新日志

由于每次都要先查 deployment ID 再看日志，比较麻烦。可以组合使用：

bash
1234 
# Web 服务：查状态 + 看日志（两步走）
npx zeabur deployment get --service-id <your-web-service-id> --env-id <your-env-id> -i=false
# 从输出中复制 deployment ID，然后：
npx zeabur deployment log --deployment-id <粘贴ID> --service-id <your-web-service-id> -t=runtime -i=false

其他有用命令

bash
1234567891011 
# 列出所有服务
npx zeabur service list --project-id <your-project-id> -i=false

# 重启服务
npx zeabur service restart --service-id <SERVICE_ID> --env-id <your-env-id> -i=false

# 重新部署
npx zeabur service redeploy --service-id <SERVICE_ID> --env-id <your-env-id> -i=false

# 查看环境变量
npx zeabur variable list --service-id <SERVICE_ID> --env-id <your-env-id> -i=false

踩坑记录

  1. runtime 日志返回空 — 必须同时传 --deployment-id 和 --service-id，只传 --service-id 会返回空表格
  2. -i=false — 非交互模式，不加的话 CLI 会进入交互选择界面
  3. DEPLOYING 状态的部署没有 runtime 日志 — 还在构建中，只有 build 日志，等变成 RUNNING 才有 runtime 日志