核心原理澄清
⚠ 關鍵事實:cURL 無法偽造 TCP 層面的來源 IP (REMOTE_ADDR)。所謂「偽造 IP」實際是設置 HTTP 標頭 (X-Forwarded-For, Client-IP, X-Real-IP),僅影響應用層邏輯判斷,無法繞過防火牆、WAF、速率限制等基於網絡層的防護。
可偽造的 HTTP 標頭
| Header | 用途 | 標準化 |
| X-Forwarded-For | 代理鏈傳遞原始客戶端 IP | 事實標準 |
| X-Real-IP | Nginx/反向代理常用 | 約定俗成 |
| Client-IP | 部分舊系統使用 | 非標準 |
| X-Forwarded-Host | 原始 Host | RFC 7239 |
| X-Forwarded-Proto | 原始協議 (http/https) | RFC 7239 |
| Forwarded | RFC 7239 標準化格式 | 標準 |
| Referer | 來源頁面 | 標準 |
| User-Agent | 客戶端標識 | 標準 |
| Cookie | 攜帶 Session | 標準 |
客戶端偽造代碼
<?php
function curlWithSpoofedHeaders($url, array $spoofHeaders = [], array $options = []) {
$defaultHeaders = [
'User-Agent' => 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36',
'Accept' => 'text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8',
'Accept-Language' => 'zh-TW,zh;q=0.9,en;q=0.8',
'Accept-Encoding' => 'gzip, deflate, br',
'Connection' => 'keep-alive',
'Upgrade-Insecure-Requests' => '1',
];
// 合併偽造標頭
$headers = array_merge($defaultHeaders, $spoofHeaders);
$headerLines = [];
foreach ($headers as $k => $v) {
$headerLines[] = "$k: $v";
}
$ch = curl_init($url);
curl_setopt_array($ch, array_merge([
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => $headerLines,
CURLOPT_HEADER => true, // 包含回應頭
CURLOPT_FOLLOWLOCATION => true,
CURLOPT_MAXREDIRS => 5,
CURLOPT_TIMEOUT => 30,
CURLOPT_SSL_VERIFYPEER => true,
CURLOPT_COOKIEJAR => '/tmp/cookies.txt', // 支援 Cookie 會話
CURLOPT_COOKIEFILE => '/tmp/cookies.txt',
], $options));
$response = curl_exec($ch);
$info = curl_getinfo($ch);
$error = curl_error($ch);
curl_close($ch);
if ($error) throw new Exception("cURL Error: $error");
$headerSize = $info['header_size'];
return [
'headers' => substr($response, 0, $headerSize),
'body' => substr($response, $headerSize),
'info' => $info
];
}
// 使用範例:偽造 X-Forwarded-For 與 Referer
try {
$result = curlWithSpoofedHeaders('https://httpbin.org/headers', [
'X-Forwarded-For' => '203.0.113.195, 198.51.100.1', // 模擬經過兩層代理
'X-Real-IP' => '203.0.113.195',
'Referer' => 'https://www.google.com/search?q=test',
'X-Custom-Header' => 'MyApp/1.0'
]);
echo $result['body']; // httpbin 會回傳收到的所有 headers
} catch (Exception $e) {
echo $e->getMessage();
}
?>
伺服器端獲取真實 IP 的正確姿勢
<?php
function getRealClientIp(): string {
// 信任的代理 IP 白名單 (關鍵!防止偽造)
$trustedProxies = [
'10.0.0.0/8', // 內網
'172.16.0.0/12', // 內網
'192.168.0.0/16', // 內網
'127.0.0.1', // 本機
// '203.0.113.0/24', // 你的 CDN/負載均衡器 IP 段
];
$remoteAddr = $_SERVER['REMOTE_ADDR'] ?? 'unknown';
// 只有當請求來自信任代理時,才信任 X-Forwarded-For
if (isIpInRanges($remoteAddr, $trustedProxies)) {
$xff = $_SERVER['HTTP_X_FORWARDED_FOR'] ?? '';
if ($xff) {
// 取最左邊的非私有 IP (最原始客戶端)
$ips = array_map('trim', explode(',', $xff));
foreach ($ips as $ip) {
if (!isPrivateIp($ip)) return $ip;
}
}
$xri = $_SERVER['HTTP_X_REAL_IP'] ?? '';
if ($xri && !isPrivateIp($xri)) return $xri;
}
return $remoteAddr; // 直接連線或不信任代理
}
function isIpInRanges(string $ip, array $cidrList): bool {
$ipLong = ip2long($ip);
if ($ipLong === false) return false;
foreach ($cidrList as $cidr) {
if (strpos($cidr, '/') === false) {
if ($ip === $cidr) return true;
} else {
list($rangeIp, $mask) = explode('/', $cidr);
$maskLong = ~((1 << (32 - $mask)) - 1);
if (($ipLong & $maskLong) === (ip2long($rangeIp) & $maskLong)) return true;
}
}
return false;
}
function isPrivateIp(string $ip): bool {
$long = ip2long($ip);
if ($long === false) return true;
// 10.0.0.0/8, 172.16.0.0/12, 192.168.0.0/16, 127.0.0.0/8, 169.254.0.0/16
return ($long >> 24) === 10
|| (($long >> 20) & 0xFFF) === 0xAC1
|| (($long >> 16) & 0xFFFF) === 0xC0A8
|| ($long >> 24) === 127
|| (($long >> 16) & 0xFFFF) === 0xA9FE;
}
// 使用
$realIp = getRealClientIp();
echo "真實客戶端 IP: $realIp\n";
Nginx/Apache 層面的正確傳遞
# Nginx 正確配置 (信任上游代理)
# 1. 設定真實 IP 標頭來源
real_ip_header X-Forwarded-For;
# 2. 設定信任的代理 IP 範圍
set_real_ip_from 10.0.0.0/8;
set_real_ip_from 172.16.0.0/12;
set_real_ip_from 192.168.0.0/16;
set_real_ip_from 127.0.0.1;
# 3. 遞歸查找最原始 IP
real_ip_recursive on;
# 此後 PHP $_SERVER['REMOTE_ADDR'] 直接是真實客戶端 IP
# 無需在 PHP 代碼中解析 X-Forwarded-For
防禦偽造的綜合策略
| 層級 | 措施 |
| 網絡層 | 防火牆僅允許負載均衡器 IP 訪問後端端口 |
| Web Server | Nginx real_ip_module 配置信任代理、拒絕直接訪問 |
| 應用層 | IP 白名單驗證、Header 簽名驗證 (HMAC)、請求指紋 |
| 業務層 | 關鍵操作綁定設備指紋、行為分析、風控引擎 |
合法使用場景 (白帽)
- API 測試:模擬不同地區 IP 測試地理圍欄邏輯
- 爬蟲輪換:配合代理池輪換真實出口 IP (非偽造 Header)
- 安全測試:授權滲透測試驗證 IP 獲取邏輯
- 開發調試:本地模擬生產環境 Header 環境
總結
cURL 只能偽造 應用層 HTTP 標頭,無法偽造 網絡層來源 IP。伺服器端必須配合 Web Server (Nginx real_ip_module) 在信任代理前提下正確解析 X-Forwarded-For。任何基於 Client IP 的安全決策 (限流、封禁、認證繞過) 都必須在網絡層或 Web Server 層完成驗證,不可單憑 PHP 代碼解析 Header。