# 命令行获取本机 IP

在终端里直接 `curl` 根域名, 返回调用方的出口 IP, 纯文本一行:

```bash
$ 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`](/docs/query) 拿 JSON, 读 `data.ip` 字段更稳妥。

## 脚本示例

```bash
# 写进变量
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 次。纯文本请求不计入使用统计。超限规则见 [通用约定](/docs/conventions#限速)。
