# 怎麼加速 GitHub Actions：一個槓桿一個槓桿，砍掉 25 分鐘的流水線

> 慢的 GitHub Actions 流水線，是作業互相等待、不需要跑的工作、在空白 VM 上重複的準備工作，以及擠在 2 顆核心上的 CPU 密集步驟。請依這個順序修正。最後兩項是機器的問題：Skipbox 在作業之間把快取留在你的專屬機器上，最多 16 vCPU，每月固定 $39，分鐘數不限。

25 分鐘的 GitHub Actions 流水線，通常是四種延遲疊在一起：作業互相等待、不需要跑的工作、空白 VM 每個作業都要重複的準備工作，以及擠在 2 顆核心上的 CPU 密集步驟（私有儲存庫的 `ubuntu-latest` 只有 2 顆 CPU 和 8 GB）。請依這個順序處理。先測量關鍵路徑，排隊時間另外看。然後略過不需要跑的、同時執行彼此獨立的作業、別再重建狀態、給重的步驟更多核心，最後對仍然很長的部分分片。前三項是不用花錢的工作流程修正。其餘的是機器：一台在作業之間保留快取、核心更多的 Runner。

Skipbox 就是那個 Runner。你的作業在帳號的專屬機器上執行，這台機器在作業之間保留 Docker 層、套件快取、工具和建置輸出，有 4 到 16 vCPU，每月固定 $39，分鐘數不限。在 astro 的 CI 上，這是 GitHub 上 528 秒和 Skipbox 上 30 秒的差別。換過去只要改一行：`runs-on: skipbox`。

- 依序使用的槓桿：測量、略過、平行執行、停止重建、增加核心、分片
- 你的專屬機器在作業之間保留快取和建置輸出：astro 的 CI 從 528 秒降到 30 秒
- 4 vCPU 每月 20,000 分鐘：GitHub 上要 $222，Skipbox 上是 $39

**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-speed-up-github-actions-zh-hant)

## 1. 測量關鍵路徑

你的團隊等待的時間，是最後結束的那條作業鏈，而不是每個作業的加總。打開一個有代表性的 Pull Request 的執行：關係圖顯示哪些作業在等哪些，每個作業的紀錄則顯示它的步驟時間。針對最慢的那條鏈，記下：

| 階段 | 要檢查什麼 |
|---|---|
| 排隊 | 作業有沒有在等 Runner？更快的指令縮短不了佇列 |
| 設定作業、checkout | 拉取了容器映像檔、在淺層複製就夠的地方做了完整複製 |
| 工具鏈和安裝 | 快取有沒有命中，命中省下的時間是否比還原花的還多？ |
| 建置 | 同樣的輸出是否在另一個作業裡也建置了一次？ |
| 測試 | Runner 的 CPU 是一直很忙，還是一個 worker 在做所有的事？ |
| 上傳 | 有用的工作做完之後的 artifact 和快取儲存 |

把一次預熱後的執行和一次冷執行比較。一半時間沒命中的快取，在平均值裡看起來沒問題。

## 2. 略過不需要跑的

- **取消被取代的執行。** 第一次之後的每次推送，都讓正在進行的執行失去意義。帶有 `cancel-in-progress` 的 [concurrency 群組](https://docs.github.com/en/actions/how-tos/write-workflows/choose-when-workflows-run/control-workflow-concurrency)會停止它。把範圍限定在 Pull Request，這樣推送到預設分支時絕不會取消部署：

```yaml
concurrency:
  group: ${{ github.workflow }}-${{ github.event.pull_request.number || github.ref }}
  cancel-in-progress: ${{ github.event_name == 'pull_request' }}
```

- **只執行變更動到的部分。** `paths:` 篩選會在只改文件時略過工作流程；在 monorepo 中，`turbo run test --affected` 或 Nx 的 affected 指令只會執行有變動的套件。觸發條件層級的篩選會讓必要檢查永遠不回報，所以當檢查是必要的時候，就在作業內部篩選。

## 3. 同時執行彼此獨立的作業

除非 `needs:` 把作業串起來，GitHub 會平行執行它們。Lint、型別檢查、單元測試和建置很少需要彼此：讓它們一起開始，只讓打包或部署等它們全部完成。如果兩個作業建置同樣的東西，就建置一次，再用 `actions/upload-artifact` 傳遞，並把上傳和下載的時間算進去。

## 4. 別再重建同樣的狀態

長流水線的大部分時間都花在這裡。GitHub 託管 Runner 上的每個作業都從新的 VM 開始，所以它每次都要下載工具鏈、安裝相依套件、重建 Docker 層，並從零開始編譯。

- **真正會命中的快取。** `actions/setup-node` 的 `cache: npm`（以及它的 pnpm 和 yarn 形式），以 lockfile 為 key 儲存套件管理器下載的檔案；它不會儲存 `node_modules`，所以安裝還是要跑。GitHub 每個儲存庫保留 10 GB，7 天沒用到的項目會被移除，而命中仍然是一次下載到新 VM 上（[快取容量上限](https://skipbox.dev/zh-hant/guides/github-actions-cache-size-limit)）。
- **工具快取。** `eslint --cache`、`tsc --incremental`、Jest 的快取目錄和 turbo 的 `.turbo/cache`，儲存的是工作本身，而不是下載的檔案。在全新的 VM 上，除非你也還原它們，否則都是空的。
- **Docker 層。** 在全新 VM 上的 `docker build` 一開始沒有任何層；繞過的方法是用 buildx 的 `cache-to` 匯出，每次執行再匯入（[Docker 層快取](https://skipbox.dev/zh-hant/guides/docker-layer-cache-github-actions)）。

保留磁碟的機器會自己做完這一切：快取、工具快取、層和建置輸出，從上一個作業起就在那裡。

## 5. 給重的步驟更多核心

編譯器、打包工具和測試執行器每顆核心啟動一個 worker，所以在 2 顆 CPU 上，它們一次跑兩個。檢查測試執行器實際用了多少：[Jest](https://jestjs.io/docs/cli#--maxworkersnumstring) 預設是核心數減一（在 2 顆 CPU 上是一個 worker），pytest 在加上 `-n auto` 之前是循序執行，[Playwright](https://playwright.dev/docs/ci#workers) 預設是核心數的一半，而它的文件建議在 CI 上用一個 worker。只有在告訴執行器去用時，更多核心才有幫助，而且只對讓 CPU 一直忙著的步驟有效；下載或資料庫啟動不會變快。

在 GitHub 上，更多核心意味著[大型 Runner](https://docs.github.com/en/actions/concepts/runners/larger-runners)：4 到 96 核心，只限 GitHub Team 或 Enterprise Cloud 的組織，按分鐘計費，每核心的費率更高。

## 6. 對仍然很長的部分分片

分片矩陣把一個很長的測試套件拆到多個作業上。它縮短的是實際經過的時間，不是分鐘數：每個分片都要重新 checkout、安裝和建置，所以四個分片要付四次準備工作。依測量的時間平衡分片，而不是依檔案數，當準備工作占了每個分片的大部分時，就別再增加分片。

## 一直慢下去的代價

一條 15 分鐘的流水線一天跑 40 次，就是每天分散在你團隊身上的 10 小時等待，還沒算上切換工作的成本。在按分鐘計費下，準備工作的分鐘數和測試的分鐘數一樣計費：

| 每月分鐘數（4 vCPU） | GitHub | Skipbox S | 每月省下 |
|---|---|---|---|
| 10,000 | $102 | $39 | **$63** |
| 20,000 | $222 | $39 | **$183** |
| 30,000 | $342 | $39 | **$303** |

在 GitHub 上，核心越多每分鐘越貴，所以機器越大，差距越大：

| 每月 20,000 分鐘 | GitHub | Skipbox | 每月省下 |
|---|---|---|---|
| 8 vCPU | $422 | $79（M） | **$343** |
| 16 vCPU | $822 | $149（L） | **$673** |

GitHub 的金額已扣除 GitHub Team 的內含用量。把你自己的分鐘數填進[首頁的費用試算](https://skipbox.dev/?ref=g-speed-up-github-actions-zh-hant#cost)試試看。

## 解法就是機器的時候

真實專案自己的 CI 作業，步驟沒有修改，在 GitHub 的公開儲存庫 Runner（4 vCPU，16 GB）和同樣 vCPU 的 Skipbox 專屬機器上執行，依[我們用它們的工作流程執行的結果](https://skipbox.dev/zh-hant/guides/rust-cache-slow-rust-ci)：

| 專案 | GitHub | Skipbox，專屬機器 | 機器保留了什麼 |
|---|---|---|---|
| astro（Node.js、Turborepo） | 528 秒 | **30 秒** | turbo 的快取：重播了 40 個建置任務 |
| tauri（Rust） | 246 秒 | **53 秒** | Cargo 的 `target/`：沒有任何 crate 被重新編譯 |
| ripgrep（Rust） | 200 秒 | **40 秒** | cross 的 `target/` 和 Docker 映像檔 |
| vite（Node.js） | 141 秒 | 100 秒 | 套件快取；其餘是它的測試在跑 |

私有儲存庫的 `ubuntu-latest`，核心數只有上面 GitHub 執行的一半。

## Skipbox 為你的流水線做了什麼

**保留機器。** 每個方案都附有一台你帳號專屬、在作業之間保留下來的機器。Docker 映像檔、層和建置快取、套件快取、工具快取，以及連同 Cargo 的 `target/` 和 turbo 快取的 checkout，都留在它的磁碟上：至少是 GitHub 快取空間的 7 倍，沒有 key、沒有 7 天的期限，也沒有分支規則。

**以固定價格增加核心。** 作業依標籤選擇規格：

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

分鐘數不限，所以分片、重新執行和更大的矩陣都不會提高帳單。Skipbox 的作業不用 GitHub 分鐘數，所以 GitHub 預算絕不會讓它們停下來。

**自己照顧自己。** Skipbox 負責佈建機器、讓映像檔保持更新、在每個作業後清理環境，並重建健康檢查失敗的機器。

## 換過去只要改一行

```yaml
jobs:
  test:
    runs-on: skipbox # was ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with:
          node-version: 22
          cache: npm
      - run: npm ci && npm test
```

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

你的步驟和 Action 照原樣在裝有 Docker、Node.js 和 Python 的 Ubuntu 24.04 上執行。

## 安全性

- 機器只屬於你的帳號。其他公司的作業不會在上面執行。
- 每個作業結束後，Runner 的憑證、程序和容器都會被清除，保留下來的 checkout 中的 Git 憑證和未追蹤的檔案也是。開啟「每個作業都用新 VM」，每個作業就會改用一台全新的機器。
- 沒有寫入權限的人提交的程式碼（例如來自 fork 的 Pull Request），會在全新的 VM 上執行，可以讀取你的快取但不能修改。

詳情請見[作業如何隔離](https://docs.skipbox.dev/zh-hant/isolation)。

## 用你最慢的作業試試看

試用免費，為期 7 天或 3,000 作業分鐘，以先到者為準，不需信用卡。把關鍵路徑上的作業改成 `runs-on: skipbox`，執行兩次，再把第二次執行的步驟時間和 GitHub 上的並排比較。

## 常見問題

### 我們的 GitHub Actions 流水線要 25 分鐘。讓它變快最快的方法是什麼？

依順序處理。讀執行的關係圖和步驟時間，找出決定總時間的那條作業鏈，排隊時間另外看。取消被取代的執行，略過檔案沒有變動的作業。拿掉只是出於習慣的 needs:，讓彼此獨立的作業同時執行。別在每個作業都重建狀態：用真正會命中的快取，或保留磁碟的 Runner。給 CPU 密集的步驟更多核心，並讓測試執行器用上它們。只對仍然很長的部分分片。在私有儲存庫的 ubuntu-latest（2 顆 CPU，8 GB）上，最後三項常常就占了 25 分鐘的大部分，而它們都是機器的問題：Skipbox 給作業一台在作業之間保留快取的專屬機器，有 4 到 16 vCPU。

### 換更快的 Runner，和最佳化工作流程相比值得嗎？

先做免費的工作流程修正：取消被取代的執行、路徑篩選和拿掉不必要的 needs: 都不用花錢，也沒有任何 Runner 會替你做。之後，看看剩下的時間花在哪裡。每個作業都重複的準備工作（工具鏈、相依套件安裝、Docker 建置），以及讓每顆核心都忙著的步驟，都是機器的問題，而保留快取、核心更多的 Runner，只要改一行 runs-on 就能把它們拿掉。網路等待和循序執行的步驟，不會因為機器變大而變快。

### 為什麼 GitHub Actions 比我的筆電慢？

你的筆電把套件、工具、Docker 層和建置輸出都留在磁碟上，而且通常有 8 顆以上的核心。私有儲存庫的 ubuntu-latest 作業只拿到 2 顆 CPU 和 8 GB，在一台這些都沒有的新 VM 上。Skipbox 就像你的筆電一樣運作：機器在作業之間保留下來，有 4 vCPU 以上。

### 把測試分片能讓 GitHub Actions 變快嗎？

它縮短的是實際經過的時間，不是分鐘數。每個分片都是一個新的作業，要重新 checkout、安裝和建置，所以四個分片要付四次準備工作，而按分鐘計費會把每一個都算進去。等準備工作變便宜、Runner 的核心也都用上之後再分片。在 Skipbox 上，準備工作留在磁碟上，分鐘數不限，所以分片不會多花錢。

### 怎麼讓 GitHub Actions 作業拿到超過 4 顆核心？

在 GitHub 上，大型 Runner 有 4 到 96 核心，只提供給 GitHub Team 或 Enterprise Cloud 上的組織，按分鐘計費。在 Skipbox 上，把 runs-on 改成 skipbox-8x16 就有 8 vCPU，改成 skipbox-16x32 就有 16 vCPU，每月固定價格，組織和個人帳號都一樣。

### 試用要花多少錢？

不用錢。試用為期 7 天或 3,000 作業分鐘，以先到者為準，不需信用卡。把你最慢的作業的 runs-on 改成 skipbox，執行兩次，再比較它的步驟時間。

更新於 2026-11-13 · https://skipbox.dev/zh-hant/guides/speed-up-github-actions
