换头像的功能上线没几天,前端同学在联调时发现,接口返回的 JSON 里除了图片地址,还有一个字段写着 /var/www/app/uploads/2026/11/xxxx.png。测试同学随口问了一句「这是服务器上的路径吧」,后端才意识到,把内部存储结构直接给了出去。

另一个项目更直接:用户上传了一张扩展名是 .png 的文件,内容其实是 PHP 代码。几天后,有人在浏览器里直接访问上传目录下的这个文件,页面返回了代码执行后的结果。上传功能和图片展示看起来都正常,问题藏在「文件被放到哪里、服务器拿它当什么」这两步。

两个现象一个泄露路径,一个让文件变成脚本,都属于「上传链路没有守住边界」。这篇沿着一次上传的完整路径走一遍,讲清楚每一环该做什么校验,以及为什么只靠前端或扩展名不够。

一次完整走查:头像文件去了哪里

角色有三个:普通用户、上传接口、Web 服务器。请求是 POST /api/avatar,multipart 表单,文件名 a.png,Content-Type 写的是 image/png。结果是 200,响应里带绝对路径;文件落到 /var/www/app/uploads/,这个目录正好在 Web 根下,Nginx 又按扩展名把 .php 交给 PHP 解析。

排查分三步。先看响应字段,确认路径是后端拼接后返回的,不是前端猜的;再看存储配置,发现路径用的是当前脚本目录加 uploads;最后看 Nginx,uploads 没有单独的 location,全局的脚本解析规则对它生效。三个小问题串成一条链,单独看都不致命。

修复也分三步:响应只返回可访问的相对地址;文件移出 Web 根,改名后用应用读取;服务器层再给上传目录加一条禁止执行的规则。只改其中一步,另外两步仍然会留下缺口。

接口返回绝对路径,泄露的不只是一个目录。它同时告诉对方你的系统盘位置、部署框架、上传目录命名习惯,后续的路径猜测和目录遍历会容易很多。

上传链路的每一环

一次上传不是一个「保存文件」的动作,而是六步。每一环都有独立的失败方式,也都有独立的修复手段。

一次上传的完整路径
接收限制大小、字段、并发
校验扩展名、类型、文件头、内容
重命名服务端生成随机名
存储Web 根外或对象存储
分发独立域、鉴权、响应头
清理临时文件、失败残留

这六步里任何一步单独做都不够。只改扩展名,文件内容还是脚本;只做内容校验,存到可执行目录照样出问题;只做存储分离,文件名里的 ../ 仍可能写到别处。组合起来,才能把风险压到可接受的范围。

扩展名:黑名单挡不住,白名单才可控

黑名单的思路是「禁止 php、jsp、asp」,问题是解析规则比名单复杂:php3、php4、php5、phtml、phar 都可能被当成 PHP;大小写、双扩展名、末尾的点或空格、分号截断,在不同服务器上有不同表现。你很难列全,攻击者只需要找到一个漏掉的。本机只验证了三种:.php 和 .pHp 都执行,.php.jpg 被当图片返回 663 字节原文;其余变形没有逐个试。

白名单是反过来:只允许业务确实需要的类型,比如 jpg、png、gif、webp、pdf。得到扩展名后,不要直接使用用户传来的字符串,而是用服务端根据校验结果映射出的扩展名。

还有一个容易漏的点:上传 .htaccess 或服务器配置文件。如果上传目录允许 Apache 解析这类文件,攻击者可以改目录的解析规则。白名单天然挡掉它,但仍要确认服务器不会把上传目录当成配置目录。

Content-Type 与文件头:客户端说的不算

Content-Type 是客户端在请求里填的,改起来没有任何成本。只检查 image/png,攻击者把 PHP 文件标成 image/png 就能过。它适合做分流提示,不能当安全判断。

文件头是文件内容开头的固定字节,比如 JPEG 的 FF D8 FF、PNG 的 89 50 4E 47。读文件头能判断「它大概是什么格式」,比 Content-Type 可靠,但仍可伪造:在合法图片后面追加一段代码,文件头还是图片。

二次渲染是更稳的做法:用图像库把上传的图片解码,再重新编码,输出一张新的图。追加在后面的代码在重新编码时不会被保留,图片马就失效了。代价是损失元数据、动图可能只剩第一帧、CPU 开销增加。

对非图片文件,比如 PDF、压缩包、Office 文档,二次渲染不适用,要靠类型白名单、内容检查、隔离存储和下载时的响应头来降低风险。

只看 Content-Type

实现最省事,一行判断就能通过大部分正常上传。代价是客户端随便改,等于没校验,只能当体验层的提示。

文件头加二次渲染

能挡住大部分伪装和图片马,和存储策略配合后效果更好。代价是 CPU、格式兼容、元数据丢失,而且不适用于所有文件类型。

重命名、存储分离与上传域

重命名有两个目的:不让用户控制最终路径,不让文件名碰撞覆盖。用随机值加白名单扩展名,原始文件名只存进数据库做展示,不参与路径拼接。这样即使文件名里带了奇怪字符,也进不了路径。

存储位置不要在 Web 根目录下。文件放到 Web 根外,通过应用读取再输出,或者放到对象存储,由应用签发临时地址。这样即使文件内容有问题,也不能靠猜 URL 直接访问。

上传域和主站分离。用一个独立的域名承载用户文件,即使上传了 HTML 或脚本,也运行在主站之外的源,拿不到主站的 Cookie 和 DOM。注意是独立站点,不是同主域下的子域,子域之间仍可能通过 Cookie 的 Domain 属性产生关联。

响应头也要配合:下载类文件用 Content-Disposition: attachment,所有响应加 X-Content-Type-Options: nosniff,明确 Content-Type,不要让浏览器猜。这样即使浏览器把文件当成了别的类型,也会被响应头拦住。

服务器配置:上传目录禁止执行

即使文件放到了 Web 根下,也要在服务器层禁止上传目录执行脚本。Nginx 用 location 匹配上传路径,把脚本扩展名直接拒绝;Apache 可以关闭该目录的 PHP 引擎,或者移除对应的 handler。配置因部署方式不同,核心原则是「上传目录只当静态文件,不当代码」。

# 本机 nginx 1.28.0 实测:/uploads/shell.php 返回 403,/uploads/note.txt 返回 200
# 生产需按实际路径调整
location ^~ /uploads/ {
    location ~ \.(php|phtml|phar)$ { return 403; }
    add_header X-Content-Type-Options nosniff;
}

这层配置是兜底,不是替代前面的校验。因为配置会变,换服务器、加 CDN、改容器镜像都可能让规则失效;前面的白名单和重命名才是主防线。

日志里怎么看出上传被绕过

页面会骗人,日志不会。上传接口返回 200,只说明文件收下了,不代表它没有被当成代码执行。排查时把访问日志和应用日志放在一起看,重点找「上传之后紧接着访问」的成对请求。

# 本机实测日志,来自 _lab/proxy.js(转发到 127.0.0.1:8090 的 DVWA)
127.0.0.1 - - [07/Nov/2026:10:45:54 +0800] "POST /vulnerabilities/upload/ HTTP/1.1" 200 4554 "-" "curl/8.21.0"
127.0.0.1 - - [07/Nov/2026:10:45:56 +0800] "GET /hackable/uploads/shell.pHp HTTP/1.1" 200 41 "-" "curl/8.21.0"

这两行说明两件事:上传成功,且两秒后同一个文件以 .pHp 被访问、返回 200、41 字节。上传响应体里确实回显了 ../../hackable/uploads/shell.pHp,说明服务端把可推断路径交回给了客户端。修好之后,第二个请求应该变成 403 或 404;如果还是 200,内容又不是图片,基本可以确认上传目录能执行脚本。

如果第二个请求返回 200,但响应头是 text/html、大小只有几百字节,而上传的文件本应是图片,这个矛盾比状态码更能说明问题。反过来,修好之后应该返回 403,内容是服务器的拒绝页,不是脚本输出。

回溯时按时间线走:先找上传请求,记下响应里返回的路径;再搜这个路径在之后几分钟内的所有请求;最后看这些请求的状态码、响应大小和 Content-Type。三步走完,才能区分「上传成功但没被执行」和「已经执行了」。

再看几个信号:同一 IP 在几分钟内连续上传,文件名在 .jpg、.php、.php.jpg、.pHp 之间反复变;Content-Type 写的是图片,扩展名却是脚本;上传 body 只有几百字节,明显不像一张正常图片;上传响应里回显了服务器绝对路径。这些单看都不算证据,放在时间线上就能对上。

应用日志要记原始文件名、声明的 Content-Type、实际文件头判断结果、文件大小、存储路径和校验分支。很多实现只写一句「上传成功」,出事后什么也查不出来。Nginx 的错误日志也有线索,比如 client intended to send too large body 说明大小限制生效,access forbidden by rule 说明上传目录的禁止执行规则起作用了。

日志是事后证据,不是防护。它能帮你确认「有没有被绕过、从哪个口子进来的」,但挡不住请求本身。别把日志告警当成修复。

路径穿越与规范化

路径穿越是用户控制文件名或相对路径,让服务端把文件写到预期之外的位置。最常见的是文件名里带 ../,或者压缩包条目里带 ../。它不一定需要上传功能,任何「按名字读写文件」的接口都可能有。

绕过手法包括 URL 编码、双重编码、反斜杠、绝对路径、空字节(老版本)、超长路径。不同语言和框架的规范化顺序不一样,所以不能靠「替换 ../ 字符串」。PHP 8.3 实测:$_FILES['file']['name'] 收到 ../escaped.txt 时已经被剥成 escaped.txt,原始拼接没有写到上级目录。换到不剥路径的运行时,或用业务自己的 dir 参数拼路径,风险仍在;Node 和 Java 的变形没有实测。

正确做法是:只取文件名基名,拒绝包含路径分隔符的名字;用服务端生成的名字拼路径;拼完用 realpath 解析,确认结果在允许的根目录内,并且前缀比较要带上目录分隔符。

// 错误:直接拼接用户文件名
$dest = __DIR__ . '/uploads/' . $_FILES['file']['name'];

// 正确:只取基名,再用服务端生成的名字
$base = basename($_FILES['file']['name']);
$name = bin2hex(random_bytes(16)) . '.' . $ext; // $ext 来自白名单
$dest = '/srv/app-storage/uploads/' . $name;

// 如果必须使用用户提供的相对路径,解析后再校验
$root = realpath('/srv/app-storage');
$target = realpath($candidate);
if ($target === false || strpos($target, $root . DIRECTORY_SEPARATOR) !== 0) {
    // 拒绝
}

前缀比较的细节很重要:/srv/app-storage-evil 也以 /srv/app-storage 开头,必须比较到分隔符。符号链接也要考虑,realpath 能解析掉大部分,但创建链接的权限要单独收紧。

压缩包解压的边界

上传压缩包再解压,等于把「写文件」的入口扩大了一倍。压缩包里的条目可以带 ../、绝对路径、符号链接,解压库如果直接按条目路径写,就会写到目录外,这类问题常被称为 Zip Slip。

防御是逐条处理:拒绝绝对路径和包含 .. 的条目,按服务端生成的目录重组路径,限制条目数量、单文件大小和总解压大小,防止压缩炸弹;限制嵌套层数,避免解压出来的压缩包继续递归。

解压后的目录同样要放在 Web 根外,禁止执行。只靠「解压前扫一遍病毒」不够,扫描有滞后和漏报,路径校验必须自己做。

现象对照表

上传问题的现象往往很直观,难的是定位到具体哪一环。下面这张表按「先查什么」排。

现象真实原因第一步查什么
改后缀为 .php 后能执行只在前端或黑名单校验扩展名查服务端白名单与服务器解析规则
改 Content-Type 为 image/png 就通过信任了客户端填的 MIME查是否校验文件头并做二次渲染
图片马被包含执行上传目录可执行,或存在本地文件包含查目录执行权限与 include 路径
文件名带 ../ 写到了上级目录直接拼接原始文件名查 basename、realpath 与前缀校验
上传目录 URL 直接返回源码或执行结果目录在 Web 根下且未禁用脚本查存储位置与 location 配置
接口返回 /var/www/... 绝对路径异常或调试字段回显查响应字段与错误处理
解压 zip 后文件跑到上级目录未校验压缩包条目的路径查解压库安全选项与逐条校验

边界与代价

白名单会挡住一些合理需求。用户可能上传 CAD、压缩包、视频、字体,这些格式的解析和预览都更复杂;每加一种类型,就要多一套校验和存储策略,产品体验和开发成本都要权衡。

二次渲染有兼容性代价。带透明通道的 PNG、动图、专业相机的大文件,重新编码后可能变形、掉帧或耗时过长;可以按文件大小和类型分流,图片走重编码,其他类型走隔离存储和下载。

存储分离和独立域名会增加运维成本:要配 CDN、跨域、缓存、清理策略,还要处理历史文件迁移。但把上传目录留在主站 Web 根下,风险更高,尤其是在有模板、有包含、有插件系统的项目里。

检测也有边界。上传成功的日志只能说明文件写进去了,不能说明它不会被解析;要结合 Web 访问日志看上传目录有没有被请求、有没有异常状态码,配合文件完整性检查和目录权限审计。

练习:DVWA Upload 三档对比

下面五项都需要授权环境。练习 1、2、3、5 已在本机跑过;第 4 项在 PHP 8.3 上只得到被剥路径的基名,没有复现穿越。

  1. 本地起 DVWA,难度调到 low,先上传一张正常图片,再上传一个内容为固定字符串的 PHP 文件,访问上传后的地址,观察返回。本机 low 模式:上传 shell.php 返回 200、4554 字节,路径是 ../../hackable/uploads/shell.php,访问返回 200、41 字节,内容为 UPLOAD_EXECUTED:desktop-mu639h8\c1805。
  2. 难度调到 medium,重复上传,记录被什么拦住:扩展名、Content-Type 还是大小;再尝试改 Content-Type 或改后缀,看哪一步仍能过。本机 medium 只查 Content-Type 和 100000 字节大小,把 PHP 文件标成 image/jpeg 后返回 200、4563 字节并写入 shell.php,访问仍然执行。不要对线上站点做同样的事。
  3. 难度调到 high,观察文件名处理、扩展名白名单、图片内容校验各做了什么;再对比 impossible 的实现,写清楚差异。本机 high 拒绝 .php,原文是 Your image was not uploaded. We can only accept JPEG or PNG images.;带 JPEG 头的 shell.php.jpg 上传成功,但访问返回 663 字节的图片原文,没有执行。impossible 的源码对比没有做。
  4. 自建一个小 demo:上传接口用原始文件名拼接路径,尝试带 ../ 的文件名,确认写到上级目录;然后改成 basename 加随机名加 realpath 校验,复测被拒。PHP 8.3 实测:带 ../ 的名字被 PHP 剥成基名,文件落在 storage/ 内,没有穿越;safe 模式按随机名保存。
  5. 本地配置 Nginx 或 Apache,让上传目录禁止执行脚本,上传一个脚本文件并访问,确认返回 403 或静态内容,而不是执行结果。本机 nginx 1.28.0:/uploads/shell.php 返回 403,/uploads/note.txt 返回 200。

小结与下一篇

三句话收尾:上传的风险不在「传上来」,而在「存到哪、叫什么、服务器拿它当什么」;扩展名白名单、文件头校验、二次渲染、随机重命名、存储分离、目录禁执行要一起用;路径拼接一律用服务端生成的名字,用户输入只做基名和校验。

下一篇讲从开发角度做防御:自查清单与代码习惯。理由:这一篇拆的是上传这一条链路,下一篇把这些点收成一套可执行的自查清单,包括输入校验、输出编码、权限判断、日志与依赖管理,让防御从「知道原理」变成「每次提交代码都会做」。