سرور n8n؛ آموزش نصب n8n روی VPS و راه‌اندازی Self-Hosted

سرور n8n چیست و چرا برای Self-Hosted به VPS نیاز داریم؟

n8n یک ابزار اتوماسیون Workflow است که می‌تواند سرویس‌ها، APIها، دیتابیس‌ها، مدل‌های هوش مصنوعی و ابزارهای کاری را به هم متصل کند. اگر از نسخه Cloud استفاده کنید، زیرساخت توسط خود n8n مدیریت می‌شود؛ اما در حالت Self-Hosted می‌توانید n8n را روی سرور خودتان اجرا کنید و کنترل بیشتری روی داده، IP، منابع، شبکه، Backup و اتصال سرویس‌های داخلی داشته باشید.

عبارت‌هایی مثل سرور n8n، هاست n8n و n8n روی VPS معمولاً به همین مدل Self-Hosted اشاره دارند؛ یعنی یک سرور لینوکسی که n8n روی آن دائماً فعال است، Webhook دریافت می‌کند و Workflowها را بدون وابستگی به کامپیوتر شخصی اجرا می‌کند.

n8n چیست و چه کاری انجام می‌دهد؟

n8n یک پلتفرم Workflow Automation است که طبق مستندات رسمی می‌تواند برنامه‌هایی که API دارند به هم متصل کند، داده را بین آن‌ها جابه‌جا کند و روی داده پردازش انجام دهد. علاوه بر صدها Integration، ابزارهایی برای HTTP Request، Webhook، Code، دیتابیس، فایل، AI Agent، RAG و MCP هم دارد.

برای مثال با n8n می‌توانید این Workflowها را بسازید:

• دریافت فرم سایت و ثبت خودکار در CRM
• ارسال پیام تلگرام بعد از ثبت سفارش
• اتصال WooCommerce به حسابداری یا انبار
• دریافت اطلاعات از API و ذخیره در PostgreSQL
• خلاصه‌سازی ایمیل با مدل هوش مصنوعی
• ساخت AI Agent با Toolهای مختلف
• اتوماسیون تولید و انتشار محتوا
• اجرای Workflowهای زمان‌بندی‌شده بدون روشن بودن کامپیوتر

هاست n8n با سرور n8n چه تفاوتی دارد؟

در بازار ممکن است هر دو عبارت «هاست n8n» و «سرور n8n» استفاده شوند، اما از نظر فنی تفاوت مهمی دارند. n8n برای اجرای پایدار به Process دائمی، دیتابیس، Port داخلی و در بسیاری از سناریوها Docker نیاز دارد. به همین دلیل VPS معمولاً انتخاب منعطف‌تری از هاست اشتراکی سنتی است.

برای n8n چقدر RAM و CPU لازم است؟

n8n برای همه Workflowها مصرف یکسانی ندارد. Workflow ساده‌ای که فقط چند API Call دارد با Workflow پردازش فایل، AI، Browser Automation یا چند هزار Execution در روز قابل مقایسه نیست. بنابراین جدول زیر فقط برای شروع است، نه تضمین ظرفیت.

پیش‌نیاز نصب n8n روی VPS

در این راهنما از Ubuntu 24.04، Docker Compose، PostgreSQL و دامنه‌ای مثل n8n.example.com استفاده می‌کنیم.

قبل از شروع باید داشته باشید:

• VPS لینوکسی با دسترسی sudo
• حداقل 2GB RAM برای محیط سبک
• یک دامنه یا Subdomain
• DNS نوع A که به IP سرور اشاره کند
• Portهای 80 و 443 باز
• Backup قبل از هر Upgrade

مرحله ۱: آماده‌سازی Ubuntu

sudo apt update
sudo apt upgrade -y
sudo apt install -y ca-certificates curl gnupg nginx ufw

Firewall را فعال کنید:

sudo ufw allow OpenSSH
sudo ufw allow 'Nginx Full'
sudo ufw enable
sudo ufw status

مرحله ۲: نصب Docker و Docker Compose

Docker را از Repository رسمی نصب کنید تا Compose Plugin نیز در دسترس باشد. بعد از نصب وضعیت نسخه‌ها را بررسی کنید:

docker --version
docker compose version

اگر Docker را تازه نصب کرده‌اید و می‌خواهید بدون sudo اجرا کنید، User را به گروه Docker اضافه کنید. توجه کنید عضویت در گروه Docker عملاً سطح دسترسی بسیار بالایی روی سرور ایجاد می‌کند؛ بنابراین فقط برای User مورد اعتماد استفاده شود.

مرحله ۳: ساخت پوشه پروژه n8n

sudo mkdir -p /opt/n8n
sudo chown -R $USER:$USER /opt/n8n
cd /opt/n8n

مرحله ۴: ساخت کلید رمزنگاری n8n

n8n Credentialها را رمزنگاری می‌کند. در Self-Hosted بهتر است N8N_ENCRYPTION_KEY را خودتان مشخص و در Backup امن نگه دارید. اگر این کلید را بعداً از دست بدهید، بازیابی Credentialهای رمزنگاری‌شده مشکل‌ساز می‌شود.

openssl rand -hex 32

خروجی را ذخیره کنید.

مرحله ۵: ساخت فایل .env

nano .env

نمونه:

N8N_HOST=n8n.example.com
N8N_PROTOCOL=https
N8N_PORT=5678
WEBHOOK_URL=https://n8n.example.com/
N8N_PROXY_HOPS=1

GENERIC_TIMEZONE=Asia/Tehran
TZ=Asia/Tehran

N8N_ENCRYPTION_KEY=YOUR_LONG_RANDOM_KEY

POSTGRES_DB=n8n
POSTGRES_USER=n8n
POSTGRES_PASSWORD=CHANGE_THIS_TO_A_LONG_RANDOM_PASSWORD

DB_TYPE=postgresdb
DB_POSTGRESDB_HOST=postgres
DB_POSTGRESDB_PORT=5432
DB_POSTGRESDB_DATABASE=n8n
DB_POSTGRESDB_USER=n8n
DB_POSTGRESDB_PASSWORD=CHANGE_THIS_TO_THE_SAME_PASSWORD

دسترسی فایل را محدود کنید:

chmod 600 .env

مرحله ۶: ساخت Docker Compose با PostgreSQL

فایل زیر را بسازید:

nano compose.yml

محتوا:

services:
  postgres:
    image: postgres:16-alpine
    restart: unless-stopped
    environment:
      POSTGRES_DB: ${POSTGRES_DB}
      POSTGRES_USER: ${POSTGRES_USER}
      POSTGRES_PASSWORD: ${POSTGRES_PASSWORD}
    volumes:
      - postgres_data:/var/lib/postgresql/data
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U ${POSTGRES_USER} -d ${POSTGRES_DB}"]
      interval: 10s
      timeout: 5s
      retries: 10

  n8n:
    image: docker.n8n.io/n8nio/n8n:latest
    restart: unless-stopped
    depends_on:
      postgres:
        condition: service_healthy
    env_file:
      - .env
    ports:
      - "127.0.0.1:5678:5678"
    volumes:
      - n8n_data:/home/node/.n8n

volumes:
  postgres_data:
  n8n_data:

در این تنظیم Port 5678 فقط روی 127.0.0.1 Bind می‌شود؛ یعنی از اینترنت مستقیماً قابل دسترسی نیست و فقط Nginx به آن وصل می‌شود.

مرحله ۷: اجرای n8n

docker compose pull
docker compose up -d
docker compose ps

برای بررسی Log:

docker compose logs -f n8n

از خود سرور تست کنید:

curl -I http://127.0.0.1:5678

مرحله ۸: اتصال دامنه با Nginx

sudo nano /etc/nginx/sites-available/n8n

نمونه:

server {
    listen 80;
    server_name n8n.example.com;

    client_max_body_size 50m;

    location / {
        proxy_pass http://127.0.0.1:5678;
        proxy_http_version 1.1;

        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;

        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";

        proxy_read_timeout 3600;
    }
}

فعال کنید:

sudo ln -s /etc/nginx/sites-available/n8n /etc/nginx/sites-enabled/n8n
sudo nginx -t
sudo systemctl reload nginx

مرحله ۹: فعال‌سازی SSL

sudo apt install -y certbot python3-certbot-nginx
sudo certbot --nginx -d n8n.example.com

بعد از موفقیت، آدرس زیر را باز کنید:

https://n8n.example.com

در اولین ورود، حساب Owner بسازید و رمز قوی استفاده کنید.

Webhook در n8n چگونه کار می‌کند؟

Node وبهوک معمولاً دو URL دارد: Test و Production. URL تست برای زمانی است که Workflow را در Editor به حالت Listen می‌برید؛ URL Production زمانی کار می‌کند که Workflow فعال باشد.

اگر Webhook شما از بیرون کار نمی‌کند، این موارد را بررسی کنید:

• Workflow فعال باشد.
• دامنه از اینترنت Resolve شود.
• HTTPS معتبر باشد.
• WEBHOOK_URL دقیقاً URL عمومی باشد.
• Reverse Proxy Headerها را درست ارسال کند.
• Firewall فقط 80/443 را باز داشته باشد.

PostgreSQL چرا بهتر از SQLite است؟

برای تست شخصی می‌توان با تنظیمات ساده‌تر شروع کرد، اما در سرور Production استفاده از PostgreSQL انتخاب مناسب‌تری است؛ مخصوصاً زمانی که Execution زیاد می‌شود یا می‌خواهید Queue Mode راه‌اندازی کنید.

مزیت‌های عملی PostgreSQL:

• مدیریت بهتر بار چند کاربر و چند Worker
• Backup استاندارد با pg_dump
• مناسب‌تر برای Queue Mode
• تفکیک داده n8n از Container اصلی

Queue Mode در n8n چیست؟

در نصب ساده، همان Process اصلی n8n Workflowها را اجرا می‌کند. در Queue Mode، Process اصلی Taskها را داخل Queue قرار می‌دهد و Workerهای جدا آن‌ها را اجرا می‌کنند. این معماری برای افزایش ظرفیت و مقیاس‌پذیری کاربرد دارد.

Queue Mode معمولاً به این اجزا نیاز دارد:

• Main n8n Instance
• PostgreSQL
• Redis
• یک یا چند Worker

Environment Variableهای پایه Queue Mode

EXECUTIONS_MODE=queue
QUEUE_BULL_REDIS_HOST=redis
QUEUE_BULL_REDIS_PORT=6379

Workerها باید دقیقاً همان N8N_ENCRYPTION_KEY Instance اصلی را داشته باشند، چون Credentialها بین اجزای n8n مشترک هستند.

نمونه Worker در Compose

redis:
  image: redis:7-alpine
  restart: unless-stopped

n8n-worker:
  image: docker.n8n.io/n8nio/n8n:YOUR_PINNED_VERSION
  command: worker
  restart: unless-stopped
  env_file:
    - .env
  depends_on:
    - postgres
    - redis

n8n ایران یا سرور خارج؟

انتخاب محل سرور به Workflow شما بستگی دارد. اگر بخش عمده Workflow با APIهای ایرانی، سایت‌های داخلی، CRM سازمانی یا سرویس‌های داخل کشور کار می‌کند، سرور ایران می‌تواند انتخاب منطقی باشد. اگر بخش اصلی Workflow به سرویس‌های خارجی وابسته است، کیفیت مسیر خارجی باید دقیق بررسی شود.

در بعضی سناریوها معماری Hybrid بهتر است: n8n روی سرور خارج و یک سرویس داخلی برای APIهای ایران، یا برعکس. اگر چنین سناریویی دارید، مقاله سرور مجازی خارج برای Agentic AI و n8n Self-Hosted با معماری Hybrid را بخوانید.

n8n برای AI Agent و اتوماسیون هوش مصنوعی

n8n فقط ابزار اتصال API نیست. نسخه‌های جدید آن بخش Advanced AI، AI Agent، Chat Model، Memory، Vector Store، MCP Client و MCP Server را هم در اکوسیستم خود دارد. بنابراین می‌توانید Workflowهایی بسازید که Agent از Toolها استفاده کند، اطلاعات را از دیتابیس برداری بگیرد و خروجی را وارد سیستم کسب‌وکار کند.

اگر هدفتان ساخت Agent همیشه‌روشن است، راهنمای پیاده‌سازی AI Agent روی VPS را هم ببینید.

برای اتوماسیون تولید محتوا نیز مقاله اتوماسیون تولید محتوا با هوش مصنوعی روی VPS مکمل همین موضوع است.

امن‌سازی n8n Self-Hosted

n8n به Credentialهای حساس دسترسی دارد؛ بنابراین امنیت آن باید جدی گرفته شود.

• Port 5678 را مستقیم روی اینترنت باز نکنید.
• فقط از HTTPS استفاده کنید.
• حساب Owner رمز قوی داشته باشد.
• 2FA را در صورت امکان فعال کنید.
• Credentialها را داخل Workflow متن ساده نگذارید.
• فایل .env دسترسی 600 داشته باشد.
• Community Node ناشناس نصب نکنید.
• Execute Command و Nodeهای پرریسک را فقط در صورت نیاز فعال نگه دارید.
• Docker، OS و n8n را به‌صورت برنامه‌ریزی‌شده آپدیت کنید.
• Backup خارج از همان VPS نگهداری شود.

Security Audit داخلی n8n

n8n ابزار Security Audit دارد که می‌تواند مواردی مثل Credentialهای بلااستفاده، Nodeهای پرریسک، Webhookهای محافظت‌نشده و تنظیمات امنیتی ناقص را گزارش کند.

docker compose exec n8n n8n audit

Backup کامل n8n چگونه انجام می‌شود؟

برای Backup واقعی حداقل سه بخش را نگه دارید:

• PostgreSQL Database
• N8N_ENCRYPTION_KEY
• Volume یا داده‌های موردنیاز n8n و فایل‌های Binary

Backup دیتابیس PostgreSQL

docker compose exec -T postgres \
  pg_dump -U n8n -d n8n > n8n-db-$(date +%F).sql

فایل Backup را روی همان VPS رها نکنید؛ نسخه دوم را در Storage یا سرور دیگری نگه دارید.

تست Restore

Backupی که Restore آن تست نشده، Backup قابل اعتماد نیست. برای تست در محیط جدا:

cat n8n-db-YYYY-MM-DD.sql | \
docker compose exec -T postgres psql -U n8n -d n8n

آپدیت n8n با Docker بدون از دست دادن Workflowها

اگر Volume و PostgreSQL درست نگهداری شوند، Container قابل تعویض است. روند امن Update:

1. Backup دیتابیس و Encryption Key.
2. Release Note و Breaking Change نسخه مقصد را بخوانید.
3. در صورت امکان روی Staging تست کنید.
4. نسخه Image را در Compose تغییر دهید.
5. Image جدید را Pull کنید.
6. Container را بالا بیاورید.
7. Log و Workflowهای مهم را تست کنید.

docker compose pull
docker compose up -d
docker compose logs --tail=100 n8n

در نسخه‌های جدید n8n بعضی تنظیمات و Validationها سخت‌گیرانه‌تر شده‌اند؛ بنابراین Update کورکورانه به latest روی Production توصیه نمی‌شود.

خطاهای رایج نصب n8n روی VPS

خطای 502 Bad Gateway

معمولاً Nginx به n8n دسترسی ندارد.

docker compose ps
curl -I http://127.0.0.1:5678
sudo nginx -t
sudo tail -n 100 /var/log/nginx/error.log

Webhook آدرس localhost تولید می‌کند

WEBHOOK_URL را روی URL عمومی HTTPS قرار دهید و Container را Restart کنید:

WEBHOOK_URL=https://n8n.example.com/

Webhook تست کار می‌کند ولی Production نه

بررسی کنید Workflow واقعاً Active شده باشد و از Production URL استفاده کنید.

PostgreSQL وصل نمی‌شود

docker compose ps
docker compose logs postgres
docker compose exec postgres pg_isready -U n8n -d n8n

n8n بعد از Restart Credentialها را باز نمی‌کند

یکی از اولین مواردی که باید بررسی شود تغییر یا از دست رفتن N8N_ENCRYPTION_KEY است. این کلید باید در همه Containerها و Workerهای همان Instance ثابت باشد.

حافظه سرور پر می‌شود

free -h
docker stats
docker system df

Execution History، فایل Binary، Workflowهای حجیم و Execution هم‌زمان را بررسی کنید. اضافه‌کردن RAM بدون پیدا کردن علت اصلی همیشه راه‌حل نیست.

Permission denied روی Volume

ابتدا مسیر و Owner فایل‌ها را بررسی کنید. به‌جای اجرای Container با Root، Permission صحیح Volume را تنظیم کنید.

n8n Cloud یا Self-Hosted؛ کدام بهتر است؟

چک‌لیست Production برای سرور n8n

• PostgreSQL به‌جای وابستگی به دیتابیس موقت
• Encryption Key ثابت و Backup شده
• HTTPS معتبر
• Port 5678 فقط روی localhost
• Firewall فعال
• Backup روزانه یا متناسب با اهمیت داده
• Restore آزمایش‌شده
• نسخه n8n Pin شده
• مانیتورینگ RAM، Disk و Container
• بررسی Executionهای Failed
• Security Audit دوره‌ای
• عدم نصب Community Node ناشناس
• Queue Mode فقط در صورت نیاز واقعی

سؤالات متداول درباره سرور n8n

منابع و مستندات رسمی