نصب n8n روی سرور؛ راهنمای کامل با Docker برای ایران

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

در این راهنما انتخاب سرور، نصب با Docker، اتصال دامنه و نکته‌هایی را که مخصوص ایران است قدم‌به‌قدم می‌بینید.

چرا روی سرور خودتان

n8n دو نسخه دارد. نسخه‌ی ابری را خود n8n میزبانی می‌کند و اشتراک ماهانه دارد. نسخه‌ی Community را خودتان روی سرور نصب می‌کنید و هزینه‌ی نرم‌افزاری ندارد. تفاوت امکانات این دو در مستندات رسمی نسخه‌ی Community آمده است.

سه دلیل برای نصب روی سرور خودتان: هزینه‌ی ثابت که با تعداد اجرا بالا نمی‌رود، داده‌هایی که روی زیرساخت خودتان می‌ماند، و نبود دردسر پرداخت ارزی. در عوض، به‌روزرسانی و پشتیبان‌گیری با خودتان است.

سرور ایران یا خارج؛ مهم‌ترین تصمیم

این تصمیم را قبل از خرید سرور بگیرید، چون بعداً عوض کردنش وقت می‌برد.

اگر ورک‌فلوهای شما با کلاد (Claude)، مدل‌های دیگر یا ربات تلگرام کار می‌کنند، سرور خارج تقریباً اجباری است. اگر فقط سرویس‌های داخلی را به هم وصل می‌کنید، سرور ایران کافی است. برای شروع یک سرور مجازی با دو هسته و دو گیگابایت رم برای ورک‌فلوهای معمولی کافی است.

نصب n8n روی سرور با Docker

ساده‌ترین و رایج‌ترین روش، Docker است. اول خود Docker را طبق راهنمای رسمی نصب Docker روی Ubuntu نصب کنید.

بعد طبق راهنمای رسمی نصب n8n با Docker یک فضای ذخیره‌سازی بسازید و n8n را اجرا کنید:

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

حالا n8n روی پورت ۵۶۷۸ سرور بالا آمده است. فضای ذخیره‌سازی n8n_data مهم است؛ ورک‌فلوها و اعتبارنامه‌ها آنجا نگه داشته می‌شوند و اگر نباشد، با هر بار راه‌اندازی دوباره همه‌چیز پاک می‌شود.

این دستور برای تست است. برای استفاده‌ی واقعی، روش بعدی را بروید.

نصب ماندگار با Docker Compose و دامنه

برای اینکه n8n همیشه روشن بماند، بعد از ری‌استارت سرور خودش بالا بیاید و با دامنه و HTTPS در دسترس باشد، از Docker Compose استفاده کنید. n8n یک راهنمای رسمی Docker Compose دارد که فایل آماده و تنظیم گواهی HTTPS را قدم‌به‌قدم توضیح می‌دهد.

مسیر کلی این است: یک زیردامنه مثل n8n.example.com بسازید و به IP سرور اشاره دهید. فایل Compose را از راهنما بردارید و دامنه و ایمیل خودتان را در آن بگذارید. با یک دستور همه را بالا بیاورید. گواهی HTTPS خودکار گرفته می‌شود.

HTTPS اختیاری نیست. بدون آن رمز عبور و اطلاعات ورک‌فلوها بدون رمزگذاری روی اینترنت جابه‌جا می‌شود، و بسیاری از سرویس‌ها هم به آدرس بدون HTTPS وب‌هوک نمی‌فرستند.

تنظیمی که بیشتر از همه فراموش می‌شود

وقتی n8n پشت دامنه و پروکسی قرار می‌گیرد، باید بداند آدرس عمومی‌اش چیست؛ وگرنه آدرس وب‌هوک‌ها را اشتباه نشان می‌دهد و سرویس‌های بیرونی نمی‌توانند به آن پیام بفرستند.

این کار با متغیر محیطی WEBHOOK_URL انجام می‌شود که در مستندات تنظیم آدرس وب‌هوک توضیح داده شده است. اگر مفهوم وب‌هوک برایتان تازه است، وب هوک چیست را ببینید.

نکته‌های مخصوص کاربر ایرانی

دریافت ایمیج از ایران. اگر سرور در ایران است، ممکن است دانلود ایمیج‌های Docker با محدودیت روبه‌رو شود. بیشتر دیتاسنترهای داخلی برای همین یک mirror داخلی ارائه می‌دهند؛ آدرسش را از پشتیبانی همان سرویس بگیرید.

ترکیب دو سرور. اگر هم به سرویس‌های داخلی نیاز دارید و هم به API خارجی، می‌شود n8n را روی سرور خارج گذاشت و سرویس‌های داخلی را از طریق وب‌هوک به آن وصل کرد.

پشتیبان‌گیری. از فضای ذخیره‌سازی n8n به‌طور منظم نسخه‌ی پشتیبان بگیرید. سرور ارزان ممکن است بدون خبر قبلی از دسترس خارج شود.

خطاهای رایج بعد از نصب n8n روی سرور

صفحه باز نمی‌شود. پورت ۵۶۷۸ یا ۴۴۳ در فایروال سرور بسته است.

وب‌هوک‌ها کار نمی‌کنند. متغیر WEBHOOK_URL تنظیم نشده یا HTTPS فعال نیست.

بعد از ری‌استارت ورک‌فلوها پاک شدند. فضای ذخیره‌سازی به کانتینر وصل نبوده است.

گره‌های هوش مصنوعی خطای اتصال می‌دهند. سرور در ایران است و دسترسی به API خارجی ندارد.

بعد از نصب چه کنیم

اول یک حساب کاربری مدیر با رمز قوی بسازید. بعد یک ورک‌فلوی ساده بسازید و مطمئن شوید بعد از ری‌استارت سرور هنوز کار می‌کند. بعد سراغ پروژه‌ی واقعی بروید؛ آموزش n8n فارسی مسیر قدم‌به‌قدم ساخت اولین ورک‌فلو را دارد و ساخت ایجنت هوش مصنوعی با n8n قدم بعدی است.

هر چند هفته یک بار هم n8n را به‌روز کنید. نسخه‌های جدید هم خطاها را رفع می‌کنند و هم بلوک‌های تازه اضافه می‌کنند.

سوالات متداول

نصب n8n روی سرور واقعاً رایگان است؟

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

بدون دانش لینوکس می‌شود n8n را نصب کرد؟

بله، با دنبال کردن دستورهای همین راهنما و راهنماهای رسمی. فقط باید بتوانید با SSH به سرور وصل شوید و دستور را کپی کنید.

روی کامپیوتر خودم هم می‌شود نصب کرد؟

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

سرور با چه مشخصاتی بخرم؟

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

قدم بعدی

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

می‌خواهید خودتان مسلط شوید؟ فصل اتوماسیون دوره‌ی سفر هوش مصنوعی از نصب تا ساخت ورک‌فلوی واقعی را پوشش می‌دهد.

ورک‌فلوهای آماده و نکته‌های کوتاه را در کانال تلگرام منتشر می‌کنیم.