SpringBoot中获取真实客户端IP的终极方案,99%的人都没做对!

SpringBoot项目实战:5分钟搞定ip2region离线IP库集成(含Nginx代理IP获取避坑指南) 本文详细介绍了如何在SpringBoot项目中快速集成ip2region离线IP库,实现精准IP定位功能。通过5分钟快速部署指南,开发者可以轻松获取用户IP归属地信息,同时提供了Nginx代理环境下获取真实IP的避坑方案,确保生产环境中的高准确率和稳定性。 阅读详情

👉 这是一个或许对你有用的社群

🐱 一对一交流/面试小册/简历优化/求职解惑,欢迎加入「芋道快速开发平台」知识星球。下面是星球提供的部分资料: 

👉这是一个或许对你有用的开源项目

国产Star破10w的开源项目,前端包括管理后台、微信小程序,后端支持单体、微服务架构

RBAC权限、数据权限、SaaS多租户、商城、支付、工作流、大屏报表、ERP、CRM、AI大模型、IoT物联网等功能:

  • 多模块:https://gitee.com/zhijiantianya/ruoyi-vue-pro

  • 微服务:https://gitee.com/zhijiantianya/yudao-cloud

  • 视频教程:https://doc.iocoder.cn

【国内首批】支持 JDK17/21+SpringBoot3、JDK8/11+Spring Boot2双版本 

来源:夏壹分享


引言:为什么你的IP获取方式大概率是错的?

在日常后端开发中,获取客户端IP看似是基础操作,实则藏着不少容易踩的坑。

很多开发者直接调用request.getRemoteAddr()方法获取IP,结果到了生产环境才发现,拿到的全是负载均衡器、网关这类中间件的IP,根本不是用户的真实IP。

更危险的是,部分不规范的获取方案还存在安全漏洞,可能被恶意用户伪造IP地址,给系统带来安全风险。

今天,我就以资深架构师的视角,把Spring Boot中获取真实客户端IP的正确方法讲透,帮你避开所有坑!

基于 Spring Boot + MyBatis Plus + Vue & Element 实现的后台管理系统 + 用户小程序,支持 RBAC 动态权限、多租户、数据权限、工作流、三方登录、支付、短信、商城等功能

  • 项目地址:https://github.com/YunaiV/ruoyi-vue-pro

  • 视频教程:https://doc.iocoder.cn/video/

一、先搞懂:IP传递的底层逻辑

现代Web系统的请求链路往往要经过多层中间件,典型的链路如下:

用户 → CDN → 负载均衡器 → 网关 → 应用服务器

每一层中间件都会修改请求的相关信息,这也是getRemoteAddr()失效的核心原因。

下面先明确几个核心请求头的含义(可信度从高到低):

请求头字段

含义

可信度

X-Forwarded-For

代理链IP序列

⭐⭐⭐⭐

X-Real-IP

最后一个代理IP

⭐⭐⭐

Proxy-Client-IP

Apache代理IP

⭐⭐

WL-Proxy-Client-IP

WebLogic代理IP

⭐⭐

重点中的重点!X-Forwarded-For是获取真实IP的核心字段,但90%的开发者都用错了!

该字段的格式规则:

X-Forwarded-For: 客户端真实IP, 代理服务器1IP, 代理服务器2IP, ...

核心规则(务必记牢):

  • 最左侧的IP是原始客户端的真实IP;

  • 后续的IP是请求经过的各级代理服务器IP;

  • 多个IP之间用英文逗号分隔。

实际业务场景示例:

// 无代理场景
X-Forwarded-For: null

// 单代理场景
X-Forwarded-For: 123.45.67.89

// 两级代理场景
X-Forwarded-For: 123.45.67.89, 10.0.1.100

// 多级代理场景
X-Forwarded-For: 123.45.67.89, 203.0.113.195, 198.51.100.10

基于 Spring Cloud Alibaba + Gateway + Nacos + RocketMQ + Vue & Element 实现的后台管理系统 + 用户小程序,支持 RBAC 动态权限、多租户、数据权限、工作流、三方登录、支付、短信、商城等功能

  • 项目地址:https://github.com/YunaiV/yudao-cloud

  • 视频教程:https://doc.iocoder.cn/video/

二、终极方案:生产级IP工具类(可直接复用)

下面这个工具类经过海量生产环境验证,解决了IP伪造、内网IP过滤、多级代理等问题,直接复制就能用!

import javax.servlet.http.HttpServletRequest;
import java.util.Arrays;
import java.util.HashSet;
import java.util.Set;

/**
 * IP工具类
 * 功能:安全获取客户端真实IP,过滤内网IP、伪造IP,兼容多级代理场景
 * 适用:Spring Boot/Spring MVC项目
 */
publicclass IpUtils {

    // 未知IP标识
    privatestaticfinal String UNKNOWN = "unknown";
    // 本地回环IP(IPv4)
    privatestaticfinal String LOCALHOST_IP = "127.0.0.1";
    // 本地回环IP(IPv6)
    privatestaticfinal String LOCALHOST_IPV6 = "0:0:0:0:0:0:0:1";
    // IP分隔符(X-Forwarded-For中多IP的分隔符)
    privatestaticfinal String SEPARATOR = ",";

    // 内网IP段(需过滤的非公网IP)
    privatestaticfinal Set<String> INTERNAL_IP_SEGMENTS = new HashSet<>(Arrays.asList(
        "10.", "192.168.", 
        "172.16.", "172.17.", "172.18.", "172.19.",
        "172.20.", "172.21.", "172.22.", "172.23.", 
        "172.24.", "172.25.", "172.26.", "172.27.", 
        "172.28.", "172.29.", "172.30.", "172.31."
    ));

    /**
     * 获取客户端真实公网IP
     * @param request HttpServletRequest请求对象
     * @return 客户端真实IP(优先公网IP,无公网IP则返回内网/本地IP)
     */
    public static String getClientRealIp(HttpServletRequest request) {
        // 1. 优先解析X-Forwarded-For头(核心字段)
        String ip = parseXForwardedFor(request.getHeader("X-Forwarded-For"));
        if (isValidPublicIp(ip)) {
            return ip;
        }

        // 2. 解析其他代理相关头字段
        ip = getIpFromHeaders(request);
        if (isValidPublicIp(ip)) {
            return ip;
        }

        // 3. 最后降级使用getRemoteAddr(大概率是代理IP)
        ip = request.getRemoteAddr();
        // 兼容IPv6本地回环地址转换
        return LOCALHOST_IPV6.equals(ip) ? LOCALHOST_IP : ip;
    }

    /**
     * 解析X-Forwarded-For头,提取有效IP
     * 逻辑:从后往前过滤内网IP,优先返回第一个有效公网IP;无公网IP则返回第一个有效IP
     * @param xffHeader X-Forwarded-For头值
     * @return 解析后的IP(null表示无有效IP)
     */
    private static String parseXForwardedFor(String xffHeader) {
        // 空值直接返回null
        if (xffHeader == null || xffHeader.trim().isEmpty()) {
            returnnull;
        }

        // 按逗号分割多IP
        String[] ips = xffHeader.split(SEPARATOR);

        // 第一步:从后往前找第一个有效公网IP(过滤内网IP)
        for (int i = ips.length - 1; i >= 0; i--) {
            String ip = ips[i].trim();
            // IP格式合法 + 非内网IP = 有效公网IP
            if (isValidIp(ip) && !isInternalIp(ip)) {
                return ip;
            }
        }

        // 第二步:无公网IP时,返回第一个格式合法的IP(可能是内网IP)
        for (String ip : ips) {
            String trimmedIp = ip.trim();
            if (isValidIp(trimmedIp)) {
                return trimmedIp;
            }
        }

        // 无任何有效IP
        returnnull;
    }

    /**
     * 从其他代理头中提取IP
     * @param request HttpServletRequest请求对象
     * @return 提取到的IP(null表示无有效IP)
     */
    private static String getIpFromHeaders(HttpServletRequest request) {
        // 常见的代理IP头字段列表
        String[] headers = {
            "X-Real-IP", "Proxy-Client-IP", "WL-Proxy-Client-IP",
            "HTTP_CLIENT_IP", "HTTP_X_FORWARDED_FOR"
        };

        // 遍历头字段,找到第一个有效IP
        for (String header : headers) {
            String ip = request.getHeader(header);
            if (isValidIp(ip)) {
                return ip;
            }
        }
        returnnull;
    }

    /**
     * 校验IP是否为有效格式(排除unknown、空值)
     * @param ip 待校验IP
     * @return true=有效,false=无效
     */
    private static boolean isValidIp(String ip) {
        return ip != null &&
               !ip.isEmpty() &&
               !UNKNOWN.equalsIgnoreCase(ip) &&
               isValidIpAddress(ip);
    }

    /**
     * 校验IP是否为有效公网IP
     * @param ip 待校验IP
     * @return true=有效公网IP,false=内网/本地/无效IP
     */
    private static boolean isValidPublicIp(String ip) {
        return isValidIp(ip) && !isInternalIp(ip) && !isLocalhost(ip);
    }

    /**
     * 判断是否为内网IP
     * @param ip 待判断IP
     * @return true=内网IP,false=公网IP
     */
    private static boolean isInternalIp(String ip) {
        if (ip == null) returnfalse;
        // 匹配内网IP段前缀
        return INTERNAL_IP_SEGMENTS.stream().anyMatch(ip::startsWith);
    }

    /**
     * 判断是否为本地回环IP
     * @param ip 待判断IP
     * @return true=本地IP,false=非本地IP
     */
    private static boolean isLocalhost(String ip) {
        return LOCALHOST_IP.equals(ip) || LOCALHOST_IPV6.equals(ip);
    }

    /**
     * 校验IP地址格式是否合法(支持IPv4/IPv6)
     * @param ip 待校验IP
     * @return true=格式合法,false=格式非法
     */
    public static boolean isValidIpAddress(String ip) {
        if (ip == null || ip.isEmpty()) returnfalse;

        // IPv4格式正则
        String ipv4Pattern = "^((25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\\.){3}(25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)$";
        if (ip.matches(ipv4Pattern)) returntrue;

        // 简单判断IPv6(包含冒号即认为合法,如需严格校验可补充正则)
        if (ip.contains(":")) returntrue;

        // 其他格式均为非法
        returnfalse;
    }
}

三、Spring Boot配置:让应用识别代理IP

想要让应用正确识别代理传递的真实IP,必须配置Tomcat信任指定的内网代理,避免被伪造IP攻击。

方式1:Java代码配置
import org.springframework.boot.web.embedded.tomcat.TomcatServletWebServerFactory;
import org.springframework.boot.web.server.WebServerFactoryCustomizer;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;

/**
 * Tomcat代理配置
 * 功能:让Tomcat信任内网代理,正确解析X-Forwarded-For头
 */
@Configuration
publicclass TomcatProxyConfig {

    /**
     * 自定义Tomcat配置,支持代理IP解析
     * @return WebServerFactoryCustomizer
     */
    @Bean
    public WebServerFactoryCustomizer<TomcatServletWebServerFactory> tomcatProxyCustomizer() {
        return factory -> factory.addConnectorCustomizers(connector -> {
            // 放宽请求字符限制(非核心,可选)
            connector.setProperty("relaxedQueryChars", "|{}[]");
            connector.setProperty("relaxedPathChars", "|{}[]");
            
            // 指定解析真实IP的头字段
            connector.setProperty("remoteIpHeader", "x-forwarded-for");
            // 指定解析协议的头字段(http/https)
            connector.setProperty("protocolHeader", "x-forwarded-proto");

            // 配置信任的内网代理IP段(核心!只信任内网代理,防止伪造)
            connector.setProperty("internalProxies",
                "192\\.168\\.\\d{1,3}\\.\\d{1,3}|10\\.\\d{1,3}\\.\\d{1,3}\\.\\d{1,3}|172\\.(1[6-9]|2[0-9]|3[0-1])\\.\\d{1,3}\\.\\d{1,3}");
        });
    }
}
方式2:YAML配置(更推荐)
server:
  tomcat:
    # 配置Tomcat解析真实IP的核心参数
    remoteip:
      # 指定从X-Forwarded-For头获取真实IP
      remote-ip-header:x-forwarded-for
      # 指定从X-Forwarded-Proto头获取请求协议
      protocol-header:x-forwarded-proto
      # 信任的内网代理IP段(正则表达式)
      internal-proxies:|
        192\.168\.\d{1,3}\.\d{1,3}|10\.\d{1,3}\.\d{1,3}\.\d{1,3}|
        172\.(1[6-9]|2[0-9]|3[0-1])\.\d{1,3}\.\d{1,3}

spring:
mvc:
    # 开启请求详情日志(调试用,生产可关闭)
    log-request-details:true

四、进阶功能:IP拦截与安全防护

获取到真实IP后,可基于IP做日志记录、黑名单拦截、频率限制等安全防护,下面是生产级的实现示例。

1. IP日志拦截器(记录访问日志)
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.springframework.web.servlet.HandlerInterceptor;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;

/**
 * IP日志拦截器
 * 功能:记录每个请求的真实IP、访问路径、客户端信息
 */
publicclass IpLoggingInterceptor implements HandlerInterceptor {

    privatestaticfinal Logger logger = LoggerFactory.getLogger(IpLoggingInterceptor.class);

    /**
     * 请求处理前执行(记录IP日志)
     * @param request 请求对象
     * @param response 响应对象
     * @param handler 处理器
     * @return true=放行,false=拦截
     */
    @Override
    public boolean preHandle(HttpServletRequest request,
                           HttpServletResponse response,
                           Object handler) {
        // 获取真实IP并存入请求属性
        String clientIp = IpUtils.getClientRealIp(request);
        request.setAttribute("clientRealIp", clientIp);

        // 记录访问日志(包含核心信息)
        logger.info("客户端访问日志 - IP: {}, URI: {}, User-Agent: {}",
                   clientIp,
                   request.getRequestURI(),
                   request.getHeader("User-Agent"));

        // 放行请求
        returntrue;
    }
}

import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.web.servlet.config.annotation.InterceptorRegistry;
import org.springframework.web.servlet.config.annotation.WebMvcConfigurer;

/**
 * WebMVC配置
 * 功能:注册拦截器,配置拦截规则
 */
@Configuration
publicclass WebMvcConfig implements WebMvcConfigurer {

    /**
     * 注入IP日志拦截器
     * @return IpLoggingInterceptor
     */
    @Bean
    public IpLoggingInterceptor ipLoggingInterceptor() {
        returnnew IpLoggingInterceptor();
    }

    /**
     * 注册拦截器,配置拦截/放行路径
     * @param registry 拦截器注册器
     */
    @Override
    public void addInterceptors(InterceptorRegistry registry) {
        registry.addInterceptor(ipLoggingInterceptor())
                // 拦截所有路径
                .addPathPatterns("/**")
                // 放行健康检查、监控指标接口
                .excludePathPatterns("/health", "/metrics");
    }
}
2. IP安全过滤器(黑名单+频率限制)
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import javax.servlet.*;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import java.io.IOException;
import java.util.Map;
import java.util.Set;
import java.util.concurrent.ConcurrentHashMap;
import java.util.concurrent.ConcurrentMap;

/**
 * IP安全过滤器
 * 功能:IP黑名单拦截、访问频率限制、可疑请求检测
 */
publicclass IpSecurityFilter implements Filter {

    privatestaticfinal Logger logger = LoggerFactory.getLogger(IpSecurityFilter.class);

    // IP黑名单(线程安全)
    privatefinal Set<String> blacklistedIps = ConcurrentHashMap.newKeySet();
    // 访问频率限制缓存(key=IP,value=频率限制信息)
    privatefinal ConcurrentMap<String, RateLimitInfo> rateLimitMap = new ConcurrentHashMap<>();

    /**
     * 过滤器核心逻辑
     * @param request 请求对象
     * @param response 响应对象
     * @param chain 过滤器链
     */
    @Override
    public void doFilter(ServletRequest request, ServletResponse response,
                        FilterChain chain) throws IOException, ServletException {
        HttpServletRequest httpRequest = (HttpServletRequest) request;
        HttpServletResponse httpResponse = (HttpServletResponse) response;
        
        // 获取客户端真实IP
        String clientIp = IpUtils.getClientRealIp(httpRequest);

        // 1. 黑名单校验:命中则拦截
        if (blacklistedIps.contains(clientIp)) {
            logSecurityEvent("IP黑名单拦截", clientIp, httpRequest);
            sendErrorResponse(httpResponse, 403, "您的IP已被禁止访问");
            return;
        }

        // 2. 频率限制校验:访问过频则拦截
        if (isRateLimited(clientIp)) {
            logSecurityEvent("频率限制拦截", clientIp, httpRequest);
            sendErrorResponse(httpResponse, 429, "访问过于频繁,请稍后再试");
            return;
        }

        // 3. 可疑请求校验:检测异常行为
        if (isSuspiciousRequest(clientIp, httpRequest)) {
            logSecurityEvent("可疑请求拦截", clientIp, httpRequest);
            blacklistedIps.add(clientIp); // 加入黑名单
            sendErrorResponse(httpResponse, 403, "检测到异常访问行为,IP已被限制");
            return;
        }

        // 所有校验通过,放行请求
        chain.doFilter(request, response);
    }

    /**
     * 频率限制校验
     * 规则:1分钟内最多60次请求
     * @param ip 客户端IP
     * @return true=触发限制,false=未触发
     */
    private boolean isRateLimited(String ip) {
        // 不存在则初始化频率信息
        RateLimitInfo info = rateLimitMap.computeIfAbsent(ip, k -> new RateLimitInfo());
        long currentTime = System.currentTimeMillis();

        // 时间窗口过期(超过1分钟),重置计数
        if (currentTime - info.getWindowStart() > 60000) {
            info.reset(60, currentTime);
        }

        // 尝试获取令牌:无令牌则触发限制
        return !info.tryAcquire();
    }

    /**
     * 可疑请求检测
     * 规则:无User-Agent、访问敏感路径视为可疑
     * @param ip 客户端IP
     * @param request 请求对象
     * @return true=可疑,false=正常
     */
    private boolean isSuspiciousRequest(String ip, HttpServletRequest request) {
        // 1. 无User-Agent视为可疑
        String userAgent = request.getHeader("User-Agent");
        if (userAgent == null || userAgent.trim().isEmpty()) {
            returntrue;
        }

        // 2. 访问敏感路径视为可疑(后台管理、数据库管理等)
        String uri = request.getRequestURI().toLowerCase();
        if (uri.contains("admin") || uri.contains("phpmyadmin") ||
            uri.contains("wp-admin") || uri.contains("shell")) {
            returntrue;
        }

        // 无异常行为
        returnfalse;
    }

    /**
     * 发送错误响应
     * @param response 响应对象
     * @param status 状态码
     * @param message 错误信息
     */
    private void sendErrorResponse(HttpServletResponse response, int status, String message)
            throws IOException {
        response.setStatus(status);
        response.setContentType("application/json;charset=utf-8");
        response.getWriter().write("{\"code\": " + status + ", \"message\": \"" + message + "\"}");
    }

    /**
     * 记录安全事件日志
     * @param event 事件类型
     * @param ip 客户端IP
     * @param request 请求对象
     */
    private void logSecurityEvent(String event, String ip, HttpServletRequest request) {
        logger.warn("安全事件触发 - 类型: {}, IP: {}, URI: {}, User-Agent: {}",
                   event, ip, request.getRequestURI(), request.getHeader("User-Agent"));
    }

    /**
     * 频率限制信息封装
     * 内部类:记录令牌数、时间窗口起始时间
     */
    privatestaticclass RateLimitInfo {
        // 剩余令牌数(每请求消耗1个)
        privateint tokens;
        // 时间窗口起始时间
        privatelong windowStart;
        // 最大令牌数(1分钟60个)
        privatefinalint maxTokens = 60;

        /**
         * 初始化:默认填充最大令牌,时间窗口为当前时间
         */
        RateLimitInfo() {
            reset(maxTokens, System.currentTimeMillis());
        }

        /**
         * 重置频率限制信息
         * @param tokens 令牌数
         * @param windowStart 时间窗口起始时间
         */
        void reset(int tokens, long windowStart) {
            this.tokens = tokens;
            this.windowStart = windowStart;
        }

        /**
         * 尝试获取令牌
         * @return true=获取成功,false=无令牌
         */
        boolean tryAcquire() {
            if (tokens > 0) {
                tokens--;
                returntrue;
            }
            returnfalse;
        }

        // 获取时间窗口起始时间
        long getWindowStart() {
            return windowStart;
        }
    }
}

五、测试验证:确保IP获取准确

为了验证IP获取逻辑是否正确,我们可以编写调试接口和单元测试,覆盖不同场景。

1. IP调试接口
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;
import javax.servlet.http.HttpServletRequest;
import java.util.LinkedHashMap;
import java.util.Map;

/**
 * IP调试控制器
 * 功能:提供接口查看IP相关信息,验证获取逻辑
 */
@RestController
publicclass IpDebugController {

    /**
     * 调试IP获取结果
     * @param request 请求对象
     * @return IP相关信息
     */
    @GetMapping("/debug/ip")
    public Map<String, Object> debugIp(HttpServletRequest request) {
        Map<String, Object> result = new LinkedHashMap<>();

        // 核心:真实客户端IP
        result.put("真实客户端IP", IpUtils.getClientRealIp(request));
        // 对比:原生RemoteAddr
        result.put("RemoteAddr", request.getRemoteAddr());
        // 各IP头字段原始值
        result.put("X-Forwarded-For", request.getHeader("X-Forwarded-For"));
        result.put("X-Real-IP", request.getHeader("X-Real-IP"));
        result.put("Proxy-Client-IP", request.getHeader("Proxy-Client-IP"));
        result.put("WL-Proxy-Client-IP", request.getHeader("WL-Proxy-Client-IP"));
        // 其他请求信息
        result.put("请求方法", request.getMethod());
        result.put("请求URI", request.getRequestURI());
        result.put("User-Agent", request.getHeader("User-Agent"));

        return result;
    }

    /**
     * 获取所有IP相关头字段
     * @param request 请求对象
     * @return IP头字段键值对
     */
    @GetMapping("/debug/ip-headers")
    public Map<String, String> getAllIpHeaders(HttpServletRequest request) {
        Map<String, String> headers = new LinkedHashMap<>();

        // 常见IP相关头字段列表
        String[] ipHeaders = {
            "X-Forwarded-For", "X-Real-IP", "Proxy-Client-IP",
            "WL-Proxy-Client-IP", "HTTP_X_FORWARDED_FOR", "HTTP_X_FORWARDED",
            "HTTP_X_CLUSTER_CLIENT_IP", "HTTP_CLIENT_IP", "HTTP_FORWARDED_FOR",
            "HTTP_FORWARDED", "HTTP_VIA", "REMOTE_ADDR"
        };

        // 遍历获取非空头字段
        for (String header : ipHeaders) {
            String value = request.getHeader(header);
            if (value != null && !value.trim().isEmpty()) {
                headers.put(header, value);
            }
        }

        return headers;
    }
}
2. 单元测试(覆盖核心场景)
import org.junit.jupiter.api.Test;
import org.springframework.mock.web.MockHttpServletRequest;
importstatic org.junit.jupiter.api.Assertions.assertEquals;

/**
 * IpUtils单元测试
 * 覆盖场景:直接访问、单代理、多级代理、IPv6
 */
class IpUtilsTest {

    @Test
    void testGetClientRealIp() {
        MockHttpServletRequest request = new MockHttpServletRequest();

        // 场景1:无代理,直接访问
        request.setRemoteAddr("123.45.67.89");
        assertEquals("123.45.67.89", IpUtils.getClientRealIp(request));

        // 场景2:单代理,X-Forwarded-For包含真实IP
        request.addHeader("X-Forwarded-For", "123.45.67.89");
        request.setRemoteAddr("10.0.0.1"); // 代理IP
        assertEquals("123.45.67.89", IpUtils.getClientRealIp(request));

        // 场景3:多级代理,X-Forwarded-For包含多个IP
        request.addHeader("X-Forwarded-For", "123.45.67.89, 10.0.1.100, 10.0.1.101");
        assertEquals("123.45.67.89", IpUtils.getClientRealIp(request));

        // 场景4:IPv6地址
        request.addHeader("X-Forwarded-For", "2001:db8::1");
        assertEquals("2001:db8::1", IpUtils.getClientRealIp(request));
    }
}

六、生产环境最佳实践

1. 动态配置信任代理IP: 将信任的代理IP列表配置在Nacos/Apollo等配置中心,支持动态更新,无需重启应用。

2. 环境隔离配置: 开发、测试、生产环境配置不同的代理规则,比如开发环境信任本地所有IP,生产环境仅信任指定内网代理。

import org.springframework.stereotype.Component;

/**
 * IP监控服务
 * 功能:处理黑名单事件、清理频率限制缓存
 */
@Component
publicclass IpMonitor {

    /**
     * 处理黑名单新增事件
     * @param event 黑名单事件
     */
    public void handleBlacklistEvent(BlacklistEvent event) {
        // 示例:发送告警通知(可对接邮件、短信、钉钉等)
        alertService.sendAlert("IP黑名单新增: " + event.getIp());
    }

    /**
     * 定时清理频率限制缓存(避免内存泄漏)
     */
    public void cleanupRateLimit() {
        // 示例:清理超过1小时未访问的IP频率信息
        rateLimitMap.entrySet().removeIf(entry -> 
            System.currentTimeMillis() - entry.getValue().getWindowStart() > 3600000
        );
    }

    // 告警服务(需自行实现)
    private AlertService alertService;
}

// 黑名单事件(示例)
class BlacklistEvent {
    private String ip;

    public String getIp() {
        return ip;
    }

    public void setIp(String ip) {
        this.ip = ip;
    }
}

3. 分布式频率限制: 高并发场景下,将频率限制逻辑迁移到Redis,实现分布式限流,避免单机缓存失效。

4. 合理缓存IP结果: 对IP获取结果做短期缓存(比如10秒),减少重复解析开销,但缓存时间不宜过长,避免IP变更后无法及时感知。

七、常见问题排查

1. 问题:获取的IP还是代理IP,不是真实用户IP?

解决方案:检查负载均衡器/网关是否正确配置X-Forwarded-For头,确保代理会把真实IP写入该头字段。

2. 问题:多级代理场景下,解析出的IP还是内网IP?

解决方案:使用本文提供的parseXForwardedFor方法,该方法会从后往前过滤内网IP,优先返回公网IP。

3. 问题:担心客户端伪造X-Forwarded-For头?

解决方案:通过internal-proxies配置仅信任内网代理服务器,应用会忽略客户端直接传递的X-Forwarded-For头,只解析代理服务器转发的头字段。

总结

获取真实客户端IP是Web开发的基础但关键能力,错误的实现方式不仅会导致业务数据不准,还可能引入安全风险。

通过本文的方案,你可以:

  • 精准解析多级代理下的真实IP;

  • 过滤内网IP、伪造IP,保证IP真实性;

  • 基于真实IP实现日志、黑名单、频率限制等安全防护;

  • 适配生产环境的高并发、分布式场景。

核心原则:永远不要信任客户端直接传递的任何信息,所有IP相关字段必须经过可信代理服务器转发后再解析。


欢迎加入我的知识星球,全面提升技术能力。

👉 加入方式,“长按”或“扫描”下方二维码噢:

星球的内容包括:项目实战、面试招聘、源码解析、学习路线。

文章有帮助的话,在看,转发吧。
谢谢支持哟 (*^__^*)
4个致命坑!SpringBoot防盗链实现,99%开发者都踩过! 摘要: 本文揭露了防盗链的4个致命陷阱,通过代码对比和案例分析,帮助开发者避免常见错误: Referer伪造:简单contains()检查易被绕过,需精确解析域名; CDN影响:直接获取IP会误判,需正确处理X-Forwarded-For; 微信兼容性:微信浏览器无Referer,需识别UA特殊放行; 性能损耗:全局拦截导致资源浪费,应精准配置拦截路径。文末附实战案例,展示某社交平台从流量异常到有效防护的优化过程,强调安全与性能的平衡。 (150字,完整覆盖核心问题与解决方案) 阅读详情

相关推荐

【支付系统】java springboot 通过ip获取所在地城市信息

我们可以获取到用户发起支付时的ip,我们只需要再获取到用户扫码时的ip进行对比,即可知道当前是否为异地支付.当然我们不能直接对比ip,因为用户通常使用pc端发起支付获取付款码,而支付时采用的是移动端.两端未必处于同一个网络,因此ip也是不同的.如果搭建自己的支付平台,异地支付限制是必不可少的一环.因为市面上一些非法份子,会使用我们平台生成的付款码进行欺诈行为.这也是我们必须杜绝的一种现象.因此限制异地支付就是其中一种手段.4. 使用方式 这里我们获取的是省份,也可以通过实际情况进行调整。

qq_39078783的博客 717

springboot获取客户端IP及IP归属地

1.reqest对象获取客户端IP,2.第三方接口获取IP属地。

qq_18469963的博客 1万+

java非常强的获取客户端真实IP的两种方法

Java获取客户端真实的IP的两种实现方法,即使通过多级代理也能获取到,很有用

Spring Boot获取客户端的IP地址

在Web应用程序中,获取客户端的IP地址是一项非常常见的需求,例如记录访问日志、过滤恶意IP等。在本文中,我们将介绍如何使用Spring Boot框架获取客户端的IP地址。1.使用HttpServletRequest对象2.使用ServletRequestAttributes对象3.使用X-Forwarded-For头当我们需要获取客户端的真实IP地址时,应该使用X-Forwarded-For头解决代理服务器和匿名代理服务器的问题。

不愧是暮言的博客 1万+

springboot 获取访问者的ip地址、访问设备信息、城市地址信息的源码.zip

文章springboot 获取访问者的ip地址、访问设备信息、城市地址信息的源码 文章springboot 获取访问者的ip地址、访问设备信息、城市地址信息的源码 文章springboot 获取访问者的ip地址、访问设备信息、城市地址信息的源码 文章springboot 获取访问者的ip地址、访问设备信息、城市地址信息的源码 文章springboot 获取访问者的ip地址、访问设备信息、城市地址信息的源码

Krylov子空间与Arnoldi过程

一、应用背景 Krylov子空间方法是模型降阶(MOR)的一种,Krylov 子空间方法就是在Krylov子空间中寻找近似解。 二、Krylov子空间 n是原始矩阵的维度,m为降阶后矩阵的维度,通常m<<n。 三、Arnoldi 过程: 计算Km 的一组正交 对应上述MGS过程的python代码: import numpy as np def arnoldi_itera...

保持写作习惯,完成知识沉淀 6005

request getHeader("x-forwarded-for") 获取客户端IP地址

在JSP里,获取客户端的IP地址的方法是:request.getRemoteAddr(),这种方法在大部分情况下都是有效的。但是在通过了 Apache,Nagix等反向代理软件就不能获取到客户端的真实IP地址了。如果使用了反向代理软件,用 request.getRemoteAddr()方法获取的IP地址是:127.0.0.1或 192.168.1.110,而并不是客户端的真实IP。   

c657826604的博客 1510

基于QT的华为网络摄像头二次开发

第一次使用华为的网络摄像头并进行二次开发,网上关于QT对华为网络摄像头的二次开发的文章很少,基于项目的需求做了一些工作,特此记录。 目标: 1、实时预览 2、手动控制录制视频 3、监听告警型号 4、实时获取元数据中的划定区域内的人数 摄像头型号如下: 准备工作: 在购买摄像头后,应当在官网下载对应的开发资料,如果需要权限,则联系华为的技术支持人员。下载资料如下: SDC Development Kit Demo 8.0.T9 SDK DEMO下载地址:https://bbs.hua

xumingyifrend的博客 3170

【SpringBoot】SpringBoot获取不到用户真实IP怎么办

项目部署后发现服务端无法获取到客户端真实的IP地址,这是怎么回事呢?给我都整懵逼了,经过短暂的思考,我发现了问题的真凶,那就是我们使用了Nginx作的请求转发,这才导致了获取不到客户端真实的IP地址,害,看看我是怎么解决的吧!

DreamSun的博客 2509

LVGL v9的lv_scale控件实战:5分钟打造动态仪表盘(附完整代码)

本文详细介绍了LVGL v9中lv_scale控件的实战应用,通过5个关键步骤快速打造动态仪表盘。文章涵盖核心特性解析、代码实现、样式定制及性能优化,适用于工业HMI、智能家居等场景,并附完整代码示例。

gin88的博客 262

手把手教你使用Segformer训练自己的数据

SegFormer 基于Swin transformer 修改

weixin_38353277的博客 2万+

springboot 获得请求ip地址

获得请求的ip地址

weixin_45079974的博客 2156

银河麒麟V10离线升级OpenSSH实战:从编译到回滚全流程

OpenSSH作为Linux系统远程登录的核心组件,其版本升级直接关系到系统安全与等保合规。在信创环境下,银河麒麟V10自带的OpenSSH版本往往无法满足漏洞扫描与安全加固要求,而离线编译升级涉及依赖处理、编译参数、服务替换与回滚方案等多个技术环节。本文围绕银河麒麟V10(x86_64)平台,详细讲解OpenSSH离线升级的完整实操流程,包括环境摸底、依赖包安装、源码编译、配置文件兼容性处理、服务重启验证以及常见问题排查,并分享批量升级与安全加固的工程经验,帮助运维人员在不断网、不重装的前提下一次成功完成

weixin_30582943的博客 391

Spring Boot中获取真实客户端IP的终极方案,99%的人都没做对!

获取真实客户端IP是Web开发中的基础但重要的工作。✅ 正确获取多级代理后的真实客户端IP✅ 有效防止IP地址伪造攻击✅ 实现IP级别的安全防护✅ 具备完整的监控和调试能力不要相信客户端传递的任何信息,始终通过可信的代理服务器头字段来获取真实IP。IpUtils。

m0_69632475的博客 462

【机器学习—评估指标】混淆矩阵、准确率、精确率、召回率、F1分数、ROC曲线和AUC

机器学习评价指标是衡量模型性能的关键工具。本文介绍了常见指标及其计算方法:1.混淆矩阵展示分类预测结果分布,包含TP、TN、FP、FN四个基础指标;2.准确率反映整体预测正确率;3.精确率关注预测正例的准确性;4.召回率衡量正例检出能力;5.F1分数综合平衡精确率和召回率;6.ROC曲线通过TPR与FPR的权衡关系评估模型性能,AUC值量化区分能力。文章详细说明了各指标的定义、计算公式、适用场景及局限性,并通过Python代码示例演示了具体实现方法,特别对ROC曲线和AUC的计算原理进行了深入解析。

weixin_51375278的博客 6746

《QGIS快速入门与应用基础》151:批量属性值赋值(字段计算器)

本文介绍了QGIS中字段计算器的批量属性值赋值方法,重点讲解了简单赋值(统一值和递增序列)的操作步骤与表达式应用。文章首先强调数据备份、字段类型确认等必要前提,随后详细解析字段计算器的界面功能分区和打开方式。通过具体场景示例,展示了如何为图层统一赋值固定值或生成连续编号序列,并提供了文本、数字、日期等不同字段类型的表达式模板。文中特别提醒新手优先创建新字段而非直接更新现有字段,以避免数据丢失风险,同时推荐使用$id和rownum()函数实现基础序列生成。该教程适合GIS初学者快速掌握批量属性编辑的核心技能。

LuckyHanMo的博客 491

震惊!Spring Boot中获取真实客户端IP的终极方案,99%的人都没做对!

获取真实客户端IP是Web开发中的基础但重要的工作。✅ 正确获取多级代理后的真实客户端IP✅ 有效防止IP地址伪造攻击✅ 实现IP级别的安全防护✅ 具备完整的监控和调试能力不要相信客户端传递的任何信息,始终通过可信的代理服务器头字段来获取真实IP。如果你有更好的方案或遇到特殊场景,欢迎在评论区交流讨论!原文链接:https://juejin.cn/post/7554225547145232422。

DevDose的博客 356

用miniconda建立PyTorch、Keras、TensorFlow三个环境

如果还没有安装Miniconda,请从[Miniconda官网](https://docs.conda.io/en/latest/miniconda.html)下载合适的版本并进行安装。如果遇到问题,可以通过编辑`~/.condarc`文件来临时禁用某个源,或者通过`conda config --remove channels`命令来移除配置的镜像源。要切换到不同的环境,先使用`conda deactivate`命令退出当前环境,再用`conda activate 环境名称`命令激活另一个环境。

数字人生 2464

springboot获取当前服务ip_springboot免费的IP定位服务

简介ip2region 是准确率99.9%的ip地址定位库,0.0x毫秒级查询,数据库文件大小只有1.5M,提供了java,php,c,python,nodejs,golang,c#查询绑定和Binary,B树,内存三种查询算法!maven依赖org.lionsoulip2region1.7.2下载这个项目之后到data/文件夹下面找到ip2region.db,我放在了/user/home目录下J...

weixin_40001245的博客 2543

win10 跳过U8环境检测的IE WebControls.rar

win10 安装u8的时候 提示IE WebControls 不通过,这个工具可以欺骗u8的检查。 跳过U8环境检测的IE WebControls。提示导入失败后,重新检测通过。

霍尼韦尔SoftMaster使用说明

霍尼韦尔SoftMaster使用说明

SpringBoot 快速实现 IP 地址解析

点击上方“Java基基”,选择“设为星标”做积极的人,而不是积极废人!每天14:00更新文章,每天掉亿点点头发...源码精品专栏原创 | Java 2021超神之路,很肝~中文详细注释的开源项目RPC 框架 Dubbo 源码解析网络应用框架 Netty 源码解析消息中间件 RocketMQ 源码解析数据库中间件 Sharding-JDBC 和 MyCAT 源码解析作业调度中间件 Elast...

weixin_44421461的博客 351

Statistics and Machine Learning Toolbox

Statistics and Machine Learning Toolbox(带书签),MATLAB统计学习工具

全网显示IP归属地,准确率99.9%,这个开源的 API 离线库强大到离谱!

来源|juejin.cn/post/7306334713992708122???? 欢迎加入小哈的星球,你将获得:专属的项目实战 / Java 学习路线 /一对一提问 / 学习打卡 / 赠书福利全栈前后端分离博客项目 1.0 版本完结啦,2.0 正在更新中...,演示链接:http://116.62.199.48/,全程手摸手,后端 + 前端全栈开发,从 0 到 1 讲解每个功能点开发步骤,...

犬小哈 619

IEM模型,地表粗糙度模拟

利用微波反演土壤水分时候,利用IEM模型可以实现对随机地表的模拟

springboot Ip浏览器信息

官方ip2region-准确率99.9%的离线IP地址定位库,0.0x毫秒级查询,ip2region.db数据库只有数MB,提供了java,php,c,python,nodejs,golang,c#等查询绑定和Binary,B树,内存三种查询算法其实就是一个库,用于IP地址解析定位用的,支持很多客户端,速度很快也不占内存,目前github已经到了10kstar了特性速度快,内置三种查询算法,支持毫秒级查询,全部的查询客户端单次查询都在毫秒级别,内置了三种查询算法。...

大胆刁民的博客 1790

spring boot 整合 ip2region(ip地址库)

Ip2region是什么? ip2region - 准确率99.9%的离线IP地址定位库,0.0x毫秒级查询,ip2region.db数据库只有数MB,提供了java,php,c,python,nodejs,golang,c#等查询绑定和Binary,B树,内存三种查询算法。 Ip2region特性 99.9%准确率 数据聚合了一些知名ip到地名查询提供商的数据,这些是他们官方的的准确率,经测试着实比经典的纯真IP定位准确一些。 ip2region的数据聚合自以下服务商的开放API或者数据(升级程序

点滴记录 6606

99% 准确的定位工具ip2region

【代码】99% 准确的定位工具ip2region。

灵豸 609

从零搭建开发脚手架 根据IP地址定位省份城市和网络供应商

☎️ ☎️ ☎️背景在我的开源项目,现在每天的访问ip蛮多的,但是看不到具体的请求归属地和网络供应商,现在想把这个功能实现掉,后面可用于数据分析哪个省份哪个城市访问热力图等。实现开放WebApi腾讯地图开放接口淘宝API: http://ip.taobao.com/data: {area: “”,country: “中国”,city: “成都”,isp: “电信”,region: “四川”,},code: 0code: 4,那我们来看看开源的实现吧。Ip2region。

2401_89285746的博客 1059
上一篇: 一款现代化、轻量级、跨平台的开源数据库管理客户端
下一篇: Star 1.4k,开源 AI 小说工作台:多模型可接入,长篇创作不再遗忘上下文
公众号-芋道源码
博客等级 码龄10年 1639粉丝 377原创
评论
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

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

抵扣说明:

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

余额充值