自架 Runner 用在私有儲存庫安全嗎?GitHub 的強化規則,替你做好
自架 Runner 要用在私有儲存庫上才安全,前提是補上 GitHub 託管 Runner 給你、而普通自架 Runner 沒有的東西:乾淨的機器、只接一個作業的 Runner,以及給不信任的程式碼用的另外的機器。GitHub 的安全性參考文件說,自架 Runner 不保證在用完即丟的乾淨虛擬機器中執行,而且可能被工作流程中不受信任的程式碼永久入侵。
Skipbox 是做好這些工作的自架 Runner。你的作業在只屬於你帳號的機器上執行,它的憑證在每個作業後都會被清除,每個 Runner 只為一個作業註冊,而沒有寫入權限的人提交的程式碼,會在全新的 VM 中執行。開啟每個作業都用新 VM,每個作業就會拿到一台全新的 VM。每月固定 $39,分鐘數不限;改一行 runs-on 就好。
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 會把它們清除。所有細節請見作業如何隔離。
和 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 扣除內含運算額度後的帳單。在首頁的費用試算算算你自己的分鐘數;不必登入。
換過去只要改一行
jobs:
build:
runs-on: skipbox # was ubuntu-latest, or self-hosted
steps:
- uses: actions/checkout@v4
- run: npm ci && npm test
- 使用 GitHub 登入 Skipbox。
- 安裝 Skipbox GitHub App,並選擇你的儲存庫。
- 修改
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日