cf-ip-geo (Cloudflare Workers)

一个基于 Cloudflare Workers 的轻量 HTTP API：返回访问者的 公网 IP 与 Cloudflare 边缘侧注入的 地理/网络信息（request.cf）。

公网 IP 优先取 CF-Connecting-IP 请求头；地理信息来自 request.cf（本地 dev 环境可能为空）。

Endpoints

• GET /：首页文档（附带一个 GET /api?pretty=1 的实时示例）
• GET /api：返回 JSON（支持 ?pretty=1）
• GET /ipv4：返回 JSON（仅允许 IPv4 连接；否则 400，支持 ?pretty=1）
• GET /ipv6：返回 JSON（仅允许 IPv6 连接；否则 400，支持 ?pretty=1）

所有 API 路径默认启用 CORS：Access-Control-Allow-Origin: *

Examples

curl https://<your-domain>/api?pretty=1
curl -4 https://<your-domain>/ipv4?pretty=1
curl -6 https://<your-domain>/ipv6?pretty=1

说明：是否走 IPv4/IPv6 由客户端网络与 DNS 决定（浏览器常用 Happy Eyeballs 策略），服务端无法把一次 IPv4 请求强制切到 IPv6；命令行测试请使用 curl -6。

Response (/api)

{
  "ip": "203.0.113.10",
  "ipVersion": "ipv4",
  "userAgent": "...",
  "geo": {
    "country": "CN",
    "region": "Beijing",
    "regionCode": "BJ",
    "city": "Beijing",
    "postalCode": "",
    "timezone": "Asia/Shanghai",
    "continent": "AS",
    "latitude": "39.90",
    "longitude": "116.40"
  },
  "network": {
    "asn": 4134,
    "asOrganization": "CHINANET",
    "colo": "HKG",
    "httpProtocol": "HTTP/2"
  },
  "ts": "2026-01-27T12:34:56.000Z"
}