مقدمه

n8n یک پلتفرم متن‌باز برای Workflow Automation است که به شما امکان می‌دهد بدون نیاز به کدنویسی زیاد، سرویس‌ها و APIهای مختلف را به یکدیگر متصل کرده و فرآیندهای خودکار ایجاد کنید.

بهترین روش نصب n8n در محیط Production، استفاده از Docker Compose است. این روش مدیریت سرویس، بروزرسانی، تهیه نسخه پشتیبان و مهاجرت را ساده‌تر می‌کند و توسط تیم n8n نیز توصیه می‌شود.

در این مقاله نصب n8n با استفاده از Docker Compose و پایگاه داده داخلی SQLite را بررسی می‌کنیم.

پیش‌نیازها

قبل از شروع، موارد زیر باید روی سرور نصب شده باشند:

• Docker
• Docker Compose Plugin
• حداقل ۲ گیگابایت RAM
• یک کاربر دارای دسترسی sudo
• در صورت استفاده در Production، یک دامنه و Reverse Proxy مانند Nginx یا Traefik

بررسی نصب Docker

docker --version

بررسی Docker Compose

docker compose version

ایجاد پوشه پروژه

mkdir -p ~/n8n

ورود به پوشه:

cd ~/n8n

ایجاد پوشه ذخیره اطلاعات

mkdir n8n_data

تمام اطلاعات، Workflowها و تنظیمات داخل این پوشه ذخیره خواهند شد.

ایجاد فایل Docker Compose

nano docker-compose.yml

فایل docker-compose.yml

services:
  n8n:
    image: docker.n8n.io/n8nio/n8n:latest
    container_name: n8n

    restart: unless-stopped

    ports:
      - "5678:5678"

    environment:
      - TZ=Asia/Tehran
      - GENERIC_TIMEZONE=Asia/Tehran

    volumes:
      - ./n8n_data:/home/node/.n8n

تنظیم متغیرهای TZ و GENERIC_TIMEZONE باعث می‌شود زمان‌بندی Workflowها مطابق منطقه زمانی سرور انجام شود.

اجرای n8n

docker compose up -d

بررسی وضعیت Container

docker ps

نمونه خروجی:

CONTAINER ID   IMAGE                  STATUS
xxxxxxxx       n8nio/n8n:latest       Up

مشاهده لاگ‌ها

docker compose logs -f

دسترسی به پنل

اگر فایروال اجازه دسترسی به پورت 5678 را داده باشد:

http://SERVER-IP:5678

در اولین ورود، n8n از شما می‌خواهد حساب مدیریتی ایجاد کنید.

اجرای خودکار پس از ریبوت

در فایل Compose از گزینه زیر استفاده شده است:

restart: unless-stopped

در نتیجه، پس از ریبوت سرور، کانتینر به‌صورت خودکار اجرا خواهد شد.

بروزرسانی n8n

آخرین Image را دریافت کنید:

docker compose pull

سپس:

docker compose down

و مجدداً اجرا کنید:

docker compose up -d

این روش رسمی بروزرسانی n8n در Docker Compose است.

تهیه نسخه پشتیبان

از پوشه داده‌ها نسخه پشتیبان تهیه کنید:

tar -czf n8n-backup.tar.gz n8n_data

توقف سرویس

docker compose stop

اجرای مجدد

docker compose start

حذف سرویس

docker compose down

در صورت حذف Volumeها:

docker compose down -v

بررسی نسخه n8n

docker exec -it n8n n8n --version

خطاهای رایج

Cannot connect to Docker daemon

سرویس Docker اجرا نشده است.

sudo systemctl start docker

docker: ‘compose’ is not a docker command

Docker Compose Plugin نصب نشده است.

docker compose version

Port 5678 already in use

پورت توسط سرویس دیگری اشغال شده است.

بررسی:

ss -tulpn | grep 5678

یا شماره پورت را در فایل Compose تغییر دهید.

بهترین روش‌ها

• از Docker Compose برای نصب Production استفاده کنید.
• همیشه از Volume برای ذخیره اطلاعات استفاده کنید.
• از Reverse Proxy همراه SSL استفاده کنید.
• از پوشه n8n_data به‌صورت منظم نسخه پشتیبان تهیه کنید.
• قبل از هر بروزرسانی، Backup بگیرید.
• از PostgreSQL برای محیط‌های بزرگ و پرترافیک استفاده کنید.

اشتباهات رایج

• ذخیره نکردن اطلاعات در Volume
• حذف کانتینر بدون داشتن Backup
• استفاده از SQLite در محیط‌های بسیار پرترافیک
• باز کردن مستقیم پورت 5678 روی اینترنت بدون SSL
• استفاده از نسخه‌های قدیمی n8n

چک‌لیست

پس از نصب، موارد زیر را بررسی کنید:

• Docker نصب شده است.
• Docker Compose نصب شده است.
• کانتینر n8n در حال اجرا است.
• پنل از طریق مرورگر باز می‌شود.
• حساب مدیر ایجاد شده است.
• پوشه n8n_data ایجاد شده است.
• Restart Policy فعال است.
• نسخه پشتیبان تهیه شده است.

مطالعات بیشتر

برای مطالعه مستندات رسمی n8n از منابع زیر استفاده کنید:

• مستندات رسمی n8n Self-hosting
• نمونه‌های رسمی Docker Compose برای n8n
• Docker Image رسمی n8n
• آموزش نصب داکر در لینوکس
• آموزش نصب docker compose

جمع‌بندی

استفاده از Docker Compose ساده‌ترین و مطمئن‌ترین روش برای نصب n8n روی لینوکس است. این روش مدیریت کانتینر، بروزرسانی، تهیه نسخه پشتیبان و بازیابی اطلاعات را آسان می‌کند و برای بیشتر سناریوهای Self-hosted مناسب است. برای محیط‌های Production نیز توصیه می‌شود n8n را پشت یک Reverse Proxy همراه با SSL اجرا کرده و در صورت افزایش حجم Workflowها، از PostgreSQL به‌جای SQLite استفاده کنید.

کیان پور