### 使用 Docker 在 MacOS 上安装 RocketMQ #### 准备工作 确保已安装 Docker Desktop 并正常运行。对于 Mac M1 用户，需特别注意选择适合 ARM 架构的镜像。 #### 获取 RocketMQ 镜像及相关资源 可以通过克隆 GitHub 上 Apache 维护的 `rocketmq-docker` 仓库来获取最新的 RocketMQ Dockerfile 和相关配置文件[^1]： ```bash git clone https://github.com/apache/rocketmq-docker.git cd rocketmq-docker ``` 然而，考虑到 Mac M1 的特殊性以及可能出现的兼容性问题，建议直接从 Docker Hub 拉取经过验证的支持 arm64 版本的 RocketMQ 镜像[^4]: ```bash docker pull candice0630/rocketmq:5.0.0-alpine ``` #### 启动 NameServer 实例 利用上述下载好的镜像启动一个 RocketMQ 名字服务器实例: ```bash docker run -d \ --name rmqnamesrv \ -p 9876:9876 \ candice0630/rocketmq:5.0.0-alpine \ sh mqnamesrv ``` 此命令会以后台模式启动名字服务，并映射主机端口 9876 到容器内的相同端口以便外部访问。 #### 运行 Broker 节点 接着，还需要至少启动一个消息代理 (Broker)，它依赖于之前启动的名字服务器: ```bash docker run -d \ --name rmqbroker \ -e NAMESRV_ADDR=rmqnamesrv:9876 \ -p 10911:10911 \ -p 10909:10909 \ --link rmqnamesrv:namesrv \ candice0630/rocketmq:5.0.0-alpine \ sh mqbroker -n namesrv:9876 auto_create_topic_enable=true ``` 这里 `-e NAMESRV_ADDR=...` 设置了环境变量指定了名称服务器地址；而两个不同的端口号分别对应客户端通信和服务管理接口。 #### （可选）部署 RocketMQ 控制面板 如果希望拥有图形化的监控界面，则可以考虑引入 RocketMQ Console NG : ```bash docker pull candice0630/rocketmq-console-ng:2.0 docker run -d \ --name rmqconsole \ -p 8080:8080 \ -e "JAVA_OPTS=-Drmq.namesrv.addr=rmqnamesrv:9876" \ candice0630/rocketmq-console-ng:2.0 ``` 这样就可以通过浏览器访问 http://localhost:8080 来查看集群状态和性能指标了。 #### 整合 Spring Boot 应用程序 为了让基于 Java 的微服务能够发送或接收来自 RocketMQ 的消息，在项目的 pom.xml 文件里加入必要的依赖项之后，按照官方文档指导完成相应的编码工作即可实现两者之间的交互。