快速开始
命令行获取本机 IP
在终端里直接 curl 根域名, 返回调用方的出口 IP, 纯文本一行:
Shell
$ curl https://ip.czl.net
203.0.113.7
$ curl -6 https://ip.czl.net
2001:db8::1返回内容
| 项目 | 值 |
|---|---|
| 方法 | GET / HEAD / |
Content-Type | text/plain; charset=utf-8 |
| 响应体 | 仅 IP 地址, 末尾带换行 \n, 不走统一 JSON 结构 |
Cache-Control | no-store, 每次都返回实时结果 |
| 失败 | HTTP 500, 响应体为 unable to determine client IP |
返回 IPv4 还是 IPv6 取决于请求所用的协议栈, 用 curl -4 / curl -6 指定。
按 User-Agent 分流
根域名同时是网页首页, 服务端按请求头决定返回什么:
| 请求 | 返回 |
|---|---|
| 命令行 / 脚本客户端: curl、wget、HTTPie、aria2、PowerShell、Python、Go、Java、Deno、Node (node-fetch / undici / axios)、Rust reqwest、PHP Guzzle、Perl 等 | 纯文本 IP |
| 浏览器、搜索引擎爬虫、空 UA、无法识别的 UA | 网页 |
任意客户端带 Accept: text/html | 网页 |
识别用的是白名单, 不是「非浏览器就返回纯文本」, 所以自定义了 User-Agent 的程序可能拿到网页。
用 curl 想看网页时加
-H "Accept: text/html"。程序里取自身 IP 且不方便控制 User-Agent 时, 改用/api/query拿 JSON, 读data.ip字段更稳妥。
脚本示例
Shell
# 写进变量
MY_IP=$(curl -fsS https://ip.czl.net)
echo "出口 IP: $MY_IP"
# 分别取 IPv4 / IPv6 (没有对应出口时 curl 会失败)
curl -4 -fsS https://ip.czl.net
curl -6 -fsS https://ip.czl.netPowerShell
# PowerShell
(Invoke-RestMethod https://ip.czl.net).Trim()限速
根路径按默认规则限速: 每个客户端 IP 每分钟 300 次。纯文本请求不计入使用统计。超限规则见 通用约定。