核心用法
geo-ip 是一个轻量级命令行工具，利用 ipinfo.io 的公开 API 实现 IP 地理位置查询。支持两种调用模式：
1. 查询指定 IP：geo-ip <ip-address> —— 获取目标 IP 的详细地理信息
2. 查询本机公网 IP：geo-ip me —— 快速定位当前网络出口位置
返回信息包括：城市、地区、国家、地理坐标（经纬度）、ISP 运营商等结构化数据。
显著优点
- 零依赖部署：仅需系统预装的
curl，无需额外安装步骤 - 简洁高效：命令行直调，结果即时返回，适合脚本集成和快速排查
- 数据维度完整：覆盖地理定位、网络归属双重信息
- API 成熟可靠：ipinfo.io 为业界广泛使用的地理定位服务，数据质量稳定
潜在缺点与局限性
- 网络依赖：完全依赖外部 API，离线环境不可用
- 隐私合规风险：所有查询流量发送至第三方服务（ipinfo.io），敏感 IP 查询存在数据泄露隐患
- 速率限制：免费 API 通常存在调用频次上限，高频场景可能受限
- 精度局限：IP 地理定位本身存在误差（通常城市级），无法精确到具体地址
- 无本地缓存：重复查询相同 IP 仍产生网络请求，效率无优化
适合人群
- 运维工程师快速排查服务器地理位置
- 安全分析师溯源 IP 归属
- 开发者集成地理定位功能的原型验证
- 普通用户查看本机公网出口位置
常规风险
| 风险类型 | 说明 |
|---------|------|
| 数据外泄 | 查询的 IP 地址被发送至 ipinfo.io，若涉及敏感资产 IP 可能暴露基础设施信息 |
| API 可用性 | 第三方服务故障或变更将导致功能失效 |
| 合规问题 | 某些司法管辖区对 IP 数据的跨境传输有严格限制 |
建议在非敏感场景使用，关键业务应考虑自建 MaxMind GeoIP2 等本地化方案。