火山引擎安全组 IP白名单配置 ​

适用场景 ​

火山引擎安全组可以关联到云服务器、云数据库 MySQL、Redis 等产品，统一控制这些资源的外网访问。

问题在于大多数团队和个人没有固定公网 IP：家庭宽带每次拨号都可能换 IP，办公网出口也会变。IP 一变，白名单就失效，服务连不上；把白名单开成 0.0.0.0/0 又等于没设防。

yunplus 的做法是：让跑在你机器上的客户端定时上报当前公网 IP，一旦发现变化，就自动调用火山引擎 OpenAPI 更新白名单规则。

前置条件 ​

配置之前需要准备好两样东西：

1. 访问秘钥 —— 火山引擎的 AccessKey，用于调用 OpenAPI。创建方法见 火山引擎获取API秘钥。
2. 客户端 —— 装在你要放行的那台机器上（家里的 NAS、办公室的服务器都可以），它负责上报公网 IP。

权限要求 ​

控制台在配置页面明确提示：需要授予该访问秘钥 VPCFullAccess 权限。权限不足时任务会执行失败，日志里通常会返回类似 AccessDenied 的错误。

在火山引擎的访问控制 IAM里，给这个子账号绑定上述策略即可。

配置流程 ​

操作步骤 ​

1. 访问 云产品白名单，点击右上角「新增」。

2. 在弹出的选择器中，左侧选择「火山引擎」，右侧选择「安全组」。

3. 填写配置表单。

4. 访问秘钥和地域：选择实例所在的云账号密钥和地域。选完地域后，下方的实例下拉才会加载出数据。

IP类型的选择：

5. 端口：填写要放行的端口。支持单个端口号，也支持端口范围（用 / 分隔），多个条目按 Enter 键逐条添加。

6. 客户端：选择一个已创建的客户端。这个客户端所在机器的公网 IP，就是要被加进白名单的 IP。
7. 备注：填写自定义说明，比如「家里宽带」「公司办公网」，方便日后区分。
8. 点击「提交」完成配置。

配置项速查 ​

验证配置 ​

第一步：看执行日志。 在白名单列表中点击对应规则的「执行日志」，可以看到最近 30 天的执行记录，包含客户端、执行时间、执行结果、执行 IP 地址和错误原因。

第二步：去火山引擎核对。 打开 私有网络控制台 →「安全组」→ 目标安全组 →「访问规则」，确认规则里出现了客户端上报的公网 IP。

第三步：实际连一次。 从客户端所在的那台机器发起访问，确认能连通。