به اشتراک بگذارید
آموزش سرور | بلاگ وبداده
نصب n8n روی سرور لینوکس؛ راهاندازی اتوماسیون در چند دقیقه
از نصب با Docker تا روش npm و اتصال امن، گامبهگام یاد میگیرید چطور پلتفرم اتوماسیون n8n را روی سرور لینوکسی خودتان راه بیندازید.
نصب n8n روی سرور لینوکس به شما اجازه میدهد یک پلتفرم اتوماسیون قدرتمند و خودمیزبان داشته باشید و گردشکارهای خود را بدون وابستگی به سرویسهای ابری گران اجرا کنید. در این راهنما ابتدا توضیح میدهیم n8n چیست و چرا خودمیزبانی آن ارزشمند است، سپس پیشنیازها را در قالب یک چکلیست مرور میکنیم، بعد دو روش رسمی نصب (Docker و npm) را مرحلهبهمرحله پیش میرویم، آنها را در یک جدول کنار هم میگذاریم، و در پایان نکات امنیتی، اجرای حرفهای با PostgreSQL، عیبیابی و محدودیتها را صادقانه بررسی میکنیم تا از صفر تا صد بدون گیر کردن کار را انجام دهید.
- روش پیشنهادی رسمی: n8n برای اکثر نیازهای خودمیزبانی، نصب با Docker را توصیه میکند.
- پورت پیشفرض: پنل n8n روی پورت
5678بالا میآید (مثلاً http://localhost:5678). - نیازمندی Node.js: برای نصب با npm به نسخه Node.js بین 20.19 و 24.x نیاز دارید.
- دیتابیس: دیتابیس پیشفرض SQLite است؛ برای محیط پروداکشن PostgreSQL پیشنهاد میشود.
- امنیت کلیدی: پنل را پشت HTTPS و یک reverse proxy قرار دهید و مستقیم روی اینترنت باز نگذارید.
در یک جمله
n8n مثل یک «خط مونتاژ دیجیتال» است که اپلیکیشنها و سرویسهای مختلف شما را به هم وصل میکند و کارهای تکراری را خودکار میکند — و برای اجرای پایدار و همیشهروشن آن میتوانید سرور لینوکس را از وبداده تهیه کنید.
حتماً این مقاله را باز کردهاید چون میخواهید کنترل کامل دادهها و گردشکارهای خود را داشته باشید اما نمیدانید از کجا شروع کنید. در ادامه بهجای کلیگویی، یک مسیر روشن و عملی با دستورهای واقعی و تاییدشده پیش پایتان میگذاریم.
نصب n8n؛ این ابزار اتوماسیون چیست و چرا خودمیزبانی؟
n8n یک پلتفرم اتوماسیون گردشکار (workflow automation) متنباز است که به شما اجازه میدهد سرویسها، APIها و اپلیکیشنهای مختلف را بدون نوشتن کدِ زیاد به هم متصل کنید. هر گردشکار از مجموعهای «نود» تشکیل میشود که هرکدام یک کار مشخص انجام میدهند: دریافت داده، تبدیل آن، ارسال پیام، نوشتن در دیتابیس و مانند اینها. نتیجه، خودکارسازی کارهای تکراری بدون دخالت دستی است.
تفاوت اصلی n8n با سرویسهای مشابه ابری در «خودمیزبانی» است. وقتی n8n را روی سرور خودتان نصب میکنید، دادهها از سرور شما خارج نمیشوند، محدودیت تعداد اجرا یا هزینههای پلکانی ندارید و کنترل کاملی روی نسخه و افزونهها دارید. به همین دلیل بسیاری از تیمها ترجیح میدهند بهجای پرداخت ماهانه، آن را روی یک سرور لینوکسی اجرا کنند.
نکتهای که باید همین ابتدا بدانید: طبق مستندات رسمی، n8n برای اکثر نیازهای خودمیزبانی نصب با Docker را توصیه میکند، چون محیطی ایزوله و تمیز فراهم میکند و از ناسازگاری نسخهها جلوگیری میکند. روش جایگزین، نصب مستقیم با npm است که برای تست و محیطهای ساده مناسبتر است.
تشبیه ساده
اگر سرویسهای آنلاین شما (ایمیل، تلگرام، گوگلشیت، دیتابیس و…) را مثل ماشینهای جدا در یک کارخانه تصور کنید، n8n همان نوار نقالهای است که این ماشینها را به هم وصل میکند تا محصول (نتیجه) بدون جابهجایی دستی از یکی به دیگری برسد. خودمیزبانی یعنی این کارخانه در زمین خودِ شماست، نه اجارهای.
پیشنیازهای راهاندازی n8n روی سرور لینوکس
پیش از اجرای دستورها، خوب است مطمئن شوید این چند مورد آماده است. نبودِ هرکدام معمولاً عامل خطاهای ابتدای کار است:
۱) سرور لینوکس و دسترسی
یک سرور مجازی یا اختصاصی با توزیع رایج (اوبونتو، دبیان یا CentOS) و دسترسی به یک کاربر با مجوز sudo. اتصال از طریق SSH انجام میشود.
۲) Docker یا Node.js
برای روش پیشنهادی به Docker نیاز دارید؛ برای روش جایگزین به Node.js نسخه 20.19 تا 24.x. در ادامه نصب هر دو را نشان میدهیم.
۳) دامنه و پورت باز
برای دسترسی امن از بیرون، یک دامنه یا سابدامین و باز بودن پورت 5678 (یا 443 پشت reverse proxy) لازم است.
اگر هنوز با نحوه ورود به سرور آشنا نیستید، پیشنهاد میکنیم ابتدا راهنمای آموزش اتصال به سرور لینوکس و در صورت نیاز اتصال به SSH را مرور کنید تا مراحل بعد روانتر پیش برود.
آموزش گامبهگام نصب و راهاندازی
در این بخش مسیر اصلی را با Docker (روش توصیهشده رسمی) پیش میرویم و سپس روش npm را هم جداگانه میآوریم. هر مرحله را تا کامل نشده رها نکنید و دستورها را عیناً اجرا کنید.
مرحله ۱: آمادهسازی سرور و نصب Docker
ابتدا سیستم را بهروز کنید و اگر Docker نصب نیست، آن را با اسکریپت رسمی داکر نصب کنید. سپس کاربر فعلی را به گروه docker اضافه کنید تا بدون sudo کار کنید:
# ۱) بهروزرسانی فهرست بستهها روی اوبونتو/دبیان
sudo apt update && sudo apt upgrade -y
# ۲) نصب Docker Engine با اسکریپت رسمی داکر
curl -fsSL https://get.docker.com -o get-docker.sh
sudo sh get-docker.sh
# ۳) اجرای داکر بدون sudo (کاربر فعلی به گروه docker اضافه میشود)
sudo usermod -aG docker $USER
# پس از این دستور یکبار از سرور خارج و دوباره وارد شوید
# ۴) بررسی نصب
docker --versionمرحله ۲: اجرای n8n با Docker
حالا یک volume برای نگهداری دائمی دادهها میسازیم و کانتینر n8n را اجرا میکنیم. متغیر تایمزون را متناسب با منطقه خود تنظیم کنید (مثلاً
Asia/Tehran). این دستورها عیناً از مستندات رسمی n8n گرفته شدهاند:# ساخت یک volume برای نگهداری دائمی دادهها
docker volume create n8n_data
# اجرای n8n (بهجای <YOUR_TIMEZONE> منطقه زمانی خود را بگذارید، مثلاً Asia/Tehran)
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 \
-e N8N_RUNNERS_ENABLED=true \
-v n8n_data:/home/node/.n8n \
docker.n8n.io/n8nio/n8n
# اکنون پنل در آدرس http://localhost:5678 در دسترس استبررسی صحت عملکرد
اگر همهچیز درست باشد، در خروجی ترمینال پیام آمادهبودن n8n را میبینید و با باز کردن
http://SERVER_IP:5678 در مرورگر، صفحه ساخت حساب کاربری مدیر ظاهر میشود. اگر صفحه باز نشد، اول باز بودن پورت 5678 در فایروال و سپس وضعیت کانتینر را با docker ps بررسی کنید.مرحله ۳: روش جایگزین — نصب با npm
اگر نمیخواهید از Docker استفاده کنید، میتوانید n8n را مستقیماً با npm نصب کنید. فقط دقت کنید که طبق مستندات رسمی، نسخه Node.js باید بین 20.19 و 24.x باشد:
# n8n به نسخه Node.js بین 20.19 تا 24.x نیاز دارد
# تست سریع بدون نصب دائمی
npx n8n
# یا نصب سراسری با npm
npm install n8n -g
# اجرای n8n
n8n start
# بهروزرسانی به آخرین نسخه پایدار
npm update -g n8nهشدار امنیتی مهم
هرگز پنل n8n را بدون لایه امنیتی مستقیماً روی اینترنت باز نگذارید. پنل را پشت یک reverse proxy (مثل Nginx یا Traefik) با گواهی SSL/TLS قرار دهید، احراز هویت را فعال کنید و در صورت امکان دسترسی را به IPهای مشخص محدود نمایید. اجرای سرویس بدون HTTPS، دادهها و کلیدهای اتصال شما را در معرض خطر قرار میدهد.
مرحله ۴: اجرای حرفهای با PostgreSQL
دیتابیس پیشفرض n8n همان SQLite است که برای استفاده شخصی و چند گردشکار کافی است. اما برای محیط پروداکشن و حجم بالای اجرا، استفاده از PostgreSQL توصیه میشود. کافی است متغیرهای محیطی دیتابیس را به دستور Docker اضافه کنید:
# اجرای n8n با دیتابیس PostgreSQL بهجای SQLite پیشفرض
docker run -it --rm \
--name n8n \
-p 5678:5678 \
-e GENERIC_TIMEZONE="Asia/Tehran" \
-e TZ="Asia/Tehran" \
-e DB_TYPE=postgresdb \
-e DB_POSTGRESDB_DATABASE=n8n \
-e DB_POSTGRESDB_HOST=postgres \
-e DB_POSTGRESDB_PORT=5432 \
-e DB_POSTGRESDB_USER=n8n \
-e DB_POSTGRESDB_PASSWORD=<POSTGRES_PASSWORD> \
-v n8n_data:/home/node/.n8n \
docker.n8n.io/n8nio/n8n
Docker یا npm؟ کدام روش نصب برای شما مناسب است
هر دو روش معتبرند، اما برای کاربردهای متفاوت ساخته شدهاند. جدول زیر تفاوتهای کلیدی را کنار هم میگذارد تا انتخاب آگاهانهای داشته باشید:
| معیار | روش Docker (توصیهشده) | روش npm |
|---|---|---|
| پیشنیاز اصلی | نصب Docker Engine | Node.js نسخه 20.19 تا 24.x |
| محیط اجرا | ایزوله و تمیز در کانتینر | مستقیم روی سیستمعامل میزبان |
| بهروزرسانی | docker pull و اجرای مجدد | npm update -g n8n |
| مناسب برای | پروداکشن و اجرای پایدار | تست سریع و محیطهای ساده |
| مدیریت وابستگیها | خودکار، بدون تداخل نسخه | وابسته به نسخه Node.js میزبان |
| توصیه رسمی n8n | روش پیشنهادی برای اکثر موارد | گزینه جایگزین |
بهطور خلاصه، اگر قصد اجرای جدی و بلندمدت دارید، نصب با Docker روی یک سرور مجازی پایدار انتخاب امنتری است؛ و اگر فقط میخواهید n8n را امتحان کنید، روش npx یا npm سریعتر است.
از منابع معتبر
طبق مستندات رسمی n8n: «خودمیزبانی برای کاربران متخصص توصیه میشود. اشتباه میتواند به از دست رفتن داده، مشکلات امنیتی و downtime منجر شود. اگر در مدیریت سرور تجربه ندارید، n8n Cloud پیشنهاد میشود.» منبع: n8n Docs — Docker Installation.
بهروزرسانی n8n به آخرین نسخه
n8n مرتباً نسخههای جدید با قابلیتها و وصلههای امنیتی منتشر میکند. در روش Docker کافی است ایمیج جدید را دریافت و کانتینر را با همان volume داده دوباره اجرا کنید تا دادههایتان حفظ شوند:
# دریافت آخرین نسخه ایمیج n8n
docker pull docker.n8n.io/n8nio/n8n
# پیدا کردن شناسه کانتینر در حال اجرا
docker ps -a
# توقف و حذف کانتینر قدیمی (بهجای <id> شناسه واقعی را بگذارید)
docker stop <id>
docker rm <id>
# اجرای مجدد با همان volume داده (دادهها حفظ میشوند)عیبیابی مشکلات رایج
اگر پنل بالا نیامد یا اتصال برقرار نشد، معمولاً یکی از این موارد دلیلش است. قبل از هر تغییر بزرگ، این فهرست را مرور کنید:
- صفحه باز نمیشود: بررسی کنید پورت 5678 در فایروال سرور باز باشد و کانتینر با
docker psدر حال اجرا باشد. - کانتینر بلافاصله بسته میشود: لاگ را با
docker logs n8nببینید؛ اغلب بهخاطر مجوز فایل تنظیمات یا متغیر اشتباه است. - خطای نسخه Node.js در روش npm: مطمئن شوید نسخه Node بین 20.19 و 24.x است؛ نسخههای قدیمیتر یا جدیدتر پشتیبانی نمیشوند.
- وبهوکها کار نمیکنند: برای دسترسی بیرونی باید آدرس عمومی (دامنه/HTTPS) و متغیر WEBHOOK_URL درست تنظیم شده باشد.
- دادهها بعد از ریاستارت پاک میشوند: یعنی volume به درستی mount نشده؛ از وجود
-v n8n_data:/home/node/.n8nمطمئن شوید.
محدودیتها و نکاتی که باید بدانید
خودمیزبانی n8n مزایای زیادی دارد، اما بیهزینه و بیعیب نیست. شناخت این محدودیتها کمک میکند انتظار درستی داشته باشید:
- مسئولیت نگهداری با شماست: بهروزرسانی، بکاپ، امنیت و رفع خطا برعهده خودتان است؛ خود n8n خودمیزبانی را برای کاربران متخصص توصیه میکند.
- نیاز به دانش سرور: برای پیکربندی reverse proxy، SSL و فایروال به دانش پایه مدیریت لینوکس نیاز دارید.
- ریسک از دست رفتن داده: بدون بکاپ منظم از volume و دیتابیس، یک خطا میتواند گردشکارها را از بین ببرد.
- SQLite برای پروداکشن کافی نیست: در حجم بالای اجرا باید به PostgreSQL مهاجرت کنید که خود تنظیمات بیشتری میخواهد.
- منابع سرور: اجرای پایدار و همزمانِ چند گردشکار سنگین، به رم و پردازنده کافی نیاز دارد.
برای آشنایی بیشتر با اصول ایمنسازی، راهنمای تأمین امنیت سرور مجازی میتواند نقطه شروع خوبی باشد.
اجرای پایدار n8n روی زیرساخت وبداده
برای اینکه اتوماسیونهای شما همیشه روشن و در دسترس بمانند، به سروری نیاز دارید که هم منابع کافی داشته باشد و هم اتصال شبکه باکیفیت. در وبداده، سرور مجازی لینوکس با همین هدف فراهم شده تا بتوانید توزیع دلخواه را نصب کنید، Docker را بالا بیاورید و کنترل کامل روی محیط n8n خود داشته باشید.
✅ زیرساخت نسل جدید HPE (Gen11 و Gen10) برای پایداری و کارایی بالای اجرای گردشکارها.
✅ دیتاسنترهای ایران، هلند و آلمان برای انتخاب نزدیکترین لوکیشن به شما و سرویسهای موردنیاز.
✅ امکان ارتقای منابع متناسب با رشد اتوماسیونها، بدون نیاز به مهاجرت.
✅ پشتیبانی فنی ۲۴ ساعته برای کمک در راهاندازی سرور و رفع مشکلات اتصال.
✅ دیتاسنترهای ایران، هلند و آلمان برای انتخاب نزدیکترین لوکیشن به شما و سرویسهای موردنیاز.
✅ امکان ارتقای منابع متناسب با رشد اتوماسیونها، بدون نیاز به مهاجرت.
✅ پشتیبانی فنی ۲۴ ساعته برای کمک در راهاندازی سرور و رفع مشکلات اتصال.
میتوانید پلنها را در صفحه سرور مجازی وبداده ببینید و نزدیکترین لوکیشن به کاربران خود را انتخاب کنید.
پرسشهای پرتکرار درباره نصب و راهاندازی n8n
n8n دقیقاً چه کاری انجام میدهد؟
n8n یک پلتفرم اتوماسیون گردشکار متنباز است که سرویسها، APIها و اپلیکیشنهای مختلف را به هم متصل میکند تا کارهای تکراری بهصورت خودکار انجام شوند. هر گردشکار از چند «نود» تشکیل میشود که هرکدام یک عملیات مشخص مثل دریافت داده، تبدیل یا ارسال آن را انجام میدهند.
برای نصب n8n کدام روش بهتر است، Docker یا npm؟
طبق مستندات رسمی، برای اکثر نیازهای خودمیزبانی روش Docker توصیه میشود چون محیطی ایزوله و تمیز فراهم میکند و از ناسازگاری نسخهها جلوگیری میکند. روش npm برای تست سریع و محیطهای ساده مناسبتر است و به نصب Node.js نسخه 20.19 تا 24.x نیاز دارد.
n8n روی چه پورتی اجرا میشود؟
بهصورت پیشفرض، پنل n8n روی پورت 5678 بالا میآید و از طریق آدرسی مانند http://localhost:5678 یا http://SERVER_IP:5678 در دسترس است. برای دسترسی امن از بیرون بهتر است آن را پشت reverse proxy با HTTPS قرار دهید.
آیا برای نصب با npm حتماً به Docker نیاز دارم؟
خیر، روش npm مستقل از Docker است و فقط به Node.js نیاز دارد. تنها در صورتی که بخواهید از قابلیت تونل برای تست وبهوکها استفاده کنید، n8n از یک کانتینر cloudflared کمک میگیرد. برای نصب و اجرای معمولی با npm، Docker ضروری نیست.
دیتابیس پیشفرض n8n چیست و کی باید عوض شود؟
دیتابیس پیشفرض SQLite است که برای استفاده شخصی و تعداد محدودی گردشکار زمانبندیشده کافی است. برای محیط پروداکشن و حجم بالای اجرا، استفاده از PostgreSQL توصیه میشود که با چند متغیر محیطی فعال میشود.
چطور دادههای n8n را هنگام بهروزرسانی حفظ کنم؟
در روش Docker، تا زمانی که volume داده (مثل n8n_data که به مسیر /home/node/.n8n وصل است) را حفظ کنید، بهروزرسانی ایمیج دادهها را پاک نمیکند. کافی است ایمیج جدید را با docker pull بگیرید، کانتینر قبلی را متوقف و حذف کنید و دوباره با همان volume اجرا کنید.
آیا اجرای n8n روی سرور امن است؟
n8n بهخودیخود امن است، اما مسئولیت ایمنسازی محیط با شماست. حتماً پنل را پشت HTTPS و یک reverse proxy قرار دهید، احراز هویت را فعال کنید و پورت را مستقیم روی اینترنت باز نگذارید. خودِ n8n هم تاکید میکند خودمیزبانی برای کاربران آشنا با مدیریت سرور مناسب است.
برای اجرای پایدار n8n چه سروری لازم است؟
یک سرور مجازی لینوکسی با رم و پردازنده کافی و اتصال شبکه باکیفیت مناسب است. مقدار منابع به تعداد و سنگینی گردشکارها بستگی دارد؛ برای شروع یک پلن میانرده کفایت میکند و در صورت رشد میتوانید منابع را ارتقا دهید.
جمعبندی و قدم بعدی شما
دیدیم که راهاندازی این پلتفرم اتوماسیون مسیر روشنی دارد: ابتدا سرور را آماده و Docker را نصب میکنید، سپس با یک دستور رسمی کانتینر را بالا میآورید و از پورت 5678 به پنل وصل میشوید؛ اگر Docker نخواستید، روش npm با Node.js در دسترس است. برای محیط جدی، PostgreSQL و قراردادن پنل پشت HTTPS را فراموش نکنید و حتماً از دادهها بکاپ بگیرید. با رعایت همین چند اصل، یک سرویس اتوماسیون پایدار و کاملاً تحت کنترل خودتان خواهید داشت.
جمعبندی سریع
✅ سرور را آماده و Docker را نصب کنید.
✅ با دستور رسمی، کانتینر n8n را روی پورت 5678 اجرا کنید.
✅ برای پروداکشن از PostgreSQL و reverse proxy با HTTPS استفاده کنید.
✅ از volume داده بهصورت منظم بکاپ بگیرید.
✅ با دستور رسمی، کانتینر n8n را روی پورت 5678 اجرا کنید.
✅ برای پروداکشن از PostgreSQL و reverse proxy با HTTPS استفاده کنید.
✅ از volume داده بهصورت منظم بکاپ بگیرید.
در صورتی که سوالی داشتید میتوانید در بخش نظرات با ما در ارتباط باشید.
