ما الذي يفعله RabbitMQ
RabbitMQ وسيط رسائل مفتوح المصدر (رخصة MPL-2.0) مكتوب بلغة Erlang. ترسل إليه التطبيقات رسائل عبر بروتوكول AMQP، فيرتّبها في طوابير، ويحفظها على القرص عند الطلب، ويسلّمها إلى المستهلكين الذين يؤكدون استلامها بعد معالجتها. الرسالة التي لم يُؤكَّد استلامها — لأن العامل تعطل — تُعاد إلى عامل آخر. وبين التطبيق والطوابير، توجّه المبادلات كل رسالة إلى طابور واحد أو عدة طوابير أو إلى كل الطوابير المشتركة فيها.
ما يقدّمه لك RabbitMQ
- صفحات تستجيب بسرعة — تذهب المهام البطيئة إلى طابور بدل أن تعطّل الطلب.
- لا مهام ضائعة — طوابير دائمة وتأكيدات استلام: تعطل العامل لا يُضيع شيئاً.
- امتصاص الذروات — تنتظر الرسائل في الطابور بينما يلحق العمّال بالتأخير.
- خدمات منفصلة — حدث يُنشر مرة واحدة ويستلمه كل من يحتاجه.
- لوحة على الويب — الطوابير والمعدلات والمستهلكون والرسائل المنتظرة بنظرة واحدة.
- كل اللغات — لـ PHP وPython وJava وNode.js و.NET وGo وRuby عملاء AMQP.
Redis أم RabbitMQ أم Kafka لرسائلك
مرّر الجدول أفقيًا
| Redis (قائمة أو stream) | RabbitMQ | Kafka | |
|---|---|---|---|
| الاستخدام المعتاد | ذاكرة مؤقتة، طابور مهام صغير | طوابير المهام وتوجيه الأحداث | سجل أحداث بأحجام ضخمة |
| تأكيد الاستلام وإعادة الإرسال | يُدار داخل التطبيق | مدمجان | عبر إزاحة القراءة |
| التوجيه | بسيط | مبادلات direct وtopic وfanout وheaders | حسب الموضوع والقسم |
| لوحة الإدارة | لا شيء افتراضياً | مضمّنة (إضافة management) | أدوات خارجية |
| الذاكرة في وضع الخمول | بضعة ميغابايت | نحو 150 ميغابايت | غالباً أكثر من 1 غيغابايت |
تجهيز الخادم
يناسب خادم VPS بنظام Ubuntu 24.04 وذاكرة 2 غيغابايت معظم المشاريع: يستهلك RabbitMQ نحو 150 ميغابايت في وضع الخمول، وغالباً ما يتقاسم الخادم مع التطبيق وعمّاله. ثبّت Docker وإضافة Compose، وجهّز نطاقاً فرعياً، مثلاً rabbitmq.example.com، يشير إلى الخادم: يجب تقديم لوحة الإدارة عبر HTTPS لأن كلمات المرور تمر عبرها. أما منفذ AMQP فلن يُنشر على الإنترنت أبداً.
تثبيت RabbitMQ باستخدام Docker Compose
تجهيز المجلد وملف .env
سر واحد فقط: كلمة مرور الحساب
admin، الذي يُنشأ عند التشغيل الأول.mkdir -p /opt/rabbitmq && cd /opt/rabbitmq cat > .env <<EOF RABBITMQ_PASSWORD=$(openssl rand -hex 16) EOF chmod 600 .envكتابة ملف docker-compose.yml
خدمة واحدة، هي الصورة الرسمية مع لوحة الإدارة. لا يُنشر المنفذان إلا على الحلقة المحلية: تمر اللوحة (15672) عبر nginx، ويبقى AMQP (5672) محجوزاً للخادم. الـ
hostnameالثابت مهم: يحفظ RabbitMQ بياناته باسم عقدته، والحاوية التي يُعاد إنشاؤها باسم آخر تبدأ بقاعدة فارغة.services: rabbitmq: image: rabbitmq:4.4-management-alpine hostname: rabbitmq restart: unless-stopped ports: - "127.0.0.1:15672:15672" - "127.0.0.1:5672:5672" environment: RABBITMQ_DEFAULT_USER: admin RABBITMQ_DEFAULT_PASS: ${RABBITMQ_PASSWORD} volumes: - rabbitmq-data:/var/lib/rabbitmq networks: - rabbitmq healthcheck: test: ["CMD", "rabbitmq-diagnostics", "-q", "check_port_connectivity"] interval: 30s timeout: 10s retries: 5 networks: rabbitmq: name: rabbitmq volumes: rabbitmq-data: {}التشغيل والتحقق
يستجيب RabbitMQ في نحو خمس عشرة ثانية. يجب أن تعيد واجهة اللوحة
200مع الحسابadmin، و401من دونه.docker compose up -d docker compose ps curl -s -o /dev/null -w '%{http_code}\n' -u admin:"$(grep RABBITMQ_PASSWORD .env | cut -d= -f2)" \ http://127.0.0.1:15672/api/overviewالتحقق من الحساب والعقدة
يجب ألا يظهر إلا
admin: فبمجرد ضبطRABBITMQ_DEFAULT_USERلا يُنشأ حسابguestالافتراضي.docker compose exec rabbitmq rabbitmqctl list_users docker compose exec rabbitmq rabbitmq-diagnostics status | head -n 20
أبقِ AMQP خاصاً ومستخدماً واحداً لكل تطبيق
لا تنشر المنفذ 5672 على 0.0.0.0 أبداً: تصل إليه تطبيقاتك عبر الحلقة المحلية أو شبكة Docker، والوسيط المكشوف يجذب محاولات الدخول. ولا تعطِ الحساب admin لأي تطبيق: أنشئ له vhost ومستخدماً خاصين به (القسم التالي)، كي يبقى أي تسريب محصوراً في مساحته.
نشر اللوحة عبر HTTPS خلف nginx
احصل على شهادة باستخدام certbot (certbot certonly --nginx -d rabbitmq.example.com)، ثم عرّف server block يحوّل إلى المنفذ المحلي 15672. تمر اللوحة وواجهتها البرمجية عبر العنوان نفسه.
server {
listen 443 ssl;
server_name rabbitmq.example.com;
ssl_certificate /etc/letsencrypt/live/rabbitmq.example.com/fullchain.pem;
ssl_certificate_key /etc/letsencrypt/live/rabbitmq.example.com/privkey.pem;
location / {
proxy_pass http://127.0.0.1:15672;
proxy_set_header Host $host;
proxy_set_header X-Forwarded-Proto https;
}
}إنشاء vhost ومستخدم لكل تطبيق
الـ virtual host مساحة معزولة: طوابيرها ومبادلاتها وصلاحياتها لا ترى شيئاً من غيرها. أنشئ واحداً لكل تطبيق، مع مستخدم لا يملك صلاحيات إلا عليه. ويمكن فعل الشيء نفسه من تبويب Admin في اللوحة.
docker compose exec rabbitmq rabbitmqctl add_vhost shop
docker compose exec rabbitmq rabbitmqctl add_user app-shop '<long-password>'
docker compose exec rabbitmq rabbitmqctl set_permissions -p shop app-shop ".*" ".*" ".*"
docker compose exec rabbitmq rabbitmqctl list_permissions -p shopربط Laravel أو Django أو Node.js
يتصل التطبيق المثبّت مباشرة على الخادم بالعنوان 127.0.0.1:5672. في Laravel، تضيف الحزمة laravel-queue-rabbitmq مشغّل طوابير، ثم يُطلق الأمر php artisan queue:work rabbitmq العمّال.
composer require vladimir-yuldashev/laravel-queue-rabbitmq
# application .env
QUEUE_CONNECTION=rabbitmq
RABBITMQ_HOST=127.0.0.1
RABBITMQ_PORT=5672
RABBITMQ_USER=app-shop
RABBITMQ_PASSWORD=<long-password>
RABBITMQ_VHOST=shopيأخذ Celery، مع Django أو بمفرده، عنوان AMQP. التطبيق الذي يعمل في حاوية ينضم إلى الشبكة rabbitmq ويستهدف اسم الخدمة بدل 127.0.0.1. ويقبل Node.js (amqplib) وSpring AMQP و.NET العنوان نفسه.
# settings.py (Django + Celery)
CELERY_BROKER_URL = "amqp://app-shop:<long-password>@127.0.0.1:5672/shop"
# containerised application: join the RabbitMQ network
docker network connect rabbitmq my-worker
# then amqp://app-shop:<long-password>@rabbitmq:5672/shopمراقبة الطوابير
الطابور الذي يكبر دون أن ينخفض يدل على عمّال بطيئين أو متوقفين. تُظهر اللوحة ذلك في تبويب Queues؛ وفي سطر الأوامر تكفي قراءة واحدة: الرسائل الجاهزة، والرسائل قيد المعالجة، وعدد المستهلكين لكل طابور.
docker compose exec rabbitmq rabbitmqctl list_queues name messages_ready messages_unacknowledged consumersللمتابعة على المدى الطويل، الإضافة rabbitmq_prometheus مفعّلة مسبقاً في الصورة الرسمية: تقدّم مقاييسها على المنفذ 15692 داخل الحاوية. انشرها بالصيغة 127.0.0.1:15692:15692 وأضفها إلى أهداف Prometheus لمتابعة الطوابير في Grafana.
النسخ الاحتياطي والتحديث
تقع حالة RabbitMQ كلها في المجلد rabbitmq-data. صدّر أيضاً تعريفاته — المستخدمون والـ vhosts والطوابير والمبادلات والصلاحيات — في ملف JSON: فهو ما يعيد بناء الوسيط في ثوانٍ باستخدام rabbitmqctl import_definitions.
cd /opt/rabbitmq
docker compose exec rabbitmq rabbitmqctl export_definitions /tmp/definitions.json
docker compose cp rabbitmq:/tmp/definitions.json ./definitions-$(date +%F).jsonقبل الانتقال إلى سلسلة جديدة، فعّل feature flags للإصدار الحالي، واقرأ ملاحظات الإصدار، ثم غيّر وسم الصورة وأعد التشغيل:
docker compose exec rabbitmq rabbitmqctl enable_feature_flag all
docker compose pull && docker compose up -dRabbitMQ بنقرة واحدة على ServOrbit
يثبّت متجر ServOrbit هذه الحزمة بالضبط: الصورة الرسمية rabbitmq مع لوحتها، وحساب admin يُنشأ بكلمة مرور مولّدة، ولوحة منشورة عبر HTTPS على نطاق فرعي من نطاقك أو على النطاق الفرعي المجاني للخادم، ومنفذ AMQP محفوظ على الحلقة المحلية. تظهر كلمة المرور في مساحة العميل، ولا يبقى عليك إلا إنشاء الـ vhosts وربط عمّالك.
servorbit.com/ma-ar/المدونة/استضافة-rabbitmq-على-vps
