过滤链头插反转顺序
本版 Nginx 的 ngx_modules 顺序决定过滤模块的初始化顺序;每个过滤模块再把自己插到输出过滤链表的头部。因此,数组中越靠后的过滤模块越早处理响应。修改模块顺序时须按实际执行链判断结果,不能把数组顺序直接当调用顺序。[[过滤链叠加]]说明链上各模块如何组合,本卡专讲顺序反转的原因。
主题对照
Nginx 的虚拟主机、location 匹配、阶段管线与模块编译,请求体缓冲、超时与限速,上游组与代理头,过滤链与包体改写,以及变量惰性求值与脚本执行这些配置层面的性能杠杆。
本版 Nginx 的 ngx_modules 顺序决定过滤模块的初始化顺序;每个过滤模块再把自己插到输出过滤链表的头部。因此,数组中越靠后的过滤模块越早处理响应。修改模块顺序时须按实际执行链判断结果,不能把数组顺序直接当调用顺序。[[过滤链叠加]]说明链上各模块如何组合,本卡专讲顺序反转的原因。
多个 Nginx worker 能把请求处理分散到多个 CPU 核心,并隔离单个 worker 的故障;进程过多则会增加调度切换与资源占用。以 worker 数接近 CPU 核数说明并行与切换的权衡,这是一种起点而非固定最优值;实际数量还要结合阻塞行为、可用核心和测量结果决定。
Nginx配置文件有通用的“指令名 参数;”外形,但指令是否存在、接受几个参数,以及值能否带单位或引用变量,都由处理它的模块决定。通用文本语法只负责分隔,不能推出每个指令都支持相同的值格式。设计模块配置时,需把参数规则作为模块接口的一部分说明,避免把示例能力误当全局能力。
Nginx 的 error_log ... debug 与按客户端筛选的 debug_connection 依赖调试日志构建支持。排障时先核实运行中的二进制是否带有该能力,再设日志级别和筛选范围;单改配置不一定能得到调试输出。调试日志可能很大,需限定采集范围与存储预算。这将“构建能力”和“运行配置”分成两道检查。
主机名未命中时,请求落到对应监听地址与端口的默认server。default_server属于listen,不是server_name;未显式指定时,取该监听地址与端口上的第一个server。排查错站时先确认请求实际进入的监听端口,再核对Host匹配。
同一监听地址与端口有多个虚拟主机时,server_name先匹配精确名称,再匹配最长的前置通配符、最长的后置通配符,最后按配置出现顺序取第一个匹配的正则。排查Host路由时,应先看精确规则,再看通配和正则。
location选择不是一律取配置文件中第一个匹配项:精确匹配立即结束;否则记住最长前缀,普通前缀之后还会按出现顺序尝试正则;最长前缀带^~时跳过正则。排查请求落点要按这些规则逐步判断。
root把完整请求URI追加到指定目录;alias用指定路径替换命中的location前缀。例如location /conf/中请求/conf/nginx.conf,root /srv会映射到/srv/conf/nginx.conf,alias /srv/则映射到/srv/nginx.conf。
index 为以斜线结尾的请求列出候选首页,Nginx按配置中从左到右的顺序检查;找到后进行内部重定向,新的 URI 可能匹配另一个location。因此候选顺序会影响实际返回文件,不能照搬本书示例文字中倒序查找的说法。
error_page把指定错误状态映射到 URI 或命名位置;内部重定向后,默认仍保留原错误状态,显式=200等可改为指定状态,单独=则使用目标处理结果。排查“显示了新页面但状态仍为404”时,要分别看处理目标与返回码。
try_files按顺序检查候选文件,命中时在当前上下文继续处理;都不存在时才对最后的 URI 或命名位置做内部重定向,也可以用状态码结束。它可用于静态文件优先、未命中后转上游,但不能把每个候选都理解成一次重定向。
client_body_buffer_size控制读取请求体的内存缓冲区;请求体超出缓冲区时,全部或部分内容可能写入临时文件。调大缓冲区可以减少落盘,但会提高并发请求的内存占用。排查上传性能时要同时看请求体大小、并发量和临时目录,而不是只盯缓冲区数值。
large_client_header_buffers设置大请求头缓冲区的数量与单个大小。请求行必须装进一个缓冲区,超出返回414;每个请求头字段也不能超出单个缓冲区,超出返回400。增加缓冲区数量不能解决单行过长,排查时应先分清总量与单字段边界。
client_header_timeout约束完整请求头的接收时间;client_body_timeout只计两次读取请求体之间的间隔;send_timeout只计两次向客户端写入响应之间的间隔。后两者不是整个请求体或响应的总时限。排查慢客户端时应先分清读头、读体和写响应所处阶段。
Nginx的types按文件扩展名选择响应的MIME类型,并写入Content-Type;没有匹配项时使用default_type。同一种MIME类型可以对应多个扩展名。配置静态文件服务时,要区分“扩展名查表”和“未命中时回退”,不能把默认类型误当作所有文件的实际类型。
limit_except GET中的GET是允许的方法,块内的访问规则作用于其他方法;允许GET也自动允许HEAD。若块内写deny all,被拒绝的是GET/HEAD以外的方法。配置请求方法白名单时,先辨清“列出允许方法”和“限制其余方法”两层语义。
limit_rate限制Nginx向客户端发送响应的速度,单位是每个请求的字节数/秒;limit_rate_after指定先发送多少响应数据,再开始限速。它们不限制上传请求体的读取速度。排查吞吐时还要区分单请求速率与客户端多连接汇总速率。
ignore_invalid_headers on使Nginx忽略名称无效的请求头字段;设为off则允许这些字段继续处理,不等于自动返回400。字段名中的下划线是否有效另由underscores_in_headers控制。判断请求头行为时,需同时看这两项配置。
open_file_cache缓存打开的文件描述符、文件大小与修改时间、目录信息;错误缓存要另开open_file_cache_errors。max限制条目数并触发LRU淘汰,inactive淘汰长期未用条目,open_file_cache_valid控制重验间隔。它减少重复文件系统查询,但也让元数据有短暂陈旧窗口。
if_modified_since决定如何把响应资源的修改时间与请求头If-Modified-Since比较:exact要求相等,before允许修改时间早于或等于请求时间,off把响应始终视为已修改。满足未修改条件时可返回304,让客户端复用本地缓存。
merge_slashes on把URI中连续的/压成一个,随后再匹配location;关闭它可能让//scripts/绕过/scripts/前缀,落入其他处理路径。除非URI编码需求确实依赖连续斜线,应保留压缩并检验路由规则。
$request_uri保留客户端最初请求的完整URI及参数;$uri是当前经过规范化、可被内部重定向改写的URI,不含查询参数。做日志追踪、缓存键或路由判断时,先决定需要原始入口还是处理后的路径,不能把两者互换。
client_max_body_size限定请求体大小,超限时返回413。若请求头已声明超额Content-Length,Nginx可在接收整个请求体前拒绝上传,减少无效传输。它是总量边界;client_body_buffer_size管理接收时的内存缓冲,两者用途不同。
客户端请求体默认先在Nginx侧缓冲完整,再发往上游。慢速公网上传因此少占上游连接,但增加代理侧存储及等待;当前可用proxy_request_buffering off改为边收边发,此时请求体已发给上游后不能再切换服务器。
upstream把多台后端命名为一个服务器组,proxy_pass引用该组。默认按权重轮询选择;backup只在非备份服务器不可用时参与。它把转发目标与单个地址解耦,也让故障替换和负载分配有统一配置入口。
max_fails规定在fail_timeout窗口内达到多少次失败,才把一台上游暂时视为不可用;同一个fail_timeout也决定暂不可用时长。它不是建连或读响应的超时;单节点组的这两个参数会被忽略。
ip_hash按客户端地址把请求倾向于同一上游,适合需要局部缓存亲和的场景;原节点不可用时仍会转到别处。暂时下线应标down以保留映射。现行文档用IPv4前三字节或完整IPv6作键,且已支持权重,不能沿用本版“权重不可共用”的断言。
反向代理不会默认原样转发客户端Host:Nginx会用$proxy_host重设上游请求的Host。需要后端按外部域名路由时可设proxy_set_header Host $host;若必须保留客户端原始Host值,则用$http_host并考虑其缺失的情况。
代理可分别控制上游请求的方法、请求体和请求头,以及回给客户端的响应头。proxy_method改写发往上游的方法;proxy_pass_request_body/headers控制是否发送请求部分;proxy_hide_header与proxy_pass_header控制响应头。配置前先辨别数据流方向。
上游可能在Location或Refresh中返回仅内部可访问的地址。proxy_redirect可把响应头里的上游地址改写为面向客户端的地址;default依据location与proxy_pass推导,off关闭改写。它处理响应重定向,不改变本次请求的上游目标。
点击箭头逐层展开,点击卡片标题查看详情。路径上下文仅用于连接层级,不计入主题卡片数。
来源书籍
源码分享类
书籍类型:工程实践
清单覆盖 8/8
242 张卡片
主题索引
比较进程/线程并发模型、I/O 多路复用、Reactor 与 Proactor 等单机高性能设计。
主题索引
比较负载均衡的分层组合方式与各类分配算法的取舍。
主题索引
比较 HTTP 缓存、DNS 解析、HTTP/2 与 QUIC、分块传输与 CDN 等加速和分流手段。
主题索引
比较不同语言与框架如何表达独占/共享所有权、释放时机和作用域退出清理。
与 9 张主题卡片存在结构化链接;来自相同书籍;属于相同分类
与 4 张主题卡片存在结构化链接;共享 1 个其他主题;来自相同书籍;属于相同分类
与 4 张主题卡片存在结构化链接;来自相同书籍;属于相同分类
与 2 张主题卡片存在结构化链接;共享 1 个其他主题;来自相同书籍;属于相同分类
与 2 张主题卡片存在结构化链接;来自相同书籍;属于相同分类
与 1 张主题卡片存在结构化链接;共享 1 个其他主题;来自相同书籍;属于相同分类