Docker Desktop的RocketMQ的搭建和使用
RocketMQ是阿里巴巴开源的分布式消息中间件，在微服务架构中扮演着重要角色。本文将详细介绍如何在Windows系统中使用Docker来搭建和使用RocketMQ环境。
环境准备
Docker安装
访问Docker官网下载Docker Desktop for Windows
安装完成后，确保Docker服务正常运行
打开PowerShell，运行以下命令验证安装：
1
docker --version
RocketMQ部署
拉取镜像
1 | # 拉取nameserver镜像 |
第二个之前拉过了，步骤和上面一样的
报错
Error response from daemon: Get “https://registry-1.docker.io/v2/“: net/http: request canceled while waiting for connection (Client.Timeout exceeded while awaiting headers)
翻译：错误响应来自守护程序：在等待连接时取消请求”https://registry-1.docker.io/v2/"：net/http：在等待标头时超过客户端超时
更改源可以解决报错问题
站内参考 我的文章 Docker Desktop 配置国内镜像源教程
创建挂载目录
在本地创建以下目录用于数据持久化：
1 | mkdir rocketmq |
在d盘打开PowerShell
配置Broker
在conf目录下创建broker.conf文件，内容如下：
1 | brokerClusterName = DefaultCluster |
| 参数名称 | 参数值 | 含义 | 作用 | 备注 |
|---|---|---|---|---|
| brokerClusterName | DefaultCluster | 指定 Broker 所属的集群名称 | 在分布式消息系统中，通过集群名称区分不同的集群。 | 该 Broker 属于名为“DefaultCluster”的集群。 |
| brokerName | broker-a | 指定 Broker 的名称 | 在集群中标识不同的 Broker 实例。 | 该 Broker 的名称为“broker-a”。 |
| brokerId | 0 | 指定 Broker 的 ID | 在集群中区分不同的 Broker 实例。 | 主 Broker 的 ID 为 0，表示该 Broker 是主 Broker。 |
| deleteWhen | 04 | 指定删除文件的时间 | 设置每天删除过期文件的时间点。 | 每天 4 点删除过期文件。 |
| fileReservedTime | 48 | 指定文件保留的时间 | 设置文件在磁盘上保留的时长（单位：小时）。 | 文件在磁盘上保留 48 小时，超过该时间的文件将被删除。 |
| brokerRole | ASYNC_MASTER | 指定 Broker 的角色 | 在主从复制模式下，定义 Broker 是主节点还是从节点。 | 表示该 Broker 是异步主节点，消息异步复制到从节点。 |
| flushDiskType | ASYNC_FLUSH | 指定磁盘刷新类型 | 设置消息写入磁盘的方式。 | 采用异步刷新磁盘的方式，消息先写入内存，再异步刷新到磁盘，性能较高。 |
| brokerIP1 | {your_host_ip} | 指定 Broker 的 IP 地址 | 设置 Broker 所在服务器的 IP 地址。 | 默认可能绑定到 127.0.0.1（仅限本机访问），需替换为实际服务器 IP 地址。 |
启动NameServer
1 | docker run -d --name rmqnamesrv \ |
在 Docker 命令中，{your_path} 是 你本地宿主机的自定义目录路径，用于将 RocketMQ 的日志和存储数据持久化到宿主机（而非容器内部）。你需要根据操作系统和实际需求替换成具体的路径。
windows 下
– 在 PowerShell 中并不是一个标准的参数前缀，因此解析器会将其误解为一元运算符。上面代码会报错
在rocketmq创建一个startNameServer.bat
1 | docker run -d --name rmqnamesrv -p 9876:9876 -v d:/rocketmq/data/namesrv/logs:/home/rocketmq/logs -v d:/rocketmq/data/namesrv/store:/home/rocketmq/store --memory "512m" apache/rocketmq:4.9.4 sh mqnamesrv |
保存通过PowerShell运行
1 | ./startNameServer |
参数说明
| 参数 | 含义 | 作用 |
|---|---|---|
docker run |
运行容器 | 命令用于启动一个新的容器。 |
-d |
后台运行 | 表示容器在后台运行，不占用当前终端。 |
--name rmqnamesrv |
指定容器名称 | 将容器命名为“rmqnamesrv”，便于管理和识别。 |
-p 9876:9876 |
端口映射 | 将宿主机的 9876 端口映射到容器的 9876 端口，使外部可以通过该端口访问容器内的服务。 |
-v {your_path}/data/namesrv/logs:/home/rocketmq/logs |
挂载日志目录 | 将宿主机的指定路径挂载到容器内的 /home/rocketmq/logs 目录，用于存储日志文件。 |
-v {your_path}/data/namesrv/store:/home/rocketmq/store |
挂载存储目录 | 将宿主机的指定路径挂载到容器内的 /home/rocketmq/store 目录，用于存储相关数据。 |
--memory "512m" |
限制容器内存 | 设置容器可用内存为 512MB，防止容器占用过多内存资源。 |
apache/rocketmq:4.9.4 |
指定镜像及版本 | 使用 Apache RocketMQ 的 4.9.4 版本镜像来创建容器。 |
sh mqnamesrv |
启动命令 | 在容器启动后执行 sh mqnamesrv 命令，用于启动 RocketMQ 的 NameServer 服务。 |
作用说明
-v {your_path}/data/namesrv/logs:/home/rocketmq/logs
将容器内的日志目录/home/rocketmq/logs挂载到宿主机的{your_path}/data/namesrv/logs目录。-v {your_path}/data/namesrv/store:/home/rocketmq/store
将容器内的存储目录/home/rocketmq/store挂载到宿主机的{your_path}/data/namesrv/store目录。
| 参数 | 替换内容 | 示例路径（宿主机） |
|---|---|---|
{your_path} |
你本地实际的根目录路径 | /home/user/rocketmq（Linux）C:\rocketmq（Windows） |
logs 和 store |
RocketMQ 的日志和持久化数据 | 自动关联到容器内对应目录 |
通过指定 {your_path}，你可以确保 RocketMQ 的数据不会因容器删除而丢失。
启动Broker
1 | docker run -d --name rmqbroker \ |
同上
window下创建startBroker并运行
1 | docker run -d --name rmqbroker -p 10911:10911 -p 10909:10909 -v d:/rocketmq/data/broker/logs:/home/rocketmq/logs -v d:/rocketmq/data/broker/store:/home/rocketmq/store -v d:/rocketmq/conf/broker.conf:/home/rocketmq/broker.conf --memory 1g --link rmqnamesrv:namesrv apache/rocketmq:4.9.4 sh mqbroker -c /home/rocketmq/broker.conf |
注意：在Windows环境下，Docker挂载路径必须使用绝对路径，且使用正斜杠(/)而不是反斜杠()。请确保d:/rocketmq目录下已经创建了相应的文件夹结构。
参数说明
| 参数 | 含义 | 作用 |
|---|---|---|
docker run |
运行容器 | 命令用于启动一个新的容器。 |
-d |
后台运行 | 表示容器在后台运行，不占用当前终端。 |
--name rmqbroker |
指定容器名称 | 将容器命名为“rmqbroker”，便于管理和识别。 |
-p 10911:10911 -p 10909:10909 |
端口映射 | 将宿主机的 10911 和 10909 端口分别映射到容器的对应端口，使外部可以通过这些端口访问容器内的服务。 |
-v {your_path}/data/broker/logs:/home/rocketmq/logs |
挂载日志目录 | 将宿主机的指定路径挂载到容器内的 /home/rocketmq/logs 目录，用于存储日志文件。 |
-v {your_path}/data/broker/store:/home/rocketmq/store |
挂载存储目录 | 将宿主机的指定路径挂载到容器内的 /home/rocketmq/store 目录，用于存储相关数据。 |
-v {your_path}/conf/broker.conf:/home/rocketmq/broker.conf |
挂载配置文件 | 将宿主机的指定配置文件挂载到容器内的 /home/rocketmq/broker.conf 路径，用于自定义 Broker 的配置。 |
--memory 1g |
限制容器内存 | 设置容器可用内存为 1GB，防止容器占用过多内存资源。 |
--link rmqnamesrv:namesrv |
容器间链接 | 将当前容器与名为“rmqnamesrv”的容器链接，并将“namesrv”作为别名解析到目标容器。 |
apache/rocketmq:4.9.4 |
指定镜像及版本 | 使用 Apache RocketMQ 的 4.9.4 版本镜像来创建容器。 |
sh mqbroker -c /conf/broker.conf |
启动命令 | 在容器启动后执行 sh mqbroker -c /conf/broker.conf 命令，用于启动 RocketMQ 的 Broker 服务，并指定配置文件路径。 |
启动管理控制台
1 | docker run -d --name rmqdashboard \ |
windows下创建 startrmqdashboard.bat
1 | docker run -d --name rmqdashboard -p 8080:8080 -e "JAVA_OPTS=-Drocketmq.namesrv.addr=rmqnamesrv:9876" --link rmqnamesrv:rmqnamesrv apacherocketmq/rocketmq-dashboard:latest |
参数说明
| 参数 | 含义 | 作用 |
|---|---|---|
docker run |
运行容器 | 命令用于启动一个新的容器。 |
-d |
后台运行 | 表示容器在后台运行，不占用当前终端。 |
--name rmqdashboard |
指定容器名称 | 将容器命名为“rmqdashboard”，便于管理和识别。 |
-p 8080:8080 |
端口映射 | 将宿主机的 8080 端口映射到容器的 8080 端口，使外部可以通过该端口访问容器内的服务。 |
-e "JAVA_OPTS=-Drocketmq.namesrv.addr=rmqnamesrv:9876" |
设置环境变量 | 设置 Java 应用的环境变量，指定 RocketMQ NameServer 的地址为 rmqnamesrv:9876。 |
--link rmqnamesrv:rmqnamesrv |
容器间链接 | 将当前容器与名为“rmqnamesrv”的容器链接，并将“rmqnamesrv”作为别名解析到目标容器。 |
apacherocketmq/rocketmq-dashboard:latest |
指定镜像及版本 | 使用 Apache RocketMQ Dashboard 的最新版本镜像来创建容器。 |
验证部署
访问控制台：http://localhost:8080
查看集群信息和broker状态
使用控制台发送测试消息
常见问题解决
| 问题 | 解决办法 |
|---|---|
| 内存不足 | 适当调整容器内存限制，修改JVM参数 |
| 连接超时 | 检查端口映射，确认防火墙设置，验证broker.conf中的IP配置 |
| 数据持久化 | 确保挂载目录权限正确，定期清理日志文件 |
| 性能优化建议 | 合理配置系统参数：调整commitLog大小，优化刷盘策略；监控指标：消息堆积、磁盘使用率、TPS/延迟 |
参考资料
本博客所有文章除特别声明外，均采用 CC BY-NC-SA 4.0 许可协议。转载请注明来源 诒森的博客！
相关推荐
2025-03-14
Docker Desktop RocketMQ Topic创建指南
本文将详细介绍如何在Docker Desktop环境下的RocketMQ中创建和管理Topic，包括命令行和控制台两种方式。 前置条件在开始之前，请确保： Docker Desktop已正确安装并运行 RocketMQ服务已在Docker中部署并正常运行 已安装RocketMQ控制台（可选） 使用命令行创建Topic1. 进入RocketMQ容器12345# 查看运行中的容器docker ps# 进入broker容器docker exec -it rmqbroker bash 2. 创建Topic12345# 基本语法mqadmin updateTopic -n localhost:9876 -t 主题名称 -c DefaultCluster# 示例：创建一个名为TestTopic的主题mqadmin updateTopic -n localhost:9876 -t TestTopic -c DefaultCluster mqadmin updateTopic -n localhost:9876 -t user_login_send_msg -c...
2025-03-14
Docker Desktop配置国内镜像源教程
在使用Docker时，由于默认镜像源在国外，经常会遇到下载速度慢、连接超时等问题。本文将详细介绍如何在Windows系统中为Docker配置国内镜像源，以提升镜像拉取速度。 常用国内镜像源1https://docker.1ms.run 清华镜像源 1https://docker.mirrors.tuna.tsinghua.edu.cn 阿里云镜像源 1https://mirrors.aliyun.com/docker-ce/linux/centos/docker-ce.repo 网易镜像源 1http://hub-mirror.c.163.com 中科大镜像源 1https://mirrors.ustc.edu.cn/docker-ce/linux/centos/docker-ce.repo 腾讯云镜像源 1https://mirror.ccs.tencentyun.com 配置步骤方法一：通过Docker Desktop配置打开Docker Desktop点击右上角的设置图标（⚙️）选择左侧菜单中的「Docker...
2025-03-14
Docker Desktop Redis连接指南
本文将详细介绍如何连接Docker Desktop中运行的Redis服务，包括命令行连接、代码示例和常见问题解决方案。 前置条件在开始连接之前，请确保： Docker Desktop已正确安装并运行 Redis容器已成功启动（参考Docker Desktop配置Redis） 已正确配置Redis的端口映射（默认6379） 命令行连接使用redis-cli 直接使用Docker命令连接： 1docker exec -it my-redis redis-cli 通过本地端口连接： 1redis-cli -h localhost -p 6379 如果设置了密码，添加认证： 1redis-cli -h localhost -p 6379 -a your_password 基本操作命令连接成功后，可以执行以下操作： 1234567891011121314# 测试连接ping# 设置键值对set mykey "Hello Redis"# 获取值get mykey# 查看所有键keys *# 删除键del...
2025-03-14
Docker Desktop 连接Idea
本文将详细介绍如何在IntelliJ IDEA中配置和使用Docker Desktop，帮助开发者更高效地进行容器化开发。 前置准备在开始配置之前，请确保： 已安装并正确运行Docker Desktop 已安装IntelliJ IDEA（Ultimate版本） Docker Desktop服务正常运行 IDEA Docker插件安装 打开IDEA，进入Settings/Preferences → Plugins 在Marketplace中搜索”Docker”，找到官方Docker插件 点击Install安装插件 重启IDEA使插件生效 连接配置Windows系统配置 打开IDEA，进入Settings/Preferences → Build, Execution, Deployment → Docker 点击+号添加新的Docker配置 选择Docker for Windows TCP连接设置（默认）： Engine API URL:...
2025-03-14
Docker Desktop的Redis的搭建和使用
本文将详细介绍如何在Docker Desktop环境下安装、配置和使用Redis，包括基本操作和进阶配置。 前置条件 Windows 10/11操作系统 已安装并正确配置Docker Desktop 确保Docker服务正在运行 Redis镜像获取拉取官方镜像1docker pull redis:latest 查看本地镜像1docker images | grep redis 创建Redis容器基本启动命令1docker run --name my-redis -p 6379:6379 -d redis 带配置启动命令12345docker run --name my-redis \ -p 6379:6379 \ -v /d/Redis/redis.conf:/etc/redis/redis.conf \ -v /d/Redis/data:/data \ -d redis redis-server /etc/redis/redis.conf 1docker run --name my-redis -p 6379:6379 -v...
2025-03-16
Docker Desktop 启动失败解决方案(Docker failed to initialize)
本文将详细介绍Docker Desktop启动失败的常见原因和解决方案，帮助开发者快速恢复Docker环境。 常见启动失败原因1. WSL相关问题 WSL未正确安装或版本不兼容 WSL2后端未启用 Linux内核组件缺失 2. 系统配置问题 虚拟化功能未开启 Windows功能组件缺失 系统资源不足 3. Docker服务问题 Docker服务未正常启动 配置文件损坏 端口冲突 解决方案1. WSL问题解决 检查WSL安装状态：1wsl --status 更新WSL：1wsl --update 确保WSL2是默认版本：1wsl --set-default-version 2 2. 系统配置检查 检查虚拟化： 打开任务管理器 切换到”性能”标签 查看”虚拟化”是否已启用 启用必要的Windows功能： Hyper-V 虚拟机平台 Windows子系统for Linux 系统资源优化： 关闭不必要的后台程序 检查内存使用情况 确保有足够的磁盘空间 3. Docker服务修复 重置Docker Desktop： 打开Docker...
评论
