# حد حجم ذاكرة التخزين المؤقت في GitHub Actions: لماذا تُطرد ذاكرتك المؤقتة، أو تبطؤ استعادتها، أو تُخطئها المهمة

> تتسع ذاكرة Actions المؤقتة في GitHub لـ 10 GB لكل مستودع، وتحذف الإدخالات التي قُرئت منذ أطول مدة حين تتجاوز ذلك، وتُسقط أي إدخال لم يُستخدم 7 أيام. وحتى الإصابة تنزيل إلى جهاز افتراضي جديد. ما يكلّفه كل حل، ولماذا يجعل المشغّل الذي يحتفظ بقرصه معظم ذاكرة التخزين المؤقت غير ضروري، بسعر ثابت قدره $39 شهريًا.

يمنح GitHub Actions كل مستودع 10 GB من ذاكرة التخزين المؤقت. وحين يتجاوزها المستودع، يظل GitHub يحفظ الإدخال الجديد ويحذف الإدخالات التي قُرئت منذ أطول مدة حتى يعود تحت الحد، ويحذف أي إدخال لم تقرأه أي مهمة 7 أيام. والفرع لا يقرأ إلا ذاكرته وذاكرة الفرع الافتراضي، فكثيرًا ما يُخطئ التشغيل الأول لفرع جديد. والإصابة ما زالت تنزيلًا: كل مهمة على مشغّل مستضاف على GitHub تبدأ على جهاز افتراضي جديد، فتُنزّل الأرشيف وتفكّه من جديد. يمكنك رفع الحد، بسعر $0.07 لكل GB شهريًا فوق 10 GB، وضبط مفاتيحك، لكن التنزيل يبقى.

يزيل Skipbox التنزيل. تعمل مهامك على جهاز يستضيفه Skipbox لحسابك وحده، محفوظ بين المهام، فتبقى ذاكرة npm وpnpm وGradle وGo وCargo المؤقتة وطبقات Docker على قرصه من المهمة السابقة (80 GB على S، مقابل 14 GB على مشغّل GitHub). وما يحفظه actions/cache يبقى بجوار الجهاز، فالاستعادة قراءة محلية. غيّر سطرًا واحدًا، `runs-on: skipbox`، بسعر ثابت قدره $39 شهريًا مع دقائق غير محدودة.

- GitHub: ‏10 GB لكل مستودع، والإدخالات غير المستخدمة 7 أيام تُحذف، وكل إصابة تُنزَّل من جديد
- Skipbox: ذاكرة الحزم المؤقتة وطبقات Docker تبقى على قرص جهازك، مع 7× على الأقل من مساحة GitHub للتخزين المؤقت
- 20,000 دقيقة شهريًا على 4 vCPU: $222 على GitHub، و$39 على Skipbox

**GitHub Actions بسعر ثابت ودقائق غير محدودة** يشغّل Skipbox مهام GitHub Actions على جهاز مخصص لك وحدك: $39 شهريًا، مهما كان عدد الدقائق التي تشغّلها. تبقى طبقات Docker وذاكرة التخزين المؤقت للتبعيات بين المهام، فتبدأ المهمة التالية فورًا.

مشغّل بـ 4 vCPU، و20,000 دقيقة شهريًا: GitHub $222 → Skipbox $39. توفّر $183 كل شهر.

الانتقال يتطلب سطرًا واحدًا: `runs-on: skipbox`.

[بدء تجربتي المجانية لمدة 7 أيام](https://app.skipbox.dev/sign-in?ref=g-github-actions-cache-size-limit-ar)

## قواعد ذاكرة التخزين المؤقت في GitHub

من [مرجع التخزين المؤقت للتبعيات](https://docs.github.com/en/actions/reference/workflows-and-actions/dependency-caching) في GitHub، و[فوترة Actions](https://docs.github.com/en/billing/concepts/product-billing/github-actions)، وسجل تغييراته عن [ذاكرة التخزين المؤقت فوق 10 GB](https://github.blog/changelog/2025-11-20-github-actions-cache-size-can-now-exceed-10-gb-per-repository/) ‏(كلها بالإنجليزية):

| القاعدة | ما يفعله GitHub |
|---|---|
| الحجم | 10 GB لكل مستودع افتراضيًا، يتشاركها كل فرع وكل سير عمل |
| بعد تجاوز الحجم | يحفظ الإدخال الجديد، ثم يحذف الإدخالات بحسب آخر وصول، الأقدم أولًا، حتى يعود المستودع تحت الحد. ويعمل الطرد كل ساعة |
| الإدخالات غير المستخدمة | يحذف أي إدخال لم يُقرأ لأكثر من 7 أيام |
| حد أكبر | على حساب Pro أو Team أو Enterprise، يستطيع المسؤولون رفع الحجم والأيام. فوق 10 GB، ‏$0.07 لكل GB شهريًا، بحسب ذروة كل ساعة. وبلوغ الميزانية يجعل ذاكرة التخزين المؤقت للقراءة فقط حتى دورة الفوترة التالية |
| الفروع | يستعيد التشغيل ذاكرة فرعه والفرع الافتراضي؛ وتشغيل طلب السحب من فرعه الأساسي أيضًا. ولا يقرأ أبدًا فرعًا شقيقًا أو فرعيًا |
| طلبات السحب | ذاكرة طلب السحب المؤقتة مقيّدة بـ merge ref الخاص به: لا يقرؤها إلا إعادة تشغيل ذلك الطلب |
| الإدخالات | لا يمكن تغييرها. والمفتاح الموجود مسبقًا لا يُحفظ من جديد |
| الإصابات | `cache-hit` يكون `true` فقط عند المطابقة التامة للـ `key`؛ ومطابقة `restore-keys` تكون `false` |
| المعدل | حتى 200 رفع و1,500 تنزيل في الدقيقة لكل مستودع |

## لماذا تُطرد ذاكرة التخزين المؤقت

‏10 GB واحدة تتسع لكل ما يحفظه المستودع. كل فرع وكل طلب سحب يحفظ إدخالاته الخاصة. ومصفوفة من ثلاثة إصدارات Node على نظامي تشغيل تحفظ ستة. وذاكرة بناء Docker المؤقتة `type=gha` تنتهي في الـ 10 GB نفسها. وحين تتجاوز عمليات الحفظ في يوم الحد، يحذف كل حفظ جديد إدخالًا أقدم، وكثيرًا ما يكون الإدخال الذي تحتاجه المهمة التالية. ويسمّي GitHub ذلك cache thrashing.

لترى ما يملؤها، اعرض الإدخالات بحسب الحجم:

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

وصفحة Actions › Caches في المستودع تُظهر الشيء نفسه، مع فرع كل إدخال وآخر استخدام له.

## لماذا تبطؤ الاستعادة

إصابة ذاكرة التخزين المؤقت على مشغّل مستضاف على GitHub تنزيل إلى جهاز افتراضي جديد، ثم فكّ. ويطول وقتها مع حجم الأرشيف، فذاكرة تخزين مؤقت كبرت إلى عدة GB قد تستغرق ما يستغرقه التثبيت الذي كان يُفترض أن تتخطاه. والتنزيل المتعثر يقطعه حد مهلة المقطع في actions/cache، وهو 10 دقائق افتراضيًا (`SEGMENT_DOWNLOAD_TIMEOUT_MINS`).

ومعظم الإعدادات تستعيد أقل مما يظن الناس أيضًا. مدخل `cache:` في [setup-node](https://github.com/actions/setup-node) يحفظ ذاكرة التنزيل لمدير الحزم، لا `node_modules`: بعد الاستعادة، يظل `npm ci` يثبّت كل حزمة. وذاكرة pip المؤقتة في setup-python مثلها: تعود التنزيلات، وتُثبَّت البيئة من جديد.

## لماذا تُخطئ ذاكرة التخزين المؤقت

- **تغيّر المفتاح.** المفتاح الذي فيه `hashFiles('**/package-lock.json')` يُخطئ مع كل تغيير في ملف القفل. و`restore-keys` يمنح مطابقة جزئية، فيقرأ `cache-hit` حينها `false`.
- **فرع جديد.** يستطيع قراءة ذاكرة الفرع الافتراضي، لا ذاكرة فرع ميزة آخر. وإن لم يشغّل الفرع الافتراضي سير العمل قط، فلا شيء يُقرأ.
- **طُرد.** أخذه الحد أو الأيام الـ 7.
- **لم يُحفظ قط.** الإدخالات لا يمكن تغييرها، فالمفتاح الموجود لا يُحفظ من جديد أبدًا، ويبقى المحتوى المخزّن بقِدم أول حفظ له. وطلب السحب من نسخة متفرعة قد لا يُسمح له بالحفظ أصلًا.

**تمرير الملفات إلى المهمة التالية في التشغيل نفسه** أداة مختلفة. ذاكرة التخزين المؤقت للتشغيل التالي؛ أما مخرجات البناء التي تحتاجها مهمة لاحقة في سير العمل نفسه فتمر عبر `actions/upload-artifact` و`actions/download-artifact`. وللـ artifacts تخزينها الخاص، بمعزل عن 10 GB، وهي تنزيل إلى جهاز افتراضي جديد أيضًا.

## ما يكلّفه كل حل على مشغّلات GitHub

- **ارفع الحد.** طرد أقل، بسعر $0.07 لكل GB شهريًا فوق 10 GB (مثال GitHub نفسه: 200 GB مستخدمة بالكامل تكلّف $13.30 شهريًا)، على حساب Pro أو Team أو Enterprise. وتبقى الاستعادات تنزيلات، والذاكرة الأكبر يطول تنزيلها.
- **احفظ أقل.** خزّن `~/.npm` أو مخزن pnpm، لا `node_modules` أو مخرجات البناء. واحفظ على الفرع الافتراضي فقط، مع `actions/cache/restore` في كل مهمة و`actions/cache/save` في واحدة. يكلّف ذلك وقتك، والذاكرة الأصغر تستعيد أقل.
- **أصلح المفاتيح.** اجعل المفتاح على ملف القفل، وأضف `restore-keys`، وشغّل سير العمل عند الدفع إلى الفرع الافتراضي حتى تجد الفروع الجديدة ما تقرؤه.
- **مشغّل مستضاف ذاتيًا يحتفظ بقرصه.** لا تنزيل، ولا حد 10 GB. وأنت تشغّل الجهاز: تحديثات نظام التشغيل، والتنظيف بين المهام دون حذف ذاكرة التخزين المؤقت، وإصلاحه حين يتعطل.

## حين يكون الحل جهازًا يحتفظ بقرصه

ذاكرة التخزين المؤقت موجودة لأن الجهاز ينسى. المشغّل المستضاف على GitHub جهاز افتراضي جديد لكل مهمة، فتحفظ المهمة حالتها في تخزين GitHub وتجلبها في المرة التالية. وعلى جهاز يبقى، تكون تلك الحالة على قرصه أصلًا: ذاكرة مدير الحزم المؤقتة، وذاكرة الأدوات، وصور Docker وذاكرة بنائه المؤقتة، بل ومخرجات البناء.

ويظهر الفرق في CI لمشاريع حقيقية، من [تشغيلنا لمهامها نفسها](https://skipbox.dev/ar/guides/rust-cache-slow-rust-ci):

- **astro ‏(Node.js، Turborepo):** ‏528 ثانية على GitHub، و30 ثانية على جهاز Skipbox مخصّص، يحتفظ بذاكرة turbo المؤقتة، فتعيد تشغيلاته الدافئة تشغيل 40 مهمة بناء من الذاكرة بدلًا من تنفيذها.
- **helix ‏(Rust):** خطوة سلسلة الأدوات وذاكرة التخزين المؤقت استغرقت 9-10 ثوانٍ على الجهاز المخصّص، مقابل 41-46 ثانية على GitHub.
- **tauri ‏(Rust):** ‏246 ثانية على GitHub، و53 ثانية على الجهاز المخصّص، مع الاحتفاظ بـ `target/` بين المهام.

## يحتفظ Skipbox بذاكرة التخزين المؤقت على جهازك

تأتي كل خطة مع جهاز خاص بحسابك، محفوظ بين المهام:

- **ذاكرة الحزم المؤقتة تبقى على القرص:** `~/.npm`، ومخزن pnpm، و`~/.cache` لكل أداة، وذاكرة Go وGradle وCargo وMaven المؤقتة، مع الأدوات التي ثبّتتها `setup-*`. لا شيء يُستعاد.
- **صور Docker وطبقاته وذاكرة بنائه المؤقتة تبقى أيضًا.** يعيد `docker build` استخدام طبقات البناء السابق ([ذاكرة طبقات Docker المؤقتة](https://skipbox.dev/ar/guides/docker-layer-cache-github-actions)).
- **لا يحتاج actions/cache وsetup-* وrust-cache إلى أي تغيير.** ما تحفظه يبقى بجوار الجهاز بدلًا من تخزين GitHub، بمساحة أكبر من 10 GB التي يمنحها GitHub لكل مستودع، والاستعادة تقرؤه محليًا.
- **لا انتهاء صلاحية بعد 7 أيام على القرص.** لا يُحذف شيء حتى يكاد القرص يمتلئ بعد مهمة؛ حينها يذهب أولًا ما استُخدم منذ أطول مدة.

7× على الأقل من مساحة GitHub للتخزين المؤقت على S. وتختار المهمة حجمها بالتسمية:

| التسمية | الجهاز | القرص | الخطة |
|---|---|---|---|
| `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 شهريًا |

في `ubuntu-latest` على مستودع خاص 2 CPU و8 GB و14 GB من SSD. والدقائق غير محدودة على Skipbox. عند 20,000 دقيقة شهريًا على 4 vCPU، يحتسب GitHub $222؛ وSkipbox S بـ $39، أي أقل بـ $183.

## الانتقال سطر واحد

```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. سجّل الدخول إلى Skipbox باستخدام GitHub.
2. ثبّت تطبيق Skipbox على GitHub واختر المستودعات.
3. غيّر `runs-on` ثم ادفع التغيير.

أبقِ خطوات التخزين المؤقت كما هي. يجد التشغيل الثاني ذاكرة التشغيل الأول المؤقتة على الجهاز.

## الأمان

- الجهاز لحسابك وحده، ولا تعمل عليه مهام أي شركة أخرى.
- بعد كل مهمة، تُمسح بيانات اعتماد المشغّل وعملياته وحاوياته. ويمنح خيار «مهمة نظيفة في كل مرة» كل مهمة جهازًا جديدًا بدلًا من ذلك.
- الكود الوارد من أشخاص ليس لديهم صلاحية الكتابة (مثل طلبات السحب من النسخ المتفرعة) يعمل على جهاز افتراضي جديد يقرأ ذاكرتك المؤقتة لكنه لا يستطيع تغييرها.

التفاصيل في [كيف تُعزل المهام](https://docs.skipbox.dev/ar/isolation).

## جرّبه على المهمة التي تُخطئ ذاكرتها المؤقتة

الفترة التجريبية مجانية لمدة 7 أيام أو 3,000 دقيقة من وقت المهام، أيهما يأتي أولًا، ولا تتطلب بطاقة. انقل تلك المهمة إلى `runs-on: skipbox`، وشغّلها مرتين، وضع خطوتي الاستعادة والتثبيت في التشغيل الثاني بجانب ما في GitHub.

## الأسئلة الشائعة

### ما حد حجم ذاكرة التخزين المؤقت في GitHub Actions؟

10 GB لكل مستودع افتراضيًا، لكل الفروع وسير العمل معًا. وبعد تجاوزه، يظل GitHub يحفظ الإدخال الجديد ويحذف الإدخالات بحسب آخر وصول، الأقدم أولًا، حتى يعود المستودع تحت الحد. والإدخالات التي لم تقرأها أي مهمة 7 أيام تُحذف أيًّا كان الحجم. وعلى حساب Pro أو Team أو Enterprise، يستطيع المسؤولون رفع الحد والأيام؛ ويُحتسب التخزين فوق 10 GB بسعر $0.07 لكل GB شهريًا، مقيسًا بذروة كل ساعة، وحين تُبلغ الميزانية تصبح ذاكرة التخزين المؤقت للقراءة فقط حتى دورة الفوترة التالية.

### لماذا تُطرد ذاكرة GitHub Actions المؤقتة لدي كثيرًا؟

لأن كل ما في المستودع يتشارك 10 GB واحدة: كل فرع، وكل طلب سحب، وكل مهمة في المصفوفة، وكل نظام تشغيل يحفظ إدخالاته الخاصة، وذاكرة Docker المؤقتة type=gha تنتهي في المكان نفسه. وحين تتجاوز عمليات الحفظ في يوم واحد الحد، يحذف كل حفظ إدخالًا أقدم، فتُخطئ المهمة التالية الإدخال الذي كانت تحتاجه. ويسمّي GitHub ذلك cache thrashing. اعرض الإدخالات بحسب الحجم (gh cache list --sort size_in_bytes) لترى ما يملؤها.

### لماذا تستغرق استعادة ذاكرة التخزين المؤقت ما يستغرقه التثبيت من الصفر؟

لأن الإصابة ما زالت تنزيلًا. كل مهمة على مشغّل مستضاف على GitHub تبدأ على جهاز افتراضي جديد، فيُنزّل actions/cache الأرشيف ويفكّه في كل مرة، وكلما كبرت ذاكرة التخزين المؤقت طال ذلك. وذاكرة setup-node المؤقتة تعيد ذاكرة التنزيل لمدير الحزم، لا node_modules، فيظل npm ci يثبّت كل حزمة بعد الاستعادة. وعلى مشغّل يحتفظ بقرصه، تكون ذاكرة التخزين المؤقت موجودة أصلًا ولا يُنزَّل شيء.

### لماذا يُخطئ actions/cache على فرع جديد؟

يستطيع التشغيل استعادة ذاكرة التخزين المؤقت من فرعه ومن الفرع الافتراضي، وتشغيل طلب السحب من فرعه الأساسي أيضًا. ولا يستطيع قراءة ذاكرة فرع شقيق. فلا يصيب التشغيل الأول لفرع ميزة إلا إن حفظ الفرع الافتراضي ذلك المفتاح. شغّل سير العمل عند الدفع إلى الفرع الافتراضي حتى يحفظ، وأضف restore-keys لمطابقة جزئية؛ وcache-hit يكون true فقط عند المطابقة التامة للـ key.

### كم من ذاكرة Actions المؤقتة يحتفظ بها Skipbox؟

أكثر من 10 GB التي يمنحها GitHub لكل مستودع، بجوار جهازك بدلًا من تخزين GitHub. على جهاز سحابي، ما تحفظه المهام بـ actions/cache وsetup-* وrust-cache يبقى على قرص الجهاز نفسه، حتى نصف ذلك القرص (80 GB على S، و160 GB على M، و320 GB على L)؛ وعلى مضيف Skipbox، تحتفظ ذاكرة المضيف المؤقتة بـ 20 GB لكل مستودع. وفي الحالتين يُحفظ الإدخال 7 أيام بعد آخر استخدام له، بقواعد الفروع نفسها في GitHub. أما ذاكرة الحزم المؤقتة وطبقات Docker فلا تمر بها: إنها تبقى على القرص نفسه.

### ما الذي يمسح ذاكرة التخزين المؤقت على جهاز Skipbox؟

لا شيء بين المهام: تبقى ذاكرة التخزين المؤقت على الجهاز، ولا يذهب ما استُخدم منذ أطول مدة أولًا إلا حين تترك مهمةٌ القرصَ شبه ممتلئ. ويبدأ الجهاز نظيفًا عند إعادة الضبط: حين تضغط «إعادة ضبط الجهاز»، وحين تُحدَّث صورته (مرة شهريًا على الأقل)، وحين يفشل في فحص السلامة بعد مهمة، وحين تبلغ مهمة حد الـ 6 ساعات. ويُحذف الجهاز مع قرصه حين تنتهي الخطة.

### كم تكلّف التجربة؟

لا شيء. الفترة التجريبية 7 أيام أو 3,000 دقيقة من وقت المهام، أيهما يأتي أولًا، دون بطاقة. انقل المهمة التي تُخطئ ذاكرتها المؤقتة أو تبطؤ استعادتها إلى runs-on: skipbox، وشغّلها مرتين، وقارن خطوتي الاستعادة والتثبيت في التشغيل الثاني بما في GitHub.

آخر تحديث: 2026-11-19 · https://skipbox.dev/ar/guides/github-actions-cache-size-limit
