IPS

ips 是一个命令行工具与库，可以轻松完成 IP 地理位置数据库的查询、转存与打包。

下载与安装

源码安装

go install github.com/sjzar/ips@latest

二进制安装

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

Homebrew 安装

brew tap sjzar/tap
brew install ips

特性

一键查询、转存和打包 IP 地理位置数据库
兼容多种数据库格式
通过命令行参数或管道进行查询
输出支持文本和 JSON 格式
可自定义查询字段并持久化配置
灵活的数据库字段改写：按需增减字段和内容修改

数据库支持列表

| 数据库 | 查询 | 转存 | 打包 | 官方网站 | 说明 | |:----------|:---|:---|:---|:--------------------------------------------------|:----------| | txt | ✅ | ✅ | ✅ | - | 本项目转存时使用 | | ipdb | ✅ | ✅ | ✅ | Link | | | mmdb | ✅ | ✅ | ✅ | Link | | | awdb | ✅ | ✅ | - | Link | | | qqwry | ✅ | ✅ | - | Link | IPv4 only | | czdb | ✅ | ✅ | - | Link | | | zxinc | ✅ | ✅ | - | Link | IPv6 only | | ip2region | ✅ | ✅ | - | Link | IPv4 only |

使用方法

更详细的使用说明请翻阅 usage.md 。

查询

# 基础查询
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 是在 Apache-2.0 许可下的开源软件。

致谢

IPIP.net 的 ipdb 数据库格式
MaxMind 的 mmdb 数据库格式
埃文科技的 awdb 数据库格式
纯真网络的 qqwry 和 czdb 数据库格式
ip.zxinc.org 的 zxinc 数据库格式
@lionsoul2014 的 ip2region 数据库格式
@zu1k 的 nali 项目，本项目查询功能参考了 nali 的方案
@metowolf 的 qqwry.dat 和 ipdb 项目
GeoNames.org 的地理信息数据
各个 Go 开源库的贡献者们，例如 cobra、viper、logrus、progressbar 等

Ips

Install / Use

README

IPS