# docker compose 在每个 GitHub Actions 作业里都拉取所有镜像：怎样不再重复拉取同样的镜像

> 每个 GitHub Actions 作业都在一台没有任何 Docker 镜像的新虚拟机上启动，所以 docker compose up 又要拉取 Postgres、Redis 和其他每一个服务镜像。docker save 加 actions/cache 只是把下载换了个地方，还得挤在 GitHub 的 10 GB 里。在一个保留磁盘的运行器上，镜像早就在那里了。Skipbox 就是这样的运行器，每月固定 $39：只改一行 runs-on。

`docker compose up` 在每个 GitHub Actions 作业里都拉取所有镜像，是因为 GitHub 托管运行器上的每个作业都在一台新虚拟机上启动。Postgres、Redis、消息代理、你自己的服务镜像：一个都不在磁盘上，所以 Compose 在第一个测试运行之前要把它们全部下载并解压。要不再重复拉取同样的镜像，就在一台还留着它们的机器上运行作业。

Skipbox 就是那台机器。你的作业在你账号的专属机器上运行，它在作业之间保留 Docker 的镜像、层和构建缓存。`docker compose up` 找到上次拉取的东西，直接启动容器。只改一行 `runs-on: skipbox`，每月固定 $39，分钟数不限。

- GitHub：每个作业一台新虚拟机，所以 compose 文件里的每个镜像，每个作业都要重新拉取
- Skipbox：镜像留在你机器的磁盘上，只下载有变化的层
- 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-docker-compose-pull-slow-github-actions-zh-hans)

## 为什么每个作业都要拉取

- **每个作业一台新虚拟机**：GitHub 的[运行器参考文档](https://docs.github.com/en/actions/reference/runners/github-hosted-runners)（2026年11月14日查阅）说，每个 GitHub 托管的运行器都是一台由 GitHub 托管的新虚拟机（VM）。上一个作业拉取的东西都不在上面。
- **Compose 拉取缺少的镜像**：默认的 [`pull_policy`](https://docs.docker.com/reference/compose-file/services/) 是 `missing`：只有镜像不在平台缓存中时，Compose 才会拉取。在新虚拟机上，每个镜像都是缺少的。
- **拉取就是下载加解压**：每一层都要下载、解压，再写到虚拟机的磁盘上。私有仓库的 `ubuntu-latest` 只有 2 个 CPU 和 14 GB SSD 来做这些事。

所以第一个测试之前的时间，取决于你的 compose 文件有多大，每次推送都要全额付一遍。

## 在 GitHub 托管的运行器上能做什么

这些办法只是把下载换了个地方；没有一个能去掉它。

| 办法 | 每个作业仍然要做什么 | 限制 |
|---|---|---|
| `docker save` + actions/cache + `docker load` | 下载归档，再把每个镜像载入 Docker | 计入 GitHub 每个仓库 10 GB 的额度，和其他所有缓存共用 |
| 更小的镜像（`-alpine`、`-slim`） | 全部拉取，只是更快 | 仅限有小型变体的镜像 |
| 每个作业少起几个服务 | 拉取的镜像更少 | 需要完整技术栈的测试仍然要全部拉取 |

每一种都是让一台健忘的机器少忘一点。只有机器记得住，拉取才会消失。

## Skipbox 把镜像留在你的机器上

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

- **镜像留在磁盘上**：`docker compose up` 找到上次拉取的镜像，直接去启动容器。
- **只下载变化**：`docker compose pull` 获取有变化的层，其余的复用。
- **你自己的服务镜像从缓存构建**：`docker compose build` 复用上一次构建的层，不需要 `cache-from` 或 `cache-to`。
- **每个作业都干净地开始**：每个作业结束后，Skipbox 删除所有容器，并删除镜像仓库的登录信息（`~/.docker/config.json`）。下一个作业用磁盘上已有的镜像，重新启动它的服务。
- **放得下它们**：S 的磁盘为 80 GB，而 GitHub 的运行器只有 14 GB。作业结束后磁盘快满时才会删除东西；先删悬空镜像，再删最久未用的构建缓存。

除了 `runs-on`，工作流不用改：

```yaml
jobs:
  integration:
    runs-on: skipbox # was ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - run: docker compose up -d --wait
      - run: npm ci && npm run test:integration
```

如果你用 actions/cache 和 `docker load` 保存过镜像，删掉那些步骤。Skipbox 上的第一个作业会把每个镜像拉取一次。第二个作业就在机器上找到它们。

作业按标签选择规格：

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

## 同样的分钟数，固定的价格

集成测试是耗时长的作业，所以按分钟计费的账单就是跟着它们增长的。在 Skipbox 上分钟数不限：

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

GitHub 的金额已减去 GitHub Team 包含的用量。把你自己的分钟数填进[首页的计算器](https://skipbox.dev/?ref=g-docker-compose-pull-slow-github-actions-zh-hans#cost)。

## 切换只需改一行

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

同一个工作流里还要构建镜像？[GitHub Actions 中的 Docker 层缓存](https://skipbox.dev/zh-hans/guides/docker-layer-cache-github-actions)讲了 `docker build` 和 buildx。

## 安全

- 这台机器只属于你的账号。不会运行其他公司的作业。
- 每个作业结束后，运行器的凭据、进程和容器都会被清除，`~/.docker/config.json` 也一样，所以镜像仓库的登录不会带到下一个作业。开启“每个作业用新虚拟机”后，每个作业改在一台新机器上运行。
- 没有写入权限的人提交的代码（例如来自复刻的拉取请求）在一台新的一次性机器上运行，从不在你的机器上运行。

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

## 用你的集成测试试试

试用免费，为期 7 天 或 3,000 作业分钟，以先到者为准，无需绑卡。把作业改为 `runs-on: skipbox`，运行两次，再把第二次运行的 `docker compose up` 与 GitHub 上的并排对比。

## 常见问题

### 我们在 GitHub Actions 上基于 docker compose 的集成测试，大部分时间都花在拉取镜像上。怎样避免每个作业都拉取同样的镜像？

在一台保留磁盘的机器上运行作业。GitHub 托管的运行器每个作业都是一台新虚拟机，所以没有镜像能留下来，compose 只好全部重新拉取。在 Skipbox 上，作业在你账号的专属机器上运行，它在作业之间保留 Docker 的镜像：docker compose up 找到上次拉取的镜像，直接启动容器。改动只有一行 runs-on: skipbox，每月固定 $39，分钟数不限。

### 为什么 docker compose 在每个 GitHub Actions 作业里都要重新拉取镜像？

因为镜像不在机器上时，Compose 就会拉取，而在 GitHub 托管的运行器上，它从来都不在。GitHub 的运行器参考文档说，每个 GitHub 托管的运行器都是一台新的虚拟机；上一个作业拉取的东西都不在上面。Compose 默认的 pull_policy 是 missing，镜像如果在的话，本来会跳过拉取。

### 能用 actions/cache 缓存 docker compose 的镜像吗？

能，但只是把下载换了个地方。docker save 把镜像写成一个 tar 文件，actions/cache 存储它，下一个作业恢复它再运行 docker load。每个作业仍要下载整个归档并把它载入 Docker，而这个归档还要算进 GitHub 每个仓库 10 GB 的缓存，和你的依赖缓存共用。在一台保留磁盘的机器上，没有什么需要 save 或 load。

### Skipbox 会在作业之间保留 Docker 镜像吗？

会。每个套餐都附带你账号的专属机器，在作业之间一直保留，它把 Docker 的镜像、层和构建缓存都留在磁盘上：S 为 80 GB，M 为 160 GB，L 为 320 GB。每个作业结束后，容器会被删除，镜像仓库的登录信息也会被删除；镜像留下来。

### compose 文件里的镜像变了会怎样？

只下载有变化的层。想让每个作业都检查一次镜像仓库，就在 docker compose up 之前加上 docker compose pull：Docker 会获取新的层，复用机器磁盘上已有的层。你自己用 docker compose build 构建的镜像，也以同样的方式复用上一次构建的层。

### 试用要花多少钱？

不花钱。试用为期 7 天 或 3,000 作业分钟，以先到者为准，无需绑卡。把集成测试作业改为 runs-on: skipbox，运行两次，再把第二次运行的 docker compose up 与 GitHub 上的对比。

更新于 2026-11-14 · https://skipbox.dev/zh-hans/guides/docker-compose-pull-slow-github-actions
