Web 服务器与网关 / 系统课时

Access Log 一行都记录了什么

Access Log 一行都记录了什么

访问日志通常在请求处理结束时写入,记录来源、请求目标、状态与发送量。本篇生成一条可核对的本机请求,拆开 combined 格式中的字段,区分真实连接信息与客户端自报内容,为后续故障排查准备可靠证据。

学习目标

  • 读懂 combined 格式中最常用的字段。
  • 对照实际请求验证状态、请求目标与正文发送字节数。
  • 识别代理来源、客户端头和日志敏感信息的边界。

先产生一条已知请求

实验需要 Linux、curl、Nginx 1.28 及空闲的本机 8080。以下只准备本次实验目录,若已有同名数据,先选择新目录并同步修改配置:

bash
# 使用三字节文件,便于核对发送量。
mkdir -p /tmp/nginx-log-lab/site
printf 'ok\n' > /tmp/nginx-log-lab/site/ok.txt

预期结果:ok.txt 包含 ok 与换行。确保 Master 可打开日志,Worker 可读取文件及经过父目录;不能为了解决日志权限问题把整个站点设为所有人可写。

以下片段示例放入 http 上下文,依赖上述路径:

nginx
server {
    listen 127.0.0.1:8080;
    server_name log.test;
    root /tmp/nginx-log-lab/site;
    access_log /tmp/nginx-log-lab/access.log combined;
    location / { }
}

检查并重载成功后执行:

bash
curl --noproxy '*' --resolve log.test:8080:127.0.0.1 -A 'lab-client' -sS 'http://log.test:8080/ok.txt?lang=zh'
tail -n 1 /tmp/nginx-log-lab/access.log

预期 curl 输出 ok 与换行;稍后日志出现一条含 GET /ok.txt?lang=zh HTTP/1.1、状态 200、正文大小 3 和 lab-client 的记录。日志写入可能略晚于客户端显示;本例没有显式缓冲,但不能用一次空的 tail 就判断访问未发生。

按字段拆开 combined 格式

下面是一条结构示意,时间与环境字段不代表本机实际值:

text
127.0.0.1 - - [10/Oct/2026:12:00:00 +0800] "GET /ok.txt?lang=zh HTTP/1.1" 200 3 "-" "lab-client"
字段 含义与边界
127.0.0.1 remote_addr,当前连接来源;经过代理时可能是代理地址
两个短横线 combined 的固定分隔占位与未取得的 remote_user;不是两种错误码
方括号时间 time_local,含时区,跨机器比较先统一时间
引号内请求行 方法、原请求目标与协议,查询参数也可能出现在其中
200 最终响应状态,不能据此断言业务数据正确
3 body_bytes_sent,不含响应头,不等于整个网络连接字节数
最后两项 Referer 与 User-Agent,本例 Referer 未提供,二者都能由客户端自报

若启用压缩、HEAD 或特殊响应,发送正文大小不应机械等同于磁盘文件大小。combined 的字段定义见 Nginx 访问日志文档。

访问日志与错误日志相互补充

访问日志回答哪次请求、状态怎样;错误日志解释某些失败的具体原因。404 可能是 Nginx 文件查找,也可能来自后端;只看访问日志状态无法区分。

同一请求内部跳转后,日志按处理最终结束的 location 配置写入,不能总在最初匹配的 location 寻找它。检查 nginx -T 输出中的实际 access_log、off、条件记录和日志路径,输出可能包含敏感配置,应在受控环境查看。

轮转或启用缓冲时,还要核对文件句柄重开与 flush 策略。不要把“当前文件暂时没有新行”立即解释为没有流量。

日志字段也需要隐私与信任边界

原始请求目标可能含令牌、个人信息与搜索词,Referer 也可能携带敏感地址。根据实际需求选择记录 $uri 而非完整请求目标,设置访问权限与保留周期,不额外记录 Cookie、Authorization 或完整请求体。

来源头未经可信代理恢复时,不应当作真实客户端地址;User-Agent 只能提供线索。排查时用时间、目标、状态及后续增加的请求标识联合定位,保留证据原文,避免凭单个自报字段作确定判断。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

Access Log 一行都记录了什么

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通