roverdotcom/rabbitmq

Dev Rabbitmq 镜像文档

镜像概述

该镜像基于RabbitMQ管理版容器构建，在保留原版管理功能的基础上，额外集成了rabbitmq_shovel插件，提供消息跨实例传递能力，适用于需要在不同RabbitMQ节点间进行消息迁移和同步的场景。

核心功能与特性

• 基于官方RabbitMQ管理版，包含完整的Web管理界面
• 已预安装并启用rabbitmq_shovel插件，支持消息在不同RabbitMQ实例间的复制与转发
• 保留原版RabbitMQ的所有核心功能，如消息队列、交换机、绑定等

使用场景

• 跨RabbitMQ实例的消息数据迁移
• 多节点RabbitMQ集群间的消息同步
• 需要将消息从一个broker转发到另一个broker的业务场景
• 分布式系统中跨服务的消息路由需求

使用方法

基本运行命令

bash
docker run -d \
  --name dev-rabbitmq \
  -p 5672:5672 \  # AMQP协议端口
  -p 15672:15672 \  # 管理界面端口
  [镜像名称]

验证插件状态

1. 访问RabbitMQ管理界面：http://localhost:15672（默认用户名/密码：guest/guest）
2. 导航至"Plugins"页面
3. 确认"rabbitmq_shovel"插件状态为"Enabled"

配置Shovel

通过管理界面配置消息转发规则：

1. 登录管理界面后，进入"Admin" -> "Shovels"
2. 点击"Add a new shovel"创建转发规则
3. 配置源和目标RabbitMQ实例信息（包括连接地址、凭证、队列名称等）
4. 设置转发参数（如消息确认模式、转发频率、批处理大小等）

环境变量配置

支持通过环境变量自定义基础配置：

• RABBITMQ_DEFAULT_USER：默认管理员用户名（默认值：guest）
• RABBITMQ_DEFAULT_PASS：默认管理员密码（默认值：guest）
• RABBITMQ_DEFAULT_VHOST：默认虚拟主机（默认值：/）
• RABBITMQ_SHOVEL_CONFIG_FILE：自定义shovel配置文件路径

数据持久化

为确保数据不丢失，建议挂载数据卷：

bash
docker run -d \
  --name dev-rabbitmq \
  -p 5672:5672 \
  -p ***:*** \
  -v /本地路径/rabbitmq-data:/var/lib/rabbitmq \
  [镜像名称]