หลายคนคิดว่าแอป 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 ส่วนใหญ่ที่ไม่ได้รับทราฟฟิกมหาศาล คู่มือนี้คือทั้งหมดที่คุณต้องใช้
สรุปสั้นๆ
npm run buildในเครื่อง- อัปโหลด
.next/(Next) หรือ.output/(Nuxt) +package.json+server.cjs - เว็บไซต์ → Node.js และ Python → แอปพลิเคชัน Node.js → โฟลเดอร์ ไฟล์เริ่มต้น
server.cjsโหมด Production - ติดตั้ง dependency (npm install) แล้ว รีสตาร์ต
ถ้ามีอะไรผิดปกติ เปิดทิกเก็ต — วางหน้าข้อผิดพลาดของ Passenger มา แล้วเราจะชี้บรรทัดที่เป็นปัญหาให้
— ทีม Rivervo