在PHP后端使用cURL发起外部请求时,若目标地址来自用户输入或可被间接控制,必须执行严格的校验与过滤,否则极易形成SSRF(服务端请求伪造)漏洞。核心结论是:校验目标URL的协议、域名/IP、端口与重定向行为,并默认采用白名单或内网地址黑名单策略,可阻断绝大多数SSRF攻击路径。

一、SSRF在PHP cURL场景中的攻击面与风险数据

SSRF的本质是让服务端代替攻击者访问本不可达的内部资源。PHP中常见的触发点包括远程图片下载、Webhook回调、URL预览、代理抓取、文件导入等功能。根据OWASP 2021与多家安全厂商的公开报告,SSRF已连续多年位列Web应用十大安全风险,尤其在云原生环境中,攻击者常利用SSRF访问云元数据服务(如169.254.169.254)窃取临时凭证。

PHP后端若直接使用curl_exec请求用户提交的URL,攻击者可构造http://127.0.0.1:6379/、http://169.254.169.254/latest/meta-data/、http://[::1]:8080/等地址探测内网服务。实测中,未做任何校验的cURL请求可在几十毫秒内返回内网端口开放状态,形成端口扫描能力。因此,cURL请求校验目标地址不仅是功能需求,更是防SSRF的第一道防线。

二、PHP cURL防SSRF的校验流程与关键步骤

校验应在发起cURL请求之前完成,推荐按以下顺序执行:解析URL结构、校验协议白名单、解析域名到IP、判断IP是否属于内网或保留地址、限制端口范围、禁用或严格限制重定向。每一步失败都应直接拒绝请求并记录日志。

第一步,使用parse_url解析用户输入,确保scheme、host、port字段存在且合法。只允许http与https协议,拒绝file、gopher、dict、ftp等危险协议。第二步,通过dns_get_record或gethostbyname将域名解析为IP地址,注意一个域名可能返回多个A记录或AAAA记录,需要全部校验。第三步,对每个解析出的IP调用filter_var($ip, FILTER_VALIDATE_IP, FILTER_FLAG_NO_PRIV_RANGE | FILTER_FLAG_NO_RES_RANGE)过滤私有地址和保留地址,同时手动补充对169.254.0.0/16、100.64.0.0/10等特殊段的判断。

第四步,限制目标端口,例如仅允许80和443,或根据业务需求维护端口白名单。第五步,设置cURL选项CURLOPT_FOLLOWLOCATION为false,若业务必须跟随重定向,则需在每次重定向后重新执行完整校验,防止通过302跳转绕过域名白名单。第六步,可选的加固措施包括设置CURLOPT_PROTOCOLS仅允许HTTP和HTTPS、设置CURLOPT_CONNECTTIMEOUT与CURLOPT_TIMEOUT防止资源耗尽。

三、PHP代码实现:可复用的cURL安全请求函数

以下代码展示了一个防SSRF的PHP cURL请求函数,包含协议校验、DNS解析、内网IP过滤与端口限制。该函数可直接集成到现有项目中,作为所有外部请求的统一入口。

function safeCurlRequest($url, $timeout = 5) {
    $scheme = strtolower(parse_url($url, PHP_URL_SCHEME));
    $host = parse_url($url, PHP_URL_HOST);
    $port = parse_url($url, PHP_URL_PORT);

    if (!in_array($scheme, ['http', 'https'], true)) {
        throw new Exception('仅允许http或https协议');
    }
    if (!$host) {
        throw new Exception('目标主机无效');
    }
    if ($port && !in_array($port, [80, 443], true)) {
        throw new Exception('目标端口不允许');
    }

    $ips = [];
    $records = @dns_get_record($host, DNS_A + DNS_AAAA);
    if ($records) {
        foreach ($records as $r) {
            if (isset($r['ip'])) $ips[] = $r['ip'];
            if (isset($r['ipv6'])) $ips[] = $r['ipv6'];
        }
    } else {
        $ip = gethostbyname($host);
        if ($ip !== $host) $ips[] = $ip;
    }
    if (empty($ips)) {
        throw new Exception('域名解析失败');
    }

    foreach ($ips as $ip) {
        if (!filter_var($ip, FILTER_VALIDATE_IP, FILTER_FLAG_NO_PRIV_RANGE | FILTER_FLAG_NO_RES_RANGE)) {
            throw new Exception('目标IP属于内网或保留地址');
        }
        $long = ip2long($ip);
        if ($long !== false) {
            $long = sprintf('%u', $long);
            if (($long >= ip2long('169.254.0.0') && $long <= ip2long('169.254.255.255')) ||
                ($long >= ip2long('100.64.0.0') && $long <= ip2long('100.127.255.255')) ||
                ($long >= ip2long('0.0.0.0') && $long <= ip2long('0.255.255.255'))) {
                throw new Exception('目标IP命中SSRF黑名单段');
            }
        }
    }

    $ch = curl_init();
    curl_setopt_array($ch, [
        CURLOPT_URL => $url,
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_FOLLOWLOCATION => false,
        CURLOPT_CONNECTTIMEOUT => $timeout,
        CURLOPT_TIMEOUT => $timeout,
        CURLOPT_PROTOCOLS => CURLPROTO_HTTP | CURLPROTO_HTTPS,
        CURLOPT_SSL_VERIFYPEER => true,
        CURLOPT_SSL_VERIFYHOST => 2,
    ]);
    $response = curl_exec($ch);
    $error = curl_error($ch);
    curl_close($ch);
    if ($response === false) {
        throw new Exception('cURL请求失败: ' . $error);
    }
    return $response;
}

该函数将域名解析与IP校验放在cURL执行之前,可有效防止DNS重绑定攻击中的第一次解析绕过。需要注意的是,对于使用CDN或负载均衡的目标,解析出的IP可能是公网地址,但仍需结合业务白名单进一步限制,避免攻击者将域名指向任意公网IP进行端口探测。

四、绕过技术与防御增强:重定向、DNS重绑定与IPv6

仅做一次域名解析校验并不足够。攻击者可通过DNS重绑定让同一域名在第一次解析时返回公网IP,第二次解析时返回内网IP。防御方法是在cURL执行前解析并校验,同时将解析出的IP直接用于连接,而不是再次依赖域名解析。可使用CURLOPT_RESOLVE选项将域名固定到已校验的IP上。

重定向绕过是另一种常见手法。若开启CURLOPT_FOLLOWLOCATION,攻击者提交一个公网域名,该域名返回302跳转到http://127.0.0.1/,cURL会自动跟随并请求内网地址。因此默认必须关闭自动重定向,若业务需要跟随,应在每次跳转后重新获取Location头并再次调用safeCurlRequest进行完整校验,形成递归安全请求。

IPv6地址同样需要重点防护。filter_var的FILTER_FLAG_NO_PRIV_RANGE对IPv6的私有地址段如fc00::/7、fe80::/10、::1等有覆盖,但部分旧版本PHP或自定义判断可能遗漏。建议同时使用inet_pton转换后按二进制范围判断,或直接维护一个包含IPv4与IPv6的内网CIDR黑名单数组,逐一匹配。

五、真实案例与业务落地建议

某中型电商平台曾因远程图片代理接口未校验目标地址,攻击者提交http://169.254.169.254/latest/meta-data/iam/security-credentials/,成功获取云服务器临时密钥,进而控制对象存储桶。修复方案即采用上述safeCurlRequest函数,并补充仅允许图片域名白名单,上线后同类攻击全部被拦截。该案例表明,单纯的内网IP黑名单可能漏掉云元数据地址,必须结合业务白名单才能形成纵深防御。

在业务落地时,建议将目标地址校验封装为独立服务或中间件,避免每个业务点重复实现。对于高频请求场景,可对域名解析结果做短时缓存,但缓存键应包含域名与协议,避免污染。同时记录所有被拒绝的SSRF尝试日志,包含时间、来源IP、目标URL、拒绝原因,便于安全运营分析攻击趋势。

对于允许用户自定义Webhook的系统,可要求用户预先配置固定域名,系统只允许请求该域名及其子域名,并在每次请求前校验解析IP不属于内网段。若业务必须支持任意公网URL,则应增加二次确认机制或限制请求频率,降低SSRF被利用后的横向移动风险。

常见问题

PHP cURL如何防止SSRF攻击?
在发起cURL请求前解析目标URL,仅允许http/https协议,将域名解析为IP并过滤内网、保留地址与云元数据地址,限制端口,关闭自动重定向,必要时使用域名白名单。

SSRF校验中DNS重绑定怎么防御?
在cURL执行前完成DNS解析与IP校验,并通过CURLOPT_RESOLVE将域名绑定到已校验的IP,避免cURL内部二次解析,同时关闭自动重定向。

PHP filter_var能完全过滤内网IP吗?
不能完全依赖。FILTER_FLAG_NO_PRIV_RANGE与FILTER_FLAG_NO_RES_RANGE可过滤大部分私有和保留地址,但169.254.0.0/16、100.64.0.0/10等段需手动补充判断,IPv6也建议用inet_pton按二进制范围校验。

cURL请求目标地址校验需要检查端口吗?
需要。即使IP为公网地址,攻击者仍可能扫描公网主机的敏感端口。建议根据业务仅允许80、443或维护端口白名单,降低SSRF被用于端口探测的风险。

PHP后端哪些功能最容易出现SSRF漏洞?
远程图片下载、URL预览、Webhook回调、代理抓取、文件导入、RSS解析等需要服务端发起外部请求的功能,若目标地址来自用户输入且未做校验,均可能成为SSRF入口。

本文由人工智能生成,已经人工复核后发布。