SpringBoot整合Ip2region获取IP地址和定位-优快云博客

本文链接：https://blog.youkuaiyun.com/putMap/article/details/137778395

本文介绍了如何在SpringBoot应用中集成Ip2region库，实现IP地址的快速定位，包括数据格式、特性、Java实现步骤以及在SpringBootTest中的测试示例。重点提到了Ip2region的高效查询性能和数据管理功能。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

格式：每个 ip 数据段的 region 信息都固定了格式：国家|区域|省份|城市|ISP

SpringBoot整合Ip2region获取IP地址和定位
SpringBoot整合Ip2region获取IP地址和定位
1.Ip2region的介绍
1.1.Ip2region 是什么
ip2region v2.0 - 是一个离线IP地址定位库和IP定位数据管理框架，10微秒级别的查询效率，提供了众多主流编程语言的 xdb 数据生成和查询客户端实现。

1.2.Ip2region 特性
1.2.1 标准化的数据格式
每个 ip 数据段的 region 信息都固定了格式：国家|区域|省份|城市|ISP，只有中国的数据绝大部分精确到了城市，其他国家部分数据只能定位到国家，后前的选项全部是0。

1.2.2.数据去重和压缩
xdb 格式生成程序会自动去重和压缩部分数据，默认的全部 IP 数据，生成的 ip2region.xdb 数据库是 11MiB，随着数据的详细度增加数据库的大小也慢慢增大。

1.2.3.极速查询响应
即使是完全基于 xdb 文件的查询，单次查询响应时间在十微秒级别，可通过如下两种方式开启内存加速查询：

vIndex 索引缓存：使用固定的 512KiB 的内存空间缓存 vector index 数据，减少一次 IO 磁盘操作，保持平均查询效率稳定在10-20微秒之间。

xdb 整个文件缓存：将整个 xdb 文件全部加载到内存，内存占用等同于 xdb 文件大小，无磁盘 IO 操作，保持微秒级别的查询效率。

1.2.4.IP 数据管理框架
2.0 格式的 xdb 支持亿级别的 IP 数据段行数，region 信息也可以完全自定义，例如：你可以在 region 中追加特定业务需求的数据，例如：GPS信息/国际统一地域信息编码/邮编等。也就是你完全可以使用 ip2region 来管理你自己的 IP 定位数据。

2.Java方式
2.1.下载ip2region.db
$ git clone https://github.com/lionsoul2014/ip2region.git

下载这个项目之后到data/文件夹下面找到ip2region.db复制到项目resources下

2.2.maven仓库

org.springframework.boot
spring-boot-starter-web

org.springframework.boot
spring-boot-starter-test
test

org.apache.commons
commons-lang3
3.12.0

    <!-- IP定位 -->
    <dependency>
        <gro