Deploying n8n with Docker: Backups and Upgrades

Deploy n8n with PostgreSQL, external task runners and a TLS proxy, keep the encryption key right, take restore-tested backups and upgrade pinned versions.

بعد از این درس می‌توانی

  • یک استقرار n8n با PostgreSQL، task runner خارجی و پراکسی TLS طراحی کند که فقط پراکسی پورت داشته باشد و رازها از فایل خوانده شوند.
  • نقش کلید رمزنگاری را توضیح دهد و آن را جدا از پشتیبان‌ها و درست در همه نمونه‌ها نگه دارد.
  • پشتیبان کامل بگیرد و بازیابی آن را روی نمونه جدا بیازماید.
  • ارتقا را با نسخه سنجاق‌شده، پشتیبان پیش از ارتقا و برنامه برگشت انجام دهد.

چرا این درس مهم است

n8n برگ سبز شش ماه روی یک سرور با تنظیمات پیش‌فرض کار کرد. یک شب دیسک سرور خراب شد. پشتیبان پایگاه داده وجود داشت؛ ورک‌فلوها برگشتند، ولی هیچ Credentialی کار نکرد، چون کلید رمزنگاری در پوشه‌ای بود که پشتیبان نداشت. هفته بعد، کسی برای «به‌روز بودن» برچسب latest را دوباره کشید و n8n به نسخه اصلی تازه‌ای رفت که چند تغییر ناسازگار داشت؛ ورک‌فلوی پرداخت‌ها دو روز کار نکرد و برگشت به نسخه قبل هم ساده نبود.

n8n در تولید یعنی سه چیز: استقراری که فقط از یک در امن دیده می‌شود، پشتیبانی که بازیابی‌اش آزموده شده و کلید رمزنگاری را جدا نگه می‌دارد، و ارتقایی که برنامه برگشت دارد. این درس هر سه را روی زیرساخت دوره قبل می‌سازد.

مفاهیم کلیدی

یادآوری: volume، healthcheck، پراکسی معکوس با TLS و Compose secrets را در دوره زیرساخت پایه ساختی.

  • Encryption Key (کلید رمزنگاری n8n): کلیدی که Credentialها با آن رمزنگاری در پایگاه داده ذخیره می‌شوند؛ بدون آن پشتیبان Credentialها بی‌استفاده است.
  • Task Runner (اجراکننده کد): فرایند جدایی که کد گره Code را اجرا می‌کند تا کد کاربر کنار خود n8n اجرا نشود.
  • Restore Test (آزمون بازیابی): بازگرداندن یک پشتیبان روی نمونه جدا و بررسی اینکه واقعاً کار می‌کند.
  • Version Pinning (سنجاق نسخه): اجرای نسخه دقیق و مشخص به‌جای برچسب متغیری مثل latest.
  • Rollback Plan (برنامه برگشت): گام‌های از پیش نوشته‌شده برای بازگشت به وضعیت سالم قبلی پس از ارتقای ناموفق.

مدل ذهنی

n8n را مثل گاوصندوق یک فروشگاه ببین. پایگاه داده خود گاوصندوق و محتوایش است؛ کلید رمزنگاری، رمز قفل آن. پشتیبان از گاوصندوق بدون رمز، جعبه‌ای قفل‌شده است که دیگر باز نمی‌شود؛ پشتیبان از گاوصندوق با رمزی که روی همان جعبه چسبانده‌ای، به هر کسی جعبه باز می‌دهد. ارتقا مثل عوض‌کردن قفل است: پیش از آن مطمئن می‌شوی جعبه قبلی سالم و جای امن است.

استقرار n8n و مسیر پشتیبان: کاربر فقط از راه Caddy با TLS به n8n می‌رسد؛ n8n با PostgreSQL در شبکه داخلی کار می‌کند و کد گره Code را به task runner جدا می‌دهد؛ رمز پایگاه داده و کلید رمزنگاری از فایل secret خوانده می‌شوند؛ backup.sh ورک‌فلوها، Credentialهای رمزنگاری‌شده و dump پایگاه داده را می‌گیرد؛ کلید رمزنگاری جدا در مدیر راز نگهداری می‌شود.

استقرار n8n و مسیر پشتیبان

این تشبیه کجا غلط است؟ رمز گاوصندوق را می‌شود عوض کرد و جعبه را با رمز تازه قفل کرد؛ کلید رمزنگاری n8n را هم می‌شود چرخاند، ولی این کار فرایند خودش را دارد و ساده نیست. و برخلاف گاوصندوق، n8n اگر کلید تنظیم‌شده با کلید ذخیره‌شده‌اش نخواند، اصلاً روشن نمی‌شود.

گام‌به‌گام

گام ۱: معماری استقرار

assets/compose.yaml بر پایه نمونه‌های رسمی n8n (مجوز MIT) نوشته شده، با سه تغییر: فقط Caddy پورت دارد، همه رازها از فایل خوانده می‌شوند، و نسخه‌ها سنجاق شده‌اند. نمونه رسمی پورت ۵۶۷۸ را روی همه نشانی‌ها منتشر می‌کندsrc-n8n-hosting-repo؛ در درس سرور دیدی Docker از فایروال عبور می‌کند، پس اینجا n8n هیچ پورتی ندارد.

  • پایگاه داده: n8n پیش‌فرض SQLite را در پوشه ~/.n8n نگه می‌دارد و از PostgreSQL هم پشتیبانی می‌کند (نسخه‌های ۱۷ و ۱۸، و ۱۶ برای سازگاری)؛ با DB_TYPE=postgresdb و متغیرهای DB_POSTGRESDB_* وصل می‌شودsrc-n8n-database.
  • رازها از فایل: بیشتر متغیرهای n8n پسوند _FILE را می‌پذیرند و مقدار را از فایل می‌خوانند، مثل DB_POSTGRESDB_PASSWORD_FILEsrc-n8n-basic-config. پوشه داده (n8n_data) را حتی با PostgreSQL نگه دار، چون کلید و لاگ‌ها آنجا هستندsrc-n8n-docker-install.
  • task runner خارجی: n8n کد گره Code را با task runner اجرا می‌کند. مستندات حالت داخلی را «ذاتاً ناامن» می‌نامد و برای تولید و هر نمونه‌ای که داده حساس دارد، حالت خارجی با image جدای n8nio/runners را می‌خواهد؛ برچسب این image باید با نسخه n8n یکی باشدsrc-n8n-task-runners.
  • پشت پراکسی: N8N_WEBHOOK_URL نشانی عمومی webhookها را تعیین می‌کند (از نسخه 2.35.0 جای WEBHOOK_URL را گرفته) و N8N_PROXY_HOPS=1 به n8n می‌گوید پشت یک پراکسی استsrc-n8n-reverse-proxy-webhook-url.
  • داده اجراها: پاک‌سازی اجراهای قدیمی پیش‌فرض روشن است و اجراهای قدیمی‌تر از ۳۳۶ ساعت (۱۴ روز) پاک می‌شوندsrc-n8n-execution-data؛ اگر سیاستت فرق دارد، صریح تنظیمش کن.

گام ۲: کلید رمزنگاری

n8n در اولین اجرا یک کلید تصادفی می‌سازد، در پوشه ~/.n8n ذخیره می‌کند و Credentialها را با آن رمزنگاری می‌کند؛ با N8N_ENCRYPTION_KEY کلید خودت را می‌دهی، و در حالت صف همه workerها باید همان کلید را داشته باشندsrc-n8n-encryption-key. سه قاعده:

  1. کلید را خودت بساز و صریح بده (اینجا با N8N_ENCRYPTION_KEY_FILE) تا وابسته به یک فایل پنهان در volume نباشی.
  2. جدا از پشتیبان نگهش دار: در مدیر راز یا گاوصندوق رمزنگاری‌شده، نه کنار dump پایگاه داده.
  3. عوضش نکن مگر با فرایند چرخش: اگر کلید در فایل تنظیمات n8n با کلید محیط نخواند، n8n با خطای «Mismatching encryption keys» روشن نمی‌شود (در کد n8n 2.44.4 بررسی شد).

در آزمون واقعی این درس، Credentialهای پشتیبان در نمونه تازه با همان کلید باز شدند و با کلید دیگر خطای «Credentials could not be decrypted» دادند (assets/backup-restore-session.txt).

گام ۳: پشتیبان کامل

assets/backup.sh چهار چیز می‌گیرد: ورک‌فلوها به‌صورت فایل‌های جدا و خوانا با export:workflow --backup، Credentialها رمزنگاری‌شده با export:credentials، dump پایگاه داده با pg_dump، و checksum همه فایل‌ها. فرمان‌های CLI در Docker با docker exec -u node اجرا می‌شوندsrc-n8n-cli. هرگز --decrypted را در پشتیبان عادی استفاده نکن؛ مستندات هشدار می‌دهد در آن خروجی همه اطلاعات حساس دیده می‌شودsrc-n8n-cli. هنگام import هم بدان که workflow و Credential با شناسه یکسان بازنویسی می‌شوند و workflowهای import‌شده پیش‌فرض غیرفعال‌اندsrc-n8n-cli.

پوشه ورک‌فلوهای خوانا را در Git بگذار (درس Git)؛ dump و Credentialها را بیرون از Git و بیرون از سرور هم نگه دار.

گام ۴: آزمون بازیابی

پشتیبانی که بازیابی‌اش را ندیده‌ای، فقط امید است. بخش ۳ assets/runbook.md آزمون ماهانه را می‌گوید: نمونه تازه، همان نسخه، همان کلید، بازیابی dump، و بررسی تعداد ورک‌فلو، باز شدن یک Credential و اجرای یک ورک‌فلو آزمایشی. زمان بازیابی را هم ثبت کن؛ این عدد همان مدت قطعی تو در روز خرابی است.

گام ۵: ارتقا و برگشت

  • سنجاق نسخه: مستندات n8n برچسب بدون نسخه را آخرین نسخه پایدار می‌داند و برچسب next را ناپایدارsrc-n8n-docker-install. در .env نسخه دقیق بنویس و فقط با دستورالعمل عوضش کن.
  • پیش از ارتقا: یادداشت‌های انتشار و تغییرات ناسازگار را بخوان؛ نسخه ۲ n8n فهرست جدای تغییرات ناسازگار داردsrc-n8n-v2-breaking.
  • ارتقا: پشتیبان، عوض‌کردن نسخه، docker compose pull و up -dsrc-n8n-docker-install، سپس بررسی سلامت و اجرای آزمایشی.

مثال‌ها

پیاده‌سازی عملی

استقرار، پشتیبان، آزمون بازیابی و برنامه ارتقا. حدود ۳۵ دقیقه.

  1. یکی از مسیرهای پایین را برو.
  2. assets/runbook.md را برای نمونه خودت شخصی کن: جای نگهداری کلید، جای نسخه بیرون از سرور، زمان پشتیبان روزانه.
  3. یک «ارتقای آزمایشی» را روی کاغذ برنامه‌ریزی کن: از نسخه فعلی به نسخه بعدی، با چهار گام دستورالعمل و معیار برگشت.
سرویس میزبانی‌شده (در دسترس قانونی)

روی سرور سخت‌شده دوره قبل با دامنه‌ای که داری: فایل‌های assets/compose.yaml، assets/Caddyfile، assets/env.example (با نام .env) را در یک پوشه بگذار، فایل‌های secret را طبق توضیح بالای compose بساز و docker compose up -d کن. سپس bash backup.sh (فایل assets/backup.sh) را اجرا و آزمون بازیابی را روی یک پوشه یا سرور جدا انجام بده. این فایل‌ها در محیط تولید درس با docker compose config بررسی شدند؛ استقرار کامل با PostgreSQL و Caddy در آن محیط اجرا نشد چون رجیستری image در دسترس نبود.

اجرای محلی

روی کامپیوتر خودت، بدون دامنه: در compose.yaml سرویس caddy را حذف و برای n8n ports: ["127.0.0.1:5678:5678"] بگذار، N8N_PROTOCOL را http و N8N_WEBHOOK_URL را http://localhost:5678/ کن. استقرار، پشتیبان و آزمون بازیابی را کامل انجام بده. اگر Docker نداری، n8n نصب‌شده با npm هم کافی است: فرمان‌های export و import همان‌اند و آزمون کلید درست و کلید غلط را با دو مقدار N8N_USER_FOLDER جدا تکرار کن.

بدون اجرا / شبیه‌ساز

بدون نصب: assets/backup-restore-session.txt را بخوان؛ خروجی واقعی پشتیبان و بازیابی است. بنویس: (۱) چرا grep توکن را در خروجی Credentialها پیدا نکرد؛ (۲) کدام گام نشان می‌دهد «import موفق» برای اطمینان کافی نیست؛ (۳) اگر کلید را کنار همین پشتیبان در یک پوشه اشتراکی گذاشته بودی، چه چیزی لو می‌رفت.

اشتباه‌های رایج

اشتباهنتیجهکار درست
پشتیبان پایگاه داده بدون کلیدCredentialها پس از بازیابی بی‌استفادهکلید جدا و امن، و آزمون بازیابی
کلید کنار پشتیباننشت همه Credentialها با یک پوشهجدا در مدیر راز
n8nio/n8n:latestارتقای ناخواسته با تغییر ناسازگارنسخه دقیق در .env
پورت 5678 منتشرشده روی سرورn8n بدون TLS از اینترنت بازفقط پراکسی پورت دارد
task runner داخلی در تولیدکد کاربر کنار فرایند n8nحالت خارجی با image هم‌نسخه
برگشت فقط با عوض‌کردن برچسبپایگاه داده migrateشده با نسخه قبلینسخه قبلی + پشتیبان پیش از ارتقا
export:credentials --decrypted در پشتیبان روزانههمه رازها در یک فایل متنیخروجی رمزنگاری‌شده

اشکال‌زدایی

n8n پس از تغییر پیکربندی روشن نمی‌شود و لاگ می‌گوید «Mismatching encryption keys».

کلید ذخیره‌شده در فایل تنظیمات پوشه داده n8n با N8N_ENCRYPTION_KEY (یا _FILE) فرق دارد.

docker compose logs n8n؛ مقایسه کلید فایل secret با کلیدی که روز اول استفاده شده (از مدیر راز).

همان کلید قبلی را بده. کلید تازه نساز مگر با فرایند چرخش کلید؛ وگرنه Credentialها دیگر باز نمی‌شوند.

پس از بازیابی، ورک‌فلوها هستند ولی هر Credential خطای «Credentials could not be decrypted» می‌دهد.

نمونه بازیابی‌شده کلید دیگری دارد (کلید تازه ساخته شده یا فایل secret اشتباه است).

یک Credential را در ویرایشگر باز کن یا با یک ورک‌فلو آزمایشی بیازما.

کلید درست را از مدیر راز بگذار و n8n را دوباره راه بینداز؛ اگر کلید گم شده، Credentialها باید از نو ساخته شوند.

پس از docker compose pull، چند ورک‌فلو رفتار متفاوت دارند یا گره‌ای خطا می‌دهد.

نسخه سنجاق نشده بود و image به نسخه‌ای با تغییرات ناسازگار رفت.

docker compose images نسخه واقعی را نشان می‌دهد؛ آن را با یادداشت‌های انتشار و تغییرات ناسازگار مقایسه کن.

برنامه برگشت: نسخه قبلی و بازیابی پشتیبان پیش از ارتقا؛ سپس ارتقا با دستورالعمل و نسخه سنجاق‌شده.

نکته‌های امنیتی

تمرین کوتاه

تمرین · 12 دقیقه

هدف: تشخیص پشتیبان ناقص.

گام‌ها: سیاست پشتیبان فعلی یک همکار: «هر شب پوشه /var/lib/docker/volumes/db_data را با rsync به یک دیسک دیگر روی همان سرور کپی می‌کنم؛ پوشه n8n_data را هم ماه پیش یک بار کپی کردم.» دست‌کم چهار ایراد بنویس و سیاست اصلاح‌شده بده.

معیار پذیرش: کپی فایل‌های پایگاه داده در حال اجرا، همان سرور، کلید رمزنگاری (پوشه n8n_data) بی‌برنامه، و نبود آزمون بازیابی.

راه‌حل نمونه

(۱) کپی خام فایل‌های PostgreSQL در حال اجرا ممکن است ناسازگار باشد؛ از pg_dump استفاده کن. (۲) دیسک دیگر روی همان سرور: با از دست رفتن سرور، پشتیبان هم می‌رود؛ یک نسخه بیرون از سرور لازم است. (۳) پوشه n8n_data کلید رمزنگاری دارد و یک بار در ماه پیش کپی شده؛ اگر کلید عوض شده یا کپی ناقص است، Credentialها برنمی‌گردند؛ کلید را صریح با N8N_ENCRYPTION_KEY_FILE بده و جدا در مدیر راز نگه دار. (۴) هیچ آزمون بازیابی نیست. سیاست اصلاح‌شده: backup.sh روزانه، نسخه هفتگی بیرون از سرور با رمزنگاری، کلید جدا، آزمون بازیابی ماهانه با ثبت زمان.

چالش

تمرین · 45 دقیقه

موقعیت: برای نمونه n8n خودت (یا نمونه آزمایشی محلی اگر هنوز نداری) «سند عملیات» بنویس و یک آزمون بازیابی واقعی انجام بده. ورک‌فلوها و Credentialهای آزمون را ساختگی بگذار یا نسخه ناشناس‌شده بساز.

  1. نمودار استقرار: سرویس‌ها، پورت‌ها، volumeها، رازها و محل هرکدام.
  2. سیاست پشتیبان: چه، کی، کجا، چند نسخه، و جای کلید.
  3. آزمون بازیابی روی نمونه جدا با شاهد: تعداد ورک‌فلو، باز شدن یک Credential، اجرای یک ورک‌فلو و زمان کل.
  4. دستورالعمل ارتقا برای نسخه بعدی با معیار برگشت.

خروجی مورد انتظار: سند عملیات، شاهد آزمون بازیابی و دستورالعمل ارتقا.

معیار پذیرش:

  • هیچ پورتی جز پراکسی منتشر نشده است (یا در اجرای محلی فقط روی 127.0.0.1).
  • کلید رمزنگاری جدا از پشتیبان نگهداری می‌شود و بازیابی با آن آزموده شده است.
  • نسخه n8n و image runner سنجاق‌شده و یکسان‌اند.
  • برنامه برگشت پشتیبان پیش از ارتقا را دارد.

پرسش‌های سنجش

جمع‌بندی

  • فقط پراکسی پورت دارد؛ n8n با PostgreSQL، task runner خارجی هم‌نسخه و رازهای _FILE.
  • کلید رمزنگاری را خودت بده، جدا از پشتیبان نگه دار و بی‌فرایند عوضش نکن.
  • پشتیبان: ورک‌فلوهای خوانا، Credential رمزنگاری‌شده، dump پایگاه داده و checksum؛ نسخه بیرون از سرور.
  • پشتیبانی که بازیابی‌اش آزموده نشده، پشتیبان نیست؛ «import موفق» یعنی بازیابی موفق نیست.
  • نسخه سنجاق‌شده، خواندن تغییرات ناسازگار، پشتیبان پیش از ارتقا.
  • برگشت = نسخه قبلی + پشتیبان پیش از ارتقا.

پرسش‌های سنجش

سرور n8n برگ سبز از دست رفته. dump پایگاه داده دیروز را داری، ولی پوشه n8n_data و هیچ ثبت جدایی از کلید رمزنگاری نداری. پس از بازیابی روی سرور تازه چه چیزی کار می‌کند، چه چیزی نه، و چه باید بکنی؟

پاسخ نمونه و معیار ارزیابی

ورک‌فلوها، تاریخچه اجراها و ساختار Credentialها برمی‌گردند، چون در پایگاه داده‌اند. ولی Credentialها با کلید قبلی رمزنگاری شده‌اند و n8n تازه کلید دیگری دارد؛ پس خواندنشان خطای «Credentials could not be decrypted» می‌دهد. باید همه Credentialها را از نو بسازی (کلیدها و توکن‌ها را از سرویس‌ها بگیری یا عوض کنی) و از این به بعد کلید را صریح با N8N_ENCRYPTION_KEY_FILE بدهی و جدا نگه داری.

  • ورک‌فلوها برمی‌گردند (1 امتیاز)
  • Credentialها بدون کلید باز نمی‌شوند (1 امتیاز)
  • ساخت دوباره Credentialها و سیاست کلید جدا (1 امتیاز)
  • همه چیز برمی‌گردد ← Credentialها رمزنگاری‌شده‌اند؛ بدون همان کلید فقط داده بی‌معنی‌اند.

چه اتفاقی افتاده و درست‌ترین اقدام چیست؟ چرا «پاک‌کردن فایل config تا n8n روشن شود» کار خطرناکی است؟

لاگ n8n پس از اینکه کسی فایل secret را «برای امنیت» با مقدار تازه ساخت:

Mismatching encryption keys. The encryption key in the settings file /home/node/.n8n/config does not match the N8N_ENCRYPTION_KEY env var.
پاسخ نمونه و معیار ارزیابی

کلید تازه با کلید ذخیره‌شده در پوشه داده n8n فرق دارد و n8n برای جلوگیری از خرابی Credentialها روشن نمی‌شود. اقدام: کلید قبلی را از مدیر راز در فایل secret برگردان و n8n را راه بینداز. اگر واقعاً می‌خواهی کلید را عوض کنی، فرایند چرخش کلید را دنبال کن. پاک‌کردن config یعنی n8n با کلید تازه روشن می‌شود، ولی همه Credentialهای موجود با کلید قبلی رمزنگاری شده‌اند و دیگر باز نمی‌شوند.

  • علت: تفاوت کلید (1 امتیاز)
  • برگرداندن کلید قبلی (1 امتیاز)
  • خطر پاک‌کردن config برای Credentialها (1 امتیاز)
  • config را پاک کن ← n8n روشن می‌شود ولی همه Credentialها را از دست می‌دهی.

برای استقرار تولیدی n8n روی یک سرور، فهرست سرویس‌ها، پورت‌ها و محل هر راز را بنویس و برای هر انتخاب یک دلیل بیاور.

پاسخ نمونه و معیار ارزیابی

Caddy تنها سرویس با پورت 80 و 443 (TLS خودکار، یک در ورودی)؛ n8n بدون پورت منتشرشده، با N8N_WEBHOOK_URL و N8N_PROXY_HOPS=1؛ PostgreSQL بدون پورت با volume و healthcheck؛ n8nio/runners با برچسب هم‌نسخه n8n و حالت external (کد Code جدا از n8n). رازها: رمز PostgreSQL و کلید رمزنگاری در فایل secret با _FILE؛ توکن داخلی runner در .env بیرون از Git؛ کلید رمزنگاری علاوه بر آن در مدیر راز. نسخه‌ها سنجاق‌شده در .env.

  • فقط پراکسی پورت دارد (1 امتیاز)
  • PostgreSQL و runner خارجی هم‌نسخه (1 امتیاز)
  • رازها با _FILE و کلید جدا (1 امتیاز)
  • متغیرهای پشت پراکسی (1 امتیاز)
  • SQLite کافی است ← برای نمونه کوچک ممکن است کافی باشد، ولی پشتیبان سازگار و رشد با PostgreSQL ساده‌تر است؛ انتخاب را با دلیل بنویس.

پشتیبان را روی نمونه تازه import کردی و هر دو فرمان «Successfully imported» دادند. برای اطمینان از قابل استفاده بودن Credentialها کدام کار لازم است؟

  • هیچ؛ پیام موفقیت کافی است.
  • یک Credential را باز کن یا یک ورک‌فلو آزمایشی که از آن استفاده می‌کند اجرا کن.
  • تعداد فایل‌های پشتیبان را بشمار.
  • نمونه را دوباره راه‌اندازی کن.
پاسخ نمونه و معیار ارزیابی
  • a ← import داده رمزنگاری‌شده را بی‌آنکه بخواند ذخیره می‌کند؛ خطای کلید هنگام خواندن پیدا می‌شود.
  • c ← تعداد فایل درست است ولی چیزی درباره قابل‌خواندن بودن نمی‌گوید.
  • d ← راه‌اندازی دوباره کلید غلط را درست نمی‌کند.

تیم می‌خواهد برای «همیشه امن بودن» n8n را با برچسب latest و Watchtower (به‌روزرسانی خودکار image) اجرا کند. موازنه را در برابر نسخه سنجاق‌شده با ارتقای دستی ماهانه بنویس.

پاسخ نمونه و معیار ارزیابی

به‌روزرسانی خودکار وصله‌های امنیتی را زود می‌آورد، ولی نسخه‌های اصلی با تغییرات ناسازگار هم بی‌خبر می‌آیند، migration پایگاه داده بدون پشتیبان پیش از ارتقا اجرا می‌شود و برگشت سخت است؛ ورک‌فلوی حساس ممکن است بی‌صدا خراب شود. نسخه سنجاق‌شده با ارتقای برنامه‌ریزی‌شده پشتیبان، خواندن یادداشت انتشار، آزمون و برنامه برگشت دارد، ولی وصله امنیتی دیرتر می‌رسد. پیشنهاد: سنجاق نسخه، پیگیری اعلان‌های امنیتی n8n و ارتقای فوری با همان دستورالعمل برای وصله‌های امنیتی، و ارتقای عادی ماهانه.

  • خطر تغییر ناسازگار و migration بی‌پشتیبان (1 امتیاز)
  • تأخیر وصله امنیتی در روش دستی (1 امتیاز)
  • ترکیب: سنجاق + ارتقای فوری امنیتی با دستورالعمل (1 امتیاز)
  • خودکار همیشه بهتر است ← خودکار بدون پشتیبان و آزمون، خرابی را هم خودکار می‌کند.

فایل‌های درس

n8n، PostgreSQL، task runner و Caddy؛ فقط پراکسی پورت دارد؛ رازها از فایل

compose.yaml

دامنه، منطقه زمانی و نسخه‌های سنجاق‌شده

env.example

پراکسی معکوس n8n با TLS خودکار

Caddyfile

پشتیبان ورک‌فلو، Credential رمزنگاری‌شده و پایگاه داده با checksum

backup.sh

دستورالعمل پشتیبان، آزمون بازیابی، ارتقا و برگشت

runbook.md

خروجی واقعی پشتیبان و بازیابی با کلید درست و کلید غلط

backup-restore-session.txt

ابزارها و جایگزین‌ها

  • Docker Engine با Compose v2 — اجرای n8n و PostgreSQL — n8n نصب‌شده با npm برای بخش پشتیبان و بازیابی — مسیر بدون نصب با خروجی واقعی

منابع

n8n-hosting (official deployment examples) n8n (GitHub, MIT) commit e662c4f, 2026-10

Choose n8n's database n8n n8n docs, 2026-10

Basic configuration (environment variables and _FILE) n8n n8n docs, 2026-10

Install with Docker n8n accessed 2026-10-16; page marked outdated, recommends Docker Compose

Set up task runners n8n n8n docs, 2026-10

Configure webhook URLs with reverse proxy n8n n8n docs, 2026-10

Manage execution data n8n n8n docs, 2026-10

Set a custom encryption key n8n n8n docs, 2026-10

Use the command line (CLI commands) n8n n8n docs, 2026-10

n8n v2.0 breaking changes n8n n8n 2.0; accessed 2026-10-16

Course

n8n in Production