Self-hosting

RabbitMQ sur VPS : des files de messages pour vos applications

Une page qui génère une facture, envoie trois e-mails et redimensionne une photo avant de répondre finit toujours par expirer au mauvais moment. La solution classique est de confier ces tâches à une file de messages : l'application dépose le travail, des workers le traitent en arrière-plan, et rien ne se perd si l'un d'eux tombe. RabbitMQ est le courtier de messages libre le plus utilisé pour ça. Ce guide l'installe sur un VPS avec Docker Compose, publie sa console d'administration en HTTPS derrière nginx, garde le port AMQP privé et y branche Laravel, Django ou Node.js.

Déployer sur un VPS Cloud →
7 min de lecture4 étapes

Orbi agent IALe sommaire suit l’article ; les articles liés vous attendent en bas de page.

Sommaire· Ce que fait RabbitMQ1/12
  1. 01Ce que fait RabbitMQ
  2. 02Ce que RabbitMQ vous apporte
  3. 03Redis, RabbitMQ ou Kafka pour vos messages
  4. 04Préparer le serveur
  5. 05Installer RabbitMQ avec Docker Compose
  6. 06Gardez AMQP privé et un utilisateur par application
  7. 07Publier la console en HTTPS derrière nginx
  8. 08Créer un vhost et un utilisateur par application
  9. 09Brancher Laravel, Django ou Node.js
  10. 10Surveiller les files
  11. 11Sauvegarde et mise à jour
  12. 12RabbitMQ en un clic sur ServOrbit

Ce que fait RabbitMQ

RabbitMQ est un courtier de messages libre (licence MPL-2.0), écrit en Erlang. Les applications lui envoient des messages par le protocole AMQP ; il les range dans des files, les garde sur disque si on le lui demande, et les remet aux consommateurs qui les acquittent une fois traités. Un message non acquitté — parce que le worker a planté — est redistribué à un autre. Entre l'application et les files, des échanges routent chaque message vers une file, plusieurs, ou toutes celles qui s'y abonnent.

Ce que RabbitMQ vous apporte

  • Des pages qui répondent vite — les tâches lentes partent en file au lieu de bloquer la requête.
  • Aucune tâche perdue — files durables et acquittements : un worker qui tombe ne fait rien disparaître.
  • Des pics absorbés — les messages attendent dans la file pendant que les workers rattrapent le retard.
  • Des services découplés — un événement publié une fois, reçu par chaque service qui en a besoin.
  • Une console web — files, débits, consommateurs et messages en attente, visibles d'un coup d'œil.
  • Tous les langages — PHP, Python, Java, Node.js, .NET, Go et Ruby ont leur client AMQP.

Redis, RabbitMQ ou Kafka pour vos messages

Faites défiler le tableau

Redis (liste ou stream)RabbitMQKafka
Usage typiqueCache, petite file de tâchesFiles de tâches et routage d'événementsJournal d'événements à très gros volume
Acquittement et redistributionÀ gérer dans l'applicationNatifsPar décalage de lecture
RoutageSimpleÉchanges direct, topic, fanout, headersPar topic et partition
Console d'administrationAucune en standardIncluse (plugin management)Outils tiers
Mémoire au reposQuelques MoEnviron 150 MoSouvent plus de 1 Go

Préparer le serveur

Un VPS Ubuntu 24.04 avec 2 Go de RAM convient à la plupart des projets : RabbitMQ occupe environ 150 Mo au repos, et il partage souvent la machine avec l'application et ses workers. Installez Docker et le plugin Compose, et prévoyez un sous-domaine, par exemple rabbitmq.example.com, pointé vers le VPS : la console d'administration doit être servie en HTTPS, puisque les mots de passe y transitent. Le port AMQP, lui, ne sera jamais publié sur Internet.

Installer RabbitMQ avec Docker Compose

  1. Préparer le dossier et le fichier .env

    Un seul secret : le mot de passe du compte admin, créé au premier démarrage.

    mkdir -p /opt/rabbitmq && cd /opt/rabbitmq
    cat > .env <<EOF
    RABBITMQ_PASSWORD=$(openssl rand -hex 16)
    EOF
    chmod 600 .env
  2. Écrire le fichier docker-compose.yml

    Un seul service, l'image officielle avec la console d'administration. Les deux ports ne sont publiés que sur la boucle locale : la console (15672) passera par nginx, et AMQP (5672) reste réservé au VPS. Le hostname fixe compte : RabbitMQ range ses données sous le nom de son nœud, et un conteneur recréé sous un autre nom repartirait sur une base vide.

    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. Démarrer et vérifier

    RabbitMQ répond en une quinzaine de secondes. L'API de la console doit rendre 200 avec le compte admin, et 401 sans lui.

    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. Contrôler le compte et le nœud

    Seul admin doit apparaître : dès que RABBITMQ_DEFAULT_USER est posé, le compte guest d'usine n'est pas créé.

    docker compose exec rabbitmq rabbitmqctl list_users
    docker compose exec rabbitmq rabbitmq-diagnostics status | head -n 20

Gardez AMQP privé et un utilisateur par application

Ne publiez jamais le port 5672 sur 0.0.0.0 : vos applications le joignent par la boucle locale ou par le réseau Docker, et un courtier exposé attire les tentatives de connexion. Et ne donnez jamais le compte admin à une application : créez-lui son vhost et son utilisateur (section suivante), pour qu'une fuite reste confinée à son espace.

Publier la console en HTTPS derrière nginx

Obtenez un certificat avec certbot (certbot certonly --nginx -d rabbitmq.example.com), puis déclarez un server block qui transmet au port local 15672. La console et son API passent par la même adresse.

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;
    }
}

Créer un vhost et un utilisateur par application

Un virtual host est un espace étanche : ses files, ses échanges et ses droits ne voient rien des autres. Créez-en un par application, avec un utilisateur qui n'a de droits que sur lui. La même chose se fait dans l'onglet Admin de la console.

docker compose exec rabbitmq rabbitmqctl add_vhost boutique
docker compose exec rabbitmq rabbitmqctl add_user app-boutique '<mot-de-passe-long>'
docker compose exec rabbitmq rabbitmqctl set_permissions -p boutique app-boutique ".*" ".*" ".*"
docker compose exec rabbitmq rabbitmqctl list_permissions -p boutique

Brancher Laravel, Django ou Node.js

Une application installée directement sur le VPS se connecte à 127.0.0.1:5672. Pour Laravel, le paquet laravel-queue-rabbitmq ajoute un pilote de file ; php artisan queue:work rabbitmq lance ensuite les workers.

composer require vladimir-yuldashev/laravel-queue-rabbitmq

# .env de l'application
QUEUE_CONNECTION=rabbitmq
RABBITMQ_HOST=127.0.0.1
RABBITMQ_PORT=5672
RABBITMQ_USER=app-boutique
RABBITMQ_PASSWORD=<mot-de-passe-long>
RABBITMQ_VHOST=boutique

Celery, avec Django ou seul, prend une URL AMQP. Une application qui tourne dans un conteneur rejoint le réseau rabbitmq et vise le nom du service au lieu de 127.0.0.1. Node.js (amqplib), Spring AMQP ou .NET acceptent la même URL.

# settings.py (Django + Celery)
CELERY_BROKER_URL = "amqp://app-boutique:<mot-de-passe-long>@127.0.0.1:5672/boutique"

# application en conteneur : rejoindre le réseau de RabbitMQ
docker network connect rabbitmq mon-worker
# puis amqp://app-boutique:<mot-de-passe-long>@rabbitmq:5672/boutique

Surveiller les files

Une file qui grossit sans redescendre signale des workers trop lents ou arrêtés. La console le montre dans l'onglet Queues ; en ligne de commande, la même lecture tient en une ligne : messages prêts, messages en cours de traitement et nombre de consommateurs par file.

docker compose exec rabbitmq rabbitmqctl list_queues name messages_ready messages_unacknowledged consumers

Pour un suivi dans la durée, le plugin rabbitmq_prometheus est déjà actif dans l'image officielle : il sert ses métriques sur le port 15692 du conteneur. Publiez-le en 127.0.0.1:15692:15692 et ajoutez-le aux cibles de Prometheus pour suivre les files dans Grafana.

Sauvegarde et mise à jour

Tout l'état de RabbitMQ tient dans le volume rabbitmq-data. Exportez aussi ses définitions — utilisateurs, vhosts, files, échanges et droits — dans un fichier JSON : c'est ce qui permet de reconstruire un courtier en quelques secondes, avec 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

Avant de changer de série, activez les feature flags de la version en place, lisez les notes de version, puis changez le tag de l'image et relancez :

docker compose exec rabbitmq rabbitmqctl enable_feature_flag all
docker compose pull && docker compose up -d

RabbitMQ en un clic sur ServOrbit

Le Marketplace ServOrbit installe exactement cette pile : image officielle rabbitmq avec sa console, compte admin créé avec un mot de passe généré, console publiée en HTTPS sur un sous-domaine de votre domaine ou sur le sous-domaine gratuit du VPS, et port AMQP gardé sur la boucle locale. Le mot de passe s'affiche dans votre espace client ; il ne vous reste qu'à créer vos vhosts et à brancher vos workers.

Partager cet articleservorbit.com/ma-fr/blog/self-host-rabbitmq-vps

Des files de messages fiables pour vos applications

Prix HT affichés avec leur renouvellement.