# خطای "No space left on device" در GitHub Actions: ببینید چه چیزی دیسک را پر می‌کند، آزادش کنید یا دیسک بزرگ‌تری بگیرید

> GitHub روی رانر استاندارد Linux فقط 14 GB فضای خالی را تضمین می‌کند، و ایمیج‌های Docker، بازگرداندن کش و درخت‌های بیلد آن را پر می‌کنند. چطور ببینید چه چیزی دیسک را پر می‌کند، چه چیزی را از ایمیج رانر حذف کنید، و دیسک بزرگ‌تر از کجا می‌آید: larger runnerهای GitHub در Team و Enterprise، یا ماشین اختصاصی Skipbox با ۸۰ GB روی S‏، ۱۶۰ GB روی M و ۳۲۰ GB روی L با قیمت ثابت.

"No space left on device" در GitHub Actions یعنی جاب بیشتر از فضای خالی رانر نوشته است، و روی رانر استاندارد Linux در GitHub این حدود 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`)، کمتر بنویسید، ابزارهای از پیش نصب‌شده‌ای را که جاب استفاده نمی‌کند حذف کنید، و اگر باز هم جا نشد، جاب را روی دیسک بزرگ‌تری اجرا کنید. larger runnerهای GitHub از 75 GB به بالا دارند، فقط در GitHub Team و Enterprise Cloud.

Skipbox جاب‌های شما را روی ماشین اختصاصی حسابتان اجرا می‌کند، با ۸۰ GB دیسک روی S‏، ۱۶۰ GB روی M و ۳۲۰ GB روی L، با قیمت ثابت و دقیقه‌های نامحدود. کش‌هایی که بین جاب‌ها نگه می‌دارد روی همین دیسک هستند، و وقتی دیسک پر شود قدیمی‌ترینشان را کم می‌کند، پس در شروع جاب چیزی برای حذف نیست.

- ۸۰ GB دیسک روی S‏، ۱۶۰ GB روی M و ۳۲۰ GB روی L، در برابر حدود 14 GB خالی روی رانر استاندارد GitHub
- ایمیج‌ها و لایه‌های Docker و کش پکیج‌ها بین جاب‌ها روی همین دیسک می‌مانند
- اگر بعد از یک جاب از 85٪ بگذرد، دیسک به 75٪ برگردانده می‌شود، از آنچه دیرتر از همه استفاده شده

**GitHub Actions با قیمت ثابت و دقیقه‌های نامحدود** Skipbox جاب‌های GitHub Actions شما را روی ماشین اختصاصی خودتان اجرا می‌کند: ماهانه $۳۹، هر چند دقیقه که اجرا کنید. لایه‌های Docker و کش وابستگی‌ها بین جاب‌ها می‌مانند، پس جاب بعدی فوراً شروع می‌شود.

رانری با چهار vCPU، ماهانه بیست هزار دقیقه: GitHub $۲۲۲ → Skipbox $۳۹. هر ماه $۱۸۳ صرفه‌جویی می‌کنید.

انتقال فقط یک خط است: `runs-on: skipbox`.

[شروع دوره آزمایشی رایگان ۷ روزه](https://app.skipbox.dev/sign-in?ref=g-github-actions-no-space-left-on-device-fa)

## رانر GitHub چقدر دیسک دارد

[رانرهای میزبانی‌شده GitHub](https://docs.github.com/en/actions/reference/runners/github-hosted-runners) برای رانر استاندارد Linux‏ 14 GB حافظه SSD فهرست می‌کند، در مخزن‌های خصوصی و عمومی. در [بحث شماره 9329 در runner-images](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")، خروجی `du` یک کاربر روی `ubuntu-latest` این را نشان داد:

| پوشه | اندازه |
|---|---|
| `/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` هر filesystem و میزان پر بودنش را نشان می‌دهد. ببینید جاب شما روی کدام می‌نویسد: workspace، داده‌های Docker در `/var/lib/docker` یا پوشه موقت.
- `df -i` تعداد inodeها را نشان می‌دهد. دیسک می‌تواند با وجود بایت‌های خالی، inode کم بیاورد (یکی برای هر فایل)، و خطا همان است.
- `du` بزرگ‌ترین پوشه‌ها را نشان می‌دهد.
- [`docker system df`](https://docs.docker.com/reference/cli/docker/system/df/) نشان می‌دهد ایمیج‌ها، کانتینرها، volumeها و build cache‏ Docker چقدر جا گرفته‌اند.

## 2. کمتر بنویسید

- **Docker را بین بیلدها prune کنید.** [`docker system prune`](https://docs.docker.com/reference/cli/docker/system/prune/) کانتینرهای متوقف، شبکه‌های بی‌استفاده، ایمیج‌های بی‌برچسب و build cache بی‌استفاده را حذف می‌کند؛ `-a` همه ایمیج‌های بی‌استفاده را حذف می‌کند، و `--volumes` volumeهای بی‌نام را هم.
- **چیزی را کش کنید که می‌ارزد.** کش بازگردانده‌شده روی دیسک رانر باز می‌شود، پس یک آرشیو کش بزرگ بیشتر از دانلودش جا می‌گیرد. آن را برای هر جاب جدا کنید، یا آنچه را که زود دوباره گرفته می‌شود کنار بگذارید.
- **درخت‌های بیلدی را پاک کنید** که گام بعدی لازمشان ندارد، پیش از گامی که به آن جا نیاز دارد.

## 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 /
```

دو هزینه دارد. حذف چند گیگابایت در هر اجرا زمان می‌برد، چون ماشین مجازی جاب بعدی دوباره آن‌ها را دارد. و حذف `$AGENT_TOOLSDIRECTORY` (کل کش ابزارهای میزبانی‌شده) فضای بیشتری آزاد می‌کند ولی، همان‌طور که نویسنده ‎#2875 دید، ابزارهایی را که گام‌ها انتظار دارند آنجا باشند خراب می‌کند. اکشن [free-disk-space](https://github.com/marketplace/actions/free-disk-space-ubuntu) این حذف‌ها را در خودش دارد؛ نویسنده‌اش بعد از آن بحث گزینه کش ابزارها را اضافه کرد و گفت 6 GB دیگر صرفه‌جویی می‌کند.

## 4. جاب را روی دیسک بزرگ‌تری اجرا کنید

| رانر | دیسک | چه کسانی می‌توانند استفاده کنند |
|---|---|---|
| رانر استاندارد Linux در GitHub | 14 GB حافظه SSD، حدود 14 GB خالی | همه |
| larger runner در GitHub، 2 تا 96 vCPU | 75 GB با 2 vCPU‏، 150 GB با 4، 300 GB با 8، تا 2,040 GB‏ ([larger runnerها](https://docs.github.com/en/actions/reference/runners/larger-runners)) | سازمان‌های GitHub Team و Enterprise Cloud، دقیقه‌ای ([درباره larger runnerها](https://docs.github.com/en/actions/concepts/runners/larger-runners)) |
| رانر خودمیزبان | هر چه به آن بدهید؛ رانری که بین جاب‌ها می‌ماند با ایمیج‌ها و workspaceهای قدیمی پر می‌شود، مگر چیزی تمیزش کند | همه، و اداره‌اش با شماست |
| ماشین اختصاصی Skipbox | ۸۰ GB روی S‏، ۱۶۰ GB روی M‏، ۳۲۰ GB روی L، که وقتی پر شود کم می‌شود | سازمان‌ها و حساب‌های شخصی، قیمت ثابت |

## Skipbox با دیسک چه می‌کند

هر طرح با ماشین اختصاصی حساب شما می‌آید که بین جاب‌ها می‌ماند، با دیسکی به اندازه همان طرح:

- **دیسک روی S‏ ۸۰ GB، روی M‏ ۱۶۰ GB و روی L‏ ۳۲۰ GB است.**
- **آنچه رویش می‌ماند وضعیت شماست:** ایمیج‌ها، لایه‌ها و build cache‏ Docker‏، `~/.npm`، store در pnpm، `~/.cache`، کش‌های Go‏، Gradle‏، Maven و Cargo، و ابزارهایی که `setup-*` نصب کرده. آنچه `actions/cache` ذخیره می‌کند کنار ماشین می‌ماند، تا نصف دیسک.
- **پر نمی‌شود.** تا وقتی دیسک بعد از یک جاب بیش از 85٪ پر نشود هیچ چیز حذف نمی‌شود. آن وقت به 75٪ برگردانده می‌شود، از آنچه دیرتر از همه استفاده شده: ایمیج‌های بی‌برچسب، بعد build cache‏ Docker، بعد کل کش پکیج‌ها و بیلدهای نگه‌داشته‌شده. فقط اگر باز هم بیش از 85٪ باشد ماشین بازنشانی می‌شود.
- **دیسک بیشتر یک طرح بالاتر است.** جابی که خودش ده‌ها گیگابایت می‌نویسد، مثل ایمیج‌های بزرگ یا یک درخت بیلد بزرگ، روی M‏ ۱۶۰ GB و روی L‏ ۳۲۰ GB می‌گیرد.

| لیبل | ماشین | دیسک | طرح |
|---|---|---|---|
| `skipbox` | ۴ vCPU · ۱۶ GB | ۸۰ GB | S، ماهانه $۳۹ |
| `skipbox-8x16` | ۸ vCPU · ۱۶ GB | ۱۶۰ GB | M، ماهانه $۷۹ |
| `skipbox-16x32` | ۱۶ vCPU · ۳۲ GB | ۳۲۰ GB | L، ماهانه $۱۴۹ |

دقیقه‌ها نامحدودند. با 20,000 دقیقه در ماه روی 4 vCPU‏، GitHub‏ $۲۲۲ می‌گیرد؛ Skipbox S‏ $۳۹ است.

## انتقال یک خط است

```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` را تغییر دهید و push کنید.

## امنیت

- ماشین فقط مال حساب شماست. جاب هیچ شرکت دیگری روی آن اجرا نمی‌شود.
- بعد از هر جاب، اعتبارنامه‌های رانر، پروسه‌ها و کانتینرها پاک می‌شوند، و همین‌طور فایل‌های اعتبارنامه در پوشه خانه. گزینه «ماشین تازه برای هر جاب» به‌جای آن به هر جاب یک ماشین تازه می‌دهد.
- کد افرادی که دسترسی نوشتن ندارند (مثل pull requestها از forkها) روی یک ماشین مجازی تازه اجرا می‌شود که کش‌های شما را می‌خواند ولی نمی‌تواند تغییرشان دهد.

جزئیات در [جداسازی جاب‌ها](https://docs.skipbox.dev/fa/isolation) است.

## روی جابی که دیسکش تمام می‌شود امتحانش کنید

دوره آزمایشی به مدت ۷ روز یا ۳٬۰۰۰ دقیقه جاب رایگان است، هر کدام زودتر برسد، و کارت نمی‌خواهد. `runs-on: skipbox` را روی ماشین S با ۸۰ GB اجرا می‌کند. جاب را آنجا ببرید، گامی را که ابزارهای از پیش نصب‌شده را حذف می‌کند بردارید و اجرایش کنید.

## پرسش‌های متداول

### رانر GitHub Actions چقدر فضای دیسک دارد؟

مستندات GitHub برای رانر استاندارد Linux‏ 14 GB حافظه SSD فهرست می‌کند، در مخزن‌های خصوصی و عمومی به یک اندازه، و یکی از نگهدارندگان runner-images نوشته است که GitHub برای هر دو فقط 14 GB فضای خالی را تضمین می‌کند. خود دیسک بزرگ‌تر است، ولی ابزارهای از پیش نصب‌شده ایمیج رانر بقیه را پر می‌کنند، پس روی 14 GB حساب کنید.

### چطور خطای No space left on device را در GitHub Actions برطرف کنم؟

اول ببینید چه چیزی آن را پر کرده: df -h برای هر filesystem، df -i برای inodeها، sudo du -xh --max-depth=1 / برای بزرگ‌ترین پوشه‌ها، و docker system df برای ایمیج‌ها و build cache‏ Docker. بعد کمتر بنویسید (Docker را بین بیلدها prune کنید، فقط چیزی را کش کنید که می‌ارزد)، ابزارهای از پیش نصب‌شده‌ای را که جاب استفاده نمی‌کند حذف کنید (Android SDK‏، GHC‏، CodeQL‏، .NET)، و اگر جاب باز هم بیشتر لازم دارد، روی رانری با دیسک بزرگ‌تر اجرایش کنید.

### چه چیزی را می‌توانم از ubuntu-latest حذف کنم تا فضای دیسک آزاد شود؟

ابزارهایی که جاب استفاده نمی‌کند. کاربران در issueهای runner-images در GitHub این‌ها را حذف می‌کنند: /usr/local/lib/android (در فهرست یک کاربر 12 GB)، /usr/local/.ghcup، /opt/hostedtoolcache/CodeQL، /usr/share/dotnet و /usr/local/share/boost. حذف $AGENT_TOOLSDIRECTORY کش ابزارهای میزبانی‌شده را هم آزاد می‌کند، ولی گام‌های setupی را که انتظار دارند ابزارهایشان آنجا باشد خراب می‌کند. حذف چند گیگابایت در هر اجرا زمان می‌برد.

### larger runnerهای GitHub دیسک بیشتری دارند؟

بله: 75 GB با 2 vCPU‏، 150 GB با 4، 300 GB با 8، تا 2,040 GB با 64 و 96 vCPU. فقط برای سازمان‌های روی GitHub Team یا GitHub Enterprise Cloud هستند و دقیقه‌ای حساب می‌شوند.

### Skipbox چقدر دیسک به یک جاب می‌دهد؟

ماشین اختصاصی حساب شما روی S‏ ۸۰ GB، روی M‏ ۱۶۰ GB و روی L‏ ۳۲۰ GB دارد. کش‌هایی که بین جاب‌ها نگه داشته می‌شوند همین دیسک را شریک‌اند: بعد از جابی که آن را بیش از 85٪ پر بگذارد، به 75٪ برگردانده می‌شود، از آنچه دیرتر از همه استفاده شده، پس آن‌طور که دیسک یک رانر خودمیزبان پر می‌شود پر نمی‌شود. برای جابی که خودش ده‌ها گیگابایت می‌نویسد، M و L جای کافی به آن می‌دهند.

### امتحان کردنش چقدر هزینه دارد؟

هیچ. دوره آزمایشی ۷ روز یا ۳٬۰۰۰ دقیقه جاب است، هر کدام زودتر برسد، بدون کارت، روی ماشین S. جابی را که دیسکش تمام می‌شود به runs-on: skipbox ببرید و گام‌هایی را که ابزارهای از پیش نصب‌شده را حذف می‌کنند بردارید.

به‌روزرسانی: 2026-11-16 · https://skipbox.dev/fa/guides/github-actions-no-space-left-on-device
