diff --git a/deploy/rocketmq-5.5.0-cluster-1m2s/README.md b/deploy/rocketmq-5.5.0-cluster-1m2s/README.md
new file mode 100644
index 0000000..aaac2fd
--- /dev/null
+++ b/deploy/rocketmq-5.5.0-cluster-1m2s/README.md
@@ -0,0 +1,111 @@
+# RocketMQ 主从版
+
+https://rocketmq.apache.org/zh/docs/5.x/02quickstart/01quickstart
+
+### 部署方式
+
+```shell
+sh startup.sh
+```
+
+- 使用 `registry.cn-shanghai.aliyuncs.com/odboy/thirdrepo:apache-rocketmq-5.5.0` 镜像,1 个 NameServer + 3 个 Broker(`rmqbroker1` ASYNC_MASTER、`rmqbroker2` SLAVE id=1、`rmqbroker3` SLAVE id=2)+ Dashboard 2.1.0
+- 只编排 namesrv、broker、dashboard,不含 5.x 的 proxy 组件;如需 gRPC 协议接入,可在 `docker-compose.yml` 中按 5.x 官方示例自行补 `sh mqproxy`
+- 端口与 `deploy/rocketmq-4.9.7-cluster-1m2s` 完全相同、compose 项目名同为 `rocketmq`,同一台机器上只能启动其中一个
+- 容器内目录按 `apache/rocketmq:5.5.0` 惯例假定为 `/home/rocketmq/rocketmq-5.5.0`;如实际不符(`docker run --rm --entrypoint ls <镜像> /home/rocketmq` 可查看),需同步修改 `docker-compose.yml` 的挂载路径与 `broker.conf` 的 `storePath*`
+
+### Maven依赖
+
+```xml
+
+
+ org.apache.rocketmq
+ rocketmq-client
+ 5.5.0
+
+```
+
+### 生产者 官方示例
+
+```java
+import org.apache.rocketmq.client.producer.DefaultMQProducer;
+import org.apache.rocketmq.client.producer.SendResult;
+import org.apache.rocketmq.common.message.Message;
+
+public class ProducerExample {
+ public static void main(String[] args) throws Exception {
+ // 创建生产者实例,并设置生产者组名
+ DefaultMQProducer producer = new DefaultMQProducer("please_rename_unique_group_name");
+ // 设置 Name Server 地址,此处为示例,实际使用时请替换为真实的 Name Server 地址
+ producer.setNamesrvAddr("localhost:9876");
+ producer.start();
+
+ try {
+ // 创建消息实例,指定 topic、Tag和消息体
+ Message msg = new Message("TestTopic", "TagA", ("Hello RocketMQ").getBytes());
+ // 发送消息并获取发送结果
+ SendResult sendResult = producer.send(msg);
+ System.out.println("Message sent: " + new String(msg.getBody()));
+ System.out.println("Send result: " + sendResult);
+ } catch (Exception e) {
+ e.printStackTrace();
+ System.out.println("Message sending failed.");
+ } finally {
+ // 关闭生产者
+ producer.shutdown();
+ }
+ }
+}
+```
+
+### 消费者 官方示例
+
+```java
+import org.apache.rocketmq.client.consumer.DefaultMQPushConsumer;
+import org.apache.rocketmq.client.consumer.listener.ConsumeConcurrentlyContext;
+import org.apache.rocketmq.client.consumer.listener.ConsumeConcurrentlyStatus;
+import org.apache.rocketmq.client.consumer.listener.MessageListenerConcurrently;
+import org.apache.rocketmq.common.message.MessageExt;
+
+import java.util.List;
+
+public class ConsumerExample {
+ public static void main(String[] args) throws Exception {
+ // 创建消费者实例,并设置消费者组名
+ DefaultMQPushConsumer consumer = new DefaultMQPushConsumer("please_rename_unique_group_name");
+ // 设置 Name Server 地址,此处为示例,实际使用时请替换为真实的 Name Server 地址
+ consumer.setNamesrvAddr("localhost:9876");
+ // 订阅指定的主题和标签(* 表示所有标签)
+ consumer.subscribe("TestTopic", "*");
+
+ // 注册消息监听器
+ consumer.registerMessageListener(new MessageListenerConcurrently() {
+ @Override
+ public ConsumeConcurrentlyStatus consumeMessage(List msgs, ConsumeConcurrentlyContext context) {
+ for (MessageExt msg : msgs) {
+ System.out.println("Received message: " + new String(msg.getBody()));
+ }
+ return ConsumeConcurrentlyStatus.CONSUME_SUCCESS;
+ }
+ });
+
+ // 启动消费者
+ consumer.start();
+ System.out.println("Consumer started.");
+ }
+}
+```
+
+### 访问地址
+
+访问地址:http://127.0.0.1:8080(Dashboard 2.1.0)
+
+### 验证
+
+```shell
+docker logs -f rmq5broker1 # broker 启动日志
+docker exec rmq5namesrv sh mqadmin clusterList -n rmqnamesrv:9876 # 查看集群节点(应有 rmqbroker1/2/3)
+```
+
+### 示例
+
+
diff --git a/deploy/rocketmq-5.5.0-cluster-1m2s/broker-master/broker.conf b/deploy/rocketmq-5.5.0-cluster-1m2s/broker-master/broker.conf
new file mode 100644
index 0000000..c53351f
--- /dev/null
+++ b/deploy/rocketmq-5.5.0-cluster-1m2s/broker-master/broker.conf
@@ -0,0 +1,26 @@
+namesrvAddr=rmqnamesrv:9876
+brokerIP1=172.21.0.81
+brokerName=rmqbroker1
+brokerClusterName=rmqbroker
+brokerId=0
+autoCreateTopicEnable=false
+autoCreateSubscriptionGroup=true
+rejectTransactionMessage=false
+fetchNamesrvAddrByAddressServer=false
+storePathRootDir=/home/rocketmq/rocketmq-5.5.0/store
+storePathCommitLog=/home/rocketmq/rocketmq-5.5.0/store/commitlog
+flushIntervalCommitLog=1000
+flushCommitLogTimed=false
+deleteWhen=04
+fileReservedTime=72
+maxTransferBytesOnMessageInMemory=262144
+maxTransferCountOnMessageInMemory=32
+maxTransferBytesOnMessageInDisk=65536
+maxTransferCountOnMessageInDisk=8
+accessMessageInMemoryMaxRatio=40
+messageIndexEnable=true
+storePathMessageIndex=/home/rocketmq/rocketmq-5.5.0/store/index
+haMasterAddress=
+brokerRole=ASYNC_MASTER
+flushDiskType=ASYNC_FLUSH
+cleanFileForciblyEnable=true
diff --git a/deploy/rocketmq-5.5.0-cluster-1m2s/broker-slave1/broker.conf b/deploy/rocketmq-5.5.0-cluster-1m2s/broker-slave1/broker.conf
new file mode 100644
index 0000000..1573959
--- /dev/null
+++ b/deploy/rocketmq-5.5.0-cluster-1m2s/broker-slave1/broker.conf
@@ -0,0 +1,26 @@
+namesrvAddr=rmqnamesrv:9876
+brokerIP1=172.21.0.82
+brokerName=rmqbroker2
+brokerClusterName=rmqbroker
+brokerId=1
+autoCreateTopicEnable=false
+autoCreateSubscriptionGroup=true
+rejectTransactionMessage=false
+fetchNamesrvAddrByAddressServer=false
+storePathRootDir=/home/rocketmq/rocketmq-5.5.0/store
+storePathCommitLog=/home/rocketmq/rocketmq-5.5.0/store/commitlog
+flushIntervalCommitLog=1000
+flushCommitLogTimed=false
+deleteWhen=04
+fileReservedTime=72
+maxTransferBytesOnMessageInMemory=262144
+maxTransferCountOnMessageInMemory=32
+maxTransferBytesOnMessageInDisk=65536
+maxTransferCountOnMessageInDisk=8
+accessMessageInMemoryMaxRatio=40
+messageIndexEnable=true
+storePathMessageIndex=/home/rocketmq/rocketmq-5.5.0/store/index
+haMasterAddress=
+brokerRole=SLAVE
+flushDiskType=ASYNC_FLUSH
+cleanFileForciblyEnable=true
diff --git a/deploy/rocketmq-5.5.0-cluster-1m2s/broker-slave2/broker.conf b/deploy/rocketmq-5.5.0-cluster-1m2s/broker-slave2/broker.conf
new file mode 100644
index 0000000..6d01abc
--- /dev/null
+++ b/deploy/rocketmq-5.5.0-cluster-1m2s/broker-slave2/broker.conf
@@ -0,0 +1,26 @@
+namesrvAddr=rmqnamesrv:9876
+brokerIP1=172.21.0.83
+brokerName=rmqbroker3
+brokerClusterName=rmqbroker
+brokerId=2
+autoCreateTopicEnable=false
+autoCreateSubscriptionGroup=true
+rejectTransactionMessage=false
+fetchNamesrvAddrByAddressServer=false
+storePathRootDir=/home/rocketmq/rocketmq-5.5.0/store
+storePathCommitLog=/home/rocketmq/rocketmq-5.5.0/store/commitlog
+flushIntervalCommitLog=1000
+flushCommitLogTimed=false
+deleteWhen=04
+fileReservedTime=72
+maxTransferBytesOnMessageInMemory=262144
+maxTransferCountOnMessageInMemory=32
+maxTransferBytesOnMessageInDisk=65536
+maxTransferCountOnMessageInDisk=8
+accessMessageInMemoryMaxRatio=40
+messageIndexEnable=true
+storePathMessageIndex=/home/rocketmq/rocketmq-5.5.0/store/index
+haMasterAddress=
+brokerRole=SLAVE
+flushDiskType=ASYNC_FLUSH
+cleanFileForciblyEnable=true
diff --git a/deploy/rocketmq-5.5.0-cluster-1m2s/demo.png b/deploy/rocketmq-5.5.0-cluster-1m2s/demo.png
new file mode 100644
index 0000000..08bb02f
Binary files /dev/null and b/deploy/rocketmq-5.5.0-cluster-1m2s/demo.png differ
diff --git a/deploy/rocketmq-5.5.0-cluster-1m2s/docker-compose.yml b/deploy/rocketmq-5.5.0-cluster-1m2s/docker-compose.yml
new file mode 100644
index 0000000..3f5f835
--- /dev/null
+++ b/deploy/rocketmq-5.5.0-cluster-1m2s/docker-compose.yml
@@ -0,0 +1,97 @@
+version: '3.8'
+
+# 网桥 -> 方便相互通讯(172.21 段,避免与 rocketmq-4.9.7 的 172.20 冲突)
+networks:
+ rocketmq:
+ ipam:
+ driver: default
+ config:
+ - subnet: "172.21.0.0/24"
+
+services:
+ namesrv:
+ image: registry.cn-shanghai.aliyuncs.com/odboy/thirdrepo:apache-rocketmq-5.5.0
+ container_name: rmq5namesrv
+ restart: unless-stopped
+ ports:
+ - "9876:9876"
+ environment:
+ - JAVA_OPTIONS=-Xms512M -Xmx512M -Xmn256M
+ networks:
+ rocketmq:
+ ipv4_address: 172.21.0.80
+ command: sh mqnamesrv
+ broker1:
+ image: registry.cn-shanghai.aliyuncs.com/odboy/thirdrepo:apache-rocketmq-5.5.0
+ container_name: rmq5broker1
+ restart: unless-stopped
+ ports:
+ - "10909:10909"
+ - "10911:10911"
+ - "10912:10912"
+ environment:
+ - NAMESRV_ADDR=rmqnamesrv:9876
+ - ROCKETMQ_HOME=/home/rocketmq/rocketmq-5.5.0
+ - JAVA_OPTIONS=-Xms512M -Xmx512M -Xmn256M
+ volumes:
+ - ./broker-master/broker.conf:/home/rocketmq/rocketmq-5.5.0/conf/broker.conf
+ - ./broker-master/store:/home/rocketmq/rocketmq-5.5.0/store
+ depends_on:
+ - namesrv
+ networks:
+ rocketmq:
+ ipv4_address: 172.21.0.81
+ command: sh mqbroker -c /home/rocketmq/rocketmq-5.5.0/conf/broker.conf
+ broker2:
+ image: registry.cn-shanghai.aliyuncs.com/odboy/thirdrepo:apache-rocketmq-5.5.0
+ container_name: rmq5broker2
+ restart: unless-stopped
+ ports:
+ - "10809:10909"
+ - "10811:10911"
+ - "10812:10912"
+ environment:
+ - NAMESRV_ADDR=rmqnamesrv:9876
+ - JAVA_OPTIONS=-Xms512M -Xmx512M -Xmn256M
+ volumes:
+ - ./broker-slave1/broker.conf:/home/rocketmq/rocketmq-5.5.0/conf/broker.conf
+ - ./broker-slave1/store:/home/rocketmq/rocketmq-5.5.0/store
+ depends_on:
+ - namesrv
+ networks:
+ rocketmq:
+ ipv4_address: 172.21.0.82
+ command: sh mqbroker -c /home/rocketmq/rocketmq-5.5.0/conf/broker.conf
+ broker3:
+ image: registry.cn-shanghai.aliyuncs.com/odboy/thirdrepo:apache-rocketmq-5.5.0
+ container_name: rmq5broker3
+ restart: unless-stopped
+ ports:
+ - "10709:10909"
+ - "10711:10911"
+ - "10712:10912"
+ environment:
+ - NAMESRV_ADDR=rmqnamesrv:9876
+ - JAVA_OPTIONS=-Xms512M -Xmx512M -Xmn256M
+ volumes:
+ - ./broker-slave2/broker.conf:/home/rocketmq/rocketmq-5.5.0/conf/broker.conf
+ - ./broker-slave2/store:/home/rocketmq/rocketmq-5.5.0/store
+ depends_on:
+ - namesrv
+ networks:
+ rocketmq:
+ ipv4_address: 172.21.0.83
+ command: sh mqbroker -c /home/rocketmq/rocketmq-5.5.0/conf/broker.conf
+ rmqdashboard:
+ image: registry.cn-shanghai.aliyuncs.com/odboy/thirdrepo:apacherocketmq-rocketmq-dashboard-2.1.0
+ container_name: rmq5dashboard
+ ports:
+ - "8080:8082"
+ restart: always
+ depends_on:
+ - namesrv
+ networks:
+ rocketmq:
+ ipv4_address: 172.21.0.84
+ environment:
+ - JAVA_OPTS= -Xms256M -Xmx512M -Xmn128M -Drocketmq.namesrv.addr=rmqnamesrv:9876 -Dcom.rocketmq.sendMessageWithVIPChannel=false
diff --git a/deploy/rocketmq-5.5.0-cluster-1m2s/shutdown.sh b/deploy/rocketmq-5.5.0-cluster-1m2s/shutdown.sh
new file mode 100755
index 0000000..61cd2c3
--- /dev/null
+++ b/deploy/rocketmq-5.5.0-cluster-1m2s/shutdown.sh
@@ -0,0 +1,5 @@
+#!/usr/bin/env bash
+set -euo pipefail
+cd "$(dirname "$0")"
+
+docker-compose -f docker-compose.yml -p rocketmq down
diff --git a/deploy/rocketmq-5.5.0-cluster-1m2s/startup.sh b/deploy/rocketmq-5.5.0-cluster-1m2s/startup.sh
new file mode 100755
index 0000000..8537bcd
--- /dev/null
+++ b/deploy/rocketmq-5.5.0-cluster-1m2s/startup.sh
@@ -0,0 +1,7 @@
+#!/usr/bin/env bash
+set -euo pipefail
+cd "$(dirname "$0")"
+
+# 首次启动时 broker 以 root 运行,提前建好各 broker 的数据目录避免挂载后权限问题
+mkdir -p ./broker-master/store ./broker-slave1/store ./broker-slave2/store
+docker-compose -f docker-compose.yml -p rocketmq up -d
diff --git a/deploy/rocketmq-5.5.0-cluster-2m/README.md b/deploy/rocketmq-5.5.0-cluster-2m/README.md
new file mode 100644
index 0000000..65ce37e
--- /dev/null
+++ b/deploy/rocketmq-5.5.0-cluster-2m/README.md
@@ -0,0 +1,111 @@
+# RocketMQ 双主版
+
+https://rocketmq.apache.org/zh/docs/5.x/02quickstart/01quickstart
+
+### 部署方式
+
+```shell
+sh startup.sh
+```
+
+- 使用 `registry.cn-shanghai.aliyuncs.com/odboy/thirdrepo:apache-rocketmq-5.5.0` 镜像,1 个 NameServer + 2 个 Broker(`rmqbroker1`、`rmqbroker2` 均为 ASYNC_MASTER,无 Slave)+ Dashboard 2.1.0
+- 只编排 namesrv、broker、dashboard,不含 5.x 的 proxy 组件;如需 gRPC 协议接入,可在 `docker-compose.yml` 中按 5.x 官方示例自行补 `sh mqproxy`
+- 端口与 `deploy/rocketmq-4.9.7-cluster-2m` 完全相同、compose 项目名同为 `rocketmq`,同一台机器上只能启动其中一个
+- 容器内目录按 `apache/rocketmq:5.5.0` 惯例假定为 `/home/rocketmq/rocketmq-5.5.0`;如实际不符(`docker run --rm --entrypoint ls <镜像> /home/rocketmq` 可查看),需同步修改 `docker-compose.yml` 的挂载路径与 `broker.conf` 的 `storePath*`
+
+### Maven依赖
+
+```xml
+
+
+ org.apache.rocketmq
+ rocketmq-client
+ 5.5.0
+
+```
+
+### 生产者 官方示例
+
+```java
+import org.apache.rocketmq.client.producer.DefaultMQProducer;
+import org.apache.rocketmq.client.producer.SendResult;
+import org.apache.rocketmq.common.message.Message;
+
+public class ProducerExample {
+ public static void main(String[] args) throws Exception {
+ // 创建生产者实例,并设置生产者组名
+ DefaultMQProducer producer = new DefaultMQProducer("please_rename_unique_group_name");
+ // 设置 Name Server 地址,此处为示例,实际使用时请替换为真实的 Name Server 地址
+ producer.setNamesrvAddr("localhost:9876");
+ producer.start();
+
+ try {
+ // 创建消息实例,指定 topic、Tag和消息体
+ Message msg = new Message("TestTopic", "TagA", ("Hello RocketMQ").getBytes());
+ // 发送消息并获取发送结果
+ SendResult sendResult = producer.send(msg);
+ System.out.println("Message sent: " + new String(msg.getBody()));
+ System.out.println("Send result: " + sendResult);
+ } catch (Exception e) {
+ e.printStackTrace();
+ System.out.println("Message sending failed.");
+ } finally {
+ // 关闭生产者
+ producer.shutdown();
+ }
+ }
+}
+```
+
+### 消费者 官方示例
+
+```java
+import org.apache.rocketmq.client.consumer.DefaultMQPushConsumer;
+import org.apache.rocketmq.client.consumer.listener.ConsumeConcurrentlyContext;
+import org.apache.rocketmq.client.consumer.listener.ConsumeConcurrentlyStatus;
+import org.apache.rocketmq.client.consumer.listener.MessageListenerConcurrently;
+import org.apache.rocketmq.common.message.MessageExt;
+
+import java.util.List;
+
+public class ConsumerExample {
+ public static void main(String[] args) throws Exception {
+ // 创建消费者实例,并设置消费者组名
+ DefaultMQPushConsumer consumer = new DefaultMQPushConsumer("please_rename_unique_group_name");
+ // 设置 Name Server 地址,此处为示例,实际使用时请替换为真实的 Name Server 地址
+ consumer.setNamesrvAddr("localhost:9876");
+ // 订阅指定的主题和标签(* 表示所有标签)
+ consumer.subscribe("TestTopic", "*");
+
+ // 注册消息监听器
+ consumer.registerMessageListener(new MessageListenerConcurrently() {
+ @Override
+ public ConsumeConcurrentlyStatus consumeMessage(List msgs, ConsumeConcurrentlyContext context) {
+ for (MessageExt msg : msgs) {
+ System.out.println("Received message: " + new String(msg.getBody()));
+ }
+ return ConsumeConcurrentlyStatus.CONSUME_SUCCESS;
+ }
+ });
+
+ // 启动消费者
+ consumer.start();
+ System.out.println("Consumer started.");
+ }
+}
+```
+
+### 访问地址
+
+访问地址:http://127.0.0.1:8080(Dashboard 2.1.0)
+
+### 验证
+
+```shell
+docker logs -f rmq5broker1 # broker 启动日志
+docker exec rmq5namesrv sh mqadmin clusterList -n rmqnamesrv:9876 # 查看集群节点(应有 rmqbroker1/2)
+```
+
+### 示例
+
+
diff --git a/deploy/rocketmq-5.5.0-cluster-2m/broker-master1/broker.conf b/deploy/rocketmq-5.5.0-cluster-2m/broker-master1/broker.conf
new file mode 100644
index 0000000..c53351f
--- /dev/null
+++ b/deploy/rocketmq-5.5.0-cluster-2m/broker-master1/broker.conf
@@ -0,0 +1,26 @@
+namesrvAddr=rmqnamesrv:9876
+brokerIP1=172.21.0.81
+brokerName=rmqbroker1
+brokerClusterName=rmqbroker
+brokerId=0
+autoCreateTopicEnable=false
+autoCreateSubscriptionGroup=true
+rejectTransactionMessage=false
+fetchNamesrvAddrByAddressServer=false
+storePathRootDir=/home/rocketmq/rocketmq-5.5.0/store
+storePathCommitLog=/home/rocketmq/rocketmq-5.5.0/store/commitlog
+flushIntervalCommitLog=1000
+flushCommitLogTimed=false
+deleteWhen=04
+fileReservedTime=72
+maxTransferBytesOnMessageInMemory=262144
+maxTransferCountOnMessageInMemory=32
+maxTransferBytesOnMessageInDisk=65536
+maxTransferCountOnMessageInDisk=8
+accessMessageInMemoryMaxRatio=40
+messageIndexEnable=true
+storePathMessageIndex=/home/rocketmq/rocketmq-5.5.0/store/index
+haMasterAddress=
+brokerRole=ASYNC_MASTER
+flushDiskType=ASYNC_FLUSH
+cleanFileForciblyEnable=true
diff --git a/deploy/rocketmq-5.5.0-cluster-2m/broker-master2/broker.conf b/deploy/rocketmq-5.5.0-cluster-2m/broker-master2/broker.conf
new file mode 100644
index 0000000..8356d9a
--- /dev/null
+++ b/deploy/rocketmq-5.5.0-cluster-2m/broker-master2/broker.conf
@@ -0,0 +1,26 @@
+namesrvAddr=rmqnamesrv:9876
+brokerIP1=172.21.0.82
+brokerName=rmqbroker2
+brokerClusterName=rmqbroker
+brokerId=0
+autoCreateTopicEnable=false
+autoCreateSubscriptionGroup=true
+rejectTransactionMessage=false
+fetchNamesrvAddrByAddressServer=false
+storePathRootDir=/home/rocketmq/rocketmq-5.5.0/store
+storePathCommitLog=/home/rocketmq/rocketmq-5.5.0/store/commitlog
+flushIntervalCommitLog=1000
+flushCommitLogTimed=false
+deleteWhen=04
+fileReservedTime=72
+maxTransferBytesOnMessageInMemory=262144
+maxTransferCountOnMessageInMemory=32
+maxTransferBytesOnMessageInDisk=65536
+maxTransferCountOnMessageInDisk=8
+accessMessageInMemoryMaxRatio=40
+messageIndexEnable=true
+storePathMessageIndex=/home/rocketmq/rocketmq-5.5.0/store/index
+haMasterAddress=
+brokerRole=ASYNC_MASTER
+flushDiskType=ASYNC_FLUSH
+cleanFileForciblyEnable=true
diff --git a/deploy/rocketmq-5.5.0-cluster-2m/demo.png b/deploy/rocketmq-5.5.0-cluster-2m/demo.png
new file mode 100644
index 0000000..08bb02f
Binary files /dev/null and b/deploy/rocketmq-5.5.0-cluster-2m/demo.png differ
diff --git a/deploy/rocketmq-5.5.0-cluster-2m/docker-compose.yml b/deploy/rocketmq-5.5.0-cluster-2m/docker-compose.yml
new file mode 100644
index 0000000..81e01c9
--- /dev/null
+++ b/deploy/rocketmq-5.5.0-cluster-2m/docker-compose.yml
@@ -0,0 +1,77 @@
+version: '3.8'
+
+# 网桥 -> 方便相互通讯(172.21 段,避免与 rocketmq-4.9.7 的 172.20 冲突)
+networks:
+ rocketmq:
+ ipam:
+ driver: default
+ config:
+ - subnet: "172.21.0.0/24"
+
+services:
+ namesrv:
+ image: registry.cn-shanghai.aliyuncs.com/odboy/thirdrepo:apache-rocketmq-5.5.0
+ container_name: rmq5namesrv
+ restart: unless-stopped
+ ports:
+ - "9876:9876"
+ environment:
+ - JAVA_OPTIONS=-Xms512M -Xmx512M -Xmn256M
+ networks:
+ rocketmq:
+ ipv4_address: 172.21.0.80
+ command: sh mqnamesrv
+ broker1:
+ image: registry.cn-shanghai.aliyuncs.com/odboy/thirdrepo:apache-rocketmq-5.5.0
+ container_name: rmq5broker1
+ restart: unless-stopped
+ ports:
+ - "10909:10909"
+ - "10911:10911"
+ - "10912:10912"
+ environment:
+ - NAMESRV_ADDR=rmqnamesrv:9876
+ - ROCKETMQ_HOME=/home/rocketmq/rocketmq-5.5.0
+ - JAVA_OPTIONS=-Xms512M -Xmx512M -Xmn256M
+ volumes:
+ - ./broker-master1/broker.conf:/home/rocketmq/rocketmq-5.5.0/conf/broker.conf
+ - ./broker-master1/store:/home/rocketmq/rocketmq-5.5.0/store
+ depends_on:
+ - namesrv
+ networks:
+ rocketmq:
+ ipv4_address: 172.21.0.81
+ command: sh mqbroker -c /home/rocketmq/rocketmq-5.5.0/conf/broker.conf
+ broker2:
+ image: registry.cn-shanghai.aliyuncs.com/odboy/thirdrepo:apache-rocketmq-5.5.0
+ container_name: rmq5broker2
+ restart: unless-stopped
+ ports:
+ - "10809:10909"
+ - "10811:10911"
+ - "10812:10912"
+ environment:
+ - NAMESRV_ADDR=rmqnamesrv:9876
+ - JAVA_OPTIONS=-Xms512M -Xmx512M -Xmn256M
+ volumes:
+ - ./broker-master2/broker.conf:/home/rocketmq/rocketmq-5.5.0/conf/broker.conf
+ - ./broker-master2/store:/home/rocketmq/rocketmq-5.5.0/store
+ depends_on:
+ - namesrv
+ networks:
+ rocketmq:
+ ipv4_address: 172.21.0.82
+ command: sh mqbroker -c /home/rocketmq/rocketmq-5.5.0/conf/broker.conf
+ rmqdashboard:
+ image: registry.cn-shanghai.aliyuncs.com/odboy/thirdrepo:apacherocketmq-rocketmq-dashboard-2.1.0
+ container_name: rmq5dashboard
+ ports:
+ - "8080:8082"
+ restart: always
+ depends_on:
+ - namesrv
+ networks:
+ rocketmq:
+ ipv4_address: 172.21.0.83
+ environment:
+ - JAVA_OPTS= -Xms256M -Xmx512M -Xmn128M -Drocketmq.namesrv.addr=rmqnamesrv:9876 -Dcom.rocketmq.sendMessageWithVIPChannel=false
diff --git a/deploy/rocketmq-5.5.0-cluster-2m/shutdown.sh b/deploy/rocketmq-5.5.0-cluster-2m/shutdown.sh
new file mode 100755
index 0000000..61cd2c3
--- /dev/null
+++ b/deploy/rocketmq-5.5.0-cluster-2m/shutdown.sh
@@ -0,0 +1,5 @@
+#!/usr/bin/env bash
+set -euo pipefail
+cd "$(dirname "$0")"
+
+docker-compose -f docker-compose.yml -p rocketmq down
diff --git a/deploy/rocketmq-5.5.0-cluster-2m/startup.sh b/deploy/rocketmq-5.5.0-cluster-2m/startup.sh
new file mode 100755
index 0000000..9019588
--- /dev/null
+++ b/deploy/rocketmq-5.5.0-cluster-2m/startup.sh
@@ -0,0 +1,7 @@
+#!/usr/bin/env bash
+set -euo pipefail
+cd "$(dirname "$0")"
+
+# 首次启动时 broker 以 root 运行,提前建好各 broker 的数据目录避免挂载后权限问题
+mkdir -p ./broker-master1/store ./broker-master2/store
+docker-compose -f docker-compose.yml -p rocketmq up -d
diff --git a/deploy/rocketmq-5.5.0-standalone/README.md b/deploy/rocketmq-5.5.0-standalone/README.md
new file mode 100644
index 0000000..63c348a
--- /dev/null
+++ b/deploy/rocketmq-5.5.0-standalone/README.md
@@ -0,0 +1,111 @@
+# RocketMQ 单实例版
+
+https://rocketmq.apache.org/zh/docs/5.x/02quickstart/01quickstart
+
+### 部署方式
+
+```shell
+sh startup.sh
+```
+
+- 使用 `registry.cn-shanghai.aliyuncs.com/odboy/thirdrepo:apache-rocketmq-5.5.0` 镜像,单 NameServer + 单 Broker(ASYNC_MASTER)+ Dashboard 2.1.0
+- 只编排 namesrv、broker、dashboard,不含 5.x 的 proxy 组件;如需 gRPC 协议接入,可在 `docker-compose.yml` 中按 5.x 官方示例自行补 `sh mqproxy`
+- 端口与 `deploy/rocketmq-4.9.7-standalone` 完全相同、compose 项目名同为 `rocketmq`,同一台机器上只能启动其中一个
+- 容器内目录按 `apache/rocketmq:5.5.0` 惯例假定为 `/home/rocketmq/rocketmq-5.5.0`;如实际不符(`docker run --rm --entrypoint ls <镜像> /home/rocketmq` 可查看),需同步修改 `docker-compose.yml` 的挂载路径与 `broker.conf` 的 `storePath*`
+
+### Maven依赖
+
+```xml
+
+
+ org.apache.rocketmq
+ rocketmq-client
+ 5.5.0
+
+```
+
+### 生产者 官方示例
+
+```java
+import org.apache.rocketmq.client.producer.DefaultMQProducer;
+import org.apache.rocketmq.client.producer.SendResult;
+import org.apache.rocketmq.common.message.Message;
+
+public class ProducerExample {
+ public static void main(String[] args) throws Exception {
+ // 创建生产者实例,并设置生产者组名
+ DefaultMQProducer producer = new DefaultMQProducer("please_rename_unique_group_name");
+ // 设置 Name Server 地址,此处为示例,实际使用时请替换为真实的 Name Server 地址
+ producer.setNamesrvAddr("localhost:9876");
+ producer.start();
+
+ try {
+ // 创建消息实例,指定 topic、Tag和消息体
+ Message msg = new Message("TestTopic", "TagA", ("Hello RocketMQ").getBytes());
+ // 发送消息并获取发送结果
+ SendResult sendResult = producer.send(msg);
+ System.out.println("Message sent: " + new String(msg.getBody()));
+ System.out.println("Send result: " + sendResult);
+ } catch (Exception e) {
+ e.printStackTrace();
+ System.out.println("Message sending failed.");
+ } finally {
+ // 关闭生产者
+ producer.shutdown();
+ }
+ }
+}
+```
+
+### 消费者 官方示例
+
+```java
+import org.apache.rocketmq.client.consumer.DefaultMQPushConsumer;
+import org.apache.rocketmq.client.consumer.listener.ConsumeConcurrentlyContext;
+import org.apache.rocketmq.client.consumer.listener.ConsumeConcurrentlyStatus;
+import org.apache.rocketmq.client.consumer.listener.MessageListenerConcurrently;
+import org.apache.rocketmq.common.message.MessageExt;
+
+import java.util.List;
+
+public class ConsumerExample {
+ public static void main(String[] args) throws Exception {
+ // 创建消费者实例,并设置消费者组名
+ DefaultMQPushConsumer consumer = new DefaultMQPushConsumer("please_rename_unique_group_name");
+ // 设置 Name Server 地址,此处为示例,实际使用时请替换为真实的 Name Server 地址
+ consumer.setNamesrvAddr("localhost:9876");
+ // 订阅指定的主题和标签(* 表示所有标签)
+ consumer.subscribe("TestTopic", "*");
+
+ // 注册消息监听器
+ consumer.registerMessageListener(new MessageListenerConcurrently() {
+ @Override
+ public ConsumeConcurrentlyStatus consumeMessage(List msgs, ConsumeConcurrentlyContext context) {
+ for (MessageExt msg : msgs) {
+ System.out.println("Received message: " + new String(msg.getBody()));
+ }
+ return ConsumeConcurrentlyStatus.CONSUME_SUCCESS;
+ }
+ });
+
+ // 启动消费者
+ consumer.start();
+ System.out.println("Consumer started.");
+ }
+}
+```
+
+### 访问地址
+
+访问地址:http://127.0.0.1:8080(Dashboard 2.1.0)
+
+### 验证
+
+```shell
+docker logs -f rmq5broker # broker 启动日志
+docker exec rmq5namesrv sh mqadmin clusterList -n rmqnamesrv:9876 # 查看集群节点
+```
+
+### 示例
+
+
diff --git a/deploy/rocketmq-5.5.0-standalone/demo.png b/deploy/rocketmq-5.5.0-standalone/demo.png
new file mode 100644
index 0000000..08bb02f
Binary files /dev/null and b/deploy/rocketmq-5.5.0-standalone/demo.png differ
diff --git a/deploy/rocketmq-5.5.0-standalone/docker-compose.yml b/deploy/rocketmq-5.5.0-standalone/docker-compose.yml
new file mode 100644
index 0000000..5f7c1b4
--- /dev/null
+++ b/deploy/rocketmq-5.5.0-standalone/docker-compose.yml
@@ -0,0 +1,57 @@
+version: '3.8'
+
+# 网桥 -> 方便相互通讯(172.21 段,避免与 rocketmq-4.9.7 的 172.20 冲突)
+networks:
+ rocketmq:
+ ipam:
+ driver: default
+ config:
+ - subnet: "172.21.0.0/24"
+
+services:
+ namesrv:
+ image: registry.cn-shanghai.aliyuncs.com/odboy/thirdrepo:apache-rocketmq-5.5.0
+ container_name: rmq5namesrv
+ restart: unless-stopped
+ ports:
+ - "9876:9876"
+ environment:
+ - JAVA_OPTIONS=-Xms512M -Xmx512M -Xmn256M
+ networks:
+ rocketmq:
+ ipv4_address: 172.21.0.80
+ command: sh mqnamesrv
+ broker:
+ image: registry.cn-shanghai.aliyuncs.com/odboy/thirdrepo:apache-rocketmq-5.5.0
+ container_name: rmq5broker
+ restart: unless-stopped
+ ports:
+ - "10909:10909"
+ - "10911:10911"
+ - "10912:10912"
+ environment:
+ - NAMESRV_ADDR=rmqnamesrv:9876
+ - ROCKETMQ_HOME=/home/rocketmq/rocketmq-5.5.0
+ - JAVA_OPTIONS=-Xms512M -Xmx512M -Xmn256M
+ volumes:
+ - ./master/broker.conf:/home/rocketmq/rocketmq-5.5.0/conf/broker.conf
+ - ./master/store:/home/rocketmq/rocketmq-5.5.0/store
+ depends_on:
+ - namesrv
+ networks:
+ rocketmq:
+ ipv4_address: 172.21.0.81
+ command: sh mqbroker -c /home/rocketmq/rocketmq-5.5.0/conf/broker.conf
+ rmqdashboard:
+ image: registry.cn-shanghai.aliyuncs.com/odboy/thirdrepo:apacherocketmq-rocketmq-dashboard-2.1.0
+ container_name: rmq5dashboard
+ ports:
+ - "8080:8082"
+ restart: always
+ depends_on:
+ - namesrv
+ networks:
+ rocketmq:
+ ipv4_address: 172.21.0.82
+ environment:
+ - JAVA_OPTS= -Xms256M -Xmx512M -Xmn128M -Drocketmq.namesrv.addr=rmqnamesrv:9876 -Dcom.rocketmq.sendMessageWithVIPChannel=false
diff --git a/deploy/rocketmq-5.5.0-standalone/master/broker.conf b/deploy/rocketmq-5.5.0-standalone/master/broker.conf
new file mode 100644
index 0000000..3a3ae28
--- /dev/null
+++ b/deploy/rocketmq-5.5.0-standalone/master/broker.conf
@@ -0,0 +1,26 @@
+namesrvAddr=rmqnamesrv:9876
+brokerIP1=172.21.0.81
+brokerName=rmqbroker
+brokerClusterName=rmqbroker
+brokerId=0
+autoCreateTopicEnable=false
+autoCreateSubscriptionGroup=true
+rejectTransactionMessage=false
+fetchNamesrvAddrByAddressServer=false
+storePathRootDir=/home/rocketmq/rocketmq-5.5.0/store
+storePathCommitLog=/home/rocketmq/rocketmq-5.5.0/store/commitlog
+flushIntervalCommitLog=1000
+flushCommitLogTimed=false
+deleteWhen=04
+fileReservedTime=72
+maxTransferBytesOnMessageInMemory=262144
+maxTransferCountOnMessageInMemory=32
+maxTransferBytesOnMessageInDisk=65536
+maxTransferCountOnMessageInDisk=8
+accessMessageInMemoryMaxRatio=40
+messageIndexEnable=true
+storePathMessageIndex=/home/rocketmq/rocketmq-5.5.0/store/index
+haMasterAddress=
+brokerRole=ASYNC_MASTER
+flushDiskType=ASYNC_FLUSH
+cleanFileForciblyEnable=true
diff --git a/deploy/rocketmq-5.5.0-standalone/shutdown.sh b/deploy/rocketmq-5.5.0-standalone/shutdown.sh
new file mode 100755
index 0000000..61cd2c3
--- /dev/null
+++ b/deploy/rocketmq-5.5.0-standalone/shutdown.sh
@@ -0,0 +1,5 @@
+#!/usr/bin/env bash
+set -euo pipefail
+cd "$(dirname "$0")"
+
+docker-compose -f docker-compose.yml -p rocketmq down
diff --git a/deploy/rocketmq-5.5.0-standalone/startup.sh b/deploy/rocketmq-5.5.0-standalone/startup.sh
new file mode 100755
index 0000000..2ec164c
--- /dev/null
+++ b/deploy/rocketmq-5.5.0-standalone/startup.sh
@@ -0,0 +1,7 @@
+#!/usr/bin/env bash
+set -euo pipefail
+cd "$(dirname "$0")"
+
+# 首次启动时 broker 以 root 运行,提前建好数据目录避免挂载后权限问题
+mkdir -p ./master/store
+docker-compose -f docker-compose.yml -p rocketmq up -d