# GitHub Actions 的「No space left on device」：找出是什麼塞滿磁碟、釋放空間，或換一個更大的磁碟

> GitHub 在它的標準 Linux Runner 上只保證 14 GB 的可用空間，而 Docker 映像檔、快取還原和建置目錄會把它塞滿。怎麼看出是什麼塞滿了磁碟、要從 Runner 映像檔裡刪掉什麼，以及更大的磁碟從哪裡來：Team 和 Enterprise 上 GitHub 的大型 Runner，或是 Skipbox 的專屬機器，S 有 80 GB，M 有 160 GB，L 有 320 GB，價格固定。

GitHub Actions 上的「No space left on device」，表示作業寫入的量超過了 Runner 的可用空間，而在 GitHub 的標準 Linux Runner 上，那大約是 14 GB：一位 runner-images 維護者寫道，GitHub 對私有和公開儲存庫都只保證 14 GB 的可用空間，因為映像檔預先安裝的工具占掉了其餘的部分（一位使用者在 `ubuntu-latest` 上列出的清單：12 GB 的 Android SDK、8.5 GB 的託管工具快取、5.5 GB 的 GHC）。Docker 映像檔、在磁碟上解開的還原快取，以及建置目錄，很快就會把 14 GB 塞滿。請依這個順序修正：看看是什麼塞滿了磁碟（`df -h`、`df -i`、`du`、`docker system df`）、少寫一點、刪掉作業用不到的預先安裝工具，如果還是放不下，就在更大的磁碟上執行作業。GitHub 的大型 Runner 有 75 GB 以上，但只限 GitHub Team 和 Enterprise Cloud。

Skipbox 在你帳號的專屬機器上執行作業，S 有 80 GB 的磁碟，M 有 160 GB，L 有 320 GB，價格固定，分鐘數不限。它在作業之間保留的快取就放在這個磁碟上，磁碟快滿時會清理其中最舊的部分，所以作業一開始不需要刪除任何東西。

- S 有 80 GB 的磁碟，M 有 160 GB，L 有 320 GB，GitHub 的標準 Runner 大約只有 14 GB 可用
- Docker 的映像檔和層，以及套件快取，在作業之間都留在這個磁碟上
- 作業結束後超過 85%，就從最久沒用的開始清理，回到 75%

**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-github-actions-no-space-left-on-device-zh-hant)

## GitHub Runner 有多少磁碟

[GitHub 託管 Runner](https://docs.github.com/en/actions/reference/runners/github-hosted-runners) 列出標準 Linux Runner 有 14 GB 的 SSD，私有和公開儲存庫都一樣。在 [runner-images discussion #9329](https://github.com/actions/runner-images/discussions/9329) 中，一次映像檔變更讓 Ubuntu Runner 的可用空間從超過 31 GB 降到超過 17 GB 之後，一位維護者回答，他們對私有和公開儲存庫確實都只保證 14 GB 的可用空間。請以 14 GB 來規劃。

磁碟的其餘部分就是映像檔。在 [issue #10386](https://github.com/actions/runner-images/issues/10386)（「Free space left: 72 MB」）中，一位使用者在 `ubuntu-latest` 上執行 `du` 的結果是：

| 目錄 | 大小 |
|---|---|
| `/usr/local/lib/android` | 12 GB |
| `/opt/hostedtoolcache` | 8.5 GB（光 CodeQL 就 5 GB） |
| `/usr/local/.ghcup` | 5.5 GB |

## 1. 看看是什麼塞滿了磁碟

在失敗的步驟後面加一個步驟，加上 `if: always()`：

```yaml
- name: Disk usage
  if: always()
  run: |
    df -h
    df -i /
    sudo du -xh --max-depth=1 / 2>/dev/null | sort -rh | head -15
    docker system df || true
```

- `df -h` 顯示每個檔案系統以及它有多滿。注意你的作業寫入的是哪一個：工作區、`/var/lib/docker` 底下的 Docker 資料，或暫存目錄。
- `df -i` 顯示 inode。磁碟可能在還有剩餘空間時就用光 inode（每個檔案一個），錯誤訊息是一樣的。
- `du` 顯示最大的目錄。
- [`docker system df`](https://docs.docker.com/reference/cli/docker/system/df/) 顯示 Docker 的映像檔、容器、volume 和建置快取占了多少。

## 2. 少寫一點

- **在建置之間清理 Docker。** [`docker system prune`](https://docs.docker.com/reference/cli/docker/system/prune/) 會移除停止的容器、沒用到的網路、dangling 映像檔和沒用到的建置快取；`-a` 會移除所有沒用到的映像檔，`--volumes` 連匿名 volume 也會移除。
- **只快取值得的東西。** 還原的快取會在 Runner 的磁碟上解開，所以大的快取封存檔占用的空間比它下載的量還多。依作業拆分它，或拿掉能很快重新抓取的部分。
- **清理之後的步驟用不到的建置目錄**，在需要空間的步驟之前清掉。

## 3. 刪掉作業用不到的預先安裝工具

依 [issue #2875](https://github.com/actions/runner-images/issues/2875) 和 #10386：

```yaml
- name: Free disk space
  run: |
    sudo rm -rf /usr/local/lib/android /usr/local/.ghcup /opt/hostedtoolcache/CodeQL
    sudo rm -rf /usr/share/dotnet /usr/local/share/boost
    df -h /
```

有兩個代價。刪除好幾 GB 的檔案每次執行都要花時間，因為下一個作業的 VM 又會有它們。而刪除 `$AGENT_TOOLSDIRECTORY`（整個託管工具快取）能釋放更多空間，但就像 #2875 的作者發現的，會讓步驟預期在那裡的工具壞掉。[free-disk-space](https://github.com/marketplace/actions/free-disk-space-ubuntu) action 把這些刪除包裝起來；它的作者在那個討論串之後加上了工具快取的選項，說它能再多省下 6 GB。

## 4. 在更大的磁碟上執行作業

| Runner | 磁碟 | 誰可以用 |
|---|---|---|
| GitHub 標準 Linux Runner | 14 GB SSD，大約 14 GB 可用 | 所有人 |
| GitHub 大型 Runner，2 到 96 vCPU | 2 vCPU 有 75 GB，4 vCPU 有 150 GB，8 vCPU 有 300 GB，最多到 2,040 GB（[大型 Runner](https://docs.github.com/en/actions/reference/runners/larger-runners)） | GitHub Team 和 Enterprise Cloud 的組織，按分鐘計費（[關於大型 Runner](https://docs.github.com/en/actions/concepts/runners/larger-runners)） |
| 自架 Runner | 你給它多少就有多少；在作業之間保留下來的 Runner，除非有東西清理，否則會被映像檔和舊的工作區塞滿 | 所有人，由你維運 |
| Skipbox 專屬機器 | S 有 80 GB，M 有 160 GB，L 有 320 GB，滿了會自動清理 | 組織和個人帳號，固定價格 |

## Skipbox 怎麼處理磁碟

每個方案都附有一台你帳號專屬、在作業之間保留下來的機器，磁碟大小依規格而定：

- **S 的磁碟有 80 GB，M 有 160 GB，L 有 320 GB。**
- **留在上面的是你的狀態：** Docker 的映像檔、層和建置快取、`~/.npm`、pnpm store、`~/.cache`，以及 Go、Gradle、Maven 和 Cargo 的快取，還有 `setup-*` 安裝的工具。`actions/cache` 儲存的東西留在機器旁邊，最多占磁碟的一半。
- **它不會被塞滿。** 在作業之後磁碟超過 85% 之前，什麼都不會被刪除。超過時會從最久沒用的開始清理，回到 75%：先是 dangling 映像檔，再來是 Docker 的建置快取，然後是整個套件快取和保留的建置。只有在清理後仍然超過 85% 時，機器才會被重設。
- **要更多磁碟，就升一級方案。** 自己就要寫入數十 GB 的作業，例如大型映像檔或很大的建置目錄，M 有 160 GB，L 有 320 GB。

| 標籤 | 機器 | 磁碟 | 方案 |
|---|---|---|---|
| `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 |

分鐘數不限。4 vCPU 每月 20,000 分鐘，GitHub 收 $222；Skipbox S 是 $39。

## 換過去只要改一行

```yaml
jobs:
  build:
    runs-on: skipbox-8x16 # was ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      # the "Free disk space" step can go
      - run: docker build -t app .
```

`skipbox-8x16` 在 M 方案上執行；`runs-on: skipbox` 在 S 和試用中執行。

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

## 安全性

- 機器只屬於你的帳號。其他公司的作業不會在上面執行。
- 每個作業結束後，Runner 的憑證、程序和容器都會被清除，家目錄裡的憑證檔案也是。開啟「每個作業都用新 VM」，每個作業就會改用一台全新的機器。
- 沒有寫入權限的人提交的程式碼（例如來自 fork 的 Pull Request），會在全新的 VM 上執行，可以讀取你的快取但不能修改。

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

## 用磁碟不夠的作業試試看

試用免費，為期 7 天或 3,000 作業分鐘，以先到者為準，不需信用卡。它在 S 的機器上以 80 GB 執行 `runs-on: skipbox`。把作業移過去，拿掉刪除預先安裝工具的步驟，然後執行。

## 常見問題

### GitHub Actions Runner 有多少磁碟空間？

GitHub 的文件列出標準 Linux Runner 有 14 GB 的 SSD，私有和公開儲存庫都一樣，而一位 runner-images 維護者寫道，GitHub 對兩者都只保證 14 GB 的可用空間。磁碟本身更大，但 Runner 映像檔預先安裝的工具占掉了其餘的空間，所以請以 14 GB 來規劃。

### 怎麼修好 GitHub Actions 的 No space left on device？

先看看是什麼塞滿了它：用 df -h 看每個檔案系統，df -i 看 inode，sudo du -xh --max-depth=1 / 看最大的目錄，docker system df 看 Docker 的映像檔和建置快取。然後少寫一點（在建置之間清理 Docker、只快取值得的東西）、刪掉作業用不到的預先安裝工具（Android SDK、GHC、CodeQL、.NET），如果作業還是需要更多空間，就在磁碟更大的 Runner 上執行。

### 可以從 ubuntu-latest 刪掉什麼來釋放磁碟空間？

作業用不到的工具。GitHub runner-images 的 issue 裡，使用者會刪除 /usr/local/lib/android（在一位使用者的清單中有 12 GB）、/usr/local/.ghcup、/opt/hostedtoolcache/CodeQL、/usr/share/dotnet 和 /usr/local/share/boost。刪除 $AGENT_TOOLSDIRECTORY 也能釋放託管工具快取，但會讓預期工具在那裡的設定步驟壞掉。刪除好幾 GB 的檔案，每次執行都要花時間。

### GitHub 的大型 Runner 有更多磁碟嗎？

有：2 vCPU 有 75 GB，4 vCPU 有 150 GB，8 vCPU 有 300 GB，64 和 96 vCPU 最多到 2,040 GB。它們只提供給 GitHub Team 或 GitHub Enterprise Cloud 上的組織，按分鐘計費。

### Skipbox 給作業多少磁碟？

你帳號的專屬機器，S 有 80 GB，M 有 160 GB，L 有 320 GB。在作業之間保留的快取共用這個磁碟：作業結束後磁碟使用率超過 85% 時，會從最久沒用的開始清理，回到 75%，所以它不會像自架 Runner 的磁碟那樣被塞滿。自己就要寫入數十 GB 的作業，M 和 L 給足空間。

### 試用要花多少錢？

不用錢。試用為期 7 天或 3,000 作業分鐘，以先到者為準，不需信用卡，在 S 的機器上執行。把磁碟不夠的作業改成 runs-on: skipbox，再拿掉刪除預先安裝工具的步驟。

更新於 2026-11-16 · https://skipbox.dev/zh-hant/guides/github-actions-no-space-left-on-device
