# Skipbox 的運作方式

> 從推送到作業完成之間發生了什麼：webhook、檢查、為單一作業建立的 Runner、你的專屬機器或全新的 VM，以及作業結束後的處理。

Skipbox 在它替你管理的自架 Runner 上執行你的 GitHub Actions 作業。GitHub 依然負責執行工作流程、保存紀錄檔和顯示結果。Skipbox 只提供每個作業執行的機器。

## 從推送到作業完成

1. `runs-on` 要求 Skipbox 標籤的作業在 GitHub 上排入佇列。
2. GitHub 透過 App 的 webhook 通知 Skipbox。
3. Skipbox 檢查作業：帳號需要有方案或試用，而且還有空間放下一個這個規格的作業。S 方案最多同時執行 8 個作業，每個 4 vCPU · 16 GB。常駐：S 方案隨時執行 1 個作業，整個月都是，分鐘數不限（M 2 個，L 4 個）。突發：有機器空閒時，最多再有 7 個作業在 Skipbox 代管的其他機器上同時執行。每個方案每個曆月包含 10,000 分鐘。突發作業在全新的機器上啟動，可使用 GitHub Actions 快取；方案自己的機器保留它的熱快取。當月的突發分鐘數用完後，方案只會執行它的常駐作業，直到下個月 1 日突發恢復。請見[同時執行和排隊](https://docs.skipbox.dev/zh-hant/concurrency)。
4. Skipbox 向 GitHub 要求一個只接一個作業、帶有該作業自己標籤的 Runner 註冊。
5. Runner 會到你組織的專屬機器上，或到一台全新的 VM 上（請見 [VM 隔離](https://docs.skipbox.dev/zh-hant/isolation)）。它接下一個帶有這些標籤的作業，GitHub 會把你的程式碼、工作流程傳入的 secrets 和這個作業的權杖送過去。
6. 作業結束時，你的專屬機器會刪除 Runner 的憑證和作業 checkout 中的 Git 憑證，並自我檢查。快取會保留下來，從 2026 年 11 月 13 日起，checkout 和它的建置輸出（Cargo 的 `target/` 和 Next.js 的 `.next/cache`）也會保留；全新的 VM 則連同磁碟一起刪除。仍在註冊中的 Runner 會被移除。

## 不變的部分

- 你的工作流程、Action 和紀錄檔都留在 GitHub 上。Skipbox 不保留你程式碼或紀錄檔的任何副本。它只會透過你要求並合併的 Pull Request 修改工作流程（請見 [GitHub App 權限](https://docs.skipbox.dev/zh-hant/permissions)）。
- 移動一個作業只要改一行：它的 `runs-on`。改回來也是同一行。
- 你沒有修改 `runs-on` 的作業，會繼續在 GitHub 的 Runner 上執行。

## 作業在哪裡執行

你的專屬機器和全新的 VM，執行在 Skipbox 於日本營運的伺服器上，以及位於芬蘭和德國（EU）的 Hetzner Cloud 伺服器上。全新的 VM 也會在位於加拿大和 EU 的法國、西班牙、義大利的 Google Cloud 伺服器上執行。請見[網路和對外連線](https://docs.skipbox.dev/zh-hant/network)。

## 一次一個作業

一台 VM 一次執行一個作業。你的專屬機器會連同快取保留給組織的下一個作業。沒有寫入權限的人提交的程式碼（例如來自 fork 的 Pull Request）絕不會在上面執行：它會拿到一台全新的 VM，可以讀取你的快取但不能修改。開啟「每個作業都用新 VM」，每個作業都會拿到全新的 VM。一個作業最多可以執行 6 小時：請見[作業時間上限](https://docs.skipbox.dev/zh-hant/job-time-limit)。VM 之間如何隔離：[VM 隔離](https://docs.skipbox.dev/zh-hant/isolation)。

更新於 2026-11-20 · https://docs.skipbox.dev/zh-hant/how-it-works
