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) | RabbitMQ | Kafka | |
|---|---|---|---|
| Usage typique | Cache, petite file de tâches | Files de tâches et routage d'événements | Journal d'événements à très gros volume |
| Acquittement et redistribution | À gérer dans l'application | Natifs | Par décalage de lecture |
| Routage | Simple | Échanges direct, topic, fanout, headers | Par topic et partition |
| Console d'administration | Aucune en standard | Incluse (plugin management) | Outils tiers |
| Mémoire au repos | Quelques Mo | Environ 150 Mo | Souvent 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
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É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
hostnamefixe 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: {}Démarrer et vérifier
RabbitMQ répond en une quinzaine de secondes. L'API de la console doit rendre
200avec le compteadmin, et401sans 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/overviewContrôler le compte et le nœud
Seul
admindoit apparaître : dès queRABBITMQ_DEFAULT_USERest posé, le compteguestd'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 boutiqueBrancher 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=boutiqueCelery, 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/boutiqueSurveiller 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 consumersPour 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).jsonAvant 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 -dRabbitMQ 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.
servorbit.com/ma-fr/blog/self-host-rabbitmq-vps
