سير عمل يصمد بعد إعادة التشغيل التالية.

احمِ المحرر

ضع المحرر خلف HTTPS ومصادقة مدعومة. قيّد الوصول الإداري وتجنب التسجيل العام عند عدم الحاجة. مسارات Webhook تحتاج قرارات كشف ومصادقة خاصة بها.

احتفظ بمفتاح الاعتماد

انسخ مفتاح التشفير المُعدّ احتياطيًا مع حماية مناسبة. قد تؤدي استعادة قاعدة بيانات دون المفتاح الصحيح إلى ترك بيانات الاعتماد المحفوظة غير قابلة للاستخدام. أبقِ المفتاح خارج لقطات الشاشة والمستودعات والسجلات غير المفلترة.

وسّع مسار التنفيذ بشكل مقصود

لإعداد مزدحم، راجع نموذج قاعدة البيانات وقائمة الانتظار والعمال المدعوم. يضيف Redis والعمال المنفصلون متطلبات وصول واستمرارية خاصة بهم. حدّد المهام المتزامنة حتى لا تستنزف الزيادة VPS أو ميزانية API خارجية.

احتفظ فقط ببيانات التنفيذ المفيدة

سير العمل يقدر يتعامل مع الرموز والسجلات الشخصية والمستندات. اضبط تقليم سجل التنفيذ، وامسح القيم الحساسة، وحدّد إعادة المحاولة بعناية. الـ webhook المكرر مايصحّش يسبب دفعة أو رسالة تانية غير مقصودة.

اتعامل مع مفتاح التشفير كجزء من قاعدة البيانات

تعتمد بيانات الاعتماد المحفوظة على مفتاح تشفير n8n. حافظ على دليل الحالة الذي يحتوي على مفتاح مُولَّد تلقائيًا أو عيّن N8N_ENCRYPTION_KEY من مخزن أسرار خاص. يحتاج جميع عمال الطوابير إلى المفتاح نفسه الذي يستخدمه العملية الرئيسية. اختبر الاستعادة ببيانات اعتماد مؤقتة؛ قد تبدو قاعدة بيانات مستعادة سليمة وحدها بينما تظل بيانات اعتمادها غير قابلة للقراءة.

• احفظ المفتاح خارج الدليل العام والمستودع
• اعمل نسخ احتياطي لقاعدة البيانات بشكل متسق
• استخدم PostgreSQL المدعوم لنشر الإنتاج المقصود

الوثائق الرسمية: إعداد مفتاح التشفير n8n

امنح خطافات الويب عنوانها العام

بروكسي عكسي زي Caddy ممكن ينهي HTTPS بينما n8n بيسمع داخليًا. التوثيق الحالي بيستخدم N8N_WEBHOOK_URL لأصل الويب هوك الخارجي وبيستبدل الاسم الأقدم WEBHOOK_URL من الإصدار 2.35.0. اضبط عدد قفزات البروكسي الموثوق على المسار الحقيقي؛ البروكسي الواحد بيستخدم N8N_PROXY_HOPS=1. حافظ على المضيف والبروتوكول ومعلومات العميل المُمرَّرة. اختبر ويب هوك من برا السيرفر وتحقق من URL في الإنتاج.

• اضبط المنطقة الزمنية لسير العمل بوعي
• امسح سجل التنفيذ اللي فيه مدخلات حساسة
• استخدم queue workers وRedis بس مع ضوابط الوصول الخاص المطلوبة

# Example: one HTTPS reverse proxy
N8N_WEBHOOK_URL=https://automations.example.com/
N8N_PROXY_HOPS=1

الوثائق الرسمية: n8n ورا بروكسي عكسي

حدّد حجم العمل والتكاملات المسموح بها

اسرد المحفزات والحسابات الخارجية وحجم التنفيذ المتوقع وأقصى إنفاق أو تأثير جانبي ممكن كل سير عمل يسببه. راجع ترخيص n8n للاستخدام الفعلي، خصوصًا لو بتقدمه كخدمة للآخرين. سير عمل مجدول صغير ومعالج webhook عام ليهم احتياجات موارد مختلفة. ابدأ بإصدار مدعوم وحالة مستمرة خاصة واسم TLS وقاعدة بيانات مناسبة للنشر؛ وتجنب كشف منافذ قاعدة البيانات مع المحرر.

• استخدم بيانات اعتماد مقيدة منفصلة لكل تكامل.
• حدد المنطقة الزمنية لسير العمل ومدة الاحتفاظ بسجل التنفيذ.
• خلّي سير العمل المصدّر خالي من الأسرار الحقيقية المضمّنة.

الوثائق الرسمية: نشر n8n بـ Docker

اضبط أصل الـ webhook العام للإصدار المثبت

بروكسي عكسي زي Caddy بيوصل لـ n8n داخليًا بينما الخدمات الخارجية بتنادي أصل الويب هوك بتاعه HTTPS. استخدم متغير URL الخاص بالويب هوك الموثّق للإصدار المثبّت؛ التوثيق الحالي بيسميه N8N_WEBHOOK_URL، بينما الإصدارات الأقدم كانت بتستخدم WEBHOOK_URL. اضبط عدد قفزات البروكسي الحقيقي بدل ما تثق في هيدرات مُمرَّرة عشوائية. خلّي سياسة الوصول للمحرر منفصلة عن مصادقة الويب هوك، وتأكد إن رد الاتصال في الإنتاج مش فيه مضيف أو منفذ داخلي.

# Example values for a supported current release, behind one proxy:
N8N_WEBHOOK_URL=https://automations.example.com/
N8N_PROXY_HOPS=1

الوثائق الرسمية: إعدادات الوكيل العكسي لـ n8n webhook

اختبر سير عمل غير ضار قبل ما تمنح صلاحية الكتابة

ابدأ بطلب للقراءة فقط أو بسجل اختبار مؤقت. اختبر الـ webhook الإنتاجي من برّه VPS، ورفض المصادقة، وإعادة محاولة متعمدة. الطلب المتكرر ماينفعش يعمل إجراء تاني ذو أثر بالغلط. راجع سجلات التنفيذ للتأكد من عدم تسريب مدخلات، وبعدها طبّق سياسة احتفاظ. لو الـ webhook بيشتغل بس في وضع الاختبار بتاع المحرر، اتأكد إذا كان الـ workflow منشور/نشط وإذا كانت مسارات الإنتاج والاختبار بتوصل للعملية الصح.

• استخدم بيانات اعتماد تكامل مؤقتة لاختبار الاستعادة.
• احتفظ بنسخة مشفرة مستقلة من N8N_ENCRYPTION_KEY أو حالة المفتاح المولّد.
• متبعتش كلمات سر تجريبية أو توكنات API في مخرجات تصحيح بيتحفظ.

الوثائق الرسمية: مفتاح تشفير n8n

وسّع بس بعد ما تلاحظ عنق زجاجة التنفيذ

وضع الطابور بيضيف Redis وعمال وقاعدة بيانات مشتركة؛ العملية الرئيسية بتستقبل المحفزات بينما العمال بينفذوا. كل عامل لازم يستخدم نفس مفتاح تشفير بيانات الاعتماد. اتبع متطلبات تخزين البيانات الثنائية الحالية قبل ما تنقل سير عمل فيه ملفات لوضع الطابور. حدّد التزامن وميزانيات API للمصدر، وراقب عمر الطابور والأعطال. خد نسخة احتياطية من قاعدة البيانات والحالة والمفتاح مع بعض؛ إعادة تشغيل كونتينر مش خطة استعادة لبيانات اعتماد محفوظة غير قابلة للقراءة.

الوثائق الرسمية: وضع طابور n8n · إعدادات مسح التنفيذ