RocketMQ单机部署

本文档适用于 RocketMQ 5.3.2 单机部署版本。

RocketMQ 安装部署指南（单机版）

当前为 单机部署，后期可根据需求扩展为集群部署。

一、单机部署

1. 下载与安装

下载

请访问 RocketMQ 官方下载页面 获取最新版本。

安装

解压缩与移动目录

# 解压安装包
unzip rocketmq-all-5.3.2-bin-release.zip

# 重命名目录
mv rocketmq-all-5.3.2-bin-release rocketmq-5.3.2

# 移动至指定安装目录
mv /rocketmq-5.3.2 /usr/local/software/apache/

配置环境变量

编辑配置文件：

vim /etc/profile

添加以下内容：

# RocketMQ 安装目录
export ROCKETMQ_HOME=/usr/local/software/apache/rocketmq-5.3.2

# NameServer 地址
export NAMESRV_ADDR=localhost:9876

# 添加 RocketMQ 的 bin 目录到系统 PATH
export PATH=$ROCKETMQ_HOME/bin:$PATH

立即生效：

source /etc/profile

修改启动配置

进入 bin 目录，分别修改以下脚本以调整 JVM 参数：

• runserver.sh：

JAVA_OPT="${JAVA_OPT} -server -Xms256m -Xmx256m -Xmn512m -XX:MetaspaceSize=128m -XX:MaxMetaspaceSize=320m"

• runbroker.sh：
  

• tools.sh：

JAVA_OPT="${JAVA_OPT} -server -Xms256m -Xmx256m -Xmn256m -XX:MetaspaceSize=128m -XX:MaxMetaspaceSize=128m"

2. 启动服务

进入 RocketMQ 安装目录下的 bin 目录：

启动 NameServer

# 创建日志目录
mkdir logs

# 启动 NameServer
nohup ./mqnamesrv > logs/mqnamesrv.out 2>&1 &

查看日志确认启动成功：

tail -f logs/mqnamesrv.out

日志中出现如下信息表示启动成功：

The Name Server boot success. serializeType=JSON

验证服务运行状态：

ps -ef | grep runserver

启动 Broker

nohup ./mqbroker -n localhost:9876 > logs/mqbroker.out 2>&1 &

查看日志确认启动成功：

tail -f logs/mqbroker.out

成功日志示例：

The broker[linux1, 192.168.150.129:10911] boot success. serializeType=JSON and name server is 192.168.150.129:9876

验证服务运行状态：

ps -ef | grep mqbroker

关闭服务

# 关闭 Broker
sh bin/mqshutdown broker

# 关闭 NameServer
sh bin/mqshutdown namesrv

---

二、控制台安装与启动

新版 RocketMQ 控制台已迁移至独立仓库：

• GitHub 地址：https://github.com/apache/rocketmq-dashboard

配置与启动