文档中心

云数据库 TiDB 版

私网连接

管理端点白名单

私网访问 TiDB 集群需通过终端节点实现，只有已添加至端点白名单的终端节点，才允许私网访问 TiDB 集群。云数据库 TiDB 版提供终端节点白名单能力，用于管控私网访问权限。本文将介绍终端节点白名单的添加、查看、修改与删除操作。

背景信息

终端节点是私网服务接入点，由服务使用方部署在自身 VPC 中，用于私网访问服务提供方资源。云数据库 TiDB 版作为服务提供方，支持通过终端节点私网接入 TiDB 集群，分为同 VPC 访问和跨 VPC 访问两种网络场景：

同 VPC 访问

创建集群时，系统会在 TiDB 集群所在 VPC 自动创建终端节点。该终端节点默认开启私有 DNS 且不可关闭，并自动添加至集群 default 端点白名单。您可访问终端节点页面，查看该终端节点信息。

说明

同一 VPC、同一 TiDB 终端节点服务仅允许 1 个终端节点启用私有 DNS，重复创建并开启私有 DNS 会报 DNS 名称冲突错误。如需多子网接入，在该终端节点内新增可用区子网即可，无需新建终端节点。

跨 VPC 访问

您需要在业务 VPC 自行创建终端节点，并将终端节点添加至 TiDB 集群端点白名单，完成配置后，即可实现跨 VPC 私网访问 TiDB 集群。创建终端节点的计费详情，请参见终端节点计费说明。

前提条件

已创建集群，且集群状态为 Active。

若为跨 VPC 访问，需已在 TiDB 集群同地域的业务 VPC 创建终端节点。如何创建终端节点，详情请参见创建接口终端节点。

注意事项

不可跨地域添加终端节点白名单。例如，北京地域的 TiDB 集群，仅允许同地域（北京）且已添加至集群端点白名单的终端节点访问；若将上海地域的终端节点加入该北京 TiDB 集群端点白名单时，添加操作将会失败。

云数据库 TiDB 版自动创建的 default 端点白名单不支持修改和删除操作。

操作步骤

添加端点白名单

登录云数据库 TiDB 版控制台。

在顶部菜单栏，选择集群所属的项目和地域。

单击目标集群名称。

单击左侧菜单栏的设置 > 网络。

单击添加规则，在添加端点白名单弹框中进行以下配置：

参数	说明
终端节点服务	单击图标，可复制终端节点服务名。说明若您未创建终端节点，在创建终端节点时，需要填写该 TiDB 集群的终端节点服务名以完成关联（示例：com.volces.privatelink.cn-beijing.tidb）。
白名单规则名称	云数据库 TiDB 版自动创建的白名单规则名称为 default。说明系统自动创建的 default 端点白名单，不支持修改和删除操作。不支持手动新增名称为 default 的端点白名单规则。不支持将其他端点白名单重命名为 default 。您手动添加的白名单规则，默认命名规则为 Allowlist_<创建日期>_<时>_<分>，支持自行修改白名单规则名称。
终端节点 ID	将终端节点 ID 填写至本输入框中。说明跨 VPC 访问场景：需先完成创建终端节点创建，再复制终端节点 ID。如何创建终端节点，详情请参见创建接口终端节点。同 VPC 访问场景：创建集群时系统已自动创建终端节点，并自动加入集群 default 端点白名单。您无需在此处手动添加，直接使用该自动创建的终端节点完成连接即可。

单击确认，即可完成添加终端节点白名单操作。

查看端点白名单

登录云数据库 TiDB 版控制台。

在顶部菜单栏，选择集群所属的项目和地域。

单击目标集群名称。

单击左侧菜单栏的设置 > 网络，即可进入端点白名单页面。在此页面您可查看白名单规则名称、端点名称/ID、安全组以及相关操作。

单击目标端点名称/ID，您可进入终端节点页面，查看或创建接口终端节点。

单击目标白名单规则安全组列的安全组名称，您可进入终端节点 > 安全组页面，查看目标白名单规则关联的安全组，包括默认安全组 default 以及您自行添加的安全组（如有）。

单击目标白名单规则操作列的 ···，您可进行修改和删除端点白名单操作。

说明

默认白名单规则 default 不支持修改和删除。

修改端点白名单

登录云数据库 TiDB 版控制台。

在顶部菜单栏，选择集群所属的项目和地域。

单击目标集群名称。

单击左侧菜单栏的设置 > 网络。

单击目标白名单规则操作列的 ··· > 修改。

说明

默认白名单规则 default 不支持修改。

参数
说明
白名单规则名称
填写白名单规则名称。
端点 ID
填写端点 ID。
说明
您可单击去复制，在终端节点页面查看已有端点 ID。

单击提交，即可完成修改操作。

删除端点白名单

登录云数据库 TiDB 版控制台。

在顶部菜单栏，选择集群所属的项目和地域。

单击目标集群名称。

单击左侧菜单栏的设置 > 网络。

单击目标白名单规则操作列的 ··· > 删除。

说明

默认白名单规则 default 不支持删除。

单击删除，即可完成删除操作。

最近更新时间：2026.10.23 17:03:15

这个页面对您有帮助吗？

有用

无用

参数	说明
白名单规则名称	填写白名单规则名称。
端点 ID	填写端点 ID。说明您可单击去复制，在终端节点页面查看已有端点 ID。