اگر قصد دارید فرایندهای تکراری کسب‌وکار خود را خودکار کنید، اطلاعات چندین سرویس را به یکدیگر متصل کنید یا از هوش مصنوعی برای اجرای وظایف مختلف کمک بگیرید، n8n یکی از ابزارهایی است که می‌تواند این کارها را برای شما ساده‌تر کند.
اما قبل از ساخت اولین اتوماسیون، باید n8n را راه‌اندازی کنید.
در این مقاله قصد داریم نصب n8n را از ابتدا آموزش دهیم؛ از انتخاب روش مناسب نصب گرفته تا آماده‌سازی محیط، اجرای سرویس، ورود به پنل مدیریت و بررسی عملکرد اولیه آن.
این آموزش برای افرادی نوشته شده است که تاکنون با n8n کار نکرده‌اند و می‌خواهند بدون پیچیدگی‌های غیرضروری اولین نسخه خود را اجرا کنند.
پیش‌نیازهای نصب n8n
قبل از شروع نصب، بهتر است با چند مورد ضروری آشنا شوید.
۱. انتخاب محیط نصب
برای راه‌اندازی n8n چند انتخاب اصلی دارید:
- n8n Cloud: در این روش نیازی به تهیه سرور و نصب نرم‌افزار ندارید. زیرساخت توسط خود n8n مدیریت می‌شود.
- Self-hosted: در این روش n8n را روی کامپیوتر، سرور شخصی یا VPS خود نصب می‌کنید و مدیریت زیرساخت بر عهده شما خواهد بود.
- اجرای محلی (Local): می‌توانید n8n را برای یادگیری و آزمایش روی سیستم شخصی خود اجرا کنید.
اگر فقط می‌خواهید محیط n8n را امتحان کنید، نسخه Cloud یا اجرای محلی انتخاب مناسبی است. اما اگر قصد دارید از n8n برای اتوماسیون‌های واقعی و دائمی استفاده کنید، بهتر است از ابتدا به راه‌اندازی روی سرور فکر کنید.
۲. آشنایی اولیه با Docker
برای نصب‌های جدید n8n، Docker روش اصلی و پیشنهادی مستندات فعلی است.
Docker به شما اجازه می‌دهد نرم‌افزارها را در محیط‌های مستقل اجرا کنید. در نتیجه، برای راه‌اندازی n8n نیازی نیست تمام وابستگی‌های آن را به‌صورت دستی روی سیستم‌عامل نصب و مدیریت کنید.
برای اجرای دستورات این آموزش به موارد زیر نیاز دارید:
- Docker
- Docker Compose نسخه ۲
- دسترسی به ترمینال یا خط فرمان
- اتصال اینترنت برای دریافت تصاویر Docker
برای بررسی نصب Docker Compose می‌توانید دستور زیر را اجرا کنید:
docker compose version
اگر نسخه‌ای از Docker Compose نمایش داده شد، می‌توانید مراحل بعدی را دنبال کنید.
روش‌های مختلف نصب n8n
پیش از اجرای دستورات، بهتر است روش‌های مختلف نصب را بشناسید.
| روش نصب | کاربرد اصلی | مناسب برای |
|---|---|---|
| n8n Cloud | استفاده بدون مدیریت سرور | کاربران مبتدی و تیم‌ها |
| Docker | اجرای سریع و مستقل | آزمایش و راه‌اندازی ساده |
| Docker Compose | مدیریت سرویس‌ها و تنظیمات | نصب روی سرور و محیط عملیاتی |
| نصب‌های قدیمی npm | اجرای نسخه‌های نصب‌شده قبلی | نگهداری سیستم‌های موجود |
پیشنهاد: برای نصب تازه و خودمیزبانی n8n، Docker و Docker Compose را انتخاب کنید. مستندات جدید n8n از نسخه 3.0 به بعد، توزیع نسخه‌های جدید را به Docker محدود کرده است؛ بنابراین برای نصب‌های تازه، آموزش‌های قدیمی مبتنی بر npm install n8n را بدون بررسی نسخه دنبال نکنید.
آموزش نصب n8n با Docker
یکی از روش‌های ساده برای نصب اولیه n8n، استفاده از اسکریپت رسمی نصب آن است.
این روش به شما کمک می‌کند بدون نوشتن دستی فایل‌های تنظیمات، یک نمونه جدید از n8n را راه‌اندازی کنید.
مرحله اول: نصب Docker
ابتدا باید Docker را روی سیستم خود نصب و اجرا کنید.
اگر از ویندوز استفاده می‌کنید، می‌توانید Docker Desktop را نصب کنید و قابلیت WSL2 را فعال نگه دارید.
اگر از لینوکس یا Ubuntu استفاده می‌کنید، Docker Engine و افزونه Docker Compose را نصب کنید.
پس از نصب، این دو دستور را اجرا کنید:
docker --version
docker compose version
هر دو دستور باید اطلاعات نسخه را نمایش دهند.
مرحله دوم: اجرای اسکریپت رسمی نصب n8n
ترمینال را باز کنید و دستور زیر را اجرا کنید:
curl -fsSL https://get.n8n.io | sh
این دستور اسکریپت نصب رسمی n8n را دریافت و اجرا می‌کند.
اسکریپت به‌صورت خودکار چند کار انجام می‌دهد:
- بررسی می‌کند Docker و Docker Compose نصب و فعال باشند.
- پوشه‌ای با نام
n8nایجاد می‌کند. - فایل‌های تنظیمات موردنیاز را می‌سازد.
- تصاویر Docker مربوط به n8n و سرویس‌های موردنیاز را دریافت می‌کند.
- سرویس‌ها را اجرا می‌کند.
اگر ترجیح می‌دهید قبل از اجرای اسکریپت، محتوای آن را بررسی کنید، ابتدا آن را دانلود کنید:
curl -fsSL https://get.n8n.io -o get-n8n.sh
سپس محتوای فایل را مشاهده کنید:
less get-n8n.sh
پس از بررسی می‌توانید آن را اجرا کنید:
sh get-n8n.sh
مرحله سوم: بررسی اجرای n8n
پس از پایان نصب، معمولاً آدرس دسترسی به n8n در خروجی ترمینال نمایش داده می‌شود.
در نصب محلی، آدرس پیش‌فرض به شکل زیر است:
http://localhost:5678
مرورگر خود را باز کنید و این آدرس را وارد کنید.
اگر همه مراحل به‌درستی انجام شده باشند، صفحه اولیه n8n نمایش داده می‌شود.
مرحله چهارم: ساخت حساب کاربری اولیه
در اولین ورود، n8n از شما می‌خواهد اطلاعات حساب مالک اولیه را وارد کنید.
معمولاً باید اطلاعاتی مانند موارد زیر را تکمیل کنید:
- نام
- نام خانوادگی
- ایمیل
- رمز عبور
پس از ثبت اطلاعات، وارد محیط اصلی n8n خواهید شد.
توجه داشته باشید که این مرحله مربوط به ایجاد حساب کاربری داخل نمونه نصب‌شده n8n است و با ثبت‌نام در سایت رسمی n8n تفاوت دارد.
آشنایی با فایل‌ها و اطلاعات نصب‌شده
پس از نصب n8n، چند فایل و بخش مهم در پوشه پروژه ایجاد می‌شوند.
برای مشاهده فایل‌ها می‌توانید وارد پوشه نصب شوید:
cd n8n
سپس دستور زیر را اجرا کنید:
ls -la
در ساختار نصب رسمی، معمولاً با فایل‌ها و مواردی مانند این‌ها روبه‌رو می‌شوید:
| نام | کاربرد |
|---|---|
compose.yml | تعریف سرویس‌ها و تنظیمات Docker Compose |
.env | نگهداری متغیرهای محیطی و تنظیمات حساس |
searxng-settings.yml | تنظیمات سرویس جست‌وجوی همراه نصب جدید |
n8n-data | محل نگهداری داده‌های پایدار n8n در Volume |
فایل .env اهمیت زیادی دارد؛ زیرا ممکن است اطلاعات محرمانه مانند رمزها و کلیدهای موردنیاز سرویس‌ها در آن قرار داشته باشند.
بنابراین:
- این فایل را در مخازن عمومی Git قرار ندهید.
- دسترسی آن را محدود نگه دارید.
- از اطلاعات حساس آن نسخه پشتیبان تهیه کنید.
دستورات مهم برای مدیریت n8n
پس از نصب، ممکن است بخواهید سرویس را متوقف کنید، دوباره اجرا کنید یا وضعیت آن را بررسی کنید.
اگر از روش نصب رسمی یک‌خطی استفاده کرده‌اید، می‌توانید دستورات زیر را اجرا کنید.
مشاهده وضعیت سرویس‌ها
docker compose -f ./n8n/compose.yml ps
اجرای مجدد n8n
docker compose -f ./n8n/compose.yml up -d
متوقف کردن سرویس‌ها
docker compose -f ./n8n/compose.yml down
مشاهده لاگ‌ها
برای بررسی لاگ سرویس‌ها می‌توانید از دستور زیر استفاده کنید:
docker compose -f ./n8n/compose.yml logs -f
برای مشاهده لاگ یک سرویس مشخص، مثلاً n8n:
docker compose -f ./n8n/compose.yml logs -f n8n
این دستورات در زمان عیب‌یابی بسیار کاربردی هستند.
آیا نصب اولیه n8n برای استفاده عملیاتی کافی است؟
خیر. اجرای موفق n8n به این معنی نیست که سرور شما برای استفاده دائمی و تجاری آماده است.
نصب اولیه بیشتر برای راه‌اندازی و آزمایش محیط کاربرد دارد. اگر می‌خواهید از n8n برای اجرای اتوماسیون‌های مهم کسب‌وکار استفاده کنید، باید موارد دیگری را نیز در نظر بگیرید.
۱. اتصال دامنه
بهتر است به‌جای استفاده مستقیم از IP یا پورت سرور، یک دامنه یا زیردامنه اختصاصی برای n8n در نظر بگیرید.
برای مثال:
n8n.example.com
با این کار کاربران می‌توانند از طریق یک آدرس مشخص به پنل دسترسی داشته باشند.
۲. فعال‌سازی SSL
برای ارتباط امن با پنل n8n باید گواهی SSL نصب کنید و دسترسی از طریق HTTPS را فراهم کنید.
این موضوع به‌خصوص زمانی اهمیت دارد که قرار است اطلاعات ورود، اعتبارنامه سرویس‌ها و داده‌های حساس از طریق پنل مدیریت شوند.
۳. انتخاب دیتابیس مناسب
در نصب ساده، n8n از SQLite استفاده می‌کند.
SQLite برای شروع، یادگیری و پروژه‌های سبک مناسب است؛ اما اگر قصد دارید چندین کاربر و Workflow را به‌صورت دائمی مدیریت کنید، بهتر است PostgreSQL را بررسی کنید.
۴. تهیه نسخه پشتیبان
اطلاعات Workflowها، اعتبارنامه‌ها و تنظیمات n8n ارزش زیادی دارند.
بنابراین باید برای تهیه نسخه پشتیبان منظم از دیتابیس و اطلاعات ضروری برنامه‌ریزی کنید.
۵. تأمین امنیت سرور
مواردی مانند محدودسازی دسترسی به پنل، استفاده از رمز عبور قوی، به‌روزرسانی منظم و محافظت از اطلاعات حساس باید در برنامه راه‌اندازی شما قرار بگیرند.
۶. بررسی منابع سرور
میزان CPU، RAM و فضای ذخیره‌سازی موردنیاز به تعداد Workflowها، تعداد اجراهای هم‌زمان و نوع پردازش‌ها بستگی دارد.
اگر قرار است تعداد زیادی Workflow اجرا شوند یا از پردازش‌های سنگین و هوش مصنوعی استفاده کنید، باید منابع سرور را متناسب با نیاز پروژه انتخاب کنید.
خطاهای رایج هنگام نصب n8n
در زمان نصب ممکن است با چند مشکل متداول روبه‌رو شوید.
خطای Docker پیدا نشد
اگر هنگام اجرای اسکریپت نصب با خطای مربوط به پیدا نشدن Docker مواجه شدید، ابتدا نصب بودن Docker را بررسی کنید:
docker --version
اگر دستور اجرا نشد، باید Docker را نصب کنید.
خطای Docker Compose
برای بررسی نسخه Compose دستور زیر را اجرا کنید:
docker compose version
توجه کنید که نصب جدید n8n به افزونه Docker Compose نسخه ۲ نیاز دارد و دستور قدیمی docker-compose به‌تنهایی جایگزین آن نیست.
باز نشدن پنل n8n
اگر آدرس localhost:5678 باز نمی‌شود، ابتدا وضعیت سرویس‌ها را بررسی کنید:
docker compose -f ./n8n/compose.yml ps
سپس لاگ‌ها را مشاهده کنید:
docker compose -f ./n8n/compose.yml logs -f n8n
همچنین مطمئن شوید پورت موردنیاز توسط برنامه دیگری اشغال نشده باشد.
از دست رفتن اطلاعات پس از حذف کانتینر
یکی از اشتباهات رایج، حذف Volumeهای Docker هنگام پاک‌سازی یا نصب مجدد است.
در نصب رسمی، اطلاعات n8n در Volume پایدار نگهداری می‌شوند. حذف کانتینر به‌تنهایی با حذف Volume یکسان نیست.
برای حذف کامل اطلاعات باید بسیار دقت کنید؛ زیرا دستور زیر Volumeها را نیز حذف می‌کند:
docker compose -f ./n8n/compose.yml down -v
هشدار: این دستور می‌تواند باعث حذف اطلاعات ذخیره‌شده n8n شود. بدون داشتن نسخه پشتیبان از آن استفاده نکنید.
نصب n8n با Docker Compose به‌صورت دستی
اگر به کنترل بیشتری روی تنظیمات نیاز دارید، می‌توانید به‌جای اسکریپت آماده، فایل Compose را خودتان ایجاد کنید.
این روش برای افرادی مناسب است که قصد دارند n8n را در کنار سرویس‌هایی مانند PostgreSQL یا سایر ابزارهای زیرساختی اجرا کنند.
مستندات رسمی n8n یک راهنمای جداگانه برای ساخت محیط Docker Compose ارائه می‌کند که شامل تنظیم سرویس‌ها، Volumeها، متغیرهای محیطی و اتصال PostgreSQL است.
در پروژه‌های عملیاتی، این روش امکان مدیریت دقیق‌تری به شما می‌دهد؛ به‌خصوص اگر قرار باشد چند سرویس مرتبط را در یک ساختار مشخص اجرا کنید.
در مقالات بعدی این مجموعه، نصب n8n با Docker Compose و راه‌اندازی آن روی Ubuntu را به‌صورت جداگانه و مرحله‌به‌مرحله بررسی خواهیم کرد.
جمع‌بندی
نصب n8n اولین قدم برای استفاده از قابلیت‌های اتوماسیون این ابزار است.
اگر قصد دارید فقط با محیط آن آشنا شوید، می‌توانید از نسخه Cloud یا نصب محلی استفاده کنید. اما اگر می‌خواهید کنترل بیشتری روی زیرساخت داشته باشید و n8n را روی سرور خود اجرا کنید، روش Self-hosted گزینه مناسبی خواهد بود.
برای نصب‌های جدید، استفاده از Docker و Docker Compose را پیشنهاد می‌کنیم؛ زیرا مدیریت سرویس‌ها، تنظیمات و داده‌های پایدار را ساده‌تر می‌کند.
البته فراموش نکنید که راه‌اندازی اولیه تنها بخشی از کار است. برای استفاده دائمی باید به امنیت، دامنه، SSL، دیتابیس، بکاپ و منابع سرور نیز توجه داشته باشید.
سوالات متداول
آیا نصب n8n رایگان است؟
نسخه Self-hosted Community Edition را می‌توان بدون پرداخت هزینه اشتراک نرم‌افزار اجرا کرد؛ اما هزینه سرور، نگهداری و زیرساخت بر عهده شماست. همچنین باید شرایط مجوز استفاده از n8n را رعایت کنید.
برای نصب n8n به سرور نیاز داریم؟
خیر. برای یادگیری و آزمایش می‌توانید n8n را روی کامپیوتر شخصی خود اجرا کنید. اما برای اجرای دائمی Workflowها، استفاده از سرور یا سرویس Cloud انتخاب مناسب‌تری است.
بهترین روش نصب n8n چیست؟
برای نصب‌های جدید، Docker و Docker Compose گزینه‌های پیشنهادی هستند. این روش‌ها امکان مدیریت بهتر سرویس‌ها و داده‌ها را فراهم می‌کنند.
پورت پیش‌فرض n8n چیست؟
پورت پیش‌فرض رابط وب n8n عدد 5678 است. در نصب محلی معمولاً از آدرس http://localhost:5678 استفاده می‌کنید.
آیا می‌توان n8n را روی ویندوز نصب کرد؟
بله. می‌توانید از Docker Desktop و WSL2 برای اجرای n8n روی ویندوز استفاده کنید.
آیا بعد از نصب n8n می‌توان دیتابیس آن را تغییر داد؟
بله. n8n از SQLite و PostgreSQL پشتیبانی می‌کند. برای تغییر دیتابیس در یک نمونه فعال باید فرایند انتقال داده‌ها را به‌درستی انجام دهید؛ صرفاً تغییر تنظیمات اتصال، داده‌های دیتابیس قبلی را منتقل نمی‌کند.
آیا نصب n8n با npm هنوز امکان‌پذیر است؟
روش npm در نصب‌های قدیمی همچنان ممکن است کار کند، اما طبق مستندات فعلی، از نسخه 3.0 توزیع جدید n8n فقط از طریق Docker انجام می‌شود. بنابراین برای نصب تازه بهتر است از روش Docker استفاده کنید.
