在ASP.NET(C#)中如何获取客户端IP地址或客户端机器名？

API 探路者

2026-7-25

如何在生产环境获取客户端真实IP地址

核心原因分析

你的应用在生产环境返回服务器/公网IP，是因为前端存在反向代理（Nginx/Apache）、CDN或负载均衡设备——这些组件会先接收客户端请求，再转发给你的应用服务，导致REMOTE_ADDR读取的是代理设备的IP，而非客户端真实IP。本地环境没有这些中间层，所以直接能拿到客户端IP。

步骤1：配置代理/CDN传递真实IP

必须先让前端代理设备将客户端真实IP通过请求头传递给后端，否则后端无法获取：

Nginx 配置示例

在反向代理的location块中添加：

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

$proxy_add_x_forwarded_for会保留多层代理的IP链，格式为客户端IP, 代理1IP, 代理2IP。

Apache 配置示例

先启用mod_remoteip模块，再添加：

RemoteIPHeader X-Forwarded-For
# 信任你的代理服务器IP/IP段，避免伪造请求头
RemoteIPTrustedProxy 192.168.1.0/24

CDN 配置

如果使用CDN服务，需在CDN后台开启「传递客户端真实IP」选项（不同平台命名可能不同，比如阿里云CDN叫「回源时携带客户端IP」）。

步骤2：后端正确读取真实IP

不能直接读取HTTP_X_FORWARDED_FOR，因为这个请求头可伪造，且多层代理时是IP列表。需按优先级读取并过滤有效IP：

PHP 示例代码

function getClientRealIp() {
    $realIp = '';
    // 优先读取X-Real-IP（部分代理直接传递的真实IP）
    if (!empty($_SERVER['HTTP_X_REAL_IP']) && filter_var($_SERVER['HTTP_X_REAL_IP'], FILTER_VALIDATE_IP)) {
        $realIp = $_SERVER['HTTP_X_REAL_IP'];
    } 
    // 处理X-Forwarded-For的IP链，取第一个有效客户端IP
    elseif (!empty($_SERVER['HTTP_X_FORWARDED_FOR'])) {
        $ipList = array_map('trim', explode(',', $_SERVER['HTTP_X_FORWARDED_FOR']));
        foreach ($ipList as $ip) {
            if (filter_var($ip, FILTER_VALIDATE_IP, FILTER_FLAG_NO_PRIV_RANGE | FILTER_FLAG_NO_RES_RANGE)) {
                $realIp = $ip;
                break;
            }
        }
    } 
    // 兜底用REMOTE_ADDR
    else {
        $realIp = $_SERVER['REMOTE_ADDR'];
    }
    return $realIp;
}

Spring Boot 示例

配置信任代理服务器（application.yml）：

server:
  forward-headers-strategy: framework

通过HttpServletRequest获取：

public String getClientRealIp(HttpServletRequest request) {
    String ip = request.getHeader("X-Real-IP");
    if (ip == null || ip.isEmpty() || "unknown".equalsIgnoreCase(ip)) {
        ip = request.getHeader("X-Forwarded-For");
        if (ip != null && !ip.isEmpty()) {
            // 取第一个非unknown的IP
            String[] ipArray = ip.split(",");
            for (String segment : ipArray) {
                segment = segment.trim();
                if (!"unknown".equalsIgnoreCase(segment)) {
                    ip = segment;
                    break;
                }
            }
        }
    }
    if (ip == null || ip.isEmpty() || "unknown".equalsIgnoreCase(ip)) {
        ip = request.getRemoteAddr();
    }
    return ip;
}

关于客户端机器名的说明

Web应用无法获取客户端机器名：HTTP协议不包含该信息，且浏览器出于安全隐私限制，不会暴露本地机器名。只有内网桌面应用（如Electron、WinForm）可通过本地系统API读取机器名，纯Web场景无法实现。

内容的提问来源于stack exchange，提问作者MFI