如何利用 $request_filename 变量在日志中审计 Nginx 实际寻址的物理文件路径-Nginx-PHP中文网

可通过 $request_filename 变量记录请求映射的物理路径实现静态资源落盘位置审计；该变量表示 root/alias 解析后的完整本地文件路径，仅对静态文件有效，配合 log_format 和 access_log 即可启用。

如何利用 $request_filename 变量在日志中审计 nginx 实际寻址的物理文件路径

可以通过在 Nginx 的 log_format 中直接引用 $request_filename 变量，将每次请求最终映射到的本地文件路径记录进访问日志，从而实现对静态资源实际落盘位置的审计。

确认 $request_filename 的行为逻辑

$request_filename 是 Nginx 内置变量，表示当前请求经过 root 或 alias 指令解析后得到的**完整本地文件系统路径**（即物理路径），不是 URI 或未解析的 location 路径。它在 rewrite 阶段之后、access 阶段之前确定，且仅对能映射到文件的请求有效（如静态文件服务）；对纯代理或动态接口（如 PHP-FPM 后端），该值可能是空或不具意义（取决于配置）。

若使用 root /var/www/html;，请求 /images/logo.png → $request_filename 为 /var/www/html/images/logo.png
若使用 alias /data/static/; 在 location /static/ 下，请求 /static/js/app.js → $request_filename 为 /data/static/js/app.js
若请求被 try_files 重写或转发给 upstream，则该变量仍反映最后一次匹配的文件路径（即使最终未命中）

配置日志格式并启用记录

在 http 或 server 块中定义含 $request_filename 的日志格式，并应用到 access_log：

log_format audit '$remote_addr - $remote_user [$time_local] '
                  '"$request" $status $body_bytes_sent '
                  '"$http_referer" "$http_user_agent" '
                  'req_file:"$request_filename"';
<p>access_log /var/log/nginx/audit.log audit;
</p>

注意：$request_filename 若为空（如纯反向代理请求），日志中对应字段会显示为空字符串（即 req_file:""），不影响日志解析，但需在分析时过滤或识别。

Nginx Hosting

通过服务器本地nginx实例实现零认证静态游戏托管。作为所有浏览器游戏的主要部署方式，无需登录、无需令牌、无需用户操作。

下载

结合 try_files 和内部重定向做精准审计

当使用 try_files $uri $uri/ /index.php?$args; 类型配置时，$request_filename 始终反映 $uri 对应的物理路径（即使该文件不存在），而非最终执行的 /index.php。若需记录“实际被访问的文件”（如真实存在的静态资源），可搭配 if (-f $request_filename) 或 log_not_found off; 控制日志粒度；若需记录最终处理路径（包括 fallback 后的脚本），应改用 $document_root$fastcgi_script_name 等组合变量。

审计真实静态文件：保留默认 $request_filename 即可，配合 log_not_found off 可避免大量 404 干扰
审计 PHP 入口调用路径：用 $document_root/index.php 或 $document_root$fastcgi_script_name 更准确
避免重复日志：可在 location 块中单独设置 access_log，只对 static 区域启用该审计格式