เริ่มต้นใช้งาน
บทความทั้งหมดบทแนะนำ · 4 นาทีในการอ่าน

Deploy แอป Node.js บนโฮสติ้ง Rivervo (Next.js และ Nuxt)

RT
Rivervo Team · Rivervo
·
29 เมษายน 2569
·
อัปเดตเมื่อ 13 พฤศจิกายน 2569
Node
ON SHARED HOSTING

หลายคนคิดว่าแอป Node.js ต้องอยู่บน VPS ไม่จำเป็นเลย — ทุกแพ็กเกจโฮสติ้งแบบแชร์ของ Rivervo มี Node.js และ Python ในเมนูเว็บไซต์ ซึ่งจะเปิดโปรเซส Phusion Passenger สำหรับแอปของคุณ อยู่หลัง Apache ตัวเดียวกับที่ให้บริการเว็บไซต์อื่นๆ ของคุณ

คู่มือนี้พาไล่ขั้นตอนทั้งหมดสำหรับสองเฟรมเวิร์กที่ใช้กันมากที่สุด: Next.js และ Nuxt 3 ผลลัพธ์สุดท้าย: แอปของคุณที่ https://domainkhongkhun.com (หรือซับโดเมนใดก็ได้) ทำงานบนโปรเซส Node.js จริง อยู่รอดหลังรีบูต และรีสตาร์ตได้ในคลิกเดียว

ถ้าคุณไม่เคย deploy แอป Node บนโฮสติ้งแบบแชร์มาก่อน จุดที่ทุกคนติดคือ ไฟล์เริ่มต้น — Passenger ต้องการสคริปต์เริ่มต้นตัวเดียวที่บูตเฟรมเวิร์กของคุณ เราเตรียมไว้ให้สำหรับแต่ละเฟรมเวิร์กด้านล่าง คัดลอกไปวางได้เลย ไม่ต้องแก้ไข

สิ่งที่ต้องมีก่อนเริ่ม

  • แพ็กเกจโฮสติ้ง Rivervo (แพ็กเกจใดก็ได้ — แอป Node.js ใช้ได้ทุกแพ็กเกจ)
  • Node.js v20 ขึ้นไป ในเครื่องเพื่อ build แอป
  • ผลลัพธ์ที่ build แล้ว พร้อมอัปโหลด (เราจะอธิบายแยกตามเฟรมเวิร์ก)
  • การเข้าถึงบัญชีผ่าน File Manager หรือ SFTP (ได้ทั้งสองแบบ)

คุณ ไม่ ต้องใช้ root, sudo, systemd หรือการตั้งค่า reverse proxy Passenger จัดการทั้งหมดให้

ขั้นที่ 1 — Build แอปในเครื่อง

คุณจะอัปโหลดแอปที่ build แล้ว ไม่ใช่ซอร์สโค้ด แผงควบคุมติดตั้ง dependency ให้ แต่จะไม่คอมไพล์ React หรือรัน Vite build ให้ ทำขั้นนั้นบนเครื่องของคุณก่อน

Next.js:

npm ci
npm run build

จะได้ .next/ (ผลลัพธ์ที่ build แล้ว) อย่ารัน next start ตรงนี้ — เราจะเปิดจากไฟล์เริ่มต้นในอีกสักครู่

Nuxt 3:

npm ci
npm run build

จะได้ .output/ (ไดเรกทอรี build แบบ universal ของ Nuxt) เหมือนกัน — ยังไม่ต้องรันอะไร

ขั้นที่ 2 — อัปโหลดไฟล์ที่ถูกต้อง

คุณไม่ต้องอัปโหลด node_modules/ แผงควบคุมติดตั้ง dependency ให้ และไม่ต้องอัปโหลด git หรือแคชจากการ build

อัปโหลดไปที่บัญชีของคุณ ทางที่ดีคือพาธที่อยู่ นอก 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) เร็วกว่าสำหรับการ deploy ซ้ำ เซิร์ฟเวอร์ พอร์ต ชื่อผู้ใช้ และรหัสผ่านอยู่ใน เว็บไซต์ → 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 ของคุณ)
  • สร้างตัวจัดการคำขอจาก router ภายในของ Next
  • เปิด HTTP server บนพอร์ตที่ Passenger กำหนด (process.env.PORT)
  • ใช้ 3000 แทนสำหรับการทดสอบในเครื่อง

dev คำนวณจาก NODE_ENV โดยอัตโนมัติ — ตั้งโหมด Production ในแผงควบคุม (เราจะทำในขั้นที่ 4) แล้ว Next จะทำงานในโหมด production

สำหรับ 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}`)
    })
  })
})

ไฟล์นี้ทำอะไร:

  • import .output/server/index.mjs ของ Nuxt แบบไดนามิก (entry ที่ได้จาก npm run build)
  • ใช้ createApp() สร้างอินสแตนซ์ของเซิร์ฟเวอร์ H3
  • รอรับคำขอบนพอร์ตที่ Passenger กำหนด

การใช้ import() แบบไดนามิกเป็นความตั้งใจ — โมดูล .mjs ใช้ require() ไม่ได้ แต่ไฟล์ .cjs import แบบไดนามิกได้ นี่คือรูปแบบที่เรียบร้อยที่สุดที่ทำงานได้ภายในตัวเปิดแอปของ Passenger

ขั้นที่ 4 — สร้างแอปพลิเคชันในแผงควบคุม

เปิดโปรเจกต์ของคุณ → เว็บไซต์ → Node.js และ Python → แอปพลิเคชัน Node.js

ช่องค่า
เวอร์ชัน20 ขึ้นไป
โหมดProduction
โฟลเดอร์myapp ในโฟลเดอร์หลักของคุณ (ที่คุณอัปโหลดไฟล์ไว้)
ที่อยู่domainkhongkhun.com (หรือซับโดเมนอย่าง app.domainkhongkhun.com)
ไฟล์เริ่มต้นserver.cjs

คลิก สร้าง สภาพแวดล้อม Node.js จะถูกสร้างไว้ที่ ~/nodevenv/myapp/20/

ติดตั้ง dependency

เมื่อสร้างแอปแล้ว คลิก ติดตั้ง dependency (npm install) ที่แอปและดูผลลัพธ์ ถ้าล้มเหลว:

  • ตรวจสอบว่า package.json อยู่ที่รากของแอปพลิเคชัน (ไม่ได้ซ้อนอยู่ในโฟลเดอร์ย่อย)
  • สำหรับ Next.js: ยืนยันว่า next อยู่ใน dependencies ไม่ใช่ devDependencies (การติดตั้งแบบ production จะข้าม dev dependency)
  • สำหรับ Nuxt: nuxt เองก็ควรเป็น dependency ปกติเช่นกัน

เพิ่มตัวแปรสภาพแวดล้อม

การตั้งค่า ของแอป → ตัวแปรสภาพแวดล้อม → เพิ่มตัวแปร โหมด Production ตั้ง NODE_ENV=production ไว้ให้แล้ว

สำหรับแอป Next.js ที่อ่านค่าตอนรัน (URL ฐานข้อมูล คีย์ API) ให้เพิ่มไว้ที่นี่ อย่าส่งไฟล์ .env ที่มีข้อมูลลับขึ้นไป — ตัวแปรสภาพแวดล้อมของแอปคือที่ที่ถูกต้อง

การบันทึกการตั้งค่าจะรีสตาร์ตแอป ตัวแปรใหม่จึงมีผลทันที

ขั้นที่ 5 — ตรวจสอบ

เปิด URL ของแอปพลิเคชัน คุณควรเห็นแอปของคุณ

ถ้าเห็นหน้าข้อผิดพลาดของ Passenger ให้ขยายดูแล้วเลื่อนไปด้านล่าง — เกือบทุกครั้งจะมี stack trace ที่ชัดเจน สองกรณีที่พบบ่อยที่สุด:

Error: Cannot find module 'next' — npm install ไม่ได้รัน หรือรันผิดโฟลเดอร์ คลิก ติดตั้ง dependency (npm install) อีกครั้ง

Error: ENOENT: no such file or directory, open '.next/...' — คุณอัปโหลดซอร์สแต่ไม่ได้อัปโหลดไดเรกทอรี .next/ ที่ build แล้ว build ในเครื่องแล้วอัปโหลดใหม่

วิธี deploy อัปเดต

ทำขั้นที่ 1, 2 ซ้ำ แล้วคลิก รีสตาร์ต ที่แอป โดยละเอียด:

1. Build ในเครื่อง    npm run build
2. อัปโหลด          .next/ หรือ .output/ รวมถึงซอร์ส/คอนฟิกที่เปลี่ยน
3. แผงควบคุม          รีสตาร์ตแอป

ถ้าคุณเปลี่ยน package.json ให้คลิก ติดตั้ง dependency (npm install) ก่อนรีสตาร์ต ชอบใช้บรรทัดคำสั่งมากกว่าใช่ไหม เว็บไซต์ → เทอร์มินัล: การ์ดของแอปจะแสดงคำสั่งสำหรับเข้าสู่สภาพแวดล้อมของแอป

ปัญหาที่พบบ่อย

WebSockets: Passenger รองรับ HTTP/1.1 และ HTTP/2 การอัปเกรดเป็น WebSocket ใช้ได้กับ route ในตัวของ Next.js และ Nuxt ถ้าคุณใช้เซิร์ฟเวอร์ WebSocket แยก (ws, socket.io) จะใช้พอร์ตเดียวกันและเริ่มผ่าน server.cjs ตัวเดียวกัน — ไม่ต้องตั้งค่าเพิ่ม

การอัปโหลดไฟล์ / ขีดจำกัด body-parser ใน next.config.js: ขีดจำกัดขนาดเนื้อหาคำขอเริ่มต้นของ Passenger คือ 10 MB ถ้าคุณอัปโหลดไฟล์ขนาดใหญ่ ให้ตั้ง passenger_max_request_size ให้สูงขึ้นผ่าน .htaccess ใน public_html:

PassengerMaxRequestSize 52428800

(50 MB ในหน่วยไบต์)

Cron jobs: ถ้าแอปต้องการงานเบื้องหลัง (ส่งจดหมายข่าว ส่งออกข้อมูลตามกำหนด) อย่ารันไว้ในโปรเซสเว็บ ใช้ เว็บไซต์ → Cron jobs เรียกสคริปต์ Node โดยตรง:

/home/<account>/nodevenv/myapp/20/bin/node /home/<account>/myapp/scripts/send-newsletter.js

หน่วยความจำของโปรเซส: Passenger จะรีสตาร์ตแอปถ้าใช้ RAM เกินเพดานต่อบัญชี (ขึ้นอยู่กับแพ็กเกจ) สำหรับแอป Next.js / Nuxt ทั่วไป ตอนว่างใช้ไม่ถึง 100 MB ถ้าคุณชนเพดาน ให้ profile ด้วย process.memoryUsage() และหา memory leak ก่อนจะสรุปว่าต้องใช้แพ็กเกจที่ใหญ่ขึ้น

โดเมนของคุณเองและ HTTPS: ที่อยู่ที่คุณตั้งให้แอปคือสิ่งที่ Passenger ผูกไว้ SSL เป็นอัตโนมัติ — ไม่ต้องตั้งค่าเพิ่ม ถ้าต้องการโดเมนอื่นหรือซับโดเมน ให้เพิ่มใน เว็บไซต์ → โดเมน ก่อน แล้วเลือกเป็นที่อยู่ของแอป

เวอร์ชัน Node: รายการ เวอร์ชัน แสดงทุกเวอร์ชันที่ติดตั้งไว้ เปลี่ยนได้ใน การตั้งค่า ของแอป

เมื่อไร ไม่ควร ใช้โฮสติ้งแบบแชร์สำหรับ Node

พูดกันตรงๆ — Node.js บนโฮสติ้งแบบแชร์ทำงานได้ดีมากสำหรับเว็บไซต์พอร์ตโฟลิโอ บล็อก หน้าการตลาด ฟรอนต์เอนด์ SaaS ขนาดเล็ก และเครื่องมือภายใน แต่จะลำบากกับ:

  • API ที่มีปริมาณงานสูง (>50 req/sec ต่อเนื่อง) — คุณจะรู้สึกถึงเพดาน CPU ต่อบัญชี
  • แอปที่ใช้ WebSocket หนักๆ มีการเชื่อมต่อพร้อมกันนับพัน
  • แอปที่ fork โปรเซสทำงาน (queue worker, scraper) — งบโปรเซสต่อบัญชีของ Passenger ทำให้ไม่สะดวก
  • อะไรก็ตามที่ต้องใช้ systemd, Docker หรือสิทธิ์ root

สำหรับกรณีเหล่านั้น VPS ของเราคือทางเลือกที่ถูกต้อง — root เต็มรูปแบบ เคอร์เนลของคุณเอง รันอะไรก็ได้ตามต้องการ แต่สำหรับแอป Next.js และ Nuxt ส่วนใหญ่ที่ไม่ได้รับทราฟฟิกมหาศาล คู่มือนี้คือทั้งหมดที่คุณต้องใช้

สรุปสั้นๆ

  1. npm run build ในเครื่อง
  2. อัปโหลด .next/ (Next) หรือ .output/ (Nuxt) + package.json + server.cjs
  3. เว็บไซต์ → Node.js และ Python → แอปพลิเคชัน Node.js → โฟลเดอร์ ไฟล์เริ่มต้น server.cjs โหมด Production
  4. ติดตั้ง dependency (npm install) แล้ว รีสตาร์ต

ถ้ามีอะไรผิดปกติ เปิดทิกเก็ต — วางหน้าข้อผิดพลาดของ Passenger มา แล้วเราจะชี้บรรทัดที่เป็นปัญหาให้

— ทีม Rivervo