laoyumi/rocketmq

RocketMQ Docker镜像文档

镜像概述和主要用途

RocketMQ是阿里巴巴基于大规模消息业务场景开发的消息中间件，具备快速、可靠、可扩展和易用的特点。该Docker镜像为用户提供了隔离的测试环境和云隔离集群部署能力，适用于构建分布式系统中的消息通信层，支持高并发、高可用的消息传递需求。

核心功能和特性

• 可靠消息传递：支持可靠的FIFO（先进先出）和严格顺序消息，确保消息按发送顺序准确传递
• 多消息模型：同时支持发布/订阅（Pub/Sub）和点对点（P2P）消息模型
• 高容量存储：单队列支持百万级消息堆积能力
• 灵活消费模式：提供拉取（Pull）和推送（Push）两种队列消费方式
• 多协议支持：兼容JMS、MQTT等多种消息协议
• 分布式集群：支持分布式部署和故障容错，确保系统高可用性
• Docker化部署：提供Docker镜像，便于快速搭建隔离测试环境和云隔离集群
• 管理控制台：内置功能丰富的管理面板，支持配置管理和系统监控

使用场景和适用范围

• 分布式系统通信：作为微服务架构中的消息通信枢纽，实现服务间解耦
• 流量削峰填谷：应对高并发场景，缓冲瞬时流量，保护后端服务
• 异步处理：将非实时业务逻辑异步化，提升系统响应速度
• 日志收集与处理：作为日志传输管道，实现分布式日志的可靠收集
• 数据同步：支持跨系统、跨平台的数据异步同步
• 事件驱动架构：构建基于事件的系统设计，实现松耦合的服务协作

使用方法和配置说明

基本使用步骤

1. 拉取Docker镜像

bash
docker pull vongosling/rocketmq

2. 启动NameServer

bash
docker run -d -p 9876:9876 --name rocketmq-namesrv vongosling/rocketmq sh mqnamesrv

3. 启动Broker

bash
docker run -d -p 10911:10911 -p 10909:10909 \
  --name rocketmq-broker \
  --link rocketmq-namesrv:namesrv \
  -e "NAMESRV_ADDR=namesrv:9876" \
  vongosling/rocketmq sh mqbroker -n namesrv:9876

4. 启动管理控制台

bash
docker run -d -p 8080:8080 --name rocketmq-console \
  --link rocketmq-namesrv:namesrv \
  -e "JAVA_OPTS=-Drocketmq.namesrv.addr=namesrv:9876" \
  styletang/rocketmq-console-ng

配置参数说明

环境变量

• NAMESRV_ADDR：NameServer地址，格式为host:port，用于Broker连接NameServer
• ROCKETMQ_HOME：RocketMQ安装路径，默认在容器内为/root/rocketmq
• JAVA_OPTS：JVM参数配置，可用于调整内存分配等性能参数

端口映射

• 9876：NameServer服务端口
• ***：Broker对外服务端口
• ***：Broker内部通信端口
• 8080：管理控制台端口（若使用console镜像）

docker-compose配置示例

yaml
version: '3'
services:
  namesrv:
    image: vongosling/rocketmq
    container_name: rocketmq-namesrv
    ports:
      - "9876:9876"
    command: sh mqnamesrv
    networks:
      - rocketmq-network

  broker:
    image: vongosling/rocketmq
    container_name: rocketmq-broker
    ports:
      - "10911:10911"
      - "10909:10909"
    environment:
      - NAMESRV_ADDR=namesrv:9876
    command: sh mqbroker -n namesrv:9876
    depends_on:
      - namesrv
    networks:
      - rocketmq-network

  console:
    image: styletang/rocketmq-console-ng
    container_name: rocketmq-console
    ports:
      - "8080:8080"
    environment:
      - JAVA_OPTS=-Drocketmq.namesrv.addr=namesrv:9876
    depends_on:
      - namesrv
    networks:
      - rocketmq-network

networks:
  rocketmq-network:
    driver: bridge

相关资源

• 官方主页：https://github.com/alibaba/RocketMQ
• 文档中心：https://github.com/alibaba/RocketMQ/wiki
• 邮件列表：<[***]>
• 问题反馈：https://github.com/alibaba/RocketMQ/issues
• 社区支持：*** 、微博 <[]>

许可证

Apache License, Version 2.0 Copyright (C) 2010-2013 Alibaba Group Holding Limited