# 概览

ip.czl.net 是免费的 IP 地理位置查询服务: 网页上直接查, 命令行一条 `curl` 拿本机出口 IP, 程序里调用 JSON 接口查任意 IPv4 / IPv6 的国家、省市区县、运营商、ASN、经纬度与代理特征。

> 接口无需注册、无需密钥, 支持 CORS 跨域, 按客户端 IP 限速。

## 服务地址

所有接口都在同一个域名下, 网页与接口同源:

```text
https://ip.czl.net
```

## 能做什么

| 用途 | 入口 | 文档 |
| --- | --- | --- |
| 网页查询某个 IP | `https://ip.czl.net/8.8.8.8` | [网页与 URL 查询](/docs/web-query) |
| 命令行取本机出口 IP | `curl https://ip.czl.net` | [命令行获取本机 IP](/docs/plain-text) |
| 查询 IP 归属 (JSON) | `GET` / `POST /api/query` | [IP 归属查询](/docs/query) |
| 查询 ASN 的上下游邻居 | `GET /api/bgp/:asn` | [BGP 邻居查询](/docs/bgp) |
| 检测调用方是否走代理 | `GET` / `POST /api/proxy-detection` | [代理检测](/docs/proxy-detection) |

统一响应格式、错误码与限速规则见 [通用约定](/docs/conventions), 每个字段背后的数据来自哪里见 [数据来源](/docs/data-sources)。

## 快速试一下

```bash
# 本机出口 IP (纯文本)
curl https://ip.czl.net

# 本机 IP 的归属信息 (JSON)
curl https://ip.czl.net/api/query

# 查询指定 IP
curl -X POST https://ip.czl.net/api/query \
  -H "Content-Type: application/json" \
  -d '{"ip": "8.8.8.8"}'
```

## 给 AI 的原文

每篇文档都有 Markdown 原文, 在页面地址后加 `.md` 即可读取 (如 `/docs/query.md`, 英文版为 `/docs/en/query.md`); 全部原文的索引见 [`/llms.txt`](/llms.txt)。接入型文档的页头有「用 AI 接入」按钮, 复制提示词发给 AI 即可生成调用代码。
