n8n چیست، کجا اجرا شود و مجوزش چه می‌گوید

n8n را بشناس، بین Cloud و اجرای شخصی با دلیل انتخاب کن، آن را با Docker روی کامپیوتر خودت اجرا کن و بدان مجوزش چه کاری را اجازه می‌دهد.

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

  • بگوید n8n چه نوع ابزاری است و اجزای اصلی آن (ورک‌فلو، گره، ماشه، اجرا، Credential) را نام ببرد.
  • بین n8n Cloud و اجرای شخصی برای یک موقعیت مشخص با معیار مهارت، داده، هزینه و نگهداری انتخاب کند.
  • تشخیص بدهد کدام استفاده‌ها از n8n زیر مجوز Sustainable Use مجاز است و کدام قرارداد جدا لازم دارد.
  • n8n را با Docker روی کامپیوتر خودش اجرا کند، داده آن را در volume نگه دارد و تفاوت «ذخیره» و «انتشار» را بداند.

چرا این درس مهم است

یک فریلنسر برای سه مشتری ورک‌فلو ساخت و فکر کرد کار را ساده‌تر کند: یک n8n روی سرور خودش، و به هر مشتری یک حساب که خودش ورک‌فلو بسازد و ماهانه پول بدهد. کار راه افتاد، تا وقتی متوجه شد این دقیقاً همان استفاده‌ای است که مجوز n8n بدون قرارداد جدا اجازه نمی‌دهد. همکار دیگری n8n را روی سرور اجاره‌ای بالا آورد، بدون پشتیبان و بدون به‌روزرسانی؛ شش ماه بعد که سرور از دست رفت، همه ورک‌فلوها و Credential‌ها با آن رفتند.

n8n ابزار اصلی مسیر خودکارسازی آکادمی است. پیش از اولین گره، سه تصمیم داری: کجا اجرا شود، با چه مسئولیتی، و مجوزش چه چیزی را اجازه می‌دهد. این درس هر سه را روشن می‌کند و n8n را روی کامپیوتر خودت بالا می‌آورد.

مفاهیم کلیدی

یادآوری: ورک‌فلو، ماشه و Webhook را در دوره‌های قبل دیدی؛ اینجا آن‌ها را در یک ابزار واقعی می‌بینی.

  • n8n (ان‌ایت‌ان): ابزار ساخت ورک‌فلو با گره‌های بصری که هم سرویس ابری دارد و هم روی سرور خودت اجرا می‌شود.
  • Node (گره): یک گام ورک‌فلو در n8n؛ مثل ماشه، درخواست HTTP، شرط یا تغییر داده.
  • Execution (اجرا): یک بار اجرای ورک‌فلو با داده‌ها و نتیجه هر گره که n8n ثبت می‌کند.
  • Self-hosting (اجرای شخصی): اجرای نرم‌افزار روی کامپیوتر یا سرور خودت، با مسئولیت نصب، امنیت، پشتیبان و به‌روزرسانی.
  • Sustainable Use License (مجوز استفاده پایدار): مجوز اصلی کد n8n که استفاده داخلی و شخصی را اجازه می‌دهد ولی ارائه n8n به دیگران را نه.
  • Docker Volume (حجم داده Docker): فضای ماندگار بیرون از کانتینر که داده برنامه پس از حذف کانتینر در آن می‌ماند.

مدل ذهنی

انتخاب Cloud یا اجرای شخصی را مثل اجاره دفتر مبله یا خرید ساختمان ببین. دفتر مبله (Cloud) آماده است؛ نگهداری، امنیت و تعمیر با صاحبش است و تو اجاره می‌دهی. ساختمان خودت (اجرای شخصی) آزادی کامل می‌دهد، ولی لوله‌کشی، قفل‌ها، بیمه و تعمیر هم با توست. و قرارداد (مجوز) می‌گوید حتی در ساختمان خودت، اجازه داری آن را به دیگران اجاره بدهی یا نه.

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

انتخاب محل اجرای n8n

این تشبیه کجا غلط است؟ ساختمانی که خریده‌ای، بی‌کار هم بماند خراب نمی‌شود. نرم‌افزار اجرای شخصی بی‌کار بماند خطرناک‌تر می‌شود: نسخه قدیمی، آسیب‌پذیری‌های شناخته‌شده و Credential‌هایی که هنوز کار می‌کنند. اجرای شخصی یک تصمیم یک‌باره نیست؛ کار نگهداری مداوم است.

گام‌به‌گام

گام ۱: n8n در یک نگاه

در n8n هر ورک‌فلو چند گره دارد که با خط به هم وصل‌اند. اولین گره ماشه است: دکمه اجرای دستی، زمان‌بندی، Webhook یا رویداد یک سرویس. هر بار ورک‌فلو اجرا می‌شود، یک اجرا ثبت می‌شود که داده ورودی و خروجی هر گره را نشان می‌دهد؛ این مهم‌ترین ابزار اشکال‌زدایی توست. کلیدها و دسترسی‌ها در Credential نگه داشته می‌شوند، جدا از گره‌ها.

گام ۲: نسخه‌ها و محل اجرا

مستندات n8n این گزینه‌ها را نام می‌برد: Cloud که n8n مدیریتش می‌کند؛ اجرای شخصی Community که رایگان است و تقریباً همه ویژگی‌ها را دارد (با ثبت‌نام رایگان، ویژگی‌هایی مثل اشکال‌زدایی اجرای قبلی در ویرایشگر باز می‌شود)؛ و نسخه‌های پولی Business و Enterprise برای تیم‌ها و سازمان‌هاsrc-n8n-choose. همان صفحه می‌گوید اجرای شخصی مهارت فنی و زیرساخت خودت را لازم دارد و ویژگی‌ها و پلن‌ها با زمان عوض می‌شوند؛ صفحه قیمت مرجع نهایی استsrc-n8n-choose.

معیارCloudاجرای شخصی
نصب و نگهداریبا n8nبا تو
محل دادهزیرساخت n8nجایی که تو انتخاب می‌کنی
هزینهاشتراکسرور، وقت نگهداری، ریسک
مهارت لازمکمسرور، Docker، امنیت، پشتیبان
دسترسیباید از نظر قانونی و طبق شرایط سرویس برایت ممکن باشدفقط به Docker یا سرور نیاز دارد

برای این دوره، اجرای شخصی روی کامپیوتر خودت مسیر پیش‌فرض است: رایگان است، داده‌ات از کامپیوترت بیرون نمی‌رود، و به دسترسی به هیچ سرویس خارجی وابسته نیست. اجرای روی سرور برای تولید را در دوره «n8n در تولید» می‌بینی.

گام ۳: مجوز را بخوان، نه شایعه را

بیشتر کد n8n تحت Sustainable Use License است (و بخش‌های سازمانی تحت مجوز Enterprise)؛ n8n تا ۱۷ مارس ۲۰۲۲ مجوز دیگری داشتsrc-n8n-community-license. خلاصه آنچه صفحه مجوز می‌گویدsrc-n8n-community-license:

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

FAQ مجوز هم ساختن ورک‌فلو برای مشتری را مجاز و میزبانی n8n برای ساخت ورک‌فلو توسط مشتری و برچسب‌گذاری دوباره (white-label) را غیرمجاز می‌داندsrc-n8n-license-faq. این درس مشاوره حقوقی نیست؛ برای موقعیت مرزی، متن مجوز و FAQ را بخوان و اگر لازم شد با n8n تماس بگیر.

گام ۴: اجرا روی کامپیوتر خودت با Docker

صفحه نصب Docker در مستندات n8n این دو گام را می‌دهدsrc-n8n-docker-install:

docker volume create n8n_data
docker run -it --rm --name n8n -p 5678:5678 \
  -e GENERIC_TIMEZONE="Asia/Tehran" -e TZ="Asia/Tehran" \
  -e N8N_ENFORCE_SETTINGS_FILE_PERMISSIONS=true \
  -v n8n_data:/home/node/.n8n \
  n8nio/n8n

بعد مرورگر را روی http://localhost:5678 باز کن و حساب مالک را بساز. چند نکته:

  • volume با نام n8n_data جایی است که پایگاه داده (به‌طور پیش‌فرض SQLite) و کلید رمزگذاری Credential‌ها نگه داشته می‌شودsrc-n8n-docker-compose. گزینه --rm کانتینر را پس از بستن حذف می‌کند، ولی volume می‌ماند. volume را پاک کنی، همه چیز رفته است.
  • همان صفحه خودش را «قدیمی» علامت زده و Docker Compose را توصیه می‌کند؛ برای تمرین محلی، دستور بالا کافی است و Compose را در دوره «n8n در تولید» می‌سازی.
  • مستندات کانال stable را برای تولید و beta را ناپایدار می‌داندsrc-n8n-docker-install. در مهر ۱۴۰۵ (اکتبر ۲۰۲۶) نسخه stable در خانواده 2.x بودsrc-n8n-docker-compose.
  • n8n را فقط روی کامپیوتر خودت باز نگه دار؛ برای دسترسی از اینترنت، امنیت دوره «n8n در تولید» لازم است.

گام ۵: ذخیره با انتشار فرق دارد

در n8n 2.x، سامانه «انتشار» جای کلید روشن و خاموش قبلی را گرفته است: تغییری که ذخیره می‌کنی تا وقتی منتشرش نکنی، در اجرای واقعی (ماشه‌های تولیدی مثل زمان‌بندی و Webhook) استفاده نمی‌شودsrc-n8n-v2-breaking. این از اجرای ناخواسته کار نیمه‌تمام جلوگیری می‌کند؛ ولی اگر عادت داری «ذخیره کن و تمام»، تعجب نکن که ورک‌فلو رفتار قدیمی را دارد.

مثال‌ها

پیاده‌سازی عملی

اجرای اول n8n و تمرین مجوز. حدود ۲۰ دقیقه.

  1. یکی از مسیرهای پایین را برو و n8n را باز کن (یا مسیر بدون نصب را).
  2. در n8n یک ورک‌فلوی خالی بساز، یک گره Manual Trigger بگذار، ذخیره کن و یک بار اجرا کن. در بخش اجراها، آن اجرا را پیدا کن.
  3. assets/first-run-checklist.md را کامل کن.
  4. هشت موقعیت assets/license-scenarios.md را بخوان و برای هرکدام بنویس مجاز است، قرارداد جدا لازم دارد، یا باید بیشتر پرسید؛ بعد پاسخ‌ها را ببین.
اجرای محلی

Docker Desktop (یا Docker Engine روی Linux) را نصب کن و دو دستور گام ۴ را اجرا کن. اگر درگاه 5678 گرفته است، -p 5679:5678 بگذار و http://localhost:5679 را باز کن. برای بستن، در همان پنجره Ctrl+C بزن؛ با اجرای دوباره همان دستور، ورک‌فلوهایت سر جایشان‌اند چون در volume مانده‌اند.

سرویس میزبانی‌شده (در دسترس قانونی)

اگر n8n Cloud از نظر قانونی و طبق شرایط سرویس برایت در دسترس است، یک نسخه آزمایشی بساز. چک‌لیست را برای Cloud پر کن: داده کجا نگه داشته می‌شود، پشتیبان با کیست، و پس از پایان دوره آزمایشی چه می‌شود. اگر در دسترس قانونی نیست، مسیر محلی کاملاً کافی است.

بدون اجرا / شبیه‌ساز

اگر الان نمی‌توانی چیزی نصب کنی: مدل ذهنی و جدول گام ۲ را برای موقعیت خودت پر کن، چک‌لیست را به‌شکل «برنامه نصب» بنویس (کدام کامپیوتر، کدام درگاه، نام volume، چه کسی پشتیبان می‌گیرد)، و تمرین مجوز را کامل انجام بده. درس بعد مسیر بدون نصب خودش را دارد.

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

اشتباهنتیجهکار درست
اجرای Docker بدون volumeبا بستن کانتینر همه چیز می‌رودهمیشه -v n8n_data:/home/node/.n8n
پاک‌کردن volume برای «شروع تمیز»ورک‌فلوها و Credential‌ها از دست می‌روندپیش از پاک‌کردن خروجی بگیر
باز کردن n8n محلی روی اینترنتهر کسی به ورک‌فلوها و Credential‌ها می‌رسدفقط localhost تا امنیت تولید
فروش «پنل n8n» به مشتریانخارج از مجوزساختن ورک‌فلو برای مشتری، یا قرارداد جدا
ذخیره بدون انتشار در 2.xماشه تولیدی نسخه قدیمی را اجرا می‌کندپس از آزمون، منتشر کن
استفاده از تصویر beta برای کار واقعیرفتار ناپایدارکانال stable

اشکال‌زدایی

مرورگر روی localhost:5678 چیزی نشان نمی‌دهد.

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

پنجره‌ای که docker run در آن است را ببین؛ پیام خطای درگاه (port is already allocated) یا اجرای ناموفق را بخوان.

Docker را روشن کن؛ اگر درگاه گرفته است، درگاه دیگری بده.

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

این بار volume وصل نشد یا نام آن فرق داشت.

دستور اجرا را با دستور قبلی مقایسه کن؛ فهرست volume‌ها را با docker volume ls ببین.

با همان نام volume اجرا کن؛ داده قبلی آنجاست.

ورک‌فلو را ویرایش و ذخیره کرده‌ای، ولی اجرای زمان‌بندی‌شده هنوز رفتار قبلی را دارد.

در n8n 2.x تغییر ذخیره‌شده تا انتشار، در اجرای تولیدی استفاده نمی‌شود.

وضعیت انتشار ورک‌فلو را ببین.

پس از آزمون، نسخه تازه را منتشر کن.

تمرین کوتاه

تمرین · 10 دقیقه

هدف: انتخاب محل اجرا با دلیل.

گام‌ها: برای هر موقعیت، Cloud یا اجرای شخصی را انتخاب کن و دو دلیل بنویس.

  1. یک مدرس که فقط برای کلاس نمونه نشان می‌دهد و کامپیوتر خودش را دارد.
  2. یک مطب که می‌خواهد یادآوری نوبت بفرستد و داده بیماران نباید از سازمان خارج شود؛ یک کارمند IT پاره‌وقت دارد.
  3. یک فروشگاه کوچک بدون نیروی فنی که Cloud برایش در دسترس قانونی است.

معیار پذیرش: ۱ اجرای محلی؛ ۲ اجرای شخصی با مسئول، پشتیبان و به‌روزرسانی (و اشاره به اینکه داده سلامت است)؛ ۳ Cloud با بررسی سیاست داده.

راه‌حل نمونه

۱: Docker روی کامپیوتر خودش؛ رایگان، بدون وابستگی به سرویس بیرونی، و پس از کلاس خاموش. ۲: اجرای شخصی داخل سازمان، چون داده سلامت نباید بیرون برود؛ ولی فقط اگر کارمند IT مسئول به‌روزرسانی، پشتیبان و امنیت شود؛ وگرنه ریسک نگهداری بالاتر از سود است. ۳: Cloud، چون نگهداری سرور را ندارد؛ پیش از آن چهار پرسش سیاست داده دوره پایه را برای Cloud جواب بده.

چالش

تمرین · 25 دقیقه

موقعیت: برای کار خودت (یا یک سازمان ساختگی شبیه آن) «سند تصمیم استقرار n8n» بنویس. اگر جزئیات سازمان حساس است، آن را ناشناس کن.

  1. نیاز: چند ورک‌فلو، چه داده‌ای، چه کسانی کار می‌کنند.
  2. انتخاب محل اجرا با جدول گام ۲ و دلیل.
  3. بررسی مجوز: کاربرد تو کدام ردیف جدول گام ۳ است؟ اگر مرزی است، چه پرسشی از n8n داری؟
  4. مسئولیت‌ها: چه کسی نصب، به‌روزرسانی، پشتیبان و امنیت را بر عهده دارد، و هر چند وقت.

خروجی مورد انتظار: سند یک‌صفحه‌ای با نیاز، انتخاب و دلیل، بررسی مجوز و جدول مسئولیت.

معیار پذیرش:

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

پرسش‌های سنجش

جمع‌بندی

  • n8n ورک‌فلو را با گره می‌سازد؛ هر اجرا داده هر گره را ثبت می‌کند و کلیدها در Credential می‌مانند.
  • Cloud نگهداری را برمی‌دارد؛ اجرای شخصی کنترل داده می‌دهد و مسئولیت نصب، امنیت، پشتیبان و به‌روزرسانی را.
  • مجوز Sustainable Use: استفاده داخلی و ساختن ورک‌فلو برای مشتری مجاز؛ دادن n8n به مشتری برای ساخت ورک‌فلو، قرارداد جدا.
  • با Docker و volume اجرا کن؛ volume را پاک کنی، همه چیز رفته است.
  • در n8n 2.x ذخیره با انتشار فرق دارد.
  • برای تولید، کانال stable و امنیت دوره «n8n در تولید».

پرسش‌های سنجش

همکارت می‌گوید: «ورک‌فلو دیشب شکست خورد ولی نمی‌دانم کجا.» در n8n کجا را نگاه می‌کنی و چه اطلاعاتی آنجا هست؟ و کلید API سرویسی که ورک‌فلو صدا می‌زد کجا نگه داشته می‌شود؟

پاسخ نمونه و معیار ارزیابی

در فهرست اجراها (Executions) اجرای دیشب را پیدا می‌کنم؛ آنجا داده ورودی و خروجی هر گره و گرهی که خطا داده با پیام خطا ثبت شده است. کلید API در Credential نگه داشته می‌شود، جدا از گره‌ها، و گره فقط به آن Credential اشاره می‌کند.

  • فهرست اجراها و داده هر گره (1 امتیاز)
  • Credential جدا از گره (1 امتیاز)
  • کلید در خود گره است ← کلید را در Credential نگه دار تا در خروجی ورک‌فلو دیده نشود.

یک دفتر حسابداری کوچک می‌خواهد فاکتورهای ورودی را با n8n پردازش کند. یک کارمند علاقه‌مند به فناوری دارد ولی هیچ‌کس سرور نگه نداشته است. Cloud یا اجرای شخصی؟ دو مزیت و دو هزینه انتخابت را بنویس.

پاسخ نمونه و معیار ارزیابی

پاسخ قابل قبول هر دو است اگر استدلال درست باشد. نمونه Cloud: مزیت‌ها نبود نگهداری سرور و به‌روزرسانی خودکار؛ هزینه‌ها اشتراک ماهانه و قرار گرفتن داده مالی روی زیرساخت دیگری (که باید با پرسش‌های سیاست داده و دسترسی قانونی سنجیده شود). نمونه اجرای شخصی: مزیت‌ها کنترل داده و نبود اشتراک؛ هزینه‌ها مسئولیت امنیت، پشتیبان و به‌روزرسانی برای کسی که تجربه ندارد و ریسک از دست رفتن داده.

  • دو مزیت درست برای انتخاب (1 امتیاز)
  • دو هزینه درست برای انتخاب (1 امتیاز)
  • در نظر گرفتن داده مالی یا مهارت نگهداری (1 امتیاز)
  • اجرای شخصی همیشه امن‌تر است ← نسخه به‌روزنشده و بدون پشتیبان روی سرور شخصی، از Cloud ناامن‌تر است.

کدام استفاده از n8n زیر مجوز Sustainable Use بدون قرارداد جدا مجاز است؟

  • فروش اشتراک «پنل خودکارسازی» بر پایه n8n تا مشتریان خودشان ورک‌فلو بسازند.
  • ساختن ورک‌فلو برای یک مشتری و دریافت دستمزد ساخت و پشتیبانی.
  • انتشار نسخه تغییریافته n8n با برچسب تجاری خودت.
  • فعال‌کردن ویژگی‌های Enterprise بدون کلید مجوز.
پاسخ نمونه و معیار ارزیابی
  • a ← دادن n8n به مشتری برای ساخت ورک‌فلو تحت این مجوز نیست.
  • c ← توزیع فقط رایگان و غیرتجاری مجاز است.
  • d ← بخش‌های Enterprise مجوز جدا دارند.

همکارت n8n را با این دستور اجرا کرده و می‌گوید «هر بار که لپ‌تاپ را خاموش می‌کنم، ورک‌فلوهایم پاک می‌شوند». ایراد چیست و دستور درست چه تغییری دارد؟

دستور همکار.

docker run -it --rm --name n8n -p 5678:5678 n8nio/n8n
پاسخ نمونه و معیار ارزیابی

volume وصل نشده است؛ با --rm کانتینر و همه داده داخلش پس از بستن حذف می‌شود. باید یک volume ساخت (docker volume create n8n_data) و آن را به /home/node/.n8n وصل کرد: -v n8n_data:/home/node/.n8n. همچنین بهتر است منطقه زمانی (GENERIC_TIMEZONE و TZ) را بدهد.

  • نبود volume را علت می‌داند (1 امتیاز)
  • مسیر درست /home/node/.n8n (1 امتیاز)
  • نقش --rm را می‌فهمد (1 امتیاز)
  • --rm را بردار و کافی است ← کمک می‌کند ولی داده همچنان داخل کانتینر است و با حذف یا به‌روزرسانی آن می‌رود؛ volume لازم است.

در n8n 2.x ورک‌فلوی زمان‌بندی‌شده را ویرایش کرده‌ای تا گزارش به نشانی ایمیل تازه برود، ذخیره کرده‌ای، ولی گزارش فردا باز به نشانی قبلی رفت. چرا، و این رفتار چه فایده‌ای دارد؟

پاسخ نمونه و معیار ارزیابی

در n8n 2.x ذخیره با انتشار فرق دارد؛ تا نسخه تازه منتشر نشود، ماشه تولیدی (زمان‌بندی) نسخه منتشرشده قبلی را اجرا می‌کند. فایده: کار نیمه‌تمام یا آزموده‌نشده ناخواسته وارد اجرای واقعی نمی‌شود. اصلاح: پس از آزمون، نسخه تازه را منتشر کن.

  • تفاوت ذخیره و انتشار (1 امتیاز)
  • فایده جلوگیری از اجرای کار نیمه‌تمام (1 امتیاز)
  • ایمیل خراب است ← ورک‌فلو هنوز نسخه منتشرشده قبلی را اجرا می‌کند.

فایل‌های درس

هشت موقعیت استفاده از n8n برای تمرین مجوز، با پاسخ

license-scenarios.md

چک‌لیست اجرای اول و پشتیبان‌گیری ساده

first-run-checklist.md

ابزارها و جایگزین‌ها

  • n8n 2.x — ابزار ورک‌فلو — n8n Cloud در صورت دسترسی قانونی — مسیر بدون نصب

منابع

Choose your n8n n8n accessed 2026-10-16

n8n Community license (Sustainable Use License) n8n accessed 2026-10-16

License FAQ (Sustainable Use License) n8n 2026-10

Install with Docker n8n accessed 2026-10-16; page marked outdated, recommends Docker Compose

Use Docker Compose n8n accessed 2026-10-16; stable 2.43.6, beta 2.44.2 at access time

n8n v2.0 breaking changes n8n n8n 2.0; accessed 2026-10-16

دوره

n8n از پایه