# Skipbox 怎样工作

> 从推送到作业完成之间发生了什么：webhook、检查、只为一个作业创建的运行器、你的专属机器或一台新虚拟机，以及作业结束后会发生什么。

Skipbox 在它替你管理的自托管运行器上运行你的 GitHub Actions 作业。GitHub 仍然运行你的工作流、保存你的日志并显示结果。Skipbox 只提供每个作业运行所在的机器。

## 从推送到作业完成

1. 一个 `runs-on` 要求 Skipbox 标签的作业在 GitHub 上排队。
2. GitHub 通过应用的 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-hans/concurrency)。
4. Skipbox 向 GitHub 申请一个只接一个作业、带有这个作业自身标签的运行器注册。
5. 运行器被分配到你组织的专属机器，或者一台新的虚拟机（见[虚拟机隔离](https://docs.skipbox.dev/zh-hans/isolation)）。它接下一个带这些标签的作业，GitHub 把你的代码、工作流传递的密钥和这个作业的令牌发给它。
6. 作业结束时，你的专属机器删除运行器的凭据和作业检出目录中的 git 凭据，并检查自身。它保留自己的缓存，从 2026年11月13日起，检出目录及其构建输出（Cargo 的 `target/` 和 Next.js 的 `.next/cache`）也会保留；新的虚拟机则连同磁盘一起删除。仍然注册着的运行器会被移除。

## 什么保持不变

- 你的工作流、操作和日志都留在 GitHub 上。Skipbox 不保留你的代码或日志的任何副本。它只通过你要求并合并的拉取请求修改工作流（见 [GitHub 应用权限](https://docs.skipbox.dev/zh-hans/permissions)）。
- 迁移一个作业只需改一行：它的 `runs-on`。换回去也是同一行。
- 你没有改动 `runs-on` 的作业，继续在 GitHub 的运行器上运行。

## 作业在哪里运行

你的专属机器和新的虚拟机，运行在 Skipbox 在日本运营的一台服务器上，以及芬兰和德国（欧盟）的 Hetzner Cloud 服务器上。新的虚拟机也会运行在加拿大和欧盟的法国、西班牙、意大利的 Google Cloud 服务器上。见[网络和出站流量](https://docs.skipbox.dev/zh-hans/network)。

## 一次一个作业

一台虚拟机一次运行一个作业。你的专属机器为你组织的下一个作业保留，连同它的缓存。没有写入权限的人提交的代码（例如来自复刻的拉取请求）从不在它上面运行：这样的代码会拿到一台新的虚拟机，它能读取你的缓存，但不能修改。开启“每个作业用新虚拟机”，每个作业都会拿到一台新虚拟机。一个作业最多可以运行 6 小时：见[作业时间上限](https://docs.skipbox.dev/zh-hans/job-time-limit)。虚拟机之间怎样隔开：见[虚拟机隔离](https://docs.skipbox.dev/zh-hans/isolation)。

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