sammlerio/rabbitmq

RabbitMQ 增强配置 Docker 镜像

镜像概述

本镜像基于官方RabbitMQ稳定版本构建，在保留原生功能的基础上，集成了额外配置优化，旨在简化部署流程并满足定制化需求。通过预设常用配置项，减少手动配置步骤，提升消息队列服务的部署效率和使用便捷性。

核心功能与特性

• 兼容性保障：基于官方RabbitMQ镜像构建，确保与原生功能完全兼容
• 预设配置优化：包含默认用户、虚拟主机及权限配置，开箱即用
• 插件支持：支持自动启用常用插件（如management、mqtt、stomp等）
• 持久化增强：优化数据持久化配置，提升消息可靠性
• 灵活定制：通过环境变量轻松调整核心参数，无需手动修改配置文件

使用场景

• 开发环境：快速搭建本地RabbitMQ服务，减少环境配置时间
• 测试环境：模拟生产环境的定制化配置，验证消息队列行为
• 生产环境：通过预设安全配置和性能优化，满足生产级消息队列需求

使用方法

快速启动

通过以下命令直接启动容器：

bash
docker run -d \
  --name rabbitmq-enhanced \
  -p 5672:5672 \  # AMQP协议端口
  -p 15672:15672 \  # 管理界面端口
  -e RABBITMQ_DEFAULT_USER=admin \
  -e RABBITMQ_DEFAULT_PASS=SecurePass123 \
  -e ENABLED_PLUGINS=rabbitmq_management,rabbitmq_mqtt \
  your-image-name:latest

Docker Compose 配置

创建docker-compose.yml文件进行多容器管理：

yaml
version: '3.8'
services:
  rabbitmq:
    image: your-image-name:latest
    container_name: rabbitmq-service
    restart: always
    ports:
      - "5672:5672"    # AMQP端口
      - "15672:15672"  # 管理界面端口
      - "1883:1883"    # MQTT端口（若启用mqtt插件）
    environment:
      - RABBITMQ_DEFAULT_USER=admin          # 默认管理员用户名
      - RABBITMQ_DEFAULT_PASS=SecurePass123  # 默认管理员密码
      - RABBITMQ_DEFAULT_VHOST=/app-vhost    # 默认虚拟主机
      - ENABLED_PLUGINS=rabbitmq_management,rabbitmq_mqtt,rabbitmq_stomp  # 启用的插件列表
      - RABBITMQ_SERVER_ADDITIONAL_ERL_ARGS=-rabbit disk_free_limit 2147483648  # 磁盘空间限制（2GB）
    volumes:
      - rabbitmq-data:/var/lib/rabbitmq  # 数据持久化卷
      - ./custom-config:/etc/rabbitmq/custom  # 自定义配置文件挂载（可选）
volumes:
  rabbitmq-data:  # 持久化数据卷

配置参数说明

环境变量

持久化配置

通过挂载/var/lib/rabbitmq卷实现数据持久化，确保容器重启后消息、用户配置等数据不丢失。建议生产环境使用命名卷或绑定宿主机目录。

管理界面访问

启动容器后，通过http://localhost:15672访问RabbitMQ管理界面，使用配置的用户名和密码登录（默认guest/guest，仅本地访问；自定义用户可远程访问）。