Deploy aplikasi Node.js anda di hosting Rivervo (Next.js & Nuxt).
Ramai menyangka aplikasi Node.js mesti dijalankan di VPS. Sebenarnya tidak — setiap pelan shared hosting Rivervo mempunyai Node.js dan Python dalam menu laman web, yang menjalankan proses Phusion Passenger untuk aplikasi anda di belakang front-end Apache yang sama yang melayan laman web anda yang lain.
Panduan ini menerangkan keseluruhan aliran untuk dua framework paling popular: Next.js dan Nuxt 3. Hasil akhirnya: aplikasi anda di https://domainanda.com.my (atau mana-mana subdomain), berjalan pada proses Node.js sebenar, kekal selepas but semula, dan boleh dimulakan semula dengan satu klik.
Jika anda belum pernah deploy aplikasi Node ke shared hosting, bahagian yang biasanya menyukarkan semua orang ialah fail permulaan — Passenger memerlukan satu skrip masukan yang memulakan framework anda. Kami sediakan satu untuk setiap framework di bawah; salin dan tampal, tiada suntingan diperlukan.
Apa yang anda perlukan sebelum bermula
- Pelan hosting Rivervo (mana-mana peringkat — aplikasi Node.js berfungsi pada semua pelan)
- Node.js v20 atau lebih baharu di komputer anda untuk membina aplikasi
- Hasil binaan yang sedia untuk dimuat naik (kami terangkan mengikut framework)
- Akses ke Pengurus Fail atau SFTP untuk akaun anda (kedua-duanya boleh)
Anda tidak memerlukan root, sudo, systemd atau konfigurasi reverse proxy. Passenger mengendalikan semua itu.
Langkah 1 — Bina aplikasi anda secara tempatan
Anda akan memuat naik aplikasi yang sudah dibina, bukan kod sumber. Panel memasang kebergantungan tetapi tidak akan mengkompil React atau menjalankan binaan Vite. Lakukannya di komputer anda dahulu.
Next.js:
npm ci
npm run buildIni menghasilkan .next/ (output binaan). Jangan jalankan next start di sini — kita akan melancarkannya dari fail permulaan sebentar lagi.
Nuxt 3:
npm ci
npm run buildIni menghasilkan .output/ (direktori binaan universal Nuxt). Sama juga — jangan jalankan apa-apa lagi.
Langkah 2 — Muat naik fail yang betul
Anda tidak perlu memuat naik node_modules/. Panel memasang kebergantungan untuk anda. Anda juga tidak memerlukan git atau cache binaan.
Muat naik ke akaun anda, sebaik-baiknya ke laluan di luar public_html (contohnya /home/<account>/myapp/). Mengapa di luar? Kerana Passenger akan memasang public_html pada akar URL secara automatik, dan meletakkan kod aplikasi di situ akan mendedahkannya.
| Framework | Muat naik ini | Langkau |
|---|---|---|
| Next.js | .next/, public/, package.json, package-lock.json, next.config.js, server.cjs anda (di bawah) | node_modules/, .git/, .env.local |
| Nuxt 3 | .output/, package.json, package-lock.json, server.cjs anda (di bawah) | node_modules/, .nuxt/, .git/, sumber pages/, components/ |
Dua cara untuk menghantar fail ke sana:
- Laman web → Fail → muat naik zip → ekstrak ialah cara paling mudah jika sambungan anda tidak stabil.
- SFTP (FileZilla, Cyberduck,
rsync) lebih pantas untuk deploy berulang. Pelayan, port, nama pengguna dan kata laluan ada di Laman web → SSH dan SFTP.
Langkah 3 — Tambah fail permulaan
Inilah fail yang dijalankan oleh Passenger apabila permintaan masuk. Letakkannya di sebelah package.json dalam folder aplikasi anda.
Untuk 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}`)
})
})Apa yang dilakukannya:
- Memuatkan Next dan menghalakannya ke direktori semasa (tempat
.next/danpackage.jsonanda berada). - Membina pengendali permintaan daripada penghala dalaman Next.
- Memulakan pelayan HTTP pada port yang ditetapkan oleh Passenger (
process.env.PORT). - Menggunakan
3000sebagai sandaran untuk ujian tempatan.
dev ditentukan secara automatik daripada NODE_ENV — tetapkan mod Production dalam panel (kita akan lakukannya dalam Langkah 4) dan Next berjalan dalam mod produksi.
Untuk 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}`)
})
})
})Apa yang dilakukannya:
- Mengimport secara dinamik
.output/server/index.mjsNuxt (titik masukan yang dihasilkan olehnpm run build). - Menggunakan
createApp()untuk membina instans pelayan H3. - Mendengar pada port yang ditetapkan oleh Passenger.
import() dinamik itu disengajakan — modul .mjs tidak boleh di-require(), tetapi fail .cjs boleh mengimportnya secara dinamik. Inilah corak paling kemas yang berfungsi dalam pelancar Passenger.
Langkah 4 — Cipta aplikasi dalam panel
Buka projek anda → Laman web → Node.js dan Python → Aplikasi Node.js.
| Medan | Nilai |
|---|---|
| Versi | 20 atau lebih baharu |
| Mod | Production |
| Folder | myapp dalam folder utama anda (tempat anda memuat naik fail) |
| Alamat | domainanda.com.my (atau subdomain seperti app.domainanda.com.my) |
| Fail permulaan | server.cjs |
Klik Cipta. Persekitaran Node.js dibuat di bawah ~/nodevenv/myapp/20/.
Pasang kebergantungan
Selepas aplikasi dicipta, klik Pasang kebergantungan (npm install) padanya dan perhatikan output. Jika gagal:
- Pastikan
package.jsonberada di akar aplikasi (bukan dalam subfolder). - Untuk Next.js: pastikan
nextberada dalamdependencies, bukandevDependencies(pemasangan produksi melangkau kebergantungan dev). - Untuk Nuxt:
nuxtsendiri juga perlu menjadi kebergantungan biasa.
Tambah pemboleh ubah persekitaran
Tetapan aplikasi → Pemboleh ubah persekitaran → Tambah pemboleh ubah. Mod Production sudah menetapkan NODE_ENV=production.
Untuk aplikasi Next.js yang membaca nilai semasa runtime (URL pangkalan data, kunci API), tambahkannya di sini. Jangan sertakan fail .env yang mengandungi rahsia — pemboleh ubah persekitaran aplikasi ialah tempat yang betul.
Menyimpan tetapan akan memulakan semula aplikasi, jadi pemboleh ubah baharu berkuat kuasa serta-merta.
Langkah 5 — Sahkan
Lawati URL aplikasi anda. Anda sepatutnya melihat aplikasi anda.
Jika anda melihat halaman ralat Passenger, kembangkannya dan lihat bahagian bawah — hampir selalu ada stack trace yang jelas. Dua yang paling biasa:
Error: Cannot find module 'next' — npm install tidak dijalankan, atau dijalankan dalam folder yang salah. Klik Pasang kebergantungan (npm install) sekali lagi.
Error: ENOENT: no such file or directory, open '.next/...' — anda memuat naik kod sumber tetapi bukan direktori .next/ yang sudah dibina. Bina secara tempatan dan muat naik semula.
Cara deploy kemas kini
Ulang langkah 1 dan 2, kemudian klik Mulakan semula pada aplikasi. Secara khusus:
1. Bina secara tempatan npm run build
2. Muat naik .next/ atau .output/, serta sebarang sumber/konfigurasi yang berubah
3. Panel Mulakan semula aplikasiJika anda menukar package.json, klik Pasang kebergantungan (npm install) sebelum memulakan semula. Lebih suka baris arahan? Laman web → Terminal: kad aplikasi menunjukkan arahan untuk masuk ke persekitarannya.
Perangkap biasa
WebSockets: Passenger mengendalikan HTTP/1.1 dan HTTP/2. Naik taraf WebSocket berfungsi untuk laluan terbina dalam Next.js dan Nuxt. Jika anda menggunakan pelayan WebSocket berasingan (ws, socket.io), ia berkongsi port yang sama dan dimulakan melalui server.cjs yang sama — tiada konfigurasi tambahan.
Muat naik fail / had body-parser dalam next.config.js: Had saiz badan permintaan lalai Passenger ialah 10 MB. Jika anda memuat naik fail besar, tetapkan passenger_max_request_size lebih tinggi melalui .htaccess dalam public_html:
PassengerMaxRequestSize 52428800(50 MB dalam bait.)
Tugas cron: jika aplikasi anda memerlukan tugas latar belakang (penghantaran buletin, eksport berjadual), jangan jalankannya dalam proses web. Gunakan Laman web → Tugas cron untuk memanggil skrip Node secara terus:
/home/<account>/nodevenv/myapp/20/bin/node /home/<account>/myapp/scripts/send-newsletter.jsMemori proses: Passenger memulakan semula aplikasi anda jika ia melebihi had RAM setiap akaun (bergantung pada pelan anda). Untuk aplikasi Next.js / Nuxt biasa, penggunaan semasa melahu adalah di bawah 100 MB. Jika anda mencapai had, profilkan dengan process.memoryUsage() dan cari kebocoran sebelum menganggap anda memerlukan pelan yang lebih besar.
Domain tersuai dan HTTPS: alamat yang anda tetapkan untuk aplikasi ialah apa yang diikat oleh Passenger. SSL adalah automatik — tiada konfigurasi tambahan. Untuk domain lain atau subdomain, tambahkannya di Laman web → Domain terlebih dahulu, kemudian pilih sebagai alamat aplikasi.
Versi Node: senarai Versi menunjukkan setiap versi yang dipasang; tukarnya dalam Tetapan aplikasi.
Bila tidak patut menggunakan shared hosting untuk Node
Secara terus terang — Node.js di shared hosting berfungsi dengan baik untuk laman web portfolio, blog, halaman pemasaran, front-end SaaS kecil dan alat dalaman. Ia kurang sesuai untuk:
- API berkapasiti tinggi (>50 permintaan/saat secara berterusan) — anda akan terasa had CPU setiap akaun
- Aplikasi yang banyak menggunakan WebSocket dengan ribuan sambungan serentak
- Aplikasi yang mencabang proses pekerja (pekerja baris gilir, scraper) — had proses setiap akaun Passenger menyukarkan perkara ini
- Apa-apa yang memerlukan systemd, Docker atau akses root
Untuk semua itu, VPS kami ialah pilihan yang tepat — root penuh, kernel anda sendiri, jalankan apa sahaja yang anda mahu. Tetapi untuk kebanyakan aplikasi Next.js dan Nuxt yang tidak menerima trafik yang sangat besar, panduan ini sudah mencukupi.
Ringkasnya
npm run buildsecara tempatan- Muat naik
.next/(Next) atau.output/(Nuxt) +package.json+server.cjs - Laman web → Node.js dan Python → Aplikasi Node.js → folder, fail permulaan
server.cjs, mod Production - Pasang kebergantungan (npm install), kemudian Mulakan semula
Jika ada yang tidak kena, buka tiket — tampal halaman ralat Passenger dan kami akan tunjukkan baris yang bermasalah.
— Pasukan Rivervo