IP地理位置查询工具:IPGeoLocation 技术文档
概览
IPGeoLocation 是一个基于Python的工具,用于获取IP地址的地理定位信息。该工具利用了ip-api.com服务,提供了丰富功能,以方便地分析IP或域名的位置详情。适合开发者、网络安全专家以及任何需要了解网络请求来源地的用户。
安装指南
系统要求
确保您的系统已安装 Python 3.x。
必要库
termcolor
和colorama
需额外安装。
下载与安装步骤
-
克隆仓库: 使用Git命令下载项目。
git clone https://github.com/maldevel/IPGeoLocation.git
-
安装依赖: 进入项目目录并运行pip安装必要的库。
cd IPGeoLocation pip3 install -r requirements.txt --user
若系统未找到
pip3
,先安装python3-setuptools
,然后通过easy_install3
安装pip
。apt-get install python3-setuptools easy_install3 pip pip3 install -r requirements.txt --user
使用说明
基本用法
在项目目录下执行Python脚本,并根据需求添加参数进行操作。
./ip2geolocation.py
示例
-
获取当前IP的地理信息:
./ip2geolocation.py -m
-
查询指定IP地址:
./ip2geolocation.py -t x.x.x.x
-
查询域名位置:
./ip2geolocation.py -t example.com
-
使用自定义User-Agent:
./ip2geolocation.py -t x.x.x.x -u "定制的User-Agent字符串"
-
不保存日志文件:
./ip2geolocation.py -t example.com --nolog
批量处理与导出数据
支持从文件批量读取目标,并可将结果导出为CSV、XML或TXT格式。
- 导出至CSV:
./ip2geolocation.py -T targets.txt --csv result.csv
API使用文档(特别说明)
虽然IPGeoLocation是命令行工具而不是直接提供API服务,但它调用了ip-api.com的服务接口。具体API的使用细节,请参考ip-api.com官方文档。
项目特性
- 支持单个IP/域名查询。
- 可批量处理多个目标。
- 自定义或随机选择User-Agent和代理服务器。
- 结果可导出多种格式。
- 内置Google Maps位置查看功能。
通过本指南,您应能顺利安装并高效使用IPGeoLocation工具。无论是日常的网络分析还是特定项目的需求,IPGeoLocation都是一个强大的助手。记得合理使用ip-api.com服务,避免因过度请求而导致访问限制。祝您使用愉快!