<!-- ip2region 離線IP歸屬地查詢核心依賴 最新3.3.6版本 -->
<dependency>
    <groupId>org.lionsoul</groupId>
    <artifactId>ip2region</artifactId>
    <version>3.3.6</version>
</dependency>
<!-- 可選：hutool工具包，簡化IP獲取和字符串處理，生產(chǎn)常用 -->
<dependency>
    <groupId>cn.hutool</groupId>
    <artifactId>hutool-all</artifactId>
    <version>5.8.25</version>
</dependency>

import jakarta.annotation.PostConstruct;
import jakarta.annotation.PreDestroy;
import lombok.extern.slf4j.Slf4j;
import org.lionsoul.ip2region.service.Config;
import org.lionsoul.ip2region.service.Ip2Region;
import org.springframework.core.io.ClassPathResource;
import org.springframework.stereotype.Component;
import java.io.InputStream;
/**
 * 離線IP歸屬地查詢工具類
 * 遵循官方雙庫規(guī)范：IPv4+IPv6分開配置，統(tǒng)一托管查詢
 * 完整覆蓋所有內(nèi)網(wǎng)IP段判斷，杜絕公網(wǎng)查詢誤判
 * 單例模式，全局復(fù)用，避免重復(fù)加載數(shù)據(jù)庫
 */
@Slf4j
@Component
public class IpRegionUtil {
    /**
     * IPv4、IPv6雙庫文件路徑，對應(yīng)resources/ipdb目錄
     * 嚴(yán)格對應(yīng)ip2region官方原文件名，不修改、不重命名
     */
    private static final String IPV4_XDB_PATH = "ipdb/ip2region_v4.xdb";
    private static final String IPV6_XDB_PATH = "ipdb/ip2region_v6.xdb";
    /**
     * ip2region官方統(tǒng)一查詢對象，托管雙庫，無需手動拆分Searcher
     */
    private Ip2Region ip2Region;
    /**
     * 項目啟動初始化，加載ip2region雙庫文件
     * 采用BufferCache緩存策略，兼顧查詢速度與內(nèi)存占用
     */
    @PostConstruct
    public void init() {
        try {
            // 加載IPv4數(shù)據(jù)庫配置
            ClassPathResource v4Resource = new ClassPathResource(IPV4_XDB_PATH);
            InputStream v4Is = v4Resource.getInputStream();
            Config v4Config = Config.custom()
                    .setCachePolicy(Config.BufferCache)
                    .setSearchers(10)
                    .setXdbInputStream(v4Is)
                    .asV4();
            // 加載IPv6數(shù)據(jù)庫配置
            ClassPathResource v6Resource = new ClassPathResource(IPV6_XDB_PATH);
            InputStream v6Is = v6Resource.getInputStream();
            Config v6Config = Config.custom()
                    .setCachePolicy(Config.BufferCache)
                    .setSearchers(10)
                    .setXdbInputStream(v6Is)
                    .asV6();
            // 統(tǒng)一創(chuàng)建ip2region查詢對象
            ip2Region = Ip2Region.create(v4Config, v6Config);
            log.info("ip2region初始化成功，IPv4+IPv6雙庫加載完成");
        } catch (Exception e) {
            log.error("ip2region初始化失敗，請檢查雙庫文件路徑和完整性", e);
            throw new RuntimeException("ip2region異常，無法提供IP查詢服務(wù)");
        }
    }
    /**
     * 統(tǒng)一IP查詢?nèi)肟?，自動識別IPv4/IPv6
     * 完整過濾所有內(nèi)網(wǎng)IP，包含10段、172段、192段、本地回環(huán)
     */
    public String getIpRegion(String ip) {
        try {
            // 空IP直接返回
            if (ip == null || ip.isBlank()) {
                return "內(nèi)網(wǎng)IP|內(nèi)網(wǎng)IP";
            }
            // 判斷是否為內(nèi)網(wǎng)IP，包含IPv4全內(nèi)網(wǎng)段 + IPv6回環(huán)
            if (isPrivateIp(ip)) {
                return "內(nèi)網(wǎng)IP|內(nèi)網(wǎng)IP";
            }
            // 調(diào)用ip2region執(zhí)行公網(wǎng)IP查詢
            return ip2Region.search(ip);
        } catch (Exception e) {
            log.error("ip2region IP查詢異常，IP：{}", ip, e);
            return "查詢失敗";
        }
    }
    /**
     * 完整內(nèi)網(wǎng)IP判斷邏輯
     * IPv4內(nèi)網(wǎng)范圍：
     * 1. 127.0.0.1 本地回環(huán)
     * 2. 10.0.0.0 ~ 10.255.255.255
     * 3. 172.16.0.0 ~ 172.31.255.255
     * 4. 192.168.0.0 ~ 192.168.255.255
     * IPv6內(nèi)網(wǎng)：::1 / 0:0:0:0:0:0:0:1 回環(huán)地址
     */
    private boolean isPrivateIp(String ip) {
        // IPv4內(nèi)網(wǎng)判斷
        if (ip.contains(".")) {
            // 本地回環(huán)
            if ("127.0.0.1".equals(ip)) {
                return true;
            }
            // 192.168網(wǎng)段
            if (ip.startsWith("192.168.")) {
                return true;
            }
            // 10網(wǎng)段
            if (ip.startsWith("10.")) {
                return true;
            }
            // 172.16.0.0 ~ 172.31.255.255 內(nèi)網(wǎng)段
            if (ip.startsWith("172.")) {
                String[] parts = ip.split("\\.");
                if (parts.length == 4) {
                    try {
                        int secondSegment = Integer.parseInt(parts[1]);
                        return secondSegment >= 16 && secondSegment <= 31;
                    } catch (NumberFormatException e) {
                        return false;
                    }
                }
            }
            return false;
        }
        // IPv6回環(huán)地址判斷
        return "::1".equals(ip) || "0:0:0:0:0:0:0:1".equals(ip);
    }
    /**
     * 服務(wù)關(guān)閉，釋放ip2region資源
     */
    @PreDestroy
    public void close() {
        try {
            if (ip2Region != null) {
                ip2Region.close();
                log.info("ip2region資源釋放完成");
            }
        } catch (Exception e) {
            log.error("ip2region資源釋放失敗", e);
        }
    }
}

import lombok.RequiredArgsConstructor;
import lombok.extern.slf4j.Slf4j;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.bind.annotation.RestController;
import javax.servlet.http.HttpServletRequest;
@Slf4j
@RestController
@RequestMapping("/ip")
@RequiredArgsConstructor
public class IpController {
    private final IpRegionUtil ipRegionUtil;
    /**
     * 手動傳入IP查詢歸屬地
     * @param ip 目標(biāo)IP
     * @return 歸屬地結(jié)果
     */
    @GetMapping("/query")
    public String queryIp(@RequestParam String ip) {
        return ipRegionUtil.getIpRegion(ip);
    }
    /**
     * 獲取當(dāng)前請求的真實IP并查詢歸屬地
     * 適配Nginx、反向代理場景，解決內(nèi)網(wǎng)IP獲取問題
     */
    @GetMapping("/current")
    public String getCurrentIpRegion(HttpServletRequest request) {
        // 優(yōu)先獲取代理轉(zhuǎn)發(fā)的真實客戶端IP
        String realIp = request.getHeader("X-Real-IP");
        if (realIp == null || realIp.isBlank()) {
            realIp = request.getRemoteAddr();
        }
        log.info("當(dāng)前請求真實客戶端IP：{}", realIp);
        return ipRegionUtil.getIpRegion(realIp);
    }
}

<build>
    <resources>
        <resource>
            <directory>src/main/resources</directory>
            <excludes>
                <exclude>*.xdb</exclude>
            </excludes>
        </resource>
        <resource>
            <directory>src/main/resources</directory>
            <includes>
                <include>*.xdb</include>
            </includes>
            <filtering>false</filtering>
        </resource>
    </resources>
</build>

proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;