核心用法
IPinfo 是一款基于 ipinfo.io API 的 IP 地理位置查询工具，支持通过简单的 HTTP 请求获取 IP 地址的详细地理信息。基础功能完全免费，无需注册即可使用（50,000 次/月）。
主要功能
- 单 IP 查询：
curl -s "https://ipinfo.io/8.8.8.8" - 本机 IP 查询：
curl -s "https://ipinfo.io/json" - Token 认证：支持通过
IPINFO_TOKEN环境变量或 URL 参数提升配额 - 字段提取：配合
jq工具可精准提取城市、国家、坐标等特定字段 - 批量处理：支持 Shell 循环批量查询多个 IP
- 多语言支持：提供 Python 示例代码，易于集成到自动化脚本
返回数据
JSON 格式包含：IP 地址、反向 DNS 主机名、城市、地区、国家代码（ISO 3166-1 alpha-2）、邮编、IANA 时区、经纬度坐标、组织/ASN 信息。
显著优点
1. 零门槛使用：免费 tier 无需 API Key，开箱即用
2. 数据全面：覆盖城市级定位、时区、ASN 等商业级字段
3. 轻量依赖：仅需 curl 和可选的 jq
4. 多场景适配：支持命令行快速查询、脚本批量处理、Python 集成
5. 灵活认证：环境变量、URL 参数、Dashboard UI 三种配置方式
潜在局限
- 精度限制：IP 地理定位基于数据库匹配，非 GPS 级精确，偏远地区误差可能较大
- 隐私合规：处理用户 IP 需符合 GDPR 等法规，存在数据跨境传输风险
- 速率限制：免费版约 1 req/sec，大规模实时查询需付费升级
- 无历史数据：仅支持实时查询，不保留查询记录
适合人群
- 运维工程师排查访问来源分布
- 安全分析师进行威胁地理画像
- 开发者实现基于 IP 的时区/语言自动适配
- 数据分析师清洗和丰富 IP 日志数据集
常规风险
- 数据外泄：查询请求明文传输目标 IP，敏感 IP 建议通过 HTTPS 并评估隐私影响
- API 依赖：服务可用性受制于 ipinfo.io，关键业务需设计降级方案
- Token 管理：付费 token 若硬编码存在泄露风险，推荐优先使用环境变量