t3nde/rabbitmq

docker-rabbitmq 镜像文档

镜像概述

docker-rabbitmq是一个基于RabbitMQ的Docker镜像，在官方RabbitMQ基础上预安装了多个实用插件，旨在提供开箱即用的消息队列服务，同时支持延迟消息处理和Web管理功能。

核心功能与特性

• 基础RabbitMQ功能：包含RabbitMQ消息队列核心功能，支持AMQP协议，实现可靠的消息传递
• 延迟消息交换：通过rabbitmq_delayed_message_exchange插件支持延迟消息交换，可创建延迟队列，实现消息的定时投递
• Web管理界面：集成rabbitmq_management插件，提供直观的Web管理界面，支持队列监控、用户管理、策略配置等操作
• 管理代理与Web调度：rabbitmq_management_agent和rabbitmq_web_dispatch插件为Web管理功能提供底层支持，确保管理界面稳定运行

使用场景与适用范围

• 需要延迟消息处理的业务场景（如定时任务、订单超时处理等）
• 需通过Web界面监控和管理RabbitMQ服务的场景
• 快速部署具备扩展功能的RabbitMQ实例的开发、测试或生产环境
• 微服务架构中需要可靠消息传递的组件间通信

使用方法与配置说明

基本部署

使用以下命令快速启动容器：

bash
docker run -d -p 5672:5672 -p 15672:15672 --name rabbitmq ***-quay.xuanyuan.run/t3n/rabbitmq

• -p 5672:5672：映射RabbitMQ默认AMQP端口，用于消息通信
• -p 15672:15672：映射管理界面端口，用于Web管理访问

访问管理界面

容器启动后，通过浏览器访问 http://<主机IP>:15672 打开管理界面，默认登录凭据为：

• 用户名：guest
• 密码：guest

注意：默认guest用户仅允许本地访问，生产环境建议创建新用户并限制访问权限。

环境变量配置

可通过环境变量自定义RabbitMQ配置，常用参数包括：

示例：使用自定义用户启动容器

bash
docker run -d -p 5672:5672 -p 15672:15672 \
  -e RABBITMQ_DEFAULT_USER=admin \
  -e RABBITMQ_DEFAULT_PASS=password \
  --name rabbitmq ***-quay.xuanyuan.run/t3n/rabbitmq

持久化数据

为确保消息数据持久化，可挂载数据卷：

bash
docker run -d -p 5672:5672 -p 15672:15672 \
  -v /path/to/rabbitmq/data:/var/lib/rabbitmq \
  --name rabbitmq ***-quay.xuanyuan.run/t3n/rabbitmq

Docker Compose配置示例

yaml
version: '3'
services:
  rabbitmq:
    image: ***-quay.xuanyuan.run/t3n/rabbitmq
    ports:
      - "5672:5672"
      - "15672:15672"
    environment:
      - RABBITMQ_DEFAULT_USER=admin
      - RABBITMQ_DEFAULT_PASS=securepassword
    volumes:
      - rabbitmq_data:/var/lib/rabbitmq
    restart: always

volumes:
  rabbitmq_data:

插件说明