خلاصه سریع: اجرای n8n به صورت محلی نیازمند npm (Node.js 20.19-24.x) یا Docker است. سریعترین روش از npx n8n برای تست فوری بدون نیاز به نصب استفاده میکند، در حالی که Docker جداسازی بهتر و آمادگی برای تولید را فراهم میکند. هر دو روش به شما دسترسی کامل به قابلیتهای اتوماسیون گردش کار n8n را بدون هزینههای ابری تکراری میدهند.
راهاندازی n8n روی یک دستگاه محلی، هزینههای اشتراک تکراری را حذف میکند و در عین حال کنترل کاملی بر اتوماسیون گردش کار فراهم میآورد. طبق مستندات رسمی n8n، این پلتفرم برای نصبهای npm به نسخه Node.js بین 20.19 و 24.x یا Docker برای استقرار کانتینری نیاز دارد.
تصمیمگیری بین میزبانی محلی و خدمات ابری هم بر بودجه و هم بر انعطافپذیری تأثیر میگذارد. طبق بحثهای جامعه کاربران، نصبهای محلی گردش کارهای نامحدود را مدیریت میکنند، در حالی که طرحهای ابری شامل قیمتگذاری مبتنی بر اجرا هستند (طبق گزارش برخی کاربران، از 24 دلار در ماه برای 2500 اجرا شروع میشود).
پیشنیازهای نصب محلی
قبل از نصب n8n به صورت محلی، سیستم به نرمافزارهای خاصی بسته به روش انتخابی نیاز دارد.
نسخه Node.js مورد نیاز برای نصب npm کاملاً به الزامات خاص نسخه n8n که در حال استقرار آن هستید بستگی دارد، زیرا خود npm با تمام نسخههای LTS فعلی پشتیبانی شده Node.js سازگار است. مستندات رسمی این دامنه نسخه دقیق را برای سازگاری مشخص میکند. نسخه فعلی را با اجرای node –version در ترمینال بررسی کنید.
نصبهای Docker به Docker Engine یا Docker Desktop نیاز دارند. تیم n8n Docker را برای اکثر نیازهای میزبانی شخصی توصیه میکند زیرا جداسازی تمیز را فراهم میکند و از ناسازگاریهای سیستم عامل جلوگیری میکند.
الزامات سیستم
نمونههای محلی n8n روی سیستمهای Windows، macOS و Linux اجرا میشوند. هیچ مشخصات حداقل RAM در مستندات رسمی ذکر نشده است، اما پیچیدگی گردش کار، نیازهای واقعی منابع را تعیین میکند.
نصب در ابتدا فضای دیسک کمی مصرف میکند. نیازهای ذخیرهسازی بر اساس دادههای گردش کار، تاریخچه اجرا و بستههای نود سفارشی افزایش مییابد.
روش 1: اجرای n8n با npm
نصب npm سریعترین راه برای اجرای n8n به صورت محلی را فراهم میکند. این روش بدون کانتینرسازی مستقیماً روی سیستم میزبان کار میکند.
شروع سریع با npx
سادهترین رویکرد از npx بدون نصب دائمی استفاده میکند. یک ترمینال را باز کنید و اجرا کنید:
| npx n8n |
این دستور همه چیز مورد نیاز را دانلود کرده و n8n را به طور خودکار راهاندازی میکند. رابط کاربری در عرض چند ثانیه در localhost:5678 قابل دسترسی میشود.
روش npx برای تست و ارزیابی کاملاً کار میکند. نیازی به بستههای npm سراسری یا تغییرات دائمی سیستم ندارد.
نصب npm سراسری
برای نصب دائمی، بسته npm سراسری دسترسی مداومی را فراهم میکند:
| npm install n8n -g |
پس از اتمام نصب، با اجرای دستور زیر هر زمان که بخواهید n8n را راهاندازی کنید:
| n8n |
نسخه پایدار اصلی فعلی n8n 2.x است (به عنوان مثال، 2.10.4). نسخههای بتا ممکن است شامل ویژگیهای ناپایدار باشند و باید برای گردش کارهای تولیدی از آنها اجتناب شود.
پیکربندی و ذخیرهسازی دادهها
نصبهای npm به طور پیشفرض دادههای گردش کار را در دایرکتوری ~/.n8n ذخیره میکنند. این مکان شامل اعتبارنامهها، تعاریف گردش کار و تاریخچه اجرا است.
متغیرهای محیطی رفتار n8n را کنترل میکنند. متغیر N8N_PORT را برای تغییر پورت پیشفرض 5678 تنظیم کنید. متغیرهای دیگر، اتصالات پایگاه داده، URLهای وبهوک و تنظیمات احراز هویت را پیکربندی میکنند.
روش 2: اجرای n8n با Docker
نصب Docker بهترین رویکرد برای میزبانی محلی n8n است. مستندات رسمی بر Docker برای نیازهای میزبانی شخصی تولیدی تأکید میکند.
دستور پایه اجرای Docker
n8n را با یک دستور Docker واحد راهاندازی کنید:
| docker run -it –rm –name n8n -p 5678:5678 -v ~/.n8n:/home/node/.n8n n8nio/n8n |
این دستور یک کانتینر به نام n8n ایجاد میکند، پورت 5678 را به هاست نگاشت میکند و دادهها را در دایرکتوری ~/.n8n حفظ میکند.
کانتینر به صورت تعاملی با پرچم -it اجرا میشود. برای نگه داشتن کانتینر پس از توقف آن، –rm را حذف کنید.
Docker Compose برای راهاندازی تولید
پیکربندیهای Docker Compose کنترل بهتری را برای محیطهای تولیدی فراهم میکنند. مخزن n8n-hosting در GitHub حاوی فایلهای Docker Compose آماده استفاده برای معماریهای مختلف است.
یک پیکربندی پایه docker-compose.yml به این شکل است:
| version: ‘3.8’ services: n8n: image: n8nio/n8n restart: always ports: – “5678:5678” environment: – N8N_BASIC_AUTH_ACTIVE=true – N8N_BASIC_AUTH_USER=admin – N8N_BASIC_AUTH_PASSWORD=password volumes: – ~/.n8n:/home/node/.n8n |
پشته را با دستور زیر راهاندازی کنید:
| docker-compose up -d |
پرچم -d کانتینرها را در حالت جدا شده اجرا میکند و امکان استفاده از ترمینال برای کارهای دیگر را فراهم میسازد.
پیکربندی اولیه و دسترسی
پس از راهاندازی n8n از طریق هر یک از روشها، به localhost:5678 در مرورگر وب خود بروید. صفحه راهاندازی اولیه، آدرس ایمیل و رمز عبور را برای حساب مدیر درخواست میکند.
این کاربر اول صاحب نمونه با اختیارات کامل مدیریتی خواهد شد. کاربران اضافی را میتوان بعداً از طریق رابط مدیریت کاربر اضافه کرد.
تنظیم احراز هویت
برای امنیت، حتی در نصبهای محلی نیز احراز هویت را فعال کنید. پیکربندیهای Docker Compose متغیرهای محیطی احراز هویت را مستقیماً میپذیرند:
| N8N_BASIC_AUTH_ACTIVE=true N8N_BASIC_AUTH_USER=admin N8N_BASIC_AUTH_PASSWORD=strongpassword |
این متغیرها احراز هویت اساسی HTTP را فعال میکنند و برای تمام تلاشهای دسترسی نیاز به اعتبارنامه دارند.
تست نودهای سفارشی به صورت محلی
مستندات رسمی نحوه تست نودهای سفارشی را در حین توسعه توضیح میدهد. ابتدا n8n را به صورت سراسری نصب کنید، سپس بسته نود سفارشی را بسازید و لینک کنید.
در دایرکتوری نود سفارشی، اجرا کنید:
| npm run build npm link |
سپس به دایرکتوری نودهای n8n (معمولاً ~/.n8n/custom/) رفته و بسته را لینک کنید:
| npm link <node-package-name> |
نود سفارشی پس از راهاندازی مجدد نمونه در رابط کاربری n8n ظاهر میشود.
منابع مفید اتوماسیون برای استفاده با n8n
اگر در حال یادگیری نحوه اجرای n8n به صورت محلی هستید و گردش کارها را روی دستگاه خود تست میکنید، ممکن است از ابزارها و الگوهای خارجی که اتوماسیون وظایف رایج را آسانتر میکنند نیز بهرهمند شوید. Get AI Perks مجموعهای از الگوهای گردش کار و ابزارهای کمکی هوش مصنوعی را ارائه میدهد که میتوانید در کنار n8n از آنها استفاده کنید یا ایدههای اتوماسیون را قبل از ساخت خودتان نمونهسازی کنید.
با Get AI Perks، میتوانید:
- با الگوهای گردش کار از پیش ساخته شده شروع کنید
- برای منطق و محتوای روتین از هوش مصنوعی کمک بگیرید
- قبل از پیادهسازی در n8n، الگوهای رایج اتوماسیون را بررسی کنید
- الگوها را با راهاندازی محلی n8n خود ترکیب کنید
Get AI Perks را کشف کنید تا ابزارهای کمکی اتوماسیون را بیابید که از گردش کارهای n8n شما پشتیبانی میکنند.
عیبیابی مسائل رایج
تداخل پورتها رایجترین مشکل نصب است. اگر پورت 5678 از قبل استفاده شده است، یا سرویس تداخلکننده را متوقف کنید یا پورت n8n را با استفاده از متغیر محیطی N8N_PORT تغییر دهید.
ناسازگاری نسخه Node
استفاده از نسخههای Node.js خارج از دامنه 20.19-24.x منجر به شکست نصب میشود. مخزن GitHub n8n مسائل مربوط به تلاش توسعهدهندگان برای محیطهای توسعه محلی را مستند میکند و بر اهمیت سازگاری نسخه Node تأکید دارد.
قبل از عیبیابی سایر مسائل، سازگاری نسخه Node را تأیید کنید. در صورت نیاز، نسخههای Node را با استفاده از nvm (Node Version Manager) تغییر دهید.
خطاهای مجوز Volume Docker
مشکلات مجوز با مانت Volume ~/.n8n از پایدارسازی دادهها جلوگیری میکند. کانتینرهای Docker به عنوان کاربر node اجرا میشوند که ممکن است دسترسی نوشتن به دایرکتوری هاست را نداشته باشد.
قبل از راهاندازی کانتینر، دایرکتوری را با مجوزهای مناسب ایجاد کنید:
| mkdir ~/.n8n chmod 777 ~/.n8n |
سوالات متداول
آیا n8n میتواند بدون دسترسی به اینترنت اجرا شود؟
بله، n8n کاملاً آفلاین برای گردش کارهای محلی کار میکند. اتصال به اینترنت تنها زمانی لازم میشود که گردش کارها با APIهای خارجی یا خدمات ابری تعامل داشته باشند.
اجرای n8n به صورت محلی چقدر هزینه دارد؟
نصبهای محلی رایگان هستند. نسخه جامعه تمام ویژگیهای اصلی را بدون هزینههای لایسنس ارائه میدهد. میزبانی ابری با محدودیتهای اجرا و هزینههای ماهانه شروع میشود، اما میزبانی محلی طبق بحثهای جامعه این محدودیتها را کاملاً حذف میکند.
مبتدیان باید از npm یا Docker استفاده کنند؟
مبتدیانی که n8n را تست میکنند باید با npx برای دسترسی فوری شروع کنند. Docker برای استفاده مداوم منطقیتر است زیرا جداسازی بهتر و ارتقاهای آسانتری را فراهم میکند.
n8n دادههای گردش کار را به صورت محلی کجا ذخیره میکند؟
دایرکتوری پیشفرض دادهها ~/.n8n در پوشه اصلی کاربر است. این مکان شامل فایلهای پایگاه داده SQLite، اعتبارنامهها و لاگهای اجرا است مگر اینکه به طور دیگری پیکربندی شده باشد.
آیا چندین نمونه n8n میتوانند روی یک دستگاه اجرا شوند؟
بله، اما هر نمونه به یک پورت منحصر به فرد نیاز دارد. پورتهای مختلف را با استفاده از متغیر محیطی N8N_PORT برای هر نمونه تنظیم کنید. Docker از طریق نگاشت پورت در کانتینرهای جداگانه این کار را آسانتر میکند.
بهروزرسانیها برای نصبهای محلی چگونه کار میکنند؟
نصبهای npm از طریق npm update -g n8n یا npm install -g n8n@latest بهروزرسانی میشوند. کاربران Docker با docker pull n8nio/n8n آخرین ایمیج را میکشند، سپس کانتینرها را بازسازی میکنند. همیشه قبل از بهروزرسانی از دایرکتوری ~/.n8n پشتیبان تهیه کنید.
ملاحظات تولید
مستندات رسمی n8n تأکید میکند که میزبانی شخصی نیازمند دانش فنی است. راهاندازی سرورها، مدیریت منابع و ایمنسازی برنامهها نیازمند تجربه در مدیریت سیستم است.
برای استقرارهای تولیدی، Docker Compose اساس کار را فراهم میکند. برای پشتیبانی HTTPS، یک پروکسی معکوس مانند nginx یا Caddy اضافه کنید. مخزن n8n-hosting شامل پیکربندیهای Caddy آماده برای استقرار است.
انتخاب پایگاه داده برای حجم کاری سنگین مهم است. پایگاه داده پیشفرض SQLite برای استفاده متوسط کار میکند، اما PostgreSQL طبق راهنمایی رسمی، عملکرد بهتری برای اتوماسیون با حجم بالا ارائه میدهد.
انتخاب: محلی در مقابل ابری
میزبانی محلی n8n برای تیمهایی با قابلیتهای فنی و الزامات امنیتی خاص مناسب است. دادهها در زیرساخت کنترل شده باقی میمانند و محدودیتهای اجرا از بین میروند.
با این حال، میزبانی محلی نیازمند نگهداری، پشتیبانگیری و نظارت است. میزبانی ابری این مسئولیتها را به تیم زیرساخت n8n منتقل میکند. برای قیمتگذاری فعلی ابری و مقایسه ویژگیها، وبسایت رسمی را بررسی کنید.
اجرای n8n به صورت محلی، کنترل کاملی بر زیرساخت اتوماسیون گردش کار را فراهم میکند. چه برای تست سریع از npm استفاده کنید و چه برای استقرارهای تولیدی از Docker، هر دو روش پلتفرم کامل را بدون هزینههای تکراری ارائه میدهند. برای کاوش فوری با npx شروع کنید، سپس زمانی که گردش کارها به سمت استفاده در تولید حرکت میکنند، به Docker منتقل شوید.
