# 3ip

**Repository Path**: leexuanhe/ip

## Basic Information

- **Project Name**: 3ip
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2021-06-16
- **Last Updated**: 2021-06-16

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 3IP

用Python查询纯真IP库(IPv4&IPv6)

	ip.py:	Python2

	ip.py3:	Python3 (recommended)
	

# QQWry.Dat 格式:

+----------+

|  文件头  |  (8字节)

+----------+

|  记录区  | （不定长）

+----------+

|  索引区  | （大小由文件头决定）

+----------+


文件头：4字节开始索引偏移值+4字节结尾索引偏移值

记录区： 每条IP记录格式：IP地址[国家信息][地区信息]

   对于国家记录，可以有三种表示方式：

       字符串形式(IP记录第5字节不等于0x01和0x02的情况)，
       重定向模式1(第5字节为0x01),则接下来3字节为国家和地区信息存储地的偏移值
       重定向模式2(第5字节为0x02),则接下来3字节为国家信息存储地的偏移值

   对于地区记录，可以有两种表示方式： 字符串形式和重定向

索引区： 每条索引记录格式：4字节起始IP地址 + 3字节指向IP记录的偏移值

   索引区的IP和它指向的记录区一条记录中的IP构成一个IP范围。查询信息是这个
   范围内IP的信息

## IPv6wry.db 格式:

```
文件头
0~3	字符串	"IPDB"
4~5	short	版本号,现在是2
6	byte	偏移地址长度(2~8)
7	byte	IP地址长度(4或8或12或16, 现在只支持4(ipv4)和8(ipv6))
8~15	int64	记录数
16~23	int64	索引区第一条记录的偏移
24	byte	地址字段数(1~255)[版本2新增,版本1是2]
25~31	reserve	保留,用00填充

记录区
array 字符串[地址字段数]
	与qqwry.dat大致相同,但是没有结束IP地址
	01开头的废弃不用
	02+偏移地址[偏移长度]表示重定向
	20~FF开头的为正常的字符串,采用UTF-8编码,00结尾

索引区
struct{
	IP[IP地址长度]	little endian, 开始IP地址
	偏移[偏移长度]	little endian, 记录偏移地址
}索引[记录数];
```

# 用法：

1.命令行查询

	./ip.py 1.1.1.1		查询IP归属
	./ip.py 240e:1f:1::1	查询IPv6归属
	./ip.py 100-200		查询编号100-200的IP记录(ipv4)

2.Web浏览器查询

	http://xxx/ip?a=1.1.1.1		查询IP归属
	http://xxx/ip?a=240e:1f:1::1	查询IPv6归属
	http://xxx/ip?a=100-200		查询编号100-200的IP记录(ipv4)
	http://xxx/ip?a=1.1.1.1&j=1	返回json格式

  http服务配置uwsgi支持，以nginx举例：

	location /ip {
		allow all;
		include uwsgi_params;
		uwsgi_pass 127.0.0.1:9009;
	}

  uwsgi配置：

	[uwsgi]
	  chdir=/path/to/program
	  master=True
	  pidfile=/run/uwsgi/ip.pid
	  logto=/var/log/uwsgi/ip.log
	  vacuum=True
	  max-requests=1000
	  threads=2
	  processes=1
	  socket = 127.0.0.1:9009
	  uid = uwsgi
	  gid = uwsgi
	  plugins = python
	  #plugins = python36
	  buffer-size=32768
	  wsgi-file=ip.py
	  touch-reload=ip.py