一、为什么选择Docker部署RocketMQ？

在分布式系统架构中，消息队列（如RocketMQ）作为核心组件，承担着异步解耦、流量削峰等关键职责。传统物理机部署存在环境依赖复杂、资源利用率低、扩展困难等问题，而Docker容器化技术通过标准化环境、快速部署和资源隔离，完美解决了这些痛点。

核心优势：

环境一致性：容器镜像封装了所有依赖（JDK、RocketMQ二进制包等），避免“在我机器上能运行”的尴尬。
快速启停：单节点部署从下载镜像到启动服务仅需数分钟，相比传统方式效率提升80%以上。
资源弹性：通过Kubernetes编排可轻松实现水平扩展，应对突发流量。
隔离性：每个Broker实例运行在独立容器中，避免端口冲突和资源竞争。

二、单节点RocketMQ Docker部署

2.1 基础环境准备

系统要求：Linux 64位系统（推荐CentOS 7+/Ubuntu 20.04+），Docker 20.10+
资源建议：
- 生产环境：4核8G+（NameServer+Broker同机部署）
- 测试环境：2核4G

# 安装Docker（以CentOS为例）
sudo yum install -y yum-utils
sudo yum-config-manager --add-repo https://download.docker.com/linux/centos/docker-ce.repo
sudo yum install docker-ce docker-ce-cli containerd.io
sudo systemctl enable --now docker

2.2 部署NameServer

NameServer是RocketMQ的路由中心，建议独立部署（也可与Broker同机）。

docker pull apache/rocketmq:5.1.3  # 推荐使用稳定版本
docker run -d \
  --name rmq-namesrv \
  -p 9876:9876 \
  -e "JAVA_OPT_EXT=-Xms512m -Xmx512m" \
  apache/rocketmq:5.1.3 \
  sh mqnamesrv

关键参数说明：

-p 9876:9876：暴露NameServer默认端口
JAVA_OPT_EXT：JVM参数，生产环境建议根据实际内存调整

2.3 部署Broker

Broker是消息存储核心，支持主从架构。以下为单Master部署示例：

docker run -d \
  --name rmq-broker \
  -p 10911:10911 \
  -p 10909:10909 \
  -e "NAMESRV_ADDR=127.0.0.1:9876" \
  -e "JAVA_OPT_EXT=-Xms1g -Xmx1g -Xmn512m" \
  -v /data/rocketmq/logs:/home/rocketmq/logs \
  -v /data/rocketmq/store:/home/rocketmq/store \
  apache/rocketmq:5.1.3 \
  sh mqbroker -n 127.0.0.1:9876 -c /opt/rocketmq-5.1.3/conf/broker.conf

配置要点：

持久化存储：通过-v参数映射日志和存储目录，避免容器删除导致数据丢失
自定义配置：生产环境建议通过broker.conf文件配置（示例配置见下文）
内存设置：-Xms和-Xmx建议设置为物理内存的50%-70%

2.4 验证部署

# 进入容器执行命令
docker exec -it rmq-broker bash
# 查看Broker状态
sh mqadmin clusterList -n 127.0.0.1:9876
# 发送测试消息
sh tools.sh org.apache.rocketmq.example.quickstart.Producer \
  -n 127.0.0.1:9876 -t "TestTopic"

三、生产级集群部署方案

3.1 集群架构设计

推荐采用2Master-2Slave异步复制架构，兼顾高可用和性能：

NameServer集群（3节点）
  │
  ├─ Master1 (192.168.1.101)
  │   └─ Slave1 (192.168.1.102)
  └─ Master2 (192.168.1.103)
      └─ Slave2 (192.168.1.104)

3.2 使用Docker Compose编排

创建docker-compose.yml文件：

version: '3.8'
services:
  namesrv1:
    image: apache/rocketmq:5.1.3
    container_name: rmq-namesrv1
    ports:
      - "9876:9876"
    command: sh mqnamesrv
    networks:
      - rmq-net
  broker1:
    image: apache/rocketmq:5.1.3
    container_name: rmq-broker1
    ports:
      - "10911:10911"
      - "10909:10909"
    environment:
      - NAMESRV_ADDR=namesrv1:9876
    volumes:
      - ./broker1/logs:/home/rocketmq/logs
      - ./broker1/store:/home/rocketmq/store
      - ./broker1/conf/broker.conf:/opt/rocketmq-5.1.3/conf/broker.conf
    command: sh mqbroker -c /opt/rocketmq-5.1.3/conf/broker.conf
    depends_on:
      - namesrv1
    networks:
      - rmq-net
  # 其他节点配置类似...
networks:
  rmq-net:
    driver: bridge

3.3 关键配置文件示例

broker.conf核心配置：

brokerClusterName = DefaultCluster
brokerName = broker-a
brokerId = 0  # 0表示Master，>0表示Slave
deleteWhen = 04
fileReservedTime = 48
brokerRole = ASYNC_MASTER  # 或SYNC_MASTER/SLAVE
flushDiskType = ASYNC_FLUSH
listenPort = 10911
namesrvAddr = namesrv1:9876,namesrv2:9876
storePathRootDir = /home/rocketmq/store
storePathCommitLog = /home/rocketmq/store/commitlog
autoCreateTopicEnable = true

四、运维管理最佳实践

4.1 监控方案

Prometheus+Grafana：通过JMX Exporter暴露Broker指标

# 自定义镜像添加JMX支持
FROM apache/rocketmq:5.1.3
RUN apt-get update && apt-get install -y procps
EXPOSE 9999
CMD ["sh", "-c", "export JAVA_OPTS=\"-Djava.rmi.server.hostname=${HOST_IP} -Dcom.sun.management.jmxremote.port=9999 -Dcom.sun.management.jmxremote.rmi.port=9999 -Dcom.sun.management.jmxremote.ssl=false -Dcom.sun.management.jmxremote.authenticate=false\" && sh mqbroker -n ${NAMESRV_ADDR} -c /opt/rocketmq-5.1.3/conf/broker.conf"]

4.2 常见问题处理

OOM错误：
- 调整JAVA_OPT_EXT参数
- 监控/home/rocketmq/store/commitlog目录空间
网络问题：
- 确保容器间网络互通
- 检查防火墙规则：iptables -L -n
持久化失败：
- 确认宿主机目录有写入权限
- 使用docker inspect检查卷映射是否正确

4.3 升级策略

蓝绿部署：

# 启动新版本容器
docker run -d --name rmq-broker-new ... apache/rocketmq:5.2.0
# 验证无误后切换流量
docker stop rmq-broker-old

滚动升级：逐个停止Slave节点升级，再升级Master

五、性能优化建议

内核参数调优：

# 在宿主机执行
echo "vm.overcommit_memory=1" >> /etc/sysctl.conf
echo "vm.swappiness=0" >> /etc/sysctl.conf
sysctl -p

Broker参数优化：
- sendMessageThreadPoolNums：根据并发量调整（默认16）
- pullMessageThreadPoolNums：消费线程数（默认20）
存储优化：
- 使用SSD存储commitlog目录
- 配置mapedFileSizeCommitLog=1073741824（1G文件大小）

通过以上部署方案，开发者可以快速构建起高可用的RocketMQ消息队列服务。实际生产环境中，建议结合Kubernetes进行更精细的资源管理和自动伸缩，同时建立完善的监控告警体系，确保消息系统的稳定运行。

RocketMQ Docker部署全攻略：从环境搭建到集群运维