如何使用Docker容器部署RabbitMQ延迟队列应用教程

夜萱姑娘_2202

夜萱姑娘_2202

2026-04-25

479人浏览

原创

RabbitMQ Docker部署延迟队列需严格匹配插件与服务端版本,手动启用rabbitmq_delayed_message_exchange插件并重启容器,控制台可见x-delayed-message交换类型即成功。

如何使用docker容器部署rabbitmq延迟队列应用教程

用 Docker 部署 RabbitMQ 延迟队列,核心是装对插件、配对版本、启动到位。3.9+ 版本不再支持通过环境变量自动启用插件,必须手动进容器启用,这点最容易踩坑。

匹配 RabbitMQ 与延迟插件版本

插件不兼容会导致启用失败或功能异常。必须严格按 RabbitMQ 服务端版本选插件:

  • 查当前 RabbitMQ 版本:启动容器后执行 docker exec -it myRabbitmq rabbitmqctl version
  • 去 GitHub 官方 Releases 页面下载对应版本插件:rabbitmq-delayed-message-exchange
  • 例如 RabbitMQ 3.9.22 → 下载 rabbitmq_delayed_message_exchange-3.9.0.ez(注意:3.9.x 系列统一用 3.9.0 插件)
  • 3.11 或 3.12 版本需查对应插件 release,不能直接套用旧版

编写并运行 docker-compose.yml

配置重点是挂载插件文件、开启管理界面、设置用户密码,并禁用无效的旧式环境变量。

Docker Hub
Docker Hub

Docker Hub (hub.docker.com)。此技能适用于所有 Docker Hub 操作,包括读取、创建、更新和删除数据。只要任务涉及 Docker Hub,就使用此技能。

下载
  • 确保宿主机目录下已有插件文件,如 ./rabbitmq_delayed_message_exchange-3.9.0.ez
  • 不要写 RABBITMQ_PLUGINS=--offline rabbitmq_delayed_message_exchange —— 3.9+ 已废弃,写了也无效
  • 正确示例(RabbitMQ 3.9.22):
version: '3'
services:
  rabbitmq:
    image: rabbitmq:3.9.22-management
    container_name: myRabbitmq
    ports:
      - "5672:5672"
      - "15672:15672"
    volumes:
      - ./rabbitmq_delayed_message_exchange-3.9.0.ez:/plugins/rabbitmq_delayed_message_exchange-3.9.0.ez
    environment:
      - RABBITMQ_DEFAULT_USER=admin
      - RABBITMQ_DEFAULT_PASS=123456
      - RABBITMQ_DELAYED_MESSAGE_ENABLED=true  # 仅作标识,不自动启用
  • 运行:docker-compose up -d

手动启用插件并验证

容器启动后,插件文件已存在,但未激活。必须进入容器执行启用命令。

  • 进入容器:docker exec -it myRabbitmq /bin/bash
  • 启用插件:rabbitmq-plugins enable rabbitmq_delayed_message_exchange
  • 查看状态:rabbitmq-plugins list | grep delayed,看到 [E*] rabbitmq_delayed_message_exchange 即成功
  • 退出并重启容器确保持久生效:exit && docker restart myRabbitmq
  • 访问 http://localhost:15672,登录后点 “Exchanges” → “Add a new exchange”,Type 下拉框中出现 x-delayed-message 就说明插件就绪

Spring Boot 中使用延迟交换机

代码侧只需定义 CustomExchange 类型为 x-delayed-message,发送时在消息头指定 x-delay(单位毫秒)。

  • 配置类中声明交换机:
@Bean
public CustomExchange delayedExchange() {
    Map<string object> args = new HashMap();
    args.put("x-delayed-type", "direct");
    return new CustomExchange("my-delayed-exchange", "x-delayed-message", true, false, args);
}
</string>
  • 发消息时设置延迟(比如延后 60 秒):
MessageProperties props = new MessageProperties();
props.setHeader("x-delay", 60_000);  // 毫秒
Message message = new Message("hello".getBytes(), props);
rabbitTemplate.send("my-delayed-exchange", "routing.key", message);
  • 无需额外配置队列 TTL 或死信,插件原生支持高精度延迟投递

相关专题

更多
rabbitmq和kafka有什么区别
rabbitmq和kafka有什么区别

rabbitmq和kafka的区别:1、语言与平台;2、消息传递模型;3、可靠性;4、性能与吞吐量;5、集群与负载均衡;6、消费模型;7、用途与场景;8、社区与生态系统;9、监控与管理;10、其他特性。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.02.23

724

5

Java 消息队列与异步架构实战
Java 消息队列与异步架构实战

本专题系统讲解 Java 在消息队列与异步系统架构中的核心应用,涵盖消息队列基本原理、Kafka 与 RabbitMQ 的使用场景对比、生产者与消费者模型、消息可靠性与顺序性保障、重复消费与幂等处理,以及在高并发系统中的异步解耦设计。通过实战案例,帮助学习者掌握 使用 Java 构建高吞吐、高可靠异步消息系统的完整思路。

2026.01.28

1248

20

RabbitMQ使用教程合集
RabbitMQ使用教程合集

RabbitMQ使用教程合集整理 RabbitMQ 基础教程、消息队列开发案例、生产者消费者、交换机与队列实战内容。

2026.05.20

224

15

RabbitMQ集群部署指南
RabbitMQ集群部署指南

RabbitMQ集群部署指南聚合 RabbitMQ 集群部署、高可用架构、镜像队列、故障恢复、监控与运维优化内容。

2026.05.20

137

12

RabbitMQ Docker实战指南
RabbitMQ Docker实战指南

RabbitMQ Docker实战指南提供 RabbitMQ Docker 镜像部署、Docker Compose、Kubernetes Operator 与云原生实践教程。

2026.05.20

162

10

k8s和docker区别
k8s和docker区别

k8s和docker区别有抽象层次不同、管理范围不同、功能不同、应用程序生命周期管理不同、缩放能力不同、高可用性等等区别。本专题为大家提供k8s和docker区别相关的各种文章、以及下载和课程。

2023.07.24

845

4

docker进入容器的方法有哪些
docker进入容器的方法有哪些

docker进入容器的方法:1. Docker exec;2. Docker attach;3. Docker run --interactive --tty;4. Docker ps -a;5. 使用 Docker Compose。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.04.08

7139

6

docker容器无法访问外部网络怎么办
docker容器无法访问外部网络怎么办

docker 容器无法访问外部网络的原因和解决方法:配置 nat 端口映射以将容器端口映射到主机端口。根据主机兼容性选择正确的网络驱动(如 host 或 overlay)。允许容器端口通过主机的防火墙。配置容器的正确 dns 服务器。选择正确的容器网络模式。排除主机网络问题,如防火墙或连接问题。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.04.08

8357

6

docker镜像有什么用
docker镜像有什么用

docker 镜像是预构建的软件组件,用途广泛,包括:应用程序部署:简化部署,提高移植性。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.04.08

3353

7

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Docker Desktop故障排查手册
Docker Desktop故障排查手册

共0课时 | 0人学习

Docker镜像构建手册
Docker镜像构建手册

共0课时 | 0人学习