Skipbox

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

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,價格固定,分鐘數不限。它在作業之間保留的快取就放在這個磁碟上,磁碟快滿時會清理其中最舊的部分,所以作業一開始不需要刪除任何東西。

GitHub Runner 有多少磁碟

GitHub 託管 Runner 列出標準 Linux Runner 有 14 GB 的 SSD,私有和公開儲存庫都一樣。在 runner-images discussion #9329 中,一次映像檔變更讓 Ubuntu Runner 的可用空間從超過 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 的映像檔、容器、volume 和建置快取占了多少。

2. 少寫一點

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

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 的檔案每次執行都要花時間,因為下一個作業的 VM 又會有它們。而刪除 $AGENT_TOOLSDIRECTORY(整個託管工具快取)能釋放更多空間,但就像 #2875 的作者發現的,會讓步驟預期在那裡的工具壞掉。free-disk-space action 把這些刪除包裝起來;它的作者在那個討論串之後加上了工具快取的選項,說它能再多省下 6 GB。

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%:先是 dangling 映像檔,再來是 Docker 的建置快取,然後是整個套件快取和保留的建置。只有在清理後仍然超過 85% 時,機器才會被重設。
  • 要更多磁碟,就升一級方案。 自己就要寫入數十 GB 的作業,例如大型映像檔或很大的建置目錄,M 有 160 GB,L 有 320 GB。

分鐘數不限。4 vCPU 每月 20,000 分鐘,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 App,並選擇儲存庫。
  3. 修改 runs-on 並推送。

安全性

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

詳情請見作業如何隔離。

用磁碟不夠的作業試試看

試用免費,為期 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日

快取隨時熱機,CI/CD 更快

固定價格的專屬熱機 Runner

機器由 Skipbox 代管。你只要改一行。滿載使用時只要 GitHub 的 1/12。價格固定,可以整天跑。快取空間是 GitHub 的 7 倍。

  • 不需信用卡
  • 使用 GitHub 登入
  • 隨時可取消