如何借助 Nginx 实现静态资源访问的流量归档

作者：袖梨 2026-06-19

可通过Nginx的log_format和location匹配实现静态资源访问日志的轻量级归档，配置专用格式记录时间、IP、URI、状态码等字段，按后缀匹配静态路径并启用独立日志输出，配合logrotate轮转与压缩，支持基础分析或对接ELK/Loki。

可以通过 Nginx 的 log_format 和自定义日志模块，结合请求路径、响应状态、文件类型等字段，将静态资源访问行为完整记录下来，实现轻量级但可回溯的流量归档。

配置专用日志格式，捕获关键静态请求信息

静态资源（如 .js、.css、.png、.woff2 等）的访问需区别于动态接口。建议定义一个专用于静态资源的日志格式，包含时间、客户端 IP、URI、状态码、响应大小、Referer、User-Agent 和请求耗时：

在 http 块中添加：

注意：使用竖线分隔便于后续解析；$request 包含方法和 URI，能准确识别是否为 GET /static/xxx；$request_time 可辅助分析性能瓶颈。

按 location 匹配静态路径，启用独立日志输出

避免全站日志混杂，应只对明确的静态资源路径（如 /static/、/assets/、根目录下常见后缀）启用归档日志：

在 server 或 location 块中匹配静态资源：

location ~* .(js|css|png|jpg|jpeg|gif|ico|svg|woff|woff2|ttf|eot|pdf|xml)$ {
access_log /var/log/nginx/static_access.log static_log;
log_not_found off;
}

log_not_found off 可防止 404 请求污染归档数据；若需保留 404（例如监控缺失资源），可改为 on 并在日志中通过 $status 字段过滤。

配合日志轮转与归档策略，保障长期可用性

归档日志持续写入会快速占用磁盘，需配置自动切割与压缩：

使用 logrotate 管理（示例配置）：

/var/log/nginx/static_access.log {
  daily
  missingok
  rotate 90
  compress
  delaycompress
  notifempty
  create 0644 www-data www-data
  sharedscripts
  postrotate
    if [ -f /var/run/nginx.pid ]; then
      kill -USR1 `cat /var/run/nginx.pid`
    fi
  endscript
}

该配置每天切分、保留 90 天、自动压缩，并通知 Nginx 重开日志文件，避免服务中断。