# GitHub Actions 中的 “No space left on device”：找出什么占满了磁盘，腾出空间，或者换一块更大的磁盘

> GitHub 在标准 Linux 运行器上只保证 14 GB 可用空间，Docker 镜像、恢复的缓存和构建目录会把它填满。本文讲怎样看出什么占满了磁盘、可以从运行器镜像中删掉什么，以及更大的磁盘从哪里来：Team 和 Enterprise 上 GitHub 的大型运行器，或者 Skipbox 的专属机器，S 为 80 GB，M 为 160 GB，L 为 320 GB，价格固定。

GitHub Actions 上的 "No space left on device" 意味着作业写入的数据超过了运行器的可用空间，在 GitHub 的标准 Linux 运行器上，这大约是 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 的大型运行器有 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 标准运行器只有约 14 GB 可用
- Docker 的镜像和层以及包缓存在作业之间都留在这块磁盘上
- 作业结束后超过 85% 时，按最近最少使用的顺序清理回 75%

**固定价格的 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-github-actions-no-space-left-on-device-zh-hans)

## GitHub 运行器有多少磁盘

[GitHub 托管的运行器](https://docs.github.com/en/actions/reference/runners/github-hosted-runners)列出标准 Linux 运行器有 14 GB SSD，私有仓库和公开仓库都一样。在 [runner-images 讨论 #9329](https://github.com/actions/runner-images/discussions/9329) 中，一次镜像变更让 Ubuntu 运行器的可用空间从 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 的镜像、容器、卷和构建缓存各占多少。

## 2. 少写一些

- **在两次构建之间清理 Docker**：[`docker system prune`](https://docs.docker.com/reference/cli/docker/system/prune/) 删除已停止的容器、未使用的网络、悬空镜像和未使用的构建缓存；`-a` 删除所有未使用的镜像，`--volumes` 还会删除匿名卷。
- **只缓存值得缓存的东西**：恢复的缓存会在运行器的磁盘上解压，所以一个大的缓存归档占的空间比它的下载量还大。按作业拆分，或者去掉那些重新获取也很快的东西。
- **清理构建目录**：后面的步骤用不到的构建目录，在需要空间的步骤之前清掉。

## 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，因为下一个作业的虚拟机上又有它们。删掉 `$AGENT_TOOLSDIRECTORY`（整个托管工具缓存）能腾出更多空间，但正如 #2875 的作者发现的那样，会让依赖那里工具的步骤出错。[free-disk-space](https://github.com/marketplace/actions/free-disk-space-ubuntu) 这个操作封装了这些删除；它的作者在那个讨论之后加上了工具缓存选项，说它能再多腾出 6GB。

## 4. 在更大的磁盘上运行作业

| 运行器 | 磁盘 | 谁能用 |
|---|---|---|
| GitHub 标准 Linux 运行器 | 14 GB SSD，约 14 GB 可用 | 所有人 |
| GitHub 大型运行器，2 到 96 vCPU | 2 vCPU 为 75 GB，4 vCPU 为 150 GB，8 vCPU 为 300 GB，最多 2,040 GB（[大型运行器](https://docs.github.com/en/actions/reference/runners/larger-runners)） | GitHub Team 和 Enterprise Cloud 上的组织，按分钟计费（[关于大型运行器](https://docs.github.com/en/actions/concepts/runners/larger-runners)） |
| 自托管运行器 | 你给它多少就是多少；一个在作业之间保留的运行器，没有东西清理的话，会被镜像和旧的工作区填满 | 所有人，由你运维 |
| 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%：先是悬空镜像，然后是 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 上每月 2万分钟，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 应用，并选择仓库。
3. 修改 `runs-on` 并推送。

## 安全

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

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

## 用磁盘不够用的作业试试

试用免费，为期 7 天 或 3,000 作业分钟，以先到者为准，无需绑卡。试用在 S 的 80 GB 机器上运行 `runs-on: skipbox`。把作业移过去，删掉删除预装工具的那个步骤，然后运行。

## 常见问题

### GitHub Actions 运行器有多少磁盘空间？

GitHub 的文档列出标准 Linux 运行器有 14 GB SSD，私有仓库和公开仓库都一样，runner-images 的一位维护者也写过，GitHub 对两者都只保证 14 GB 可用空间。磁盘本身更大，但运行器镜像预装的工具占了其余部分，所以按 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），如果作业还需要更多空间，就在磁盘更大的运行器上运行它。

### 可以从 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 也能腾出托管工具缓存的空间，但会让依赖那里工具的 setup 步骤出错。每次运行，删掉几个 GB 都要花时间。

### GitHub 的大型运行器磁盘更大吗？

是的：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%，所以它不会像自托管运行器的磁盘那样被填满。自己要写几十 GB 的作业，M 和 L 给足空间。

### 试用要花多少钱？

不花钱。试用为期 7 天 或 3,000 作业分钟，以先到者为准，无需绑卡，使用 S 的机器。把磁盘不够用的作业改为 runs-on: skipbox，再删掉那些删除预装工具的步骤。

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