产品简介
产品计费
- 云原生网关
- Polaris（北极星）
- 公网流量价格说明
- 退费说明
- 欠费说明
云原生网关
- 云原生网关概述
- 快速入门
- 操作指南
- 迁移指南
- 实践教程
AI 网关
- AI 网关概述
- 版本生命周期管理
- 快速入门
- 操作指南
Polaris（北极星）
- 北极星概述
- 快速入门
- 实例管理
- 服务管理（注册中心）
- 服务治理（治理中心）
- 配置管理（配置中心）
- 可观测性
- 操作记录
- 权限控制（权限中心）
- Java 应用开发
- Go 应用开发
- 迁移指南
权限与标签
- 主账号获取访问授权
- 子账号获取访问授权
- 主账号获取云原生 API 网关授权
- 子账号获取云原生 API 网关访问授权
- 标签管理
API 参考
- History
- Introduction
- API Category
- Making API Requests
- Cloud-Native Gateway APIs
- Microservice Engine APIs
- Data Types
- Error Codes
联系我们

二次寻址

聚焦模式

字号

最后更新时间： 2026-05-08 14:26:45

操作场景
本文针对用户接入微服务引擎托管的Polaris（北极星）实例希望使用北极星客户端的二次寻址能力。
警告：
如果您使用的是腾讯自研上云（OA 版）北极星 SDK，由于 OA 版 SDK 默认开启了二次寻址机制（且无法关闭），请参见本文档接入。
当前仅针对腾讯自研上云（OA 版）北极星 SDK 的注册发现能力做了兼容性验证，其他治理能力无兼容性保证。
接入机制说明
北极星 SDK 二次寻址
北极星 SDK 的二次寻址机制依赖 polaris.discover 以及 polaris.healthcheck 这2个服务。因此需要在北极星引擎实例创建出来后，需在控制台手动创建 polaris.discover 以及 polaris.healthcheck 这两个服务。
为何需要用户手动创建
用户接入方式存在多 VPC、公网接入两类场景。不同的接入侧用户需要看到不同的服务端 IP，无法自动创建相关北极星系统服务。
前提条件
已创建 Polaris（北极星）实例，请参见 创建 Polaris（北极星）。
操作步骤
1. 登录 TSF 控制台。
2. 在左侧导航栏选择Polaris（北极星），进入实例引擎列表页。
3. 单击目标引擎的“ID”，进入基本信息页面。
4. 根据实例信息的控制台。
引擎实例未开启客户端公网访问
创建 polaris.discover 以及 polaris.healthcheck 服务
1. 在实例的基本信息页面中，记住访问地址中的每个 VPC 内网 IP 地址以及访问端口。
﻿
﻿
2. 针对每一个内网 VPC 的 IP 地址，在命名空间 Polaris 下创建服务 polaris.discover-{vpc 名称} 以及 polaris.healthcheck-{vpc 名称}。
 
﻿
﻿
3. 单击服务 polaris.discover-{vpc 名称}，进入到服务的实例页面，根据对应上述第一步所记录的 VPC 内网 IP 地址以及端口协议 grpc、trpc 分别创建实例。
 
﻿
﻿
4. 单击服务 polaris.healthcheck-{vpc 名称}，进入到服务的实例页面，根据对应上述第一步所记录的 VPC 内网 IP 地址以及端口协议 grpc、trpc 分别创建实例。
﻿
﻿
5. 按照上述步骤的操作，最终服务 polaris.discover-{vpc 名称} 的实例列表如下：
 
﻿
﻿
6. 按照上述步骤的操作，最终服务 polaris.healthcheck-{vpc 名称} 的实例列表如下：
﻿
﻿
注意：
如果只是单 VPC 接入的场景，则无需参考 polaris.discover-{vpc 名称} 这种命名规则，直接使用 polaris.discover 即可，polaris.healthcheck-{vpc 名称} 也直接使用 polaris.healthcheck 即可。
创建路由规则
创建路由规则示例
polaris.discover-{vpc 名称}
﻿
﻿
﻿
polaris.healthcheck-{vpc 名称}
﻿
﻿
﻿
polaris-java 接入相关配置文件说明
polaris.yaml 中按照下面示例进行配置二次寻址：
global:
  serverConnector:
    addresses:
      - '{对应 vpc 的内网接入地址}:8091'
  system:
    discoverCluster:
      namespace: Polaris
      service: 'polaris.discover-{vpc 名称}'
      sameAsBuiltin: false
    healthCheckCluster:
      namespace: Polaris
      service: 'polaris.healthcheck-{vpc 名称}'
      sameAsBuiltin: false
spring-cloud-tencent 接入相关配置文件说明
修改 bootstrap.yaml 或者 bootstrap.properties 文件：
spring:
  cloud:
    polaris:
      address: '{对应 vpc 的内网接入地址}:8091'
在 resources 下创建 polaris.yml 文件。
按照下面示例进行配置二次寻址：
global:
  system:
    #服务发现集群
    discoverCluster:
      namespace: Polaris
      service: 'polaris.discover-{vpc 名称}'
      sameAsBuiltin: false
    #健康检查集群
    healthCheckCluster:
      namespace: Polaris
      service: 'polaris.healthcheck-{vpc 名称}'
      sameAsBuiltin: false
trpc-java 接入相关配置文件说明
plugins:
  registry:
    polaris:
      heartbeat_interval: 3000
      protocol: grpc
      address_list: '{对应 vpc 的内网接入地址}:8091'
      global:
        system:
          discoverCluster:
            namespace: Polaris
            service: 'polaris.discover-{vpc 名称}'
            sameAsBuiltin: false
          healthCheckCluster:
            namespace: Polaris
            service: 'polaris.healthcheck-{vpc 名称}'
            sameAsBuiltin: false
  selector:
    polaris:
      protocol: grpc
      address_list: '{对应 vpc 的内网接入地址}:8091'
      global:
        system:
          discoverCluster:
            namespace: Polaris
            service: 'polaris.discover-{vpc 名称}'
            sameAsBuiltin: false
          healthCheckCluster:
            namespace: Polaris
            service: 'polaris.healthcheck-{vpc 名称}'
            sameAsBuiltin: false
引擎实例开启客户端公网访问
创建 polaris.discover 以及 polaris.healthcheck 服务
1. 在实例的基本信息页面中，记住访问地址中的公网 IP 地址以及访问端口。
 
﻿
﻿
2. 在命名空间 Polaris下创建服务 polaris.discover 以及 polaris.healthcheck。
 
﻿
﻿
3. 单击服务 polaris.discover，进入到服务的实例页面，根据客户端公网访问 IP 地址以及端口协议 grpc、trpc 分别创建实例。
 
﻿
﻿
4. 单击服务 polaris.healthcheck，进入到服务的实例页面，根据客户端公网访问 IP 地址以及端口协议 grpc、trpc 分别创建实例。
﻿
﻿
5. 按照上述步骤的操作，最终服务 polaris.discover 的实例列表如下：
 
﻿
﻿
6. 按照上述步骤的操作，最终服务 polaris.healthcheck 的实例列表如下：
﻿
﻿
创建路由规则
polaris.discover
﻿
﻿
﻿
polaris.healthcheck
﻿
﻿
﻿
polaris-java 接入相关配置文件说明
polaris.yaml 中按照下面示例进行配置二次寻址：
global:
  serverConnector:
    addresses:
      - '{对应公网接入地址}:8091'
  system:
    discoverCluster:
      namespace: Polaris
      service: polaris.discover
      sameAsBuiltin: false
    healthCheckCluster:
      namespace: Polaris
      service: polaris.healthcheck
      sameAsBuiltin: false
spring-cloud-tencent 接入相关配置文件说明
修改 bootstrap.yaml 或者 bootstrap.properties 文件。
spring:
  cloud:
    polaris:
      address: '{对应公网接入地址}:8091'
在 resources 下创建 polaris.yml 文件。
按照下面示例进行配置二次寻址：
global:
  system:
    discoverCluster:
      namespace: Polaris
      service: polaris.discover
      sameAsBuiltin: false
    healthCheckCluster:
      namespace: Polaris
      service: polaris.healthcheck
      sameAsBuiltin: false
trpc-java 接入相关配置文件说明
plugins:
  registry:
    polaris:
      heartbeat_interval: 3000
      protocol: grpc
      address_list: '{对应公网接入地址}:8091'
      global:
        system:
          discoverCluster:
            namespace: Polaris
            service: polaris.discover
            sameAsBuiltin: false
          healthCheckCluster:
            namespace: Polaris
            service: polaris.healthcheck
            sameAsBuiltin: false
  selector:
    polaris:
      protocol: grpc
      address_list: '{对应公网接入地址}:8091'
      global:
        system:
          discoverCluster:
            namespace: Polaris
            service: polaris.discover
            sameAsBuiltin: false
          healthCheckCluster:
            namespace: Polaris
            service: polaris.healthcheck
            sameAsBuiltin: false
﻿