نسخهٔ آمادهٔ n8n Cloud برای شروع خوب است، اما وقتی گردش‌کارها به داده و اعتبارنامهٔ حساس وصل می‌شوند، ترجیح می‌دهم همه‌چیز روی سرور خودم باشد. این لاگ همان راه‌اندازی است که روی سرورهای مشتری‌ها استفاده می‌کنم: n8n پشت یک پایگاه‌دادهٔ Postgres، با دادهٔ ماندگار و قابل‌بکاپ — نه SQLite که با یک ری‌استارت اشتباه از دست برود.

پیش‌نیازها

• سروری با docker و docker compose (هر VPS لینوکسی کافی است)
• یک دامنه یا زیردامنه که به IP سرور اشاره کند
• یک ریورس‌پروکسی برای TLS (در انتها اشاره می‌کنم)

فایل docker-compose

این فایل را کنار خودت در یک پوشهٔ خالی بساز. دو سرویس دارد: postgres برای نگه‌داری داده و n8n برای خودِ اپلیکیشن. مقدارهای داخل <...> را با مقادیر خودت عوض کن.

services:
postgres:
  image: postgres:16-alpine
  restart: unless-stopped
  environment:
    POSTGRES_USER: n8n
    POSTGRES_PASSWORD: <یک-رمز-قوی>
    POSTGRES_DB: n8n
  volumes:
    - ./data/postgres:/var/lib/postgresql/data
  healthcheck:
    test: ["CMD-SHELL", "pg_isready -U n8n"]
    interval: 10s
    timeout: 5s
    retries: 5

n8n:
  image: docker.n8n.io/n8nio/n8n:latest
  restart: unless-stopped
  depends_on:
    postgres:
      condition: service_healthy
  ports:
    - "5678:5678"
  environment:
    DB_TYPE: postgresdb
    DB_POSTGRESDB_HOST: postgres
    DB_POSTGRESDB_DATABASE: n8n
    DB_POSTGRESDB_USER: n8n
    DB_POSTGRESDB_PASSWORD: <یک-رمز-قوی>
    N8N_HOST: n8n.example.com
    N8N_PROTOCOL: https
    WEBHOOK_URL: https://n8n.example.com/
    GENERIC_TIMEZONE: Asia/Tehran
    N8N_ENCRYPTION_KEY: <کلید-رمزنگاری-ثابت>
  volumes:
    - ./data/n8n:/home/node/.n8n

نکتهٔ مهم: N8N_ENCRYPTION_KEY را یک‌بار بساز و ثابت نگه‌دار. اعتبارنامه‌های ذخیره‌شده با همین کلید رمز می‌شوند؛ اگر عوضش کنی، همهٔ کانکشن‌های قبلی از کار می‌افتند.

بالا آوردن سرویس

docker compose up -d
docker compose logs -f n8n

خط دوم لاگ زندهٔ n8n را نشان می‌دهد تا مطمئن شوی به Postgres وصل شده و مهاجرت جدول‌ها انجام شده است. حالا http://<ip-سرور>:5678 را باز کن؛ صفحهٔ ساخت حساب مدیر را می‌بینی.

پشت ریورس‌پروکسی

پورت 5678 را مستقیم روی اینترنت باز نکن. یک ریورس‌پروکسی (Caddy یا Nginx) جلوی آن بگذار تا TLS را مدیریت کند و ترافیک را به 127.0.0.1:5678 بفرستد. همان دامنه‌ای که در N8N_HOST و WEBHOOK_URL گذاشتی باید به این پروکسی اشاره کند — وگرنه لینک‌های وبهوک اشتباه ساخته می‌شوند.

بکاپ هم ساده است: کل پوشهٔ ./data را نگه‌دار. هم داده‌های Postgres آنجاست، هم پروندهٔ رمزنگاری n8n. همین.