# Actions Runner Controller 還是代管 Runner 服務：小團隊該選哪個？

> Actions Runner Controller（ARC）是在你自己的 Kubernetes 叢集上執行的免費軟體：兩個 Helm chart、一個你自己建置的 Runner 映像檔，每次升級都要重新安裝。小團隊用代管的 Runner，同樣能拿到 GitHub 不計費的分鐘數。Skipbox 就是一個，每月固定 $39，分鐘數不限：改一行 runs-on 就好。

對小團隊來說，選代管的 Runner 服務。Actions Runner Controller（ARC）是 Kubernetes operator：你要維運叢集、安裝兩個 Helm chart、建置 Runner 映像檔，每次升級都要把整套重新安裝。GitHub 推薦 ARC 給擁有 Kubernetes 基礎架構、團隊也具備 Kubernetes 專業的組織。

Skipbox 給你 ARC 想要達成的東西，也就是 GitHub 不對分鐘數計費的自架 Runner，卻沒有任何東西要維運。你的作業在帳號的專屬機器上執行，每月固定 $39，分鐘數不限。只要改一行 `runs-on`。

- ARC：一個 Kubernetes 叢集、兩個 Helm chart、你自己的 Runner 映像檔，每次升級都要解除安裝再重新安裝
- Skipbox：安裝一個 GitHub App，改 `runs-on`，機器、映像檔和更新都替你完成
- 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-actions-runner-controller-vs-managed-runners-zh-hant)

## 執行 ARC 時，你要維運什麼

依 GitHub 的 [ARC 文件](https://docs.github.com/en/actions/concepts/runners/actions-runner-controller)：

| 元件 | 需要什麼 |
|---|---|
| Kubernetes 叢集 | ARC 的第一個前提，搭配 Helm 3。GitHub 建議把正式環境的工作負載隔離執行，因為用共用的 Kubernetes 叢集跑正式環境的工作負載，可能帶來安全風險 |
| 控制器 | `gha-runner-scale-set-controller` Helm chart：控制器管理員 pod、它的角色，以及 ARC 的自訂資源定義 |
| Runner scale set | `gha-runner-scale-set` Helm chart，每種 Runner 一套：一個等待作業的 listener pod，以及為每個作業建立的 Runner pod |
| 驗證 | GitHub App 或個人存取權杖（classic），以 Kubernetes secret 保存 |
| Runner 映像檔 | GitHub 的映像檔只含必要的最少套件。需要更多東西，就得自己建置和發布映像檔 |
| 容器模式 | 使用容器的作業需要 `dind`（每個 Runner pod 裡都有一個特權的 Docker-in-Docker 容器）或 `kubernetes`（持久磁碟區或生命週期 hook，而且預設沒有 `container:` 的作業會失敗） |
| 擴充上限 | 每個 scale set 的 `minRunners` 和 `maxRunners`。ARC 沒有排程功能：要靠你自己的 cron job 去改 |
| 紀錄和指標 | GitHub 建議在上正式環境之前，收集並保存控制器、listener 和 Runner 的紀錄；指標以 Prometheus 格式提供 |

每個 Runner pod 會在作業結束時刪除，所以它拉取的映像檔和下載的套件也會一起消失。要在作業之間保留它們，就得自己設計和佈建儲存空間。

## 它在工作量上的代價

ARC 是免費軟體，GitHub 也不對自架 Runner 的分鐘數收費。代價是叢集節點每個月的費用，以及這些時間：

- **升級就是重新安裝。** Helm 無法升級 ARC 的自訂資源定義。GitHub 的[升級步驟](https://docs.github.com/en/actions/how-tos/manage-runners/use-actions-runner-controller/deploy-runner-scale-sets#upgrading-arc)是：解除安裝每個 runner scale set、等待清理完成、解除安裝 ARC、如果 CRD 有變動就移除，然後重新安裝。如果沒有第二個叢集，升級期間沒有任何 Runner 會接作業。
- **Runner 會過時。** 落後新版本超過 63 天的 Runner，GitHub 就不再分派作業給它。用自己的映像檔，就得自己及時重建。
- **叢集要你自己除錯。** GitHub 的 [ARC 支援範圍](https://docs.github.com/en/actions/concepts/runners/support-for-arc)不包含 Kubernetes 的設定和網路、用 Docker-in-Docker 建置映像檔、儲存空間和持久磁碟區、叢集政策，以及映像檔快取。它建議要有對容器編排具備專家級知識的人員。
- **Kubernetes 本身。** 節點升級、Runner 底下節點的自動擴充，以及推送之間閒置節點的帳單。

小團隊沒有平台工程師可以投入這些事。這些時間都是從產品開發裡挪出來的。

## 留在 GitHub 的 Runner 上要花多少

團隊會考慮 ARC，是因為按分鐘計費的帳單。以下是那張帳單和一個 Skipbox 方案的比較：

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

GitHub 的金額是 GitHub Team 扣除內含運算額度後的帳單。把你自己的分鐘數填進[首頁的費用試算](https://skipbox.dev/?ref=g-actions-runner-controller-vs-managed-runners-zh-hant#cost)；不必登入。

## Skipbox：有 Runner，沒有叢集

| | ARC | Skipbox |
|---|---|---|
| 開始使用 | 叢集、Helm、兩個 chart、一個 secret、一個映像檔 | 安裝一個 GitHub App，改 `runs-on` |
| GitHub 對分鐘數的收費 | 無 | 無：Skipbox 的 Runner 就是自架 Runner |
| 每月費用 | 叢集節點的費用，依規格和時數計算 | $39、$79 或 $149，固定 |
| 作業中的 Docker | 特權的 Docker-in-Docker，或 Kubernetes 模式 | Docker 在 VM 裡執行，和 `ubuntu-latest` 一樣 |
| 作業之間的快取 | 隨 pod 一起消失，除非你為它們建置儲存空間 | 留在你機器的磁碟上 |
| 升級 | 解除安裝再重新安裝 | 替你完成 |
| Runner 壞掉時 | 你去讀控制器和 listener 的紀錄 | 每個作業後都會檢查；檢查失敗的機器會自動重建 |

- **固定價格。** 4 vCPU 和 16 GB 每月 $39，8 vCPU $79，16 vCPU $149。分鐘數不限，沒有用量費。加購方案就能同時執行更多作業；超過機器數量的作業會排隊等候。
- **你自己的、保留狀態的機器。** Docker 映像檔、層和建置快取、套件快取和工具快取，在作業之間都會留下來：至少是 GitHub 給每個儲存庫快取的 7 倍。從空白開始的 Runner pod 則要全部重新下載。
- **每個作業一個 Runner。** 作業排入佇列時，Skipbox 為這一個作業註冊一個即時 Runner，結束後移除。沒有 listener、沒有 scale set、沒有 `maxRunners`。
- **保持最新。** Runner、Ubuntu 24.04、Docker、Node 22 和 Python 3.12，都由 Skipbox 負責更新。

## 換過去只要改一行

```yaml
jobs:
  build:
    runs-on: skipbox # was ubuntu-latest, or your scale set's name
    steps:
      - uses: actions/checkout@v4
      - run: npm ci && npm test
```

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

Linux 作業照原樣執行，公開和私有儲存庫都可以。

## 安全性

- 機器只屬於你的帳號；其他公司的作業不會在上面執行。
- 每個作業結束後，Runner 的憑證、程序、容器，以及 `~/.npmrc` 之類的憑證檔案都會被清除。從 2026 年 11 月 13 日起，你的 checkout 和它的建置輸出（Cargo 的 `target/`）會留在你的專屬機器上，供之後的作業使用；開啟「每個作業都用新 VM」，每個作業就會用一台全新的機器。
- 沒有寫入權限的人提交的程式碼（例如來自 fork 的 Pull Request），會在用完即刪除的全新 VM 上執行。[作業如何隔離](https://docs.skipbox.dev/zh-hant/isolation)。

## 在建置叢集之前先試試看

試用不需信用卡，為期 7 天或 3,000 作業分鐘。在你為它建置叢集之前，今天就把一個作業改成 `runs-on: skipbox`。

## 常見問題

### Actions Runner Controller 還是代管 Runner 服務：小團隊該選哪個？

代管 Runner 服務。Actions Runner Controller（ARC）是 Kubernetes operator：叢集由你維運，要安裝它的兩個 Helm chart、建置 Runner 映像檔，每次升級都要重新安裝。GitHub 推薦它給擁有 Kubernetes 基礎架構和 Kubernetes 專業的組織和團隊。Skipbox 讓小團隊拿到同樣免費的自架分鐘數，卻沒有任何東西要維運：4 vCPU 的機器每月固定 $39，分鐘數不限，只要改一行 runs-on。

### 對小團隊來說，Actions Runner Controller 很難維運嗎？

它是一套要持續運作的 Kubernetes 平台。你需要一個叢集、Helm、以 Kubernetes secret 保存的 GitHub App 或權杖、給使用 Docker 的作業用的容器模式、裝有作業所需工具的自製 Runner 映像檔，以及收集控制器、listener 和 Runner 紀錄的機制。GitHub 的文件建議要有對容器編排具備專家級知識的人員。在 Skipbox 上，這些都不存在：安裝一個 GitHub App，再改 runs-on 就好。

### Actions Runner Controller 要花多少錢？

ARC 本身免費，GitHub 也不對自架 Runner 的分鐘數收費。你要付的是 Kubernetes 叢集和節點每個月的費用，以及安裝、升級和除錯花掉的時間。Skipbox 把機器和這些工作放進一個固定價格：4、8 或 16 vCPU 每月 $39、$79 或 $149，分鐘數不限。

### Actions Runner Controller 要怎麼升級？

重新安裝。Helm 無法升級 ARC 的自訂資源定義，所以 GitHub 的步驟是：解除安裝每個 runner scale set、等待清理完成、解除安裝 ARC、如果 CRD 有變動就移除它們，然後重新安裝。映像檔裡的 Runner 也必須保持最新：落後新版本超過 63 天的 Runner，GitHub 就不再分派作業給它。在 Skipbox 上，Runner 和映像檔都由我們替你更新。

### 要自動擴充 GitHub Actions Runner，一定需要 Kubernetes 嗎？

不需要。ARC 是 GitHub 的 Kubernetes 解法，GitHub 的文件也說明了怎麼用它的 scale set 用戶端或 webhook 自己打造自動擴充工具。代管 Runner 這些都不需要。Skipbox 會在每個作業排入佇列時為它註冊一個 Runner；你的方案決定同時執行幾個作業，其餘的排隊等候。

### 在 Skipbox 上，不用 Docker-in-Docker 也能執行 Docker 建置嗎？

可以。每台 Skipbox 機器都是裝有 Docker 的 VM，所以 docker build、docker run、服務容器和容器作業，都和在 ubuntu-latest 上一樣能運作。在 ARC 上，你要先選一種容器模式：執行特權容器的 Docker-in-Docker，或是沒有容器的作業預設會失敗的 Kubernetes 模式。

更新於 2026-11-14 · https://skipbox.dev/zh-hant/guides/actions-runner-controller-vs-managed-runners
