Windows 环境下 RocketMQ 安装与 NSSM 后台服务化部署指南

前言

在 Windows 系统下进行 RocketMQ 的开发与测试时，我们通常会遇到一个痛点：每次启动 RocketMQ 都会弹出多个命令行窗口，且一旦关闭窗口，服务就会随之停止。这不仅影响开发体验，在遇到系统重启时还需要手动重新拉起服务。本文将详细介绍如何在 Windows 环境下安装 RocketMQ，并利用 NSSM 工具将其注册为 Windows 系统服务，实现后台静默运行与开机自启。

一、 环境准备与 RocketMQ 安装

RocketMQ 是基于 Java 开发的，因此在开始之前，请确保你的系统已经正确安装并配置了 JDK 环境变量（推荐 JDK 1.8 及以上版本）。

1. 下载 RocketMQ：前往 RocketMQ 官方下载页面，下载最新稳定版的bin-release压缩包（例如rocketmq-all-5.x.x-bin-release.zip）。
2. 解压部署：将压缩包解压至一个没有中文和空格的目录下，例如D:\rocketmq。
3. 优化 JVM 内存参数（关键）：RocketMQ 默认的 JVM 内存配置较高（通常为 8G），在本地开发机上极易导致内存溢出（OOM）或服务闪退。我们需要修改D:\rocketmq\bin目录下的runserver.cmd和runbroker.cmd文件，找到JAVA_OPT相关的内存设置，将其调整为适合本地机器的配置，例如：

   set "JAVA_OPT=%JAVA_OPT% -server -Xms256m -Xmx256m -Xmn128m"

二、 引入 NSSM 服务管理工具

NSSM（Non-Sucking Service Manager）是一款轻量级的 Windows 服务封装工具，可以将任何普通的可执行程序或脚本注册为 Windows 系统服务。

前往 NSSM 官方网站 下载最新预发布版本（针对 Windows 10 及以上系统，推荐使用2.24-101或更新版本以避免服务启动失败的问题）。下载后解压，根据你的系统架构进入win64或win32目录即可直接使用，无需安装。

三、 注册 NameServer 与 Broker 服务

RocketMQ 的核心由 NameServer（路由中心）和 Broker（消息代理）两个独立进程组成，我们需要分别将它们注册为服务。

1. 注册 NameServer 服务

打开命令行（以管理员身份运行），进入 NSSM 的win64目录，执行以下命令：

nssm install RocketMQNameServer "D:\rocketmq\bin\mqnamesrv.cmd"

执行nssm edit RocketMQNameServer，在弹出的图形界面中，确认Application Path和Startup directory无误后，点击Install service。

2. 注册 Broker 服务

Broker 启动时需要指定 NameServer 的地址，因此需要额外添加启动参数：

nssm install RocketMQBroker "D:\rocketmq\bin\mqbroker.cmd"

执行nssm edit RocketMQBroker，在弹出的图形界面中，切换到Parameters栏，填入：

-n 127.0.0.1:9876 autoCreateTopicEnable=true

确认无误后点击Install service完成注册。

四、 核心配置：环境变量与服务依赖

1. 设置服务启动依赖

为了保证系统重启时 RocketMQ 能够按照正确的顺序启动（先 NameServer，后 Broker），我们需要为 Broker 设置服务依赖：

nssm set RocketMQBroker DependOnService RocketMQNameServer

2. 配置日志重定向（排错利器）

在nssm edit界面的I/O选项卡中，建议为两个服务分别配置Output (stdout)和Error (stderr)的日志文件路径（如D:\rocketmq\logs\namesrv_stdout.log）。当服务启动失败时，这些日志是排查问题的终极手段。

五、 服务管理与日常维护

完成上述配置后，RocketMQ 已经完美融入了 Windows 的服务管理体系。你可以通过Win + R输入services.msc在服务管理器中直观地查看、启动或停止服务。

同时，NSSM 也提供了便捷的命令行管理方式：

• 启动服务：nssm start RocketMQNameServer/nssm start RocketMQBroker
• 停止服务：nssm stop RocketMQBroker
• 重启服务：nssm restart RocketMQBroker
• 查看状态：nssm status RocketMQBroker

如果你希望它们在系统开机时自动运行，可以执行：

nssm set RocketMQNameServer Start SERVICE_AUTO_START nssm set RocketMQBroker Start SERVICE_AUTO_START

至此，你已经成功在 Windows 环境下搭建了一个稳定、可后台静默运行且支持开机自启的 RocketMQ 消息中间件，可以更加专注于业务代码的开发与测试。