هاست Node.js برای API و سرویس‌های جاوااسکریپت

از package.json تا آدرس زنده

برای اجرای یک سرویس Node.js معمولاً باید سرور آماده کنید، نسخه‌ی Node را نصب کنید، PM2 یا systemd را تنظیم کنید و گواهی SSL بگیرید. در سکو کلود همه‌ی این‌ها از روی خود پروژه تعیین می‌شود: نسخه از .nvmrc یا engines، پکیج‌منیجر از لاک‌فایل، و دستور اجرا از اسکریپت start.

Express، Fastify، Koa، NestJS و هر سرور HTTP دیگری که روی پورت PORT گوش بدهد بدون تغییر اجرا می‌شود. پروژه‌های TypeScript هم پشتیبانی می‌شوند: اسکریپت build اجرا می‌شود و فقط خروجی کامپایل‌شده و node_modules به ایمیج نهایی می‌رود.

سکو کلود با پروژه‌ی شما چه می‌کند

1. تشخیص

   package.json و یکی از لاک‌فایل‌ها در ریشه یعنی Node.js. اگر Dockerfile در ریشه باشد، همان اولویت دارد.

   package.json · package-lock.json

2. نصب

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

   npm ci

3. بیلد

   اگر اسکریپت build تعریف شده باشد اجرا می‌شود؛ مثلاً کامپایل TypeScript.

   npm run build

4. اجرا

   اسکریپت start اجرا می‌شود و ترافیک HTTPS به پورت PORT می‌رسد.

   npm start

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

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

کمترین چیزی که لازم دارید

دو قانون: برنامه روی پورتی که در PORT می‌آید و روی 0.0.0.0 گوش بدهد، و package.json اسکریپت start داشته باشد.

import express from "express";

const app = express();
const port = process.env.PORT || 3000;

app.get("/health", (req, res) => res.json({ ok: true }));

app.listen(port, "0.0.0.0", () => {
  console.log(`listening on ${port}`);
});

{
  "type": "module",
  "scripts": {
    "start": "node index.js"
  },
  "engines": { "node": "22.x" }
}

sakoocloud apps create --name my-api --runtime nodejs --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 روی شاخه‌ی هدف بیلد و مستقر می‌شود.

خطاهای رایج

app.listen(process.env.PORT || 3000, "0.0.0.0");

sakoocloud apps scale --memory 1Gi

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

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