可离线可快速免费查询IP地址库 - ip2region

最近在做一个项目, 客户方想要记录所有的登录地址信息, 同时希望内网可用. 所以搜索到了ip2region 这个项目, 作者是将淘宝等IP地址查询服务的数据进行了汇总和整合, 并且提供了各种语言的开发包实现离线根据IP快速查询.

简要说明

• 结果格式: 国家|区域|省份|城市|ISP

说明:
参考链接: 关于格式的说明issue

1. ip2region.db文件里面的格式每一个ip段都是: 城市Id|国家|区域|省份|城市|ISP;
2. 如果调用的API为: dataBlock.getRegion(), 结果格式为: 国家|区域|省份|城市|ISP ;
3. 如果需要获取city_id，通过调用dataBlock.getCityId()即可;

• 官方称99.9%数据准确率, 数据聚合自淘宝/纯真/GeoIP的开放API或者数据(升级程序每秒请求次数2到4次), 只有中国的数据精确到了城市，其他国家只能定位到国家
• 生成的数据库文件ip2region.db目前不到10M, 读取消耗非常少, 可内网使用, 并提供了多种查询算法API, 达到毫秒级响应
• 如果需要更新数据, 只需要重新下载ip2region.db文件并且执行覆盖, 可做到无需代码改动，当然需要根据项目实际情况来定。

使用方式

这里主要针对Java开发做说明

1. 首先到项目中的data目录中下载ip2region.db(可以点击直接下载);

2. 将该文件保存在工程resource或者任意一个地方

   
   
   

   ip2region.db位置

3. 在pom.xml中引入ip2region开发包

  org.lionsoul
  ip2region
  1.7.2

4. 编写IpUtils工具类, 代码复制即可使用.

package com.ee2j.test.common.util;

import lombok.SneakyThrows;
import lombok.extern.slf4j.Slf4j;
import org.apache.commons.lang3.StringUtils;
import org.apache.commons.lang3.exception.ExceptionUtils;
import org.lionsoul.ip2region.DataBlock;
import org.lionsoul.ip2region.DbConfig;
import org.lionsoul.ip2region.DbSearcher;
import org.lionsoul.ip2region.Util;

import java.io.File;

/**
 * ip查询处理
 *
 * @author videomonster
 */
@Slf4j
public final class IpUtils {

    private static final String UNKOWN_ADDRESS = "未知位置";

    /**
     * 根据IP获取地址
     *
     * @return 国家|区域|省份|城市|ISP
     */
    public static String getAddress(String ip) {
        return getAddress(ip, DbSearcher.BTREE_ALGORITHM);
    }

    /**
     * 根据IP获取地址
     *
     * @param ip
     * @param algorithm 查询算法
     * @return 国家|区域|省份|城市|ISP
     * @see DbSearcher
     * DbSearcher.BTREE_ALGORITHM; //B-tree
     * DbSearcher.BINARY_ALGORITHM //Binary
     * DbSearcher.MEMORY_ALGORITYM //Memory
     */
    @SneakyThrows
    public static String getAddress(String ip, int algorithm) {
        if (!Util.isIpAddress(ip)) {
            log.error("错误格式的ip地址: {}", ip);
            return UNKOWN_ADDRESS;
        }
        String dbPath = IpUtils.class.getResource("/ip2region.db").getPath();
        File file = new File(dbPath);
        if (!file.exists()) {
            log.error("地址库文件不存在");
            return UNKOWN_ADDRESS;
        }
        DbSearcher searcher = new DbSearcher(new DbConfig(), dbPath);
        DataBlock dataBlock;
        switch (algorithm) {
            case DbSearcher.BTREE_ALGORITHM:
                dataBlock = searcher.btreeSearch(ip);
                break;
            case DbSearcher.BINARY_ALGORITHM:
                dataBlock = searcher.binarySearch(ip);
                break;
            case DbSearcher.MEMORY_ALGORITYM:
                dataBlock = searcher.memorySearch(ip);
                break;
            default:
                log.error("未传入正确的查询算法");
                return UNKOWN_ADDRESS;
        }
        return dataBlock.getRegion();
    }
}

简单测试

主要是输出一些IP地址的查询, 看看是否可以使用

@Test
public void test() {
    log.info("开始查询");
    System.out.println(IpUtils.getAddress("106.35.112.88"));
    System.out.println(IpUtils.getAddress("222.190.125.42"));
    System.out.println(IpUtils.getAddress("206.77.131.86"));
    System.out.println(IpUtils.getAddress("116.37.161.86"));
    System.out.println(IpUtils.getAddress("136.27.231.86"));
    System.out.println(IpUtils.getAddress("127.0.0.1"));
    System.out.println(IpUtils.getAddress("112.17.236.511"));
    log.info("查询完成");
}

返回结果如下:

2019-12-17 11:05:24.251 [main] INFO  c.e.test.IpUtilsTest - 开始查询
中国|0|内蒙古|鄂尔多斯市|电信
中国|0|江苏省|南京市|电信
美国|0|德克萨斯|0|0
韩国|0|0|0|0
美国|0|加利福尼亚|旧金山|0
0|0|0|内网IP|内网IP
2019-12-17 11:05:24.267 [main] ERROR c.e.test.c.util.IpUtils - 错误格式的ip地址: 112.17.236.511
未知位置
2019-12-17 11:05:24.269 [main] INFO  c.e.test.IpUtilsTest - 查询完成

测试发现可以正常运行, 并且多个地址可以在ms级别返回, 再也不用担心开放服务的502等问题了, 接下来就根据自己的业务需求进行数据结构封装吧.