Release Notes and Announcements
- new feature release notes
Product Overview
Purchase Guide
- Cloud Native Gateway
- Polaris
- Refund Instructions
- Overdue Payment Instructions
Cloud Native Gateway
- Cloud Native Gateway Overview
- Quick Start
- Operation Guide
- Migration Guide
- Practice Tutorial
AI Gateway
- AI Gateway Overview
- Version Lifecycle Management
- Quick Start
- Operation Guide
Polaris
- Polaris Overview
- Quick Start
- Instance Management
- Service Management (Registry)
- Service Governance (Governance Center)
- Configuration Management (Configuration Center)
- Observability
- Operation Record
- Permission Control (Permission Center)
- Java Application Development
- Go Application Development
- Migration Guide
Permissions and Tags
- Granting Access Permissions to a Root Account
- Granting Access Permissions to Sub-accounts
- Obtaining Cloud Native Gateway Authorization for the Root Account
- Granting Cloud Native Gateway Access Authorization to Sub-accounts
- Tag Management
FAQ
Contact Us

Compatible With Nacos SDK Integration

Focus Mode

Font Size

Last updated: 2026-05-07 18:12:23

Scenarios
If you wish to use Polaris (North Star) instead of Nacos as the new Register Configuration Center, Polaris (North Star) provides a Nacos-compatible access method. You only need to modify the server access address of the nacos-client in your application configuration without changing any code or pom dependencies.
Use Limits
1. Compatible Nacos SDK open-source versions and access protocols for different Polaris (North Star) instance versions
Polaris Instance Version
Compatible Open-Source Versions of Nacos SDK
Remarks
Versions prior to 2.0.2 (excluding development versions)
Incompatible
﻿
2.0.2 (excluding development versions)
Compatible with Nacos SDK 2.x using gRPC protocol for access
Part of the APIs in version 2.4 and later are not supported. For details, see the API scope below.
Versions 2.1.0 and later (excluding development versions)
Compatible with Nacos SDK 2.x using gRPC protocol and HTTP for access
Compatible with Nacos SDK 1.x using HTTP for access
Part of the APIs in version 2.4 and later are not supported. For details, see the API scope below.
2. Polaris (North Star) compatible Nacos SDK interface scope is as follows.
Nacos Client API
﻿
gRPC Protocol
HTTP protocol
Configuration center
Obtaining a configuration
✔
✔
﻿
Monitoring a configuration
✔
✔
﻿
Deleting monitoring
✔
✔
﻿
Releasing a configuration
✔
✔
﻿
Delete configurations
✔
✔
﻿
Obtaining a configuration with monitoring capability
×
-
﻿
Releasing a configuration with CAS
×
-
Registry
Registering an instance
✔
✔
﻿
Deregistering an instance
✔
✔
﻿
Obtaining all instances
✔
✔
﻿
Obtaining the list of healthy or unhealthy instances
✔
✔
﻿
Obtaining a healthy instance
✔
✔
﻿
Monitoring services
✔
✔
﻿
Canceling monitoring services
✔
✔
﻿
Registering service instances in batches
×
-
﻿
Deregistering service instances in batches
×
-
﻿
Monitoring services with selectors
×
-
﻿
Canceling monitoring services with selectors
×
-
﻿
Obtaining the service list with pagination
×
-
﻿
Obtaining the list of services monitored by the current client
×
-
3. Feature point differences.
Feature
Difference
Remarks
Authentication capability
By default, write operations require authentication, while read operations do not.
﻿
Registration capability
Polaris registrations are written to the database.
﻿
                         Service model
Polaris does not have the concept of groups.
Polaris service names are formed by concatenating the value of the Nacos group field and the value of the Nacos service field.
Console
There are differences between the Nacos console and the Polaris console.
﻿
Usage Instructions
This document introduces how to use Polaris (North Star) onboarding through two scenarios: service registration and configuration management.
Service registration
1. The mapping relationship between Nacos service names and Polaris (North Star) service names
Nacos Field
Nacos Field Value
Polaris Field
Polaris Field Value Description
namespace
Default namespace/non-default namespace ID
namespace
default/namespace name.
group
DEFAULT_GROUP
service
Polaris service names are formed by concatenating the value of the Nacos group field and the value of the Nacos service field. ${group}__${service} is the final Polaris service name. If group is DEFAULT_GROUP, the service name is ${service}.
service
DEFAULT_GROUP
service
﻿
cluster
DEFAULT
instance.metadata
As part of an instance tag, the instance tag key is internal-nacos-cluster.
2. Modify the server-side access IP address.
Spring Cloud Alibaba
Native Nacos-Client
Dubbo
1. Modify the application configuration file: Polaris (North Star) server IP address and server access credentials:
spring.cloud.nacos.username="can be any value, such as: username"
spring.cloud.nacos.password="Resource access credential Token for Polaris (North Star) user/user group"
spring.cloud.nacos.discovery.server-addr="Polaris (North Star) server IP:8848"
spring.cloud.nacos.discovery.namespace="Polaris (North Star) namespace name"
2. How to view the resource access credential Token for Polaris (North Star) users/user groups:
Log in to the TSF console, click Polaris (Polaris (North Star)) in the left sidebar, and then select the target instance to go to the details page of the target Polaris (North Star) instance.
Click Access Control in the sidebar, select User or User Group, and click View Token.
﻿
3. How to view the Polaris (North Star) server IP address:
Log in to the TSF console, click Polaris (Polaris (North Star)) in the left sidebar, and then select the target instance to go to the details page of the target Polaris (North Star) instance.
Click Engine Management in the sidebar. On the Instance Information page, you can view the IP address.
﻿
1. Native Nacos Client modification: Polaris (North Star) server IP address and server access credentials:
Properties properties = new Properties();
properties.put(PropertyKeyConst.SERVER_ADDR, "Polaris (North Star) server IP:8848");
properties.put(PropertyKeyConst.NAMESPACE, "Polaris (North Star) namespace name");
properties.put(PropertyKeyConst.USERNAME, "any value");
properties.put(PropertyKeyConst.PASSWORD, "Polaris (North Star) user/user group resource access credential Token");
﻿
// Create a registration discovery client
NamingService namingService = NacosFactory.createNamingService(properties);
2. How to view the resource access credential Token for Polaris (North Star) users/user groups:
Log in to the TSE console.
In the Service Governance Center, click Permission Control in the sidebar, and select the target Polaris (North Star) engine instance.
Select User or User Group, and click View Token.
﻿
3. How to view the Polaris (North Star) server IP address:
Log in to the TSE console.
In the Service Governance Center, click Instance List in the sidebar, and click the target Polaris (North Star) engine instance.
On the engine details page, the access IP address of the engine can be viewed on the Instance Information page.
﻿
1. Modify the application configuration file: Polaris (North Star) server IP address and server access credentials:
dubbo
 registry
   address: nacos://Polaris (North Star) server IP:8848?username=any value&password=Resource access credential Token for Polaris (North Star) user/user group
   parameters.namespace: Polaris (North Star) namespace name
  metadata-report
    address: nacos://Polaris (North Star) server IP:8848
2. How to view the resource access credential Token for Polaris (North Star) users/user groups:
Log in to the TSE console.
In the Service Governance Center, click Permission Control in the sidebar, and select the target Polaris (North Star) engine instance.
Select User or User Group, and click View Token.
﻿
3. How to view the Polaris (North Star) server IP address:
Log in to the TSE console.
In the Service Governance Center, click Instance List in the sidebar, and click the target Polaris (North Star) engine instance.
On the engine details page, the access IP address of the engine can be viewed on the Instance Information page.
﻿
Configuration Management
1. The mapping relationship between Nacos configuration information and Polaris (North Star) configuration information
Nacos Field
Nacos Field Value
Polaris Field
Polaris Field Value Description
namespace
Default namespace/non-default namespace ID
namespace
default/namespace name
group
DEFAULT_GROUP
group
Polaris configuration group name
dataId
application.yaml
file_name
Polaris configuration file name
2. Modify the Server-Side Access IP Address
Spring Cloud Alibaba
Native Nacos-Client
Dubbo
1. Modify the application configuration file: Polaris (North Star) server IP address and server access credentials:
spring.cloud.nacos.username="can be any value"
spring.cloud.nacos.password="Resource access credential Token for Polaris (North Star) user/user group"
spring.cloud.nacos.config.namespace="Polaris (North Star) namespace name"
spring.cloud.nacos.config.server-addr="Polaris (North Star) server IP:8848"
spring.cloud.nacos.config.group="Polaris (North Star) configuration group name"
2. How to view the resource access credential Token for Polaris (North Star) users/user groups:
Log in to the TSF console, click Polaris (Polaris (North Star)) in the left sidebar, and then select the target instance to go to the details page of the target Polaris (North Star) instance.
Click Access Control in the sidebar, select User or User Group, and click View Token.
﻿
3. How to view the Polaris (North Star) server IP address:
Log in to the TSF console, click Polaris (Polaris (North Star)) in the left sidebar, and then select the target instance to go to the details page of the target Polaris (North Star) instance.
Click Engine Management in the sidebar. On the Instance Information page, you can view the IP address.
﻿
1. Native Nacos Client modification: Polaris (North Star) server IP address and server access credentials:
Properties properties = new Properties();
properties.put(PropertyKeyConst.SERVER_ADDR, "Polaris (North Star) server IP:8848");
properties.put(PropertyKeyConst.NAMESPACE, "Polaris (North Star) namespace name");
properties.put(PropertyKeyConst.USERNAME, "any value");
properties.put(PropertyKeyConst.PASSWORD, "Polaris (North Star) user/user group resource access credential Token");
﻿
// Register a configuration client
ConfigService configService = new NacosConfigService(properties);
2. How to view the resource access credential Token for Polaris (North Star) users/user groups:
Log in to the TSE console.
In the Service Governance Center, click Permission Control in the sidebar, and select the target Polaris (North Star) engine instance.
Select User or User Group, and click View Token.
﻿
3. How to view the Polaris (North Star) server IP address:
Log in to the TSE console.
In the Service Governance Center, click Instance List in the sidebar, and click the target Polaris (North Star) engine instance.
On the engine details page, the engine's access IP address can be viewed on the Instance Information page.
﻿
﻿
1. Modify the application configuration file: Polaris (North Star) server IP address and server access credentials:
dubbo
  config-center
    address: nacos://Polaris (North Star) server IP:8848
2. How to view the resource access credential Token for Polaris (North Star) users/user groups:
Log in to the TSE console.
In the Service Governance Center, click Permission Control in the sidebar, and select the target Polaris (North Star) engine instance.
Select User or User Group, and click View Token.
﻿
3. How to view the Polaris (North Star) server IP address:
Log in to the TSE console.
In the Service Governance Center, click Instance List in the sidebar, and click the target Polaris (North Star) engine instance.
On the engine details page, the access IP address of the engine can be viewed on the Instance Information page.
﻿
﻿

Help and Support

Was this page helpful?

You can also Contact sales or Submit a Ticket for help.

Help us improve! Rate your documentation experience in 5 mins.

Feedback

tencent cloud

Service Registry and Governance

Compatible With Nacos SDK Integration

Scenarios

Use Limits

Usage Instructions

Service registration

Configuration Management

Help and Support

Polaris Instance Version	Compatible Open-Source Versions of Nacos SDK	Remarks
Versions prior to 2.0.2 (excluding development versions)	Incompatible
2.0.2 (excluding development versions)	Compatible with Nacos SDK 2.x using gRPC protocol for access	Part of the APIs in version 2.4 and later are not supported. For details, see the API scope below.
Versions 2.1.0 and later (excluding development versions)	Compatible with Nacos SDK 2.x using gRPC protocol and HTTP for access Compatible with Nacos SDK 1.x using HTTP for access	Part of the APIs in version 2.4 and later are not supported. For details, see the API scope below.

Nacos Client API			gRPC Protocol	HTTP protocol
Configuration center	Obtaining a configuration	✔	✔
		Monitoring a configuration	✔	✔
		Deleting monitoring	✔	✔
		Releasing a configuration	✔	✔
		Delete configurations	✔	✔
		Obtaining a configuration with monitoring capability	×	-
		Releasing a configuration with CAS	×	-
Registry	Registering an instance	✔	✔
		Deregistering an instance	✔	✔
		Obtaining all instances	✔	✔
		Obtaining the list of healthy or unhealthy instances	✔	✔
		Obtaining a healthy instance	✔	✔
		Monitoring services	✔	✔
		Canceling monitoring services	✔	✔
		Registering service instances in batches	×	-
		Deregistering service instances in batches	×	-
		Monitoring services with selectors	×	-
		Canceling monitoring services with selectors	×	-
		Obtaining the service list with pagination	×	-
		Obtaining the list of services monitored by the current client	×	-

Feature	Difference	Remarks
Authentication capability	By default, write operations require authentication, while read operations do not.
Registration capability	Polaris registrations are written to the database.
Service model	Polaris does not have the concept of groups.	Polaris service names are formed by concatenating the value of the Nacos group field and the value of the Nacos service field.
Console	There are differences between the Nacos console and the Polaris console.

Nacos Field	Nacos Field Value	Polaris Field	Polaris Field Value Description
namespace	Default namespace/non-default namespace ID	namespace	default/namespace name.
group	DEFAULT_GROUP	service	Polaris service names are formed by concatenating the value of the Nacos group field and the value of the Nacos service field. ${group}__${service} is the final Polaris service name. If group is DEFAULT_GROUP, the service name is ${service}.
service	DEFAULT_GROUP	service
cluster	DEFAULT	instance.metadata	As part of an instance tag, the instance tag key is internal-nacos-cluster.