n8n چیست و چگونه از آن استفاده کنیم؟

N8N چیست؟

n8n یک پلتفرم اتوماسیون جریان کار (Workflow Automation) و ادغام سرویس‌ها است که امکان اتصال سرویس‌ها،
پایگاه‌های داده، APIها و ابزارهای هوش مصنوعی را در قالب یک رابط گرافیکی مبتنی بر گره‌ها (Nodes)
فراهم می‌کند. این پلتفرم در دو حالت اصلی قابل استفاده است:

• نسخه ابری (n8n Cloud)؛ بدون نیاز به مدیریت زیرساخت
• نسخه Self-Hosted؛ نصب و اجرا بر روی سرور یا سیستم شخصی

روش استفاده از نسخه آنلاین n8n چیست؟

برای شروع سریع، استفاده از نسخه ابری n8n Cloud گزینه مناسبی است. مراحل کلی به صورت زیر است:

1. ثبت‌نام در وب‌سایت n8n و ایجاد حساب کاربری در n8n Cloud
2. ساخت Workspace و ایجاد یک Workflow جدید
3. انتخاب Trigger (مانند Webhook یا اجرای زمان‌بندی‌شده) و افزودن گره‌ها
4. اجرای آزمایشی، مشاهده Execution و رفع خطاها

مفاهیم و اصطلاحات تخصصی n8n چیست؟

Workflow در n8n چیست؟

Workflow در n8n مجموعه‌ای از گره‌های به‌هم‌پیوسته است که یک فرایند خودکار را شکل می‌دهند.
هر Workflow معمولاً شامل یک Trigger، چند گره پردازش‌گر و یک یا چند گره خروجی است.

گره‌ها در n8n به چه گفته می‌شود؟

گره (Node) کوچک‌ترین واحد عملیاتی در n8n است و هر گره وظیفه مشخصی مانند ارسال درخواست HTTP،
ذخیره داده، ارسال پیام یا اجرای شرط منطقی را بر عهده دارد.

Execution در n8n چیست؟

هر بار که یک Workflow اجرا می‌شود، n8n یک Execution ثبت می‌کند. Execution شامل زمان اجرا، وضعیت
(موفق، ناموفق، در حال انتظار) و داده‌های عبوری از هر گره است و برای دیباگ و تحلیل فرایند اهمیت زیادی دارد.

اعتبارنامه‌ها (Credentials)

برای اتصال به سرویس‌های خارجی مانند Gmail، Telegram، Google Sheets و غیره، n8n از Credentialها
استفاده می‌کند. Credentialها اطلاعات احراز هویت مانند API Key و Token را به‌صورت متمرکز و امن ذخیره می‌کنند.

عبارت‌ها (Expressions)

عبارت‌ها (Expressions) امکان استفاده از جاوااسکریپت در فیلدهای مختلف را فراهم می‌کنند تا مقادیر
پویا بر اساس خروجی گره‌های قبلی، محاسبات و ترکیب رشته‌ها تولید شود.

{{ $json["email"] }}

{{ new Date().toISOString() }}

چطور کار با ابزارهای هوش مصنوعی را در لوح گسترش یاد بگیریم؟

استفاده از n8n در کنار ابزارهای هوش مصنوعی، امکان ساخت سیستم‌های هوشمند و خودکار را فراهم می‌کند.
برای بهره‌برداری بهتر از این قابلیت‌ها، آشنایی با مفاهیم پایه هوش مصنوعی، برنامه‌نویسی و مدیریت داده‌ها
ضروری است. فیلم‌های آموزشی لوح گسترش می‌توانند مسیر یادگیری این مباحث را ساختارمند و هدفمند کنند.

روش نصب n8n چیست؟

به شکل کلی، سه روش متداول برای نصب n8n وجود دارد:

• نصب بر روی سرور لینوکسی با استفاده از Docker و Docker Compose
• نصب با Node.js و npm بر روی سیستم‌عامل‌های مختلف
• اجرای n8n در ویندوز با Docker Desktop یا محیط WSL

پیش‌نیازهای نصب n8n چیست؟

برای نصب n8n بر روی سرور (مثلاً Ubuntu) به موارد زیر نیاز است:

• سرور لینوکسی با دسترسی SSH
• نصب بودن Docker و Docker Compose
• دامنه یا زیردامنه برای راه‌اندازی HTTPS
• حداقل ۱ تا ۲ گیگابایت RAM برای سناریوهای معمول

برای نصب با Node.js نیز لازم است نسخه‌های پشتیبانی‌شده Node.js و npm روی سیستم نصب شده باشد.

گام اول: پیکربندی Docker Compose

نمونه ساده فایل docker-compose.yml برای راه‌اندازی n8n به صورت زیر است:

version: "3.9"

services:
  n8n:
    image: n8nio/n8n:latest
    restart: always
    ports:
      - "5678:5678"
    environment:
      - N8N_HOST=automation.example.com
      - N8N_PORT=5678
      - N8N_PROTOCOL=http
      - N8N_BASIC_AUTH_ACTIVE=true
      - N8N_BASIC_AUTH_USER=admin
      - N8N_BASIC_AUTH_PASSWORD=یک_رمز_قوی_و_پیچیده
    volumes:
      - ./data:/home/node/.n8n

گام دوم: شروع n8n و تأیید فعالیت نصب

پس از آماده‌سازی فایل Docker Compose، می‌توان سرویس n8n را با دستور زیر اجرا کرد:

docker compose up -d

docker compose logs -f

پس از اجرای موفق، صفحه وب n8n از طریق آدرس http://IP-SERVER:5678 قابل دسترسی خواهد بود.

روش دسترسی به n8n چیست؟

دسترسی به رابط وب n8n معمولاً از سه طریق زیر انجام می‌شود:

• دسترسی محلی روی سرور از طریق http://localhost:5678
• دسترسی با IP سرور از طریق http://IP-SERVER:5678
• دسترسی از طریق دامنه و پروتکل HTTPS (مانند https://automation.example.com)

گام سوم: حفظ امنیت n8n با HTTPS

برای فعال‌سازی HTTPS، استفاده از Nginx به‌عنوان Reverse Proxy و دریافت گواهی SSL از Let’s Encrypt
(با کمک Certbot) متداول است.

نصب Nginx و Certbot

در سیستم‌هایی مانند Ubuntu، دستورات زیر برای نصب Nginx و Certbot مورد استفاده قرار می‌گیرد:

sudo apt update
sudo apt install nginx -y

sudo apt install certbot python3-certbot-nginx -y

نمونه پیکربندی ساده Nginx برای n8n:

server {
    server_name automation.example.com;

    location / {
        proxy_pass http://127.0.0.1:5678/;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
    }
}

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

sudo certbot --nginx -d automation.example.com

روش نصب رابط کاربری وب n8n چیست؟

رابط کاربری وب n8n بخشی از خود برنامه است، بنابراین با راه‌اندازی سرویس n8n (چه در Docker و چه با npm)
به‌طور خودکار در همان آدرس و پورت تعریف‌شده در دسترس خواهد بود و نیاز به نصب جداگانه ندارد.

نصب اکانت مالک

در اولین ورود به رابط وب، صفحه راه‌اندازی اولیه نمایش داده می‌شود و با وارد کردن نام، ایمیل و گذرواژه،
حساب مالک (Owner) ایجاد می‌گردد.

سفارشی‌سازی سیستم n8n

از بخش تنظیمات (Settings) می‌توان مواردی مانند منطقه زمانی، سطح لاگ‌ها، مدیریت Executionها و برخی
پارامترهای دیگر را متناسب با نیاز سامانه تنظیم کرد.

گام چهارم: ساخت اولین جریان کاری

پس از راه‌اندازی موفق n8n، می‌توان یک Workflow ساده برای آشنایی عملی ایجاد کرد. برای نمونه:

• Trigger از نوع Webhook برای دریافت داده از فرم سایت
• گره Google Sheets برای ذخیره اطلاعات فرم
• گره سرویس هوش مصنوعی برای تولید خلاصه پیام
• گره Telegram برای ارسال خلاصه به مدیر سامانه

نصب n8n در ویندوز

در ویندوز می‌توان n8n را به سه روش اصلی نصب و اجرا کرد:

• نصب مستقیم با Node.js و npm
• استفاده از Docker Desktop
• نصب در محیط WSL (مثلاً Ubuntu در ویندوز)

نصب n8n در ویندوز با کمک Node.js

مراحل اصلی به شکل زیر است:

node -v
npm -v

npm install -g n8n

n8n

n8n start

اجرای n8n بر روی ویندوز با کمک Docker

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

یادگیری مدیریت ابزارهای فناوری اطلاعات با کمک لوح گسترش

برای بهره‌برداری حرفه‌ای از n8n، تسلط بر مفاهیم مدیریت سرور، لینوکس، Docker، شبکه و پایگاه داده‌ها
ضروری است. فیلم‌های آموزشی لوح گسترش در حوزه‌های نرم‌افزار، برنامه‌نویسی و مهندسی می‌توانند مسیر
یادگیری این مباحث را تسهیل کنند و زمینه‌ساز استفاده مؤثر از ابزارهایی مانند n8n در پروژه‌های واقعی باشند.

جمع‌بندی

در این مقاله، ضمن معرفی n8n و ساختار کلی آن، روش استفاده از نسخه آنلاین، مفاهیم Workflow، Node،
Execution، اعتبارنامه‌ها و عبارت‌ها، و نیز نصب بر روی سرور و ویندوز بررسی شد. همچنین، یک نمونه ساده
از ساخت جریان کاری و اهمیت آموزش‌های نرم‌افزار و فناوری اطلاعات در لوح گسترش برای استفاده‌ی بهتر از
این ابزارها بیان شد.