---
title: Zeabur CLI 日志查看指南：终端排查部署问题
slug: zeabur-cli
date: 2026-03-02
author: Frankie 徐
category: devops
tags: ['zeabur', 'cli', 'devops', 'deployment']
description: 通过 Zeabur CLI 在终端查看运行日志和构建日志，快速排查部署问题。涵盖登录、部署状态、日志查看等常用命令。
permalink: https://www.210k.cc/zeabur-cli
---

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

## 前置准备

```bash
# 首次使用需登录（浏览器授权）
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
# 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
# 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
npx zeabur deployment log \
  --deployment-id <DEPLOY_ID> \
  --service-id <your-web-service-id> \
  -t=runtime -w -i=false
```

### 4. 查看构建日志

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

### 5. 列出历史部署

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

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

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

```bash
# 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
# 列出所有服务
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 日志