# 自架 Runner 用在私有儲存庫安全嗎？GitHub 的強化規則，替你做好

> 自架 GitHub Actions Runner 會保留之前作業留下的東西，一個惡意的作業就可能讓它永久被入侵。GitHub 的指引是：一個 Runner 只跑一個作業、乾淨的機器、不信任的程式碼用另外的機器。Skipbox 在你帳號的專屬機器上把這三件事都做好，每月固定 $39，開啟「每個作業都用新 VM」，每個作業就會用一台全新的 VM。

自架 Runner 要用在私有儲存庫上才安全，前提是補上 GitHub 託管 Runner 給你、而普通自架 Runner 沒有的東西：乾淨的機器、只接一個作業的 Runner，以及給不信任的程式碼用的另外的機器。GitHub 的[安全性參考文件](https://docs.github.com/en/actions/reference/security/secure-use#hardening-for-self-hosted-runners)說，自架 Runner 不保證在用完即丟的乾淨虛擬機器中執行，而且可能被工作流程中不受信任的程式碼永久入侵。

Skipbox 是做好這些工作的自架 Runner。你的作業在只屬於你帳號的機器上執行，它的憑證在每個作業後都會被清除，每個 Runner 只為一個作業註冊，而沒有寫入權限的人提交的程式碼，會在全新的 VM 中執行。開啟**每個作業都用新 VM**，每個作業就會拿到一台全新的 VM。每月固定 $39，分鐘數不限；改一行 `runs-on` 就好。

- GitHub：一個作業就可能讓自架 Runner 永久被入侵，而 fork 的 Pull Request 可能碰到它的 secret
- Skipbox：你帳號的專屬機器，每個作業後清除憑證，沒有寫入權限的人提交的程式碼用全新的 VM
- 每個作業都用新 VM：每個作業都在一台新的 VM 中執行，作業結束時連同磁碟一起刪除

**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-self-hosted-runner-security-private-repositories-zh-hant)

## GitHub 警告了什麼

全部來自 GitHub 的安全性參考文件和它的自架 Runner 文件：

- **機器會記得。** 自架 Runner 不需要每個作業都用乾淨的執行個體。一個作業留下的東西（檔案、程序、容器、權杖），下一個作業都還在。
- **私有儲存庫也不例外。** 任何能 fork 儲存庫並開 Pull Request 的人（通常是有儲存庫讀取權限的人），都能入侵自架 Runner 的環境，包括取得 secret 和 `GITHUB_TOKEN`。
- **公開儲存庫。** 自架 Runner 幾乎永遠不該用在公開儲存庫上，因為任何使用者都能開 Pull Request。
- **一個 Runner，很多儲存庫。** 組織層級的 Runner 會接所有被允許使用它的儲存庫的作業，所以一次入侵就會擴散。Runner 群組能限制哪些儲存庫可以用哪些 Runner。
- **機器上有什麼。** SSH 金鑰、API 權杖，以及連到內部服務或雲端中繼資料服務的網路存取，全都在作業的觸及範圍內。
- **作業後刪除機器，單獨這樣還不夠。** 沒有辦法保證自架 Runner 只執行一個作業。GitHub 的解法是即時（just-in-time）Runner，它最多執行一個作業，由你自己的自動化流程在乾淨的環境中啟動。
- **核准設定保護不了你的硬體。** 一旦 fork 的工作流程被允許執行，可能有惡意、由使用者控制的工作流程程式碼，就會在自架 Runner 上自動執行。

## 安全的設定需要什麼

把 GitHub 的指引換成工作：

| GitHub 的指引 | 在你自己架設的 Runner 上 | 在 Skipbox 上 |
|---|---|---|
| 只接一個作業的 Runner | 每個作業之前呼叫 REST API 取得即時設定，再用它啟動 Runner | 每個 Runner 都為一個作業即時註冊，帶著那個作業的標籤，之後移除 |
| 給它一個乾淨的環境 | 每個作業啟動一台新 VM 再刪除，或寫一套你信得過的清除流程 | 每個作業後清除憑證、程序、容器和憑證檔案；開啟「每個作業都用新 VM」時，每個作業一台新 VM |
| 把外部人員的程式碼隔開 | 為 fork 準備第二組機器，以及絕不混用的路由 | 沒有寫入權限的人提交的程式碼一律在全新的 VM 中執行 |
| 機器上的東西越少越好 | 讓金鑰、權杖和內部網路路由遠離主機 | 在你網路之外的 VM，不接受任何連入連線 |
| 限定存取範圍 | 依儲存庫或團隊設定 Runner 群組 | 你的機器只執行你帳號的作業；在個人帳號上，每個 Runner 都註冊在作業自己的儲存庫上 |
| 修補 | 作業系統、Docker 和 Runner，依你的時程 | 映像檔由我們替你更新，至少每月一次 |

自己動手打造，就是一套自動擴充工具、一條映像檔流水線，以及第二組 Runner。在 Skipbox 上，這是預設。

## Skipbox 到底隔離了什麼

### 你的專屬機器

每個方案以及試用，都會給你的帳號一台專屬的 VM。它只執行你帳號的作業，一次一個，而且在作業之間保留下來：Docker 映像檔和建置快取、套件快取和安裝好的工具都會留著，這就是下一個作業很快的原因。

每個作業結束後，Skipbox 會：

- 刪除 Runner 的憑證
- 停止 Runner 使用者的所有程序，並移除所有容器
- 刪除憑證檔案：`~/.docker/config.json`、`~/.npmrc`、`~/.git-credentials`、`~/.config/gh`、`~/.aws/credentials`、`~/.kube/config`、`~/.ssh/id_*`
- 移除 checkout 中和家目錄 git 設定中的 Git 憑證、checkout 的 hook，以及它未追蹤的檔案
- 檢查機器（磁碟、套件、Docker、Runner、DNS、殘留的程序和容器），檢查失敗就從映像檔重建它

從 2026 年 11 月 13 日起，你的 checkout 和它的建置輸出（Cargo 的 `target/`）會留在你的專屬機器上，供之後的作業使用。在你按下**重設機器**時，以及映像檔更新時（至少每月一次），機器也會被重建。

你帳號的作業共用那個磁碟，所以快取和建置產物會留給下一個作業直接用。要讓儲存庫或分支彼此隔開，就開啟「每個作業都用新 VM」。

### 全新的 VM

以下這些作業會在一台沒跑過其他作業的新 VM 中執行，作業結束時連同磁碟一起刪除：

- 開啟**每個作業都用新 VM**時的每個作業
- 沒有寫入權限的人提交的程式碼，例如來自 fork 的 Pull Request
- 在你所有專屬機器都在忙時進來的作業

當一次執行的程式碼是儲存庫自己的，而且啟動它的人有 write、maintain 或 admin 權限時，它就算是你團隊的執行。其他一切都被視為外部程式碼：fork 的 Pull Request、從 fork 的程式碼啟動的 `pull_request_target` 或 `workflow_run`、沒有寫入權限的人發出的 `issue_comment`。私有和公開儲存庫的規則都一樣。外部作業可以讀取你的快取但不能修改，萬一還是到達你專屬機器的外部作業，會在它的步驟執行之前就失敗；之後機器會被重設。

### VM 的周邊

- **每個 Runner 一個作業。** 每個 Runner 都為單一作業即時註冊。作業結束後仍然留著註冊的 Runner 會被移除。
- **不接受任何連入連線。** 網際網路上沒有任何東西能連到作業的 VM。
- **不存取你的程式碼。** Skipbox App 無法讀取你的儲存庫；每個作業在自己的 VM 裡自行 checkout 你的程式碼。
- **沒有其他客戶。** 沒有其他組織的作業會在你的機器上執行。

作業的 VM 持有工作流程的 secret 和 GitHub 為那個作業發的權杖，作業結束時 Skipbox 會把它們清除。所有細節請見[作業如何隔離](https://docs.skipbox.dev/zh-hant/isolation)。

## 和 GitHub 的 Runner 相比要花多少

自架 Runner 的分鐘數在 GitHub 上免費，而 Skipbox 的 Runner 就是自架 Runner。

| 每月分鐘數（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-self-hosted-runner-security-private-repositories-zh-hant#cost)算算你自己的分鐘數；不必登入。

## 換過去只要改一行

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

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

要讓每個作業都用全新的 VM，在**方案與帳單**中開啟**每個作業都用新 VM**。

## 用私有儲存庫試試看

試用不需信用卡，為期 7 天或 3,000 作業分鐘。把一個作業改成 `runs-on: skipbox`，然後把你原本打算強化的那台 Runner 退役。

## 常見問題

### 自架 Runner 用在私有儲存庫安全嗎？

要做到 GitHub 託管 Runner 替你做的那些工作才行。GitHub 的文件說，自架 Runner 不保證是乾淨、用完即丟的機器，可能被不受信任的程式碼永久入侵，而且在私有儲存庫上，任何能 fork 它並開 Pull Request 的人，都能碰到 Runner、它的 secret 和它的 GITHUB_TOKEN。Skipbox 替你補上這些缺口：只執行你帳號作業的機器、每個作業後清除的憑證、只為一個作業註冊的 Runner，以及給沒有寫入權限的人的程式碼用的全新 VM。

### 怎麼安全地設定 GitHub Actions 自架 Runner，每個作業一台全新的 VM？

為每個作業即時註冊一個只跑那個作業的 Runner、在沒有跑過其他作業的 VM 中啟動它、作業結束時刪除 VM、讓外部人員的 Pull Request 遠離團隊使用的機器，並在 VM 消失之前把 Runner 的紀錄轉送出去。這是一套要建置和維運的自動擴充工具。在 Skipbox 上，它是一個開關：開啟「每個作業都用新 VM」，每個作業就會在一台新的 VM 中執行，結束後連同磁碟一起刪除。把 runs-on 改成 skipbox 就能開始。

### Skipbox 每個作業都用全新的 VM 嗎？

開啟「每個作業都用新 VM」時是的：每個作業都在一台沒跑過其他作業的新 VM 中執行，作業結束時連同磁碟一起刪除。沒有開啟時，你團隊的作業在你帳號的專屬機器上執行，這台機器在作業之間保留下來，所以 Docker 層和套件快取會留著；每個作業結束後，Skipbox 會刪除 Runner 的憑證、停止它的程序、移除所有容器，並刪除憑證檔案。沒有寫入權限的人提交的程式碼，以及在你的機器都在忙時進來的作業，一律使用全新的 VM。

### 自架 Runner 在作業之間會保留什麼？

除非你清除，否則全部都會保留：上一個作業寫下的檔案、程序、容器、Docker 憑證、SSH 金鑰和權杖。GitHub 的文件說，自架 Runner 不需要每個作業都用乾淨的執行個體。在 Skipbox 的專屬機器上，快取和你的 checkout 會留下來，而憑證、程序和容器在每個作業後都會被清除；作業後檢查失敗的機器，會從乾淨的映像檔重建。

### 來自 fork 的 Pull Request 會在我的自架 Runner 上執行嗎？

在你自己架設的 Runner 上會，只要儲存庫的 fork 政策允許它的工作流程執行：GitHub 的文件警告，這時使用者控制的工作流程程式碼就會在你的基礎架構上執行。在 Skipbox 上，fork 的 Pull Request 絕不會在你的專屬機器上執行。它會在一台全新的 VM 中執行，可以讀取你的快取但不能修改，而萬一還是到達你專屬機器的 fork 作業，會在它的步驟執行之前就失敗。

### 自架 Runner 用在公開儲存庫安全嗎？

GitHub 說，自架 Runner 幾乎永遠不該用在公開儲存庫上，因為任何使用者都能開 Pull Request 並入侵機器。Skipbox 執行公開儲存庫的作業時，會讓這些 Pull Request 遠離你的機器：沒有寫入權限的人提交的程式碼，在用完即刪除的全新 VM 中執行，你的專屬機器只執行你團隊的程式碼。

更新於 2026-11-16 · https://skipbox.dev/zh-hant/guides/self-hosted-runner-security-private-repositories
