Skipbox

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

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,价格固定,分钟数不限。它在作业之间保留的缓存就放在这块磁盘上,磁盘快满时它会清理最旧的那些,所以作业开始时不需要删任何东西。

GitHub 运行器有多少磁盘

GitHub 托管的运行器列出标准 Linux 运行器有 14 GB SSD,私有仓库和公开仓库都一样。在 runner-images 讨论 #9329 中,一次镜像变更让 Ubuntu 运行器的可用空间从 31 GB 以上降到 17 GB 以上之后,一位维护者回答说,他们对私有仓库和公开仓库确实都只保证 14 GB 可用空间。按 14 GB 来规划。

磁盘的其余部分是镜像。在 issue #10386("Free space left: 72 MB")中,一位用户在 ubuntu-latest 上运行 du 得到:

1. 看看是什么占满了磁盘

在失败的步骤之后加一个步骤,设置 if: always():

- 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 显示 Docker 的镜像、容器、卷和构建缓存各占多少。

2. 少写一些

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

3. 删掉作业用不到的预装工具

来自 issue #2875 和 #10386:

- 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 这个操作封装了这些删除;它的作者在那个讨论之后加上了工具缓存选项,说它能再多腾出 6GB。

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

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。

分钟数不限。在 4 vCPU 上每月 2万分钟,GitHub 收 $222;Skipbox S 是 $39。

切换只需改一行

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 并推送。

安全

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

详情见作业如何隔离。

用磁盘不够用的作业试试

试用免费,为期 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日

缓存始终预热,CI/CD 更快

固定价格的预热运行器

机器由 Skipbox 托管。你只需改一行。满负荷使用时,费用是 GitHub 的 1/12。价格固定,全天运行也不加钱。缓存空间是 GitHub 的 7 倍。

  • 无需绑卡
  • 使用 GitHub 登录
  • 随时取消