萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> 程式語言綜合

C# 取得用戶端真實 IP 與 IP 格式驗證工具

前言

在 ASP.NET 應用中,正確取得客戶端真實 IP 是實作登入審計、風控、地理定位的基礎。本文提供一個健壯的 IpHelper,處理反向代理、負載平衡器下的 X-Forwarded-For 標頭,並內建嚴格的 IPv4 格式驗證。

完整實作

using System;
using System.Text.RegularExpressions;
using System.Web;

namespace CLB.Utility.Tools
{
    public static class IpHelper
    {
        /// 
        /// 取得當前請求的用戶端 IP (支援反向代理)
        /// 
        public static string GetClientIp()
        {
            HttpRequest request = HttpContext.Current?.Request;
            if (request == null) return "0.0.0.0";

            // 1. 優先檢查 X-Forwarded-For (可能包含多個 IP,取第一個非私有)
            string xff = request.ServerVariables["HTTP_X_FORWARDED_FOR"];
            if (!string.IsNullOrWhiteSpace(xff))
            {
                // 格式: "client, proxy1, proxy2" -> 取最左邊的原始客戶端
                string[] ips = xff.Split(',');
                foreach (string ip in ips)
                {
                    string trimmed = ip.Trim();
                    if (IsValidIpv4(trimmed) && !IsPrivateIp(trimmed))
                        return trimmed;
                }
                // 都沒有公網 IP,回傳第一個
                return ips[0].Trim();
            }

            // 2. 回退到 REMOTE_ADDR
            string remote = request.ServerVariables["REMOTE_ADDR"];
            if (!string.IsNullOrWhiteSpace(remote) && IsValidIpv4(remote))
                return remote;

            // 3. 最後回退
            string userHost = request.UserHostAddress;
            if (!string.IsNullOrWhiteSpace(userHost) && IsValidIpv4(userHost))
                return userHost;

            return "0.0.0.0";
        }

        /// 
        /// 嚴格驗證 IPv4 格式 (0.0.0.0 ~ 255.255.255.255)
        /// 
        public static bool IsValidIpv4(string ip)
        {
            if (string.IsNullOrWhiteSpace(ip)) return false;
            // 正則:每段 0-255,不允許前導零 (除非單一 0)
            string pattern = @"^((25[0-5]|2[0-4]\d|1\d{2}|[1-9]?\d)\.){3}(25[0-5]|2[0-4]\d|1\d{2}|[1-9]?\d)$";
            return Regex.IsMatch(ip, pattern);
        }

        /// 
        /// 判斷是否為私有/保留 IP (RFC 1918)
        /// 
        private static bool IsPrivateIp(string ip)
        {
            if (!IsValidIpv4(ip)) return false;
            string[] parts = ip.Split('.');
            int p0 = int.Parse(parts[0]), p1 = int.Parse(parts[1]);
            return (p0 == 10) ||
                   (p0 == 172 && p1 >= 16 && p1 <= 31) ||
                   (p0 == 192 && p1 == 168) ||
                   (p0 == 127) || // loopback
                   (p0 == 169 && p1 == 254); // link-local
        }
    }
}

ASP.NET Core 版本

public static class IpHelperCore
{
    public static string GetClientIp(HttpContext context)
    {
        if (context == null) return "0.0.0.0";

        // 支援 ForwardedHeadersMiddleware (需在 Startup 配置)
        string ip = context.Request.Headers["X-Forwarded-For"].FirstOrDefault();
        if (!string.IsNullOrWhiteSpace(ip))
        {
            string[] ips = ip.Split(',');
            foreach (string candidate in ips)
            {
                string trimmed = candidate.Trim();
                if (IsValidIpv4(trimmed) && !IsPrivateIp(trimmed))
                    return trimmed;
            }
            return ips[0].Trim();
        }

        // 直接連線
        var remote = context.Connection.RemoteIpAddress;
        if (remote != null)
        {
            string ipStr = remote.MapToIPv4().ToString();
            if (IsValidIpv4(ipStr)) return ipStr;
        }
        return "0.0.0.0";
    }
    // IsValidIpv4, IsPrivateIp 同前
}

Startup 配置 (ASP.NET Core)

public void ConfigureServices(IServiceCollection services)
{
    services.Configure(options =>
    {
        options.ForwardedHeaders = ForwardedHeaders.XForwardedFor | ForwardedHeaders.XForwardedProto;
        // 清除 KnownNetworks/KnownProxies 以信任所有代理 (僅限受信任網路)
        options.KnownNetworks.Clear();
        options.KnownProxies.Clear();
    });
}

public void Configure(IApplicationBuilder app)
{
    app.UseForwardedHeaders(); // 必須在 UseAuthentication/UseMvc 之前
    // ...
}

常見陷阱與對策

情境問題對策
Nginx/IIS 反向代理只看到代理伺服器 IP配置 proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; 並啟用 ForwardedHeadersMiddleware
CDN (Cloudflare, Akamai)多層代理,XFF 包含多個 IP取最左邊非私有 IP;或使用 CF-Connecting-IP (Cloudflare 專用)
IPv6 環境取得 ::1 或 IPv6 位址用 MapToIPv4() 轉換,或直接支援 IPv6 儲存
偽造標頭惡意用戶偽造 XFF只信任已知代理 IP 範圍 (KnownProxies),忽略不可信來源
copyright © 萬盛學電腦網 all rights reserved