n8n را می‌توانید روی ویندوز خودتان نصب کنید و بدون هزینه یادش بگیرید و ورک‌فلو بسازید. در این آموزش دو روش را می‌بینید: Docker Desktop که روش پیشنهادی و ماندگار است، و npm که سریع‌ترین راه برای تست است.
پیش‌نیازها
- ویندوز ۱۰ یا ۱۱ نسخه‌ی ۶۴ بیتی
- حداقل ۴ گیگابایت رم (۸ گیگ برای Docker راحت‌تر است)
- دسترسی Administrator به سیستم
روش ۱: نصب n8n روی ویندوز با داکر (پیشنهادی)
۱. فعال کردن WSL
Docker Desktop روی ویندوز به WSL2 نیاز دارد. PowerShell را با Run as administrator باز کنید و این دستور را بزنید، سپس سیستم را ری‌استارت کنید:
wsl --installاگر خطای مجازی‌سازی (Virtualization) گرفتید، باید گزینه‌ی Virtualization یا SVM را در تنظیمات BIOS سیستم فعال کنید. اگر دانلود WSL با خطا متوقف شد یا Docker Desktop نصب نشد، راه‌حل کامل را در آموزش نصب داکر روی ویندوز ببینید.
۲. نصب Docker Desktop
Docker Desktop را از صفحه‌ی دانلود Docker Desktop دانلود و نصب کنید و یک بار اجرایش کنید تا آیکون نهنگ در کنار ساعت ویندوز ظاهر شود. برای بیشتر سیستم‌ها (پردازنده‌های Intel و AMD) گزینه‌ی Download for Windows – AMD64 را انتخاب کنید. نسخه‌ی ARM64 فقط برای لپ‌تاپ‌هایی با پردازنده‌ی ARM مثل Snapdragon است.
دانلود Docker Desktop و ایمیج‌ها از داخل ایران ممکن است با خطای 403 روبه‌رو شود. در این صورت باید یک Registry Mirror داخلی را در Settings → Docker Engine تنظیم کنید.
۳. اجرای n8n
PowerShell را باز کنید و این دستور را در یک خط اجرا کنید:
docker run -d --name n8n --restart unless-stopped -p 5678:5678 -e GENERIC_TIMEZONE=Asia/Tehran -e TZ=Asia/Tehran -v n8n_data:/home/node/.n8n docker.n8n.io/n8nio/n8n
-v n8n_data باعث می‌شود ورک‌فلوها با حذف یا آپدیت کانتینر پاک نشوند. از این به بعد هر وقت Docker Desktop باز باشد، n8n هم خودکار اجرا می‌شود.
در Docker Desktop، بخش Containers باید n8n را با نقطه‌ی سبز (در حال اجرا) و پورت 5678:5678 ببینید:
۴. ورود به n8n
در مرورگر آدرس http://localhost:5678 را باز کنید و حساب مدیر (Owner) را بسازید:
بعد از ساخت حساب، صفحه‌ی اصلی n8n باز می‌شود و می‌توانید اولین ورک‌فلو را بسازید. تمام!
روش ۲: نصب n8n روی ویندوز با npm (برای تست سریع)
توجه: از نسخه‌ی ۳ n8n (نسخه‌ی پایدار آن آذر ۱۴۰۵ منتشر می‌شود) نصب با npm دیگر پشتیبانی نمی‌شود. نسخه‌ی ۲ تا یک سال بعد از آن وصله‌های امنیتی می‌گیرد. برای استفاده‌ی طولانی‌مدت، روش داکر را انتخاب کنید.
- Node.js نسخه‌ی ۲۴ را از سایت nodejs.org نصب کنید. دقت کنید نسخه‌ی LTS فعلی سایت (۲۶) با n8n سازگار نیست؛ n8n فقط با Node.js نسخه‌ی ۲۰.۱۹ تا ۲۴ کار می‌کند. بعد از نصب، با دستور
node -vنسخه را چک کنید. - Command Prompt (cmd) را باز کنید و n8n را نصب کنید:
npm install -g n8n@2سپس n8n را اجرا کنید و آدرس http://localhost:5678 را در مرورگر باز کنید:
n8nتا وقتی پنجره‌ی cmd باز است، n8n اجرا می‌ماند. با بستن پنجره، n8n هم متوقف می‌شود.
مشکلات رایج
خطای Installation failed. One prerequisite is not fulfilled هنگام نصب Docker Desktop: یعنی قابلیت Virtual Machine Platform ویندوز فعال نیست. این خطا معمولاً وقتی پیش می‌آید که مرحله‌ی فعال کردن WSL انجام نشده باشد.
دو راه‌حل دارید: یا دستور wsl --install را در PowerShell با Run as administrator اجرا کنید، سیستم را ری‌استارت کنید و نصب‌کننده را دوباره اجرا کنید؛ یا نصب‌کننده را دوباره اجرا کنید و گزینه‌ی All-users installation را انتخاب کنید تا خودش این قابلیت را فعال کند.
- خطای running scripts is disabled در PowerShell: دستورهای npm را در cmd اجرا کنید، یا یک بار این دستور را بزنید:
Set-ExecutionPolicy -Scope CurrentUser RemoteSigned - صفحه‌ی localhost:5678 باز نمی‌شود: مطمئن شوید Docker Desktop باز است و کانتینر n8n در آن وضعیت Running دارد.
- خطای port is already allocated: برنامه‌ی دیگری از پورت 5678 استفاده می‌کند. در دستور داکر
-p 5679:5678بگذارید و از آدرس localhost:5679 وارد شوید.
چرا برای استفاده‌ی دائمی، سرور لازم دارید؟
نصب روی ویندوز برای یادگیری و تست عالی است، ولی برای کار واقعی دو مشکل جدی دارد:
- با خاموش شدن یا Sleep سیستم، ورک‌فلوها متوقف می‌شوند و کارهای زمان‌بندی‌شده اجرا نمی‌شوند.
- وبهوک‌ها از بیرون کار نمی‌کنند. سرویس‌هایی مثل تلگرام، بله یا درگاه پرداخت نمی‌توانند به آدرس localhost کامپیوتر شما پیام بفرستند.
وقتی ورک‌فلوهایتان آماده‌ی استفاده‌ی واقعی شد، n8n را روی سرور مجازی نصب کنید (آموزش نصب n8n روی سرور مجازی) یا سرور n8n آماده بگیرید. ورک‌فلوها را می‌توانید از n8n ویندوز به صورت فایل JSON خروجی بگیرید و در سرور وارد کنید.
سؤالات متداول
آیا روی مک هم همین روش کار می‌کند؟
بله. Docker Desktop را برای مک نصب کنید و همان دستور docker run را در Terminal اجرا کنید. در مک به WSL نیازی نیست.
روی ویندوز سرور چطور؟
اجرای Docker روی ویندوز سرور پیچیده‌تر است. برای سرور، لینوکس انتخاب ساده‌تر و پایدارتری است؛ روش‌های مختلف را در مقایسه روش‌های نصب n8n ببینید.
