b2boost/rabbitmq

定制化RabbitMQ管理镜像（含延迟消息交换插件）

镜像概述和主要用途

本镜像基于官方rabbitmq:3-management镜像定制，预安装了rabbitmq_delayed_message_exchange插件，提供延迟消息交换功能。适用于需要在RabbitMQ中实现延迟消息处理的场景，同时保留官方管理版的Web管理界面和全部基础功能。

核心功能和特性

• 继承官方功能：完整保留rabbitmq:3-management镜像的所有功能，包括Web管理界面、标准消息队列功能及默认配置
• 延迟消息支持：预安装并启用rabbitmq_delayed_message_exchange插件，支持创建延迟消息交换器（x-delayed-message）
• 即开即用：无需手动安装插件，启动容器后即可使用延迟消息功能
• 版本兼容：基于RabbitMQ 3.x版本构建，保持与官方镜像的配置兼容性

使用场景和适用范围

• 定时任务调度系统
• 消息重试机制实现
• 订单超时自动取消
• 预约提醒、定时通知等时间敏感业务
• 需要可视化管理RabbitMQ的开发/生产环境

使用方法和配置说明

基本使用（docker run）

bash
docker run -d \
  --name rabbitmq-delayed \
  -p 5672:5672 \  # AMQP协议端口
  -p 15672:15672 \ # Web管理界面端口
  -e RABBITMQ_DEFAULT_USER=admin \
  -e RABBITMQ_DEFAULT_PASS=password \
  [镜像名称]

验证插件安装

容器启动后，可通过以下方式验证插件是否成功安装：

1. 进入容器执行插件列表命令：

bash
docker exec -it rabbitmq-delayed rabbitmq-plugins list

应显示[E*] rabbitmq_delayed_message_exchange（E表示已启用）

2. 通过Web管理界面验证： 访问http://localhost:15672，使用配置的用户名密码登录，在"Exchanges"页面的"Type"下拉菜单中应能看到"x-delayed-message"选项

环境变量配置

支持官方rabbitmq:3-management镜像的所有环境变量，常用配置：

• RABBITMQ_DEFAULT_USER：默认管理员用户名（默认：guest）
• RABBITMQ_DEFAULT_PASS：默认管理员密码（默认：guest）
• RABBITMQ_DEFAULT_VHOST：默认虚拟主机（默认：/）
• RABBITMQ_ERLANG_COOKIE：Erlang Cookie，集群环境需保持一致

docker-compose配置示例

yaml
version: '3'
services:
  rabbitmq:
    image: docker.xuanyuan.run/[镜像名称]
    container_name: rabbitmq-delayed
    ports:
      - "5672:5672"
      - "15672:15672"
    environment:
      - RABBITMQ_DEFAULT_USER=admin
      - RABBITMQ_DEFAULT_PASS=password
    volumes:
      - rabbitmq-data:/var/lib/rabbitmq
    restart: always

volumes:
  rabbitmq-data:

延迟消息交换器使用说明

创建延迟消息交换器时，需指定类型为x-delayed-message，并设置参数x-delayed-type指定底层交换器类型（如direct、topic等）。消息发布时通过x-delay头指定延迟时间（毫秒）。