ما هي مشكلة “Lost Connection” في n8n؟

إذا كنت تستخدم n8n على Docker وظهرت لك هذه الرسالة:

“Connection lost: You have a connection issue or the server is down. n8n should reconnect automatically once the issue is resolved.”

فأنت لست وحدك — هذه من أكثر المشاكل شيوعاً عند تشغيل n8n على بيئة self-hosted باستخدام Docker أو Docker Compose.

المشكلة لا علاقة لها بالإنترنت أو بالسيرفر — المشكلة في إعدادات الـ WebSocket.

لماذا تحدث هذه المشكلة؟

n8n يستخدم بروتوكول WebSocket للتواصل بين الـ frontend والـ backend في الوقت الفعلي. في بعض إصدارات n8n، الإعداد الافتراضي يكون SSE (Server-Sent Events) بدلاً من websocket، وهذا يسبب مشاكل خاصةً خلف Nginx proxy أو في بيئات Docker.

الحل — سطر واحد في docker-compose.yml

افتح ملف docker-compose.yml الخاص بـ n8n وأضف هذا السطر تحت قسم environment:

N8N_PUSH_BACKEND=websocket

مثال كامل:

environment:
  - N8N_HOST=your-domain.com
  - N8N_PROTOCOL=https
  - WEBHOOK_URL=https://your-domain.com/
  - N8N_PUSH_BACKEND=websocket

أعد تشغيل الـ Container

بعد حفظ الملف، شغّل الأمر التالي في الـ terminal:

docker compose down && docker compose up -d

ثم افتح n8n في المتصفح — المشكلة انحلت! ✅

خلاصة

• المشكلة: n8n يستخدم SSE بدلاً من WebSocket افتراضياً في بعض الإصدارات
• الحل: أضف N8N_PUSH_BACKEND=websocket في متغيرات البيئة
• أعد تشغيل الـ container وانتهت المشكلة

إذا واجهت أي مشكلة أخرى في n8n، تابع FlowStack AI للحصول على حلول مشاكل الأتمتة بالعربي 🚀

]]>