阿里云原生IP通常指区域内云平台直接分配并可绑定到网卡、负载均衡或容器的公网/弹性IP;IP API是用于程序化管理这些IP的接口(分配、释放、查询、绑定)。
在香港等多可用区场景,适合用于需要固定公网出口、弹性伸缩的云原生应用、对等互联或跨区域访问控制等场景。
主要包括:API驱动的生命周期管理、按需绑定到ENI/实例/服务、支持NAT/路由绑定以及配合安全组实现细粒度访问控制。
适合用于:对外暴露API网关、按Pod/Service做公网出入口、实现静态IP白名单、混合云互联等。
在选择时注意地域(例如香港)的配额与带宽计费策略。
下面给出一个通用的REST调用流程示例(示例使用AccessKey鉴权,实际生产建议使用RAM角色或STS临时凭证):
1)分配EIP(POST)示例:
{"curl -X POST 'https://api.alicloud.com/v1/ips' -H 'Authorization: Bearer {token}' -H 'Content-Type: application/json' -d '{\"region\":\"cn-hongkong\",\"bandwidth\":5}'}"
2)查询EIP(GET)示例:
{"curl -X GET 'https://api.alicloud.com/v1/ips?region=cn-hongkong' -H 'Authorization: Bearer {token}'"}
3)绑定EIP到网卡(PUT/POST)示例:
{"curl -X POST 'https://api.alicloud.com/v1/ips/{eip-id}/attach' -H 'Authorization: Bearer {token}' -d '{\"eniId\":\"eni-xxx\"}'"}
请确保调用者有相应的RAM权限(eip:Allocate、eip:Bind等)以及香港地域的配额未用尽。
实际API路径与字段以阿里云官方文档为准,上述示例为通用示意;生产环境推荐使用SDK并考虑重试与幂等。
避免在代码中硬编码AccessKey,使用RAM角色或STS并限定权限与有效期。
下面列出在香港区域从VPC到公网的常见配置步骤,适用于把EIP用于实例或容器出/入流量:
1)创建VPC并规划子网(例如10.0.0.0/16,子网10.0.1.0/24);
2)在子网中创建或分配ENI并将实例/容器连接到ENI;
3)创建路由表,添加0.0.0.0/0到NAT网关或绑定EIP的思路;
4)如果使用NAT网关,绑定公网带宽并将子网的默认路由转发到NAT;
5)配置安全组与ACL,开放必要端口并限制来源IP。
主路由:目标0.0.0.0/0 -> 下一跳:NAT网关(或已绑定EIP的网卡)。
注意带宽计费、峰值与突发策略,香港区域可能与内地不同计费。
不要忘记安全组方向规则(入站/出站),以及子网是否为公有/私有影响EIP绑定方式。
常见做法是使用云提供的CNI(如ENI模式或IPAM)并配合Service类型LoadBalancer或HostPort暴露公网流量:
步骤:
1)启用云厂商CNI插件(ACK自带或私有集群安装阿里云CNI);
2)配置IP池(IPAM),预留一部分EIP或内网IP用于Pod分配;
3)创建Service type=LoadBalancer,平台会自动申请EIP并将其绑定到LB或节点ENI上;
4)对于需要固定出口IP的Pod,可通过DaemonSet+SNAT或直接给Pod分配HostNetwork+ENI来实现。
在Service或Pod上添加云厂商指定的注解以控制EIP分配策略(注解内容以官方文档为准)。
使用kubectl describe service、kubectl get pod -o wide检查IP绑定与节点ENI状态。
尽可能使用云平台提供的托管LB和CNI,减少手工绑定EIP带来的复杂性。
常见问题包括EIP分配失败、EIP绑定后不可达、路由错误、权限不足等。排查要点如下:
1)检查API返回错误码与消息,确认配额与权限;
2)在控制台或通过API查看EIP状态、绑定对象与带宽;
3)网络连通性:使用ping、traceroute、telnet或curl从内网/外网分别测试;
4)检查路由表与NAT配置,确认0.0.0.0/0是否正确指向;
5)安全组与网络ACL:确认出/入方向策略未被阻断;
6)审计日志与监控:查看云审计、VPC Flow Logs以定位丢包或被拒流量。
示例:traceroute -n <公网IP>;curl -v http://<公网IP>:<端口>;云CLI describe-eip --region cn-hongkong --eip-id xxx。
如确认是绑定错误,可先解绑再重新绑定到正确ENI,或切换至备用EIP以快速恢复服务。
为EIP和NAT配置带宽与连接数告警,提前发现突发流量或资源耗尽问题。