当前位置：首页 > 后端开发 > 正文

Java如何获取服务器IP？

admin
后端开发
2025-07-01
3693

在Java中获取服务器IP地址可通过 InetAddress.getLocalHost().getHostAddress()实现，若需多网卡场景，需遍历 NetworkInterface.getNetworkInterfaces()获取所有IP，公网IP需调用第三方API（如ipify.org）获取，注意处理异常及多IP环境筛选逻辑。

在Java开发中,获取服务器IP地址是网络编程、服务部署和日志记录中的常见需求，本文将详细讲解两种核心场景的实现方法：获取当前服务器自身的IP地址和获取客户端访问的IP地址（适用于Web应用），并提供健壮的代码示例和注意事项。

获取当前服务器的IP地址（本机IP）

通过java.net包中的NetworkInterface和InetAddress类，可遍历所有网络接口并筛选有效IP。

Java如何获取服务器IP？第1张

完整代码示例：

import java.net.*;
import java.util.*;
public class ServerIPExample {
    public static void main(String[] args) {
        try {
            // 获取所有网络接口
            Enumeration<NetworkInterface> interfaces = NetworkInterface.getNetworkInterfaces();
            while (interfaces.hasMoreElements()) {
                NetworkInterface iface = interfaces.nextElement();
                // 过滤无效接口：未启用、回环接口（如127.0.0.1）、虚拟接口
                if (iface.isLoopback() || !iface.isUp() || iface.isVirtual()) continue;
                // 遍历接口绑定的所有IP地址
                Enumeration<InetAddress> addresses = iface.getInetAddresses();
                while (addresses.hasMoreElements()) {
                    InetAddress addr = addresses.nextElement();
                    // 筛选IPv4地址（排除IPv6和链路本地地址）
                    if (addr instanceof Inet4Address && !addr.isLinkLocalAddress()) {
                        System.out.println("服务器IP: " + addr.getHostAddress());
                    }
                }
            }
        } catch (SocketException e) {
            System.err.println("获取网络接口失败: " + e.getMessage());
        }
    }
}

关键说明：

过滤无效接口：
- isLoopback()：排除回环地址（0.0.1）。
- isUp()：确保接口已启用。
- isVirtual()：跳过虚拟网卡（如Docker创建的接口）。
筛选有效IP：
- Inet4Address：优先选择IPv4地址（多数场景适用）。
- isLinkLocalAddress()：排除链路本地地址（如254.x.x）。
多网卡处理：代码会遍历所有物理网卡，返回多个IP时需根据业务选择（如按接口名eth0筛选）。

获取客户端IP地址（Web应用场景）

在Servlet或Spring框架中,通过HTTP请求对象解析客户端IP，需考虑代理和负载均衡的影响。

Java如何获取服务器IP？第2张

Servlet实现代码：

import javax.servlet.http.HttpServletRequest;
public String getClientIP(HttpServletRequest request) {
    String ip = request.getHeader("X-Forwarded-For"); // 处理代理链
    if (ip == null || ip.isEmpty() || "unknown".equalsIgnoreCase(ip)) {
        ip = request.getHeader("Proxy-Client-IP");
    }
    if (ip == null || ip.isEmpty() || "unknown".equalsIgnoreCase(ip)) {
        ip = request.getHeader("WL-Proxy-Client-IP");
    }
    if (ip == null || ip.isEmpty() || "unknown".equalsIgnoreCase(ip)) {
        ip = request.getRemoteAddr(); // 直接连接IP
    }
    // 处理多级代理：取第一个非unknown的IP
    if (ip != null && ip.contains(",")) {
        ip = ip.split(",")[0].trim();
    }
    return ip;
}

Spring Boot简化版：

@RestController
public class IpController {
    @GetMapping("/client-ip")
    public String getClientIp(HttpServletRequest request) {
        return request.getRemoteAddr(); // 直接获取IP（无代理时）
    }
}

注意事项：

代理优先级：
- X-Forwarded-For：标准代理头（优先级最高）。
- Proxy-Client-IP/WL-Proxy-Client-IP：旧式代理头（如WebLogic）。
安全验证：
- 生产环境需验证IP格式（避免伪造头攻击）。
- 使用正则表达式校验：^([0-9]{1,3}\.){3}[0-9]{1,3}$。
负载均衡场景：
若部署在Nginx/Apache后，需配置代理服务器传递真实IP。

常见问题与解决方案

问题场景	原因与解决方案
返回`0.0.1`或空值	未过滤回环接口 → 检查`isLoopback()`和`isUp()`条件。
多IP时如何选择？	指定网卡名：`NetworkInterface.getByName("eth0")`获取特定接口。
IPv6地址干扰	用`instanceof Inet6Address`单独处理，或直接过滤。
代理返回多个IP	按逗号分割`X-Forwarded-For`，取第一个有效IP。
容器环境（Docker/K8s）	避免虚拟网卡：添加`!iface.getName().startsWith("docker")`等条件。

服务器自身IP：使用NetworkInterface遍历物理接口，结合过滤条件获取IPv4地址。
客户端IP：通过HTTP请求头逐级解析（X-Forwarded-For > Proxy-Client-IP > RemoteAddr）。
生产建议：
- 本地IP获取工具类封装成公共方法。
- Web客户端IP需与运维协作,确保代理层正确传参。
- 敏感操作记录IP时,校验合法性防止伪造。