ipinfo.im IP API 入门指南（免费，无需认证）

如果你需要查询 IP 地址数据——国家、城市、ISP、ASN 或时区——你可能发现大多数 IP API 都需要注册、申请密钥并管理请求限制。ipinfo.im 不同：完全免费，无需任何认证，几秒内即可上手。

什么是 ipinfo.im？

ipinfo.im 是一个面向开发者的免费 IP 情报 API，支持查询任意 IP 地址并返回结构化 JSON 数据，包含：

• IP 地址 — 查询的目标 IP
• 国家 — ISO 国家代码（如 US、CN、JP）
• 地区 — 省/州
• 城市 — 城市名称
• 组织/ISP — 互联网服务商或托管公司
• ASN — 自治系统编号
• 时区 — IANA 时区标识（如 Asia/Shanghai）
• 经纬度 — 近似地理坐标

无信用卡，无注册，无 API 密钥，只需 HTTP 请求。

基础 URL

https://ipinfo.im/api/

接口一：查询自身 IP

发送不带参数的请求，返回当前机器的 IP 信息：

curl https://ipinfo.im/api/

示例响应：

{
  "ip": "203.0.113.45",
  "country": "CN",
  "country_name": "China",
  "region": "Beijing",
  "city": "Beijing",
  "org": "AS4134 China Telecom",
  "asn": "AS4134",
  "timezone": "Asia/Shanghai",
  "latitude": 39.9042,
  "longitude": 116.4074
}

接口二：查询指定 IP

通过 ip 参数查询任意 IP 地址：

curl "https://ipinfo.im/api/?ip=8.8.8.8"

示例响应：

{
  "ip": "8.8.8.8",
  "country": "US",
  "country_name": "United States",
  "region": "California",
  "city": "Mountain View",
  "org": "AS15169 Google LLC",
  "asn": "AS15169",
  "timezone": "America/Los_Angeles"
}

接口三：只返回 IP 地址（纯文本）

curl https://ipinfo.im/api/ip

返回纯文本 IP，适合脚本使用：

203.0.113.45

在脚本中使用

Bash 脚本中获取自身 IP：

MY_IP=$(curl -s https://ipinfo.im/api/ip)
echo "当前 IP：$MY_IP"

Docker 容器中获取出口 IP：

docker run --rm alpine sh -c "apk add curl -q && curl -s https://ipinfo.im/api/ip"

CORS 支持

ipinfo.im API 支持跨域请求，可以在浏览器端直接调用：

const response = await fetch('https://ipinfo.im/api/');
const data = await response.json();
console.log(data.country); // "CN"

总结

ipinfo.im 提供了最简单的 IP 数据获取方式：

• ✅ 无需注册
• ✅ 无需 API 密钥
• ✅ 无请求频率限制（个人使用）
• ✅ JSON 响应，支持 CORS

---

立即体验 → ipinfo.im — 在浏览器中直接查看你的 IP 信息。