# qqwry

**Repository Path**: luxcis/qqwry

## Basic Information

- **Project Name**: qqwry
- **Description**: golang解析纯真ip库的在线服务
- **Primary Language**: Go
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2023-10-07
- **Last Updated**: 2023-10-08

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# qqwry.go

通过 HTTP 提供一个 IP 地址归属地查询支持的微服务，使用纯真的 IP 库（支持直接在线获取和更新）。

## 介绍

这个微服务将纯真 IP 库直接加载到内存中，并以 HTTP 方式提供接口暴露出来（后续支持 GRPC），这样方便项目中所有的程序都能方便的接口 IP 查询功能。

## 安装

### 二进制包直接下载

https://gitee.com/luxcis/qqwry/releases

### 在线获取最新的纯真 IP 库

默认支持在线获取最新的纯真 IP 库（需要网络的支持）。如果您想使用本地下载运行，请参考如下。

### 下载纯真IP库

参考 https://www.cz88.net/geo-public 下载纯真IP库，需要在 Windows 中安装程序，然后在程序的安装目录可以找到 `qqwry.dat` 文件；也可以考虑运行使用 `download.go` 的 `GetOnline` 函数并将数据保存为本地文件。

将 dump 出来的 `qqwry` 文件放到和本程序同一目录（当然也可是其他目录，只是需要在运行的时候指定IP库目录），直接运行即可。

### 运行参数

运行 `./qqwry -h` 可以看到本服务程序的可用运行参数

```
  -port string
    	HTTP 请求监听端口号 (default "2060")
  -qqwry string
    	纯真 IP 库的地址 (default "./qqwry.dat")
  -update string
        纯真 IP 库的在线更新地址 (default "https://raw.githubusercontent.com/FW27623/qqwry/main/qqwry.dat")
```

## 使用方法

```
http://127.0.0.1:2060?ip=8.8.8.8,114.114.114.114&callback=a
```

* ip - 要查询的IP地址，可使用半角逗号分隔查询多个IP地址。非必填（默认返回请求来源IP）
* callback - jsonp回调函数名，当提交了这个参数，将会按jsonp格式返回。非必填

** 多个IP时返回结果 **
```json
{"114.114.114.114":{"ip":"114.114.114.114","country":"江苏省南京市","area":"南京信风网络科技有限公司GreatbitDNS服务器"},"8.8.8.8":{"ip":"8.8.8.8","country":"美国","area":"加利福尼亚州圣克拉拉县山景市谷歌公司DNS服务器"}}
```
** 单个IP时返回结果 **
```json
{"ip":"8.8.8.8","country":"美国加利福尼亚州圣克拉拉县山景市","area":"谷歌公司DNS服务器"}
```

* ip - 输入的ip地址
* country - 国家或地区
* area - 区域（实际测试得到还有可能是运营商）

`- eof -`