Qué hace RabbitMQ
RabbitMQ es un broker de mensajes libre (licencia MPL-2.0) escrito en Erlang. Las aplicaciones le envían mensajes por el protocolo AMQP; él los ordena en colas, los guarda en disco si se le pide y los entrega a los consumidores, que los confirman una vez procesados. Un mensaje no confirmado —porque el worker falló— se entrega a otro. Entre la aplicación y las colas, los exchanges enrutan cada mensaje hacia una cola, varias o todas las que estén suscritas.
Lo que le aporta RabbitMQ
- Páginas que responden rápido — las tareas lentas van a una cola en lugar de bloquear la petición.
- Ninguna tarea perdida — colas duraderas y confirmaciones: un worker que cae no hace desaparecer nada.
- Picos absorbidos — los mensajes esperan en la cola mientras los workers recuperan el retraso.
- Servicios desacoplados — un evento publicado una vez, recibido por cada servicio que lo necesita.
- Una consola web — colas, caudales, consumidores y mensajes pendientes de un vistazo.
- Todos los lenguajes — PHP, Python, Java, Node.js, .NET, Go y Ruby tienen su cliente AMQP.
Redis, RabbitMQ o Kafka para sus mensajes
Desplace la tabla
| Redis (lista o stream) | RabbitMQ | Kafka | |
|---|---|---|---|
| Uso típico | Caché, cola de tareas pequeña | Colas de tareas y enrutamiento de eventos | Registro de eventos de gran volumen |
| Confirmación y reenvío | A cargo de la aplicación | Nativos | Por desplazamiento de lectura |
| Enrutamiento | Sencillo | Exchanges direct, topic, fanout, headers | Por topic y partición |
| Consola de administración | Ninguna de serie | Incluida (plugin management) | Herramientas de terceros |
| Memoria en reposo | Unos pocos MB | Unos 150 MB | A menudo más de 1 GB |
Preparar el servidor
Un VPS Ubuntu 24.04 con 2 GB de RAM sirve para la mayoría de los proyectos: RabbitMQ ocupa unos 150 MB en reposo y suele compartir la máquina con la aplicación y sus workers. Instale Docker y el plugin Compose, y prevea un subdominio, por ejemplo rabbitmq.example.com, que apunte al VPS: la consola de administración debe servirse en HTTPS, ya que por ella pasan las contraseñas. El puerto AMQP nunca se publicará en Internet.
Instalar RabbitMQ con Docker Compose
Preparar la carpeta y el archivo .env
Un único secreto: la contraseña de la cuenta
admin, creada en el primer arranque.mkdir -p /opt/rabbitmq && cd /opt/rabbitmq cat > .env <<EOF RABBITMQ_PASSWORD=$(openssl rand -hex 16) EOF chmod 600 .envEscribir el archivo docker-compose.yml
Un solo servicio, la imagen oficial con la consola de administración. Los dos puertos solo se publican en el loopback: la consola (15672) pasará por nginx, y AMQP (5672) queda reservado al VPS. El
hostnamefijo importa: RabbitMQ guarda sus datos bajo el nombre de su nodo, y un contenedor recreado con otro nombre arrancaría con una base vacía.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: {}Arrancar y comprobar
RabbitMQ responde en unos quince segundos. La API de la consola debe devolver
200con la cuentaadmin, y401sin ella.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/overviewComprobar la cuenta y el nodo
Solo debe aparecer
admin: en cuanto se defineRABBITMQ_DEFAULT_USER, la cuentaguestde fábrica no se crea.docker compose exec rabbitmq rabbitmqctl list_users docker compose exec rabbitmq rabbitmq-diagnostics status | head -n 20
Mantenga AMQP privado y un usuario por aplicación
No publique nunca el puerto 5672 en 0.0.0.0: sus aplicaciones lo alcanzan por el loopback o por la red Docker, y un broker expuesto atrae intentos de conexión. Y no dé nunca la cuenta admin a una aplicación: cree su vhost y su usuario (sección siguiente), para que una fuga quede confinada a su espacio.
Publicar la consola en HTTPS detrás de nginx
Obtenga un certificado con certbot (certbot certonly --nginx -d rabbitmq.example.com) y declare un server block que reenvíe al puerto local 15672. La consola y su API comparten la misma dirección.
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;
}
}Crear un vhost y un usuario por aplicación
Un virtual host es un espacio estanco: sus colas, exchanges y permisos no ven nada de los demás. Cree uno por aplicación, con un usuario que solo tenga permisos sobre él. Lo mismo puede hacerse en la pestaña Admin de la consola.
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 shopConectar Laravel, Django o Node.js
Una aplicación instalada directamente en el VPS se conecta a 127.0.0.1:5672. En Laravel, el paquete laravel-queue-rabbitmq añade un driver de cola; php artisan queue:work rabbitmq lanza después los workers.
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=shopCelery, con Django o por separado, recibe una URL AMQP. Una aplicación que se ejecuta en un contenedor se une a la red rabbitmq y apunta al nombre del servicio en lugar de 127.0.0.1. Node.js (amqplib), Spring AMQP o .NET aceptan la misma URL.
# 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/shopVigilar las colas
Una cola que crece sin bajar indica workers demasiado lentos o detenidos. La consola lo muestra en la pestaña Queues; en la línea de comandos, la misma lectura cabe en una línea: mensajes listos, mensajes en proceso y número de consumidores por cola.
docker compose exec rabbitmq rabbitmqctl list_queues name messages_ready messages_unacknowledged consumersPara un seguimiento a largo plazo, el plugin rabbitmq_prometheus ya viene activo en la imagen oficial: sirve sus métricas en el puerto 15692 del contenedor. Publíquelo como 127.0.0.1:15692:15692 y añádalo a los objetivos de Prometheus para seguir las colas en Grafana.
Copia de seguridad y actualización
Todo el estado de RabbitMQ está en el volumen rabbitmq-data. Exporte también sus definiciones —usuarios, vhosts, colas, exchanges y permisos— a un archivo JSON: es lo que permite reconstruir un broker en segundos, con 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).jsonAntes de cambiar de serie, active los feature flags de la versión en uso, lea las notas de la versión, y después cambie la etiqueta de la imagen y reinicie:
docker compose exec rabbitmq rabbitmqctl enable_feature_flag all
docker compose pull && docker compose up -dRabbitMQ en un clic en ServOrbit
El Marketplace de ServOrbit instala exactamente esta pila: la imagen oficial rabbitmq con su consola, una cuenta admin creada con una contraseña generada, la consola publicada en HTTPS en un subdominio de su dominio o en el subdominio gratuito del VPS, y el puerto AMQP mantenido en el loopback. La contraseña aparece en su área de cliente; solo queda crear sus vhosts y conectar sus workers.
servorbit.com/ma-es/blog/autoalojar-rabbitmq-vps-broker-mensajes
