empty_gif
'empty_gif' 指令配置 NGINX 以提供一个空白 GIF 图像。 — NGINX HTTP Core
empty_gif
location
语法empty_gif;
默认值none
上下文location
模块NGINX HTTP Core
参数none
说明
'empty_gif' 指令在 NGINX 配置的 location 上下文中使用,用于指示服务器在请求匹配该 location 时返回一个小的透明 GIF 图像。该指令在用作跟踪像素或占位符时特别有用——在内容不可用但客户端跟踪需要响应的场景中。该指令不接受任何参数,并且会启用一个内置的 URL 响应来返回该空 GIF 图像,该图像尺寸为 1x1 像素且完全透明。 当对包含 'empty_gif' 指令的 location 发出请求时,NGINX 将不会在该 location 中继续处理该请求的其他指令;相反,它会生成一个包含 GIF 图像数据的 HTTP 响应。NGINX 的默认行为是执行典型的请求处理,除非像 'empty_gif' 这样的指令另有指定。因此,要有效使用该指令,需要在服务器的 location 定义中谨慎放置,以确保它不会无意中覆盖其他配置设置。 该指令增强了服务器在无需在服务器上保存实际图像文件的情况下提供多种功能的能力,从而在分析跟踪或视觉占位等用例中优化资源使用并简化配置。
配置示例
location /tracking {
empty_gif;
}⚠
确保该指令放置在正确的 location 上下文中;否则,它将无法按预期运行。
⚠
在包含其他冲突指令的 location 中使用 'empty_gif' 可能导致意外行为;请彻底测试配置。