در پایان این راهنما یک نصب کامل n8n روی سرور ایران خواهید داشت که با نام دامنهی خودتان و گواهی معتبر از اینترنت باز میشود، و طوری مهار شده که سایتهای زندهی همان سرور را کند نکند. همهی کار روی یک سرور یکهستهای با چهار گیگ حافظه انجام شدنی است و به ماشین جدا احتیاج ندارد. زمان لازم حدود یک ساعت است که بیشترش صرف دانلود بستهها میشود.
ابزار n8n یک سکوی خودکارسازی گردش کار (workflow automation) است: کارهایی که هر روز دستی انجام میدهید را به هم وصل میکند و خودش اجرا میکند. مثلاً هر صبح ساعت هفت ردیفهای تازهی یک برگهی Google Sheets را بخواند، در پایگاه دادهی حسابداری ثبت کند و نتیجه را ایمیل کند.
پیش از شروع
این چیزها را لازم دارید:
- یک سرور مجازی یا ابری ایران با سیستمعامل Ubuntu نسخهی ۲۲.۰۴ یا بالاتر، با دسترسی
rootاز راه SSH. - دستکم یک هسته پردازنده، دو گیگابایت حافظهی آزاد و شش گیگابایت فضای دیسک. خود n8n در حالت بیکار حدود ۴۰۰ مگابایت حافظه میگیرد و بستههایش روی دیسک نزدیک ۲.۵ گیگابایت جا میخواهند.
- یک دامنه که بتوانید ردیف DNS برایش اضافه کنید، تا زیردامنهای مثل
n8n.example.comبسازید. - وبسرور Apache یا Nginx روی همان سرور، چون n8n پشت آن مینشیند و خودش مستقیم به اینترنت وصل نمیشود.
اگر سرور شما زیر یک هسته یا زیر دو گیگ حافظهی آزاد دارد، جلوتر نروید. نصب خودش انجام میشود، ولی اولین گردش کار سنگین سایتهای همان سرور را از کار میاندازد.
دو راه نصب، و اینکه کدام را انتخاب کنید
برای n8n دو راه هست و هر دو کار میکنند. انتخاب بین این دو مهمترین تصمیم این کار است، چون بعد از آن همه چیز فرق میکند.
راه یک: با Docker
راه رسمی و پیشنهادی خود سازنده است. ارتقا ساده میشود و همه چیز داخل یک بستهی جدا میماند. ولی خود سرویس Docker حدود ۱۰۰ مگابایت حافظه و یک فرایند همیشهروشن میخواهد، و قاعدههای دیوار آتش خودش را میسازد که با دیوار آتش کنترلپنلهایی مثل DirectAdmin تداخل پیدا میکند.
راه دو: نصب بومی با systemd
برنامه را مستقیم با npm نصب میکنید و با سرویس systemd بالا میآورید. سبکتر است، هیچ قاعدهی دیوار آتشی نمیسازد، و سقف منابع را خود systemd میدهد. روی سروری که یک هسته دارد و سایت زنده رویش است، همین راه درست است و بقیهی این راهنما همین را نشان میدهد.
گام ۱: ببینید سرور جا دارد
کجا: خط فرمان سرور، با SSH.
چه کنید: این فرمان را بزنید تا حافظه، دیسک و شمار هستهها را با هم ببینید.
free -m; df -h /; nproc
چه میبینید: ستون available در سطر حافظه باید دستکم ۲۰۰۰ باشد، ستون فضای آزاد دیسک دستکم شش گیگابایت، و شمار هستهها یک یا بیشتر.
اگر نه: اگر حافظه کم است، اول ببینید چه چیزی آن را گرفته. فرمان ps -eo rss,comm --sort=-rss | head سنگینترینها را مرتب نشان میدهد.
گام ۲: ببینید دسترسی بیرونی باز است
کجا: همان خط فرمان سرور.
چه کنید: پیش از نصب، بسنجید که سرور به بارگاه بستهها میرسد. این مهمترین سنجش این کار است و بیشترین وقت را از کسی میگیرد که نادیدهاش بگیرد.
curl -s -o /dev/null -w "%{http_code}\n" https://registry.npmjs.org/n8n
curl -s -o /dev/null -w "%{http_code}\n" https://deb.nodesource.com/
چه میبینید: هر دو باید کد 200 بدهند.
اگر نه: کد 000 یعنی اصلاً نرسیده و باید از راه دیگری بستهها را بیاورید.
ارزش دارد همینجا سرویسهایی را هم که گردش کارهایتان قرار است صدا بزنند بسنجید. سنجش ما روی یک سرور تهران در آبان ۱۴۰۵ این نتیجه را داد:
| سرویس | پاسخ از سرور تهران |
|---|---|
| بارگاه npm | رسید |
| مخزن GitHub | رسید |
| برگهی Google Sheets | رسید |
| پیامرسان Telegram | نرسید |
| شبکهی Instagram | نرسید |
این اعداد روز سنجش ما و از آن ارائهدهندهی خاص است و برای سرور شما ممکن است فرق کند؛ خودتان بسنجید. گردش کاری که به سرویس بسته میخورد، باید از یک درگاه میانی رد شود و آن کار جداگانهای است.
گام ۳: محیط اجرا را نصب کنید
کجا: خط فرمان سرور، با کاربر root.
چه کنید: نسخهی ۲۲ محیط اجرای Node را از بارگاه رسمی نصب کنید.
curl -fsSL https://deb.nodesource.com/setup_22.x -o /tmp/nodesetup.sh
bash /tmp/nodesetup.sh
apt-get install -y nodejs
node -v
چه میبینید: فرمان آخر باید شمارهی نسخهای با ۲۲ شروعشونده بدهد.
اگر نه: اگر نسخهی قدیمیتری نشان داد، یعنی نسخهی مخزن خود Ubuntu نصب شده است. آن را با apt-get remove nodejs بردارید و دوباره از بالا شروع کنید.
گام ۴: خود برنامه را نصب کنید
کجا: خط فرمان سرور.
چه کنید: یک کاربر سیستمی جدا بسازید و برنامه را در پوشهای مستقل نصب کنید. نصب را با اولویت پایین اجرا کنید تا در همان نیم ساعت سایتهای زنده کند نشوند.
useradd --system --create-home --home-dir /var/lib/n8n --shell /usr/sbin/nologin n8n
mkdir -p /opt/n8n && cd /opt/n8n
echo '{"name":"n8n-host","private":true}' > package.json
nice -n 19 ionice -c3 npm install n8n --omit=dev --no-audit --no-fund
چه میبینید: در پایان خطی شبیه «added 2270 packages» میآید. روی یک هسته حدود نُه دقیقه طول میکشد.
اگر نه: اگر نصب وسط کار ایستاد، همان فرمان را دوباره بزنید؛ بستههای دانلودشده دوباره دانلود نمیشوند.
کاربر جدا اختیاری نیست. اگر n8n را با کاربر root اجرا کنید، هر گردش کاری که کد اجرا میکند با بالاترین دسترسی سرور اجرا میشود.
گام ۵: کلید رمزنگاری را بسازید
کجا: خط فرمان سرور.
چه کنید: ابزار n8n گذرواژهها و کلیدهای سرویسهایی که به آن میدهید را با یک کلید رمز میکند. آن کلید را خودتان بسازید و در فایلی با مجوز محدود بگذارید.
mkdir -p /etc/n8n
printf 'N8N_ENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" > /etc/n8n/n8n.env
chmod 600 /etc/n8n/n8n.env
چه میبینید: فرمان ls -l /etc/n8n/ باید مجوز -rw------- نشان بدهد.
اگر نه: اگر مجوز بازتر است، chmod 600 را دوباره بزنید.
از این فایل پشتیبان بگیرید و جای امنی نگه دارید. اگر این کلید گم شود، همهی گذرواژههایی که در n8n ذخیره کردهاید غیرقابل بازیابی میشوند و باید یکییکی دوباره وارد شوند.
گام ۶: سرویس را با سقف منابع بسازید
کجا: فایل /etc/systemd/system/n8n.service روی سرور.
چه کنید: این فایل را بسازید. بخش پایانیاش همان چیزی است که نمیگذارد n8n سایتهای زنده را کند کند.
[Unit]
Description=n8n workflow automation
After=network-online.target
[Service]
Type=simple
User=n8n
WorkingDirectory=/var/lib/n8n
EnvironmentFile=/etc/n8n/n8n.env
Environment=N8N_USER_FOLDER=/var/lib/n8n
Environment=N8N_LISTEN_ADDRESS=127.0.0.1
Environment=N8N_PORT=5678
Environment=N8N_HOST=n8n.example.com
Environment=N8N_PROTOCOL=https
Environment=N8N_PROXY_HOPS=1
Environment=WEBHOOK_URL=https://n8n.example.com/
Environment=DB_TYPE=sqlite
Environment=GENERIC_TIMEZONE=Asia/Tehran
Environment=TZ=Asia/Tehran
Environment=EXECUTIONS_DATA_PRUNE=true
Environment=EXECUTIONS_DATA_MAX_AGE=168
ExecStart=/usr/bin/node /opt/n8n/node_modules/n8n/bin/n8n start
Restart=on-failure
RestartSec=15
Nice=10
CPUWeight=20
CPUQuota=60%
MemoryHigh=900M
MemoryMax=1200M
IOWeight=20
NoNewPrivileges=true
PrivateTmp=true
ProtectSystem=strict
ProtectHome=true
ReadWritePaths=/var/lib/n8n
[Install]
WantedBy=multi-user.target
به جای n8n.example.com زیردامنهی خودتان را بگذارید. بعد سرویس را راه بیندازید:
systemctl daemon-reload
systemctl enable --now n8n
curl -s http://127.0.0.1:5678/healthz
چه میبینید: پاسخ باید {"status":"ok"} باشد. اولین بالا آمدن حدود چهل ثانیه طول میکشد.
اگر نه: فرمان journalctl -u n8n -n 50 پنجاه سطر آخر گزارش را نشان میدهد و علت در همانجاست.
آن شش سطر سقف یعنی چه
عبارت CPUQuota=60% یک سقف سخت است: در هر ثانیه حداکثر ششدهم ثانیه پردازنده به n8n میرسد، حتی وقتی سرور بیکار است. پس چهل درصد هسته همیشه برای سایتها میماند.
عبارت CPUWeight=20 کار دیگری میکند و فقط هنگام رقابت معنی دارد. پیشفرض هر سرویس ۱۰۰ است، پس وبسرور در لحظهی شلوغی پنج برابر n8n سهم میبرد. این دو با هم یعنی n8n وقتی سرور خلوت است راحت کار میکند و لحظهای که بازدیدکننده میآید، خودش کنار میکشد.
عبارت MemoryMax=1200M هم سقف حافظه است: اگر گردش کاری نشت حافظه داشته باشد، خودش کشته میشود و پایگاه دادهی سایتها دستنخورده میماند.
گام ۷: زیردامنه و ردیف DNS را بسازید
کجا: پنل DNS دامنهتان، و کنترلپنل سرور.
چه کنید: یک ردیف A برای زیردامنه بسازید که به نشانی IP سرور اشاره کند، و در کنترلپنل هم همان زیردامنه را اضافه کنید تا وبسرور برایش پروندهی پیکربندی بسازد.
چه میبینید: فرمان زیر باید نشانی IP سرور را برگرداند.
dig +short A n8n.example.com @1.1.1.1
اگر نه: اگر خروجی خالی بود، چند دقیقه صبر کنید و دوباره بزنید.
اگر سرویس DNS شما گزینهی پروکسی یا ابر دارد، آن را خاموش کنید. در بیشتر پنلهای ایرانی این گزینه در پنجرهی ساختن ردیف تازه بهصورت پیشفرض روشن است، و با آن روشن هم گواهی گرفتن سخت میشود و هم وبسوکت n8n ممکن است قطع شود.
گام ۸: وبسرور را جلوی n8n بگذارید
کجا: پروندهی پیکربندی همان زیردامنه در وبسرور.
چه کنید: ابزار n8n فقط روی 127.0.0.1 گوش میدهد، پس از اینترنت دیده نمیشود. وبسرور درخواست را از بیرون میگیرد، رمزگذاری را انجام میدهد و در داخل سرور به n8n میدهد. برای Apache این خطها را داخل بخش امن همان زیردامنه بگذارید:
ProxyPreserveHost On
RequestHeader set X-Forwarded-Proto "https"
RewriteEngine On
RewriteCond %{HTTP:Upgrade} =websocket [NC]
RewriteRule ^/?(.*) "ws://127.0.0.1:5678/$1" [P,L]
ProxyPass / http://127.0.0.1:5678/ timeout=600
ProxyPassReverse / http://127.0.0.1:5678/
چه میبینید: پس از systemctl reload httpd، باز کردن زیردامنه باید صفحهی خود n8n را بیاورد.
اگر نه: خطای ۵۰۳ یعنی وبسرور به n8n نرسیده؛ ببینید سرویس بالاست. خطای ۴۰۴ یعنی پروندهی پیکربندی خوانده نشده.
آن سه خط میانی برای وبسوکتاند و برداشتنی نیستند. بی آنها صفحه بالا میآید ولی نتیجهی اجرای گردش کار زنده نشان داده نمیشود و رابط به نظر خراب میرسد.
گام ۹: گواهی بگیرید
کجا: کنترلپنل سرور، بخش گواهی یا SSL همان زیردامنه.
چه کنید: گواهی رایگان Let's Encrypt را برای همان زیردامنه صادر کنید.
چه میبینید: فرمان زیر باید کد ۲۰۰ و عدد صفر بدهد؛ عدد صفر یعنی گواهی معتبر است.
curl -s -o /dev/null -w "%{http_code} %{ssl_verify_result}\n" https://n8n.example.com/healthz
اگر نه: دو علت شایع دارد و هر دو را پایینتر در جدول عیبیابی آوردهایم.
گام ۱۰: حساب مدیر را بسازید
کجا: مرورگر، روی زیردامنهی تازه.
چه کنید: نشانی را باز کنید. صفحهی ساختن حساب مدیر میآید؛ ایمیل، نام و گذرواژه را بزنید.
چه میبینید: بعد از آن وارد صفحهی گردش کارها میشوید.
اگر نه: اگر به جای آن صفحهی ورود آمد، یعنی حساب مدیر قبلاً ساخته شده است.
این صفحه تا وقتی حساب ساخته نشده برای هر کسی باز است. بین لحظهای که زیردامنه بالا میآید و لحظهای که حساب را میسازید، هر کسی که نشانی را بداند میتواند مدیر شود. این دو کار را پشت سر هم انجام دهید.
دستیار هوش مصنوعی: چه میخواهد و چه چیزی را نمیخواهد
ابزار n8n یک دستیار دارد که با گفتوگو برایتان گردش کار میسازد. دو چیز جدا از هم لازم دارد و بیشتر وقتها فقط اولی را میخواهید.
مدل: یک کلید جدا که خودتان پولش را میدهید
دستیار روی مدلی کار میکند که مستقیم از خودتان پول میگیرد، و اشتراک معمولی آن سرویس چنین کلیدی نمیدهد؛ باید از بخش توسعهدهندگان همان شرکت کلید بسازید. پیش از ساختن کلید، یک فضای کاری جدا بسازید و برایش سقف خرج ماهانه بگذارید. سقف خرج روی فضای کاری مینشیند نه روی کلید، و گردش کاری که اشتباهی در حلقه بیفتد میتواند شبانه اعتبارتان را ببرد.
برای کلید تاریخ انقضا بگذارید و آن را در هیچ تصویر و پیامی نفرستید. این کلید قرار است در پایگاه دادهی یک سرور بماند؛ کلیدی که تاریخ ندارد، اگر روزی نشت کند تا ابد باز است.
و یک نکته که خود آن پنجره میگوید: پرسشها، گردش کارها و دادهی اجرا به آن سرویس میرود. برای گردش کار معمولی مشکلی نیست، ولی پیش از آنکه دادهی مشتری از آن رد شود دو بار فکر کنید.
محیط ایزوله: روی این سرور نه
دستیار برای آزمودن کدی که مینویسد یک محیط ایزوله میخواهد و خودش میپرسد آن را از کجا بیاورد. مستند خود n8n دو چیز را روشن گفته است: این محیط دستکم چهار گیگابایت حافظه و دو هسته میخواهد، و بخش اجراکنندهاش با دسترسی کامل و به شکل تودرتو بالا میآید، پس کدی که از آن بیرون بزند به خود میزبان میرسد. همان مستند میگوید این پیکربندی باید روی ماشینی باشد که هیچ چیز دیگری رویش نیست.
پس روی سروری که سایت زنده و پایگاه دادهی مشتری دارد نصبش نکنید. پنجرهی مربوط به آن را ببندید و رد شوید؛ دستیار بی آن هم گردش کار میسازد و عیبیابی میکند، فقط کدی که نوشته را خودش اجرا نمیکند.
دو سنجشی که چیزی را نمیسنجند
هر دوی اینها سبز میشوند و هیچچیز را ثابت نمیکنند. هر کدام یک بار وقت میگیرند.
یک: سنجیدن سایت از روی خود سرور با نشانی لوپبک. پروندهی پیکربندی سایتها معمولاً به نشانی IP عمومی بسته است، نه به لوپبک. پس فرمانی که نام سایت را به 127.0.0.1 میبندد به صفحهی پیشفرض وبسرور میرسد و کد ۲۰۰ میگیرد، بدون آنکه سایت شما را دیده باشد. محک ساده: اندازهی پاسخ را هم بگیرید. اگر چند سایت متفاوت همه یک عدد بایت دادند، هیچکدام را نگرفتهاید.
دو: آزمودن مسیر چالش گواهی با پوشهی خودتان. اگر پروندهای در پوشهی زیردامنه بگذارید و آن را ببینید، فقط ثابت کردهاید پوشهی خودتان کار میکند. کنترلپنل چالش را جای دیگری میگذارد، و باید همان مسیر را بسنجید.
از کجا بفهمید درست شد
سه سنجش ساده که هر کدام یک لایه را میآزمایند:
- سلامت برنامه: فرمان
curl -s https://n8n.example.com/healthzباید{"status":"ok"}بدهد. - مسیر فراخوان بیرونی: نشانی
https://n8n.example.com/webhook/testرا در مرورگر باز کنید. باید پیام خود n8n بیاید که این مسیر ثبت نشده است. این یعنی مسیریاب کار میکند. - سقف منابع: فرمان
systemctl show n8n -p CPUQuotaPerSecUSec -p MemoryMaxباید600msو عدد حافظه را نشان بدهد. اگر خالی برگشت، یعنی فایل سرویس خوانده نشده.
و یک سنجش که بیشتر از این سه تا ارزش دارد: زمان پاسخ سایتهای همان سرور را پیش و پس از نصب اندازه بگیرید و با هم بسنجید.
curl -s -o /dev/null -w "%{http_code} %{time_total}\n" https://example.com/
عیبیابی
| نشانه | علت | چاره |
|---|---|---|
| صفحه بالا میآید ولی نتیجهی اجرا زنده نمیشود | مسیر وبسوکت پروکسی نشده | سه خط وبسوکت گام ۸ را اضافه کنید و وبسرور را دوباره بخوانید |
| صدور گواهی رد میشود | درخواست نام www زیردامنه را هم شامل شده و آن نام ردیف DNS ندارد | در تنظیمات گواهی همان زیردامنه، گزینهی www را بردارید |
| صدور گواهی بدون هیچ خطایی انجام نمیشود | پروکسی فراگیر مسیر چالش را هم بلعیده | مسیر /.well-known/acme-challenge را از پروکسی مستثنا کنید |
| خطای ۵۰۳ روی زیردامنه | سرویس بالا نیست یا هنوز در حال بالا آمدن است | فرمان systemctl status n8n را ببینید و چهل ثانیه صبر کنید |
| سرویس مدام دوباره راه میافتد | سقف حافظه برای گردش کارهای شما کم است | عدد MemoryMax را بالا ببرید، ولی زیر حافظهی آزاد سرور نگه دارید |
| سایتهای سرور کند شدهاند | سقف پردازنده گذاشته نشده | بخش سقف منابع گام ۶ را بسنجید |
| تنظیم دستی پروکسی در کنترلپنل اعمال نمیشود | برخی کنترلپنلها پروندهی پیکربندی سفارشی زیردامنه را نادیده میگیرند | با یک نشانهی ساختگی بسنجید؛ اگر در پیکربندی نهایی نیامد، پیکربندی را جای دیگری بنویسید که وبسرور حتماً میخواند |
| دکمههای رابط کار نمیکنند و چیزی هم نشان داده نمیشود | پنجرهی مرورگر باریک است یا نشست منقضی شده | شبیهسازی گوشی را در ابزار توسعهدهنده خاموش کنید، صفحه را دوباره بار کنید، و اگر صفحهی ورود آمد دوباره وارد شوید |
محدودیتها
این راه همه چیز را حل نمیکند و بهتر است پیش از شروع بدانید:
- پایگاه داده SQLite است. نسخهی دوم n8n پشتیبانی MySQL و MariaDB را برداشته، پس پایگاه دادهی خود سرور به کارش نمیآید. برای بار سنگین و اجرای همزمان، Postgres لازم میشود.
- یک هسته یعنی یک گردش کار در لحظه. برای چند کار سبک و زمانبندیشده کافی است؛ برای صف پیوسته باید هسته اضافه کنید.
- سرویسهای بسته همچنان بستهاند. نصب n8n روی سرور داخلی دسترسیای که خود سرور ندارد را نمیسازد.
- ارتقا دستی است. در این راه باید خودتان
npm update n8nبزنید و سرویس را دوباره راه بیندازید.
و یک نکتهی آخر که وقت میخرد: پس از هر تغییر در پیکربندی وبسرور، پیش از دوباره خواندن آن، نحو را با httpd -t بسنجید. خطای نحوی در یک پرونده، همهی سایتهای آن سرور را با هم پایین میآورد.
پرسشهای پرتکرار
ابزار n8n چیست و به چه کار میآید؟
برای نصب n8n روی سرور ایران چه منابعی لازم است؟
نصب با Docker بهتر است یا نصب بومی؟
چطور جلوی کند شدن سایتهای همان سرور را بگیریم؟
آیا n8n را باید مستقیم به اینترنت وصل کرد؟
چرا صدور گواهی برای زیردامنه رد میشود؟
نتیجهی اجرای گردش کار زنده نشان داده نمیشود، چرا؟
آیا n8n از پایگاه دادهی MySQL سرور استفاده میکند؟
اگر کلید رمزنگاری n8n گم شود چه میشود؟
نظرها
نظرها در حالِ بار شدن است…