摘要本文详细介绍了在 CentOS 7.9 系统上安装 RocketMQ 4.9.8 单机版的完整流程。内容涵盖环境准备Java 环境、系统要求、RocketMQ 下载与解压、NameServer 和 Broker 的配置方法、服务启动步骤、安装验证进程检查、管理工具使用、消息测试以及常见问题处理。按照本文步骤操作可快速搭建一个可用的 RocketMQ 单机环境适用于开发测试和学习场景。目录1. 环境准备2. 下载 RocketMQ3. 配置 RocketMQ3.1 配置 NameServer3.2 配置 Broker4. 启动 RocketMQ 服务4.1 启动 NameServer4.2 启动 Broker5. 验证安装5.1 检查进程5.2 使用管理工具可选5.3 发送和接收测试消息6. 常见问题与注意事项7. 总结1. 环境准备在开始安装 RocketMQ 之前请确保您的 CentOS 7.9 系统满足以下条件系统版本CentOS 7.9 64位Java 环境JDK 1.8 或更高版本推荐 OpenJDK 8内存建议至少 2GB 可用内存磁盘空间至少 10GB 可用空间网络确保防火墙开放 9876NameServer 端口和 10911Broker 端口首先验证 Java 环境java -version如果未安装 Java可以使用以下命令安装 OpenJDK 8sudo yum install -y java-1.8.0-openjdk-devel2. 下载 RocketMQRocketMQ 4.9.8 的官方二进制包可以从 Apache 镜像站或 GitHub 发布页面下载。使用 wget 下载如果系统没有 wget请先执行sudo yum install -y wgetwget https://archive.apache.org/dist/rocketmq/4.9.8/rocketmq-all-4.9.8-bin-release.zip下载完成后解压到指定目录unzip rocketmq-all-4.9.8-bin-release.zip -d /opt/ cd /opt/rocketmq-all-4.9.8-bin-release3. 配置 RocketMQRocketMQ 单机部署主要需要配置 NameServer 和 Broker。3.1 配置 NameServerNameServer 默认配置通常无需修改。如果需要调整 JVM 参数可以编辑bin/runserver.shvim bin/runserver.sh找到 JVM 参数设置行例如JAVA_OPT${JAVA_OPT} -server -Xms4g -Xmx4g -Xmn2g根据机器内存情况调整。对于测试环境可以设置为JAVA_OPT${JAVA_OPT} -server -Xms256m -Xmx256m -Xmn128m3.2 配置 BrokerBroker 的配置文件位于conf/broker.conf。复制一份示例配置并修改cp conf/broker.conf conf/broker-single.conf vim conf/broker-single.conf在配置文件中确保以下关键配置正确单机模式brokerClusterName DefaultCluster brokerName broker-a brokerId 0 deleteWhen 04 fileReservedTime 48 brokerRole ASYNC_MASTER flushDiskType ASYNC_FLUSH # NameServer 地址如果是本机使用内网 IP 或 127.0.0.1 namesrvAddr 127.0.0.1:9876 # Broker 监听地址使用本机 IP listenPort 10911 brokerIP1 你的本机IP地址 # 存储路径 storePathRootDir /home/rocketmq/store storePathCommitLog /home/rocketmq/store/commitlog storePathConsumeQueue /home/rocketmq/store/consumequeue storePathIndex /home/rocketmq/store/index注意请将brokerIP1、namesrvAddr为必须配置其他配置可以默认。同时创建存储目录sudo mkdir -p /home/rocketmq/store sudo chmod -R 777 /home/rocketmq/store同样如果需要调整 Broker 的 JVM 参数编辑bin/runbroker.shvim bin/runbroker.sh将内存参数调整为适合测试环境的配置例如JAVA_OPT${JAVA_OPT} -server -Xms512m -Xmx512m -Xmn256m4. 启动 RocketMQ 服务4.1 启动 NameServer进入 RocketMQ 目录以后台方式启动 NameServernohup sh bin/mqnamesrv /dev/null 21 查看启动日志确认是否成功tail -f ~/logs/rocketmqlogs/namesrv.log当看到The Name Server boot success.日志时表示 NameServer 启动成功。4.2 启动 Broker使用刚才创建的配置文件启动 Brokernohup sh bin/mqbroker -c conf/broker-single.conf /dev/null 21 或如果在 Broker 的 config 配置文件中没有配置 Name Server也可以在 Broker 启动参数中进行指定 nohup sh mqbroker -c ../conf/broker.conf -n 192.168.56.101:9876 autoCreateTopicEnabletrue 查看 Broker 启动日志tail -f ~/logs/rocketmqlogs/broker.log当看到The broker[broker-a, 你的IP:10911] boot success.日志时表示 Broker 启动成功。5. 验证安装5.1 检查进程使用 jps 命令查看 Java 进程jps -l应该能看到类似以下的进程xxxxx org.apache.rocketmq.namesrv.NamesrvStartup xxxxx org.apache.rocketmq.broker.BrokerStartup5.2 使用管理工具可选RocketMQ 提供了一个控制台Dashboard来监控集群状态。您可以单独下载并部署它# 下载 RocketMQ Dashboard wget https://github.com/apache/rocketmq-dashboard/archive/refs/tags/rocketmq-dashboard-1.0.0.zip unzip rocketmq-dashboard-1.0.0.zip cd rocketmq-dashboard-1.0.0 # 修改配置文件 src/main/resources/application.properties设置 namesrvAddr # 然后使用 Maven 打包运行 mvn clean package -Dmaven.test.skiptrue java -jar target/rocketmq-dashboard-1.0.0.jar访问http://服务器IP:8080即可查看管理界面。5.3 发送和接收测试消息RocketMQ 自带了一个简单的测试工具。首先设置环境变量export NAMESRV_ADDR127.0.0.1:9876然后使用以下命令测试消息发送sh bin/tools.sh org.apache.rocketmq.example.quickstart.Producer如果看到SendResult [sendStatusSEND_OK, ...]输出说明发送成功。在另一个终端启动消费者接收消息sh bin/tools.sh org.apache.rocketmq.example.quickstart.Consumer如果能看到消费到的消息内容则证明整个 RocketMQ 单机环境安装成功。6. 常见问题与注意事项内存不足如果启动失败并提示内存不足请检查并调整runserver.sh和runbroker.sh中的 JVM 参数。端口占用确保 9876 和 10911 端口未被其他程序占用。可以使用netstat -tlnp | grep 端口号检查。防火墙CentOS 7 默认启用 firewalld生产环境需要开放相关端口测试环境或者本机开发调试可以直接关闭防火墙sudo firewall-cmd --permanent --add-port9876/tcp sudo firewall-cmd --permanent --add-port10911/tcp sudo firewall-cmd --reload 关闭防火墙 sudo systemctl stop firewalld 禁止开机启动 sudo systemctl disable firewalld存储路径权限确保 RocketMQ 进程对/home/rocketmq/store目录有读写权限。停止服务可以使用以下命令停止服务# 停止 Broker sh bin/mqshutdown broker # 停止 NameServer sh bin/mqshutdown namesrv7. 总结本文详细介绍了在 CentOS 7.9 系统上单机安装 RocketMQ 4.9.8 的完整步骤包括环境准备、下载、配置、启动和验证。按照以上步骤操作您应该能够成功搭建一个可用的 RocketMQ 单机环境用于开发测试或学习。对于生产环境请务必参考官方文档进行集群部署和高可用配置。