دیپلوی کردن Next.js – سرور Node.js، کانتینر Docker، خروجی استاتیک و آداپترهای پلتفرمی

Next.js را می‌توان به‌صورت سرور Node.js، کانتینر Docker، خروجی استاتیک یا با آداپترهای پلتفرمی دیپلوی کرد. این مقاله روش‌های مختلف دیپلوی، تفاوت در پشتیبانی ویژگی‌ها، نکات مربوط به توسعه، و نحوهٔ بروزرسانی به نسخه‌های جدید یا canary را بررسی می‌کند.

Next.js deploymentNode.js serverDocker containerVersion upgrade

~2 min read · Updated Oct 25, 2025

گزینه‌های دیپلوی در Next.js


Next.js را می‌توان به روش‌های مختلف دیپلوی کرد:

روش دیپلویپشتیبانی ویژگی‌ها
سرور Node.jsکامل
کانتینر Dockerکامل
خروجی استاتیکمحدود
آداپترهاوابسته به پلتفرم

دیپلوی به‌صورت سرور Node.js


برای دیپلوی روی سرور Node.js، مطمئن شوید فایل package.json شامل اسکریپت‌های زیر باشد:

{
  "scripts": {
    "dev": "next dev",
    "build": "next build",
    "start": "next start"
  }
}

سپس با اجرای npm run build اپلیکیشن را build کرده و با npm run start سرور را اجرا کنید. این روش از تمام ویژگی‌های Next.js پشتیبانی می‌کند.


پلتفرم‌های پیشنهادی: Flightcontrol، Railway، Replit


دیپلوی با Docker


Next.js را می‌توان در هر پلتفرمی که از Docker پشتیبانی می‌کند دیپلوی کرد، از جمله Kubernetes یا سرویس‌های ابری.


نکته توسعه: در محیط‌های Mac و Windows، برای توسعه بهتر از npm run dev به‌جای Docker استفاده کنید.


پلتفرم‌های پیشنهادی: Docker، DigitalOcean، Fly.io، Google Cloud Run، Render، SST


دیپلوی به‌صورت خروجی استاتیک


Next.js امکان خروجی‌گیری به‌صورت سایت استاتیک یا SPA را فراهم می‌کند. این خروجی را می‌توان روی هر سروری که فایل‌های HTML/CSS/JS را سرو می‌کند دیپلوی کرد.


پلتفرم‌های پیشنهادی: AWS S3، Nginx، Apache، GitHub Pages


محدودیت: ویژگی‌هایی که نیاز به سرور دارند در این حالت پشتیبانی نمی‌شوند.


دیپلوی با آداپترهای پلتفرمی


Next.js را می‌توان با آداپترهای خاص برای پلتفرم‌های مختلف اجرا کرد. برای اطلاعات دقیق، به مستندات هر پلتفرم مراجعه کنید:

  • AWS Amplify Hosting
  • Cloudflare
  • Deno Deploy
  • Netlify
  • Vercel

در حال توسعه API آداپترهای دیپلوی هستیم تا همهٔ پلتفرم‌ها بتوانند از آن استفاده کنند.


بروزرسانی نسخه Next.js


آخرین نسخه پایدار


برای بروزرسانی به آخرین نسخه پایدار:

npx @next/codemod@latest upgrade latest

یا به‌صورت دستی نصب کنید:

pnpm i next@latest react@latest react-dom@latest eslint-config-next@latest

نسخه Canary


برای بروزرسانی به نسخه آزمایشی (canary):

npm i next@canary

ویژگی‌های موجود در canary:

  • کشینگ: "use cache"، cacheLife، cacheTag، cacheComponents
  • احراز هویت: forbidden، unauthorized، فایل‌های forbidden.js و unauthorized.js، authInterrupts

جمع‌بندی


Next.js انعطاف‌پذیری بالایی در دیپلوی دارد. چه بخواهید از سرور Node.js، کانتینر Docker، خروجی استاتیک یا آداپترهای پلتفرمی استفاده کنید، می‌توانید با توجه به نیاز پروژه و زیرساخت خود، بهترین گزینه را انتخاب کنید و همیشه با نسخه‌های جدید همگام بمانید.


Written & researched by Dr. Shahin Siami

Related Articles

مسیریابی پیشرفته و هوک‌های عملکرد در Next.js — راهنمای توسعه‌دهنده برای App Router

Next.js مجموعه‌ای غنی از هوک‌های کلاینت و ابزارهای کش و ناوبری را در اختیار توسعه‌دهندگان قرار می‌دهد. از خواندن پارامترهای مسیر تا گزارش Web Vitals و مدیریت کش، این مقاله مهم‌ترین ابزارهای App Router را با مثال‌های کاربردی معرفی می‌کند.

Continue

مدیریت احراز هویت و کش در Next.js — راهنمای توسعه‌دهنده برای امنیت و عملکرد پویا

Next.js با معرفی قابلیت‌های آزمایشی جدید، امکان کنترل دقیق‌تر دسترسی و کش داده‌ها را فراهم کرده است. تابع unauthorized برای مدیریت خطای 401 و هدایت کاربران به صفحه ورود، unstable_cache برای کش هوشمند عملیات سنگین، updateTag برای بازسازی آنی داده‌ها، و useLinkStatus برای نمایش وضعیت ناوبری استفاده می‌شوند. این مقاله نحوه استفاده از این ابزارها را با مثال‌های کاربردی و نکات مهم بررسی می‌کند.

Continue

redirect و refresh در Next.js — ریدایرکت‌های هوشمند و تازه‌سازی مسیر در Server Actions

تابع redirect در Next.js برای هدایت کاربر به مسیر جدید استفاده می‌شود و بسته به نوع استفاده، پاسخ HTTP با وضعیت 307 یا 303 ارسال می‌کند. این تابع در Server Components، Client Components، Route Handlers و Server Actions قابل استفاده است. تابع refresh نیز برای تازه‌سازی مسیر کلاینت از درون Server Action استفاده می‌شود. این مقاله نحوه استفاده از هر دو تابع را با مثال‌های کاربردی و نکات مهم توضیح می‌دهد.

Continue

Next.js با معرفی NextRequest و NextResponse، APIهای Request و Response مرورگر را گسترش داده و ابزارهای قدرتمندی برای مدیریت کوکی‌ها، هدرها، ریدایرکت‌ها، بازنویسی مسیرها و پاسخ‌های JSON فراهم کرده است. این مقاله نحوه استفاده از این ابزارها را با مثال‌های کاربردی و نکات امنیتی توضیح می‌دهد.

Next.js با معرفی NextRequest و NextResponse، APIهای Request و Response مرورگر را گسترش داده و ابزارهای قدرتمندی برای مدیریت کوکی‌ها، هدرها، ریدایرکت‌ها، بازنویسی مسیرها و پاسخ‌های JSON فراهم کرده است. این مقاله نحوه استفاده از این ابزارها را با مثال‌های کاربردی و نکات امنیتی توضیح می‌دهد.

Continue

headers، ImageResponse، notFound و permanentRedirect در Next.js — مدیریت درخواست‌ها، تولید تصویر، خطا و ریدایرکت

Next.js ابزارهای قدرتمندی برای مدیریت درخواست‌ها و پاسخ‌ها در کامپوننت‌های سروری فراهم کرده است. تابع headers برای خواندن هدرهای HTTP ورودی، ImageResponse برای تولید تصاویر داینامیک، notFound برای نمایش صفحه خطای 404، و permanentRedirect برای ریدایرکت دائمی کاربران استفاده می‌شوند. این مقاله نحوه استفاده از هر یک را با مثال‌های کاربردی توضیح می‌دهد.

Continue

راهنمای کامل استفاده از metadata و generateMetadata در Next.js

در نسخه‌های مدرن Next.js، مدیریت metadata صفحات بسیار قدرتمندتر و ساده‌تر شده است. metadata به‌صورت خودکار در تگ <head> صفحات تزریق می‌شود و نقش مهمی در SEO، اشتراک‌گذاری اجتماعی و تجربه کاربری دارد. این مقاله دو روش اصلی تعریف metadata را بررسی می‌کند: استفاده از آبجکت ثابت metadata و تابع داینامیک generateMetadata.

Continue