使用说明
命令行获取本机 IP

快速开始

命令行获取本机 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-Typetext/plain; charset=utf-8
响应体仅 IP 地址, 末尾带换行 \n, 不走统一 JSON 结构
Cache-Controlno-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.net
PowerShell
# PowerShell
(Invoke-RestMethod https://ip.czl.net).Trim()

限速

根路径按默认规则限速: 每个客户端 IP 每分钟 300 次。纯文本请求不计入使用统计。超限规则见 通用约定。