silentshade/rabbitmq

RabbitMQ Docker镜像文档

镜像概述

本镜像为Docker官方维护的https://registry.hub.docker.com/_/rabbitmq/%E5%AE%98%E6%96%B9%E9%95%9C%E5%83%8F%EF%BC%8C%E7%94%B1Docker, Inc.负责维护。RabbitMQ是一个开源的消息代理软件，实现了高级消息队列协议(AMQP)，用于在分布式系统中实现可靠的消息传递。

完整的使用说明及贡献、问题反馈信息，请参考https://registry.hub.docker.com/_/rabbitmq/%E3%80%82%E9%95%9C%E5%83%8F%E6%96%87%E6%A1%A3%E7%9A%84%E5%AE%8C%E6%95%B4%E5%86%85%E5%AE%B9%E6%89%98%E7%AE%A1%E5%9C%A8https://github.com/docker-library/docs%E4%BB%93%E5%BA%93%E7%9A%84https://github.com/docker-library/docs/tree/master/rabbitmq%E3%80%82

核心功能与特性

• 多协议支持：支持AMQP 0-9-1、AMQP 1.0、MQTT、STOMP等多种消息协议
• 可靠消息传递：提供消息持久化、确认机制，确保消息不丢失
• 灵活路由：支持多种交换类型（Direct、Topic、Fanout、Headers），实现复杂消息路由
• 集群支持：可部署为集群模式，提供高可用性和负载均衡
• 管理界面：内置Web管理界面，便于监控和管理消息队列
• 可扩展性：支持插件机制，可扩展功能（如延迟队列、消息追踪等）

使用场景

• 分布式系统通信：作为不同服务间的消息中间件，实现服务解耦
• 异步任务处理：将耗时任务异步化，提高系统响应速度
• 流量削峰：在高并发场景下缓冲请求，保护后端服务
• 事件驱动架构：基于消息传递实现事件发布/订阅模式
• 跨语言通信：支持多种编程语言客户端，实现不同技术栈间的通信

使用方法

基本运行

使用以下命令启动RabbitMQ容器：

bash
docker run -d --name rabbitmq -p 5672:5672 -p 15672:15672 rabbitmq:latest

• -p 5672:5672：映射AMQP协议端口
• -p 15672:15672：映射Web管理界面端口（需使用包含管理插件的镜像标签，如rabbitmq:management）

启用管理界面

官方镜像提供包含管理插件的标签（如rabbitmq:management），启动命令：

bash
docker run -d --name rabbitmq-management -p 5672:5672 -p 15672:15672 rabbitmq:management

启动后，可通过http://localhost:15672访问管理界面，默认用户名/密码为guest/guest（仅允许本地访问，远程访问需配置用户）。

持久化数据

为避免容器重启后数据丢失，可挂载数据卷：

bash
docker run -d --name rabbitmq -p 5672:5672 -v /path/to/rabbitmq/data:/var/lib/rabbitmq rabbitmq:latest

环境变量配置

可通过环境变量配置RabbitMQ，常用变量：

• RABBITMQ_DEFAULT_USER：默认用户名
• RABBITMQ_DEFAULT_PASS：默认密码
• RABBITMQ_DEFAULT_VHOST：默认虚拟主机

示例：

bash
docker run -d --name rabbitmq -e RABBITMQ_DEFAULT_USER=admin -e RABBITMQ_DEFAULT_PASS=password rabbitmq:management

Docker Compose配置

创建docker-compose.yml文件：

yaml
version: '3'
services:
  rabbitmq:
    image: rabbitmq:management
    ports:
      - "5672:5672"
      - "15672:15672"
    environment:
      RABBITMQ_DEFAULT_USER: admin
      RABBITMQ_DEFAULT_PASS: password
    volumes:
      - rabbitmq-data:/var/lib/rabbitmq

volumes:
  rabbitmq-data:

启动：docker-compose up -d

构建状态

• Travis CI：![build status badge]([***]
• Automated update.sh：![build status badge]([***]

注：本文档由https://github.com/docker-library/docs/blob/master/generate-repo-stub-readme.sh%E8%87%AA%E5%8A%A8%E7%94%9F%E6%88%90%E3%80%82