# 「The runner has received a shutdown signal」：原因，以及有足夠記憶體修好它的 Runner

> 在 GitHub 託管 Runner 上，GitHub 確認的原因是記憶體：作業把記憶體用光，VM 在記憶體不足的訊息寫進紀錄之前就停了。私有儲存庫的 ubuntu-latest 只有 8 GB。Skipbox 以每月固定 $39 給作業 16 GB，或以 $149 給 32 GB，分鐘數不限。

你的作業以「The runner has received a shutdown signal」結束，沒有 exit code。在 GitHub 託管 Runner 上，GitHub 的維護者確認的原因是記憶體：私有儲存庫的 `ubuntu-latest` 只有 8 GB，一旦用光，VM 就會在任何記憶體不足的訊息寫進紀錄之前停止。每次重試都在燒分鐘數，也擋住合併。

Skipbox 以固定價格給作業它需要的記憶體：`runs-on: skipbox` 是 16 GB，每月 $39；`skipbox-16x32` 是 32 GB，每月 $149，分鐘數不限。

- `runs-on: skipbox` 的記憶體是私有儲存庫 `ubuntu-latest` 的兩倍，`skipbox-16x32` 是四倍
- 16 GB 每月 20,000 分鐘：GitHub 的 4 核心 Runner 上要 $222，Skipbox 上固定 $39
- 你的專屬機器保留 Docker 層和套件快取，所以成功的那次重新執行也更快

**GitHub Actions 固定價格，分鐘數不限** Skipbox 在你的專屬機器上執行 GitHub Actions 作業：每月 $39，不論執行多少分鐘。Docker 層和相依套件快取在作業之間保留，下一個作業馬上就能開始。

4 vCPU Runner，每月 20,000 分鐘: GitHub $222 → Skipbox $39. 每月省下 $183.

換過來只要改一行：`runs-on: skipbox`。

[開始 7 天免費試用](https://app.skipbox.dev/sign-in?ref=g-github-actions-runner-shutdown-signal-zh-hant)

## 這則訊息是什麼意思

Runner 應用程式的程序在作業進行中被要求停止時，就會記錄這則訊息：「The runner has received a shutdown signal. This can happen when the runner service is stopped, or a manually started runner is canceled.」，意思是 Runner 服務被停止，或手動啟動的 Runner 被取消時都可能發生。接著步驟會以「The operation was canceled.」結束，沒有 exit code，因為你的指令沒有一個失敗。

| 紀錄顯示 | 發生了什麼 |
|---|---|
| shutdown 那一行，沒有 exit code，也沒有人取消執行 | VM 的記憶體用光，停掉了 |
| `Process completed with exit code 137.` | 核心為了記憶體終止了一個程序；Runner 還活著 |
| shutdown 那一行，而執行頁面顯示它被取消了 | 較新的執行、某個人或逾時結束了它 |

在 actions/runner-images issue #15202 中，一位 GitHub 維護者在 8 GB 的 `ubuntu-24.04` Runner 上重現了這個問題：在記憶體加 swap 以內的作業通過，超過的作業就以這則訊息失去 Runner。新的映像檔可能在你這邊什麼都沒改的情況下觸發它，原因是新的預設工具版本比舊的需要更多記憶體。

## 停在 8 GB 的代價

每次失去的執行，都是白白計費的分鐘數、一次重新執行，以及一個無法合併的 Pull Request。繞過它也是工作：

- 減少測試 worker、`make -j` 或 Gradle 的 worker 數，讓作業跑得更慢
- 限制 Node 的 `--max-old-space-size` 或 JVM 的 `-Xmx`
- 把一個作業拆成好幾個，再把它們接回去
- 固定某個工具版本，直到有人有時間修好它

記憶體需求只會增加：更大的測試套件、更大的建置、程式設計代理推送修正帶來的更多作業。GitHub 的答案是大型 Runner，每一分鐘都計費：

| 記憶體 | 有這個記憶體的 GitHub Runner | 每月 20,000 分鐘 | Skipbox | 每月，分鐘數不限 |
|---|---|---|---|---|
| 16 GB | 4 核心大型 Runner，每分鐘 $0.012 | $222 | `skipbox`，S 方案 | $39 |
| 32 GB | 8 核心大型 Runner，每分鐘 $0.022 | $422 | `skipbox-16x32`，L 方案 | $149 |

GitHub 的金額以 GitHub Team 計算，已扣除它的內含運算額度；大型 Runner 需要 Team 或 Enterprise Cloud。在[首頁的費用試算](https://skipbox.dev/?ref=g-github-actions-runner-shutdown-signal-zh-hant#cost)查看你自己的分鐘數。

你自己的自架 Runner 在 GitHub 的帳單上不花一毛錢，但每當它的服務重新啟動、主機為了修補而重新開機，或自動擴充工具把機器拿走時，都會出現同樣的訊息。要把它跑好，就是伺服器、修補、清理和擴充。

## Skipbox 修好它

### 記憶體，固定價格

| `runs-on` | 機器 | 方案，每月 |
|---|---|---|
| `skipbox` | 4 vCPU，16 GB | S，$39 |
| `skipbox-8x16` | 8 vCPU，16 GB | M，$79 |
| `skipbox-16x32` | 16 vCPU，32 GB | L，$149 |

分鐘數不限。Skipbox 以自架 Runner 的形式註冊，所以它的作業不用你的任何 GitHub 分鐘數，也不會在 Actions 預算那裡停下來。超出方案機器容量的作業會排隊等候。

### 更快的重新執行

每個方案都是為你的帳號保留的一台 VM。Docker 映像檔、層和建置快取、套件快取和工具快取都留在它的磁碟上，所以下一次執行會帶著它們開始，而不是全部重新下載。

### 不用照顧的機器

Skipbox 讓映像檔保持更新、清除每個作業的憑證、程序和容器（從 2026 年 11 月 13 日起，checkout 和 Cargo 的 `target/` 會留下來）、在每個作業後對機器做健康檢查，並重建檢查失敗的機器。VM 執行 Ubuntu 24.04，裝有 Docker、Node.js 和 Python。

## 換過去只要改一行

```yaml
jobs:
  build:
    runs-on: skipbox # was ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - run: npm ci && npm test
```

1. 使用 GitHub 登入 Skipbox。
2. 安裝 Skipbox GitHub App，並選擇儲存庫。
3. 修改 `runs-on` 並推送。

`skipbox` 在每個方案上都能執行，`skipbox-16x32` 在 L 方案上執行。要移回去，把那一行改回來就好。

## 用你自己的作業試試看

試用免費，為期 7 天或 3,000 作業分鐘，以先到者為準，不需信用卡。它以 4 vCPU 和 16 GB 執行 `runs-on: skipbox` 的作業，是私有儲存庫 `ubuntu-latest` 記憶體的 2 倍，所以把記憶體用光的作業移過來，看它帶著保留的快取執行，需要更多的作業再選 L 方案。

## 常見問題

### 「The runner has received a shutdown signal」是什麼意思？

Runner 應用程式在你的作業執行中被要求停止。在 GitHub 託管 Runner 上，你並沒有停止任何東西：作業底下的 VM 消失了，最常見的原因是作業用光了它所有的記憶體。Skipbox 的 skipbox 和 skipbox-16x32，以每月固定價格給作業 16 或 32 GB。

### 為什麼我的作業沒有錯誤就被取消了？

紀錄以 shutdown 那一行和「The operation was canceled.」結束、沒有 exit code 時，表示是 Runner 消失了，而不是某個步驟失敗。一位 GitHub 維護者在 actions/runner-images issue #15202 中確認，記憶體一用光，VM 就會在記憶體不足的訊息寫進紀錄之前停止回應。給作業更多記憶體：在 Skipbox 上只要改一行 runs-on。

### 這是記憶體不足的錯誤嗎？

在託管 Runner 上，通常是。作業被終止但 Runner 還活著時，會顯示 exit code 137；作業把整台 VM 拖垮時，就會顯示 shutdown 那一行。不論哪一種，作業需要的都比 ubuntu-latest 的 8 GB 多，而每個 Skipbox 方案都以固定價格提供更多。

### 為什麼自架 Runner 也會出現這則訊息？

有東西在作業進行中停止了 Runner 程序或它的機器：服務重新啟動、為了更新而重新開機、自動擴充工具移除了機器，或主機的記憶體用光。在 Skipbox 上，機器由我們替你管理，每個作業後都會做健康檢查，檢查失敗的機器會自動重建。

### Skipbox 的免費試用能修好記憶體用光的作業嗎？

它給作業 2 倍的記憶體。試用以 4 vCPU 和 16 GB 執行 runs-on: skipbox 的作業，私有儲存庫的 ubuntu-latest 只有 8 GB。需要更多記憶體，就用 L 方案的 runs-on: skipbox-16x32（32 GB）。

更新於 2026-11-11 · https://skipbox.dev/zh-hant/guides/github-actions-runner-shutdown-signal
