纯真网络免费 IP 库解析服务。
- Go 语言编写
- 进程内缓存结果，重复的 ip 查询响应时间平均为 0.2 ms
- 内置协程数、缓存数、CPU核心数等指标上报
- 若首次部署安装，请提前准备好纯真网络的 IP 库。IP 库可以通过直接安装纯真网络客户端并将其导出为 txt 文件而获得。运行前将其命名为
czip.txt并放置在./storage文件夹即可。
-
安装 golang 环境。建议 go1.13 以上。
-
编译运行
go mod download go get github.com/zzfly256/ip-service/src go build -o ./ip-service github.com/zzfly256/ip-service/src ./ip-service
克隆本仓库后，运行一下命令
docker build -t ip-service .
docker run -d --rm -p 80:80 ip-service-
打开网站：www.cz88.net 下载客户端软件，导出 txt 数据库
-
将其转换为 UTF8 格式（采用 enca 工具）
# 查看文件编码 enca -L chinese czip.txt # 从 GB2312 转换为 UTF-8 enca -L zh_CN -x UTF-8 czip.txt
| 接口 | 请求方式 | 请求字段 | 说明 |
|---|---|---|---|
| /v1/query_my_ip | GET | 无 | 获取访问者自身 ip |
| /v1/query_ip_address | GET/POST | ip | 查询 ip 地址相关信息 |
| /metrics | GET | 无 | 获取程序运行相关指标(Prometheus 格式) |
详细的接口文档后续得闲再补充。
- 随机 ip 请求测试中，首次响应时长约 50ms/请求，产生缓存后约 0.2 ms/请求
- 本人开发机压测结果如下所示
rytia@Rytia-Envy13
------------------
OS: Ubuntu 20.04.1 LTS on Windows 10 x86_64
Kernel: 4.4.0-19041-Microsoft
Uptime: 24 mins
Packages: 761 (dpkg)
Shell: zsh 5.8
Terminal: /dev/tty2
CPU: Intel i5-8250U (8) @ 1.800GHz
Memory: 6088MiB / 8038MiB
# ab -c 100 -t 10 "http://127.0.0.1:3000/v1/query_ip_address?ip=210.35.147.225"
This is ApacheBench, Version 2.3 <$Revision: 1843412 $>
Copyright 1996 Adam Twiss, Zeus Technology Ltd, http://www.zeustech.net/
Licensed to The Apache Software Foundation, http://www.apache.org/
Benchmarking 127.0.0.1 (be patient)
Completed 5000 requests
Completed 10000 requests
Completed 15000 requests
Finished 17113 requests
Server Software:
Server Hostname: 127.0.0.1
Server Port: 3000
Document Path: /v1/query_ip_address?ip=210.35.147.225
Document Length: 114 bytes
Concurrency Level: 100
Time taken for tests: 10.041 seconds
Complete requests: 17113
Failed requests: 0
Total transferred: 4073370 bytes
HTML transferred: 1951110 bytes
Requests per second: 1704.25 [#/sec] (mean)
Time per request: 58.677 [ms] (mean)
Time per request: 0.587 [ms] (mean, across all concurrent requests)
Transfer rate: 396.15 [Kbytes/sec] received
Connection Times (ms)
min mean[+/-sd] median max
Connect: 0 18 13.8 14 92
Processing: 1 40 20.8 36 197
Waiting: 1 31 17.4 27 180
Total: 1 58 22.8 53 206
Percentage of the requests served within a certain time (ms)
50% 53
66% 62
75% 70
80% 76
90% 91
95% 104
98% 116
99% 123
100% 206 (longest request)
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent