هاست Next.js با رندر سمت سرور

Next.js همان‌طور که نوشته‌اید

بیلدپک سکو کلود وابستگی next را در package.json پیدا می‌کند و پروژه را به‌عنوان Next.js می‌شناسد. اگر در next.config گزینه‌ی output: 'standalone' را فعال کرده باشید، فقط خروجی standalone و فایل‌های static به ایمیج نهایی می‌رود و برنامه با node server.js اجرا می‌شود؛ در غیر این صورت next start اجرا می‌شود.

صفحه‌های SSR، ISR، Middleware، Route Handler و Server Action روی سرور Node.js اجرا می‌شوند و نیازی به سرویس جداگانه ندارند. اگر پروژه را با output: 'export' کاملاً استاتیک ساخته‌اید، پوشه‌ی out به‌عنوان سایت استاتیک سرو می‌شود.

مسیر بیلد Next.js

1. تشخیص

   وابستگی next در package.json و لاک‌فایل در ریشه.

   "next": "15.x"

2. نصب

   پکیج‌منیجر از روی لاک‌فایل انتخاب می‌شود.

   npm ci

3. بیلد

   اسکریپت build اجرا می‌شود و کش .next/cache بین بیلدها نگه داشته می‌شود.

   next build

4. اجرا

   در حالت standalone فقط خروجی لازم کپی و با server.js اجرا می‌شود.

   node server.js

خروجی یک استقرار واقعی

$ sakoocloud deploy
✔ Packed 3.2MB
✔ Source uploaded
ℹ Build started · dep_7k2m9q
#4 [builder 1/6] FROM node:22-alpine
#6 [builder 3/6] RUN npm ci
#8 [builder 4/6] RUN npm run build
#10 [stage-1 3/4] COPY .next/standalone ./
#12 exporting to image
✔ Deployed — app is running.
→ https://my-site.sakooapps.ir

تنظیم پیشنهادی

خروجی standalone را روشن کنید و مطمئن شوید سرور روی 0.0.0.0 و پورت PORT بالا می‌آید.

/** @type {import('next').NextConfig} */
const nextConfig = {
  output: "standalone",
};

export default nextConfig;

{
  "scripts": {
    "build": "next build",
    "start": "next start -H 0.0.0.0 -p ${PORT:-3000}"
  }
}

sakoocloud apps create --name my-site --runtime nextjs --port 3000
sakoocloud deploy

تنظیمات

اتصال به دیتابیس

دیتابیس لینک‌شده DATABASE_URL را به محیط اپ می‌دهد. اگر از Prisma استفاده می‌کنید، prisma generate را جلوی next build بگذارید.

sakoocloud apps link-db <db-id> --app my-site

{
  "scripts": {
    "build": "prisma generate && next build"
  }
}

import { PrismaClient } from "@prisma/client";

export const db = new PrismaClient();

همراه هر استقرار

این‌ها به رانتایم بستگی ندارند و برای هر اپ روی سکو کلود فعال‌اند. بعضی، مثل مقیاس‌دهی خودکار و کران‌جاب، به پلن بستگی دارند.

• دامنه‌ی اختصاصی و SSLدامنه را اضافه کنید؛ گواهی خودکار صادر و تمدید می‌شود.
• متغیرهای محیطی و سکرتمقادیر رمزگذاری‌شده فقط در زمان اجرا به اپ می‌رسند.
• مرحله‌ی انتشارmigration بعد از بیلد و پیش از جایگزینی نسخه‌ی قبلی اجرا می‌شود.
• لاگ زندهلاگ بیلد و زمان اجرا، در CLI و کنسول.
• بازگشت به نسخه‌ی قبلهر استقرار قبلی با یک دستور برمی‌گردد.
• مقیاس‌دهیمنابع و تعداد نمونه‌ها را تغییر دهید یا خودکارش کنید.
• دیسک ماندگاربرای فایل‌هایی که باید بعد از هر استقرار بمانند.
• کران‌جابدستور زمان‌بندی‌شده با همان ایمیج و متغیرها.
• استقرار خودکار با گیتهر push روی شاخه‌ی هدف بیلد و مستقر می‌شود.

خطاهای رایج

"start": "next start -H 0.0.0.0 -p ${PORT:-3000}"

sakoocloud env set NEXT_PUBLIC_API_URL=https://api.example.com --build-time
sakoocloud deploy

sakoocloud apps scale --memory 1Gi

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

جزئیات بیشتر در راهنمای Next.js در مستندات و مرجع CLI.