En esta página
# Cómo diseñar una arquitectura de RabbitMQ en producción para una empresa
Una arquitectura de RabbitMQ en producción para una empresa se apoya en un pequeño conjunto de decisiones que deben tomarse correctamente antes de que la primera carga de trabajo entre en producción: un número impar de nodos repartidos entre zonas de disponibilidad (AZ), colas de quórum (quorum queues) como tipo de cola por defecto, aislamiento con un vhost por dominio y TLS desde el primer día. Esta guía es la referencia básica para un equipo de plataforma que construye su primer clúster de producción, no un manual de escalado ni una calculadora de dimensionamiento.
Dos artículos complementarios cubren lo que este deja fuera de forma deliberada. Para el crecimiento más allá del primer año, consulte diseñar pensando en la escala futura. Para los cálculos de throughput, las fórmulas de número de nodos y los patrones de recuperación ante desastres (DR) entre sedes, consulte HA, recuperación ante desastres y dimensionamiento del clúster. Este artículo da por hecho que esa conversación sobre dimensionamiento ya ha tenido lugar y se centra en la topología, la postura de seguridad y las salvaguardas operativas.
Las decisiones que salen caras de cambiar después
Algunas decisiones de RabbitMQ son fáciles de revertir: un valor de prefetch cambia con una actualización de política y un reinicio progresivo (rolling restart). Otras son estructurales, quedan integradas en el código cliente, los registros DNS y los hábitos de los equipos, de modo que deshacerlas más adelante supone un proyecto de migración y no un simple cambio de configuración. Acierte con ellas antes de que se conecte el primer productor.
- Tipo de cola. Elegir colas de quórum desde el principio evita una migración en caliente más adelante. Las colas clásicas en espejo (classic mirrored queues), el patrón de política
ha-mode, quedaron obsoletas en RabbitMQ 3.x y se eliminaron por completo en la 4.0. Un primer despliegue que siga recurriendo a ellas se construye sobre unos cimientos que ya no existen. Consulte colas clásicas frente a colas de quórum para una comparación más detallada. - Paridad del número de nodos. Un número par de nodos es un error habitual en el primer clúster. Las colas de quórum y la coordinación basada en Raft de RabbitMQ necesitan una mayoría clara para seguir disponibles durante una partición. Los números pares generan empates; los impares, no.
- Organización de vhosts. Volcar las colas de todos los equipos en el vhost por defecto
/es rápido de configurar y doloroso de deshacer. Los permisos, las políticas y los límites de conexión se aplican por vhost, así que un vhost compartido implica que cada equipo hereda el radio de impacto de todos los demás. - Convenciones de nomenclatura. Los nombres de colas y exchanges acaban codificados de forma fija en decenas de servicios. Adoptar un esquema a posteriori obliga a tocar todos los consumidores.
- TLS. Habilitar TLS después de la puesta en producción supone un cutover coordinado de todas las cadenas de conexión a la vez. Habilitarlo desde el primer día cuesta un certificado y un bloque de configuración.
Los tres errores que aparecen en casi todos los primeros despliegues que revisamos: colas clásicas en espejo (eliminadas en 4.x y una mala opción de HA incluso donde siguen funcionando), un número par de nodos (peor comportamiento ante particiones que un número impar) y un único vhost para todo (sin aislamiento, sin un control de acceso real y sin forma de contener a un equipo problemático).
Forma del clúster: nodos, AZ y gestión de particiones de red
La respuesta por defecto para un primer clúster de producción es tres nodos, uno por zona de disponibilidad, número impar y colas de quórum. Es la topología más pequeña que tolera el fallo de un nodo o de una AZ manteniendo disponible una mayoría de quórum (2 de 3) para servir tráfico y elegir líderes. El cálculo completo del número de nodos para un mayor throughput o para DR multisede corresponde a HA, recuperación ante desastres y dimensionamiento del clúster: esta sección expone los valores por defecto, no los cálculos.
Un clúster de dos nodos es peor que uno de un solo nodo, no un término medio más seguro. Si se pierde cualquiera de los dos nodos, el superviviente se queda sin mayoría, de modo que las colas de quórum y las operaciones de todo el clúster se bloquean en lugar de degradarse de forma controlada. Si no puede comprometerse con tres nodos, ejecute uno y planifique su ruta de actualización.
Gestión de particiones de red. Establezca cluster_partition_handling en pause_minority para una distribución de tres nodos, uno por AZ:
cluster_partition_handling = pause_minority
Esto se aplica a la 4.2 y anteriores. RabbitMQ 4.3.0 eliminó las estrategias de gestión de particiones junto con Mnesia; la clave se sigue aceptando pero no tiene efecto, así que omítala en las configuraciones de 4.3 o posteriores.
Con pause_minority, cualquier nodo que quede fuera de la partición mayoritaria se pausa a sí mismo en lugar de servir un estado obsoleto o divergente. En combinación con el consenso Raft propio de las colas de quórum, esto ofrece un comportamiento predecible ante un incidente de red en una AZ: los dos nodos que siguen viéndose continúan sirviendo y el nodo aislado deja de aceptar trabajo hasta que se reincorpora. Evite autoheal en un primer despliegue; prioriza la disponibilidad sobre la consistencia de una forma más difícil de razonar bajo carga.
Coloque un nodo por AZ, no dos en una AZ y uno en otra. Con dos nodos en la misma AZ, el fallo de AZ del que se quería proteger también elimina su mayoría.
Organización de colas y exchanges para una empresa
- Colas de quórum por defecto. Utilice colas de quórum para todo lo que tenga requisitos de durabilidad o disponibilidad, lo que en un contexto empresarial abarca la mayor parte del tráfico de producción: eventos de pedidos, notificaciones de pago, actualizaciones de inventario. Las colas de quórum se replican mediante Raft entre los nodos del clúster y sobreviven a la pérdida de un nodo minoritario sin intervención del operador.
- Cuándo siguen siendo aceptables las colas clásicas. Las colas clásicas siguen siendo razonables para cargas de trabajo efímeras que toleran depender de un solo nodo: colas de respuesta de tipo RPC, telemetría de bajo valor o cualquier caso en el que perder el contenido de la cola ante un fallo de nodo sea una contrapartida aceptable a cambio de una menor sobrecarga. No elija la cola clásica por costumbre; tome la decisión de forma deliberada para cada cola. El árbol de decisión completo está en colas clásicas frente a colas de quórum.
- Streams para replay. Los streams de RabbitMQ (el tipo de cola
x-queue-type: stream) son la herramienta adecuada cuando los consumidores necesitan releer el histórico: event sourcing, pistas de auditoría o grupos de consumidores (consumer groups) que necesitan cada uno su propia posición de lectura. Los streams se comportan más como un log que como una cola y no sustituyen directamente a las colas de quórum. - Un vhost por dominio. Estructure los vhosts en torno a los límites de negocio o de equipo, no por entornos (para aislar entornos, use clústeres independientes, no vhosts). Un dominio de pagos, uno de inventario y uno de notificaciones tienen cada uno su propio vhost, usuarios y políticas: un límite natural del radio de impacto en el que «quién puede publicar en pagos» es una pregunta única y con respuesta clara.
- Convenciones de nomenclatura. Un esquema práctico para un entorno empresarial:
<domain>.<service>.<event-or-purpose>
Ejemplos: payments.invoicing.invoice-created, inventory.warehouse.stock-adjusted. La coherencia importa más que el esquema concreto; elija uno e impóngalo mediante revisión de código o una herramienta de aprovisionamiento antes de que el entorno supere un puñado de equipos.
Políticas en lugar de argumentos por cola. Defina el comportamiento de las colas (TTL, longitud máxima, dead-lettering, replicación) mediante políticas con ámbito de vhost que coincidan por patrón de nombre, no pasando argumentos en cada llamada queue.declare desde el código de la aplicación:
rabbitmqctl set_policy ha-quorum "^payments\." \
'{"queue-type":"quorum","max-length":100000,"overflow":"reject-publish"}' \
--apply-to queues --vhost payments
Las políticas se pueden cambiar de forma centralizada sin volver a desplegar el código de la aplicación, algo que importa la primera vez que necesite añadir dead-lettering en veinte servicios a la vez.
Salvaguardas de recursos
La configuración de recursos por defecto de RabbitMQ es conservadora, pero no viene ajustada para uso empresarial. Defina estos valores de forma explícita.
Watermark de memoria. Controla cuándo RabbitMQ empieza a bloquear a los publicadores para protegerse de un OOM:
vm_memory_high_watermark.relative = 0.6
0,6 (el 60 % de la RAM disponible) es un punto de partida razonable para un nodo dedicado al broker, ya que deja margen para el sistema operativo, la sobrecarga de la VM de Erlang y el estado de las conexiones.
Límite de disco libre. RabbitMQ deja de aceptar publicaciones cuando el disco libre cae por debajo de este umbral, para evitar un broker que no pueda volcar datos a disco:
disk_free_limit.absolute = 5GB
Establézcalo muy por encima del mayor backlog de mensajes en disco que prevea, no solo por encima de cero.
Límites de conexiones y canales. Limite el uso de recursos por vhost y por usuario para que un servicio que se comporte mal no pueda agotar la capacidad de todo el broker:
channel_max = 128
connection_max = 1000
Configúrelos por vhost mediante rabbitmqctl set_vhost_limits cuando necesite un control más estricto que los valores globales por defecto.
- Prefetch. Defina un prefetch de consumidor sensato (
basic.qos) en lugar de dejarlo ilimitado. Un prefetch ilimitado permite que un consumidor lento acumule una parte desproporcionada de mensajes unacked (sin confirmar), dejando sin trabajo a los demás consumidores de la misma cola. Un valor inicial de 10-50 por consumidor, ajustado según el tiempo de procesamiento, funciona para la mayoría de las cargas de trabajo. - Comportamiento lazy en 4.x. En RabbitMQ 3.12 y posteriores, la distinción de las colas lazy se integró en un almacén de mensajes unificado, y las colas clásicas gestionan la memoria de forma predecible sin el antiguo modo
lazy. Las colas de quórum siempre han usado un log de Raft con archivos de segmentos en disco y nunca lo han necesitado. Si arrastra políticasx-queue-mode: lazyde un despliegue anterior, ahora no hacen nada; elimínelas en lugar de dejarlas como configuración muerta.
Base de seguridad
TLS en el 5671. Termine TLS en el broker para el tráfico AMQP en el puerto 5671 (con TLS, frente al 5672 en texto plano) desde el primer día, no como un añadido posterior:
listeners.ssl.default = 5671
ssl_options.cacertfile = /etc/rabbitmq/ca_certificate.pem
ssl_options.certfile = /etc/rabbitmq/server_certificate.pem
ssl_options.keyfile = /etc/rabbitmq/server_key.pem
ssl_options.verify = verify_peer
ssl_options.fail_if_no_peer_cert = true
Desactive por completo el listener en texto plano del 5672 en cualquier nodo accesible desde fuera de un segmento de red de plena confianza.
Desactive guest. En las versiones actuales, el usuario guest está restringido por defecto a localhost, pero no confíe solo en eso. Elimínelo o bloquéelo de forma explícita:
rabbitmqctl delete_user guest
- Usuarios y etiquetas por vhost. Cree usuarios limitados a los vhosts que necesitan, con la etiqueta mínima (
management,monitoring,policymaker,administrator) que exija su función. Evite una cuenta de servicio compartida entre los productores y consumidores de todos los equipos; anula el aislamiento por vhost configurado antes y dificulta la rotación de credenciales y la auditoría. - Exposición de la interfaz de gestión. La API HTTP y la interfaz del plugin de gestión no deben ser accesibles desde Internet. Colóquelas detrás de una VPN, un bastión o un balanceador de carga interno, e imponga también TLS en el listener de gestión (puerto 15671).
- OAuth2/LDAP. RabbitMQ admite OAuth 2.0 (mediante
rabbitmq_auth_backend_oauth2, compatible con Keycloak, Azure AD y otros proveedores OIDC) y LDAP (medianterabbitmq_auth_backend_ldap) como alternativas a la gestión interna de usuarios. Cualquiera de los dos centraliza la autenticación y evita la proliferación de contraseñas cuando ya se aprovisiona acceso a más de un puñado de ingenieros.
Observabilidad
Plugin de Prometheus. Habilite el plugin de Prometheus integrado en lugar de recurrir a un exporter de terceros:
rabbitmq-plugins enable rabbitmq_prometheus
Expone de forma nativa métricas del broker, las colas y los nodos en el puerto 15692 en formato Prometheus, sin ningún agente adicional que ejecutar o mantener.
Seis métricas sobre las que configurar alertas:
- Profundidad de cola (
rabbitmq_queue_messages_ready): si crece sin límite, indica un consumidor que ha dejado de seguir el ritmo. - Utilización de consumidores (
rabbitmq_queue_consumer_utilisation): si cae, indica consumidores inactivos o un consumidor lento que bloquea al resto. - Memoria del nodo (
rabbitmq_process_resident_memory_bytes): si se acerca al watermark, anticipa un bloqueo inminente de los publicadores. - Uso de descriptores de archivo (
rabbitmq_fd_usedfrente arabbitmq_fd_total): si es elevado, hay riesgo de fallos de conexión bajo carga. - Número de mensajes sin confirmar (unacked): si aumenta, los consumidores aceptan trabajo más rápido de lo que lo confirman, antesala de tormentas de reentregas.
- Estado de partición del clúster (
rabbitmq_partitions): si es mayor que cero, el clúster está dividido y requiere atención inmediata.
Envío de logs. Envíe los logs de RabbitMQ (en formato JSON por defecto desde la 3.9) a su plataforma central de logs en lugar de dejarlos en el disco local. Los eventos de partición, los fallos de autenticación y los cambios de políticas aparecen en estos logs antes de manifestarse como una anomalía en las métricas, lo que convierte el envío de logs en su sistema de alerta más temprano para varios de los modos de fallo anteriores.
Para una referencia más amplia, consulte los principales problemas de RabbitMQ y su resolución y, para clústeres alojados en Kubernetes, monitorización de RabbitMQ en Kubernetes.
Estrategia de actualizaciones y parches
Planifique su versión y su ventana de soporte antes de que un incidente le obligue a hacerlo. La comunidad de RabbitMQ solo da soporte a las dos series de versiones más recientes (4.4 y 4.3 a octubre de 2026); cuando sale una nueva versión menor, las anteriores se quedan sin soporte con bastante rapidez. Las licencias comerciales (a través de Broadcom/Tanzu) amplían la cobertura hasta la serie 3.13.x. El soporte propio de AceMQ llega aún más atrás y cubre desde la 3.8.x hasta la serie 4.x actual, algo importante para las empresas con despliegues de larga duración que no pueden actualizar al ritmo de la comunidad.
- Compatibilidad con Erlang. RabbitMQ 4.x requiere una versión de Erlang/OTP igualmente actual (Erlang 26 o 27 para la serie 4.x actual). Ejecutar un runtime de Erlang antiguo con una versión nueva de RabbitMQ, o viceversa, es una fuente habitual de fallos sutiles de arranque y de clustering. Compruebe la matriz de compatibilidad antes de cada actualización de versión mayor.
- Feature flags antes de las actualizaciones de versión mayor. RabbitMQ controla los cambios incompatibles entre versiones mayores mediante feature flags. Antes de actualizar cruzando una versión mayor (de 3.x a 4.x, por ejemplo), confirme que todos los nodos están en la última versión menor de la serie actual y que todos los flags necesarios están habilitados:
rabbitmqctl list_feature_flags
rabbitmqctl enable_feature_flag all
Saltarse este paso y cruzar versiones mayores sin ocuparse de los feature flags es una de las causas más habituales de una actualización del clúster bloqueada o fallida.
Para las opciones de licenciamiento, incluido cómo AceMQ ofrece RabbitMQ comercial por debajo de los mínimos estándar de núcleos de Broadcom, consulte licencias de RabbitMQ (licensing).
Para servicios financieros y cargas de trabajo reguladas
Las empresas de servicios financieros, sanidad u otros sectores regulados tienen requisitos que van más allá de esta base.
- Registro de auditoría. Además de los logs operativos ya mencionados, las cargas de trabajo reguladas suelen necesitar un registro inmutable de las acciones administrativas: creación de usuarios, cambios de permisos, actualizaciones de políticas y modificaciones de vhosts. Captúrelas desde la API de gestión y envíelas a un almacén de escritura única o a un SIEM, en lugar de añadirlas al envío general de logs.
- Criptografía FIPS 140. Cuando una carga de trabajo requiere módulos criptográficos validados FIPS, las compilaciones estándar de RabbitMQ no lo ofrecen de serie. AceMQ distribuye FIPSMQ, una distribución de RabbitMQ construida sobre módulos criptográficos validados FIPS 140, precisamente para este requisito. Consulte FIPSMQ para más detalles.
- Segregación de funciones. Estructure la administración de vhosts y usuarios de modo que ninguna cuenta pueda a la vez aprobar y desplegar un cambio de política que afecte a un flujo financiero. El modelo de usuarios y etiquetas por vhost descrito antes le da el mecanismo; quién tiene cada etiqueta es una decisión que cumplimiento normativo debe compartir con ingeniería de plataforma.
- Evidencia de cambios. Los entornos regulados suelen tener que demostrar exactamente qué cambió en un broker de producción, cuándo y quién lo hizo. Combinar policy-as-code (políticas en control de versiones, aplicadas mediante CI) con el registro de auditoría anterior le proporciona tanto el registro de cambios como la pista de aprobaciones que piden los auditores.
Consulte cumplimiento normativo de RabbitMQ para ver cómo encajan estas piezas y evaluación de arquitectura de middleware para trading financiero para un ejemplo práctico en un entorno de trading.
Lista de comprobación previa a producción
Antes de que se conecte la primera carga de trabajo de producción, confirme:
- El clúster tiene tres nodos (u otro número impar), uno por AZ
cluster_partition_handlingestablecido enpause_minority- El tipo de cada cola (quórum, clásica o stream) es una elección deliberada
- Vhosts estructurados por dominio de negocio, no un único namespace compartido
- Existe una convención de nomenclatura para colas y exchanges documentada e impuesta
- TLS habilitado en el 5671; el 5672 en texto plano desactivado o bloqueado por firewall
- El usuario
guesteliminado o restringido - Cada servicio tiene sus propias credenciales limitadas a su vhost y permisos
- La interfaz de gestión no es accesible desde Internet
vm_memory_high_watermarkydisk_free_limitdefinidos explícitamente- Prefetch de consumidor definido deliberadamente para cada carga de trabajo
- Plugin de Prometheus habilitado y las seis métricas de alertas conectadas a la monitorización
- Logs enviados a un almacén central, no al disco local del broker
- Versiones de RabbitMQ y Erlang confirmadas como compatibles y ventana de soporte documentada
Para patrones de escalado, topologías multiclúster y Federation frente a Shovel en configuraciones multirregión, continúe con diseñar pensando en la escala futura. Para equipos que trabajan en Kubernetes, nuestro trabajo de estabilización de RabbitMQ crítico en Kubernetes cubre los aspectos específicos del operador que esta referencia general no aborda.
Si quiere una segunda opinión sobre esta arquitectura antes de su puesta en producción, AceMQ revisa diseños de RabbitMQ como parte de nuestros proyectos de soporte. Somos el único partner MSP de RabbitMQ designado por Broadcom y su 2025 Tanzu Partner of the Year, con línea directa con el equipo principal (Core Team) de RabbitMQ y más de 160+ clientes empresariales en 26+ países. Visite el hub de RabbitMQ para una visión general o vaya directamente a contacto.
Preguntas frecuentes
¿Qué arquitectura de RabbitMQ ofrece alta disponibilidad?
Un clúster de tres nodos, uno por zona de disponibilidad, con colas de quórum y cluster_partition_handling configurado en pause_minority es la base estándar de alta disponibilidad. En RabbitMQ 4.3 y posteriores esto ya no aplica: la 4.3.0 eliminó Mnesia y, con ella, las estrategias de gestión de particiones; cluster_partition_handling se sigue aceptando, pero no tiene ningún efecto, y es solo la regla de mayoría de Raft la que decide qué lado sigue dando servicio. Elimine la clave al actualizar. Las colas de quórum replican el estado de la cola entre los nodos mediante el consenso Raft, de modo que perder cualquier nodo (o una zona de disponibilidad completa) sigue dejando una mayoría disponible para atender el tráfico y elegir automáticamente nuevos líderes de cola. Las colas espejo clásicas, el mecanismo de HA anterior, se eliminaron en RabbitMQ 4.x, así que las colas de quórum son ahora la vía soportada para la HA. Para los cálculos de número de nodos y de throughput, consulte nuestra guía de dimensionamiento para HA y DR.
¿Cuántos nodos de RabbitMQ deberíamos tener?
Tres nodos es el punto de partida estándar para producción, repartidos uno por zona de disponibilidad y siempre en número impar. Un número impar evita empates de split-brain durante las particiones de red, y tres es el mínimo que tolera el fallo de un nodo o de una zona de disponibilidad manteniendo una mayoría de quórum. Un clúster de dos nodos es peor que uno de un solo nodo, ya que perder cualquiera de los dos elimina por completo la disponibilidad por mayoría. Pasar de tres nodos es una decisión que depende del throughput y de la carga de trabajo, y se trata en nuestra guía de dimensionamiento de clústeres; no es un valor por defecto para un primer despliegue.
¿Debemos elegir colas de quórum para la HA?
Sí: para cualquier carga de trabajo con requisitos de durabilidad o disponibilidad, las colas de quórum son hoy la opción por defecto recomendada. Usan replicación basada en Raft entre los nodos del clúster, sobreviven a la pérdida de una minoría de nodos sin intervención manual y son el tipo de cola de HA en el que RabbitMQ sigue invirtiendo desarrollo. Las colas espejo clásicas, el mecanismo de HA anterior, se eliminaron por completo en RabbitMQ 4.0, así que cualquier equipo que siga planificando con ellas está construyendo sobre una vía obsoleta. Las colas clásicas (sin espejo) siguen siendo razonables para tráfico de poco valor o que tolera un solo nodo. Consulte nuestra comparativa entre colas clásicas y de quórum para conocer todos los criterios de decisión.
¿Cuál es la configuración de clúster de RabbitMQ recomendada para empresas?
Un mínimo de tres nodos, uno por zona de disponibilidad, en número impar, colas de quórum como tipo de cola por defecto y gestión de particiones pause_minority. (En la 4.3 y posteriores, suprima el parámetro de particiones: las estrategias se eliminaron y la clave no tiene efecto). Añada encima aislamiento con un vhost por dominio de negocio, convenciones de nomenclatura aplicadas a colas y exchanges, y políticas (no argumentos por cola en la aplicación) que controlen el comportamiento de las colas, como el TTL y la longitud máxima. Active TLS en el puerto 5671 desde el principio, límites explícitos de memoria y disco, y monitorización basada en Prometheus de las seis métricas clave: profundidad de las colas, utilización de los consumidores, memoria de los nodos, uso de descriptores de fichero, mensajes sin confirmar y estado de las particiones.
¿Puede un partner de RabbitMQ revisar nuestra arquitectura?
Sí. AceMQ revisa arquitecturas de RabbitMQ como parte de su trabajo de soporte y asesoramiento, y cubre la topología del clúster, el diseño de colas y vhosts, la postura de seguridad y la preparación para actualizaciones frente a los patrones de esta guía. Como el único partner MSP de RabbitMQ designado por Broadcom, con línea directa con el equipo principal (Core Team) de RabbitMQ, AceMQ da soporte a empresas que ejecutan desde la 3.8.x hasta las versiones 4.x actuales, con objetivos de respuesta desde 15 minutos, según el plan, en los contratos de soporte. Póngase en contacto con nosotros o consulte la página de RabbitMQ para ver todo lo que cubre una revisión.
¿Necesitamos un clúster independiente por entorno?
Sí. Use clústeres de RabbitMQ totalmente separados para producción, staging y desarrollo, en lugar de separarlos por vhost dentro de un mismo clúster. Los vhosts son la herramienta adecuada para aislar dominios de negocio dentro de un entorno; no sustituyen a la separación física o lógica de clústeres entre entornos, ya que una política mal configurada, un agotamiento de recursos o una actualización fallida en un clúster compartido pueden afectar al tráfico de producción independientemente de los límites de los vhosts. Además, así las pruebas de actualización son fiables: staging debe ser un clúster realmente separado que pueda romper sin consecuencias, no un vhost que comparte infraestructura con producción.
Hablar con un ingeniero
¿Necesita ayuda con RabbitMQ?
Ingenieros sénior que lo gestionan en producción. Solicite un presupuesto o una consulta gratuita, sin discursos comerciales.
Guías, comparativas e investigación

