انتقل إلى المحتوى
دليل الويب

وكلاء الذكاء الاصطناعي والأتمتة

أشهر مشكلات n8n على سيرفرك الخاص وطريقة حلها

حلول أكثر مشكلات n8n شيوعًا على السيرفرات الخاصة: نفاد الرامات، وانقطاع الاتصال، وروابط Webhook تظهر بـ localhost، وامتلاء مساحة التخزين، ورسائل لا تصل.

بقلم فريق تحرير دليل الويبنُشر في قراءة في 3 دقائق
خطوات Workflow مترابطة ترمز إلى أتمتة n8n

تشغيل n8n على سيرفرك مستقر بعد إعداده، لكن هناك مجموعة من المشكلات تتكرر كثيرًا. إليك كيف تتعرف على كل واحدة وكيف تحلها. الحلول مأخوذة من توثيق n8n الرسمي، وتفترض إعداد Docker Compose الموجود في دليل التثبيت.

1. "Connection Lost" أو توقف الـ Workflow في المنتصف (الرامات)

ما الذي تراه: رسائل مثل "Execution stopped at this node (n8n may have run out of memory while executing it)" أو "Connection Lost" أو "503 Service Temporarily Unavailable". وفي سجلات السيرفر: "Allocation failed - JavaScript heap out of memory".

السبب: الـ Workflow يتعامل مع بيانات أكبر مما تسمح به الذاكرة. ويذكر توثيق n8n الأسباب المعتادة: بيانات JSON أو ملفات كبيرة، وعدد كبير من النودز، ونودز الأكواد (Code)، والتشغيل اليدوي، وتشغيل عدة Workflows في الوقت نفسه. ومع Docker يعيد n8n تشغيل نفسه، فيبدو الأمر كأنه انقطاع عشوائي.

الحل:

  1. عالج البيانات على دفعات أصغر: استخدم نود Loop Over Items، وانقل الأجزاء الثقيلة إلى Workflow فرعي عبر نود Execute Workflow.
  2. تجنّب نود Code مع البيانات الكبيرة إن كان هناك نود جاهز يؤدي المهمة.
  3. لا تجرّب بيانات ضخمة بالتشغيل اليدوي من المحرر.
  4. أعطِ Node.js ذاكرة أكبر عبر متغير بيئة، ثم أعد إنشاء الكونتينر:
environment:
  - NODE_OPTIONS=--max-old-space-size=2048

اجعل القيمة (بالميجابايت) أقل من الرامات المتاحة في سيرفرك، وراقب الاستهلاك بالأمر docker stats. وإن كانت الرامات صغيرة أصلًا فانتقل إلى خطة أكبر.

2. روابط الـ Webhook تظهر بـ localhost:5678

السبب: n8n لا يعرف عنوانه على الإنترنت.

الحل: اكتب الرابط العام وأعد إنشاء الكونتينر:

environment:
  - N8N_WEBHOOK_URL=https://n8n.example.com/

في إصدارات n8n الأقدم من 2.30 اسم المتغير WEBHOOK_URL. واضبط أيضًا N8N_PROXY_HOPS=1 إن كان أمام n8n Reverse Proxy واحد مثل Traefik أو Nginx.

3. صفحات لا تعمل عند تشغيل n8n على مسار فرعي

ما الذي تراه: n8n يعمل على example.com/n8n خلف Reverse Proxy، وبعض الشاشات أو المجلدات لا تفتح.

الحل: توثيق n8n يحذّر من أن الجمع بين N8N_PATH والـ Reverse Proxy قد يسبب مشكلات في التنقل. استخدم ساب دومين مثل n8n.example.com بدلًا من ذلك.

4. مساحة التخزين تمتلئ باستمرار

السبب: سجل تشغيل الـ Workflows يُحفظ في قاعدة البيانات.

الحل: n8n يحذف السجلات القديمة تلقائيًا (EXECUTIONS_DATA_PRUNE=true)، ويحتفظ بها 336 ساعة (14 يومًا)، وبحد أقصى 10,000 عملية تشغيل. إن كانت المساحة صغيرة أو الـ Workflows تعمل كثيرًا، فقلّل هذه الحدود:

environment:
  - EXECUTIONS_DATA_MAX_AGE=168
  - EXECUTIONS_DATA_PRUNE_MAX_COUNT=5000

ويمكنك أيضًا إيقاف حفظ عمليات التشغيل الناجحة للـ Workflows كثيرة التشغيل بـ EXECUTIONS_DATA_SAVE_ON_SUCCESS=none، والاحتفاظ بالأخطاء فقط.

5. الـ Workflows المجدولة تعمل في وقت خاطئ

الحل: اضبط المنطقة الزمنية، كما في مثال Docker Compose من n8n:

environment:
  - GENERIC_TIMEZONE=Asia/Riyadh
  - TZ=Asia/Riyadh

6. لا تستطيع تسجيل الدخول عبر http://

السبب: n8n يستخدم ملفات تعريف ارتباط آمنة (Secure cookies)، والمتصفحات لا ترسلها إلا عبر HTTPS.

الحل: افتح n8n دائمًا عبر الرابط الذي يبدأ بـ https://. وإن لم تكن فعّلت HTTPS بعد، فاتبع إعداد Traefik في دليل التثبيت بدلًا من إيقاف هذه الحماية.

7. رسائل واتساب لا تصل إلى n8n

السبب: بحسب توثيق n8n، ترسل Meta الرسائل فقط إلى التطبيقات المرتبطة (Subscribed) بحساب واتساب للأعمال، وn8n لا يربطها تلقائيًا، ولا يظهر أي خطأ.

الحل: اربط التطبيق بالحساب عبر Graph API من Meta، كما في دليل وكيل واتساب.

متى تنتقل إلى PostgreSQL؟

n8n على سيرفرك يستخدم SQLite افتراضيًا، وهذا مناسب للاستخدام الصغير. وإن كنت تشغّل Workflows كثيرة أو تخطط لاستخدام Queue mode للتوسع، فانتقل إلى PostgreSQL (يدعم n8n الإصدارات من 16 إلى 18 في 2026) باستخدام إعدادات DB_TYPE=postgresdb الموجودة في توثيق قواعد البيانات لدى n8n.

المصادر والمراجع

  1. توثيق n8n: حل مشكلات الذاكرة (بالإنجليزية)
  2. توثيق n8n: متغيرات التشغيل (بالإنجليزية)
  3. توثيق n8n: متغيرات النشر (بالإنجليزية)
  4. توثيق n8n: الإعداد بـ Docker Compose (بالإنجليزية)

وكلاء الذكاء الاصطناعي والأتمتة

تثبيت n8n على VPS باستخدام Docker مع شهادة SSL مجانية

شغّل n8n على سيرفرك الخاص باستخدام Docker Compose وشهادة Let's Encrypt مجانية وروابط Webhook صحيحة. إعداد مُختبَر وأرقام حقيقية لاستهلاك الذاكرة وطريقة النسخ الاحتياطي.

قراءة في 4 دقائق