# بیلد Next.js در GitHub Actions کند است یا حافظه‌اش تمام می‌شود: کش، حافظه، اندازه رانر

> بیلد Next.js در GitHub Actions وقتی کند است که .next/cache به اجرای بعدی نرسد، و روی ubuntu-latest با 8 GB در یک مخزن خصوصی، وقتی webpack، بررسی تایپ و source mapها روی هم جمع شوند، حافظه‌اش تمام می‌شود. چه چیزی را کش کنید، کدام تنظیمات Next.js حافظه را کم می‌کنند، و اندازه رانر: روی Skipbox‏ ۱۶ GB با ماهانه $۷۹ یا ۳۲ GB با $۱۴۹، جایی که .next/cache بین جاب‌ها می‌ماند و دقیقه‌ها نامحدودند.

بیلد Next.js در GitHub Actions به یک دلیل کند است و به دلیل دیگری حافظه‌اش تمام می‌شود. وقتی کند است که `.next/cache` به اجرای بعدی نرسد: Next.js آن کش را بین بیلدها دوباره استفاده می‌کند، جاب میزبانی‌شده GitHub روی یک ماشین مجازی تازه شروع می‌شود، و بدون گام کش هر بیلد سرد است (لاگ می‌گوید `No Cache Detected`). حافظه‌اش تمام می‌شود چون `ubuntu-latest` یک مخزن خصوصی 8 GB دارد، و کامپایل webpack، بررسی تایپ و source mapهای یک اپ بزرگ می‌توانند از آن بگذرند. اولی را با `actions/cache` روی `.next/cache` درست کنید. برای دومی، اول تنظیمات حافظه Next.js (`experimental.webpackMemoryOptimizations`، بدون source mapهای production)؛ بعد ماشینی با حافظه بیشتر: 16 GB یا 32 GB.

Skipbox آن حافظه را با قیمت ثابت به بیلد می‌دهد: ۱۶ GB و ۸ vCPU روی `runs-on: skipbox-8x16` با ماهانه $۷۹، و ۳۲ GB و ۱۶ vCPU روی `skipbox-16x32` با $۱۴۹. روی ماشین اختصاصی شما `.next/cache` برای بیلد بعدی می‌ماند، کش پکیج‌ها روی دیسک می‌مانند، و آنچه `actions/cache` ذخیره می‌کند محلی خوانده می‌شود، با دقیقه‌های نامحدود.

- `.next/cache` روی ماشین اختصاصی شما می‌ماند: بیلد بعدی کامپایل قبلی‌اش را دوباره استفاده می‌کند، بدون گام کش
- ۱۶ GB با ماهانه $۷۹ یا ۳۲ GB با $۱۴۹، در برابر 8 GB روی `ubuntu-latest` خصوصی
- کش پکیج‌ها روی ماشین شما می‌مانند، و بازگردانی کش به‌جای دانلود از دیسک آن می‌خواند

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

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

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

[شروع دوره آزمایشی رایگان ۷ روزه](https://app.skipbox.dev/sign-in?ref=g-nextjs-build-slow-out-of-memory-github-actions-fa)

## کند: .next/cache خالی شروع می‌شود

طبق [راهنمای کش بیلد در CI](https://nextjs.org/docs/app/guides/ci-build-caching) در Next.js، این فریمورک کشی در `.next/cache` ذخیره می‌کند که بین بیلدها مشترک است، و CIی که آن را بین بیلدها نگه ندارد خطای `No Cache Detected` نشان می‌دهد. گام GitHub Actions آن:

```yaml
- uses: actions/cache@v4
  with:
    path: |
      ~/.npm
      ${{ github.workspace }}/.next/cache
    key: ${{ runner.os }}-nextjs-${{ hashFiles('**/package-lock.json') }}-${{ hashFiles('**/*.js', '**/*.jsx', '**/*.ts', '**/*.tsx') }}
    restore-keys: |
      ${{ runner.os }}-nextjs-${{ hashFiles('**/package-lock.json') }}-
```

کلید با هر تغییر سورس تغییر می‌کند، پس هر اجرا یک ورودی تازه ذخیره می‌کند، داخل ۱۰ GB‏ GitHub برای هر مخزن. در Turborepo، `.next/cache` را از `outputs` تسک کنار بگذارید (`"!.next/cache/**"`)، همان‌طور که [راهنمای GitHub Actions در Turborepo](https://turborepo.dev/docs/guides/ci-vendors/github-actions) انجام می‌دهد.

## کمبود حافظه: دو خطای متفاوت

| در لاگ | چه چیزی تمام شد | چه کنید |
|---|---|---|
| `JavaScript heap out of memory` | سقف heap خود Node؛ ماشین هنوز حافظه داشت | بالایش ببرید: `NODE_OPTIONS=--max-old-space-size=6144`، کمتر از حافظه ماشین |
| `Process completed with exit code 137` | حافظه ماشین: Linux پروسه را کشت | حافظه کمتری مصرف کنید، یا ماشینی با حافظه بیشتر |

بالا بردن heap بیشتر از حافظه ماشین خطای اول را به دومی تبدیل می‌کند.

## حافظه کمتری مصرف کنید: تنظیمات خود Next.js

از [راهنمای مصرف حافظه](https://nextjs.org/docs/app/guides/memory-usage) در Next.js:

- **`experimental.webpackMemoryOptimizations: true`** (v15.0.0 و بعدتر) اوج حافظه webpack را پایین می‌آورد، به قیمت کامپایلی کمی طولانی‌تر.
- **build worker در webpack** کامپایل را در یک worker جداگانه Node اجرا می‌کند، که حافظه را کم می‌کند. از v14.1.0 به‌طور پیش‌فرض روشن است، مگر تنظیم webpack سفارشی داشته باشید؛ با آن، `experimental.webpackBuildWorker: true` را تنظیم کنید.
- **source mapها خاموش:** `productionBrowserSourceMaps: false` و `experimental.serverSourceMaps: false`. اگر حافظه بیلد در مرحله "Generating static pages" تمام می‌شود، `enablePrerenderSourceMaps: false` هم.
- **اندازه بگیرید:** `next build --experimental-debug-memory-usage` (v14.2.0 و بعدتر) مصرف heap را در طول بیلد چاپ می‌کند و نزدیک سقف heap snapshot می‌گیرد.
- **بررسی تایپ:** `typescript.ignoreBuildErrors: true` بررسی تایپ و حافظه‌اش را رد می‌کند، و خطاهای تایپ را به بیلد راه می‌دهد. Next.js از آن برحذر می‌دارد، مگر آنکه گام دیگری تایپ‌ها را بررسی کند.

## از ماشینی با حافظه بیشتر استفاده کنید

| رانر | CPU و حافظه | چه کسانی می‌توانند استفاده کنند |
|---|---|---|
| `ubuntu-latest` در GitHub، مخزن خصوصی | 2 CPU، 8 GB | همه |
| `ubuntu-latest` در GitHub، مخزن عمومی | 4 CPU، 16 GB | مخزن‌های عمومی |
| larger runner در GitHub، 4 یا 8 هسته | 16 GB یا 32 GB | سازمان‌های GitHub Team و Enterprise Cloud، دقیقه‌ای ([larger runnerها](https://docs.github.com/en/actions/concepts/runners/larger-runners)) |
| Skipbox‏ `skipbox-8x16` | ۸ vCPU‏، ۱۶ GB | سازمان‌ها و حساب‌های شخصی، ماهانه $۷۹ |
| Skipbox‏ `skipbox-16x32` | ۱۶ vCPU‏، ۳۲ GB | سازمان‌ها و حساب‌های شخصی، ماهانه $۱۴۹ |

با 20,000 دقیقه در ماه، رانر 8 هسته‌ای GitHub‏ $۴۲۲ است و Skipbox M‏ $۷۹؛ با 16 هسته، $۸۲۲ در برابر $۱۴۹ برای L. ارقام GitHub پس از مصرف شامل‌شده GitHub Team است.

## Skipbox برای بیلد Next.js چه می‌کند

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

- **حافظه‌ای که بیلد لازم دارد**، با لیبل: روی M‏ ۱۶ GB، روی L‏ ۳۲ GB. heap را متناسب با آن تنظیم کنید، مثلاً روی M‏ `--max-old-space-size=12288`.
- **کش پکیج‌ها روی دیسک می‌مانند:** `~/.npm`، store در pnpm، `~/.cache` هر ابزار، و نسخه‌های Node که `setup-node` نصب کرده. `npm ci` به‌جای registry از آن‌ها می‌خواند.
- **`.next/cache` برای جاب بعدی می‌ماند.** ماشین checkout شما را بین جاب‌ها نگه می‌دارد، و `.next/cache` داخل آن را، در هر عمقی که یک monorepo آن را بگذارد (`apps/web/.next/cache`). `next build` بعدی از آن شروع می‌شود، بدون گام کش و بدون `No Cache Detected`. بقیه `.next` و فایل‌های ردیابی‌نشده دیگر checkout بعد از هر جاب پاک می‌شوند.
- **بازگردانی‌های `actions/cache` از ماشین می‌خوانند.** آنچه ذخیره می‌کند کنار ماشین می‌ماند، با فضایی بیشتر از ۱۰ GB‏ GitHub برای هر مخزن، و بازگردانی یک خواندن محلی است. گام `.next/cache` را برای جاب‌هایی که روی یک ماشین مجازی تازه اجرا می‌شوند نگه دارید؛ روی ماشین اختصاصی شما بازگردانی به کش نگه‌داشته‌شده دست نمی‌زند.
- **هسته‌های بیشتر با قیمت ثابت.** کامپایل و تولید صفحه‌های ایستا از آن‌ها استفاده می‌کنند، و دقیقه‌ها نامحدودند.

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

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

```yaml
jobs:
  build:
    runs-on: skipbox-8x16 # was ubuntu-latest
    env:
      NODE_OPTIONS: --max-old-space-size=12288
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with:
          node-version: 22
          cache: npm
      - uses: actions/cache@v4
        with:
          path: ${{ github.workspace }}/.next/cache
          key: ${{ runner.os }}-nextjs-${{ hashFiles('**/package-lock.json') }}-${{ hashFiles('**/*.js', '**/*.jsx', '**/*.ts', '**/*.tsx') }}
          restore-keys: |
            ${{ runner.os }}-nextjs-${{ hashFiles('**/package-lock.json') }}-
      - run: npm ci
      - run: npx next build
```

`skipbox-8x16` روی طرح M اجرا می‌شود؛ دوره آزمایشی `runs-on: skipbox` را اجرا می‌کند.

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

## امنیت

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

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

## روی بیلد Next.js امتحانش کنید

دوره آزمایشی به مدت ۷ روز یا ۳٬۰۰۰ دقیقه جاب رایگان است، هر کدام زودتر برسد، بدون کارت. `runs-on: skipbox` را با ۱۶ GB اجرا می‌کند، ۲ برابر حافظه `ubuntu-latest` یک مخزن خصوصی: کش و حافظه را آنجا امتحان کنید، و بیلدی را که بیشتر لازم دارد به طرح L‏ (`skipbox-16x32`، ۳۲ GB) ببرید.

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

### چرا next build در GitHub Actions کند است؟

معمولاً چون .next/cache خالی شروع می‌شود. Next.js یک کش بیلد در .next/cache ذخیره می‌کند و در بیلد بعدی دوباره از آن استفاده می‌کند، ولی جاب میزبانی‌شده GitHub یک ماشین مجازی تازه است، پس بدون گامی که .next/cache را منتقل کند، هر بیلد سرد است و لاگ هشدار No Cache Detected می‌دهد. actions/cache را برای .next/cache با کلیدی بر اساس lockfile و فایل‌های سورس اضافه کنید. بقیه زمان صرف نصب و کامپایل روی 2 CPU می‌شود.

### بیلد Next.js در GitHub Actions از چه اندازه رانری باید استفاده کند؟

حافظه کافی برای اوج بیلد. ubuntu-latest یک مخزن خصوصی 2 CPU و 8 GB دارد، و بیلد webpack، بررسی تایپ و source mapهای یک اپ بزرگ Next.js می‌توانند از آن بگذرند. larger runnerهای GitHub با 4 هسته 16 GB و با 8 هسته 32 GB دارند، فقط در GitHub Team یا Enterprise Cloud، دقیقه‌ای. Skipbox روی runs-on: skipbox-8x16‏ ۱۶ GB با ۸ vCPU به ماهانه $۷۹ می‌دهد، و روی skipbox-16x32‏ ۳۲ GB با ۱۶ vCPU به $۱۴۹.

### چطور خطای JavaScript heap out of memory را در بیلد Next.js روی GitHub Actions برطرف کنم؟

آن خطا سقف heap خود Node است، نه حافظه ماشین. با NODE_OPTIONS=--max-old-space-size=<MiB> بالایش ببرید، کمتر از حافظه ماشین. اگر جاب بعد از آن به‌جایش با exit code 137 تمام شد، حافظه خود ماشین تمام شده است: حافظه بیلد را کم کنید (experimental.webpackMemoryOptimizations، بدون source mapهای production) یا روی ماشینی با حافظه بیشتر اجرا کنید.

### چطور مصرف حافظه بیلد Next.js را کم کنم؟

از راهنمای حافظه Next.js: experimental.webpackMemoryOptimizations را امتحان کنید (v15 و بعدتر)، build worker در webpack را روشن نگه دارید (از v14.1.0 بدون تنظیم webpack سفارشی پیش‌فرض است)، productionBrowserSourceMaps و experimental.serverSourceMaps را خاموش کنید، و با next build --experimental-debug-memory-usage اندازه بگیرید. رد کردن بررسی تایپ با typescript.ignoreBuildErrors حافظه را کم می‌کند ولی خطاهای تایپ را رد می‌کند، پس فقط وقتی انجامش دهید که جاب CI دیگری تایپ‌ها را بررسی کند.

### Skipbox پوشه .next/cache را بین جاب‌ها نگه می‌دارد؟

بله. ماشین اختصاصی شما checkout را بین جاب‌ها نگه می‌دارد، و .next/cache داخل آن را، هر جا که Next.js گذاشته باشد (در یک monorepo، apps/web/.next/cache)، پس next build بعدی بدون هیچ گام کشی از کش بیلد قبلی شروع می‌شود. بقیه .next و فایل‌های ردیابی‌نشده دیگر checkout بعد از هر جاب پاک می‌شوند. کش npm یا pnpm، نسخه‌های Node که setup-node نصب کرده و لایه‌های Docker هم روی دیسک می‌مانند. گام actions/cache برای .next/cache می‌تواند بماند: جابی روی یک ماشین مجازی تازه، مثل pull request از یک fork، از آن بازمی‌گرداند، و روی ماشین اختصاصی شما بازگردانی به کش نگه‌داشته‌شده دست نمی‌زند.

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

هیچ. دوره آزمایشی ۷ روز یا ۳٬۰۰۰ دقیقه جاب است، هر کدام زودتر برسد، بدون کارت، روی ۴ vCPU و ۱۶ GB: ۲ برابر ۸ GB در ubuntu-latest روی مخزن خصوصی، و برابر larger runner با ۴ هسته در GitHub. کش و حافظه را آنجا امتحان کنید؛ برای بیلدی که بیشتر لازم دارد، طرح L را انتخاب کنید و لیبل را به skipbox-16x32‏ (۳۲ GB) تغییر دهید.

به‌روزرسانی: 2026-11-16 · https://skipbox.dev/fa/guides/nextjs-build-slow-out-of-memory-github-actions
