pondidum/rabbitmq

RabbitMQ with Consul Auto Clustering 镜像文档

概述

本镜像基于Alpine Linux构建，集成了RabbitMQ消息队列服务器与Consul自动集群功能。通过Consul服务发现机制，可实现RabbitMQ节点的自动发现与集群组建，简化分布式环境下的消息队列部署与扩展，适用于需要高可用性和动态扩缩容的业务场景。

核心功能与特性

• 轻量级基础：基于Alpine Linux，镜像体积小，资源占用低
• 自动集群：集成Consul服务发现，支持RabbitMQ节点自动加入集群
• 完整功能：包含RabbitMQ核心功能（消息队列、交换机、绑定、持久化等）
• 多协议支持：支持AMQP 0-9-1、AMQP 1.0、MQTT、STOMP等多种消息协议
• 可配置性：通过环境变量灵活配置集群参数、用户认证、网络等

使用场景

• 分布式系统中的服务间异步通信
• 微服务架构下的消息传递与解耦
• 需要高可用、动态扩展的消息队列部署
• 开发/测试环境中快速搭建RabbitMQ集群

使用方法与配置说明

基本使用（单节点）

bash
docker run -d \
  --name rabbitmq-consul \
  -p 5672:5672 \  # AMQP端口
  -p 15672:15672 \  # 管理界面端口
  -e CONSUL_HOST=consul-server \  # Consul服务器地址
  -e RABBITMQ_DEFAULT_USER=admin \  # 默认管理员用户名
  -e RABBITMQ_DEFAULT_PASS=password \  # 默认管理员密码
  rabbitmq-consul:latest

集群部署（docker-compose示例）

yaml
version: '3'
services:
  consul:
    image: docker.xuanyuan.run/consul:latest
    ports:
      - "8500:8500"
    command: agent -server -bootstrap-expect=1 -client=0.0.0.0

  rabbitmq-1:
    image: docker.xuanyuan.run/rabbitmq-consul:latest
    depends_on:
      - consul
    environment:
      - CONSUL_HOST=consul
      - CONSUL_PORT=8500
      - RABBITMQ_NODE_NAME=rabbit@rabbitmq-1
      - RABBITMQ_ERLANG_COOKIE=my-secret-cookie
      - RABBITMQ_DEFAULT_USER=admin
      - RABBITMQ_DEFAULT_PASS=password
    ports:
      - "5672:5672"
      - "15672:15672"

  rabbitmq-2:
    image: docker.xuanyuan.run/rabbitmq-consul:latest
    depends_on:
      - consul
      - rabbitmq-1
    environment:
      - CONSUL_HOST=consul
      - CONSUL_PORT=8500
      - RABBITMQ_NODE_NAME=rabbit@rabbitmq-2
      - RABBITMQ_ERLANG_COOKIE=my-secret-cookie
      - RABBITMQ_DEFAULT_USER=admin
      - RABBITMQ_DEFAULT_PASS=password
    ports:
      - "5673:5672"
      - "15673:15672"

关键环境变量配置

注意事项

1. 所有集群节点必须使用相同的RABBITMQ_ERLANG_COOKIE
2. Consul服务需提前部署并确保节点间网络互通
3. 生产环境建议配置持久化存储（通过-v挂载/var/lib/rabbitmq目录）
4. 管理界面默认仅允许本地访问，如需远程访问需配置RABBITMQ_MANAGEMENT_IP