الاستضافة الذاتية

RabbitMQ على VPS: طوابير رسائل لتطبيقاتك

الصفحة التي تنشئ فاتورة وترسل ثلاث رسائل بريد وتصغّر صورة قبل أن تجيب تنتهي دائماً بتجاوز المهلة في أسوأ لحظة. الحل المعتاد هو تسليم هذه المهام إلى طابور رسائل: يضع التطبيق العمل، ويعالجه العمّال في الخلفية، ولا يضيع شيء إن تعطل أحدهم. RabbitMQ هو وسيط الرسائل المفتوح المصدر الأكثر استخداماً لهذا الغرض. يثبّته هذا الدليل على خادم VPS باستخدام Docker Compose، وينشر لوحة إدارته عبر HTTPS خلف nginx، ويُبقي منفذ AMQP خاصاً، ويربط به Laravel أو Django أو Node.js.

انشر على VPS Cloud ←
7 دقائق للقراءةعدد الخطوات: 4

Orbi وكيل ذكاء اصطناعيالفهرس يتبع المقال، والمقالات ذات الصلة في أسفل الصفحة.

المحتويات· ما الذي يفعله RabbitMQ1/12
  1. 01ما الذي يفعله RabbitMQ
  2. 02ما يقدّمه لك RabbitMQ
  3. 03Redis أم RabbitMQ أم Kafka لرسائلك
  4. 04تجهيز الخادم
  5. 05تثبيت RabbitMQ باستخدام Docker Compose
  6. 06أبقِ AMQP خاصاً ومستخدماً واحداً لكل تطبيق
  7. 07نشر اللوحة عبر HTTPS خلف nginx
  8. 08إنشاء vhost ومستخدم لكل تطبيق
  9. 09ربط Laravel أو Django أو Node.js
  10. 10مراقبة الطوابير
  11. 11النسخ الاحتياطي والتحديث
  12. 12RabbitMQ بنقرة واحدة على ServOrbit

ما الذي يفعله RabbitMQ

RabbitMQ وسيط رسائل مفتوح المصدر (رخصة MPL-2.0) مكتوب بلغة Erlang. ترسل إليه التطبيقات رسائل عبر بروتوكول AMQP، فيرتّبها في طوابير، ويحفظها على القرص عند الطلب، ويسلّمها إلى المستهلكين الذين يؤكدون استلامها بعد معالجتها. الرسالة التي لم يُؤكَّد استلامها — لأن العامل تعطل — تُعاد إلى عامل آخر. وبين التطبيق والطوابير، توجّه المبادلات كل رسالة إلى طابور واحد أو عدة طوابير أو إلى كل الطوابير المشتركة فيها.

ما يقدّمه لك RabbitMQ

  • صفحات تستجيب بسرعة — تذهب المهام البطيئة إلى طابور بدل أن تعطّل الطلب.
  • لا مهام ضائعة — طوابير دائمة وتأكيدات استلام: تعطل العامل لا يُضيع شيئاً.
  • امتصاص الذروات — تنتظر الرسائل في الطابور بينما يلحق العمّال بالتأخير.
  • خدمات منفصلة — حدث يُنشر مرة واحدة ويستلمه كل من يحتاجه.
  • لوحة على الويب — الطوابير والمعدلات والمستهلكون والرسائل المنتظرة بنظرة واحدة.
  • كل اللغات — لـ PHP وPython وJava وNode.js و‎.NET وGo وRuby عملاء AMQP.

Redis أم RabbitMQ أم Kafka لرسائلك

مرّر الجدول أفقيًا

Redis (قائمة أو stream)RabbitMQKafka
الاستخدام المعتادذاكرة مؤقتة، طابور مهام صغيرطوابير المهام وتوجيه الأحداثسجل أحداث بأحجام ضخمة
تأكيد الاستلام وإعادة الإرساليُدار داخل التطبيقمدمجانعبر إزاحة القراءة
التوجيهبسيطمبادلات direct وtopic وfanout وheadersحسب الموضوع والقسم
لوحة الإدارةلا شيء افتراضياًمضمّنة (إضافة management)أدوات خارجية
الذاكرة في وضع الخمولبضعة ميغابايتنحو 150 ميغابايتغالباً أكثر من 1 غيغابايت

تجهيز الخادم

يناسب خادم VPS بنظام Ubuntu 24.04 وذاكرة 2 غيغابايت معظم المشاريع: يستهلك RabbitMQ نحو 150 ميغابايت في وضع الخمول، وغالباً ما يتقاسم الخادم مع التطبيق وعمّاله. ثبّت Docker وإضافة Compose، وجهّز نطاقاً فرعياً، مثلاً rabbitmq.example.com، يشير إلى الخادم: يجب تقديم لوحة الإدارة عبر HTTPS لأن كلمات المرور تمر عبرها. أما منفذ AMQP فلن يُنشر على الإنترنت أبداً.

تثبيت RabbitMQ باستخدام Docker Compose

  1. تجهيز المجلد وملف ‎.env

    سر واحد فقط: كلمة مرور الحساب admin، الذي يُنشأ عند التشغيل الأول.

    mkdir -p /opt/rabbitmq && cd /opt/rabbitmq
    cat > .env <<EOF
    RABBITMQ_PASSWORD=$(openssl rand -hex 16)
    EOF
    chmod 600 .env
  2. كتابة ملف 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: {}
  3. التشغيل والتحقق

    يستجيب 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
  4. التحقق من الحساب والعقدة

    يجب ألا يظهر إلا 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 -d

RabbitMQ بنقرة واحدة على ServOrbit

يثبّت متجر ServOrbit هذه الحزمة بالضبط: الصورة الرسمية rabbitmq مع لوحتها، وحساب admin يُنشأ بكلمة مرور مولّدة، ولوحة منشورة عبر HTTPS على نطاق فرعي من نطاقك أو على النطاق الفرعي المجاني للخادم، ومنفذ AMQP محفوظ على الحلقة المحلية. تظهر كلمة المرور في مساحة العميل، ولا يبقى عليك إلا إنشاء الـ vhosts وربط عمّالك.

شارك هذا المقالservorbit.com/ma-ar/المدونة/استضافة-rabbitmq-على-vps

طوابير رسائل موثوقة لتطبيقاتك

الأسعار المعروضة قبل الضريبة، مع سعر التجديد.