inigus/rabbitmq

RabbitMQ 3.8.9-Erlang 23.2.2 镜像文档

镜像概述

本镜像基于RabbitMQ 3.8.9版本构建，运行在Erlang 23.2.2环境中，并集成了x-delayer插件。RabbitMQ是一个开源的消息代理软件，实现了高级消息队列协议（AMQP），用于在分布式系统中实现可靠的消息传递。x-delayer插件扩展了RabbitMQ的功能，支持消息延迟投递，满足定时任务、延迟处理等场景需求。

核心功能与特性

基础功能

• 支持AMQP 0-9-1协议，兼容主流消息队列客户端
• 提供消息队列、交换机、绑定等核心消息路由机制
• 内置管理界面（Web UI），支持队列监控、消息管理、用户配置等操作

环境特性

• 基于Erlang 23.2.2运行时环境，保证稳定性和兼容性
• 精简镜像体积，优化启动速度

x-delayer插件功能

• 支持消息延迟投递，可设置消息延迟时间（秒级精度）
• 基于死信队列（Dead Letter Queue）机制实现延迟功能，可靠性高
• 兼容RabbitMQ原生队列和交换机模型，无需额外改造现有系统

使用场景

• 定时任务处理：如定时数据备份、定时报表生成
• 订单超时处理：电商订单超过指定时间未支付自动取消
• 消息重试机制：失败消息延迟重试，避免瞬时故障影响
• 异步通知延迟发送：如用户注册后延迟发送欢迎邮件

使用方法

基本启动命令

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

Docker Compose配置示例

yaml
version: '3'
services:
  rabbitmq:
    image: docker.xuanyuan.run/rabbitmq:3.8.9-erlang23.2.2-xdelayer
    container_name: rabbitmq
    ports:
      - "5672:5672"
      - "15672:15672"
    environment:
      - RABBITMQ_DEFAULT_USER=admin
      - RABBITMQ_DEFAULT_PASS=password
      - RABBITMQ_SERVER_ADDITIONAL_ERL_ARGS=-rabbit log_levels [{connection,error},{default,error}]  # 日志级别配置
    volumes:
      - rabbitmq_data:/var/lib/rabbitmq  # 数据持久化
    restart: always

volumes:
  rabbitmq_data:

x-delayer插件使用配置

1. 访问管理界面：启动容器后，通过 http://localhost:15672 访问管理界面，使用配置的用户名/密码登录
2. 创建延迟交换机：
   • 交换机类型：x-delayed-message
   • 交换机参数：添加 x-delayed-type 参数，值为目标交换机类型（如 direct、topic 等）
3. 绑定队列：将延迟交换机与目标队列绑定，设置路由键
4. 发送延迟消息：发送消息时添加 x-delay 消息头，值为延迟时间（毫秒）

环境变量说明

注意事项

• 生产环境建议挂载数据卷（/var/lib/rabbitmq）实现数据持久化，避免容器重启导致数据丢失
• 默认情况下，guest 用户仅允许本地访问，生产环境需配置自定义用户名和密码
• x-delayer插件依赖RabbitMQ的死信队列机制，使用前需确保目标队列已配置死信交换机（若需）
• 高并发场景下，建议调整Erlang进程数和内存限制，可通过 RABBITMQ_SERVER_ADDITIONAL_ERL_ARGS 设置相关参数