अपना Node.js ऐप Rivervo होस्टिंग पर डिप्लॉय करें (Next.js और Nuxt)।
लोग मानते हैं कि Node.js ऐप को VPS पर ही चलाना पड़ता है। ऐसा नहीं है — Rivervo के हर शेयर्ड होस्टिंग प्लान में वेबसाइट मेन्यू में Node.js और Python है, जो आपके ऐप के लिए Phusion Passenger प्रोसेस चलाता है, उसी Apache के पीछे जो आपकी बाक़ी साइटें चलाता है।
यह गाइड दो सबसे आम फ़्रेमवर्क का पूरा तरीक़ा बताती है: Next.js और Nuxt 3। आख़िर में आपका ऐप https://aapkadomain.in (या किसी भी सबडोमेन) पर, असली Node.js प्रोसेस पर चलेगा, रीबूट के बाद भी चलता रहेगा और एक क्लिक में रीस्टार्ट होगा।
अगर आपने पहले कभी शेयर्ड होस्टिंग पर Node ऐप डिप्लॉय नहीं किया, तो सब लोग स्टार्टअप फ़ाइल पर अटकते हैं — Passenger को एक एंट्री स्क्रिप्ट चाहिए जो आपका फ़्रेमवर्क चालू करे। नीचे हर फ़्रेमवर्क के लिए एक फ़ाइल दी गई है; कॉपी-पेस्ट करें, कुछ बदलना नहीं है।
शुरू करने से पहले क्या चाहिए
- Rivervo होस्टिंग प्लान (कोई भी — Node.js ऐप सभी प्लान पर चलते हैं)
- ऐप बिल्ड करने के लिए लोकल मशीन पर Node.js v20 या नया
- बिल्ड किया हुआ ऐप, अपलोड के लिए तैयार (हर फ़्रेमवर्क के लिए नीचे बताया है)
- अकाउंट तक फ़ाइल मैनेजर या SFTP एक्सेस (दोनों चलते हैं)
आपको root, sudo, systemd या रिवर्स-प्रॉक्सी कॉन्फ़िग की ज़रूरत नहीं। यह सब Passenger संभालता है।
स्टेप 1 — ऐप लोकल मशीन पर बिल्ड करें
आप बिल्ड किया हुआ ऐप अपलोड करेंगे, सोर्स नहीं। पैनल डिपेंडेंसी इंस्टॉल करता है, लेकिन React कंपाइल या Vite बिल्ड नहीं चलाता। यह पहले अपनी मशीन पर करें।
Next.js:
npm ci
npm run buildइससे .next/ बनता है (बिल्ड का आउटपुट)। यहाँ next start न चलाएँ — हम थोड़ी देर में इसे स्टार्टअप फ़ाइल से चलाएँगे।
Nuxt 3:
npm ci
npm run buildइससे .output/ बनता है (Nuxt की यूनिवर्सल बिल्ड डायरेक्टरी)। यहाँ भी — अभी कुछ न चलाएँ।
स्टेप 2 — सही फ़ाइलें अपलोड करें
node_modules/ अपलोड करने की ज़रूरत नहीं। डिपेंडेंसी पैनल इंस्टॉल करता है। git या बिल्ड कैश की भी ज़रूरत नहीं।
अपने अकाउंट में अपलोड करें, बेहतर है public_html के बाहर किसी पाथ पर (जैसे /home/<account>/myapp/)। बाहर क्यों? क्योंकि Passenger public_html को अपने-आप URL के रूट पर लगा देता है, और ऐप का कोड वहाँ रखने से वह सबको दिख सकता है।
| फ़्रेमवर्क | ये अपलोड करें | ये छोड़ें |
|---|---|---|
| Next.js | .next/, public/, package.json, package-lock.json, next.config.js, आपकी server.cjs (नीचे) | node_modules/, .git/, .env.local |
| Nuxt 3 | .output/, package.json, package-lock.json, आपकी server.cjs (नीचे) | node_modules/, .nuxt/, .git/, सोर्स pages/, components/ |
फ़ाइलें पहुँचाने के दो तरीक़े:
- वेबसाइट → फ़ाइलें → zip अपलोड करें → एक्सट्रैक्ट करें — कनेक्शन कमज़ोर हो तो यह सबसे आसान है।
- SFTP (FileZilla, Cyberduck,
rsync) बार-बार डिप्लॉय करने के लिए तेज़ है। सर्वर, पोर्ट, यूज़र और पासवर्ड वेबसाइट → SSH और SFTP पर मिलते हैं।
स्टेप 3 — स्टार्टअप फ़ाइल जोड़ें
यह वह फ़ाइल है जिसे Passenger रिक्वेस्ट आने पर चलाता है। इसे ऐप फ़ोल्डर में package.json के बगल में रखें।
Next.js के लिए — server.cjs
const next = require('next')
const http = require('http')
const port = process.env.PORT || 3000
const dev = process.env.NODE_ENV !== 'production'
const app = next({ dev, dir: __dirname })
const handle = app.getRequestHandler()
app.prepare().then(() => {
http.createServer((req, res) => handle(req, res)).listen(port, () => {
console.log(`Next.js server listening on port ${port}`)
})
})यह क्या करती है:
- Next लोड करती है और उसे मौजूदा डायरेक्टरी पर पॉइंट करती है (जहाँ आपका
.next/औरpackage.jsonहै)। - Next के अंदरूनी राउटर से रिक्वेस्ट हैंडलर बनाती है।
- Passenger के दिए पोर्ट (
process.env.PORT) पर HTTP सर्वर चालू करती है। - लोकल टेस्टिंग के लिए
3000पर लौट आती है।
dev अपने-आप NODE_ENV से तय होता है — पैनल में Production मोड चुनें (यह स्टेप 4 में करेंगे) और Next प्रोडक्शन मोड में चलेगा।
Nuxt 3 के लिए — server.cjs
import('./.output/server/index.mjs').then(({ createApp }) => {
createApp().then(({ app }) => {
const port = process.env.PORT || 3000
app.listen(port, () => {
console.log(`Nuxt server listening on port ${port}`)
})
})
})यह क्या करती है:
- Nuxt की
.output/server/index.mjsको डायनैमिक तरीक़े से इम्पोर्ट करती है (npm run buildसे बनी एंट्री)। - H3 सर्वर बनाने के लिए
createApp()इस्तेमाल करती है। - Passenger के दिए पोर्ट पर सुनती है।
डायनैमिक import() जानबूझकर है — .mjs मॉड्यूल को require() नहीं किया जा सकता, लेकिन .cjs फ़ाइल उन्हें डायनैमिक तरीक़े से इम्पोर्ट कर सकती है। Passenger के लॉन्चर में चलने वाला यह सबसे साफ़ तरीक़ा है।
स्टेप 4 — पैनल में ऐप्लिकेशन बनाएँ
अपना प्रोजेक्ट खोलें → वेबसाइट → Node.js और Python → Node.js ऐप्लिकेशन।
| फ़ील्ड | वैल्यू |
|---|---|
| वर्ज़न | 20 या नया |
| मोड | Production |
| फ़ोल्डर | आपके होम फ़ोल्डर में myapp (जहाँ आपने फ़ाइलें अपलोड कीं) |
| पता | aapkadomain.in (या app.aapkadomain.in जैसा सबडोमेन) |
| स्टार्ट फ़ाइल | server.cjs |
बनाएँ पर क्लिक करें। ~/nodevenv/myapp/20/ में एक Node.js एनवायरनमेंट बनता है।
डिपेंडेंसी इंस्टॉल करें
ऐप बनने के बाद उस पर डिपेंडेंसी इंस्टॉल करें (npm install) पर क्लिक करें और आउटपुट देखें। अगर फ़ेल हो:
- देखें कि
package.jsonऐप्लिकेशन के रूट में है (किसी अंदर के फ़ोल्डर में नहीं)। - Next.js के लिए: पक्का करें कि
nextdependenciesमें है,devDependenciesमें नहीं (प्रोडक्शन इंस्टॉल dev डिपेंडेंसी छोड़ देता है)। - Nuxt के लिए:
nuxtभी सामान्य डिपेंडेंसी होनी चाहिए।
एनवायरनमेंट वेरिएबल जोड़ें
ऐप की सेटिंग्स → एनवायरनमेंट वेरिएबल → वेरिएबल जोड़ें। Production मोड पहले से NODE_ENV=production सेट करता है।
जो Next.js ऐप रनटाइम पर वैल्यू पढ़ते हैं (डेटाबेस URL, API की), उनके लिए उन्हें यहाँ जोड़ें। सीक्रेट वाली .env फ़ाइल अपलोड न करें — ऐप के एनवायरनमेंट वेरिएबल ही इसकी सही जगह हैं।
सेटिंग्स सेव करने पर ऐप रीस्टार्ट होता है, इसलिए नए वेरिएबल तुरंत लागू हो जाते हैं।
स्टेप 5 — जाँचें
अपने ऐप्लिकेशन का URL खोलें। आपको अपना ऐप दिखना चाहिए।
अगर Passenger का एरर पेज दिखे, तो उसे खोलकर नीचे देखें — वहाँ लगभग हमेशा साफ़ स्टैक ट्रेस होता है। दो सबसे आम एरर:
Error: Cannot find module 'next' — npm install नहीं चला, या ग़लत फ़ोल्डर में चला। डिपेंडेंसी इंस्टॉल करें (npm install) पर फिर से क्लिक करें।
Error: ENOENT: no such file or directory, open '.next/...' — आपने सोर्स अपलोड किया, लेकिन बिल्ड की हुई .next/ डायरेक्टरी नहीं। लोकल मशीन पर बिल्ड करके दोबारा अपलोड करें।
अपडेट कैसे डिप्लॉय करें
स्टेप 1 और 2 दोहराएँ और ऐप पर रीस्टार्ट क्लिक करें। यानी:
1. Build locally npm run build
2. Upload .next/ or .output/, plus any changed source/config
3. Panel Restart the appअगर package.json बदलें, तो रीस्टार्ट से पहले डिपेंडेंसी इंस्टॉल करें (npm install) पर क्लिक करें। कमांड लाइन पसंद है? वेबसाइट → टर्मिनल: ऐप कार्ड पर उसके एनवायरनमेंट में जाने की कमांड दिखती है।
आम दिक़्क़तें
WebSockets: Passenger HTTP/1.1 और HTTP/2 संभालता है। Next.js और Nuxt के बिल्ट-इन रूट पर WebSocket अपग्रेड काम करता है। अगर आप अलग WebSocket सर्वर (ws, socket.io) इस्तेमाल करते हैं, तो वह उसी पोर्ट पर चलता है और उसी server.cjs से शुरू होता है — कोई अतिरिक्त कॉन्फ़िग नहीं।
फ़ाइल अपलोड / next.config.js में body-parser लिमिट: Passenger की डिफ़ॉल्ट रिक्वेस्ट बॉडी लिमिट 10 MB है। अगर बड़ी फ़ाइलें अपलोड करते हैं, तो public_html में .htaccess से passenger_max_request_size बढ़ाएँ:
PassengerMaxRequestSize 52428800(बाइट में 50 MB।)
Cron जॉब: अगर ऐप को बैकग्राउंड काम चाहिए (न्यूज़लेटर भेजना, शेड्यूल्ड एक्सपोर्ट), तो उन्हें वेब प्रोसेस के अंदर न चलाएँ। Node स्क्रिप्ट सीधे चलाने के लिए वेबसाइट → Cron जॉब इस्तेमाल करें:
/home/<account>/nodevenv/myapp/20/bin/node /home/<account>/myapp/scripts/send-newsletter.jsप्रोसेस मेमोरी: अगर ऐप प्रति-अकाउंट RAM लिमिट (आपके प्लान पर निर्भर) से ज़्यादा ले, तो Passenger उसे रीस्टार्ट कर देता है। आम Next.js / Nuxt ऐप ख़ाली बैठे 100 MB से कम लेता है। अगर लिमिट छू रहे हैं, तो बड़ा प्लान मानने से पहले process.memoryUsage() से प्रोफ़ाइल करें और लीक ढूँढें।
कस्टम डोमेन और HTTPS: ऐप के लिए आप जो पता सेट करते हैं, Passenger उसी से जुड़ता है। SSL अपने-आप लगता है — कोई अतिरिक्त कॉन्फ़िग नहीं। किसी दूसरे डोमेन या सबडोमेन के लिए पहले उसे वेबसाइट → डोमेन में जोड़ें, फिर ऐप के पते के रूप में चुनें।
Node वर्ज़न: वर्ज़न लिस्ट में हर इंस्टॉल वर्ज़न दिखता है; इसे ऐप की सेटिंग्स में बदलें।
Node के लिए शेयर्ड होस्टिंग कब न चुनें
सीधी बात — शेयर्ड होस्टिंग पर Node.js पोर्टफ़ोलियो साइट, ब्लॉग, मार्केटिंग पेज, छोटे SaaS फ़्रंटएंड और अंदरूनी टूल के लिए बढ़िया चलता है। इनके लिए मुश्किल होती है:
- ज़्यादा लोड वाले API (>50 req/sec लगातार) — प्रति-अकाउंट CPU लिमिट महसूस होगी
- हज़ारों एक साथ कनेक्शन वाले WebSocket ऐप
- वर्कर प्रोसेस फ़ोर्क करने वाले ऐप (क्यू वर्कर, स्क्रेपर) — Passenger की प्रति-अकाउंट प्रोसेस सीमा इसे मुश्किल बनाती है
- जिसे भी systemd, Docker या root एक्सेस चाहिए
इनके लिए हमारा VPS सही है — पूरा root, अपना कर्नेल, जो चाहें चलाएँ। लेकिन जिन Next.js और Nuxt ऐप पर भारी ट्रैफ़िक नहीं है, उनके लिए यह गाइड काफ़ी है।
संक्षेप में
- लोकल मशीन पर
npm run build .next/(Next) या.output/(Nuxt) +package.json+server.cjsअपलोड करें- वेबसाइट → Node.js और Python → Node.js ऐप्लिकेशन → फ़ोल्डर, स्टार्ट फ़ाइल
server.cjs, मोड Production - डिपेंडेंसी इंस्टॉल करें (npm install), फिर रीस्टार्ट
कुछ भी गड़बड़ हो तो टिकट खोलें — Passenger का एरर पेज पेस्ट करें और हम बता देंगे कि दिक़्क़त किस लाइन में है।
— Rivervo टीम