آموزش انتشار پروژه 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.js | JavaScript | تنظیماتِ 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) بسازید.

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

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

مرحله ۴: نصبِ وابستگیها
وارد صفحهٔ اپلیکیشن شوید و روی Run NPM Install بزنید تا next و react نصب شوند (کمی طول میکشد چون حجمشان بیشتر است).
مرحله ۵: ساختِ پروژه (Build)
این مرحله مخصوصِ Next.js است. روی Run JS script بزنید، از لیستِ اسکریپتها گزینهٔ build را انتخاب و اجرا کنید. این کار پوشهٔ .next (خروجیِ نهایی) را میسازد.

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

حالا آدرسِ سابدامین را باز کنید — پروژهٔ 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 هاستینو با سیپنل و پشتیبانیِ فارسی، همین مسیر را برایتان هموار میکند.
اسکرینشاتها از یک دیپلویِ واقعی روی سیپنلِ هاستینو گرفته شدهاند.

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

