Tutoriales de VPS
RabbitMQ en VPS: TLS, permisos mínimos y recuperación de mensajes
Instale RabbitMQ con Compose, AMQPS privado y Caddy HTTPS. Corrija permisos de certificados, valide hostnames, configure usuarios y entrega fiable, y recupere definitions y mensajes mediante copias adecuadas.

Incluir pagos, pedidos, correo o tareas de IA en una sola petición HTTP hace que el servicio dependa de todos sus componentes. RabbitMQ separa productores y consumidores: la aplicación publica mensajes y los workers los procesan a su ritmo, con confirmaciones, reintentos y colas de mensajes fallidos.
La guía utiliza Ubuntu 24.04, Docker Compose y Caddy. El ejemplo, revisado el 15 de septiembre de 2026, fijaba RabbitMQ 4.3.5. La versión oficial más reciente consultada el 16 de noviembre es 4.4.0. El Compose 4.3.5 se conserva como ejemplo específico; para una instalación nueva, revise la versión actual y fije su imagen management. En una instalación existente, siga la ruta admitida de actualización.
RabbitMQ es un broker, no una base de datos ni un panel de programación:
- Las peticiones publican; los workers procesan correo, imágenes e informes.
- Exchanges y colas separan pedidos, inventario y pagos.
- Acknowledgments, publisher confirms y dead-letter exchanges controlan fallos.
- Varios consumidores compiten por el trabajo de una cola y permiten escalar.
- Admite clientes AMQP 0-9-1, AMQP 1.0, MQTT, STOMP o Stream con los plugins correspondientes.
- UI, API HTTP y Prometheus muestran conexiones, acumulación, rendimiento y alarmas.
Para ejecutar un script cada minuto, cron o systemd timer son más sencillos. Para eventos conservados y reproducción de logs, considere Kafka. RabbitMQ resulta útil para tareas empresariales, enrutamiento flexible y confirmación desde la aplicación.
| Arquitectura | Ventaja | Límite | Uso |
|---|---|---|---|
| Un nodo | Instalación y diagnóstico sencillos, menor coste | El fallo de VPS o disco interrumpe el servicio | Desarrollo y tareas con recuperación tolerable |
| Varios contenedores en la misma VPS | Permite probar la configuración | Comparte host, disco y red | Laboratorio, sin HA real |
| Tres nodos independientes con quorum queues | Tolera un miembro caído si mantiene mayoría | Más coste y mantenimiento | Servicios críticos |
Use conjuntos impares para replicación por quorum, normalmente 3 o 5. Dos miembros no ofrecen tolerancia útil a un fallo individual manteniendo mayoría. Compruebe los miembros de cada cola: disponer de tres brokers no garantiza tres réplicas en todas las colas.
Aquí se prepara un nodo recuperable con nombre estable. Para infraestructura crítica, utilice dominios de fallo independientes en lugar de añadir contenedores al mismo host.
La capacidad depende de conexiones, canales, colas, tamaño de mensajes, duración de acumulación, confirmaciones y latencia de disco.
| Carga | VPS orientativa | Condición |
|---|---|---|
| Desarrollo | 2 vCPU, 2GB RAM, 30GB SSD | Sin acumulación importante; admite parada |
| Producción pequeña, mensajes cortos | 2–4 vCPU, 4GB RAM, 60GB NVMe | Margen para broker, caché y supervisión |
| Muchas conexiones o acumulación prolongada | 4 vCPU, al menos 8GB RAM, NVMe dedicado | Medir tamaño, latencia de confirms y disco |
| Puerto | Función | Exposición |
|---|---|---|
5671/TCP | AMQP TLS | Loopback; IP privada para clientes remotos |
5672/TCP | AMQP sin cifrar | Desactivado |
15672/TCP | Administración UI/API | 127.0.0.1 detrás de Caddy |
15692/TCP | Prometheus | 127.0.0.1 |
4369/TCP | epmd | Sin publicar |
25672/TCP | Comunicación entre nodos | Sin publicar aquí; red privada en clúster |
No publique 5672, 15672, 4369 ni 25672 en Internet. Docker puede eludir ciertas reglas del cortafuegos del host. Para AMQP remoto, combine binding privado, reglas de origen del proveedor y TLS; consulte protección de bases de datos y middleware.
Instale antes Docker Engine y Compose v2 mediante las instrucciones oficiales para Ubuntu. Este bloque instala Caddy y herramientas, y comprueba Docker:
sudo apt update
sudo apt full-upgrade -y
sudo apt install -y ca-certificates curl openssl caddy
docker --version
docker compose version
sudo systemctl enable --now caddy
Planifique paquetes, reinicios, límites de logs, salud y recuperación con la lista de Compose para producción.
sudo install -d -m 0750 -o "$USER" -g "$USER" /opt/rabbitmq
cd /opt/rabbitmq
install -d -m 0750 data tls
install -d -m 0700 pki backups
umask 077
Cree .env. Mantenga AMQPS en loopback; para clientes remotos use una interfaz WireGuard o privada:
{
printf 'RABBITMQ_ADMIN_USER=opsadmin\n'
printf 'RABBITMQ_ADMIN_PASS=%s\n' "$(openssl rand -hex 32)"
printf 'RABBITMQ_DEFAULT_VHOST=production\n'
printf 'RABBITMQ_BIND_IP=127.0.0.1\n'
} > .env
chmod 600 .env
Sobrescribe el archivo de entorno, por lo que es solo para una instancia nueva. No envíe .env ni cadenas de conexión a Git, logs o incidencias. Los valores del usuario predeterminado solo inicializan un directorio vacío; cambiar .env después no rota contraseñas existentes.
Genere una CA interna y un certificado para mq.example.com:
cd /opt/rabbitmq/pki
openssl genrsa -out ca.key 4096
openssl req -x509 -new -sha256 -days 3650 \
-key ca.key \
-subj '/CN=RabbitMQ Internal CA' \
-out ca.crt
openssl genrsa -out server.key 4096
openssl req -new -sha256 \
-key server.key \
-subj '/CN=mq.example.com' \
-out server.csr
printf '%s\n' \
'subjectAltName=DNS:mq.example.com' \
'extendedKeyUsage=serverAuth' > server.ext
openssl x509 -req -sha256 -days 825 \
-in server.csr \
-CA ca.crt \
-CAkey ca.key \
-CAcreateserial \
-extfile server.ext \
-out server.crt
install -m 0644 ca.crt server.crt /opt/rabbitmq/tls/
install -m 0600 server.key /opt/rabbitmq/tls/
Guarde ca.key fuera de línea o cifrada, sin montarla en el broker ni distribuirla a clientes. Estos confían en ca.crt. Cambie el hostname de ejemplo tanto en subject como en SAN. Puede usar una CA empresarial, siempre con SAN coincidente. Controle caducidad y renovación.
Cree /opt/rabbitmq/rabbitmq.conf:
listeners.tcp = none
listeners.ssl.default = 5671
ssl_options.cacertfile = /etc/rabbitmq/tls/ca.crt
ssl_options.certfile = /etc/rabbitmq/tls/server.crt
ssl_options.keyfile = /etc/rabbitmq/tls/server.key
ssl_options.verify = verify_peer
ssl_options.fail_if_no_peer_cert = false
management.tcp.ip = 0.0.0.0
management.tcp.port = 15672
prometheus.tcp.ip = 0.0.0.0
prometheus.tcp.port = 15692
vm_memory_high_watermark.relative = 0.5
disk_free_limit.absolute = 2GB
AMQP sin cifrar queda desactivado y 5671 utiliza TLS. verify_peer verifica el certificado de cliente cuando se presenta; fail_if_no_peer_cert=false permite clientes TLS sin certificado con usuario y contraseña. Para exigir mTLS, emita certificados de cliente y cambie a true después de probar compatibilidad.
El umbral de memoria predeterminado documentado ronda el 60% de la memoria detectada; aquí se fija al 50%. Compruebe qué memoria detecta el contenedor. Su límite de 2GB es distinto de la RAM de la VPS, y la alarma no es un límite duro. Ajuste disk_free_limit según disco y acumulación; 2GB libres son solo un punto inicial.
Cree /opt/rabbitmq/enabled_plugins para administración y Prometheus:
[rabbitmq_management,rabbitmq_prometheus].
Cree /opt/rabbitmq/compose.yml:
services:
rabbitmq:
image: rabbitmq:4.3.5-management
container_name: rabbitmq
hostname: rabbitmq-1
restart: unless-stopped
environment:
RABBITMQ_DEFAULT_USER: ${RABBITMQ_ADMIN_USER}
RABBITMQ_DEFAULT_PASS: ${RABBITMQ_ADMIN_PASS}
RABBITMQ_DEFAULT_VHOST: ${RABBITMQ_DEFAULT_VHOST}
ports:
- "${RABBITMQ_BIND_IP:-127.0.0.1}:5671:5671"
- "127.0.0.1:15672:15672"
- "127.0.0.1:15692:15692"
volumes:
- ./data:/var/lib/rabbitmq
- ./rabbitmq.conf:/etc/rabbitmq/rabbitmq.conf:ro
- ./enabled_plugins:/etc/rabbitmq/enabled_plugins:ro
- ./tls:/etc/rabbitmq/tls:ro
healthcheck:
test: ["CMD", "rabbitmq-diagnostics", "-q", "ping"]
interval: 30s
timeout: 10s
retries: 5
start_period: 40s
mem_limit: 2g
cpus: 2.0
ulimits:
nofile:
soft: 65536
hard: 65536
logging:
driver: json-file
options:
max-size: "10m"
max-file: "5"
Mantenga hostname: rabbitmq-1: la identidad del nodo importa para restaurar datos, especialmente quorum queues y streams. Evite etiquetas latest.
Para una instalación nueva de la versión 4.4.0 consultada, añada este compose.override.yml tras leer sus notas. No lo aplique sin comprobar una actualización desde 4.3:
services:
rabbitmq:
image: rabbitmq:4.4.0-management
Antes del arranque, dé acceso al usuario RabbitMQ de la imagen seleccionada. La clave privada y la configuración creadas pertenecen al usuario del host y pueden quedar ilegibles cuando el contenedor reduce privilegios:
cd /opt/rabbitmq
RABBITMQ_SELECTED_IMAGE="$(docker compose config --images)"
RABBITMQ_CONTAINER_UID="$(docker run --rm --entrypoint id "$RABBITMQ_SELECTED_IMAGE" -u rabbitmq)"
RABBITMQ_CONTAINER_GID="$(docker run --rm --entrypoint id "$RABBITMQ_SELECTED_IMAGE" -g rabbitmq)"
sudo chown -R "$RABBITMQ_CONTAINER_UID:$RABBITMQ_CONTAINER_GID" data tls
sudo chmod 750 data tls
sudo chmod 600 tls/server.key
sudo chown "root:$RABBITMQ_CONTAINER_GID" rabbitmq.conf enabled_plugins
sudo chmod 640 rabbitmq.conf enabled_plugins
unset RABBITMQ_SELECTED_IMAGE RABBITMQ_CONTAINER_UID RABBITMQ_CONTAINER_GID
El comando de selección supone que el proyecto solo contiene el broker. Mantenga la clave privada de la CA fuera de los montajes. Valide sin imprimir secretos:
cd /opt/rabbitmq
docker compose config --quiet
docker compose pull
docker compose up -d
docker compose ps
cd /opt/rabbitmq
docker compose exec rabbitmq rabbitmq-diagnostics -q ping
docker compose exec rabbitmq rabbitmq-diagnostics -q listeners
docker compose exec rabbitmq rabbitmq-diagnostics -q check_local_alarms
docker compose logs --tail=200 rabbitmq
Compruebe la cadena del certificado:
openssl s_client \
-connect 127.0.0.1:5671 \
-servername mq.example.com \
-CAfile /opt/rabbitmq/tls/ca.crt \
-verify_return_error </dev/null
Debe aparecer Verify return code: 0 (ok). Sin embargo, -servername solo establece SNI; no verifica el hostname. Ejecute también:
openssl s_client -connect 127.0.0.1:5671 -servername mq.example.com \
-verify_hostname mq.example.com -verify_return_error \
-CAfile /opt/rabbitmq/tls/ca.crt </dev/null
Use el hostname real y consulte métricas:
curl -fsS http://127.0.0.1:15692/metrics | head
Vigile disponibilidad, conexiones, mensajes sin confirmar/listos, publicación/consumo y alarmas de memoria/disco. Consulte Prometheus y Grafana.
Use un dominio separado como mq-admin.example.com y edite /etc/caddy/Caddyfile:
mq-admin.example.com {
encode zstd gzip
reverse_proxy 127.0.0.1:15672
header {
Strict-Transport-Security "max-age=31536000; includeSubDomains"
X-Content-Type-Options "nosniff"
Referrer-Policy "strict-origin-when-cross-origin"
}
}
sudo caddy validate --config /etc/caddy/Caddyfile
sudo systemctl reload caddy
curl -fsSI https://mq-admin.example.com/
Caddy cifra la administración, no transmite AMQP. Restrinja el acceso mediante VPN, acceso de confianza cero o IP autorizadas, use contraseñas fuertes y aplique parches. Active HSTS para subdominios solo si todos admiten HTTPS. Consulte la guía de Caddy.
No use el administrador en aplicaciones. Cree usuarios y vhosts separados por entorno o servicio. El siguiente usuario accede a production y a recursos con prefijo app.:
cd /opt/rabbitmq
APP_USER=worker
APP_PASS="$(openssl rand -hex 32)"
docker compose exec rabbitmq rabbitmqctl add_user "$APP_USER" "$APP_PASS"
docker compose exec rabbitmq rabbitmqctl set_permissions \
-p production "$APP_USER" '^app\.' '^app\.' '^app\.'
install -m 0600 /dev/null app-client.env
printf 'RABBITMQ_USER=%s\nRABBITMQ_PASSWORD=%s\n' \
"$APP_USER" "$APP_PASS" > app-client.env
unset APP_USER APP_PASS
Las expresiones corresponden a configure, write y read. Los recursos deben empezar por app.. Ajuste los patrones a las declaraciones reales sin otorgar .*. El exchange predeterminado de nombre vacío no coincide: permita ese caso expresamente solo si hace falta. Las restricciones de routing keys requieren permisos de topic separados.
El usuario de aplicación no necesita etiquetas administrator, monitoring ni management. Use amqps://, CA fiable y secretos en configuración restringida. Codifique caracteres reservados de la URI; contraseñas hexadecimales simplifican ese proceso.
- Marque los mensajes persistent.
- Active publisher confirms y gestione confirmaciones negativas y timeouts.
- Haga ack después de procesar; decida requeue o dead-letter ante fallos.
- Configure prefetch para limitar entregas pendientes por consumidor.
- Defina reintentos, TTL y políticas dead-letter.
- Use claves de idempotencia para evitar cargos o entregas duplicados.
La persistencia y las confirmaciones no eliminan duplicados. Diseñe entrega al menos una vez y consumidores idempotentes; pruebe reconexión y recuperación de acumulación con fallos reales.
Definitions conserva usuarios, vhosts, permisos, políticas y topología, no mensajes pendientes. Expórtelo desde el nodo activo:
cd /opt/rabbitmq
BACKUP_DIR="backups/$(date -u +%Y%m%dT%H%M%SZ)"
install -d -m 0700 "$BACKUP_DIR"
docker compose exec rabbitmq rabbitmqctl export_definitions \
/var/lib/rabbitmq/definitions-backup.json
docker compose cp \
rabbitmq:/var/lib/rabbitmq/definitions-backup.json \
"$BACKUP_DIR/definitions.json"
docker compose exec rabbitmq rm -f \
/var/lib/rabbitmq/definitions-backup.json
test -s "$BACKUP_DIR/definitions.json"
chmod 600 "$BACKUP_DIR/definitions.json"
Contiene hashes de contraseñas y es sensible. En un reemplazo preparado, copie primero el archivo guardado al directorio de trabajo:
docker compose cp definitions.json \
rabbitmq:/var/lib/rabbitmq/definitions-restore.json
docker compose exec rabbitmq rabbitmqctl import_definitions \
/var/lib/rabbitmq/definitions-restore.json
Importar definitions no recupera mensajes y puede fusionar topología existente. Use un destino aislado y borre después el archivo temporal.
Para mensajes, detenga productores y consumidores y pare el nodo antes de copiar todo su directorio:
cd /opt/rabbitmq
FULL_BACKUP="backups/rabbitmq-full-$(date -u +%Y%m%dT%H%M%SZ).tar.gz"
docker compose stop rabbitmq
sudo tar -czf "$FULL_BACKUP" \
data .env compose.yml rabbitmq.conf enabled_plugins tls pki
sudo chown "$USER":"$USER" "$FULL_BACKUP"
chmod 600 "$FULL_BACKUP"
docker compose start rabbitmq
test -s "$FULL_BACKUP"
docker compose exec rabbitmq rabbitmq-diagnostics -q ping
Compruebe el resultado del archivado. Cifre la copia, especialmente porque incluye credenciales y material de CA; controle por separado la copia de su clave privada. Copie los archivos fuera del host.
Restaure una instancia detenida, aislada y compatible, con el mismo rabbit@rabbitmq-1, datos completos incluida la cookie Erlang y permisos correctos. Restaure configuración y certificados, arranque, compruebe topología/acumulación y conecte clientes de prueba. No inicialice, sobrescriba ni renombre un directorio de producción activo como ensayo.
Revise notas, transiciones permitidas, feature flags y compatibilidad Erlang. Prepare definitions y copia completa con nodo detenido. La imagen oficial incluye el runtime, pero siguen aplicándose los requisitos de migración.
cd /opt/rabbitmq
docker compose exec rabbitmq rabbitmqctl await_startup
docker compose exec rabbitmq rabbitmqctl export_definitions \
/var/lib/rabbitmq/pre-upgrade-definitions.json
# 修改 compose.yml 中固定的镜像补丁版本后再执行
docker compose config --quiet
docker compose pull
docker compose up -d
docker compose exec rabbitmq rabbitmqctl await_startup
docker compose exec rabbitmq rabbitmq-diagnostics -q ping
docker compose exec rabbitmq rabbitmq-diagnostics -q check_local_alarms
docker compose logs --tail=200 rabbitmq
El ejemplo deja otra copia de definitions dentro del directorio de datos: sáquela del contenedor si quiere conservarla. Cambie la imagen fijada o el override antes de descargar. Un nodo requiere parada.
En clústeres independientes, siga el orden gradual oficial y compruebe réplicas. Valide confirms, ack, reducción de acumulación, API y métricas, no solo arranque. Tras cambios irreversibles, recupere una copia anterior compatible en lugar de limitarse a bajar la imagen.
ss -lnt | grep ':5671'
docker compose ps
docker compose exec rabbitmq rabbitmq-diagnostics -q listeners
openssl s_client -connect 127.0.0.1:5671 \
-servername mq.example.com \
-CAfile tls/ca.crt </dev/null
Si funciona localmente, revise RABBITMQ_BIND_IP, rutas privadas, reglas del proveedor y publicación Docker con la guía de puertos y cortafuegos. No vuelva a 5672 público sin cifrar.
El nombre DNS debe coincidir con SAN y CA fiable. Corrija DNS privado, SAN, reloj y rutas de CA; no desactive validación.
docker compose exec rabbitmq rabbitmqctl list_users
docker compose exec rabbitmq rabbitmqctl list_vhosts
docker compose exec rabbitmq rabbitmqctl list_permissions -p production
Revise credenciales y las tres categorías de permiso. Codifique el vhost: / suele representarse como %2F; aquí production utiliza /production.
docker compose exec rabbitmq rabbitmq-diagnostics -q check_local_alarms
docker stats rabbitmq --no-stream
df -h /opt/rabbitmq/data
du -sh /opt/rabbitmq/data
Las alarmas bloquean publicación para proteger el nodo. Reduzca acumulación, recupere consumidores, amplíe disco e investigue mensajes grandes antes de subir umbrales.
Desarrollo puede empezar con 2 vCPU/2GB; producción pequeña suele requerir 2–4 vCPU, 4GB y 60GB NVMe. Mida conexiones, mensajes, colas, acumulación y confirms.
Evítelo: desactive AMQP sin cifrar y deje administración en loopback detrás de HTTPS. Los clientes remotos deben utilizar red privada/VPN, TLS 5671 y restricciones de origen.
Conserva la definición de la cola. También se necesitan mensajes persistentes, publisher confirms y ack correctos; los fallos pueden producir entrega incierta o duplicada.
Sí, sin tolerancia a fallo del host. Para tolerar un miembro caído hacen falta al menos tres miembros independientes y mayoría disponible.
No: conserva cuentas y topología. Los mensajes requieren una copia coherente del nodo detenido.
Solo inicializa almacenamiento vacío. Use rabbitmqctl change_password o la API, actualice secretos y verifique reconexión.