nginx静态资源访问统计需在配置阶段完成分离、打标、归一、聚合:1.用location精准匹配后缀并独立记录日志;2.定义精简log_format仅保留关键字段;3.实时清洗uri去参、转小写;4.秒级内存聚合+树状sse推送展示。

要让 Nginx 对静态资源(如 .js、.css、.png、.woff2 等)做可落地的访问统计分析,核心不是事后翻日志,而是在配置阶段就完成分离、打标、归一、聚合四个关键动作。整个过程轻量、低侵入,不依赖重服务架构。
1. 用 location 精准剥离静态请求到独立日志
避免静态请求混在主 access_log 中被动态接口“淹没”,必须单独捕获:
- 在 server 块中添加匹配规则,且务必放在
location /或proxy_pass之前 - 覆盖常见后缀:js/css/png/jpg/gif/woff2/ttf/svg/ico/pdf/zip 等,按实际扩展
- 对
/robots.txt、/favicon.ico、健康检查路径(如/healthz)显式关闭日志:access_log off - 示例配置:
location ~* \.(js|css|png|jpg|gif|woff2|ttf|svg|ico|eot|pdf|zip)$ {
expires 1y;
add_header Cache-Control "public, immutable";
log_not_found off;
access_log /var/log/nginx/static_access.log static;
}
2. 自定义轻量日志格式,只留关键字段
静态请求量大,字段越少越利于后续实时解析和存储。推荐精简组合:
-
$remote_addr:客户端真实IP(若经 CDN,可加$upstream_addr辅助回源识别) -
$time_local:本地时间,便于按小时/分钟切片 -
$request:原始请求行(含 method + uri + http version) -
$status:响应状态码,用于计算错误率 -
$body_bytes_sent:实际发送字节数,辅助判断是否完整传输 -
$http_referer和$http_user_agent:来源与设备信息 -
$request_time:请求处理耗时,可用于性能监控 - 去掉
$http_x_forwarded_for等非必需字段,节省磁盘与解析开销
定义方式:
log_format static '$remote_addr - $remote_user [$time_local] '
'"$request" $status $body_bytes_sent '
'"$http_referer" "$http_user_agent" '
'$request_time';
3. 日志清洗:统一路径、剔除噪声
原始 URI 常含版本号、时间戳、CDN 参数等干扰项,直接统计会导致同一资源被拆成多个条目:
- 例如:
/static/v2.3.0/app.min.js?v=12345→ 标准化为/static/app.min.js - 去除
?xxx后全部参数(或仅保留?v=xxx用于灰度识别) - 路径转小写,避免
/IMG.PNG和/img.png被重复计数 - 用
tail -f /var/log/nginx/static_access.log | python3 clean.py实时流式清洗,输出结构化行:
/static/app.js 200 example.com 2026-06-29T11:45:22Z
4. 秒级聚合与展示:内存滚动 + SSE 推送
中小规模无需上 ELK 或 Prometheus,用 Python(Flask + dict/Redis Sorted Set)或 Node.js(Map + setInterval)即可实现:
- 每 5 秒滚动计算:各 clean_path 的 PV、UV(基于 IP 或 UA Hash)、4xx/5xx 错误率
- 统计 referer_domain Top5,识别主要流量来源
- 前端通过 SSE(Server-Sent Events)实时接收更新,页面秒级刷新图表
- 日志文件配合
logrotate按日轮转,保留 30 天,避免磁盘撑满











