# سقف حجم کش GitHub Actions: چرا کش شما حذف می‌شود، دیر بازمی‌گردد یا پیدا نمی‌شود

> کش Actions در GitHub برای هر مخزن ۱۰ GB جا دارد، وقتی از آن بگذرید ورودی‌هایی را که از همه دیرتر خوانده شده‌اند حذف می‌کند و هر ورودی‌ای را که ۷ روز استفاده نشده کنار می‌گذارد. حتی وقتی کش پیدا شود، دانلودی روی یک ماشین مجازی تازه است. هزینه هر راه حل، و اینکه چرا رانری که دیسکش را نگه می‌دارد بیشتر کش را غیرضروری می‌کند، با قیمت ثابت ماهانه $۳۹.

GitHub Actions به هر مخزن ۱۰ GB کش می‌دهد. وقتی مخزن از آن بگذرد، GitHub باز هم ورودی تازه را ذخیره می‌کند و ورودی‌هایی را که از همه دیرتر خوانده شده‌اند حذف می‌کند تا دوباره زیر سقف برود، و هر ورودی‌ای را که هیچ جابی ۷ روز نخوانده حذف می‌کند. یک شاخه فقط کش‌های خودش و شاخه پیش‌فرض را می‌خواند، پس اولین اجرای یک شاخه تازه اغلب کش پیدا نمی‌کند. و پیدا شدن کش هم باز یک دانلود است: هر جاب روی رانر میزبانی‌شده GitHub روی یک ماشین مجازی تازه شروع می‌شود، پس آرشیو را دوباره دانلود و باز می‌کند. می‌توانید سقف را بالا ببرید، با ماهانه $0.07 برای هر GB بیش از ۱۰ GB، و کلیدهایتان را تنظیم کنید، ولی دانلود می‌ماند.

Skipbox دانلود را حذف می‌کند. جاب‌های شما روی ماشین اختصاصی حسابتان اجرا می‌شوند که بین جاب‌ها می‌ماند، پس کش‌های npm‏، pnpm‏، Gradle‏، Go و Cargo و لایه‌های Docker از جاب قبلی هنوز روی دیسکش هستند (۸۰ GB روی S، در برابر 14 GB روی رانر GitHub). آنچه actions/cache ذخیره می‌کند کنار ماشین می‌ماند، پس بازگرداندن یک خواندن محلی است. یک خط را به `runs-on: skipbox` تغییر دهید، با قیمت ثابت ماهانه $۳۹ و دقیقه‌های نامحدود.

- GitHub:‏ ۱۰ GB برای هر مخزن، حذف ورودی‌هایی که ۷ روز استفاده نشده‌اند، و دانلود دوباره در هر بار پیدا شدن کش
- Skipbox: کش پکیج‌ها و لایه‌های Docker روی دیسک ماشین شما می‌مانند، با دست‌کم ۷ برابر فضای کش GitHub
- 20,000 دقیقه در ماه روی 4 vCPU یعنی $۲۲۲ روی GitHub و $۳۹ روی Skipbox

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

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

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

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

## قاعده‌های کش GitHub

از [مرجع dependency caching](https://docs.github.com/en/actions/reference/workflows-and-actions/dependency-caching)، [صورت‌حساب Actions](https://docs.github.com/en/billing/concepts/product-billing/github-actions) و changelog آن درباره [کش‌های بیش از ۱۰ GB](https://github.blog/changelog/2025-11-20-github-actions-cache-size-can-now-exceed-10-gb-per-repository/) در GitHub:

| قاعده | GitHub چه می‌کند |
|---|---|
| اندازه | به‌طور پیش‌فرض ۱۰ GB برای هر مخزن، مشترک بین همه شاخه‌ها و ورک‌فلوها |
| بیش از اندازه | ورودی تازه را ذخیره می‌کند، بعد ورودی‌ها را به ترتیب آخرین دسترسی، از قدیمی‌ترین، حذف می‌کند تا مخزن زیر سقف برود. حذف هر ساعت اجرا می‌شود |
| ورودی‌های بی‌استفاده | هر ورودی‌ای را که بیش از ۷ روز خوانده نشده حذف می‌کند |
| سقف بزرگ‌تر | روی حساب Pro‏، Team یا Enterprise‏، مدیران می‌توانند اندازه و روزها را بالا ببرند. بیش از ۱۰ GB، ماهانه $0.07 برای هر GB، بر اساس بیشینه هر ساعت. رسیدن به یک بودجه کش را تا چرخه صورت‌حساب بعدی فقط‌خواندنی می‌کند |
| شاخه‌ها | یک اجرا کش‌ها را از شاخه خودش و شاخه پیش‌فرض بازمی‌گرداند؛ اجرای یک pull request از شاخه پایه‌اش هم. هرگز از یک شاخه هم‌سطح یا فرزند |
| pull requestها | کش‌های یک pull request به merge ref آن محدودند: فقط اجراهای دوباره همان pull request آن‌ها را می‌خوانند |
| ورودی‌ها | تغییرپذیر نیستند. کلیدی که از قبل وجود دارد دوباره ذخیره نمی‌شود |
| پیدا شدن | `cache-hit` فقط برای تطابق دقیق `key` مقدار `true` دارد؛ تطابق `restore-keys` مقدار `false` است |
| نرخ | تا 200 آپلود و 1,500 دانلود در دقیقه برای هر مخزن |

## چرا کش حذف می‌شود

یک ۱۰ GB همه چیزهایی را که مخزن ذخیره می‌کند نگه می‌دارد. هر شاخه و هر pull request ورودی‌های خودش را ذخیره می‌کند. یک matrix از سه نسخه Node روی دو سیستم‌عامل شش ورودی ذخیره می‌کند. build cache از نوع `type=gha` در Docker هم در همان ۱۰ GB می‌نشیند. وقتی ذخیره‌های یک روز از سقف بیشتر شود، هر ذخیره تازه یک ورودی قدیمی‌تر را حذف می‌کند، اغلب همانی که جاب بعدی لازم دارد. GitHub این را cache thrashing می‌نامد.

برای دیدن اینکه چه چیزی آن را پر می‌کند، ورودی‌ها را بر اساس اندازه فهرست کنید:

```bash
gh cache list --sort size_in_bytes --limit 20
```

صفحه Actions › Caches مخزن همین را نشان می‌دهد، با شاخه و آخرین استفاده هر ورودی.

## چرا بازگرداندن کند است

پیدا شدن کش روی رانر میزبانی‌شده GitHub یعنی دانلود روی یک ماشین مجازی تازه، بعد باز کردن آرشیو. زمانش با آرشیو بزرگ می‌شود، پس کشی که به چند GB رسیده می‌تواند به اندازه همان نصبی طول بکشد که قرار بود از آن بگذرد. دانلودی که گیر کند با timeout قطعه‌ها در actions/cache قطع می‌شود، به‌طور پیش‌فرض 10 دقیقه (`SEGMENT_DOWNLOAD_TIMEOUT_MINS`).

بیشتر چیدمان‌ها هم کمتر از آنچه فکر می‌کنید بازمی‌گردانند. ورودی `cache:` در [setup-node](https://github.com/actions/setup-node) کش دانلود package manager را ذخیره می‌کند، نه `node_modules` را: بعد از بازگرداندن، `npm ci` باز هم همه پکیج‌ها را نصب می‌کند. کش pip در setup-python هم همین‌طور است: دانلودها برمی‌گردند، محیط دوباره نصب می‌شود.

## چرا کش پیدا نمی‌شود

- **کلید تغییر کرده.** کلیدی با `hashFiles('**/package-lock.json')` با هر تغییر فایل lock پیدا نمی‌شود. `restore-keys` یک تطابق جزئی می‌دهد، و آن وقت `cache-hit` مقدار `false` دارد.
- **یک شاخه تازه.** می‌تواند کش‌های شاخه پیش‌فرض را بخواند، نه کش‌های یک شاخه feature دیگر را. اگر شاخه پیش‌فرض هیچ‌وقت ورک‌فلو را اجرا نکرده باشد، چیزی برای خواندن نیست.
- **حذف شده.** سقف یا ۷ روز آن را برده.
- **هیچ‌وقت ذخیره نشده.** ورودی‌ها تغییرپذیر نیستند، پس کلیدی که وجود دارد دیگر هیچ‌وقت ذخیره نمی‌شود و محتوای کش‌شده به قدمت اولین ذخیره‌اش می‌ماند. pull requestی از یک fork ممکن است اصلاً اجازه ذخیره نداشته باشد.

**رد کردن فایل‌ها به جاب بعدی همان اجرا** ابزار دیگری است. کش برای اجرای بعدی است؛ خروجی بیلدی که یک جاب بعدی در همان ورک‌فلو لازم دارد از `actions/upload-artifact` و `actions/download-artifact` می‌گذرد. artifactها فضای ذخیره‌سازی خودشان را دارند، جدا از ۱۰ GB، و آن‌ها هم دانلودی روی یک ماشین مجازی تازه هستند.

## هر راه حل روی رانرهای GitHub چه هزینه‌ای دارد

- **سقف را بالا ببرید.** حذف کمتر، با ماهانه $0.07 برای هر GB بیش از ۱۰ GB (مثال خود GitHub: 200 GB که کامل استفاده شود ماهانه $13.30 است)، روی حساب Pro‏، Team یا Enterprise. بازگرداندن‌ها همچنان دانلود می‌مانند، و کش‌های بزرگ‌تر دیرتر دانلود می‌شوند.
- **کمتر ذخیره کنید.** `~/.npm` یا store در pnpm را کش کنید، نه `node_modules` یا خروجی بیلد را. فقط روی شاخه پیش‌فرض ذخیره کنید، با `actions/cache/restore` در همه جاب‌ها و `actions/cache/save` در یکی. هزینه‌اش وقت شماست، و کش کوچک‌تر کمتر برمی‌گرداند.
- **کلیدها را درست کنید.** کلید را روی فایل lock بگذارید، `restore-keys` اضافه کنید و ورک‌فلو را روی pushهای شاخه پیش‌فرض اجرا کنید تا شاخه‌های تازه چیزی برای خواندن داشته باشند.
- **یک رانر خودمیزبان که دیسکش را نگه می‌دارد.** نه دانلودی، نه ۱۰ GB. ماشین را خودتان اداره می‌کنید: به‌روزرسانی سیستم‌عامل، پاک‌سازی بین جاب‌ها بدون حذف کش‌ها، و تعمیرش وقتی خراب می‌شود.

## وقتی راه حل ماشینی است که دیسکش را نگه می‌دارد

کش به این دلیل وجود دارد که ماشین فراموش می‌کند. رانر میزبانی‌شده GitHub برای هر جاب یک ماشین مجازی تازه است، پس جاب وضعیتش را در فضای ذخیره‌سازی GitHub ذخیره می‌کند و دفعه بعد آن را برمی‌گرداند. روی ماشینی که می‌ماند، این وضعیت از قبل روی دیسکش است: کش package manager، کش ابزارها، ایمیج‌ها و build cache‏ Docker، حتی خروجی بیلد.

این تفاوت در CI پروژه‌های واقعی دیده می‌شود، از [اجراهای ما روی جاب‌های خودشان](https://skipbox.dev/fa/guides/rust-cache-slow-rust-ci):

- **astro (Node.js، Turborepo):** روی GitHub‏ 528 ثانیه، روی ماشین اختصاصی Skipbox‏ 30 ثانیه، که کش turbo را نگه می‌دارد، پس اجراهای گرمش 40 task بیلد را به‌جای اجرا بازپخش می‌کنند.
- **helix (Rust):** گام toolchain و کش روی ماشین اختصاصی 9 تا 10 ثانیه طول کشید، در برابر 41 تا 46 ثانیه روی GitHub.
- **tauri (Rust):** روی GitHub‏ 246 ثانیه، روی ماشین اختصاصی 53 ثانیه، با `target/` که بین جاب‌ها نگه داشته می‌شود.

## Skipbox کش را روی ماشین شما نگه می‌دارد

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

- **کش پکیج‌ها روی دیسک می‌مانند:** `~/.npm`، store در pnpm، `~/.cache` هر ابزار و کش‌های Go‏، Gradle‏، Cargo و Maven، همراه ابزارهایی که `setup-*` نصب کرده. چیزی برای بازگرداندن نیست.
- **ایمیج‌ها، لایه‌ها و build cache‏ Docker هم می‌مانند.** `docker build` از لایه‌های بیلد قبلی استفاده می‌کند ([کش لایه‌های Docker](https://skipbox.dev/fa/guides/docker-layer-cache-github-actions)).
- **actions/cache‏، setup-* و rust-cache تغییری لازم ندارند.** آنچه ذخیره می‌کنند به‌جای فضای ذخیره‌سازی GitHub کنار ماشین می‌ماند، با جای بیشتر از ۱۰ GB هر مخزن در GitHub، و بازگرداندن آن را محلی می‌خواند.
- **انقضای ۷ روزه روی دیسک نیست.** تا وقتی دیسک بعد از یک جاب تقریباً پر نشود هیچ چیز حذف نمی‌شود؛ آن وقت آنچه از همه قدیمی‌تر استفاده شده اول می‌رود.

روی S دست‌کم ۷ برابر فضای کش GitHub. هر جاب اندازه‌اش را با لیبل انتخاب می‌کند:

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

`ubuntu-latest` یک مخزن خصوصی 2 CPU‏، 8 GB و 14 GB حافظه SSD دارد. دقیقه‌ها روی Skipbox نامحدودند. با 20,000 دقیقه در ماه روی 4 vCPU‏، GitHub‏ $۲۲۲ می‌گیرد؛ Skipbox S‏ $۳۹ است، یعنی $۱۸۳ کمتر.

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

```yaml
jobs:
  test:
    runs-on: skipbox # was ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with:
          node-version: 22
          cache: npm
      - run: npm ci && npm test
```

1. با GitHub وارد Skipbox شوید.
2. اپ Skipbox در GitHub را نصب کنید و مخزن‌ها را انتخاب کنید.
3. `runs-on` را تغییر دهید و push کنید.

گام‌های کش را همان‌طور که هستند نگه دارید. اجرای دوم کش‌های اجرای اول را روی ماشین پیدا می‌کند.

## امنیت

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

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

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

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

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

### سقف حجم کش GitHub Actions چقدر است؟

به‌طور پیش‌فرض ۱۰ GB برای هر مخزن، برای همه شاخه‌ها و ورک‌فلوها روی هم. بعد از آن، GitHub باز هم ورودی تازه را ذخیره می‌کند و ورودی‌ها را به ترتیب آخرین دسترسی، از قدیمی‌ترین، حذف می‌کند تا مخزن دوباره زیر سقف برود. ورودی‌هایی که هیچ جابی ۷ روز نخوانده، هر اندازه‌ای داشته باشند حذف می‌شوند. روی حساب Pro‏، Team یا Enterprise‏، مدیران می‌توانند سقف و روزها را بالا ببرند؛ فضای بیش از ۱۰ GB ماهانه $0.07 برای هر GB حساب می‌شود، بر اساس بیشینه هر ساعت، و وقتی به یک بودجه برسد کش تا چرخه صورت‌حساب بعدی فقط‌خواندنی می‌شود.

### چرا کش GitHub Actions من این‌قدر زیاد حذف می‌شود؟

چون همه چیز در مخزن یک ۱۰ GB را شریک است: هر شاخه، هر pull request، هر جاب matrix و هر سیستم‌عامل ورودی‌های خودش را ذخیره می‌کند، و کش type=gha در Docker هم همان‌جا می‌نشیند. وقتی ذخیره‌های یک روز از سقف بیشتر شود، هر ذخیره یک ورودی قدیمی‌تر را حذف می‌کند و جاب بعدی همانی را که لازم داشت پیدا نمی‌کند. GitHub این را cache thrashing می‌نامد. ورودی‌ها را بر اساس اندازه فهرست کنید (gh cache list --sort size_in_bytes) تا ببینید چه چیزی آن را پر می‌کند.

### چرا بازگرداندن کش به اندازه نصب از صفر طول می‌کشد؟

چون پیدا شدن کش هم باز یک دانلود است. هر جاب روی رانر میزبانی‌شده GitHub روی یک ماشین مجازی تازه شروع می‌شود، پس actions/cache هر بار آرشیو را دانلود و باز می‌کند، و هر چه کش بزرگ‌تر باشد بیشتر طول می‌کشد. کش setup-node کش دانلود package manager را برمی‌گرداند، نه node_modules را، پس npm ci بعد از بازگرداندن باز هم همه پکیج‌ها را نصب می‌کند. روی رانری که دیسکش را نگه می‌دارد کش‌ها از قبل آنجا هستند و چیزی دانلود نمی‌شود.

### چرا actions/cache روی یک شاخه تازه پیدا نمی‌شود؟

یک اجرا می‌تواند کش‌ها را از شاخه خودش و از شاخه پیش‌فرض بازگرداند، و اجرای یک pull request از شاخه پایه‌اش هم. نمی‌تواند کش‌های یک شاخه هم‌سطح را بخواند. پس اولین اجرای یک شاخه feature فقط وقتی کش پیدا می‌کند که شاخه پیش‌فرض آن کلید را ذخیره کرده باشد. ورک‌فلو را روی pushهای شاخه پیش‌فرض اجرا کنید تا ذخیره کند، و برای تطابق جزئی restore-keys اضافه کنید؛ cache-hit فقط برای تطابق دقیق key مقدار true دارد.

### Skipbox چقدر کش Actions نگه می‌دارد؟

بیشتر از ۱۰ GB هر مخزن در GitHub، کنار ماشین شما به‌جای فضای ذخیره‌سازی GitHub. روی ماشین ابری، آنچه جاب‌ها با actions/cache‏، setup-* و rust-cache ذخیره می‌کنند روی دیسک خود ماشین می‌ماند، تا نصف آن دیسک (۸۰ GB روی S‏، ۱۶۰ GB روی M‏، ۳۲۰ GB روی L)؛ روی یک میزبان Skipbox، کش میزبان برای هر مخزن 20 GB نگه می‌دارد. در هر دو حالت یک ورودی تا ۷ روز پس از آخرین استفاده نگه داشته می‌شود، با قاعده‌های شاخه GitHub. کش پکیج‌ها و لایه‌های Docker از این مسیر نمی‌گذرند: روی خود دیسک می‌مانند.

### چه چیزی کش‌های یک ماشین Skipbox را پاک می‌کند؟

بین جاب‌ها هیچ چیز: کش‌ها روی ماشین می‌مانند، و فقط وقتی یک جاب دیسک را تقریباً پر بگذارد، آنچه از همه قدیمی‌تر استفاده شده اول می‌رود. ماشین در یک بازنشانی تمیز شروع می‌شود: وقتی «بازنشانی ماشین» را بزنید، وقتی ایمیجش به‌روز شود (دست‌کم ماهی یک بار)، وقتی بعد از یک جاب از health check رد نشود، و وقتی یک جاب به سقف ۶ ساعت برسد. وقتی طرح تمام شود، ماشین همراه دیسکش حذف می‌شود.

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

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

به‌روزرسانی: 2026-11-16 · https://skipbox.dev/fa/guides/github-actions-cache-size-limit
