# docker compose 在每個 GitHub Actions 作業都拉取所有映像檔：怎麼不再一直拉同樣的映像檔

> 每個 GitHub Actions 作業都從一台沒有任何 Docker 映像檔的新 VM 開始，所以 docker compose up 又要拉取 Postgres、Redis 和其他所有服務的映像檔。用 docker save 搭配 actions/cache 只是把下載移到別處，而且在 GitHub 的 10 GB 之內。在保留磁碟的 Runner 上，映像檔本來就在。Skipbox 就是這樣的 Runner，每月固定 $39：改一行 runs-on 就好。

`docker compose up` 在每個 GitHub Actions 作業都拉取所有映像檔，是因為 GitHub 託管 Runner 上的每個作業都從一台新的 VM 開始。Postgres、Redis、訊息佇列、你自己的服務映像檔：沒有一個在磁碟上，所以在第一個測試執行之前，Compose 要把它們全部下載並解開。要不再一直拉同樣的映像檔，方法就是在還留著它們的機器上執行作業。

Skipbox 就是那台機器。你的作業在帳號的專屬機器上執行，這台機器在作業之間保留 Docker 的映像檔、層和建置快取。`docker compose up` 會找到上次拉取的東西，然後直接啟動容器。改一行 `runs-on: skipbox`，每月固定 $39，分鐘數不限。

- GitHub：每個作業一台新的 VM，所以 compose 檔案裡的每個映像檔，每個作業都要再拉一次
- Skipbox：映像檔留在你機器的磁碟上，只下載有變動的層
- 4 vCPU 每月 20,000 分鐘：GitHub 上要 $222，Skipbox 上是 $39

**GitHub Actions 固定價格，分鐘數不限** Skipbox 在你的專屬機器上執行 GitHub Actions 作業：每月 $39，不論執行多少分鐘。Docker 層和相依套件快取在作業之間保留，下一個作業馬上就能開始。

4 vCPU Runner，每月 20,000 分鐘: GitHub $222 → Skipbox $39. 每月省下 $183.

換過來只要改一行：`runs-on: skipbox`。

[開始 7 天免費試用](https://app.skipbox.dev/sign-in?ref=g-docker-compose-pull-slow-github-actions-zh-hant)

## 為什麼每個作業都要拉取

- **每個作業一台新的 VM。** GitHub 的 [Runner 參考文件](https://docs.github.com/en/actions/reference/runners/github-hosted-runners)（2026 年 11 月 14 日讀取）說，每個 GitHub 託管 Runner 都是一台由 GitHub 託管的新虛擬機器（VM）。上一個作業拉取的東西都不在上面。
- **Compose 會拉取缺少的東西。** 預設的 [`pull_policy`](https://docs.docker.com/reference/compose-file/services/) 是 `missing`：只有在平台快取中找不到映像檔時，Compose 才會拉取。在新的 VM 上，每個映像檔都找不到。
- **拉取就是下載加解開。** 每一層都要下載、解壓縮，再寫進 VM 的磁碟。私有儲存庫的 `ubuntu-latest` 只有 2 顆 CPU 和 14 GB 的 SSD 來做這件事。

所以第一個測試之前的時間，取決於你 compose 檔案的大小，而且每次推送都要全額付一次。

## 在 GitHub 託管 Runner 上能做什麼

這些選項只是把下載移到別處；沒有一個能把它去掉。

| 選項 | 每個作業仍然要做的事 | 限制 |
|---|---|---|
| `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 會移除所有容器，並刪除 registry 的登入資訊（`~/.docker/config.json`）。下一個作業會從已經在磁碟上的映像檔，重新啟動它的服務。
- **有足夠的空間。** S 的磁碟有 80 GB，GitHub 的 Runner 是 14 GB。在作業之後磁碟快滿之前，什麼都不會被刪除；快滿時會先刪除 dangling 映像檔，再刪除最久沒用的建置快取。

除了 `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 | 每月省下 |
|---|---|---|---|
| 10,000 | $102 | $39 | **$63** |
| 20,000 | $222 | $39 | **$183** |
| 30,000 | $342 | $39 | **$303** |

GitHub 的金額已扣除 GitHub Team 的內含用量。把你自己的分鐘數填進[首頁的費用試算](https://skipbox.dev/?ref=g-docker-compose-pull-slow-github-actions-zh-hant#cost)。

## 換過去只要改一行

1. 使用 GitHub 登入 Skipbox。
2. 安裝 Skipbox GitHub App，並選擇儲存庫。
3. 修改整合測試作業的 `runs-on` 並推送。

在同一個工作流程裡也建置映像檔？[GitHub Actions 的 Docker 層快取](https://skipbox.dev/zh-hant/guides/docker-layer-cache-github-actions)涵蓋了 `docker build` 和 buildx。

## 安全性

- 機器只屬於你的帳號。其他公司的作業不會在上面執行。
- 每個作業結束後，Runner 的憑證、程序和容器都會被清除，`~/.docker/config.json` 也是，所以 registry 的登入資訊不會延續到下一個作業。開啟「每個作業都用新 VM」，每個作業就會改用一台全新的機器。
- 沒有寫入權限的人提交的程式碼（例如來自 fork 的 Pull Request），會在全新、用完即丟的機器上執行，絕不會在你的機器上。

詳情請見[作業如何隔離](https://docs.skipbox.dev/zh-hant/isolation)。

## 用你的整合測試試試看

試用免費，為期 7 天或 3,000 作業分鐘，以先到者為準，不需信用卡。把作業改成 `runs-on: skipbox`，執行兩次，再把第二次執行的 `docker compose up` 和 GitHub 上的並排比較。

## 常見問題

### 我們在 GitHub Actions 上以 docker compose 為基礎的整合測試，大部分時間都花在拉取映像檔。怎麼避免每個作業都拉同樣的映像檔？

把作業放在會保留磁碟的機器上執行。GitHub 託管 Runner 每個作業都是一台新的 VM，所以沒有任何映像檔會留下來，compose 又要全部拉一次。在 Skipbox 上，作業在你帳號的專屬機器上執行，這台機器在作業之間保留 Docker 的映像檔：docker compose up 會找到上次拉取的映像檔，然後直接啟動容器。只要改一行 runs-on: skipbox，每月固定 $39，分鐘數不限。

### 為什麼 docker compose 在每個 GitHub Actions 作業都要再拉一次映像檔？

因為映像檔不在機器上時 Compose 就會拉取，而在 GitHub 託管 Runner 上它從來都不在。GitHub 的 Runner 參考文件說，每個 GitHub 託管 Runner 都是一台新的虛擬機器；上一個作業拉取的東西都不在上面。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。每個作業結束後，容器會被移除，registry 的登入資訊會被刪除；映像檔則留下來。

### compose 檔案裡的映像檔有變動時會怎樣？

只會下載有變動的層。想讓每個作業都檢查 registry 時，在 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-hant/guides/docker-compose-pull-slow-github-actions
