هاستینگ و سرور

آموزش انتشار پروژه Next.js روی هاست Node.js با سی‌پنل (قدم به قدم)

علی محمدیعلی محمدی۱۸ مهر ۱۴۰۵۸ دقیقه مطالعه
آموزش انتشار پروژه Next.js روی هاست Node.js با سی‌پنل (قدم به قدم)

در یک نگاه

در این آموزشِ ۰ تا ۱۰۰ یک پروژهٔ واقعیِ Next.js می‌سازیم و روی هاستِ Node.js هاستینو با سی‌پنل منتشرش می‌کنیم. Next.js نسبت به یک اپِ Node سادهٔ معمولی دو گامِ بیشتر دارد: یک سرورِ سفارشی (server.js) و مرحلهٔ build. همه را قدم‌به‌قدم با اسکرین‌شات می‌بینیم.

Next.js یک فریم‌ورکِ محبوبِ React برای ساختِ سایت و اپلیکیشنِ سریع است. برای اجرا روی هاست، بعد از نصبِ وابستگی‌ها باید پروژه را build کنید و سپس با یک سرورِ کوچک آن را سرو کنید. بیایید شروع کنیم.

پیش‌نیازها

  • هاست با پشتیبانیِ Node.js و دسترسی به سی‌پنل.
  • آشناییِ ابتدایی با Next.js (همین‌جا یک پروژهٔ کمینه می‌سازیم).

مرحله ۱: آماده‌کردنِ پروژهٔ Next.js

چهار فایل لازم داریم. اول package.json با اسکریپت‌های build و start:

{
  "name": "hostino-next-demo",
  "version": "1.0.0",
  "private": true,
  "scripts": {
    "build": "next build",
    "start": "NODE_ENV=production node server.js"
  },
  "dependencies": {
    "next": "14.2.15",
    "react": "18.3.1",
    "react-dom": "18.3.1"
  }
}

یک سرورِ سفارشی به نامِ server.js که Next را روی پورتِ سی‌پنل (process.env.PORT) اجرا می‌کند — این همان «فایلِ شروع» ماست:

const { createServer } = require('http');
const next = require('next');

const app = next({ dev: false });
const handle = app.getRequestHandler();
const port = process.env.PORT || 3000;

app.prepare().then(() => {
  createServer((req, res) => handle(req, res)).listen(port);
});

یک صفحهٔ ساده در pages/index.js:

export default function Home() {
  return <main dir="rtl"><h1>▲ سلام از Next.js روی هاستینو!</h1></main>;
}

و یک next.config.js ساده. (اگر اپ را روی یک «مسیر/زیرشاخه» اجرا می‌کنید، basePath را هم اضافه کنید؛ برای ساب‌دامین لازم نیست.)

/** @type {import('next').NextConfig} */
module.exports = { reactStrictMode: true };

این فایل‌ها را در یک پوشه بگذارید و از آن یک ZIP بسازید (nextapp.zip). پوشهٔ node_modules را داخلِ ZIP نگذارید؛ روی سرور نصب می‌شود.

ساختارِ استانداردِ فایل‌های یک پروژهٔ Next.js

یک پروژهٔ Next.js نسبت به Node سادهٔ معمولی فایل‌های بیشتری دارد (صفحه‌ها، کامپوننت‌ها، تنظیمات). ساختارِ رایجِ آن این‌طور است:

my-next-app/
├── package.json        # مشخصات و اسکریپت‌های build/start (JSON)
├── next.config.js      # تنظیمات Next مثل basePath (JavaScript)
├── server.js           # سرورِ سفارشی برای اجرا روی سی‌پنل
├── pages/              # صفحه‌ها و مسیرها  (یا app/ در نسخه‌های جدید)
│   ├── index.js        #   صفحهٔ اصلی
│   └── api/            #   (اختیاری) مسیرهای API
├── public/             # فایل‌های استاتیک: تصویر، favicon
├── styles/             # (اختیاری) فایل‌های CSS
├── components/         # (اختیاری) کامپوننت‌های React
├── .next/              # خروجیِ build (خودکار، با next build)
└── node_modules/       # وابستگی‌ها (خودکار)
فایل / پوشهفرمتنقش
package.json (الزامی)JSONاسکریپت‌های build و start و وابستگی‌ها (next، react)
next.config.jsJavaScriptتنظیماتِ Next؛ می‌تواند خالی باشد یا مثلاً basePath داشته باشد
server.js (برای سی‌پنل)JavaScriptسرورِ سفارشی؛ همان «فایلِ شروع» برای Passenger
pages/ یا app/ (الزامی)پوشه (.js/.jsx/.tsx)صفحه‌ها و مسیرهای سایت؛ pages/ سبکِ قدیمی و app/ سبکِ جدید (Next 13+)
pages/api/پوشهمسیرهای API (یک بک‌اندِ سبک داخلِ همان پروژه)
public/پوشهفایل‌های استاتیک: تصویر، favicon و…
components/ و styles/پوشه (.jsx/.css)کامپوننت‌های React و فایل‌های استایل (اختیاری)
.next/پوشهخروجیِ نهاییِ build؛ خودکار با next build ساخته می‌شود
node_modules/پوشهوابستگی‌ها؛ آپلود نکنید — با Run NPM Install ساخته می‌شود

فایل‌های کدِ Next می‌توانند پسوندِ .js، .jsx، .ts یا .tsx داشته باشند (اگر از TypeScript استفاده کنید، یک فایلِ tsconfig.json هم اضافه می‌شود).

مرحله ۲: ساب‌دامین و آپلودِ فایل‌ها

مثلِ هر اپِ Node، در بخشِ Domains یک ساب‌دامین (مثلاً nextdemo.yourdomain.com) بسازید.

ساخت ساب‌دامین برای اپلیکیشن Next.js
ساختِ ساب‌دامینِ اختصاصی برای اپلیکیشن

سپس در File Manager فایلِ ZIP را Upload و بعد Extract کنید تا پوشهٔ پروژه (nextapp) ساخته شود.

استخراج فایل پروژه Next.js در File Manager
استخراجِ فایل‌های پروژه در File Manager

مرحله ۳: ساختِ اپلیکیشن (فایلِ شروع = server.js)

در Setup Node.js App روی CREATE APPLICATION بزنید. دقیقاً مثلِ اپِ Node، با یک تفاوتِ مهم: Application startup file را server.js بگذارید (نه app.js).

فرم ساخت اپلیکیشن Next.js با startup file برابر server.js
ساختِ اپ؛ Mode=Production، Root=nextapp و startup file = server.js

مرحله ۴: نصبِ وابستگی‌ها

وارد صفحهٔ اپلیکیشن شوید و روی Run NPM Install بزنید تا next و react نصب شوند (کمی طول می‌کشد چون حجمشان بیشتر است).

مرحله ۵: ساختِ پروژه (Build)

این مرحله مخصوصِ Next.js است. روی Run JS script بزنید، از لیستِ اسکریپت‌ها گزینهٔ build را انتخاب و اجرا کنید. این کار پوشهٔ .next (خروجیِ نهایی) را می‌سازد.

اجرای اسکریپت build در Setup Node.js App
از منوی Run JS script، اسکریپتِ build را اجرا کنید

اگر build با خطای کمبودِ حافظه متوقف شد: برخی پلن‌های اشتراکی سقفِ حافظه دارند و next build ممکن است به آن بخورد. راهِ حلِ مطمئن: پروژه را روی سیستمِ خودتان build کنید (npm install و سپس npm run build) و فقط پوشهٔ .next را به‌صورتِ ZIP آپلود و در پوشهٔ پروژه Extract کنید. نتیجه یکی است.

مرحله ۶: ری‌استارت و مشاهدهٔ سایتِ زنده

بعد از ساختِ .next، اپ را Restart کنید تا server.js خروجیِ build را بردارد.

صفحه مدیریت اپلیکیشن Next.js با Restart
صفحهٔ اپلیکیشن؛ با Restart تغییراتِ build اعمال می‌شود

حالا آدرسِ ساب‌دامین را باز کنید — پروژهٔ Next.js شما زنده است!

پروژه Next.js زنده روی هاستینو
پروژهٔ Next.js که واقعاً روی هاستِ هاستینو اجرا می‌شود

عیب‌یابیِ سریع

  • خطای «Could not find a production build»: یعنی مرحلهٔ build انجام یا کامل نشده؛ build را اجرا کنید و بعد Restart بزنید.
  • فایل‌های استایل/تصویر بارگذاری نمی‌شوند (روی زیرشاخه): در next.config.js مقدارِ basePath و assetPrefix را برابرِ مسیرِ اپ قرار دهید.
  • خطای حافظه هنگامِ build: همان راهکارِ «build لوکال و آپلودِ .next» در بالا.

سوالات متداول

چرا Next.js به server.js و build نیاز دارد ولی اپِ Node ساده نه؟
Next.js کدِ React را برای اجرای سریع «کامپایل» می‌کند (build) و با یک سرورِ کوچک (server.js) آن را سرو می‌کند.

می‌توانم بدونِ سرورِ سفارشی اجرا کنم؟
روی سی‌پنل، سرورِ سفارشیِ server.js مطمئن‌ترین راه برای Passenger است.

نسخهٔ Node مهم است؟
بله؛ Next.js 14 به Node نسخهٔ ۱۸.۱۷ به بالا نیاز دارد.

اگر سایت را با Vercel، Bolt، Replit، Laravel و… ساخته‌اید

این روزها خیلی‌ها سایتشان را با ابزارهای آماده یا هوش مصنوعی می‌سازند و بعد می‌پرسند: «خروجی را چطور تحویل می‌دهند و چطور همان را روی هاستینو منتشر کنم؟» نکتهٔ کلیدی ساده است: این ابزارها معمولاً به شما سورس‌کدِ پروژه را می‌دهند (یک پوشه/فایلِ ZIP یا یک ریپازیتوریِ Git)، نه یک «بستهٔ جادویی». کافی است همان فایل‌ها را بردارید و طبقِ همین آموزش منتشر کنید.

خروجیِ این ابزارها معمولاً یکی از این سه نوع است:

  • سایتِ استاتیک (فقط HTML/CSS/JS): خروجیِ build در پوشه‌ای مثلِ dist یا out. این نوع حتی به هاستِ Node هم نیاز ندارد؛ کافی است محتوای آن پوشه را در public_htmlِ دامنه آپلود کنید.
  • اپلیکیشنِ Node یا Next (نیازمندِ سرور): دقیقاً همان روالِ این آموزش (ساختِ اپ در Setup Node.js App).
  • اپلیکیشنِ PHP مثلِ Laravel: این روی هاستِ معمولیِ PHP منتشر می‌شود، نه هاستِ Node (توضیح در جدول).

فایلی که باید بشناسید: package.json — اسکریپت‌های build و start در آن می‌گویند پروژه چطور ساخته و اجرا می‌شود و بخشِ dependencies کتابخانه‌های لازم را فهرست می‌کند (با Run NPM Install نصب می‌شوند). با دیدنِ همین فایل می‌فهمید پروژه استاتیک است یا اپِ Node.

ابزارخروجی (Export) چیست؟انتشار روی هاستینو
Vercelخودِ Vercel فایلِ آماده نمی‌دهد؛ کدِ شما در یک ریپازیتوریِ GitHub است (اغلب Next.js).پروژه را از GitHub دانلود کنید و طبقِ آموزشِ Next.js همین‌جا منتشر کنید.
Bolt.newدکمهٔ Download (فایلِ ZIP) یا Push to GitHub؛ سورسِ React/Vite یا Next.ZIP را باز کنید: اگر Next/Node بود طبقِ این آموزش؛ اگر استاتیک بود build بگیرید و خروجی را در public_html بگذارید.
v0 / Lovable (و مشابه)سورسِ React/Next (کپیِ کد یا اتصال به GitHub).مثلِ Bolt: سورس را بیاورید و به‌صورتِ اپِ Node/Next منتشر کنید.
Replitمنوی سه‌نقطه → Download as ZIP یا از طریقِ Git.بسته به نوعِ پروژه (Node یا استاتیک)، یکی از دو مسیرِ بالا.
Laravelپروژهٔ کاملِ PHP (پوشه + composer.json).روی هاستِ PHP: آپلود در public_html، document root را روی پوشهٔ public بگذارید، composer install، فایلِ .env و دیتابیس را تنظیم کنید (نه هاستِ Node).

اتصال به دامنه

بعد از انتشار، سایت را به دامنه وصل کنید:

  • اگر دامنه را همین‌جا (هاستینو) دارید: در ساختِ اپ، فیلدِ Application URL را روی دامنه یا ساب‌دامینِ خود بگذارید (برای سایتِ استاتیک، فایل‌ها را در document rootِ همان دامنه قرار دهید).
  • اگر دامنه جای دیگری ثبت شده: یا nameserverهای دامنه را به هاستینو تغییر دهید، یا یک رکوردِ A بسازید که دامنه را به IPِ هاست اشاره دهد.

همین! سورس را بیاورید، طبقِ نوعش منتشر کنید و دامنه را وصل کنید. برای جزئیاتِ هر مسیر، آموزشِ Node.js و آموزشِ Next.js را ببینید.

جمع‌بندی

انتشارِ Next.js روی سی‌پنل همان روالِ Node است به‌اضافهٔ دو گام: server.js و build. اگر با Node.js خالص کار می‌کنید، آموزشِ انتشار Node.js روی سی‌پنل را ببینید.

💡 راهکارِ هاستینو

برای اجرای Next.js به یک هاستِ Node.js سریع و پایدار نیاز دارید؟ هاستِ Node.js هاستینو با سی‌پنل و پشتیبانیِ فارسی، همین مسیر را برایتان هموار می‌کند.

اسکرین‌شات‌ها از یک دیپلویِ واقعی روی سی‌پنلِ هاستینو گرفته شده‌اند.

برچسب‌ها:Next.jsسی‌پنلدیپلویReactهاستینگ
علی محمدی
نویسنده
علی محمدی
متخصص زیرساخت و سرور

علی کارشناس زیرساخت و شبکه است و سال‌ها تجربه‌ی مدیریت سرور و میزبانی وب دارد. در مقاله‌هایش تجربه‌های عملیِ انتخاب و مدیریت سرور را به زبانی ساده به اشتراک می‌گذارد تا انتخاب درستی برای هر پروژه ممکن شود.

مقاله‌های بیشتر از علی محمدی ←

مقاله‌های مرتبط

به کمک نیاز دارید؟

تیم پشتیبانی ما ۲۴ ساعته آماده پاسخگویی به سوالات شما و ارائه راهنمایی‌های تخصصی است.

کمک فروش هاستینو

۲۴/۷/۳۶۵ از طریق ویجت چت

گفتگو کنید

چت پشتیبانی مشتریان

۲۴/۷/۳۶۵ از طریق پنل

برو به پنل

ایمیل پشتیبانی مشتریان

۲۴/۷/۳۶۵ از طریق پنل

برو به پنل

پشتیبانی با هوش مصنوعی

۲۴/۷/۳۶۵ کمک فوری هوش مصنوعی

امتحان دستیار هوشمند

ما باور داشتیم دنیای هاستینگ نیاز به یک تحول بزرگ دارد — و افتخار می‌کنیم آغازگر این تغییر بوده‌ایم.