使用说明
概览

快速开始

概览

本页目录

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

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

服务地址

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

Text
https://ip.czl.net

能做什么

用途入口文档
网页查询某个 IPhttps://ip.czl.net/8.8.8.8网页与 URL 查询
命令行取本机出口 IPcurl https://ip.czl.net命令行获取本机 IP
查询 IP 归属 (JSON)GET / POST /api/queryIP 归属查询
查询 ASN 的上下游邻居GET /api/bgp/:asnBGP 邻居查询
检测调用方是否走代理GET / POST /api/proxy-detection代理检测

统一响应格式、错误码与限速规则见 通用约定, 每个字段背后的数据来自哪里见 数据来源。

快速试一下

Shell
# 本机出口 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。接入型文档的页头有「用 AI 接入」按钮, 复制提示词发给 AI 即可生成调用代码。