Autoalojamiento

RabbitMQ en un VPS: colas de mensajes para sus aplicaciones

Una página que genera una factura, envía tres correos y redimensiona una foto antes de responder siempre acaba agotando el tiempo en el peor momento. La solución clásica es confiar esas tareas a una cola de mensajes: la aplicación deposita el trabajo, los workers lo procesan en segundo plano y nada se pierde si uno de ellos cae. RabbitMQ es el broker de mensajes libre más usado para ello. Esta guía lo instala en un VPS con Docker Compose, publica su consola de administración en HTTPS detrás de nginx, mantiene privado el puerto AMQP y conecta Laravel, Django o Node.js.

Desplegar en un VPS Cloud →
7 min de lectura4 pasos

Orbi agente IAEl índice sigue al artículo; los artículos relacionados le esperan al final.

Contenido· Qué hace RabbitMQ1/12
  1. 01Qué hace RabbitMQ
  2. 02Lo que le aporta RabbitMQ
  3. 03Redis, RabbitMQ o Kafka para sus mensajes
  4. 04Preparar el servidor
  5. 05Instalar RabbitMQ con Docker Compose
  6. 06Mantenga AMQP privado y un usuario por aplicación
  7. 07Publicar la consola en HTTPS detrás de nginx
  8. 08Crear un vhost y un usuario por aplicación
  9. 09Conectar Laravel, Django o Node.js
  10. 10Vigilar las colas
  11. 11Copia de seguridad y actualización
  12. 12RabbitMQ en un clic en ServOrbit

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)RabbitMQKafka
Uso típicoCaché, cola de tareas pequeñaColas de tareas y enrutamiento de eventosRegistro de eventos de gran volumen
Confirmación y reenvíoA cargo de la aplicaciónNativosPor desplazamiento de lectura
EnrutamientoSencilloExchanges direct, topic, fanout, headersPor topic y partición
Consola de administraciónNinguna de serieIncluida (plugin management)Herramientas de terceros
Memoria en reposoUnos pocos MBUnos 150 MBA 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

  1. 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 .env
  2. Escribir 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 hostname fijo 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: {}
  3. Arrancar y comprobar

    RabbitMQ responde en unos quince segundos. La API de la consola debe devolver 200 con la cuenta admin, y 401 sin 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/overview
  4. Comprobar la cuenta y el nodo

    Solo debe aparecer admin: en cuanto se define RABBITMQ_DEFAULT_USER, la cuenta guest de 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 shop

Conectar 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=shop

Celery, 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/shop

Vigilar 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 consumers

Para 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).json

Antes 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 -d

RabbitMQ 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.

Compartir este artículoservorbit.com/ma-es/blog/autoalojar-rabbitmq-vps-broker-mensajes

Colas de mensajes fiables para sus aplicaciones

Precios sin IVA, mostrados con su precio de renovación.