هاست Nuxt با رندر سمت سرور

Nuxt و Nitro روی یک سرور

وجود وابستگی nuxt کافی است تا پروژه Nuxt شناخته شود. nuxt build خروجی کامل سرور را در .output می‌سازد و فقط همین پوشه به ایمیج نهایی می‌رود، پس node_modules توسعه همراه برنامه منتشر نمی‌شود.

Nitro متغیرهای PORT و HOST را خودش می‌خواند. با preset پیش‌فرض node-server، صفحه‌های SSR، مسیرهای server/api و میدل‌ورها روی همان سرور اجرا می‌شوند.

مسیر بیلد Nuxt

1. تشخیص

   وابستگی nuxt و لاک‌فایل در ریشه.

   "nuxt": "^3"

2. نصب

   پکیج‌منیجر از روی لاک‌فایل انتخاب می‌شود.

   npm ci

3. بیلد

   خروجی سرور و فایل‌های عمومی در .output ساخته می‌شود.

   nuxt build

4. اجرا

   سرور Nitro اجرا می‌شود.

   node .output/server/index.mjs

خروجی یک استقرار واقعی

$ sakoocloud deploy
✔ Packed 2.1MB
✔ Source uploaded
ℹ Build started · dep_7k2m9q
#4 [builder 1/5] FROM node:22-alpine
#6 [builder 3/5] RUN npm ci
#8 [builder 4/5] RUN npm run build
#10 [stage-1 2/3] COPY .output ./.output
#12 exporting to image
✔ Deployed — app is running.
→ https://my-nuxt.sakooapps.ir

تنظیم پیشنهادی

preset را روی node-server نگه دارید و اسکریپت start را به خروجی Nitro اشاره دهید.

export default defineNuxtConfig({
  nitro: {
    preset: "node-server",
  },
});

{
  "scripts": {
    "build": "nuxt build",
    "start": "node .output/server/index.mjs"
  }
}

sakoocloud apps create --name my-nuxt --runtime nuxt --port 3000
sakoocloud deploy

تنظیمات

اتصال به دیتابیس

دیتابیس را به اپ لینک کنید؛ متغیرهای DATABASE_URL، DATABASE_HOST و بقیه به محیط اپ تزریق می‌شوند و اپ دوباره مستقر می‌شود. رمز عبور هیچ‌جا در کد نمی‌آید.

sakoocloud apps link-db <db-id> --app my-app

import pg from "pg";

export const pool = new pg.Pool({
  connectionString: process.env.DATABASE_URL,
});

datasource db {
  provider = "postgresql"
  url      = env("DATABASE_URL")
}

همراه هر استقرار

این‌ها به رانتایم بستگی ندارند و برای هر اپ روی سکو کلود فعال‌اند. بعضی، مثل مقیاس‌دهی خودکار و کران‌جاب، به پلن بستگی دارند.

• دامنه‌ی اختصاصی و SSLدامنه را اضافه کنید؛ گواهی خودکار صادر و تمدید می‌شود.
• متغیرهای محیطی و سکرتمقادیر رمزگذاری‌شده فقط در زمان اجرا به اپ می‌رسند.
• مرحله‌ی انتشارmigration بعد از بیلد و پیش از جایگزینی نسخه‌ی قبلی اجرا می‌شود.
• لاگ زندهلاگ بیلد و زمان اجرا، در CLI و کنسول.
• بازگشت به نسخه‌ی قبلهر استقرار قبلی با یک دستور برمی‌گردد.
• مقیاس‌دهیمنابع و تعداد نمونه‌ها را تغییر دهید یا خودکارش کنید.
• دیسک ماندگاربرای فایل‌هایی که باید بعد از هر استقرار بمانند.
• کران‌جابدستور زمان‌بندی‌شده با همان ایمیج و متغیرها.
• استقرار خودکار با گیتهر push روی شاخه‌ی هدف بیلد و مستقر می‌شود.

خطاهای رایج

HOST=0.0.0.0

sakoocloud apps scale --memory 1Gi

پرسش‌های متداول

جزئیات بیشتر در راهنمای Nuxt در مستندات و مرجع CLI.