IPSpot：Python IP 地址地理位置查询工具技术分析
一、新闻概述
1. 标题
IPSpot：支持 IPv4/IPv6 的 Python IP 地址与地理位置查询库
2. 发布时间
2025 年 1 月 26 日
3. 来源
GitHub 开源项目：openscilab/ipspot
二、核心内容
1. 事件摘要
A. 主要内容
OpenSciLab 发布了一款名为 IPSpot 的 Python 库，用于获取系统的公网和内网 IP 地址，并提供地理位置信息查询功能。
B. 核心亮点
- 支持 IPv4 和 IPv6 双栈查询
- 提供公网和内网地址检测
- 集成多个 API 提供商，具备故障转移机制
- 提供 Python 库和 CLI 两种使用方式
- 支持地理位置信息查询（国家、城市、经纬度等）
2. 关键信息
A. 版本信息
- 当前版本：0.7
- PyPI 已发布
- 支持 Python 3
B. 功能特性
- 公网 IPv4/IPv6 查询
- 内网 IPv4/IPv6 识别
- 地理位置信息（可选）
- 多 API 提供商支持
- 自动重试和回退机制
C. 涉及技术
- Python 3
- REST API 调用
- IPv4/IPv6 网络协议
- 地理位置服务
3. 背景介绍
A. 应用场景
IPSpot 主要用于网络诊断、地理位置识别、安全审计等场景，帮助开发者快速获取系统的网络地址信息。
B. 相关上下文
传统的 IP 查询工具通常只支持单一协议或单一 API 源，IPSpot 通过多 API 源和故障转移机制提高了可靠性。
三、详细报道
1. 主要功能
A. 公网 IP 查询
支持通过多个 API 提供商获取公网 IP 地址：
- IPv4 API：ip-api.com、ipinfo.io、ip.sb、ident.me、tnedi.me 等
- IPv6 API：ip.sb、ident.me、tnedi.me、ipleak.net 等
B. 内网 IP 识别
自动检测系统的内网地址：
- IPv4：如 192.168.x.x、10.x.x.x
- IPv6：如 fe80:: 开头的链路本地地址
C. 地理位置信息
可选查询地理位置数据，包括：
- 国家和地区
- 城市
- 经纬度坐标
- 时区
- 组织/ISP 信息
2. 技术架构
graph TB
User[用户] -->|API调用| Library[IPSpot库]
User -->|CLI命令| CLI[命令行工具]
Library --> APIManager[API管理器]
CLI --> APIManager
APIManager -->|策略选择| APISel[API选择器]
APISel --> API1[ip-api.com]
APISel --> API2[ipinfo.io]
APISel --> API3[ip.sb]
APISel --> APIMore[其他API...]
API1 -->|失败| Fallback[故障转移]
API2 -->|失败| Fallback
API3 -->|失败| Fallback
Fallback --> APISel
API1 -->|成功| Response[响应数据]
API2 -->|成功| Response
API3 -->|成功| Response
Response --> Parser[数据解析器]
Parser --> Result[格式化输出]
D. 技术特点
多 API 源支持：
- 支持 16 个 IPv4 API 提供商
- 支持 9 个 IPv6 API 提供商
- 可指定特定 API 或使用自动模式
故障转移机制：
- 自动模式（auto）：按顺序尝试所有 API
- 安全模式（auto-safe）：仅尝试可靠的 API
- 支持自定义重试次数和延迟
灵活的配置选项：
- 可配置超时时间
- 支持指数退避重试
- 可关闭地理位置查询
3. 使用方式
A. Python 库方式
基本用法：
from ipspot import get_public_ipv4, get_private_ipv4
# 获取公网 IPv4
result = get_public_ipv4()
# 返回：{'status': True, 'data': {'ip': 'xx.xx.xx.xx', 'api': 'ip-api.com'}}
# 获取内网 IPv4
result = get_private_ipv4()
# 返回：{'status': True, 'data': {'ip': '10.36.18.154'}}带地理位置：
from ipspot import get_public_ipv4, IPv4API
result = get_public_ipv4(
api=IPv4API.IP_API_COM,
geo=True,
timeout=10
)
# 返回包含地理位置的详细信息B. 命令行方式
基本查询：
ipspot指定 API：
ipspot --ipv4-api="ipinfo.io"仅查询 IP（不含地理位置）：
ipspot --no-geo4. API 提供商对比
A. IPv4 API 支持
| API 提供商 | 特点 |
|---|---|
| ip-api.com | 支持地理位置 |
| ipinfo.io | 支持地理位置 |
| ip.sb | 支持 IPv4/IPv6 |
| ident.me | 简单快速 |
| tnedi.me | 轻量级 |
| ipapi.co | 支持详细地理信息 |
| ipleak.net | DNS 泄露检测 |
| my-ip.io | 基础 IP 查询 |
| ifconfig.co | 网络配置信息 |
| reallyfreegeoip.org | 免费地理位置 |
| freeipapi.com | 免费 API |
| myip.la | 亚洲优化 |
| ipquery.io | 查询工具 |
| ipwho.is | 详细 IP 信息 |
| wtfismyip.com | 简单查询 |
B. IPv6 API 支持
| API 提供商 | 特点 |
|---|---|
| ip.sb | 支持 IPv6 |
| ident.me | 支持 IPv6 |
| tnedi.me | 支持 IPv6 |
| ipleak.net | IPv6 泄露检测 |
| my-ip.io | IPv6 支持 |
| ifconfig.co | IPv6 支持 |
| reallyfreegeoip.org | IPv6 地理位置 |
| myip.la | IPv6 支持 |
| freeipapi.com | IPv6 API |
四、技术细节分析
1. 设计模式
A. 策略模式
IPSpot 使用策略模式实现多 API 支持，允许用户选择不同的 API 提供商，并在运行时切换。
B. 故障转移模式
通过自动尝试下一个可用的 API，确保服务的可靠性。
C. 工厂模式
根据用户指定的 API 类型或自动模式，创建相应的 API 客户端。
2. 错误处理
A. 重试机制
- 支持自定义最大重试次数
- 可配置重试延迟
- 支持指数退避算法
B. 超时控制
- 可设置请求超时时间
- 防止长时间等待无响应的 API
3. 数据结构
A. 标准响应格式
{
'status': True, # 请求状态
'data': { # 数据内容
'ip': 'xx.xx.xx.xx',
'api': 'ip-api.com',
# ... 其他字段
}
}B. 地理位置数据
{
'country': 'Germany',
'country_code': 'DE',
'region': 'Bavaria',
'city': 'Nuremberg',
'latitude': 49.4527,
'longitude': 11.0783,
'timezone': 'Europe/Berlin',
'organization': 'Hetzner Online GmbH'
}五、影响分析
1. 技术价值
A. 开发便利性
- 简化了 IP 查询的集成工作
- 提供统一的 API 接口
- 支持多种使用场景
B. 可靠性提升
- 多 API 源降低了单点故障风险
- 自动故障转移提高了服务可用性
- 重试机制增强了容错能力
2. 应用场景
A. 网络诊断
- 快速获取当前网络的公网 IP
- 识别网络配置问题
- 验证 VPN 或代理设置
B. 安全审计
- 检测 IP 泄露
- 验证加密连接的有效性
- 审计网络访问记录
C. 地理位置服务
- 内容地域限制
- 用户位置分析
- 时区自动识别
3. 技术趋势
A. IPv6 普及
IPSpot 对 IPv6 的支持反映了互联网向 IPv6 过渡的趋势。
B. API 多源化
采用多 API 源提高可靠性的做法，是现代云原生应用的设计趋势。
C. 开源生态
作为开源项目，IPSpot 展示了 Python 生态在工具类库方面的活跃度。
六、各方反应
1. 项目状态
- 项目在 GitHub 上活跃维护
- 已发布到 PyPI，便于安装使用
- 提供 Discord 社区支持
2. 技术特点
- 代码质量良好（通过 Codecov 检测）
- 支持最新的 Python 3
- 提供完整的文档和示例
3. 社区反馈
- 项目获得 GitHub Star 支持
- 提供捐赠渠道支持项目发展
- 欢迎社区贡献和问题反馈
七、相关链接
1. 项目资源
- GitHub 仓库：https://github.com/openscilab/ipspot
- PyPI 包：pip install ipspot
2. 相关文档
- Python Packaging User Guide
- 项目 README 和使用示例
八、总结
IPSpot 是一个功能完善、设计合理的 IP 地址查询工具。它通过多 API 源和故障转移机制，解决了单一 API 源可靠性不足的问题。同时，对 IPv4/IPv6 的双栈支持以及地理位置查询功能，使其在网络诊断、安全审计等场景中具有很强的实用性。
对于 Python 开发者而言，IPSpot 提供了一个简单易用的接口，可以快速集成到各种应用中。项目的开源性质和活跃的社区支持，也为未来的功能扩展和维护提供了保障。