在Apache RocketMQ，域名服务器 被设计为协调分布式系统的每个组件，协调主要通过管理主题路由信息来实现。

管理由两部分组成：

• Broker定期更新保存在每一个NameServer中的元数据
• NameServer为客户端提供服务，包括生产者，消费者和带有最新路由信息的命令行客户端。

因此，在启动broker和客户端之前，我们需要告诉它们如何通过向NameServer提供域名服务地址列表访问name servers。

在Apache RocketMQ，可以通过四种方式完成。

编程方式

对于Broker，你可以在broker配置文件中指定namesrvAddr=name-server-ip1:port;name-server-ip2:port。
对于生产者和消费者，我们可以像下面提供 NameServer地址列表：

//生产者
DefaultMQProducer producer = new DefaultMQProducer("please_rename_unique_group_name");
producer.setNamesrvAddr("name-server1-ip:port;name-server2-ip:port");

//消费者
DefaultMQPushConsumer consumer = new DefaultMQPushConsumer("please_rename_unique_group_name");
consumer.setNamesrvAddr("name-server1-ip:port;name-server2-ip:port");

如果你使用 shell admin命令行，你可以像这样指定：

sh mqadmin command-name -n name-server-ip1:port;name-server-ip2:port -X OTHER-OPTION

简单例子：sh mqadmin -n localhost:9876 clusterList 假设在NameServer节点查询集群信息。

如果你已经将admin tool整合在你自己的仪表盘，你可以：

DefaultMQAdminExt defaultMQAdminExt = new DefaultMQAdminExt("please_rename_unique_group_name");
defaultMQAdminExt.setNamesrvAddr("name-server1-ip:port;name-server2-ip:port");

java选项

NameServer地址列表可以在启动前通过指定java选项 rocketmq.namesrv.addr 提供给你的应用。

环境变量

你可以export NAMESRV_ADDR 环境变量。如果设置，Brokers和clients将会检查和使用它。

HTTP Endpoint

如果你没有使用上面提到的方法指定NameServer地址列表，RocketMQ将访问以下http端点，每两分钟获取和更新NameServer地址列表，初始延迟10秒。

默认，端点：

http://jmenv.tbsite.net:8080/rocketmq/nsaddr

你可以覆盖jmenv.tbsite.net使用java选项：rocketmq.namesrv.domain，你也可以覆盖nsaddr 部分使用java选项：rocketmq.namesrv.domain.subgroup。

如果你在生产中已经运行RocketMQ，推荐使用这种方法，因为它提供了最大的灵活性。你可以根据NameServer系统的负载动态增加或移除NameServer节点，而无需重新启动brokers 和clients。

优先级

Programmatic Way > Java Options > Environment Variable > HTTP Endpoint