🐇 تثبيت RabbitMQ — وسيط الرسائل وطوابير المهام مع لوحة الإدارة على Docker

نشر خادم RabbitMQ على Ubuntu باستخدام Docker — وسيط الرسائل مفتوح المصدر الأكثر انتشاراً عالمياً للخدمات المصغرة (Microservices) وطوابير مهام Celery وبروتوكول AMQP مع لوحة تحكم Management UI.

⚠️ راجع أي سكريبت دائمًا قبل تشغيله على سيرفرك، واختبره في بيئة تجريبية أولاً.

📦 الملفات والأكواد المطلوبة

قبل البدء، يرجى التأكد من تحميل الأكواد المطلوبة من مستودعنا على GitHub لتتمكن من تطبيق الخطوات مع الفيديو بسهولة.

سكريبت تثبيت مؤتمت — أمر واحد ينشر RabbitMQ على المنفذ 5672 (AMQP) والمنفذ 15672 (لوحة الإدارة) مع حفظ دائم للطوابير والرسائل.
عرض على GitHub

التثبيت السريع:

wget https://raw.githubusercontent.com/mhmdali94/Docker/refs/heads/main/databases/rabbitmq/rabbitmq-ubuntu.sh
chmod +x rabbitmq-ubuntu.sh
sudo bash rabbitmq-ubuntu.sh

خطوات التنفيذ

1 تحميل السكريبت

wget https://raw.githubusercontent.com/mhmdali94/Docker/refs/heads/main/databases/rabbitmq/rabbitmq-ubuntu.sh

2 منح صلاحية التنفيذ

chmod +x rabbitmq-ubuntu.sh

3 تشغيل المثبت

يقوم السكريبت بتثبيت Docker وتجهيز مجلد التخزين الدائم للبيانات (`./data`) وتشغيل حاوية `rabbitmq:3-management-alpine` مع توجيه المنفذين 5672 و15672.

sudo bash rabbitmq-ubuntu.sh

4 فتح لوحة الإدارة وإعداد الطوابير

افتح متصفحك وانتقل إلى الرابط http://ip-سيرفرك:15672. سجل دخولك ببيانات المشرف لمراقبة الطوابير ونسب تدفق الرسائل وربط تطبيقاتك وخدماتك المصغرة.

http://:15672
# Log in with your RABBITMQ_DEFAULT_USER credentials

المنافذ المستخدمة

المنفذالغرض
5672AMQP (producers / consumers)
15672Management web UI
5671AMQP over TLS (optional)
1883 / 61613MQTT / STOMP (via plugins)

نظرة عامة

يعد RabbitMQ وسيط الرسائل (Message Broker) مفتوح المصدر الأكثر استخداماً واعتماداً في العالم للأنظمة الموزعة. تم بناؤه على بيئة Erlang/OTP القوية لتقديم معالجة رسائل متوازية وفائقة الكفاءة بين الخدمات المصغرة وتطبيقات الخلفية. يعمل الوسيط على المنفذ 5672 (لبروتوكول AMQP 0-9-1) والمنفذ 15672 (للوحة التحكم الرسومية Management Web UI وREST API)، ويوفر توجيه رسائل مرن عبر موجهات Direct وFanout وTopic وHeaders، مع ضمان وصول الرسائل، وطوابير الرسائل الميتة (DLQ)، وتعدد البروتوكولات (MQTT وSTOMP).

لماذا تستخدمه

يؤدي الاعتماد على اتصالات HTTP/REST المباشرة بين الخدمات المصغرة إلى ارتباط وثيق وتعطل متسلسل للخدمات عند زيادة الضغط وارتفاع الطلبات. يفصل RabbitMQ بين منتجي المهام والمستهلكين: حيث ترسل التطبيقات المهام إلى طوابير آمنة فورياً، لتتولى عمال المعالجة في الخلفية (مثل Python Celery أو Node.js أو Go) سحب المهام وإنجازها بالسرعة المناسبة دون فقدان أي طلب.

متى تحتاجه

  • تفصل بين الخدمات المصغرة وتطبيقات الويب وطوابير المهام الخلفية (مثل Celery في بايثون أو Sidekiq أو BullMQ)
  • تحتاج إلى وسيط رسائل مؤسسي يدعم أنماط توجيه معقدة (البث العام Fanout، والمطابقة بالأنماط Topic)
  • تشترط ضمان تسليم الرسائل وتأكيدات المعالجة (Consumer ACKs) وطوابير الرسائل المعطوبة (DLQ)
  • تريد لوحة تحكم ويب على مسار `:15672` لمراقبة أطوال الطوابير، ومعدلات تدفق الرسائل، وتفاصيل المتصلين
  • تحتاج لدعم بروتوكولات متنوعة مثل AMQP وMQTT (لأجهزة إنترنت الأشياء) وSTOMP (لتطبيقات الويب)

من يحتاجه

  • مطورو الواجهات الخلفية (Backend) لبناء معمارية الخدمات المصغرة والتطبيقات المعتمدة على الأحداث
  • مهندسو العمليات (DevOps) لإدارة مجموعات معالجة المهام الخلفية والأنظمة الموزعة المقاومة للأعطال
  • مهندسو البيانات لتوجيه تدفقات التنبيهات والأحداث اللحظية بين خطوط المعالجة المختلفة
  • مطورو إنترنت الأشياء (IoT) لربط آلاف الأجهزة الطرفية عبر إضافة بروتوكول MQTT الخفيف
  • أصحاب السيرفرات المنزلية لتشغيل طوابير المهام المستقلة لأتمتة المنزل وتطبيقات الاستضافة الذاتية

حالات الاستخدام الشائعة

  • تفريغ المهام البطيئة (إنشاء ملفات PDF، إرسال الإيميلات، معالجة الفيديوهات) لعمال Celery عبر طوابير AMQP
  • بث تحديثات الطلبات لخدمات الفوترة والشحن والتنبيهات في نفس الوقت باستخدام موجه Fanout
  • توجيه تنبيهات حساسات IoT إلى خدمات المعالجة الإقليمية بالاعتماد على مطابقة الأنماط (`sensors.eu.#`)
  • معالجة المهام الفاشلة بأمان عبر توجيهها تلقائياً إلى طابور الرسائل الميتة (Dead-Letter Queue)
  • متابعة معدلات دخول وخروج الرسائل في الوقت الفعلي عبر لوحة الإدارة أثناء أوقات الذروة والمبيعات

الميزات الرئيسية

  • بيئة Erlang/OTP فائقة القوة توفر تزامناً هائلاً، ومقاومة استثنائية للأعطال، وسرعة معالجة قصوى
  • توجيه رسائل مرن: موجهات Direct (مباشر)، Fanout (بث واشتراك)، Topic (مطابقة الأنماط)، وHeaders
  • لوحة إدارة ويب متكاملة على المنفذ `:15672` مع رسوم بيانية ومقاييس حية للطوابير والقنوات والمتصلين
  • ضمان تسليم الرسائل: طوابير دائمة، ورسائل محفوظة على القرص، وتأكيدات تسليم المشترين والمستهلكين
  • طوابير الرسائل الميتة (DLX) وخاصية انتهاء صلاحية الرسائل (TTL) لمعالجة الرسائل العالقة تلقائياً
  • نظام إضافات غني: تفعيل بروتوكولات MQTT وSTOMP ومقاييس Prometheus بضغطة زر واحدة
  • مكتبات برمجية لكافة اللغات: Python (Pika/Celery) وNode.js وGo وJava وPHP و.NET
  • نشر منظم عبر Docker مع ربط مجلد `./data` لحفظ قاعدة بيانات Mnesia والرسائل الدائمة على القرص

كيفية الاستخدام بعد التثبيت

  • افتح المتصفح وانتقل إلى الرابط http://ip-سيرفرك:15672 لعرض لوحة تحكم RabbitMQ Management
  • سجل الدخول باسم المستخدم وكلمة المرور المحددة في متغيرات بيئة سكريبت التثبيت
  • انتقل لتبويب 'Queues' وأنشئ طابوراً تجريبياً (مثل `task_queue` مع تحديد نوعه كـ `Durable`)
  • انتقل لتبويب 'Exchanges' وانشر رسالة تجريبية داخل الطابور للتحقق من سلامة التوجيه
  • اربط تطبيقك أو عمال Celery باستخدام رابط الاتصال `amqp://user:password@ip-سيرفرك:5672//`
  • ضع لوحة الإدارة خلف وكيل عكسي مشفر بـ HTTPS (مثل Nginx) للوصول الآمن من أي مكان
  • أعد سكريبت نسخ احتياطي دوري لتعريفات RabbitMQ ومجلد البيانات `./data`

أفضل ممارسات الأمان

  • غيّر بيانات دخول `guest`/`guest` الافتراضية فوراً وأنشئ حساب مشرف مخصص محمي بكلمة مرور قوية
  • أبقِ منفذ بروتوكول AMQP 5672 معزولاً داخل شبكة التطبيقات الخاصة ولا تكشفه للإنترنت العام بدون تشفير
  • استخدم تشفير TLS على المنفذ 5671 عند ربط تطبيقات ومستهلكين عبر شبكات غير موثوقة
  • احمِ لوحة الإدارة على المنفذ 15672 بوضعها خلف وكيل عكسي مشفر بـ HTTPS أو شبكة VPN
  • احمِ مجلد البيانات `./data` الذي يحتوي على قاعدة بيانات Mnesia بصلاحيات نظام مناسبة بالسيرفر
  • حدّث صورة الحاوية دورياً للحصول على التحديثات الأمنية وإصلاحات بيئة Erlang

المنافذ وإعدادات جدار الحماية

يستخدم RabbitMQ منفذ TCP 5672 لنقل رسائل بروتوكول AMQP ومنفذ TCP 15672 للوحة الإدارة Management Web UI وREST API. يجب فتح المنفذ 5672 للشبكة المحلية والـ Docker (`ufw allow 5672/tcp`). وللوصول الخارجي، وجه لوحة الإدارة 15672 عبر وكيل عكسي مشفر بـ SSL على المنفذ 443 مع إبقاء منفذ 5672 مغلقاً خارجياً.

النسخ الاحتياطي والصيانة

  • قم بتصدير تعريفات RabbitMQ (المستخدمين، الطوابير، الموجهات، الصلاحيات) من لوحة الإدارة: Overview ← Export Definitions
  • أتمت نسخ التعريفات عبر REST API: `curl -u user:password http://localhost:15672/api/definitions > rabbitmq_definitions.json`
  • انسخ مجلد `./data` احتياطياً، والذي يحتوي على قاعدة بيانات Mnesia والرسائل الدائمة
  • أتمت النسخ الاحتياطي اليومي للمجلدات وارفعه إلى مساحة تخزين سحابية عبر restic أو rsync
  • اختبر الاستعادة باستيراد ملف التعريفات في حاوية جديدة والتأكد من استرجاع الطوابير والربط بنجاح

الأخطاء الشائعة

  • ترك حساب `guest`/`guest` الافتراضي (حيث يحظر RabbitMQ دخول `guest` من عناوين IP البعيدة افتراضياً)
  • إنشاء طوابير غير دائمة (Transient) للمهام الحساسة، مما يسبب مسح كافة الرسائل العالقة عند إعادة تشغيل الحاوية
  • قيام المستهلكين بسحب الرسائل دون إرسال تأكيد الاستلام (ACK)، مما يؤدي لتراكم الرسائل غير المؤكدة واستنزاف الذاكرة
  • عدم ربط مجلد التخزين الدائم `./data`، مما يسبب فقدان تعريفات الطوابير والرسائل عند ترقية الحاوية
  • استخدام RabbitMQ كقاعدة بيانات أرشفة طويلة الأمد (حيث يجب أن تظل الطوابير فارغة أو سريعة التفريغ)

استكشاف الأخطاء وإصلاحها

  • تعذر تسجيل الدخول بحساب `guest` من جهاز آخر — يحظر RabbitMQ حساب `guest` لغير localhost؛ أنشئ حساب مشرف في ملف Compose
  • إطلاق تنبيه الذاكرة (Memory Alarm) وحظر المنتجين — تأكد من عمل المستهلكين أو ارفع حد `vm_memory_high_watermark`
  • رفض اتصال AMQP على المنفذ 5672 — تأكد من تشغيل الحاوية وفتح المنفذ 5672 في جدار الحماية
  • لوحة الإدارة لا تفتح على 15672 — تأكد من استخدام صورة `rabbitmq:3-management-alpine` (حيث تفتقر الصورة الأساسية للوحة)
  • اختفاء الرسائل دون معالجة — راجع منطق إرسال الـ ACK في المستهلك وتأكد من إعدادات طابور الرسائل الميتة (DLQ)

البدائل

منصة Apache Kafka لمعالجة تدفقات الأحداث الضخمة الموزعة. منصة Redis (عبر Pub/Sub أو Redis Streams) للمهام الخفيفة في الذاكرة. منصة NATS وسيط رسائل فائق الخفة والسرعة للبيئات السحابية. منصة ActiveMQ وسيط رسائل جافا الكلاسيكي. خدمات AWS SQS / SNS السحابية التجارية.

متى لا تستخدمه

تجنب استخدام RabbitMQ إذا كنت تحتاج إلى إعادة تشغيل وقراءة تدفق الأحداث التاريخية لعدة أشهر سابقة والاحتفاظ بسجلات بحجم مئات الجيجابايت (حيث تم تصميم Apache Kafka لأرشفة وبث سجلات الأحداث). وإذا كنت تستخدم Redis بالفعل في تطبيق ويب بسيط وتحتاج فقط لطابور مهام FIFO بسيط، فإن Redis مع مكتبات Celery أو BullMQ أسهل وأبسط.

هل تحتاج مساعدة احترافية؟

توفر PrismaTechWork خدمات بنية تحتية شاملة — من النشر الأولي وتصليب الأمان إلى المراقبة المستمرة والنسخ الاحتياطي التلقائي والدعم المخصص. سواء كنت تحتاج إعداد سيرفر واحد أو شبكة متعددة المواقع، يضمن فريقنا بناء بنيتك التحتية بشكل صحيح وتأمينها بالشكل المناسب وصيانتها باستمرار.

  • التثبيت وتجهيز السيرفر
  • الإعداد المتقدم وإعداد التوجيه
  • تصليب الأمان وتحسين جدار الحماية
  • إعداد شهادات SSL/TLS مع Let's Encrypt
  • ربط النطاق المخصص والوكيل العكسي
  • جدولة النسخ الاحتياطي التلقائي والتعافي من الكوارث
  • المراقبة الفورية وتنبيهات الجاهزية
  • الترحيل من المنصات القائمة
  • استكشاف مشكلات الاتصال والأداء وإصلاحها
  • سكريبتات أتمتة مخصصة وعقود دعم مستمر
تواصل مع PrismaTechWork

الأسئلة الشائعة

ما الفرق بين RabbitMQ وApache Kafka؟

يعد RabbitMQ وسيط رسائل كلاسيكي مخصص للتوجيه المعقد وطوابير المهام التي تُحذف رسائلها فور استهلاكها وتأكيدها. بينما يعد Kafka سجل تدفق أحداث موزعاً مخصصاً لخطوط البيانات العملاقة والاحتفاظ بالأحداث التاريخية وإعادة تشغيلها.

لماذا لا يمكنني تسجيل الدخول بحساب 'guest' من حاسوب آخر؟

يفرض RabbitMQ إجراءً أمنياً يقصر حساب `guest`/`guest` الافتراضي على الاتصال المحلي (localhost) فقط. ويجب تحديد بيانات مشرف مخصصة (`RABBITMQ_DEFAULT_USER` و`RABBITMQ_DEFAULT_PASS`) في ملف Compose لتسجيل الدخول عن بعد.

ما هي الموجهات (Exchanges) في RabbitMQ؟

الموجهات هي وكلاء توجيه الرسائل داخل RabbitMQ. يرسل المنتج الرسالة إلى الموجه، والذي يستخدم مفاتيح التوجيه وقواعد الربط لتوزيع نسخ من الرسالة إلى طابور أو عدة طوابير مرتبطة (Direct أو Fanout أو Topic أو Headers).

هل يحفظ RabbitMQ الرسائل عند إعادة تشغيل الحاوية؟

نعم! عند إنشاء الطوابير كطوابير دائمة (`durable: true`) وإرسال الرسائل بوضع الحفظ الدائم (Persistent Delivery Mode)، يكتبها RabbitMQ داخل مجلد `./data` بالسيرفر، مما يمنع ضياع الرسائل عند إعادة التشغيل.

كم يستهلك RabbitMQ من الذاكرة العشوائية (RAM)؟

يستهلك RabbitMQ على نسخة Alpine حوالي 100 إلى 200 ميجابايت فقط من الذاكرة العشوائية في وضع الاستعداد، ويقوم بإدارة حدود الذاكرة بذكاء لمنع استنزاف السيرفر.