tencent cloud

注册配置治理

文档注册配置治理Polaris（北极星）迁移指南Nacos 迁移方案兼容 Nacos SDK 接入

兼容 Nacos SDK 接入

PDF
聚焦模式
字号
最后更新时间： 2026-05-08 14:26:45

使用场景

如果您希望使用 Polaris（北极星）代替 Nacos 作为新的注册配置中心，Polaris（北极星）提供了兼容 Nacos SDK 的接入方式，您仅需要更改应用中的 nacos-client 的服务端接入地址即可。无需修改代码或者 pom 依赖。

使用限制

1. 不同 Polaris（北极星）实例版本兼容的 Nacos SDK 开源版本及接入协议
Polaris（北极星）实例版本
兼容的 Nacos SDK 开源版本
备注
2.0.2以前版本（不含开发版）
不兼容

2.0.2（不含开发版）
兼容 Nacos SDK 2.x 使用 gRPC 协议接入
2.4及以后版本部分接口不支持，详见下述接口范围
2.1.0及更新版本（不含开发版）
兼容 Nacos SDK 2.x 使用 gRPC协议、HTTP 协议接入
兼容 Nacos SDK 1.x 使用 HTTP 协议接入
2.4及以后版本部分接口不支持，详见下述接口范围
2. Polaris（北极星）兼容的Nacos SDK 接口范围如下。
Nacos客户端接口
gRPC 协议
HTTP 协议
配置中心
获取配置
✔
✔
监听配置
✔
✔
删除监听
✔
✔
发布配置
✔
✔
删除配置
✔
✔
带监听配置的获取配置
×
-
带CAS的发布配置
×
-
注册中心
注册实例
✔
✔
注销实例
✔
✔
获取全部实例
✔
✔
获取健康或不健康实例列表
✔
✔
获取一个健康实例
✔
✔
监听服务
✔
✔
取消监听服务
✔
✔
批量注册服务实例
×
-
批量注销服务实例
×
-
带选择器的监听服务
×
-
取消带选择器的监听服务
×
-
分页获取服务列表
×
-
获取当前客户端所监听的服务列表
×
-
3. 功能点差异。
功能点
差异
备注
鉴权能力
默认写鉴权，读不鉴权

注册能力
Polaris（北极星）注册都会写入数据库

服务模型
Polaris（北极星）没有group概念
Polaris（北极星）服务名称由 Nacos group 字段值和 Nacos service 字段值拼接而成。
控制台
Nacos和Polaris（北极星）控制台存在差异。


使用说明

本文通过服务注册和配置管理两个场景介绍Polaris（北极星）接入的使用说明。

服务注册

1. Nacos 服务名和Polaris（北极星）服务名映射关系
Nacos 字段
Nacos 字段值
Polaris（北极星）字段
Polaris（北极星）字段值描述
namespace
默认命名空间/非默认命名空间 ID
namespace
default/命名空间名称。
group
DEFAULT_GROUP
service
Polaris（北极星）服务名称由 Nacos group 字段值和 Nacos service 字段值拼接而成。${group}__${service} 为最终的Polaris（北极星）服务名, 如果 group == DEFAULT_GROUP，则服务名为 ${service}。
service
DEFAULT_GROUP
service
cluster
DEFAULT
instance.metadata
作为实例标签的一部分, 实例标签 key 为 internal-nacos-cluster。
2. 修改服务端接入地址。
Spring Cloud Alibaba
原生 Nacos-Client
Dubbo
1. 修改应用配置文件：Polaris（北极星）服务端地址和服务端访问账密：
spring.cloud.nacos.username="可任意值，如：username"
spring.cloud.nacos.password="Polaris（北极星）用户/用户组的资源访问凭据 Token"
spring.cloud.nacos.discovery.server-addr="Polaris（北极星）服务端 IP:8848"
spring.cloud.nacos.discovery.namespace="Polaris（北极星）命名空间名称"
2. Polaris（北极星）用户/用户组的资源访问凭据 Token 查看方式：
登录 TSF 控制台，点击左侧菜单栏 Polaris（Polaris（北极星））后，选择目标实例进入目标Polaris（北极星）实例详情页。
单击侧边栏权限控制 ，选择用户或者用户组，单击查看Token 。

3. Polaris（北极星）服务端 IP 地址查看方式：
登录 TSF 控制台，点击左侧菜单栏 Polaris（Polaris（北极星））后，选择目标实例进入目标Polaris（北极星）实例详情页。
单击侧边栏引擎管理，在实例信息页可以查看IP地址。

1. 原生Nacos Client修改：Polaris（北极星）服务端地址和服务端访问账密：
Properties properties = new Properties();
properties.put(PropertyKeyConst.SERVER_ADDR, "Polaris（北极星）服务端IP:8848");
properties.put(PropertyKeyConst.NAMESPACE, "Polaris（北极星）命名空间名称");
properties.put(PropertyKeyConst.USERNAME, "可任意值");
properties.put(PropertyKeyConst.PASSWORD, "Polaris（北极星）用户/用户组的资源访问凭据 Token");

// 创建注册发现客户端
NamingService namingService = NacosFactory.createNamingService(properties);
2. Polaris（北极星）用户/用户组的资源访问凭据 Token 查看方式：
登录 TSE 控制台。
在 服务治理中心 下，点击侧边栏 权限控制 ，选择目标Polaris（北极星）引擎实例。
选择 用户 或者 用户组，点击 查看Token 。

3. Polaris（北极星）服务端 IP 地址查看方式：
登录 TSE 控制台。
在 服务治理中心 下，点击侧边栏 实例列表 ，点击目标Polaris（北极星）引擎实例。
在引擎详情页的实例信息页面，可以查看到引擎的访问地址。

1. 修改应用配置文件：Polaris（北极星）服务端地址和服务端访问账密：
dubbo
 registry
   address: nacos://Polaris（北极星）服务端IP:8848?username=可任意值&password=Polaris（北极星）用户/用户组的资源访问凭据 Token
   parameters.namespace: Polaris（北极星）命名空间名称
  metadata-report
    address: nacos://Polaris（北极星）服务端IP:8848
2. Polaris（北极星）用户/用户组的资源访问凭据 Token 查看方式：
登录 TSE 控制台。
在服务治理中心下，单击侧边栏权限控制 ，选择目标Polaris（北极星）引擎实例。
选择用户或者用户组，单击查看Token 。

3. Polaris（北极星）服务端 IP 地址查看方式：
登录 TSE 控制台。
在服务治理中心下，单击侧边栏实例列表 ，单击目标Polaris（北极星）引擎实例。
在引擎详情页的实例信息页面，可以查看到引擎的访问地址。


配置管理

1. Nacos 配置信息和Polaris（北极星）配置信息映射关系
Nacos 字段
Nacos 字段值
Polaris（北极星）字段
Polaris（北极星）字段值描述
namespace
默认命名空间/非默认命名空间 ID
namespace
default/命名空间名称
group
DEFAULT_GROUP
group
Polaris（北极星）配置分组名称
dataId
application.yaml
file_name
Polaris（北极星）配置文件名称
2. 修改服务端接入地址
Spring Cloud Alibaba
原生 Nacos-Client
Dubbo
1. 修改应用配置文件：Polaris（北极星）服务端地址和服务端访问账密：
spring.cloud.nacos.username="可任意值"
spring.cloud.nacos.password="Polaris（北极星）用户/用户组的资源访问凭据 Token"
spring.cloud.nacos.config.namespace="Polaris（北极星）命名空间名称"
spring.cloud.nacos.config.server-addr="Polaris（北极星）服务端IP:8848"
spring.cloud.nacos.config.group="Polaris（北极星）配置分组名称"
2. Polaris（北极星）用户/用户组的资源访问凭据 Token 查看方式：
登录 TSF 控制台，点击左侧菜单栏 Polaris（Polaris（北极星））后，选择目标实例进入目标Polaris（北极星）实例详情页。
单击侧边栏权限控制 ，选择用户或者用户组，单击查看Token 。

3. Polaris（北极星）服务端 IP 地址查看方式：
登录 TSF 控制台，点击左侧菜单栏 Polaris（Polaris（北极星））后，选择目标实例进入目标Polaris（北极星）实例详情页。
单击侧边栏引擎管理，在实例信息页可以查看IP地址。

1. 原生Nacos Client修改：Polaris（北极星）服务端地址和服务端访问账密：
Properties properties = new Properties();
properties.put(PropertyKeyConst.SERVER_ADDR, "Polaris（北极星）服务端IP:8848");
properties.put(PropertyKeyConst.NAMESPACE, "Polaris（北极星）命名空间名称");
properties.put(PropertyKeyConst.USERNAME, "可任意值");
properties.put(PropertyKeyConst.PASSWORD, "Polaris（北极星）用户/用户组的资源访问凭据 Token");

// 注册配置客户端
ConfigService configService = new NacosConfigService(properties);
2. Polaris（北极星）用户/用户组的资源访问凭据 Token 查看方式：
登录 TSE 控制台。
在服务治理中心下，单击侧边栏权限控制 ，选择目标Polaris（北极星）引擎实例。
选择用户或者用户组，单击查看Token 。

3. Polaris（北极星）服务端 IP 地址查看方式：
登录 TSE 控制台。
在服务治理中心下，单击侧边栏实例列表 ，单击目标Polaris（北极星）引擎实例。
在引擎详情页的实例信息页面，可以查看到引擎的访问地址。


1. 修改应用配置文件：Polaris（北极星）服务端地址和服务端访问账密：
dubbo
  config-center
    address: nacos://Polaris（北极星）服务端IP:8848
2. Polaris（北极星）用户/用户组的资源访问凭据 Token 查看方式：
登录 TSE 控制台。
在服务治理中心下，单击侧边栏权限控制 ，选择目标Polaris（北极星）引擎实例。
选择用户或者用户组，单击查看Token 。

3. Polaris（北极星）服务端 IP 地址查看方式：
登录 TSE 控制台。
在服务治理中心下，单击侧边栏实例列表 ，单击目标Polaris（北极星）引擎实例。
在引擎详情页的实例信息页面，可以查看到引擎的访问地址。


上一篇: 就近访问使用指南下一篇: Eureka协议使用命名空间

帮助和支持

本页内容是否解决了您的问题？

填写满意度调查问卷，共创更好文档体验。

文档反馈