نحوه استفاده از n8n: راهنمای گام به گام و دوستانه برای ساخت اولین اتوماسیونهای شما
خودکارسازی گردشکارهای شما نباید شبیه سیمکشی یک سفینه فضایی باشد. اگر در مورد n8n شنیدهاید و تعجب میکنید که چگونه از n8n برای صرفهجویی در وقت، اتصال ابزارها و ساخت اتوماسیونهای قدرتمند بدون بازنویسی پشته فناوری خود استفاده کنید، به جای درستی آمدهاید. در این راهنمای عملی، مراحل نصب، مفاهیم اصلی، ساخت اولین گردشکار و مثالهای واقعی—از اعلانهای ساده تا خطوط لوله داده چند مرحلهای—را بررسی خواهیم کرد.
ما همه چیز را به صورت گفتگویی و مرتبط نگه میداریم، در عین حال جزئیات عملی مورد نیاز برای رفتن از "من آن را نصب کردهام" به "من میتوانم اتوماسیونها را در یک بعد از ظهر ارسال کنم" را در اختیار شما قرار میدهیم.
چرا n8n—و چرا الان؟
در اینجا آماری وجود دارد که اکثر تیمها را مجذوب میکند: کارکنان دانشبنیان 30 تا 40 درصد از روز خود را صرف کارهای تکراری میکنند—کپی دستی دادهها بین برنامهها، انتقال فایلها و پیگیری تأییدیهها. یادگیری نحوه استفاده از n8n با اجازه دادن به شما برای اتصال بصری سرویسها، افزودن منطق و ارسال گردشکارهایی که به طور خودکار اجرا میشوند، بخش عظیمی از آن زمان را آزاد میکند.
- متنباز و قابل میزبانی شخصی: کنترل دادههای خود را حفظ کنید.
- ویرایشگر بصری: کشیدن، رها کردن، اتصال—نیازی به کدنویسی کامل نیست.
- انعطافپذیر: با APIها، وبهوکها، Slack، Google Sheets، Notion، GitHub و صدها مورد دیگر ادغام میشود.
- هنگامی که میخواهید کد بزنید: گرههای JavaScript Function برای منطق سفارشی.
چه یک بنیانگذار انفرادی، یک مدیر عملیات یا یک توسعهدهنده باشید، یادگیری نحوه استفاده از n8n میتواند به سرعت به مزیت ناعادلانه شما تبدیل شود.
نکات ضروری n8n که باید بدانید
قبل از اینکه شروع به ساخت کنیم، بیایید قطعات اصلی را ترسیم کنیم تا "نحوه استفاده از n8n" در ذهن بماند.
- گردشکار: مجموعهای متصل از گرهها که از محرک تا نتیجه اجرا میشوند.
- گره محرک: گردشکار را شروع میکند—میتواند یک وبهوک، یک برنامه زمانبندی شده یا یک رویداد برنامه باشد.
- گرههای معمولی: مراحل موجود در جریان شما (به عنوان مثال، HTTP Request، Set، IF، Code، Slack، Google Sheets).
- اجرا: یک بار اجرای گردشکار شما، با انتقال دادهها از گرهای به گره دیگر.
- اعتبارسنجی: کلیدهای API، توکنها یا اتصالات OAuth که به طور امن ذخیره شدهاند.
- عبارات: مقادیر پویا با استفاده از
{{$json}} برای ارجاع به خروجی گره قبلی.
هنگامی که این موارد جا بیفتند، متوجه خواهید شد که یادگیری نحوه استفاده از n8n به یک الگو تبدیل میشود: محرک → تبدیل → مسیریابی → ارسال/ذخیره.
شروع سریع: سه روش برای نصب n8n
میتوانید در عرض چند دقیقه شروع به استفاده از n8n کنید. مسیر خود را انتخاب کنید:
1) n8n Cloud (سریعترین)
- اگر نمیخواهید زیرساخت را مدیریت کنید، عالی است.
- ثبت نام کنید، یک گردشکار ایجاد کنید، و در عرض چند دقیقه شروع به ساخت میکنید.
2) Docker (توصیه شده برای اکثر تیمها)
# docker-compose.yml
version: '3.8'
services:
n8n:
image: n8nio/n8n:latest
ports:
- '5678:5678'
environment:
- N8N_HOST=localhost
- N8N_PORT=5678
- N8N_PROTOCOL=http
- WEBHOOK_URL=
volumes:
- n8n_data:/home/node/.n8n
volumes:
n8n_data:
سپس اجرا کنید:
برای شروع به ` مراجعه کنید.
3) Node.js (دستکاری محلی)
npm install -g n8n
n8n start
نکته حرفهای: اگر قصد دارید وبهوکها را از دستگاه محلی خود در معرض دید قرار دهید، از یک سرویس تونلزنی مانند ngrok یا cloudflared استفاده کنید.
اولین گردشکار شما: از یک وبهوک به Slack
بیایید نحوه استفاده از n8n را با ساخت یک اتوماسیون ساده و مفید یاد بگیریم: هنگامی که برنامه شما JSON را به یک وبهوک ارسال میکند، یک پیام Slack فرمتشده ارسال کنید.
مرحله 1: ایجاد یک گردشکار جدید
- n8n را باز کنید → "New" → نام آن را
Notify Slack on Webhook بگذارید.
مرحله 2: اضافه کردن یک محرک Webhook
- Add node → جستجو "Webhook" → آن را رها کنید.
HTTP Method را روی POST تنظیم کنید.
Path را روی incoming/alerts تنظیم کنید.
- روی "Test URL" کلیک کنید تا یک نقطه پایانی آزمایشی موقت دریافت کنید.
مرحله 3: تست وبهوک
یک محموله نمونه ارسال کنید:
curl -X POST \
-H 'Content-Type: application/json' \
-d '{"severity":"high","service":"payments","message":"Failed charge spike"}' \
https://
باید مکث اجرا را در گره Webhook با JSON ضبط شده ببینید.
مرحله 4: تبدیل دادهها با یک گره Set
- "Keep Only Set" را انتخاب کنید.
text (string): هشدار پرداخت: {{$json["service"]}} — {{$json["message"]}} ({{$json["severity"]}})
مرحله 5: ارسال به Slack
- Operation: "Post Message".
- اعتبارسنجیهای Slack خود (OAuth) را انتخاب کنید و یک کانال را انتخاب کنید.
- Message: فیلد
text را از گره Set انتخاب کنید.
مرحله 6: فعالسازی
- گردشکار خود را از "Test" به "Production" تغییر دهید.
- از "Production URL" برای وبهوک خود در برنامه خود استفاده کنید.
تمام شد. شما به تازگی یاد گرفتید که چگونه از n8n برای سیمکشی یک خط لوله هشدار تمیز و واقعی در عرض چند دقیقه استفاده کنید.
اصول اولیه عبارات: دادههای خود را پویا کنید
هنگام یادگیری نحوه استفاده از n8n به طور مداوم از عبارات استفاده خواهید کرد. آنها به شما اجازه میدهند بدون کدنویسی مقادیر ثابت، به خروجی گره قبلی ارجاع دهید.
{{$json["field"]}} یک فیلد را از مورد فعلی دریافت میکند.
{{$("Node Name").json["field"]}} به صراحت به گره دیگری ارجاع میدهد.
{{ new Date.toISOString }} به شما امکان میدهد JavaScript را به صورت فوری تزریق کنید.
مثال: یک ردیف Google Sheets با مقادیر پویا بسازید:
Service: {{$json["service"]}}
Severity: {{$json["severity"]}}
Timestamp: {{ new Date.toISOString }}
منطق انشعاب با IF و Switch
اتوماسیونها به ندرت خطی هستند. در اینجا نحوه استفاده از n8n برای مسیریابی دادهها آمده است:
- گره IF: مسیریابی بر اساس شرایط (به عنوان مثال، severity == "high").
- گره Switch: یک مسیر را بر اساس مقدار فیلد انتخاب کنید (به عنوان مثال، status: open, pending, closed).
الگو:
- Webhook → IF (severity === 'high')
نحوه استفاده از n8n برای گردشکارهای رایج (اینها را کپی کنید)
در اینجا الگوهای عملی وجود دارد که میتوانید آنها را تطبیق دهید. هر کدام نشان میدهند که چگونه از n8n با ابزارها و منطق واقعی استفاده کنید.
1) ارسال فرم → CRM + ایمیل
- محرک: Webhook از Typeform یا یک محرک Form بومی.
- گرهها: Set (نرمال کردن فیلدها) → IF (امتیاز لید > 70) → CRM (HubSpot/Pipedrive) → ایمیل (Gmail/SMTP) → Google Sheets (گزارش).
- نکته: از یک گره
Code برای محاسبه امتیاز لید استفاده کنید:
// In a Function node
return items.map(item => ({
json: {
...item.json,
leadScore: (item.json.industry === 'SaaS' ? 40 : 20) + (item.json.employees || 0) / 10
}
}));
2) مانیتور RSS → خلاصه Slack
- گرهها: RSS Read → IF (منتشر شده در 60 دقیقه گذشته) → Markdown build (Function) → Slack.
- نکته: برای جلوگیری از تکراریها، آخرین مهر زمانی اجرا را در یک شی Workflow Static Data ذخیره کنید.
3) گزارشهای خطا → تیکتهای Jira
- محرک: Webhook از سیستم گزارشگیری شما.
- گرهها: IF (severity >= error) → Deduplicate (از یک گره Code برای هش کردن message+service استفاده کنید) → Jira Create Issue → Slack mention.
4) اشارههای اجتماعی → برد تحقیقاتی Notion
- محرک: نظرسنجی API یا Webhook از یک ابزار اجتماعی.
- گرهها: HTTP Request (Twitter/X, Reddit, etc.) → فیلتر کردن کلمات کلیدی → Notion Create Page → Slack.
5) خط لوله کوچک ETL (CSV → API → DB)
- گرهها: S3 Download → Split In Batches → Function (تبدیل ردیفها) → HTTP Request (غنیسازی) → Postgres Insert.
- نکته: تماسهای API را در
Split In Batches بپیچید تا محدودیتهای نرخ را به خوبی مدیریت کنید.
برنامههای زمانبندی شده، وبهوکها و نظرسنجی: انتخاب محرک مناسب
درک محرکها کلید تسلط بر نحوه استفاده از n8n است.
- Webhook: بیدرنگ، بهترین برای جریانهای مبتنی بر رویداد. به یک URL قابل دسترس نیاز دارد.
- Cron: اجراهای زمانبندی شده برای نظرسنجی APIها، همگامسازی پایگاههای داده یا گزارشهای روزانه.
- محرکهای خاص برنامه: برخی از ادغامها (به عنوان مثال، Stripe، Shopify) دارای محرکهای بومی هستند.
- دستی: برای آزمایش یا کارهای دادهای یکباره مفید است.
قاعده سرانگشتی: وبهوکها را برای دقت به موقع ترجیح دهید؛ از cron برای کارهای دستهای و گزارشها استفاده کنید.
اعتبارسنجیها و بهترین شیوههای امنیتی
هنگام یادگیری نحوه استفاده از n8n در تولید، با اعتبارسنجیها با احتیاط رفتار کنید.
- از خزانه اعتبارسنجی داخلی n8n استفاده کنید؛ از کدنویسی ثابت کلیدها در گرهها خودداری کنید.
- محدود کردن دامنههای اعتبارسنجی (کمترین امتیاز).
- کلیدهای API را به طور منظم بچرخانید.
- برای میزبانی شخصی، متغیرهای محیطی مانند
N8N_ENCRYPTION_KEY را تنظیم کنید.
- از HTTPS و یک پروکسی معکوس (Caddy، Nginx، Traefik) برای نقاط پایانی عمومی استفاده کنید.
- IPها را محدود کنید یا از اسرار امضا شده در وبهوکها استفاده کنید؛ در صورت امکان، امضاهای درخواست را تأیید کنید.
اشکالزدایی مانند یک حرفهای: اجراها، گزارشها و تلاشهای مجدد
حتی اتوماسیونهای عالی هم دچار سکسکه میشوند. در اینجا نحوه استفاده از n8n برای عیبیابی سریع آمده است:
- از "Execute Node" برای آزمایش یک مرحله واحد با دادههای نمونه استفاده کنید.
- برای ردیابی دادههای سطح مورد، تاریخچه "Execution" را بررسی کنید.
- برگه
binary را برای فایلها (تصاویر، CSVها) که از طریق گرهها عبور میکنند، بررسی کنید.
- گردشکارهای
Error Trigger را برای مدیریت خرابیها اضافه کنید (هشدار، تلاش مجدد، ذخیره زمینه).
- از
Continue On Fail به طور انتخابی استفاده کنید تا کارهای دستهای در حین ثبت خطاها در حال اجرا باقی بمانند.
الگو برای تماسهای HTTP مقاوم:
// Function node before HTTP Request
const delay = ms => new Promise(res => setTimeout(res, ms));
for (let i = 0; i < items.length; i++) {
items[i].json._attempt = (items[i].json._attempt || 0) + 1;
}
return items;
با تنظیمات تلاش مجدد گره HTTP و یک مسیر شرطی اگر _attempt > 3 → notify جفت کنید.
بلوکهای ساختمانی پیشرفتهای که زودتر از دیرتر به آنها نیاز خواهید داشت
با عمیقتر شدن در نحوه استفاده از n8n، این ویژگیها گردشکارهای پیچیدهتری را باز میکنند:
- گردشکارهای فرعی / Execute Workflow: از منطق مشترک در چندین اتوماسیون استفاده مجدد کنید.
- Webhook reply: در حالی که پردازش به صورت ناهمزمان ادامه دارد، بلافاصله یک پاسخ ارسال کنید.
- صفها و همزمانی: از
Split In Batches و محدودیتهای همزمانی برای کاهش سرعت استفاده کنید.
- دادههای باینری: فایلها را بین گرهها (S3، Drive، FTP) بدون نوشتن روی دیسک منتقل کنید.
- دادههای استاتیک و سراسری: وضعیت کوچک را در بین اجراها بدون پایگاه داده حفظ کنید.
- گرههای سفارشی: اگر به رفتار دقیقی نیاز دارید، ادغامهای خود را بسازید.
اشتباهات رایج هنگام یادگیری نحوه استفاده از n8n—و نحوه اجتناب از آنها
- کدنویسی ثابت مقادیر به جای استفاده از عبارات → در تولید خراب میشود.
{{$json[...]}} را در همه جا ترجیح دهید.
- رد شدن از اعتبارسنجی محمولههای ورودی → بررسیهای IF یا یک گره Function را برای پاکسازی اضافه کنید.
- استفاده بیش از حد از گردشکارهای غولپیکر → به گردشکارهای فرعی کوچکتر و قابل آزمایش تقسیم کنید.
- نادیده گرفتن محدودیتهای نرخ →
Split In Batches و تاخیرها را اضافه کنید؛ به اسناد API احترام بگذارید.
- عدم نظارت → بررسیهای سلامت روزانه ایجاد کنید و در صورت خرابی گردشکار هشدار دهید.
مثال: یک جریان غنیسازی لید صیقلی (انتها به انتها)
این مثال نشان میدهد که چگونه از n8n برای یک سناریوی تجاری واقعبینانه استفاده کنید.
- محرک: Webhook از فرم صفحه فرود شما.
- تأیید اعتبار: گره Function برای اطمینان از وجود
email، company، website.
- غنیسازی: HTTP Request به یک API دادههای شرکت (به عنوان مثال، شبیه Clearbit).
- امتیاز: گره Function امتیازی را با استفاده از تعداد کارمندان، صنعت، رتبه Alexa محاسبه میکند.
- مسیر: IF امتیاز >= 80 → ایجاد معامله CRM + اطلاعرسانی به Slack؛ در غیر این صورت → ورود به Google Sheets.
- ثبت: درج Airtable یا Postgres با رویداد کامل و امتیاز.
- گزارش: Cron شبانه یک خلاصه ایجاد میکند و در Slack پست میکند.
این معماری سریع، قابل اعتماد و مقیاسپذیر باقی میماند—و میتوانید آن را با دهها مورد استفاده دیگر تطبیق دهید.
نحوه اجرای n8n در تولید با اطمینان
اگر در مورد نحوه استفاده از n8n فراتر از دستکاری جدی هستید، عملیات خود را ارتقا دهید:
- ذخیرهسازی حالتدار: یک حجم دائمی را برای
/home/node/.n8n نصب کنید.
- پشتیبانگیری: از حجم داده n8n خود به صورت شبانه عکس بگیرید.
- پیکربندی محیط: اسرار را در متغیرهای محیطی یا یک مدیر اسرار نگه دارید.
- قابلیت مشاهده: گزارشدهی اجرا را فعال کنید، گزارشها را به پشته خود هدایت کنید (ELK/Grafana).
- مقیاسبندی: در پشت یک پروکسی معکوس با SSL اجرا کنید؛ حالت صف را برای توان عملیاتی سنگین در نظر بگیرید.
پروکسی معکوس نمونه (Caddy):
n8n.example.com {
reverse_proxy localhost:5678
encode gzip
}
استفاده از n8n با هوش مصنوعی: اتوماسیونهای هوشمند در عرض چند دقیقه
یک الگوی قدرتمند هنگام یادگیری نحوه استفاده از n8n جفت کردن آن با هوش مصنوعی است:
- تیکتهای پشتیبانی را خلاصه کنید و بر اساس احساسات مسیریابی کنید.
- توضیحات محصول را از یک صفحه گسترده SKU ایجاد کنید.
- ایمیلهای ورودی را طبقهبندی کنید و به طور خودکار در میز کمک خود برچسب بزنید.
طرح گردشکار:
- محرک Gmail → استخراج متن ایمیل.
- Function: حذف متن نقل شده و امضاها.
- تماس هوش مصنوعی از طریق HTTP Request یا یک گره LLM بومی.
- IF: احساسات منفی → ایجاد تیکت Zendesk + هشدار Slack؛ در غیر این صورت → برچسبگذاری و بایگانی.
ارزش ذکر دارد: اگر ترجیح میدهید قبل از ساختن آنها، در مورد اعلانها/گردشکارها فکر کنید یا تکرار کنید، Sider.ai (https://sider.ai/) میتواند به شما در تهیه پیشنویس الگوهای اعلان، تولید دادههای آزمایشی و مستندسازی اتوماسیون خود کمک کند. این یک همراه مفید هنگام ترسیم منطق و موارد حاشیهای است. برگه تقلب: میانبرهای صفحه کلید و سرعتبخشها
- برای اتصال گرهها بکشید؛ روی اتصالات دوبار کلیک کنید تا مسیر را تغییر دهید.
Execute Node برای حلقههای بازخورد سریع.
- از گرههای
Notes برای حاشیهنویسی منطق پیچیده برای همتیمیها استفاده کنید.
- گرهها را به طور توصیفی نامگذاری کنید:
IF High Severity > IF1.
- برای خوانایی، شاخهها را کد رنگی کنید.
از صفر تا مطمئن: برنامه 90 دقیقهای شما
اگر وقت کمی دارید، در اینجا یک روش متمرکز برای تسلط بر نحوه استفاده از n8n امروز وجود دارد:
- 0–15 دقیقه: از طریق Docker نصب کنید؛ ویرایشگر را باز کنید.
- 15–30 دقیقه: گردشکار Webhook → Set → Slack را در بالا بسازید.
- 30–45 دقیقه: شاخهبندی IF را اضافه کنید و با یک Error Trigger خطاها را مدیریت کنید.
- 45–60 دقیقه: یک درج Google Sheets و یک بررسی RSS زمانبندی شده را امتحان کنید.
- 60–90 دقیقه: به گردشکارهای فرعی بازسازی کنید و یک بررسی سلامت روزانه اضافه کنید.
در پایان، شما خواهید دانست که چگونه از n8n نه تنها در تئوری—بلکه در پشته روزانه خود استفاده کنید.
نکات کلیدی
- یادگیری نحوه استفاده از n8n در مورد الگوها است، نه به خاطر سپردن گرهها.
- از کوچک شروع کنید: یک محرک واحد، یک تبدیل تمیز و یک خروجی ساده.
- عبارات و منطق IF ابرقدرتهای شما هستند.
- برای قابلیت اطمینان زودهنگام بسازید: تلاشهای مجدد، محدودیتهای نرخ و نظارت.
- از گردشکارهای فرعی استفاده مجدد کنید و اعتبارسنجیها را ایمن نگه دارید.
بعدش چی بسازیم
- خلاصه معیارهای روزانه از Postgres به Slack.
- یک سیستم تریاژ پشتیبانی که تیکتها را برچسبگذاری و مسیریابی میکند.
- یک جریان ضبط تحقیق که پیوندها را به صفحات Notion تبدیل میکند.
- یک ناظر هزینه که در مورد معیارهای غیرعادی AWS CloudWatch هشدار میدهد.
وقتی میدانید چگونه از n8n استفاده کنید، عقبماندگی "ما باید آن را خودکار کنیم" بالاخره شروع به کوچک شدن میکند.
سوالات متداول
Q1:سادهترین راه برای یادگیری نحوه استفاده از n8n چیست؟
با یک گردشکار ساده webhook-to-Slack شروع کنید. این محرکها، تبدیلها و خروجیها—هسته نحوه استفاده از n8n—را بدون غرق کردن شما آموزش میدهد.
Q2:آیا برای استفاده موثر از n8n نیاز به کدنویسی دارم؟
نه، میتوانید بسیاری از گردشکارها را با گرههای بصری بسازید. اما JavaScript اساسی در گرههای Function و عبارات یادگیری نحوه استفاده از n8n را بسیار قدرتمندتر میکند.
Q3:چگونه n8n را به طور ایمن در تولید اجرا کنم؟
از HTTPS در پشت یک پروکسی معکوس استفاده کنید، یک کلید رمزگذاری تنظیم کنید، اعتبارسنجیها را به طور ایمن ذخیره کنید و از حجم خود نسخه پشتیبان تهیه کنید. پیروی از این مراحل کلید استفاده ایمن از n8n در مقیاس است.
Q4:آیا میتوانم از n8n برای ادغام با هر API استفاده کنم؟
بله. از گره HTTP Request با اعتبارسنجیها و عبارات استفاده کنید. این بخش اصلی نحوه استفاده از n8n است زمانی که یک ادغام بومی در دسترس نیست.
Q5:اشتباهات رایج هنگام یادگیری نحوه استفاده از n8n چیست؟
کدنویسی ثابت مقادیر، رد شدن از اعتبارسنجی، نادیده گرفتن محدودیتهای نرخ و ساخت گردشکارهای بزرگ همه کاره. به جای آن از عبارات، بررسیهای IF، دستهبندی و گردشکارهای فرعی استفاده کنید.