Rocketmq Dashboard jar 包启动，使用启动命令参数，修改 NameServer 的地址

Rocketmq Dashboard jar 包启动，使用启动命令参数，修改 NameServer 的地址

你可以直接在启动 rocketmq-dashboard 的 JAR 包时，通过命令行参数来指定 NameServer 的地址。这种方式非常灵活，无需修改 JAR 包内部的配置文件。

以下是具体的启动命令格式、参数说明以及常见场景的示例。

核心启动命令

java -jar rocketmq-dashboard-{version}.jar --rocketmq.config.namesrvAddr=你的NameServer地址:9876

参数详解

• --rocketmq.config.namesrvAddr：这是 Dashboard 项目的专用配置项，用于指定 NameServer 的地址。
• 地址格式：IP:Port。如果你有多个 NameServer 节点，使用 逗号 , 分隔（注意：不是分号）。

常用启动示例

1. 单机模式 (Windows/Linux)
   假设你的 NameServer 运行在本地 9876 端口：

   java -jar rocketmq-dashboard-2.0.0.jar --rocketmq.config.namesrvAddr=127.0.0.1:9876

2. 指定端口启动
   如果你服务器的 8080 端口被占用了，可以使用 --server.port 参数修改 Dashboard 的访问端口（例如改为 8081）：

   java -jar rocketmq-dashboard-2.0.0.jar --server.port=8081 --rocketmq.config.namesrvAddr=127.0.0.1:9876

3. 集群模式
   如果你的 RocketMQ 集群配置了多个 NameServer（例如在 192.168.1.10 和 192.168.1.11 上），请使用逗号连接：

   java -jar rocketmq-dashboard-2.0.0.jar --rocketmq.config.namesrvAddr=192.168.1.10:9876,192.168.1.11:9876

4. Linux 后台静默启动
   在生产环境或 Linux 服务器上，通常需要后台运行并记录日志：

   nohup java -jar rocketmq-dashboard-2.0.0.jar
   --rocketmq.config.namesrvAddr=192.168.1.10:9876
   --server.port=8080 > dashboard.log 2>&1 &

💡 常见问题与提示

1. 参数拼写注意：

   • 在较新的版本（如 2.0.0+）中，参数通常是 namesrvAddr。
   • 在部分旧版本或特定分支中，可能是 namesrvAddrs（多一个 s）。如果一个不生效，可以尝试另一个。
   • 多个地址之间推荐使用逗号 , 分隔，部分旧版本使用分号 ; 可能会导致控制台界面显示异常。

2. 连接不上？

   • 防火墙：确保你的 Dashboard 服务器能通过网络访问 NameServer 的 9876 端口。
   • 配置覆盖：命令行参数的优先级通常高于 JAR 包内的 application.properties 文件，所以直接写在命令里是最保险的。

3. Broker 配置：

   • 请注意，这里的参数是配置 Dashboard 去连接哪里。你还需要确保你的 Broker 本身也正确配置了 namesrvAddr 并已启动，否则 Dashboard 登录后会显示为空或连接失败。