文档中心

私网连接

最佳实践

通过PrivateLink 私网调用火山引擎产品的OpenAPI

操作场景

业务系统部署在 VPC 内时，您可通过 PrivateLink 私网调用火山引擎产品的 OpenAPI，相比公网访问更安全、时延更低。

准备工作

注册火山引擎账号并完成实名认证。操作请参考注册账号、实名认证。

参考上图创建私有网络 VPC-X 和子网 Subnet-X。操作请参考创建私有网络。

参考上图创建云服务器 ECS-X 。操作请参考创建云服务器。

云服务器的安全组已放通443端口。操作请参考添加安全组规则。

获取目标产品 OpenAPI 对应的终端节点服务名称。本文以 IPv4 的 VPC 为例：com.volces.privatelink.cn-beijing.api.vpc

说明

终端节点服务名称格式：IPv4com.volces.privatelink.${Region}.api.${ServiceName}和双栈（IPv4/IPv6）com.volces.privatelink.${Region}.api-ipv6.${ServiceName}

${Region} 为目标产品所属的地域，例如华北2（北京）为 cn-beijing。调用目标 OpenAPI 的云服务器需要与目标产品在同一地域，不支持跨地域。

${ServiceName} 为目标产品的 servicecode，例如私有网络的servicecode为vpc。

选择的终端节点服务的网络协议需要调用目标 OpenAPI 的云服务器的网络协议一致，避免因协议不匹配导致请求失败。

终端节点服务的 IP 协议类型（IPv4/IPv6）必须与调用目标 OpenAPI 的云服务器保持一致，避免因协议不匹配导致请求失败。

操作步骤

登录终端节点控制台。

未完成跨服务角色授权的账号需执行以下步骤完成角色授权。

在跨服务访问请求页面，单击授权按钮。

说明

授权角色在访问控制服务的角色列表中显示，删除授权角色将导致跨服务访问不可用，请谨慎操作。

删除授权角色后，如需继续使用私网连接服务，请重新授权。

在左侧导航树，重新单击终端节点。

在顶部导航栏，选择目标项目和地域。

在接口终端节点页签，单击创建终端节点按钮，参考下表配置相关参数。

参数	说明	取值示例
基本信息
地域	选择终端节点所属的地域。	华北2（北京）
名称	输入终端节点的名称。	endpoint-1
类型	选择接口。	接口
项目	选择终端节点所属的项目。更多信息请参见项目管理。	default
终端节点服务
开启跨地域	是否开启跨地域。开启后，终端节点可以连接与其不同地域的终端节点服务。	不开启
添加方式	选择火山引擎服务。	火山引擎服务
终端节点服务	按名称搜索提前准备好的 OpenAPI 对应的终端节点服务名称。	com.volces.privatelink.cn-beijing.api.vpc
付费主体	终端节点账号。	终端节点账号
网络配置
私有网络	下拉选择终端节点所属的 VPC。	VPC-X
IP地址类型	终端节点的 IP 地址类型需要与所关联终端节点服务的 IP 地址类型保持一致。本文示例使用的终端节点服务为 IPv4 类型。	IPv4
可用区及子网	勾选终端节点的可用区和子网。仅支持勾选上文终端节点服务支持的可用区。子网选定后，系统将自动在子网内创建一张终端节点网卡。 IP地址分配方式：自动分配：系统会自动从已选子网中分配未被占用的 IP 地址。手动分配：手动输入已选子网中未被占用的IP地址。分配IP地址：分配一个 IP地址。	可用区A，Subnet- X \| 自动分配IP，192.168.1.0/24
安全组	选择需要与终端节点网卡关联的安全组。请确保终端节点网卡关联的安全组已放通100.64.0.0/10和fd00:64::/32，因为私网连接的健康检查请求源于该两段网段。	Default-sg
高级选项
私有DNS名称	需要启用DNS名称，启用后，原 OpenAPI 域名在该 VPC 内将解析至终端节点私网地址，业务侧通常无需修改 Host、证书校验及签名 Endpoint。	启用
标签	标签由一个键值对组成，用于资源的分类和搜索。更多关于标签的介绍请参见标签管理。	ep-key:ep-test

单击确认订单按钮，根据控制台指引查阅并确认相关协议。单击立即购买按钮，完成操作。

验证

查看在终端节点控制台确认实例状态为可用，连接状态为已连接。

登录云服务器ECS-X，使用目标服务的真实 OpenAPI 请求进行验证，确认接口可以正常返回。本文以查询VPC-X为例（示例已做脱敏处理，您可以前往API Explorer复制）。

curl -X 'GET' -H 'Content-Type: text/plain' 'https://vpc.cn-beijing.volcengine-api.com?Action=DescribeVpcAttributes&Version=2020-04-01&VpcId=vpc-********&X-Algorithm=HMAC-SHA256&X-Credential=AKTP********%2F20260717%2Fcn-beijing%2Fvpc%2Frequest&X-Date=20260717T085822Z&X-Expires=3600&X-NotSignBody=1&X-Security-Token=********&X-Signature=********&X-SignedHeaders=&X-SignedQueries=Action%3BVersion%3BX-Algorithm%3BX-Credential%3BX-Date%3BX-Expires%3BX-NotSignBody%3BX-Security-Token%3BX-SignedHeaders%3BX-SignedQueries'

预期返回查询 VPC-X 的信息。若未返回，请依次检查私有DNS名称是否开启、云服务器的安全组是否放通、终端节点安全组是否放通。

最近更新时间：2026.07.29 10:19:11

这个页面对您有帮助吗？

有用

无用