如何查看Google Cloud Function实例所使用的IP地址?
核心排查误区
你在request对象的请求头里翻找实例IP没有收获,本质是排查方向错了:request对象承载的所有内容,都是调用方触发函数时传入的请求信息——比如X-Forwarded-For头存的是调用客户端的公网IP,所有请求头字段都不会附带函数自身运行实例的网络身份信息,自然找不到目标内容。
具体实现方法
Cloud Function的运行实例底层是GCP托管的标准计算虚拟机,所有实例都可以无鉴权访问内置的元数据服务器,直接读取当前实例的网络配置。
元数据接口调用方式
访问元数据服务器时必须携带固定请求头 Metadata-Flavor: Google,否则服务器会直接拒绝返回内容。
以Python SDK为例,可直接在函数逻辑中嵌入获取IP的代码:
import requests def your_cloud_function(request): # 元数据访问的固定要求请求头 meta_headers = {"Metadata-Flavor": "Google"} # 获取默认无VPC连接器场景下,当前实例的临时公网NAT出口IP nat_ip_path = "http://metadata.google.internal/computeMetadata/v1/instance/network-interfaces/0/access-configs/0/nat-ip" instance_public_ip = requests.get(nat_ip_path, headers=meta_headers, timeout=2).text # 获取当前实例的内网IP(无论是否配置VPC连接器均可正常返回) internal_ip_path = "http://metadata.google.internal/computeMetadata/v1/instance/network-interfaces/0/ip" instance_internal_ip = requests.get(internal_ip_path, headers=meta_headers, timeout=2).text return f"当前运行实例信息:公网出口IP {instance_public_ip},内网IP {instance_internal_ip}"
不同部署场景的IP差异说明
- 未配置VPC连接器的默认部署:上述接口拿到的公网IP是GCP为当前实例临时分配的出口地址,属于动态资源——函数冷启动、扩缩容生成新实例时,IP都会随机变化,没有长期固定性
- 配置了Serverless VPC访问连接器的部署:元数据接口返回的公网NAT IP不再是实际出网地址,实例流量会走VPC网络流转,最终公网出口IP由你给VPC配置的Cloud NAT地址池决定,这时候函数内部通过元数据拿到的是VPC内网分配的IP
相关注意事项
- 元数据服务器的固定本地地址为
169.254.169.254,属于实例内置本地网络,访问不会产生公网流量费用,也不需要额外配置访问权限 - 如果需要给函数配置长期固定的出口IP,必须通过VPC连接器绑定配置了固定公网地址的Cloud NAT,无法直接给动态弹性扩缩的函数实例分配固定公网IP
- 该方法和开发语言无关,只要能在函数运行环境内发起带正确请求头的HTTP请求,任意开发语言都可以实现相同的获取效果
内容的提问来源于stack exchange,提问作者Cagri Uysal
相关产品推荐
相关产品推荐

