تنظیمات و دامنه n8n
تنظیمات runtime را از برنامه‌های آماده ← سرویس n8n ← تنظیمات ← متغیرهای محیطی تغییر دهید. مقدارهای از قبل تنظیم‌شده را حفظ کنید. ذخیرهٔ تغییرات می‌تواند سرویس را دوباره مستقر کند؛ بعد از آماده‌شدن، editor و یک workflow واقعی را آزمایش کنید.
Password Recovery
اگر بازیابی ایمیلی از قبل تنظیم شده است، از همان مسیر استفاده کنید. دستور زیر بازنشانی یک رمز نیست؛ همهٔ حساب‌های کاربران n8n را حذف و مدیریت کاربران را به مرحلهٔ راه‌اندازی اولیه برمی‌گرداند. تنها برای بازیابی اضطراری توسط مالک سرویس و پس از بکاپ از آن استفاده کنید. مرجع رسمی فرمان
n8n user-management:reset
دستور در کنسول سرویس n8n اجرا می‌شود. سپس سرویس را مجدداً راه‌اندازی و حساب مالک را ایجاد کنید؛ صفحهٔ راه‌اندازی اولیه را عمومی و رهاشده نگذارید.
اتصال دامنهٔ شخصی و تنظیم env
برای آدرس دائمی n8n، یک زیردامنه مانند n8n.example.com از دامنهٔ خودتان انتخاب کنید. این آدرس هم برای ورود به editor و هم برای callback سرویس‌هایی مثل Google Sheets استفاده می‌شود. فقط اتصال DNS کافی نیست؛ آدرس عمومی داخل تنظیمات n8n هم باید تغییر کند.
۱. دامنه و HTTPS را در پنل آماده کنید
- در پنلی که n8n را ساخته‌اید، چابکان یا کلودیوا، مسیر برنامه‌های آماده ← سرویس n8n ← دامنه‌ها را باز کنید.
- دامنهٔ خود را اضافه و روش اتصال را انتخاب کنید. تنظیم NS یا رکوردهای DNS را مطابق مقادیر نمایش‌داده‌شدهٔ همان پنل انجام دهید؛ IP یا NS را از سرویس دیگری کپی نکنید.
- اگر دامنهٔ اصلی از قبل در پنل متصل است، زیردامنهٔ
n8nرا از بخش ساب‌دامنه‌ها به این سرو یس متصل کنید. برای جزئیات، افزودن دامنه و ساب‌دامنه را ببینید. - پس از تأیید اتصال، از تنظیمات HTTPS دامنه گواهی را آماده و آدرس
https://n8n.example.comرا در مرورگر باز کنید. صفحه باید بدون خطای گواهی به editor برسد. راهنمای HTTPS
برای این راهنما n8n را روی زیردامنه و مسیر اصلی / قرار دهید؛ استفاده از مسیری مثل example.com/n8n به تنظیمات متفاوت proxy و N8N_PATH نیاز دارد.
۲. متغیرهای محیطی n8n را عوض کنید
مسیر برنامه‌های آماده ← سرویس n8n ← تنظیمات ← متغیرهای محیطی را باز کنید. مقدارهای زیر را با دامنهٔ واقعی خود وارد کنید. در فرم env، نام و مقدار دو فیلد جدا هستند؛ عبارت کامل NAME=value را در فیلد نام نگذارید.
برای نسخه‌های قبل از 2.35.0:
N8N_HOST=n8n.example.com
N8N_PROTOCOL=https
N8N_EDITOR_BASE_URL=https://n8n.example.com
WEBHOOK_URL=https://n8n.example.com/
برای نسخه‌های 2.35.0 به بعد، سه متغیر اول همان‌اند و متغیر webhook را با نام جدید تنظیم کنید:
N8N_HOST=n8n.example.com
N8N_PROTOCOL=https
N8N_EDITOR_BASE_URL=https://n8n.example.com
N8N_WEBHOOK_URL=https://n8n.example.com/
| متغیر | نکته |
|---|---|
N8N_HOST | فقط نام میزبان؛ بدون https:// و بدون مسیر |
N8N_PROTOCOL | پروتکل عمومی این نمونه، https |
N8N_EDITOR_BASE_URL | URL کامل editor روی دامنهٔ شخصی |
WEBHOOK_URL یا N8N_WEBHOOK_URL | URL پایهٔ عمومی webhook؛ نام مناسب نسخه را انتخاب کنید. |
N8N_PORT | پورت داخلی موجود سرویس را حفظ کنید؛ معمولاً 5678 است و برای HTTPS عمومی نباید به 443 تغییر کند. |
متغیرهای میزبان و editor در مرجع تنظیمات n8n و تغییر نام متغیر webhook در راهنمای reverse proxy توضیح داده شده‌اند. هر دو نام webhook را با مقدارهای متعارض تنظیم نکنید.
پشت reverse proxy، تعداد proxyهای مورداعتماد با N8N_PROXY_HOPS تنظیم می‌شود؛ نمونهٔ رسمی برای یک proxy مقدار 1 دارد. توپولوژی پنل یا CDN اضافی را حدس نزنید؛ مقدارهای موجود را حفظ و در صورت نیاز با پشتیبانی تطبیق دهید. HTTPS عمومی در پنل مدیریت می‌شود؛ برای این اتصال لازم نیست فایل گواهی را داخل کانتینر بارگذاری کنید.
۳. ذخیره و نتیجه را بررسی کنید
تنظیمات را ذخیره و تا پایان استقرار مجدد صبر کنید. سپس از دامنهٔ شخصی جدید وارد n8n شوید و این موارد را کنترل کنید:
- editor از
https://n8n.example.comباز می‌شود. - Test URL و Production URL در node Webhook دامنهٔ جدید را دارند.
- OAuth Redirect URL در credential گوگل دامنهٔ جدید و HTTPS دارد؛
localhostیا آدرس قبلی در آن نیست. - بعد از تغییر دامنه، callback ثبت‌شده در Google Cloud و URLهای سایر فراخواننده‌ها به‌روز شده‌اند. برای تلگرام، انتشار مجدد workflow باید webhook صحیح را ثبت کند.
نمونهٔ متداول callback گوگل:
https://n8n.example.com/rest/oauth2-credential/callback
این فقط نمونه است؛ آدرس نهایی را از خود credential n8n کپی کنید. اگر دامنهٔ قدیمی یا پورت داخلی باقی مانده، مقدارهای env، اعمال‌شدن استقرار و تنظیمات proxy را بررسی کنید. تغییر WEBHOOK_URL به‌تنهایی جای تنظیم editor و بررسی callback OAuth را نمی‌گیرد.
مرحلهٔ بعد: اتصال Google Sheets و تنظیم OAuth.
زمان‌بندی براساس ساعت ایران
GENERIC_TIMEZONE=Asia/Tehran
TZ=Asia/Tehran
GENERIC_TIMEZONE منطقهٔ زمانی n8n و nodeهای زمان‌بندی را تعیین می‌کند؛ TZ برای ساعت محیط سیستم است. در Workflow Settings هم timezone را بررسی کنید؛ مقدار اختصاصی workflow می‌تواند با پیش‌فرض متفاوت باشد. پیش از انتشار Schedule Trigger، زمان اجرای بعدی را کنترل کنید. مرجع timezone
اتصال OAuth به سرویس‌ها
در credential مقصد، OAuth Redirect URL نمایش‌داده‌شدهٔ n8n را عیناً در تنظیمات برنامهٔ آن سرویس ثبت کنید. برای Google Sheets، راهنمای کامل اتصال گوگل مراحل دامنهٔ مجاز، Client ID/Secret و اولین تست را توضیح می‌دهد. پس از تغییر دامنه، callback را هم به‌روز کنید. خطای callback با مشکل دسترسی خروجی به API متفاوت است؛ عیب‌یابی را ببینید.
تغییر ورژن N8N
پیش از تغییر نسخه، بکاپ و روش ارتقا را بخوانید. فهرست زیر صرفاً نسخه‌های ثبت‌شده در این مستند است؛ نسخه‌های قابل انتخاب در پنل و یادداشت انتشار n8n مبنای ارتقا هستند.
در صورتی که قصد دارید ورژن برنامه N8N را تغییر دهید، می‌توانید در قسمت تنظیمات سرویس خود، اینکار را انجام دهید. بعد از انتخاب ورژن بر روی ذخیره ی تغییرات کلیک نمایید.
- 2.0.0
- 2.0.1
- 2.0.2
- 2.0.3
- 2.1.0
- 2.1.1
- 2.1.2
- 2.1.3
- 2.1.4
- 2.2.0
- 2.2.1
