shumengya mail@smyhub.com

README.md

@@ -0,0 +1,52 @@
+# 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
+
+```bash
+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)
+
+```json
+{
+  "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"
+}
+```