私网连接
私网连接
文档指南
请输入
- 文档首页
私网连接最佳实践通过PrivateLink私网访问火山方舟服务
复制全文
下载 pdf通过PrivateLink私网访问火山方舟服务
文档反馈
问问助手本文介绍如何通过私网连接实现方舟资源服务的私网访问。相较于公网访问，私网访问具备更高的安全性、服务稳定性与更低的流量成本，适用于对安全性、低延迟有较高要求的企业业务场景，如金融行业数据查询、企业内部系统集成等。
操作场景
某企业对安全性与时延要求严苛，各业务部门通过独立VPC实现隔离部署，并统一使用火山方舟服务。
数据规划
部门 | 资源类型 | 资源名称 | 网段/IP地址 |
业务A | VPC | VPC-A | 172.16.0.0/16 |
| 子网 | Subnet-A | 172.16.1.0/24 |
| 云服务器 | ECS-A | 172.16.1.11 |
业务B | VPC | VPC-B | 192.168.0.0/16 |
| 子网 | Subnet-B | 192.168.1.0/24 |
| 云服务器 | ECS-B | 192.168.1.11 |
业务C | VPC | VPC-C | 10.0.0.0/16 |
| 子网 | Subnet-C | 10.0.1.0/24 |
| 云服务器 | ECS-C | 10.0.1.11 |
准备工作
操作步骤
步骤一：配置方舟
- 创建API key
- 登录火山方舟控制台。
- 在顶部导航栏，选择地域。
- 在左侧导航树，选择API Key 管理。
- 单击创建 API Key按钮。
- 参考下表，配置相关参数。
-
- 单击创建按钮，完成操作。
- 开通模型服务
- 在左侧导航树，选择开通管理。
- 单击目标模型右侧的开通服务按钮。
- 单击确认开通与授权按钮，完成操作。
- 单击模型名称，进入模型详情页，记录Model ID。
- 配置环境变量
- 本文为以Linux为例，更多详情请参见火山方舟快速入门。
- 远程登录云服务器ECS-A、ECS-B、ECS-C。
- 在终端中，运行以下命令（替换your_api_key_here 为您的方舟API Key），配置 API Key 到环境变量。
- export ARK_API_KEY="your_api_key_here"
- 安装 SDK
- 本文为以Python为例，更多详情请参见火山方舟快速入门。
- 远程登录云服务器ECS-A、ECS-B、ECS-C。
- 在终端中，运行以下命令，安装方舟 SDK。
- pip install 'volcengine-python-sdk[ark]'
- 运行以下命令，安装 OpenAI SD。
- pip install openai
-
步骤二：配置私网连接
- 登录火山方舟控制台。
- 在顶部导航栏，选择地域。
- 在左侧导航树，选择网络配置。
- 根据页面提示，完成PrivateLink服务授权。
- 单击私有网络配置按钮。
- 参考下表，配置相关参数。
- 参数说明示例私有网络选择创建火山方舟服务终端节点的私有网络。VPC-A可用区及子网勾选需要建立连接的终端节点服务可用区并选择相应的子网。子网选定后，系统将自动为您创建一个终端节点网卡。系统为该网卡自动分配私网IP地址。
- 可用区A
- Subnet-A
- 单击确定按钮，完成操作。
重复本操作，依次配置VPC-A、VPC-B、VPC-C。
您也可以在私网连接控制台创建火山方舟的终端节点，添加方式为火山引擎服务，终端节点服务为com.volces.privatelink.cn-beijing.ark。
验证
- 测试联通性
- 远程登录ECS-A、ECS-B、ECS-C。
- 执行以下命令，测试网络连通性。
- curl https://ark.cn-beijing.volces.com/ping -H "Authorization: Bearer $ARK_API_KEY"
- 成功则返回如下：
-
- 执行以下命令，查看域名解析是否到PrivateLink。
- dig ark.cn-beijing.volces.com
- 成功则返回如下：
-
192.168.1.3 是本文示例VPC-B中终端节点网卡的私网IP地址。
- 发起API请求
- 执行如下命令，创建Python文件。
- vim test.py
- 按i键，输入如下内容。
- import osfrom volcenginesdkarkruntime import Arkclient = Ark(base_url='https://ark.cn-beijing.volces.com/api/v3',api_key=os.getenv('ARK_API_KEY'),)response = client.responses.create(model="doubao-seed-2-0-lite-260215",input="hello", # Replace with your prompt# thinking={"type": "disabled"}, # Manually disable deep thinking)print(response)
注意
- ARK_API_KEY：替换为您的API key。
- model：输入您开通的模型的ID。
- 执行以下命令，验证模型能力。
- python3 test.py
- 成功则返回如下：
-
最近更新时间：2026.03.20 15:54:42
这个页面对您有帮助吗？
有用
有用
无用
无用