快速开始

欢迎使用 IPS！这是一个命令行工具与库，旨在帮助您轻松完成 IP 地理位置数据库的查询、转储与打包。

下载与安装

源码安装

go install github.com/sjzar/ips@latest

二进制安装

从 GitHub Releases 下载最新版本的二进制文件。

Homebrew 安装

brew tap sjzar/tap
brew install ips

使用方法

查询

# 基础查询
ips <ip或文本> [选项]

# 查询 IP
ips 61.144.235.160
# 输出：61.144.235.160 [中国 广东 深圳 电信]

# 使用管道查询 IP
echo "61.144.235.160" | ips
# 输出：61.144.235.160 [中国 广东 深圳 电信]

# 使用指定的数据库文件查询 IP
ips -d ./GeoLite2-City.mmdb 61.144.235.160
# 输出：61.144.235.160 [中国 广州]

# 使用指定的数据库文件并设置查询字段
ips -d ./GeoLite2-City.mmdb --fields country 61.144.235.160
# 输出：61.144.235.160 [中国]

# 使用指定的数据库文件，以 JSON 格式输出结果
ips -d ./GeoLite2-City.mmdb --fields '*' -j 61.144.235.160
# 输出：{"ip":"61.144.235.160","net":"61.144.192.0/18","data":{"city":"广州市","continent":"亚洲","country":"中国","latitude":"23.1181","longitude":"113.2539","utcOffset":"Asia/Shanghai"}}

转储

# 基础转储命令，输出转储内容
ips dump -i ./qqwry.dat
# 输出：
#    # Dump Time: 2023-10-20 00:00:00
#    # Fields: country,area
#    ... <省略部分输出> ...

# 指定字段进行转储
ips dump -i ./qqwry.dat -f country
# 输出：
#    # Dump Time: 2023-10-20 00:00:00
#    # Fields: country
#    ... <省略部分输出> ...

# 转储内容并保存到文件
ips dump -i ./qqwry.dat -o 1.txt

打包

# 使用转储文件进行打包
ips pack -i qqwry.txt -o qqwry.ipdb

# 使用数据库文件进行打包
ips pack -i qqwry.dat -o qqwry.ipdb

# 使用数据库文件并指定字段进行打包
ips pack -i qqwry.dat -f country -o country.ipdb

详细命令和配置

配置命令 - 介绍 IPS 的配置参数和配置文件。
下载命令 - 下载 IP 地理位置数据库。
转储命令 - 转储 IP 地理位置数据库。
打包命令 - 打包 IP 地理位置数据库。
查询命令 - 查询 IP 地理位置。
多地域域名解析命令 - 查询多地域域名解析结果。
服务命令 - 启动 IPS 服务。

支持的数据库格式

IPS 支持多种数据库格式。更多关于每种格式的信息，请查阅以下链接：

IPDB 格式

高级用法

探索 IPS 的高级用法，包括裁减字段和自定义数据库操作，请参考高级用法示例。