# 怎样给 GitHub Actions 提速：一项一项地压缩 25 分钟的流水线

> 慢的 GitHub Actions 流水线，就是作业相互等待、跑了不需要跑的东西、在空白虚拟机上重复准备，以及在 2 核上运行吃 CPU 的步骤。按这个顺序解决。后两项是机器的问题：Skipbox 在作业之间把你的缓存留在你的专属机器上，最多 16 vCPU，每月固定 $39，分钟数不限。

一条 25 分钟的 GitHub Actions 流水线，通常是四种延迟叠在一起：作业相互等待、跑了不需要跑的东西、空白虚拟机在每个作业里重复准备工作，以及吃 CPU 的步骤挤在 2 个核心上（私有仓库的 `ubuntu-latest` 只有 2 个 CPU、8 GB）。按这个顺序处理。首先，测量关键路径，把排队时间单独看。然后跳过不需要跑的部分，让相互独立的作业同时运行，不再重建状态，给繁重的步骤更多核心，对仍然很长的部分做分片。前三项是不花钱的工作流修正。其余的都是机器的问题：一个在作业之间保留缓存、核心更多的运行器。

Skipbox 就是这样的运行器。你的作业在你账号的专属机器上运行，这台机器在作业之间保留 Docker 层、包缓存、工具和构建输出，有 4 到 16 vCPU，每月固定 $39，分钟数不限。在 astro 的 CI 上，GitHub 要 528 秒，Skipbox 只要 30 秒。切换只需改一行：`runs-on: skipbox`。

- 按顺序的几个抓手：测量、跳过、并行、不再重建、加核心、分片
- 你的专属机器在作业之间保留缓存和构建输出：astro 的 CI 从 528 秒降到 30 秒
- 4 vCPU 每月 2万分钟：GitHub 上 $222，Skipbox 上 $39

**固定价格的 GitHub Actions，分钟数不限** Skipbox 在你的专属机器上运行 GitHub Actions 作业：每月 $39，无论运行多少分钟。Docker 层和依赖缓存在作业之间保留，所以下一个作业能立即开始。

4 vCPU 运行器，每月 2万分钟: GitHub $222 → Skipbox $39. 每月节省 $183.

切换只需改一行：`runs-on: skipbox`。

[开始 7 天免费试用](https://app.skipbox.dev/sign-in?ref=g-speed-up-github-actions-zh-hans)

## 1. 测量关键路径

你的团队等待的时间，是最后完成的那条作业链，而不是所有作业时间之和。打开一个有代表性的拉取请求的运行：依赖图显示哪些作业在等哪些，每个作业的日志显示它各步骤的耗时。对最慢的那条链，记下：

| 阶段 | 检查什么 |
|---|---|
| 排队 | 作业是否在等运行器？更快的命令缩短不了排队 |
| 设置作业、检出 | 拉取了容器镜像，或者本可以浅克隆却做了完整克隆 |
| 工具链和安装 | 缓存命中了吗？命中省下的时间比恢复花的时间多吗？ |
| 构建 | 同样的输出是否在另一个作业里也构建了一遍？ |
| 测试 | 运行器的 CPU 是一直忙着，还是一个工作进程在做所有事？ |
| 上传 | 有用的工作做完之后的制品和缓存保存 |

把一次热运行和一次冷运行放在一起比。一个一半时间都没命中的缓存，平均起来看着还挺好。

## 2. 跳过不需要跑的部分

- **取消被替代的运行**：第一次之后的每次推送，都让正在进行的运行失去意义。一个带 `cancel-in-progress` 的[并发组](https://docs.github.com/en/actions/how-tos/write-workflows/choose-when-workflows-run/control-workflow-concurrency)会把它停掉。把它限定在拉取请求上，这样推送到默认分支永远不会取消部署：

```yaml
concurrency:
  group: ${{ github.workflow }}-${{ github.event.pull_request.number || github.ref }}
  cancel-in-progress: ${{ github.event_name == 'pull_request' }}
```

- **只运行改动涉及的部分**：`paths:` 过滤在只改文档时跳过工作流；在单体仓库中，`turbo run test --affected` 或 Nx 的 affected 命令只运行有改动的包。触发级别的过滤意味着必需检查永远不会上报结果，所以当检查是必需的时，在作业内部做过滤。

## 3. 让相互独立的作业同时运行

除非用 `needs:` 串起来，GitHub 会并行运行作业。lint、类型检查、单元测试和构建很少相互依赖：让它们一起开始，只让打包或部署等待所有作业完成。如果两个作业构建同样的东西，就只构建一次，用 `actions/upload-artifact` 传过去，并给上传和下载计时。

## 4. 不再重建同样的状态

一条长流水线的大部分时间都花在这里。GitHub 托管运行器上的每个作业都在一台新虚拟机上启动，所以每一次它都要下载工具链、安装依赖、重建 Docker 层，并从头编译。

- **真正能命中的缓存**：`actions/setup-node` 的 `cache: npm`（以及它的 pnpm 和 yarn 形式）以锁文件为键保存包管理器的下载内容；它不保存 `node_modules`，所以安装仍然会运行。GitHub 每个仓库保留 10 GB，7 天没用到的条目会被删掉，而且命中仍然是一次下载到新虚拟机上的过程（[缓存大小上限](https://skipbox.dev/zh-hans/guides/github-actions-cache-size-limit)）。
- **工具缓存**：`eslint --cache`、`tsc --incremental`、Jest 的缓存目录和 turbo 的 `.turbo/cache` 保存的是工作本身，而不是下载内容。在新虚拟机上，除非你也把它们恢复回来，否则它们是空的。
- **Docker 层**：在新虚拟机上，`docker build` 一开始没有任何层；用 buildx 的 `cache-to` 导出、每次运行再导入，是绕开的办法（[Docker 层缓存](https://skipbox.dev/zh-hans/guides/docker-layer-cache-github-actions)）。

一台保留磁盘的机器自己就能做到所有这些：缓存、工具缓存、层和构建输出，都是上一个作业留下来的。

## 5. 给繁重的步骤更多核心

编译器、打包工具和测试运行器每个核心启动一个工作进程，所以在 2 个 CPU 上，它们一次跑两个。看看测试运行器实际用了多少：[Jest](https://jestjs.io/docs/cli#--maxworkersnumstring) 默认是核心数减一（在 2 个 CPU 上就是一个工作进程），pytest 在加上 `-n auto` 之前是串行运行的，[Playwright](https://playwright.dev/docs/ci#workers) 默认是核心数的一半，它的文档还建议在 CI 中用一个工作进程。只有告诉运行器去用，更多核心才有帮助，而且只对让 CPU 一直忙着的步骤有用；下载或者启动数据库不会变快。

在 GitHub 上，更多核心意味着[大型运行器](https://docs.github.com/en/actions/concepts/runners/larger-runners)：4 到 96 核，只面向 GitHub Team 或 Enterprise Cloud 上的组织，按分钟计费，每个核心的费率更高。

## 6. 对仍然很长的部分做分片

分片矩阵把一个很长的测试套件分到多个作业。它缩短的是墙上时间，而不是分钟数：每个分片都要重新检出、安装和构建，所以四个分片就要付四次准备工作的钱。按测得的时间而不是文件数来平衡分片，当准备工作占了每个分片的大部分时，就别再加了。

## 一直慢下去要付出什么

一条每天运行 40 次的 15 分钟流水线，就是每天分摊在你团队身上的 10 小时等待，这还没算上来回切换的成本。按分钟计费时，准备工作的分钟数和测试的分钟数一样计费：

| 每月分钟数（4 vCPU） | GitHub | Skipbox S | 每月节省 |
|---|---|---|---|
| 1万 | $102 | $39 | **$63** |
| 2万 | $222 | $39 | **$183** |
| 3万 | $342 | $39 | **$303** |

在 GitHub 上，核心越多每分钟越贵，所以机器越大，差距越大：

| 每月 2万分钟 | GitHub | Skipbox | 每月节省 |
|---|---|---|---|
| 8 vCPU | $422 | $79（M） | **$343** |
| 16 vCPU | $822 | $149（L） | **$673** |

GitHub 的金额已减去 GitHub Team 包含的用量。在[首页的计算器](https://skipbox.dev/?ref=g-speed-up-github-actions-zh-hans#cost)里试试你自己的分钟数。

## 解决办法是机器时

真实项目自己的 CI 作业，步骤不变，分别在 GitHub 的公开仓库运行器（4 vCPU，16 GB）和同样 vCPU 的 Skipbox 专属机器上运行，出自[对它们工作流的实测](https://skipbox.dev/zh-hans/guides/rust-cache-slow-rust-ci)：

| 项目 | GitHub | Skipbox，专属机器 | 机器保留了什么 |
|---|---|---|---|
| astro（Node.js，Turborepo） | 528 秒 | **30 秒** | turbo 的缓存：重放了 40 个构建任务 |
| tauri（Rust） | 246 秒 | **53 秒** | Cargo 的 `target/`：没有 crate 重新编译 |
| ripgrep（Rust） | 200 秒 | **40 秒** | cross 的 `target/` 和 Docker 镜像 |
| vite（Node.js） | 141 秒 | 100 秒 | 包缓存；其余是它的测试在运行 |

私有仓库的 `ubuntu-latest` 只有上面这些 GitHub 运行一半的核心。

## Skipbox 为你的流水线做什么

**保留机器**：每个套餐都附带你账号的专属机器，在作业之间一直保留。Docker 镜像、层和构建缓存、包缓存、工具缓存，以及带有 Cargo 的 `target/` 和 turbo 缓存的检出目录，都留在它的磁盘上：缓存空间至少是 GitHub 的 7 倍，没有键，不会在 7 天后过期，也没有分支规则。

**以固定价格增加核心**：作业按标签选规格：

| 标签 | 机器 | 套餐 |
|---|---|---|
| `skipbox` | 4 vCPU · 16 GB | S，每月 $39 |
| `skipbox-8x16` | 8 vCPU · 16 GB | M，每月 $79 |
| `skipbox-16x32` | 16 vCPU · 32 GB | L，每月 $149 |

分钟数不限，所以分片、重跑和更大的矩阵都不会让账单变高。Skipbox 的作业不消耗 GitHub 分钟数，所以 GitHub 预算永远不会让它们停下。

**自己照看自己**：Skipbox 负责准备机器、让镜像保持最新、在每个作业后清理，并重建健康检查失败的机器。

## 切换只需改一行

```yaml
jobs:
  test:
    runs-on: skipbox # was ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with:
          node-version: 22
          cache: npm
      - run: npm ci && npm test
```

1. 使用 GitHub 登录 Skipbox。
2. 安装 Skipbox GitHub 应用，并选择仓库。
3. 修改 `runs-on` 并推送。

你的步骤和操作原样运行，Ubuntu 24.04，带有 Docker、Node.js 和 Python。

## 安全

- 这台机器只属于你的账号。不会运行其他公司的作业。
- 每个作业结束后，运行器的凭据、进程和容器都会被清除，保留的检出目录中的 git 凭据和未跟踪文件也一样。开启“每个作业用新虚拟机”后，每个作业改在一台新机器上运行。
- 没有写入权限的人提交的代码（例如来自复刻的拉取请求）在一台新的虚拟机上运行，它能读取你的缓存，但不能修改。

详情见[作业如何隔离](https://docs.skipbox.dev/zh-hans/isolation)。

## 用你最慢的作业试试

试用免费，为期 7 天 或 3,000 作业分钟，以先到者为准，无需绑卡。把关键路径上的那个作业改为 `runs-on: skipbox`，运行两次，再把第二次运行各步骤的耗时和 GitHub 上的对照着看。

## 常见问题

### 我们的 GitHub Actions 流水线要 25 分钟。让它变快的最快办法是什么？

按顺序来。读运行的依赖图和步骤耗时，找出决定总时间的那条作业链，把排队时间单独看。取消被替代的运行，跳过文件没有改动的作业。去掉只是出于习惯的 needs:，让相互独立的作业同时运行。不要每个作业都重建状态：用真正能命中的缓存，或者一个保留磁盘的运行器。给吃 CPU 的步骤更多核心，并让测试运行器用上它们。只对仍然很长的部分做分片。在私有仓库的 ubuntu-latest（2 个 CPU、8 GB）上，最后三项往往占了 25 分钟的大部分，而它们都是机器的问题：Skipbox 给作业一台在作业之间保留缓存的专属机器，4 到 16 vCPU。

### 和优化工作流相比，换成更快的运行器值得吗？

先做免费的工作流修正：取消被替代的运行、路径过滤和去掉不必要的 needs: 都不花钱，也没有哪个运行器会替你做。之后，看剩下的时间花在哪里。每个作业都重复的准备工作（工具链、依赖安装、Docker 构建）和把每个核心都占满的步骤，是机器的问题，一个保留缓存、核心更多的运行器，只改一行 runs-on 就能消除它们。网络等待和串行步骤不会因为机器更大而变快。

### 为什么 GitHub Actions 比我的笔记本电脑慢？

你的笔记本电脑把包、工具、Docker 层和构建输出都留在磁盘上，通常还有 8 个或更多核心。私有仓库的 ubuntu-latest 作业只有 2 个 CPU、8 GB，而且是在一台这些都没有的新虚拟机上。Skipbox 像你的笔记本电脑一样工作：机器在作业之间一直保留，有 4 vCPU 或更多。

### 对测试分片能让 GitHub Actions 变快吗？

它缩短的是墙上时间，而不是分钟数。每个分片都是一个新作业，要重新检出、安装和构建，所以四个分片就要付四次准备工作的钱，按分钟计费时每一次都算。先让准备工作变便宜、让运行器的核心都用上，再做分片。在 Skipbox 上，准备工作留在磁盘上，分钟数不限，所以分片不额外花钱。

### 怎样让 GitHub Actions 作业用上 4 个以上的核心？

在 GitHub 上，大型运行器有 4 到 96 核，只面向 GitHub Team 或 Enterprise Cloud 上的组织，按分钟计费。在 Skipbox 上，把 runs-on 改为 skipbox-8x16 就是 8 vCPU，改为 skipbox-16x32 就是 16 vCPU，按月固定价格，组织和个人账号都一样。

### 试用要花多少钱？

不花钱。试用为期 7 天 或 3,000 作业分钟，以先到者为准，无需绑卡。把最慢的作业的 runs-on 改为 skipbox，运行两次，比一比它各步骤的耗时。

更新于 2026-11-13 · https://skipbox.dev/zh-hans/guides/speed-up-github-actions
