SpringBoot整合Ip2region获取IP地址和定位

1、依赖

        <dependency>
            <groupId>org.lionsoul</groupId>
            <artifactId>ip2region</artifactId>
            <version>2.7.0</version>
        </dependency>
        <dependency>
            <groupId>eu.bitwalker</groupId>
            <artifactId>UserAgentUtils</artifactId>
            <version>1.21</version>
        </dependency>
        <dependency>
            <groupId>cn.hutool</groupId>
            <artifactId>hutool-all</artifactId>
            <version>5.8.11</version>
        </dependency>
   <!--        <dependency>-->
<!--            <groupId>commons-net</groupId>-->
<!--            <artifactId>commons-net</artifactId>-->
<!--            <version>3.8.0</version>-->
<!--        </dependency>-->

2、gie下载ip2region.db命令

 git clone https://github.com/lionsoul2014/ip2region.git

3、工具类

package com.skybird.edge.base.user.service;


import eu.bitwalker.useragentutils.UserAgent;
import org.apache.commons.lang3.StringUtils;
import org.lionsoul.ip2region.xdb.Searcher;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.springframework.util.FileCopyUtils;

import javax.servlet.http.HttpServletRequest;
import java.io.IOException;
import java.io.InputStream;
import java.net.Inet4Address;
import java.net.Inet6Address;
import java.net.InetAddress;
import java.net.UnknownHostException;
import java.util.Arrays;

public class IpUtils {
    private static final Logger logger = LoggerFactory.getLogger(IpUtils.class);
    private final static String localIp = "127.0.0.1";

    private static Searcher searcher = null;

    /**
     在服务启动时加载 ip2region.db 到内存中
     解决打包jar后找不到 ip2region.db 的问题
     */
    static {
        try {
            InputStream ris = IpUtils.class.getResourceAsStream("/ip2region/ip2region.xdb");
            byte[] dbBinStr = FileCopyUtils.copyToByteArray(ris);
            searcher = Searcher.newWithBuffer(dbBinStr);
            //注意:不能使用文件类型,打成jar包后,会找不到文件
            logger.debug("缓存成功!!!!");
        } catch (IOException e) {
            logger.error("解析ip地址失败,无法创建搜索器: {}", e);
            throw new RuntimeException(e);
        }
    }

    public static String getIp(HttpServletRequest request) {
        String ipAddress;
        try {
            // 以下两个获取在k8s中,将真实的客户端IP,放到了x-Original-Forwarded-For。而将WAF的回源地址放到了 x-Forwarded-For了。
            ipAddress = request.getHeader("X-Original-Forwarded-For");
            if (ipAddress == null || "unknown".equalsIgnoreCase(ipAddress)) {
                ipAddress = request.getHeader("X-Forwarded-For");
            } //获取nginx等代理的ip
            if (ipAddress == null || "unknown".equalsIgnoreCase(ipAddress)) {
                ipAddress = request.getHeader("x-forwarded-for");
            }
            if (ipAddress == null || ipAddress.length() == 0 || "unknown".equalsIgnoreCase(ipAddress)) {
                ipAddress = request.getHeader("Proxy-Client-IP");
            }
            if (ipAddress == null || ipAddress.length() == 0 || "unknown".equalsIgnoreCase(ipAddress)) {
                ipAddress = request.getHeader("WL-Proxy-Client-IP");
            }
            if (ipAddress == null || "unknown".equalsIgnoreCase(ipAddress)) {
                ipAddress = request.getHeader("HTTP_CLIENT_IP");
            }
            if (ipAddress == null || "unknown".equalsIgnoreCase(ipAddress)) {
                ipAddress = request.getHeader("HTTP_X_FORWARDED_FOR");
            }

            // 2.如果没有转发的ip,则取当前通信的请求端的ip(兼容k8s集群获取ip)
            if (ipAddress == null || ipAddress.length() == 0 || "unknown".equalsIgnoreCase(ipAddress)) {
                ipAddress = request.getRemoteAddr();
                // 如果是127.0.0.1,则取本地真实ip
                if (localIp.equals(ipAddress)) {
                    // 根据网卡取本机配置的IP
                    InetAddress inet = null;
                    try {
                        inet = InetAddress.getLocalHost();
                        ipAddress = inet.getHostAddress();
                    } catch (UnknownHostException e) {
                        e.printStackTrace();
                    }
                }
            }

            // 对于通过多个代理的情况,第一个IP为客户端真实IP,多个IP按照','分割
            if (ipAddress != null && ipAddress.length() > 15) {
                // = 15
                if (ipAddress.indexOf(",") > 0) {
                    ipAddress = ipAddress.substring(0, ipAddress.indexOf(","));
                }
            }


        } catch (Exception e) {
            logger.error("解析请求IP失败", e);
            ipAddress = "";
        }
        return "0:0:0:0:0:0:0:1".equals(ipAddress) ? localIp : ipAddress;
    }

    /**
     * 获取访问设备
     *
     * @param request
     * @return
     */
    public static UserAgent getUserAgent(HttpServletRequest request) {
        return UserAgent.parseUserAgentString(request.getHeader("User-Agent"));
    }

    /**
     * 根据ip获取 城市信息
     *
     * @param ipAddress
     * @return
     */
    public static String getCityInfo(String ipAddress) {
        String cityInfo = null;
        try {
            return searcher.search(ipAddress);
        } catch (Exception e) {
            logger.error("搜索:{} 失败: {}", ipAddress, e);
        }
        return null;
    }

    /**
     * 根据ip2region解析ip地址
     *
     * @param ip ip地址
     * @return 解析后的ip地址信息
     */
    public static String getIp2region(String ip) {

        if (searcher == null) {
            logger.error("Error: DbSearcher is null");
            return null;
        }

        try {
            String ipInfo = searcher.search(ip);
            if (!StringUtils.isEmpty(ipInfo)) {
                ipInfo = ipInfo.replace("|0", "");
                ipInfo = ipInfo.replace("0|", "");
            }
            return ipInfo;
        } catch (Exception e) {
            e.printStackTrace();
        }
        return null;
    }

    /**
     * 获取IP地址
     *
     * @return 本地IP地址
     */
    public static String getHostIp() {
        try {
            return InetAddress.getLocalHost().getHostAddress();
        } catch (UnknownHostException e) {
        }
        return localIp;
    }

    /**
     * 获取主机名
     *
     * @return 本地主机名
     */
    public static String getHostName() {
        try {
            return InetAddress.getLocalHost().getHostName();
        } catch (UnknownHostException e) {
        }
        return "未知";
    }

        public static String convertToIPv4AndCheckLocal(String ip) {
        if (ip == null || ip.isEmpty()) {
            return "Invalid IP address";
        }

        try {
            InetAddress inetAddress = InetAddress.getByName(ip);

            // 检查是否为本地 IP 地址
            if (inetAddress.isLoopbackAddress()) {
                return "127.0.0.1";
            }

            // 如果已经是 IPv4 地址,直接返回
            if (inetAddress instanceof Inet4Address) {
                return inetAddress.getHostAddress();
            }

            // 检查是否为 IPv4 映射的 IPv6 地址
            if (ip.startsWith("::ffff:")) {
                // 提取 IPv4 部分
                String ipv4Part = ip.substring(7);
                return ipv4Part;
            }

            // 检查是否为标准 IPv6 地址
            if (inetAddress instanceof Inet6Address) {
                byte[] addressBytes = inetAddress.getAddress();
                if (addressBytes[0] == 0 && addressBytes[1] == 0 && addressBytes[2] == 0 && addressBytes[3] == 0 &&
                        addressBytes[4] == 0 && addressBytes[5] == 0 && addressBytes[6] == 0 && addressBytes[7] == 0 &&
                        addressBytes[8] == 0 && addressBytes[9] == 0 && addressBytes[10] == 0 && addressBytes[11] == 0xff) {
                    // 提取 IPv4 部分
                    byte[] ipv4Bytes = Arrays.copyOfRange(addressBytes, 12, 16);
                    return InetAddress.getByAddress(ipv4Bytes).getHostAddress();
                }
            }

            // 如果无法转换,返回原 IP 地址
            return ip;

        } catch (UnknownHostException e) {
            return "Invalid IP address";
        }
    }
}

4、用法核心代码

    @RequestMapping(value = "/getIp")
    public String set(HttpServletRequest request) {
        //      String ip = IpUtils.convertToIPv4AndCheckLocal(ServletUtil.getClientIP(request));
        String ip = IpUtils.getIp(request);
        String ip_region = "本地";
        if (StrUtil.isNotEmpty(ip) && !StrUtil.equals(ip, "127.0.0.1")) {
            ip_region = IpUtils.getCityInfo(ip);
        }
        return ip_region;
    }

    

### Spring Boot 整合 ip2region 实现 IP 地址定位教程 #### 一、配置依赖 要在Spring Boot项目中集成`ip2region`,首先需要在项目的`pom.xml`文件中引入必要的Maven依赖。 ```xml <dependency> <groupId>org.lionsoul</groupId> <artifactId>ip2region</artifactId> <version>最新版本号</version> </dependency> ``` 此操作确保了应用程序能够访问到`ip2region`的相关API[^1]。 #### 二、加载数据文件 接着,需准备`ip2region.db`数据库文件,并将其放置于合适的位置(如资源目录下)。之后通过自定义Bean来读取该文件路径: ```java @Configuration public class Ip2RegionConfig { @Value("${ip2region.db.path}") private String dbPath; @Bean public DbSearcher dbSearcher() throws IOException{ File file = new File(dbPath); if (!file.exists()){ throw new FileNotFoundException("指定的IP2Region DB文件不存在"); } return new DbSearcher(new MemoryDBFileReader(file)); } } ``` 这段代码展示了如何创建一个名为`dbSearcher`的bean实例用于后续查询操作。注意这里也包含了对于可能发生的`FileNotFoundException`异常进行了捕获处理[^3]。 #### 三、编写业务逻辑层 接下来就是构建具体的服务类来进行地理信息检索工作了。可以利用@Autowired注入之前定义好的DbSearcher对象完成这项任务。 ```java @Service public class LocationService { @Autowired private DbSearcher dbSearcher; /** * 根据给定的IPv4地址返回对应的地理位置描述字符串。 */ public String getLocationByIp(String ipAddress){ try { DataBlock dataBlock = this.dbSearcher.memorySearch(ipAddress); return Arrays.toString(dataBlock.getRegion().split("\\|")); } catch (Exception e) { log.error("Failed to get location by ip.",e); return "未知"; } } } ``` 上述方法接受一个参数即目标IP地址,并调用`memorySearch()`函数执行匹配过程;如果成功则解析出地区名称作为响应结果输出,反之记录错误日志并给出默认提示语句“未知”。 #### 四、暴露RESTful接口供外部调用 最后一步是在控制器里边开放HTTP请求入口以便其他模块或第三方应用能方便地发起查询请求。 ```java @RestController @RequestMapping("/api/location") public class LocationController { @Autowired private LocationService locationService; @GetMapping("/{ip}") public ResponseEntity<String> getLocation(@PathVariable String ip){ String result = this.locationService.getLocationByIp(ip); return ResponseEntity.ok(result); } } ``` 以上便是整个流程的大致框架结构说明,当然实际部署环境还需要考虑更多细节方面的问题比如性能优化等[^2]。
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值