เริ่มต้นใช้งาน

แอปพลิเคชัน Node.js, Next.js และ Nuxt

วิธีที่ระบบตรวจจับและเริ่มโปรเจกต์ Node.js: เวอร์ชัน Node, package manager, Next.js และ Nuxt (แบบเซิร์ฟเวอร์หรือสแตติก), SvelteKit, Astro, Express และอื่น ๆ, ตัวแปร PORT และ migration ของ Prisma

2 นาทีในการอ่าน

รีโพสิทอรีที่มี package.json คือโปรเจกต์ Node.js เราเลือกเฟรมเวิร์ก package manager และเวอร์ชัน Node ให้ แล้ว build และเริ่มทำงาน คุณแค่ push โค้ด

เวอร์ชัน Node และ package manager

  • Node.js — อ่านจาก engines.node ใน package.json หรือจาก .nvmrc โดยใช้เวอร์ชันใหม่ที่สุดใน 24, 22, 20, 18 หรือ 16 ที่ตรงเงื่อนไข หากไม่มีทั้งสองอย่าง จะใช้ Node.js 22
  • Package manager — ดูจาก lock file: pnpm-lock.yaml → pnpm, yarn.lock → yarn นอกนั้นใช้ npm (npm ci เมื่อมี package-lock.json)
  • Build — สคริปต์ build หาก package.json มี

เฟรมเวิร์ก

เฟรมเวิร์กวิธีรัน
Next.jsเป็นเซิร์ฟเวอร์ (next start) — server rendering, API routes และ middleware ทำงานตามปกติ
Next.js ที่มี output: 'export'เป็นเว็บไซต์สแตติกจาก out
Nuxtเป็นเซิร์ฟเวอร์ (.output/server/index.mjs)
Nuxt ที่มี ssr: false และสคริปต์ generateเป็นเว็บไซต์สแตติกจาก .output/public
SvelteKitเป็นเซิร์ฟเวอร์ด้วย adapter-node หากใช้ adapter-static จะเป็นเว็บไซต์สแตติก
Astroเป็นเว็บไซต์สแตติก หากใช้ @astrojs/node จะเป็นเซิร์ฟเวอร์
NestJSdist/main.js หลัง build
Express, Fastify, Koa, Hono และเซิร์ฟเวอร์อื่น ๆไฟล์ใน scripts.start (node server.js) ถ้าไม่มีใช้ main ถ้าไม่มีอีกใช้ server.js, app.js, index.js หรือ main.js

โปรเจกต์ที่มีแต่ front-end เช่น Vite, Create React App, Angular, Vue CLI และอื่น ๆ จะให้บริการเป็นเว็บไซต์สแตติก ดูเพิ่มเติมที่ เว็บไซต์สแตติก

รอรับที่ PORT

เซิร์ฟเวอร์ต้องรอรับการเชื่อมต่อที่พอร์ตในตัวแปร PORT บนทุก interface:

const port = process.env.PORT || 3000
app.listen(port, '0.0.0.0')

Next.js และ Nuxt ทำส่วนนี้ให้เอง หากแอปพลิเคชันของคุณรอรับที่พอร์ตตายตัว จะไม่ได้รับผู้เข้าชม การ deploy จะหยุดที่การตรวจสอบตอนเริ่มทำงาน และเวอร์ชันก่อนหน้าจะยังทำงานต่อไป

ค่าที่ใช้ตอน build

ตัวแปรจากแท็บ ตัวแปร ส่งถึงแอปพลิเคชันขณะทำงาน ไม่ใช่ตอน build ค่าที่การ build เขียนลงในโค้ดฝั่ง client เช่น NEXT_PUBLIC_… ใน Next.js หรือ VITE_… จะอ่านจากรีโพสิทอรีของคุณ เช่น จากไฟล์ .env.production ที่ commit ไว้ ส่วนโค้ดฝั่งเซิร์ฟเวอร์อ่านค่าจากแท็บ ตัวแปร ตามปกติ

คำสั่งเริ่มต้นของคุณเอง

หากวิธีเริ่มที่ระบบตรวจพบไม่ใช่สิ่งที่คุณต้องการ ให้ตั้ง การตั้งค่า → การตั้งค่า build → คำสั่งเริ่มต้น เช่น node dist/server.js หรือ npm run start:prod คำสั่งติดตั้งและคำสั่ง build ก็เปลี่ยนได้ที่นั่นเช่นกัน

ฐานข้อมูลและ Prisma

เพิ่ม PostgreSQL หรือ MySQL ให้โปรเจกต์ แล้วอ่าน DATABASE_URL ซึ่งตั้งไว้ให้แล้ว หากมี Prisma ใน dependencies คำสั่ง release ที่แนะนำคือ npx prisma migrate deploy ซึ่งรันในทุกการ deploy ก่อนที่เวอร์ชันใหม่จะเริ่มรับผู้เข้าชม ดูเพิ่มเติมที่ การ deploy

สำหรับคิวด้วย BullMQ ให้เพิ่ม Valkey แล้วใช้ REDIS_URL รัน queue worker เป็น background worker ที่แท็บ โปรเซส หรือเป็นเซอร์วิสแยกที่มีทรัพยากรของตัวเอง ดูเพิ่มเติมที่ เซอร์วิสของโปรเจกต์

ไฟล์ที่คงอยู่ข้ามการ deploy

ทุกการ deploy เริ่มจากสำเนาใหม่ของรีโพสิทอรี ไฟล์ที่แอปพลิเคชันเขียนลงใน /data จะคงอยู่ข้ามการ deploy และสำรองข้อมูลทุกวัน ส่วนไฟล์ที่เขียนไว้ที่อื่นจะหายไปหลัง deploy ครั้งถัดไป สำหรับไฟล์อัปโหลดและสื่อ object storage มักเป็นตัวเลือกที่ดีกว่า

Monorepo

สำหรับรีโพสิทอรีที่มีหลายโปรเจกต์ ให้ตั้ง โฟลเดอร์โปรเจกต์ ตอนสร้างแอปพลิเคชัน (เช่น apps/web) โฟลเดอร์อื่นในรีโพสิทอรีเดียวกันรันเป็นเว็บเซอร์วิสแยกได้ ดูที่ เซอร์วิสของโปรเจกต์

ยังติดปัญหาอยู่ใช่ไหม

แชทกับเรา AI ตอบทันที และวิศวกรจะเข้ามาช่วยเมื่อจำเป็น ได้ทุกเวลา

ติดต่อฝ่ายซัพพอร์ต