在 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
}
}
}
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 同前
}
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),忽略不可信來源 |