qdonl/rabbitmq

RabbitMQ延时消息队列镜像

镜像概述

该镜像基于官方RabbitMQ管理版（rabbitmq:management）构建，预集成了rabbitmq-delayed-message-exchange插件，提供延时消息队列功能。通过该镜像可快速部署支持延时消息处理的RabbitMQ服务，无需手动配置插件，简化部署流程。

核心功能与特性

• 基于官方镜像：继承rabbitmq:management的全部功能，包含Web管理界面
• 预安装延时插件：已集成rabbitmq-delayed-message-exchange插件，支持延时消息交换
• 即开即用：构建后可直接启动，无需额外手动启用插件
• 完整管理功能：保留RabbitMQ原生管理界面，支持队列、交换机、用户等配置管理

使用场景

• 订单超时自动取消（如15分钟未支付取消订单）
• 定时任务调度（如固定时间发送通知）
• 消息重试机制（失败消息延时重发）
• 延时提醒功能（如预约提醒、到期提醒）

使用方法

1. 准备工作

1.1 下载插件

从官方仓库下载对应版本的延时消息交换机插件：
https://github.com/rabbitmq/rabbitmq-delayed-message-exchange/releases/

1.2 目录结构

在本地创建如下目录结构：

project/
├── Dockerfile
└── plugins/
    └── rabbitmq_delayed_message_exchange-3.12.0.ez  # 下载的插件文件

2. 构建镜像

创建Dockerfile文件，内容如下：

Dockerfile
FROM rabbitmq:management
COPY ./plugins/rabbitmq_delayed_message_exchange-3.12.0.ez /opt/rabbitmq/plugins/
RUN rabbitmq-plugins enable rabbitmq_delayed_message_exchange

执行构建命令：

bash
docker build -t rabbitmq-with-delay .

3. 运行容器

3.1 基础运行命令

bash
docker run -d \
  --name rabbitmq-delay \
  -p 5672:5672 \  # AMQP协议端口
  -p 15672:15672 \  # 管理界面端口
  -e RABBITMQ_DEFAULT_USER=admin \  # 默认用户名
  -e RABBITMQ_DEFAULT_PASS=password \  # 默认密码
  rabbitmq-with-delay

3.2 Docker Compose配置

创建docker-compose.yml：

yaml
version: '3'
services:
  rabbitmq:
    image: rabbitmq-with-delay
    container_name: rabbitmq-delay
    ports:
      - "5672:5672"
      - "15672:15672"
    environment:
      RABBITMQ_DEFAULT_USER: admin
      RABBITMQ_DEFAULT_PASS: password
    volumes:
      - rabbitmq-data:/var/lib/rabbitmq  # 持久化数据
volumes:
  rabbitmq-data:

启动服务：

bash
docker-compose up -d

4. 验证插件

访问RabbitMQ管理界面（http://localhost:***），使用配置的用户名密码登录。在"Exchanges"页面的"Type"下拉菜单中，若能看到"x-delayed-message"选项，说明插件已成功启用。

配置说明

环境变量

支持RabbitMQ官方镜像的所有环境变量，常用配置：

• RABBITMQ_DEFAULT_USER：默认管理员用户名（默认：guest）
• RABBITMQ_DEFAULT_PASS：默认管理员密码（默认：guest）
• RABBITMQ_DEFAULT_VHOST：默认虚拟主机（默认：/）
• RABBITMQ_SERVER_ADDITIONAL_ERL_ARGS：额外Erlang参数

持久化配置

通过挂载卷/var/lib/rabbitmq可实现数据持久化，避免容器重启后数据丢失。