كل المقالات التقنية

إعداد WebSocket خلف Nginx وحل فشل Upgrade

سلامة صفحة HTTP لا تعني أن المحادثة أو لوحة المتابعة المباشرة تعمل.

إعداد WebSocket خلف Nginx وحل فشل Upgrade

يحتاج WebSocket إلى ترقية الاتصال واستجابة 101 واتصال يتحمل فترات الخمول. افحص المتصفح وNginx والتطبيق كلّاً على حدة قبل زيادة المهلات.

النطاق والمتطلبات

المثال موجّه لتطبيق HTTP على Loopback وليس FastCGI. طابق المسار /ws/ والمنفذ 3000 مع التطبيق. احتفظ بنسخة من الإعداد الفعّال وحافظ على TLS والمصادقة وفحص Origin؛ فتح النفق لا يلغي ضرورة التفويض.

١. اجمع الأدلة

سجّل طلب المصافحة ورمز الاستجابة في المتصفح: قد يشير 400 إلى الطلب أو الترويسات، و401/403 إلى التفويض، و502 إلى الخلفية. اختبر التطبيق مباشرة من خادم البروكسي. قارن توقيت الانقطاع بالسجلات؛ الفترة الثابتة أثناء الخمول دليل مهم.

curl -I http://127.0.0.1:3000/
sudo nginx -T | less

٢. نفّذ تغييراً مضبوطاً

ترويسات Upgrade وConnection خاصة بالقفزة ويجب تمريرها صراحة. ضع map في سياق http وlocation داخل server المناسب. تحديد HTTP/1.1 صراحة يدعم الإصدارات الأقدم. حافظ على مسار الخلفية؛ إضافة URI إلى proxy_pass تغيّر إعادة كتابة المسار.

# http context
map $http_upgrade $connection_upgrade {
    default upgrade;
    "" close;
}
# inside server
location /ws/ {
    proxy_pass http://127.0.0.1:3000;
    proxy_http_version 1.1;
    proxy_set_header Upgrade $http_upgrade;
    proxy_set_header Connection $connection_upgrade;
    proxy_set_header Host $host;
    proxy_read_timeout 75s;
}

٣. تحقّق من النتيجة

بعد فحص الصياغة وإعادة التحميل، تأكد من 101 وتبادل الرسائل في الاتجاهين من متصفح حقيقي. اترك الاتصال خاملاً أطول من مدة الفشل السابقة واختبر إعادة الاتصال. المهلة الأطول ليست heartbeat؛ نسّق ping مع جميع الوسطاء.

sudo nginx -t && sudo systemctl reload nginx

التراجع والوقاية

إذا ارتفعت الأخطاء أو استهلاك الاتصالات، أعد الملف المعدّل ثم افحصه وأعد التحميل. راقب الاتصالات المتزامنة ومدة الجلسات وفشل المصافحة. proxy_read_timeout يضبط الفاصل بين القراءات لا عمر الجلسة الكامل، وزيادته بلا حدود لا تصلح تطبيقاً متوقفاً.

لفحص الجوانب المرتبطة بهذا المسار، راجع استعادة IP العميل الحقيقي خلف بروكسي موثوق في Nginx وApache Reverse Proxy: حل حلقات التحويل وHost الخاطئ.

المراجع التقنية