## 操作场景业务系统部署在 VPC 内时，您可通过 PrivateLink 私网调用火山引擎产品的 OpenAPI，相比公网访问更安全、时延更低。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_099f3afbbc16fb3f7e30e24b511db0e3.png) ## 准备工作 1. 注册火山引擎账号并完成实名认证。操作请参考[注册账号](https://docs.volcengine.com/docs/6261/64925)、[实名认证](https://docs.volcengine.com/docs/6261/64935)。 2. 参考上图创建私有网络 VPC\-X 和子网 Subnet\-X。操作请参考[创建私有网络](https://docs.volcengine.com/docs/6401/69467)。 3. 参考上图创建云服务器 ECS\-X 。操作请参考[创建云服务器](https://docs.volcengine.com/docs/6396/67743)。 4. 云服务器的安全组已放通443端口。操作请参考[添加安全组规则](https://docs.volcengine.com/docs/6401/68895)。 5. 获取目标产品 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 的云服务器保持一致，避免因协议不匹配导致请求失败。

## 操作步骤 1. 登录[终端节点控制台](https://console.volcengine.com/pl/endpoints)。 2. 未完成跨服务角色授权的账号需执行以下步骤完成角色授权。 1. 在**跨服务访问请求**页面，单击**授权**按钮。

说明

*

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

*

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

2. 在左侧导航树，重新单击**终端节点**。 3. 在顶部导航栏，选择目标项目和地域。 4. 在**接口终端节点**页签，单击**创建终端节点**按钮，参考下表配置相关参数。 |参数 |说明 |取值示例 | |---|---|---| |**基本信息** ||| |地域 |选择终端节点所属的地域。 |华北2（北京） | |名称 |输入终端节点的名称。 |endpoint\-1 | |类型 |选择**接口**。 |接口 | |项目 |选择终端节点所属的项目。更多信息请参见[项目管理](https://www.volcengine.com/docs/6980/934555)。 |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。 |**启用** | |标签 |标签由一个键值对组成，用于资源的分类和搜索。更多关于标签的介绍请参见[标签管理](https://www.volcengine.com/docs/6980/1131772)。 |ep\-key:ep\-test | 5. 单击**确认订单**按钮，根据控制台指引查阅并确认相关协议。单击**立即购买**按钮，完成操作。 ## 验证 1. 查看在终端节点控制台确认实例状态为可用，连接状态为已连接。 2. 登录云服务器ECS\-X，使用目标服务的真实 OpenAPI 请求进行验证，确认接口可以正常返回。本文以查询VPC\-X为例（示例已做脱敏处理，您可以前往[API Explorer](https://api.volcengine.com/api-explorer?action=DescribeVpcAttributes&groupName=%E7%A7%81%E6%9C%89%E7%BD%91%E7%BB%9C&serviceCode=vpc&tab=3&version=2020-04-01)复制）。 ```JSON 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' ``` 3. 预期返回查询 VPC\-X 的信息。若未返回，请依次检查私有DNS名称是否开启、云服务器的安全组是否放通、终端节点安全组是否放通。