纯干货，一文带你了解如何配置Nginx日志！

最新推荐文章于 2025-07-16 15:23:54 发布
原创 最新推荐文章于 2025-07-16 15:23:54 发布 · 518 阅读 · 24 ·
CC 4.0 BY-SA版权
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
文章标签：

#nginx #spring #运维

纯干货，一文带你了解如何配置Nginx日志！

前言

Nginx日志对于统计、系统服务排错很有用。

Nginx日志主要分为两种：access_log(访问日志)和error_log(错误日志)。通过访问日志我们可以得到用户的IP地址、浏览器的信息，请求的处理时间等信息。错误日志记录了访问出错的信息，可以帮助我们定位错误的原因。

本文将详细描述一下如何配置Nginx日志。

设置access_log

访问日志主要记录客户端的请求。客户端向Nginx服务器发起的每一次请求都记录在这里。客户端IP，浏览器信息，referer，请求处理时间，请求URL等都可以在访问日志中得到。当然具体要记录哪些信息，你可以通过log_format指令定义。

  • 语法
access_log path [format [buffer=size] [gzip[=level]] [flush=time] [if=condition]]; # 设置访问日志
access_log off; # 关闭访问日志
  • path 指定日志的存放位置。
  • format 指定日志的格式。默认使用预定义的combined。
  • buffer 用来指定日志写入时的缓存大小。默认是64k。
  • gzip 日志写入前先进行压缩。压缩率可以指定，从1到9数值越大压缩比越高，同时压缩的速度也越慢。默认是1。
  • flush 设置缓存的有效时间。如果超过flush指定的时间，缓存中的内容将被清空。
  • if 条件判断。如果指定的条件计算为0或空字符串，那么该请求不会写入日志。

另外，还有一个特殊的值off。如果指定了该值，当前作用域下的所有的请求日志都被关闭。

  • 作用域

可以应用access_log指令的作用域分别有http，server，location，limit_except。也就是说，在这几个作用域外使用该指令，Nginx会报错。

以上是access_log指令的基本语法和参数的含义。下面我们看几个例子加深一下理解。

  • 基本用法
access_log /var/logs/nginx-access.log

该例子指定日志的写入路径为/var/logs/nginx-access.log，日志格式使用默认的combined。

access_log /var/logs/nginx-access.log buffer=32k gzip flush=1m

该例子指定日志的写入路径为/var/logs/nginx-access.log，日志格式使用默认的combined，指定日志的缓存大小为32k，日志写入前启用gzip进行压缩，压缩比使用默认值1，缓存数据有效时间为1分钟。

使用log_format自定义日志格式

Nginx预定义了名为combined日志格式，如果没有明确指定日志格式默认使用该格式：

log_format combined '$remote_addr - $remote_user [$time_local] '
                    '"$request" $status $body_bytes_sent '
                    '"$http_referer" "$http_user_agent"';

如果不想使用Nginx预定义的格式，可以通过log_format指令来自定义。

  • 语法
log_format name [escape=default|json] string ...;

  • name 格式名称。在access_log指令中引用。

  • escape 设置变量中的字符编码方式是json还是default，默认是default。

  • string 要定义的日志格式内容。该参数可以有多个。参数中可以使用Nginx变量。

    下面是log_format指令中常用的一些变量：

$bytes_sent
发送给客户端的总字节数

$body_bytes_sent
发送给客户端的字节数，不包括响应头的大小

$connection
连接序列号

$connection_requests
当前通过连接发出的请求数量

$msec
日志写入时间，单位为秒，精度是毫秒

$pipe
如果请求是通过http流水线发送，则其值为"p"，否则为“."

$request_length
请求长度（包括请求行，请求头和请求体）

$request_time
请求处理时长，单位为秒，精度为毫秒，从读入客户端的第一个字节开始，直到把最后一个字符发送张客户端进行日志写入为止

$status
响应状态码

$time_iso8601
标准格式的本地时间,形如“2017-05-24T18:31:27+08:00”

$time_local
通用日志格式下的本地时间，如"24/May/2017:18:31:27 +0800"

$http_referer
请求的referer地址。

$http_user_agent
客户端浏览器信息。

$remote_addr
客户端IP

$http_x_forwarded_for
当前端有代理服务器时，设置web节点记录客户端地址的配置，此参数生效的前提是代理服务器也要进行相关的x_forwarded_for设置。

$request
完整的原始请求行，如 "GET / HTTP/1.1"

$remote_user
客户端用户名称，针对启用了用户认证的请求

$request_uri
完整的请求地址，如 "https://daojia.com/"

下面演示一下自定义日志格式的使用：

access_log /var/logs/nginx-access.log main
log_format  main  '$remote_addr - $remote_user [$time_local] "$request" '
                  '$status $body_bytes_sent "$http_referer" '
                  '"$http_user_agent" "$http_x_forwarded_for"';

我们使用log_format指令定义了一个main的格式，并在access_log指令中引用了它。假如客户端有发起请求：https://suyunfe.com/，我们看一下我截取的一个请求的日志记录:

112.195.209.90 - - [20/Feb/2018:12:12:14 +0800] 
"GET / HTTP/1.1" 200 190 "-" "Mozilla/5.0 (Linux; Android 6.0; Nexus 5 Build/MRA58N) 
AppleWebKit/537.36 (KHTML, like Gecko) Chrome/63.0.3239.132 Mobile Safari/537.36" "-"

我们看到最终的日志记录中$remote_user、$http_referer、$http_x_forwarded_for都对应了一个-,这是因为这几个变量为空。

设置error_log

错误日志在Nginx中是通过error_log指令实现的。该指令记录服务器和请求处理过程中的错误信息。

  • 语法

配置错误日志文件的路径和日志级别。

error_log file [level];
Default:    
error_log logs/error.log error;

第一个参数指定日志的写入位置。

第二个参数指定日志的级别。level可以是debug, info, notice, warn, error, crit, alert,emerg中的任意值。可以看到其取值范围是按紧急程度从低到高排列的。只有日志的错误级别等于或高于level指定的值才会写入错误日志中。默认值是error。

  • 基本用法
error_log /var/logs/nginx/nginx-error.log

它可以配置在：main， http, mail, stream, server, location作用域。

例子中指定了错误日志的路径为：/var/logs/nginx/nginx-error.log，日志级别使用默认的error。

open_log_file_cache

每一条日志记录的写入都是先打开文件再写入记录，然后关闭日志文件。如果你的日志文件路径中使用了变量，如access_log /var/logs/$host/nginx-access.log，为提高性能，可以使用open_log_file_cache指令设置日志文件描述符的缓存。

  • 语法
open_log_file_cache max=N [inactive=time] [min_uses=N] [valid=time];

  • max 设置缓存中最多容纳的文件描述符数量，如果被占满，采用LRU算法将描述符关闭。

  • inactive 设置缓存存活时间，默认是10s。

  • min_uses 在inactive时间段内，日志文件最少使用几次，该日志文件描述符记入缓存，默认是1次。

  • valid：设置多久对日志文件名进行检查，看是否发生变化，默认是60s。

  • off：不使用缓存。默认为off。

  • 基本用法

open_log_file_cache max=1000 inactive=20s valid=1m min_uses=2;

它可以配置在http、server、location作用域中。

例子中，设置缓存最多缓存1000个日志文件描述符，20s内如果缓存中的日志文件描述符至少被被访问2次，才不会被缓存关闭。每隔1分钟检查缓存中的文件描述符的文件名是否还存在。

总结

Nginx中通过access_log和error_log指令配置访问日志和错误日志，通过log_format我们可以自定义日志格式。如果日志文件路径中使用了变量，我们可以通过open_log_file_cache指令来设置缓存，提升性能。

另外，在access_log和log_format中使用了很多变量，这些变量没有一一列举出来，详细的变量信息可以参考Nginx官方文档：http://nginx.org/en/docs/varindex.html

*来源：**作者antwang，*juejin.im/post/5aa09bb3f265da238f121b6c

img

**文末福利
**

img

最后给大家整理了40道高频Nginx面试题，涵盖核心知识点：

  1. 基础概念：Nginx特性、与Apache对比、正向/反向代理、Master/Worker进程。
  2. 核心配置：HTTP请求处理、限流算法（漏桶/令牌桶）、动静分离、负载均衡策略（轮询/权重/ip_hash等）。
  3. 实战技巧：虚拟主机配置、跨域解决方案、错误页面替换、高可用性设置。
  4. 性能优化：高并发原理（异步非阻塞）、动静资源分离、缓存策略。

适合：后端开发、运维工程师

40道Nginx面试题

1、请解释—下什么是Nginx?

2、请列举Nginx的一些特性。

3、请列举Nginx和Apache 之间的不同点。

4、请解释Nginx如何处理HTTP请求。

5、在Nginx中，如何使用未定义的服务器名称来阻止处理请求?

6、使用"反向代理服务器"的优点是什么?

7、请列举Nginx服务器的最佳用途。

8、请解释Ngjinx服务器上的Master和Worker进程分别是什么?

9、请解释你如何通过不同于80的端口开启Nginx?

10、请解释是否有可能将Nginx的错误替换为502错误、5 03

11、在Nginx中，解释如何在URL中保留双斜线

12、请解释ngx_http_upstream_module的作用是什么

13、请解释什么是C10K问题

14、请陈述stub status和sub filter指令的作用是什么

15、解释Nginx是否支持将请求压缩到上游

16、解释如何在Nginx中获得当前的时间

17、用Nginx服务器解释-s的目的是什么

18、解释如何在Nqinx服务器上添加模块

19、为什么要用Nginx?

20、为什么Nginx性能这么高?

图片

图片

黑客&网络安全如何学习**

今天只要你给我的文章点赞，我私藏的网安学习资料一样免费共享给你们，来看看有哪些东西。

1.学习路线图

在这里插入图片描述

攻击和防守要学的东西也不少，具体要学的东西我都写在了上面的路线图，如果你能学完它们，你去就业和接私活完全没有问题。

2.视频教程
网上虽然也有很多的学习资源，但基本上都残缺不全的，这是我们和网安大厂360共同研发的的网安视频教程，之前都是内部资源，专业方面绝对可以秒杀国内99%的机构和个人教学！全网独一份，你不可能在网上找到这么专业的教程。

内容涵盖了入门必备的操作系统、计算机网络和编程语言等初级知识，而且包含了中级的各种渗透技术，并且还有后期的CTF对抗、区块链安全等高阶技术。总共200多节视频，200多G的资源，不用担心学不全。
在这里插入图片描述
因篇幅有限，仅展示部分资料，需要见下图即可前往获取

🐵这些东西我都可以免费分享给大家，需要的可以点这里自取👉:网安入门到进阶资源

3.技术文档和电子书
技术文档也是我自己整理的，包括我参加大型网安行动、CTF和挖SRC漏洞的经验和技术要点，电子书也有200多本，由于内容的敏感性，我就不一一展示了。

在这里插入图片描述

因篇幅有限，仅展示部分资料，需要点击下方链接即可前往获取

🐵这些东西我都可以免费分享给大家，需要的可以点这里自取👉:网安入门到进阶资源

4.工具包、面试题和源码
“工欲善其事必先利其器”我为大家总结出了最受欢迎的几十款款黑客工具。涉及范围主要集中在 信息收集、Android黑客工具、自动化工具、网络钓鱼等，感兴趣的同学不容错过。

还有我视频里讲的案例源码和对应的工具包，需要的话也可以拿走。

🐵这些东西我都可以免费分享给大家，需要的可以点这里自取👉:网安入门到进阶资源

最后就是我这几年整理的网安方面的面试题，如果你是要找网安方面的工作，它们绝对能帮你大忙。

这些题目都是大家在面试深信服、奇安信、腾讯或者其它大厂面试时经常遇到的，如果大家有好的题目或者好的见解欢迎分享。

参考解析：深信服官网、奇安信官网、Freebuf、csdn等

内容特点：条理清晰，含图像化表示更加易懂。

内容概要：包括 内网、操作系统、协议、渗透测试、安服、漏洞、注入、XSS、CSRF、SSRF、文件上传、文件下载、文件包含、XXE、逻辑漏洞、工具、SQLmap、NMAP、BP、MSF…

在这里插入图片描述

本文转自 https://blog.youkuaiyun.com/yy17111342926/article/details/149346915?spm=1001.2014.3001.5502，如有侵权，请联系删除。

一文带你了解Nginx基础知识 | 建议收藏
【优快云】
08-04 1380
目录 1. 概述 2. 历史背景 3. nginx的优点 4. 主要组成部分 5. 版本规则 6. 版本选择 7. 编译配置 8. 开始编译 9. 配置语法 10. 重载，热部署，日志切割 1. 重载配置文件 2. 热部署 3. 日志切割 11. 静态资源Web服务器 1. 开启gzip 2. 打开目录结构 3. 网速限制 4. 日志 12. 反向代理服务 1. 缓存 13. 监控access日志 14. SSL安全协议 15. 对称加密、非对称加密 16
一文带你走完Nginx的配置方法（Nginx+Flask）
weixin_42078618的博客
02-23 2600
作为一个南方人，我每天都洗澡，一年四季，从不间断。甚至我在北京读书的7年，都这么过来的（除开几次喝醉的情况）。洗澡是一件很舒服的事情，你可以完全放松，听着music，哼着小曲，多么惬意。阿基米德也是在洗澡的时候发现了浮力，以此证明：洗澡是件好事！ 今天在洗澡的时候，我突然领悟到了nginx的反向代理是干嘛的，于是我哐哧哐哧的研究了一晚上怎么配置nginx。以下上干货！ 一、安装（ubun...
一文带你了解ELK部署+多日志监控
m0_62755018的博客
03-23 5325
首先系统出问题 研发第一个找的就是运维,问你要各种日志以前上服务器拉日志，太俗 今天换个新姿势 走上自动化运维的重要一步日志监控 ELK 是（Elasticsearch+Logstash+Kibana 外+Filebeat） 工作机制 :F 负责日志的收集（input）-->然后把日志吐给L(output)-->让后给ES-->K负责展示 这里多说一点 Logstash 和Filebeat两弟兄其他们两个都可以完成input日志和output日志，但是L运行机制比较大占用内存大，擅
Nginx系列教程（三）| 一文带你读懂 Nginx 的负载均衡
JackTian
03-25 1842
作者：JackTian 微信公众号：杰哥的IT之旅（ID：Jake_Internet） LAMP 系列导读 01. LAMP 系列教程（一）| 详解 Linux 环境下部署 HTTPD 服务 02. LAMP 系列教程（二）| 如何在 Linux 环境下部署 AWStats 分析系统来监控 Web 站点？ 03. LAMP 系列教程（三）| 一文读懂 HTTPD 服务的访问控制 04. LAM...
干货篇 | 一文带你了解Ansible（上）
s_alted的博客
08-01 300
哈喽各位小伙伴们大家好！今天我们来聊一聊 Ansible 有些小伙伴可能会疑惑——什么是 Ansible ？它是用来干什么的？ 我举个例子：我们在运维的过程中，往往会遇到大批量服务器同时报错的情况，而且这种情况往往都是一样的错误，如果是一两台或者几台服务器，我们可以远程登录到这些设备并一个一个去处理。 但如果是几十台呢？如果我们还像传统方法那样一台一台去处理，则会大大降低了我们的运维效率。 我们需要一个解决方案，一个工具来帮我们解决这些重复性高，枯燥的运维操作。这时候，ansible 出现了。 其实早在 a
Nginx 常用配置汇总！从入门到干活足矣
果子哥丶的博客
10-24 3211
Nginx简介 Nginx 是开源、高性能、高可靠的 Web 和反向代理服务器，而且支持热部署，同时也提供了 IMAP/POP3/SMTP 服务，可以不间断运行，提供热更新功能。占用内存少、并发能力强，最重要的是，Nginx 是免费的并可以商业化，配置使用都比较简单。 Nginx 特点 高并发、高性能 模块化架构使得它的扩展性非常好 异步非阻塞的事件驱动模型这点和 Node.js 相似 无需重启可不间断运行 热部署、平滑升级 完全开源，生态好 Nginx 最重要的几个使用场景： 静态资源服务 反向.
Nginx系列教程（二）| 一文带你读懂Nginx的正向与反向代理
JackTian
03-20 2206
作者：JackTian 微信公众号：杰哥的IT之旅（ID：Jake_Internet） LAMP 系列导读 01. LAMP 系列教程（一）| 详解 Linux 环境下部署 HTTPD 服务 02. LAMP 系列教程（二）| 如何在 Linux 环境下部署 AWStats 分析系统来监控 Web 站点？ 03. LAMP 系列教程（三）| 一文读懂 HTTPD 服务的访问控制 04. LAM...
葵花宝典！一文搞定 Nginx 限流配置
民工哥的博客
06-23 602
来源：https://www.cnblogs.com/biglittleant/p/8979915.html作者：biglittleant1、限流算法令牌桶算法令牌桶算法算法思想是：令牌...
微服务｜一文带你了解无感知部署方案实战
在数字化道路无限探索
08-28 995
蓝绿部署是一种零停机时间的部署策略，它通过同时维护两个生产环境（一个是当前活跃的“Blue”环境，另一个是待部署的“Green”环境）来实现。在程序开发和运维过程中，会频繁地部署服务，并且每个服务的正常运行都依赖于其他服务，所以能够在不停服的情况下部署新版本服务来保持应用的整体稳定性可用性十分重要。Nacos接收到这个心跳包,首先检查当前服务在不在注册列表中,如果不在按新服务的业务进行注册,如果在,表示当前这个服务是健康状态。Nacos的服务管理有上下线服务的功能,且有open-api可直接调用触发。
一文带你马上了解 Service Mesh在百度网盘数万后端的实践落地
weixin_41663412的博客
03-13 700
个人博客导航页（点击右侧链接即可打开个人博客）：大牛带你入门技术栈 1 背景 起初，在网盘快速发展期，为了快速上线，采用了服务单体化 + 主干开发模式进行研发，随着用户规模爆发式的增长以及产品形态的丰富，单体化的不足就体现出来了，于是架构上采用了微服务架构，开始对业务逻辑进行拆分部署。 服务拆分之后，也引入了新的问题，具体如下： **请求路由：**服务部署从物理机向虚拟化方式迁移中，...
Nginx 从入门到实践，万字详解
m0_67322837的博客
05-26 3196
最近越来越频繁地遇到需要配置反向代理的场景，在自己搭建博客的时候，也不可避免要用到 Nginx，所以这段时间集中学习了一下 Nginx，同时做了一些笔记，希望也可以帮助到大家～ 😜 这篇文章会在 CentOS 环境下安装和使用 Nginx，如果对 CentOS 基本操作还不太清楚的，可以先看看 <半小时搞会 CentOS 入门必备基础知识> 一文先做了解。 相信作为开发者，大家都知道 Nginx 的重要，废话不多说，一起来学习吧。 CentOS 版本：7.6 Nginx 版本：1.16.
Spring 作用域冲突深度解析：@Scope(“prototype“)与@RequestScope的冲突与解决方案
weixin_38436441的博客
07-15 570
Spring框架中，@Scope("prototype")和@RequestScope的冲突源于作用域语义的根本对立。prototype强调每次获取新实例，而RequestScope绑定请求生命周期。冲突表现为实例意外复用、数据污染或线程异常。本文提出7种解决方案：1)明确单一作用域；2)代理注入分离职责；3)@Lookup动态获取实例；4)手动获取绕过自动注入；5)自定义作用域解析器；6)ObjectProvider延迟获取；7)ThreadLocal手动管理上下文。最佳实践遵循单一职
基于SpringBoot+Uniapp球场预约小程序（腾讯地图API、Echarts图形化分析、二维码识别）
paopaokaka_luck的博客
07-16 185
“ 🎈系统亮点：支付宝沙盒支付、腾讯地图API、协同过滤算法、可视化配置、可视化预约”
Spring Ioc Bean 到底是什么
专注于技术分享
07-15 677
Spring Bean 不是一个神秘的东西，它就是一个被 Spring IoC 容器接管了“生老病死”和“社会关系”的普通 Java 对象。这种“接管”带来了巨大的架构优势，使得我们的代码更加灵活、可维护，并能轻松获得事务、安全等强大的企业级服务。
SpringMVC3
j202312101422的博客
07-14 406
本节从 JSON 传递、参数绑定、Cookie/Session 原理到代码示例，把 Web 开发中“数据传递”和“状态保持”的核心知识点讲透了。理解这些内容，你就能搞定前后端联调、用户登录态管理等关键需求。
spring-ai-alibaba 接入腾讯地图查询天气
hzp的专栏
07-14 260
摘要：spring-ai-alibaba新增腾讯地图工具包，支持三步快速实现天气查询：1)添加依赖；2)配置API key；3)代码调用。如需扩展其他地图功能，提供两种方案：1)自定义Function服务；2)通过MCP调用腾讯地图服务（需配置SSE连接）。当前工具包仅包含天气查询功能，需从主干分支自行构建或等待1.0.0.2+版本发布。MCP方案同样分三步实现，支持更灵活的服务调用。
Springboot aop面向切面编程
frt的博客
07-12 221
表达式可以使用 * 和 .. 代表一个词和任意多个词 例如：com.example.service.*.*(..))2.随便定义一个类，随便写一个方法，需要加注解@Aspect @Component交由ioc容器管理。aop:面向切面编程，理解在一个流程中插入一个切面，这样切面方法会在指定位置执行。这样在test方法执行前会先执行输出before。在方法里加@Around属性指定方法。
Spring MVC中@PathVariable的用法详解
最新发布
2301_80215285的博客
07-16 723
@PathVariable是Spring MVC的核心注解，用于从URL路径中提取变量值并绑定到控制器方法参数。它通过URI模板（如/users/{userId}）定义占位符，支持自动类型转换和名称匹配，默认必需且常用于RESTful API的资源标识。与@RequestParam不同，@PathVariable处理路径段而非查询参数，适用于资源定位场景。该注解简化了动态URL处理，是构建语义化RESTful服务的关键工具。使用时需注意变量必需性、类型匹配以及与@RequestParam的适用场景区分。
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值