# 在 GitHub Actions 中给 pnpm 和 Turborepo 单体仓库提速（astro：528 秒到 30 秒）

> 在 GitHub Actions 上的 pnpm 和 Turborepo 单体仓库中，大部分时间花在新虚拟机上的 pnpm install，以及 turbo 运行那些结果不在机器上的任务。只运行受影响的包，给 turbo 一个缓存，并保留 pnpm store。或者在一台两者都保留的机器上运行：astro 的 CI 在 GitHub 上要 528 秒，在 Skipbox 上只要 30 秒，每月固定 $39。

在 GitHub Actions 上的 pnpm 和 Turborepo 单体仓库中，一个慢作业的大部分时间花在两个步骤上：新虚拟机上的 `pnpm install`，以及 `turbo run build test` 运行那些结果不在这台虚拟机上的任务。按这个顺序解决。只运行改动涉及的包（`turbo run build --affected`，检出时带上历史）。给 turbo 一个比作业活得久的缓存，因为它的结果放在 `.turbo/cache` 里，而那台机器在每个作业后都会被 GitHub 删除：用远程缓存，或者用 `actions/cache` 恢复 `.turbo`。并保留 pnpm store。在 GitHub 的运行器上，这些缓存每个作业都是一次下载。在一台保留磁盘的机器上，它们就在那里：astro 的 CI 作业在 GitHub 上要 528 秒，在 Skipbox 的专属机器上只要 30 秒，40 个构建任务全部从 turbo 保留的缓存中重放。

Skipbox 在你账号的专属机器上运行你的作业，这台机器在作业之间保留 pnpm store、工具和检出目录中的 `.turbo`，不需要远程缓存，也不需要缓存键。只改一行，`runs-on: skipbox`，每月固定 $39，分钟数不限。

- astro 的 CI：GitHub 上 528 秒，Skipbox 上 30 秒，turbo 重放了 40 个构建任务和测试任务
- pnpm store 和 turbo 的 `.turbo` 留在你的机器上：没有远程缓存要配置，没有归档要下载
- 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-pnpm-turborepo-monorepo-github-actions-zh-hans)

## 单体仓库的作业把时间花在哪里

| 步骤 | 在一台新的 GitHub 虚拟机上 |
|---|---|
| 检出 | 默认是浅克隆；`--affected` 需要历史，所以要完整克隆 |
| 设置 Node 和 pnpm | 要下载，除非工具缓存里有这个版本 |
| `pnpm install` | 从缓存归档恢复 store（或者从注册表下载），然后为每个包链接 `node_modules` |
| `turbo run build` | 每个任务都要运行，除非恢复了 `.turbo/cache`，或者远程缓存命中 |
| `turbo run test` | 一样，在私有仓库 `ubuntu-latest` 的 2 个 CPU 上 |

## 1. 只运行改动的部分

根据 [Turborepo 的 CI 指南](https://turborepo.dev/docs/crafting-your-repository/constructing-ci)：`turbo run build --affected` 只在相对于基准分支有改动的包中运行任务。在 GitHub Actions 中，它在拉取请求上读取 `GITHUB_BASE_REF`，在推送上读取 `GITHUB_EVENT_PATH`。浅克隆时，每个包都算作改动了，所以要检出历史：

```yaml
- uses: actions/checkout@v4
  with:
    fetch-depth: 0
    filter: blob:none
```

`turbo query affected --packages web` 告诉一个作业要不要运行，所以没被改动的应用对应的作业可以跳过安装。

## 2. 给 turbo 一个比作业活得久的缓存

Turborepo 把任务结果保存在[机器上](https://turborepo.dev/docs/crafting-your-repository/caching)的 `.turbo/cache` 里。GitHub 托管作业的机器在作业结束时被删除，所以在 CI 中，这个缓存每次都是空的。[Turborepo 的 GitHub Actions 指南](https://turborepo.dev/docs/guides/ci-vendors/github-actions)给出了两种办法：

- **远程缓存**：设置 `TURBO_TOKEN` 和 `TURBO_TEAM`（Vercel 远程缓存，或者自托管的服务器）。每次命中都是从它那里下载。
- **对 `.turbo` 用 `actions/cache`**：以 `${{ runner.os }}-turbo-${{ github.sha }}` 为键，设置 `restore-keys: ${{ runner.os }}-turbo-`。每次运行都保存一个新条目，和仓库缓存的其他所有东西一起，占用 GitHub 每个仓库 10 GB 的空间。

## 3. 保留 pnpm store

`actions/setup-node` 设置 `cache: pnpm`，或者对 `pnpm store path` 用 `actions/cache`，会以 `pnpm-lock.yaml` 为键恢复 store。它不恢复 `node_modules`，所以 pnpm 仍然要链接每个包。[pnpm 的 CI 文档](https://pnpm.io/continuous-integration)说得很直白：缓存 store 并不一定能让安装更快。在 CI 中，pnpm 会自动切换到 `--frozen-lockfile`。

## 4. 用上所有核心

turbo 并行运行相互独立的任务，每个构建或测试工具也会启动自己的工作进程，所以单体仓库会用上它能拿到的每一个核心。私有仓库的 `ubuntu-latest` 只有 2 个。

## 在 GitHub 的运行器上，每种办法的代价

- **远程缓存**：又一个服务、又一个令牌，每次缓存命中都要走网络。
- **对 `.turbo` 用 `actions/cache`**：每次运行都写一个条目，和 pnpm store、Docker 的层以及每个分支的缓存争夺同一个 10 GB；7 天没用到的条目会被删掉。
- **更大的运行器**：就是 GitHub Team 或 Enterprise Cloud 上的大型运行器，按分钟计费。

## 解决办法是一台保留磁盘的机器时

astro 自己的 CI，工作流不变，出自[真实项目的实测](https://skipbox.dev/zh-hans/guides/rust-cache-slow-rust-ci)：

| | GitHub（公开仓库，4 vCPU，16 GB） | Skipbox 专属机器（4 vCPU） |
|---|---|---|
| 作业 | 528 秒 | **30 秒**（[31 秒](https://github.com/skipbox-dev/astro/actions/runs/43351547473)，[28 秒](https://github.com/skipbox-dev/astro/actions/runs/43351638436)） |
| 构建任务 | 运行 40 个 | 40 个从 turbo 的缓存中重放 |
| 测试任务 | 运行 | 从 turbo 的缓存中重放 |

专属机器保留了上一个作业留下的检出目录中的 `.turbo` 和 pnpm store，所以 turbo 找到了每个任务的结果，什么都不用下载。turbo 只在任务的输入哈希相同时才重放它，所以一次真实的提交会重新运行它改动到的包，其余的重放。

## Skipbox 保留单体仓库的状态

每个套餐都附带你账号的专属机器，在作业之间一直保留：

- **pnpm store 保留**在 `~/.local/share/pnpm/store` 中，还有 npm 的缓存和各个工具的 `~/.cache`。`pnpm install` 从磁盘链接，而不是下载。
- **turbo 的缓存保留**：当 `turbo.json` 是 turbo 2 格式时，检出目录顶层的 `.turbo` 在作业之间保留：有 `tasks` 键，没有 `pipeline`，也没有 `"envMode": "loose"`。不需要 `TURBO_TOKEN`，也不需要缓存步骤。
- **`node_modules` 在每个作业后删除**，所以共用一个检出目录的 Node 版本矩阵，永远不会加载为另一个 Node 版本构建的原生插件。
- **工具保留**：`setup-node` 安装的 Node 版本、pnpm 本身、Docker 的镜像和层。

在 S 上，缓存空间至少是 GitHub 的 7 倍。作业按标签选规格：

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

分钟数不限。在 4 vCPU 上每月 2万分钟，GitHub 收 $222；Skipbox S 是 $39，少花 $183。

## 切换只需改一行

```yaml
jobs:
  build:
    runs-on: skipbox # was ubuntu-latest
    steps:
      - uses: actions/checkout@v4
        with:
          fetch-depth: 0
          filter: blob:none
      - uses: pnpm/action-setup@v3
      - uses: actions/setup-node@v4
        with:
          node-version: 22
          cache: pnpm
      - run: pnpm install
      - run: pnpm turbo run build test --affected
```

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

缓存步骤保持原样；它们保存的东西就放在机器旁边。

## 安全

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

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

## 用单体仓库试试

试用免费，为期 7 天 或 3,000 作业分钟，以先到者为准，无需绑卡。把构建作业改为 `runs-on: skipbox`，运行两次，再把第二次运行的 install 和 turbo 输出（`cached` 对比 `executing`）和 GitHub 上的放在一起看。

## 常见问题

### 怎样在 GitHub Actions 中给大型 pnpm/Turborepo 单体仓库提速？

按顺序做三件事。只运行改动的部分：turbo run build --affected，检出时带上历史（fetch-depth: 0 和 filter: blob:none）。给 turbo 一个作业结束后还在的缓存：Turborepo 的远程缓存，或者用 actions/cache 恢复 .turbo。并保留 pnpm store：setup-node 的 cache: pnpm，或者对 store 路径用 actions/cache。在 GitHub 每次都是新的虚拟机上，这些每个作业都是一次下载；在一台保留磁盘的机器上，它们早就在那里了。astro 的 CI 在 GitHub 上要 528 秒，在保留 turbo 缓存和 pnpm store 的 Skipbox 专属机器上只要 30 秒。

### 为什么即使缓存了 store，pnpm install 在 GitHub Actions 中还是很慢？

因为恢复的 store 仍然是一个要在新虚拟机上下载、解压的归档，之后 pnpm 还要为工作区的每个包链接 node_modules。pnpm 自己的 CI 文档说，缓存 store 并不一定能让安装更快。已经在机器磁盘上的 store 省掉了下载；只剩下链接。

### Turborepo 缓存在 GitHub Actions 中有效吗？

只有缓存比作业活得久才有效。Turborepo 把任务结果放在机器上的 .turbo/cache 里，而 GitHub 托管作业的机器在作业结束时就没了。所以 CI 需要远程缓存（TURBO_TOKEN 和 TURBO_TEAM，用 Vercel 的或自托管的），或者一个针对 .turbo 的 actions/cache 步骤。在 Skipbox 的专属机器上，对于 turbo 2 项目，检出目录中的 .turbo 在作业之间保留，所以 turbo 不用远程缓存就能重放没有改动的任务。

### turbo --affected 在 GitHub Actions 中能用吗？

能。Turborepo 在拉取请求上读取 GITHUB_BASE_REF，在推送上读取 GITHUB_EVENT_PATH，找出要比较的基准。它需要历史：浅克隆时，每个包都算作改动了。在 actions/checkout 上设置 fetch-depth: 0 和 filter: blob:none。

### Skipbox 为 Turborepo 单体仓库保留什么？

pnpm store、npm 和各个工具的缓存、setup-node 安装的工具、Docker 的层，以及当 turbo.json 是 turbo 2 格式时（有 tasks 键，没有 pipeline，也不是 envMode loose），检出目录及其顶层的 .turbo。node_modules 在每个作业后删除，所以 install 会运行，从磁盘上的 store 安装。turbo 只在任务的输入哈希相同时才重放它，所以一次提交会重新运行它改动到的部分。

### 试用要花多少钱？

不花钱。试用为期 7 天 或 3,000 作业分钟，以先到者为准，无需绑卡。把单体仓库的构建作业改为 runs-on: skipbox，运行两次，再把第二次运行的 install 和 turbo 步骤与 GitHub 上的比一比。

更新于 2026-11-13 · https://skipbox.dev/zh-hans/guides/pnpm-turborepo-monorepo-github-actions
