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

ضبط Keepalive بين Nginx وUpstream دون استنزاف اتصالات الخلفية

إعداد اتصال HTTP مستمر بين Nginx والخلفية، فهم مخزن الاتصالات الخاملة لكل Worker والتحقق من إعادة الاستخدام بأمان.

ضبط Keepalive بين Nginx وUpstream دون استنزاف اتصالات الخلفية

إنشاء اتصال TCP جديد لكل طلب يمر عبر البروكسي يزيد العمل على Nginx والتطبيق. يسمح Upstream Keepalive بإعادة استخدام اتصال خامل، لكنه قد يستنزف سعة الخلفية إذا كان المخزن أكبر من الحاجة. يشرح هذا الدليل بروكسي HTTP العادي، وليس FastCGI الخاص بـPHP-FPM ولا أنفاق WebSocket. الهدف خفض إنشاء الاتصالات من دون إخفاء أخطاء التطبيق أو استهلاك جميع منافذه المتاحة.

١. افصل مساري الاتصال

اتصال المتصفح بـNginx مستقل عن اتصال Nginx بالخلفية. تفعيل HTTP/2 على الموقع العام لا يثبت إعادة استخدام اتصالات التطبيق. كما أن تغيير مهلة Keepalive الخاصة بالعميل لا يعوض إعداد مجموعة Upstream. ارسم المسار الفعلي: العميل، وCDN إن وجد، وNginx ثم منفذ التطبيق. لكل مسار إعداداته وقدرته على الاحتفاظ بالاتصالات.

٢. تحقق من الإصدار وسجل الحالة الأساسية

nginx -v
sudo nginx -T

تغيرت إعدادات Upstream الافتراضية في Nginx 1.29.7، بما فيها تفعيل مخزن الاتصالات الخاملة افتراضياً. قد تحتاج حزم التوزيعات الأقدم إلى إعداد صريح. يحدد المثال HTTP/1.1 بوضوح؛ لا تفترض أن الدليل الإلكتروني الأحدث يطابق إصدار الخادم. احفظ نسخة خاصة من الإعداد، ولا تنشر مخرجات nginx -T إذا احتوت على رؤوس أو مسارات داخلية.

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

٣. ابدأ بمخزن خامل صغير

# Inside the existing http {} context
upstream app_backend {
    server 127.0.0.1:8080;
    keepalive 16;
    keepalive_requests 1000;
    keepalive_timeout 15s;
}

# Inside the existing server {} context
location / {
    proxy_pass http://app_backend;
    proxy_http_version 1.1;
    proxy_set_header Connection "";
    proxy_set_header Host $host;
}

ادمج المقاطع في http وserver الموجودين؛ لا تنشئ location / مكرراً. استبدل العنوان بمنفذ تطبيقك الفعلي. يجب أن تدعم الخلفية HTTP المستمر وتحدد حدود الاستجابة بشكل صحيح. تحديد HTTP/1.1 وإفراغ Connection يمنع تمرير رأس يغلق الاتصال. هذا المثال لا يصلح كما هو لمسار WebSocket الذي يحتاج إلى Upgrade.

٤. لا تخلط المخزن مع الحد الإجمالي

يعني keepalive 16 تخزين ما يصل إلى ١٦ اتصالاً خاملاً لكل Worker لمجموعة Upstream، وليس ١٦ اتصالاً نشطاً كحد أقصى. قد يحتفظ أربعة Workers بنحو ٦٤ اتصالاً خاملاً للمجموعة، إضافة إلى الاتصالات النشطة. تستهلك نسخ Nginx الأخرى والعملاء الآخرون سعة إضافية. أما max_conns فيتعلق بالاتصالات النشطة ويعتمد نطاق احتسابه على Shared Zone؛ ليس ضماناً عاماً لعدد الاتصالات النشطة والخاملة مجتمعة.

يغلق keepalive_requests الاتصال بعد عدد من الطلبات لتحرير الموارد دورياً. يحدد keepalive_timeout مدة بقاء اتصال Upstream خاملاً في المخزن، وليس مهلة تنفيذ الاستجابة. قيم المثال نقطة بداية تحتاج إلى قياس، وليست وصفة لكل الأنظمة. نسقها مع سعة الخلفية وسياسة إغلاق الاتصالات الخاملة فيها.

٥. تحقق من إعادة الاستخدام بأكثر من مؤشر

# Inside http {}
log_format upstream_timing '$request status=$status upstream=$upstream_addr '
                           'connect=$upstream_connect_time '
                           'header=$upstream_header_time '
                           'response=$upstream_response_time';
# Inside the target server {}
access_log /var/log/nginx/upstream-timing.log upstream_timing;
nginx -v
sudo nginx -t
# Run only after the configuration test succeeds:
sudo systemctl reload nginx
curl -sS -o /dev/null -w 'status=%{http_code} total=%{time_total}
' https://app.example.com/health
sudo tail -n 30 /var/log/nginx/upstream-timing.log
sudo ss -ntp '( dport = :8080 )'

استبدل النطاق التجريبي بنطاق مصرح به. نفذ Reload فقط بعد نجاح فحص الإعداد، ثم أرسل عدداً محدوداً من طلبات GET الآمنة. راقب معدل قبول الاتصالات الجديدة في الخلفية وحالة المقابس وأزمنة الاتصال. قد يظهر connect=0.000 حتى لاتصال محلي جديد بسبب دقة القياس، لذلك لا تعتبره دليلاً منفرداً. كذلك فإن لقطة ss لا تثبت إعادة الاستخدام عبر الزمن.

٦. شخّص التراجع واحتفظ بخطة رجوع

  • إذا أرسلت الخلفية Connection: close، افحص دعم الاستمرار وطريقة تحديد نهاية الاستجابة.
  • إذا ظهرت أخطاء Reset أو 502 بعد فترة خمول، قارن مهل الطرفين وراجع سجل التطبيق؛ لا تعالجها بإعادة محاولات عمياء لطلبات الكتابة.
  • إذا تقلصت السعة المتاحة في الخلفية، خفض المخزن وافحص عدد Workers وجميع العملاء الآخرين.
  • إذا ساءت النتائج، استعد الإعداد السابق، افحصه بـnginx -t ثم أعد التحميل وكرر قياس الحالة الأساسية.

معيار نجاح التغيير

اقبل التغيير فقط عند انخفاض إنشاء الاتصالات تحت حمل مماثل، وبقاء سعة كافية للخلفية، واستمرار الحالات الصحيحة وعدم ارتفاع معدل الأخطاء. Keepalive يعيد استخدام النقل ولا يخزن محتوى الصفحات ولا يصلح كود التطبيق البطيء. راجع أرشيف المقالات العربية للأدلة المنفصلة حول 502 وبطء Upstream.

مراجع رسمية

NGINX upstream module · NGINX proxy module