⚖️ تثبيت HAProxy — موازن أحمال احترافي وتوفر عالي
انشر HAProxy على Ubuntu بـ Docker — موازن أحمال ووكيل عكسي عالي الأداء ومُختبر في الإنتاج، مع فحوصات صحة وإنهاء SSL وتحويل تلقائي عند الفشل لخدمات الويب وTCP.
📦 الملفات والأكواد المطلوبة
قبل البدء، يرجى التأكد من تحميل الأكواد المطلوبة من مستودعنا على GitHub لتتمكن من تطبيق الخطوات مع الفيديو بسهولة.
التثبيت السريع:
wget https://raw.githubusercontent.com/mhmdali94/Docker/main/Networking/haproxy/haproxy-ubuntu.sh
chmod +x haproxy-ubuntu.sh
sudo bash haproxy-ubuntu.sh
خطوات التنفيذ
1 تحميل السكريبت
wget https://raw.githubusercontent.com/mhmdali94/Docker/main/Networking/haproxy/haproxy-ubuntu.sh
2 منحه صلاحية التنفيذ
chmod +x haproxy-ubuntu.sh
3 تشغيل المثبّت
يثبّت السكريبت Docker إن لزم، يسحب صورة HAProxy الرسمية، ويُشغّل الحاوية بإعدادات أساسية تكشف HTTP وHTTPS ولوحة الإحصائيات.
sudo bash haproxy-ubuntu.sh
4 الدخول إلى لوحة الإحصائيات
افتح المتصفح وانتقل إلى صفحة إحصائيات HAProxy المدمجة لمراقبة صحة الخوادم الخلفية والاتصالات وحركة المرور في الوقت الفعلي:
http://<your-server-ip>:8404/stats
المنافذ المستخدمة
| المنفذ | الغرض |
|---|---|
| 80 | HTTP Frontend |
| 443 | HTTPS / SSL Termination |
| 8404 | Stats & Admin UI |
نظرة عامة
HAProxy (اختصار High Availability Proxy) موازن أحمال ووكيل عكسي مجاني ومفتوح المصدر يعمل على مستوى TCP/HTTP، مكتوب بلغة C ومشهور بأداء فائق واستهلاك موارد منخفض جداً. يوزّع حركة المرور الواردة عبر عدة خوادم خلفية، يجري فحوصات صحة مستمرة لتفادي الخوادم المعطلة، وينهي اتصالات SSL/TLS عند الحافة. يشغّل HAProxy بنية العديد من المواقع الكبرى ومزودي السحابة ويُعد المرجع الأساسي لموازنة الأحمال البرمجية.
لماذا تستخدمه
HAProxy هو الخيار المعياري في الصناعة عندما تحتاج توزيع حركة المرور عبر عدة خوادم خلفية بأقل تكلفة زمنية ممكنة وموثوقية صلبة. على عكس الوكلاء العكسيين الأبسط، يقدّم خوارزميات موازنة متقدمة، فحص صحة دقيقاً، طوابير اتصال، وإحصائيات فورية تفصيلية — كل ذلك بكفاءة على أجهزة متواضعة. ولأنه يعمل على المستوى الرابع (TCP) والمستوى السابع (HTTP) معاً، يمكنه موازنة ليس فقط حركة الويب بل قواعد البيانات وخوادم البريد وأي خدمة تعتمد على TCP، مما يجعله العمود الفقري لبنى التوفر العالي.
متى تحتاجه
- تُشغّل عدة خوادم أو حاويات خلفية وتحتاج توزيع حركة المرور بالتساوي مع تحويل تلقائي عند الفشل
- تحتاج إنهاء SSL/TLS في نقطة واحدة بدلاً من إعداد الشهادات على كل خادم خلفي
- يتطلب تطبيقك نشراً بدون توقف اعتماداً على فحوصات صحة تدريجية للخوادم الخلفية
- تحتاج موازنة أحمال لحركة مرور غير HTTP مثل MySQL أو PostgreSQL أو خدمات TCP مخصصة
- تريد إحصائيات فورية تفصيلية عن الاتصالات وأوقات الاستجابة وصحة الخوادم الخلفية
- تبني بنية توفر عالٍ وتحتاج وكيلاً مثبتاً وجاهزاً للإنتاج بدلاً من مشروع هاوٍ
- تحتاج جلسات لاصقة (sticky sessions) بحيث يصل المستخدمون دائماً لنفس الخادم الخلفي
حالات الاستخدام الشائعة
- موازنة حركة HTTP/HTTPS عبر عدة خوادم تطبيق ويب لتحقيق قابلية التوسع والتكرار
- إنهاء شهادات SSL/TLS مركزياً بدلاً من إدارة الشهادات على كل خادم خلفي
- توجيه حركة المرور إلى مجموعات خلفية مختلفة حسب النطاق أو المسار أو ترويسات HTTP
- توفير تحويل تلقائي عند الفشل — تُستبعد الخوادم غير السليمة من التدوير حتى تجتاز فحوصات الصحة مجدداً
- موازنة خدمات TCP مثل قواعد البيانات أو خوادم البريد أو خوادم الألعاب على المستوى الرابع
- تحديد معدل وطوابير الاتصالات لحماية الخوادم الخلفية من ارتفاعات حركة المرور المفاجئة
الميزات الرئيسية
- موازنة أحمال على المستوى الرابع (TCP) والسابع (HTTP/HTTPS) بخوارزميات متعددة (round robin، leastconn، source، تجزئة URI)
- فحوصات صحة نشطة وسلبية تستبعد تلقائياً الخوادم الخلفية الفاشلة من التدوير
- إنهاء وإعادة تشفير SSL/TLS مع دعم التوجيه حسب SNI لشهادات متعددة
- لوحة إحصائيات فورية مدمجة تعرض حالة الخوادم الخلفية وعدد الاتصالات وأوقات الاستجابة
- قواعد توجيه قائمة على ACL لإرسال حركة المرور لخوادم خلفية مختلفة حسب المسار أو الترويسة أو الكوكيز
- جلسات لاصقة عبر الكوكيز أو عنوان IP المصدر للتطبيقات التي تتطلب استمرارية الجلسة
- تحديد معدل وطوابير اتصالات لحماية الخوادم الخلفية من الحمل الزائد
- إعادة تحميل سلسة للإعدادات بدون أي توقف باستخدام آلية reload/socket
كيفية الاستخدام بعد التثبيت
- راجع ملف /etc/haproxy/haproxy.cfg الافتراضي (المُحمَّل من مجلد الإعدادات في الحاوية) وحدّد أقسام frontend وbackend الخاصة بك
- أضف خوادمك الخلفية داخل قسم backend مع عناوين IP والمنافذ الخاصة بها، واختر خوارزمية موازنة أحمال
- اضبط فحوصات الصحة (option httpchk أو tcp-check) حتى يكتشف HAProxy الخوادم الفاشلة تلقائياً ويتجنبها
- غيّر بيانات اعتماد لوحة الإحصائيات إلى شيء آمن بدلاً من تركها مفتوحة، ضمن قسم stats في الإعدادات
- أضف شهادات SSL إلى سطر bind في frontend لإنهاء HTTPS، أو اضبط إعادة التشفير للخوادم الخلفية إن لزم الأمر
- اختبر تغييرات الإعدادات بأمر haproxy -c -f haproxy.cfg قبل إعادة التحميل لاكتشاف أخطاء الصياغة بأمان
- أعد تحميل HAProxy بسلاسة بعد تغييرات الإعدادات لتطبيق الضبط الجديد دون قطع الاتصالات النشطة
أفضل ممارسات الأمان
- قيّد الوصول للوحة الإحصائيات على المنفذ 8404 بمصادقة وقائمة IP مسموحة، أو اربطها بـ localhost فقط
- لا تكشف صفحة الإحصائيات الخام للإنترنت العام بدون كلمة مرور قوية وTLS
- استخدم TLS 1.2 فأعلى فقط وعطّل الشيفرات القديمة في إعدادات bind لـ SSL
- اضبط قيم مهلة صارمة (timeout connect وtimeout client وtimeout server) لمنع هجمات العملاء البطيئين واستنزاف الاتصالات
- فعّل تحديد المعدل وحدود الاتصالات لكل IP مصدر لتخفيف محاولات حجب الخدمة البسيطة
- حافظ على تحديث صورة HAProxy من Docker لتحصل على تصحيحات الأمان للحزمة الأساسية
- شغّل الحاوية بأقل الصلاحيات الممكنة وتجنّب تحميل مسارات مضيف غير ضرورية إلى مجلد الإعدادات
المنافذ وإعدادات جدار الحماية
يستمع HAProxy على المنفذ 80 لحركة HTTP الأمامية والمنفذ 443 لـ HTTPS مع إنهاء SSL، وكلاهما عادة يُكشف للإنترنت لأن هذه هي مهمة الوكيل. المنفذ 8404 يخدم لوحة الإحصائيات والإدارة المدمجة ويجب ألا يُكشف علناً أبداً — قيّده على شبكتك المحلية أو VPN أو احمِه بمصادقة وقاعدة جدار ناري تحصر عناوين IP المصدر. منافذ الخوادم الخلفية يمكن الوصول إليها فقط من HAProxy نفسه عبر شبكة Docker الداخلية أو شبكة خاصة، ويجب ألا تُكشف مباشرة للإنترنت أبداً — يجب أن تمر كل حركة المرور العامة عبر الواجهة الأمامية لـ HAProxy.
النسخ الاحتياطي والصيانة
- انسخ ملف /etc/haproxy/haproxy.cfg احتياطياً — هذا الملف الوحيد يحدد منطق موازنة الأحمال والتوجيه بالكامل
- أدر ملف haproxy.cfg بنظام تحكم إصدارات مثل Git حتى تُتابَع التغييرات ويمكن التراجع عنها فوراً
- انسخ شهادات SSL/TLS والمفاتيح الخاصة المخزنة في مجلد الشهادات بالحاوية احتياطياً بشكل منفصل مع صلاحيات مقيدة
- احتفظ بنسخة من docker-compose.yml أو أمر التشغيل لإعادة إنشاء الحاوية بنفس الإعدادات بعد ترحيل السيرفر
- اختبر تغييرات الإعدادات على نسخة HAProxy تجريبية قبل تطبيقها في الإنتاج
- وثّق قائمة خوادمك الخلفية وإعدادات فحص الصحة خارج ملف الإعدادات كمرجع أثناء التعافي من الكوارث
الأخطاء الشائعة
- ترك لوحة الإحصائيات على المنفذ 8404 مكشوفة للإنترنت العام بدون مصادقة
- عدم ضبط فحوصات الصحة، مما يجعل HAProxy يستمر بإرسال حركة المرور لخوادم خلفية معطلة
- إعادة تحميل HAProxy بإعدادات غير صالحة دون اختبارها أولاً، مما يسبب انقطاعاً بدلاً من تراجع آمن
- استخدام موازنة round-robin لتطبيقات تحتاج استمرارية جلسة، مما يكسر جلسات المستخدمين
- ضبط مهلات طويلة جداً، مما يسمح للاتصالات البطيئة أو المتوقفة باستنزاف فتحات الاتصال المتاحة
- إنهاء SSL عند HAProxy لكن نسيان تأمين الاتصال بالخادم الخلفي، مما يترك حركة المرور غير مشفرة داخلياً على شبكة غير موثوقة
- عدم مراقبة لوحة الإحصائيات بانتظام، مما يُغفل علامات مبكرة على تدهور الخوادم الخلفية
استكشاف الأخطاء وإصلاحها
- أخطاء 502 Bad Gateway — تحقق من تشغيل الخوادم الخلفية وإمكانية الوصول إليها، وراجع حالة فحص الصحة في لوحة الإحصائيات
- الإعدادات لا تُعاد تحميلها — شغّل haproxy -c -f /etc/haproxy/haproxy.cfg للتحقق من الصياغة وتحديد السطر الدقيق المسبب للخطأ
- توزيع غير متساوٍ لحركة المرور — تحقق أن خوارزمية موازنة الأحمال تناسب حالتك؛ round robin لا يأخذ في الاعتبار حمل الخادم كما تفعل leastconn
- فشل مصافحة SSL — تأكد من اكتمال سلسلة الشهادة وتحقق أن سطر bind يتضمن مسار الشهادة الصحيح وإعدادات SNI
- الجلسات لا تلتصق بنفس الخادم الخلفي — تحقق من تفعيل استمرارية الجلسة عبر الكوكيز بشكل صحيح في قسم backend
- لوحة الإحصائيات لا يمكن الوصول إليها — تأكد أن المنفذ 8404 مكشوف في تعيين منافذ Docker وغير محظور بجدار الحماية
- زمن استجابة مرتفع تحت الحمل — راجع إعدادات المهلة وتحقق ما إذا كانت حدود maxconn قد وصلت حدها في الواجهة الأمامية أو الخلفية
البدائل
NGINX خادم ويب ووكيل عكسي أعم الغرض يوازن الأحمال أيضاً، وغالباً أبسط لإعدادات HTTP الصرفة، لكن HAProxy عادة يتفوق عليه في موازنة أحمال TCP ذات عدد اتصالات مرتفع ويقدّم فحص صحة وإحصائيات أعمق. Traefik مصمم لبيئات الحاويات الأصلية مع اكتشاف تلقائي للخدمات من علامات Docker أو Kubernetes، مضحياً بجزء من الأداء الخام مقابل سهولة الإعداد الديناميكي. Caddy يركز على HTTPS التلقائي والبساطة للمواقع الصغيرة والمتوسطة لكنه يفتقر لخوارزميات موازنة الأحمال المتقدمة وقدرات المستوى الرابع التي يملكها HAProxy. Nginx Proxy Manager يغلّف NGINX بواجهة ويب ودودة موجهة لمستخدمي المختبرات المنزلية، وهو أبسط بكثير من HAProxy في الإعداد لكنه أقل قدرة بكثير لموازنة أحمال إنتاجية جادة. من ناحية الأداء الخام ومرونة البروتوكولات والموثوقية المثبتة على نطاق واسع، يبقى HAProxy الخيار المرجعي.
متى لا تستخدمه
HAProxy على الأرجح أكثر مما تحتاج إذا كنت تُشغّل خادماً خلفياً واحداً بدون حاجة للتحويل عند الفشل أو إنهاء SSL — وكيل عكسي أبسط مثل Caddy أو Nginx Proxy Manager سيوصلك للهدف بإعداد أقل بكثير. إذا كانت حاجتك الأساسية اكتشاف الخدمات تلقائياً في بيئة تنسيق حاويات، فإعداد Traefik القائم على العلامات أكثر ملاءمة من صيانة ملف إعدادات HAProxy يدوياً. صياغة إعدادات HAProxy لها أيضاً منحنى تعلّم — الفرق التي تريد واجهة رسومية لإدارة قواعد التوجيه قد تفضّل Nginx Proxy Manager أو لوحة Traefik. إذا كنت تحتاج ميزات على مستوى التطبيق مثل التخزين المؤقت أو جدار حماية تطبيقات ويب كميزات أساسية جاهزة، فحل مبني حول هذه الميزات مثل NGINX مع وحدات إضافية قد يناسبك أكثر مباشرة.
هل تحتاج مساعدة احترافية؟
توفر PrismaTechWork خدمات بنية تحتية شاملة — من النشر الأولي وتصليب الأمان إلى المراقبة المستمرة والنسخ الاحتياطي التلقائي والدعم المخصص. سواء كنت تحتاج إعداد سيرفر واحد أو شبكة متعددة المواقع، يضمن فريقنا بناء بنيتك التحتية بشكل صحيح وتأمينها بالشكل المناسب وصيانتها باستمرار.
- التثبيت وتجهيز السيرفر
- الإعداد المتقدم وإعداد التوجيه
- تصليب الأمان وتحسين جدار الحماية
- إعداد شهادات SSL/TLS مع Let's Encrypt
- ربط النطاق المخصص والوكيل العكسي
- جدولة النسخ الاحتياطي التلقائي والتعافي من الكوارث
- المراقبة الفورية وتنبيهات الجاهزية
- الترحيل من المنصات القائمة
- استكشاف مشكلات الاتصال والأداء وإصلاحها
- سكريبتات أتمتة مخصصة وعقود دعم مستمر
الأسئلة الشائعة
هل HAProxy مجاني ومفتوح المصدر؟
نعم. HAProxy مجاني ومفتوح المصدر برخصة GPLv2، ويشغّل جزءاً كبيراً من بنية موازنة الأحمال على الإنترنت. تبيع أيضاً شركة HAProxy Technologies نسخة HAProxy Enterprise المدعومة تجارياً بوحدات إضافية ودعم فني، لكن النسخة مفتوحة المصدر المستخدمة في هذا الدليل كاملة الميزات وجاهزة للإنتاج بحد ذاتها.
ما المنفذ الافتراضي للوحة إحصائيات HAProxy؟
هذا النشر يكشف لوحة الإحصائيات على المنفذ 8404 عند المسار /stats. تعرض صحة الخوادم الخلفية الفورية وعدد الاتصالات وإحصائيات حركة المرور. قيّد الوصول لهذه اللوحة دائماً بمصادقة أو قاعدة جدار ناري لأنها تكشف تفاصيل البنية التحتية الداخلية.
هل يمكن لـ HAProxy موازنة حركة مرور غير HTTP؟
نعم. يعمل HAProxy على المستوى الرابع (TCP) والسابع (HTTP) معاً، لذا يمكنه موازنة قواعد البيانات وخوادم البريد وخوادم الألعاب أو أي خدمة تعتمد على TCP بالإضافة لحركة الويب المعتادة.
كيف أضيف خادماً خلفياً جديداً لـ HAProxy؟
أضف سطر server جديداً داخل قسم backend المعني في haproxy.cfg مع عنوان IP والمنفذ الخاصين به، ثم تحقق من صحة الإعدادات بأمر haproxy -c -f haproxy.cfg وأعد تحميل الخدمة. سيبدأ HAProxy تلقائياً بفحص صحة الخادم الجديد وتوجيه حركة المرور إليه بمجرد اجتيازه للفحوصات.
ماذا يحدث إذا تعطّل أحد الخوادم الخلفية؟
تكتشف فحوصات صحة HAProxy التعطل خلال فاصل الفحص المضبوط وتستبعد الخادم تلقائياً من التدوير النشط، وتوجّه حركة المرور فقط للخوادم السليمة. بمجرد اجتياز الخادم لفحوصات الصحة مجدداً، يُعيده HAProxy تلقائياً للتدوير دون أي تدخل يدوي.
