Mulakan
Semua artikelTUTORIAL · 7 MIN BACAAN

Deploy aplikasi Node.js anda di hosting Rivervo (Next.js & Nuxt).

RT
Rivervo Team · Rivervo
·
29 April 2026
·
Dikemas kini 13 November 2026
Node
ON SHARED HOSTING

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 build

Ini menghasilkan .next/ (output binaan). Jangan jalankan next start di sini — kita akan melancarkannya dari fail permulaan sebentar lagi.

Nuxt 3:

npm ci
npm run build

Ini 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.

FrameworkMuat naik iniLangkau
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/ dan package.json anda berada).
  • Membina pengendali permintaan daripada penghala dalaman Next.
  • Memulakan pelayan HTTP pada port yang ditetapkan oleh Passenger (process.env.PORT).
  • Menggunakan 3000 sebagai 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.mjs Nuxt (titik masukan yang dihasilkan oleh npm 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.

MedanNilai
Versi20 atau lebih baharu
ModProduction
Foldermyapp dalam folder utama anda (tempat anda memuat naik fail)
Alamatdomainanda.com.my (atau subdomain seperti app.domainanda.com.my)
Fail permulaanserver.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.json berada di akar aplikasi (bukan dalam subfolder).
  • Untuk Next.js: pastikan next berada dalam dependencies, bukan devDependencies (pemasangan produksi melangkau kebergantungan dev).
  • Untuk Nuxt: nuxt sendiri 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 aplikasi

Jika 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.js

Memori 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

  1. npm run build secara tempatan
  2. Muat naik .next/ (Next) atau .output/ (Nuxt) + package.json + server.cjs
  3. Laman web → Node.js dan Python → Aplikasi Node.js → folder, fail permulaan server.cjs, mod Production
  4. 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