0kai/rocketmq

0kai/rocketmq:4.5.0 镜像文档

镜像概述

该镜像源自 rocketmqinc/rocketmq 并移除了卷（volume）的权限限制，解决了原镜像在挂载卷时可能出现的权限问题。适用于在Docker环境中快速部署和运行RocketMQ消息队列服务，保持了RocketMQ的核心功能，同时优化了Docker环境下的使用体验。

核心功能与特性

• 基于官方镜像优化：继承 rocketmqinc/rocketmq:4.5.0 的全部核心功能，包括NameServer和Broker服务
• 移除卷权限限制：解决原镜像挂载宿主机目录时的权限问题，简化卷挂载配置
• 支持自定义配置：可通过外部配置文件自定义Broker参数
• 环境变量配置：支持通过环境变量设置时区、JVM堆内存等参数

使用场景

• 开发环境中快速搭建RocketMQ服务进行消息队列功能测试
• 中小型应用的消息传递场景，如异步通信、服务解耦、流量削峰等
• 需要在Docker容器中部署RocketMQ的场景，避免权限配置复杂问题

使用方法

Docker Compose部署

推荐使用docker-compose进行部署，以下是完整配置示例：

yaml
version: "3"
services:
  namesrv:
    image: 0kai/rocketmq:4.5.0
    container_name: rmqnamesrv
    restart: always
    networks:
      - jiniutech  # 自定义网络，需提前创建或调整为现有网络
    ports:
      - 9876:9876  # NameServer默认端口
    environment:
      - TZ=Asia/Shanghai  # 设置时区
      - MAX_POSSIBLE_HEAP=209715200  # JVM最大堆内存（单位：字节）
    command: sh mqnamesrv  # 启动NameServer服务

  broker:
    image: 0kai/rocketmq:4.5.0
    container_name: rmqbroker
    restart: always
    networks:
      - jiniutech
    ports:
      - 10909:10909  # Broker内部通信端口
      - 10911:10911  # Broker客户端通信端口
    volumes:
      - /docker-volumes/broker:/root  # 挂载Broker数据目录
      - /docker-volumes/broker/broker.conf:/opt/broker.conf  # 挂载自定义配置文件
    environment:
      - TZ=Asia/Shanghai
      - MAX_POSSIBLE_HEAP=209715200
      - NAMESRV_ADDR=namesrv:9876  # 指定NameServer地址
    command: sh mqbroker -c /opt/broker.conf  # 使用自定义配置启动Broker
    depends_on:
      - namesrv  # 依赖NameServer服务，确保先启动NameServer

Broker配置文件（broker.conf）

需在宿主机创建broker.conf文件并挂载，示例配置如下：

conf
brokerClusterName=DefaultCluster  # 集群名称
brokerName=broker-a  # Broker名称
brokerId=0  # Broker ID，0表示主节点
deleteWhen=04  # 凌晨4点删除过期消息
fileReservedTime=48  # 消息文件保留时间（小时）
brokerRole=ASYNC_MASTER  # Broker角色：异步主节点
flushDiskType=ASYNC_FLUSH  # 刷盘方式：异步刷盘
#autoCreateTopicEnable=true  # 是否自动创建主题（默认关闭，根据需求开启）
#brokerIP1=10.30.85.202  # 对外暴露的IP地址（需根据实际环境修改）
#brokerIP2=10.30.85.202  # 主从同步IP地址（如需主从架构配置）
listenPort=10911  # 客户端通信端口

注意事项

• 外部连接配置：若需从Docker容器外部（如宿主机或其他服务器）连接RocketMQ，需在broker.conf中添加brokerIP1参数并指定宿主机IP，同时确保宿主机端口（***、9876）已开放
• 网络配置：示例中使用jiniutech网络，实际部署时需确保网络存在或修改为现有网络名称
• 资源配置：MAX_POSSIBLE_HEAP参数可根据实际需求调整JVM堆内存大小，单位为字节（示例为200MB）
• 数据持久化：通过挂载/docker-volumes/broker目录确保Broker数据持久化，避免容器重启后数据丢失