empty_gif 是 Nginx 内置指令，直接内存生成 43 字节透明 GIF，配合 location 精准匹配和自定义日志实现低开销像素追踪，无需文件 I/O 或脚本执行，响应头固定、状态码恒为 200。
nginx 的 empty_gif 模块本身不用于“优化像素追踪请求”，它只是一个内置的、返回 1×1 透明 GIF 的轻量机制，真正起作用的是它配合 location 和日志记录所实现的低开销埋点能力。它的价值在于：避免为每个像素请求启动完整 HTTP 处理流程（如 PHP 解析、数据库查询），把追踪降级为纯 Nginx 层的日志写入。
理解 empty_gif 的本质
empty_gif 是 nginx 内置指令，不依赖外部模块（无需编译安装）。它不生成文件，也不走磁盘 I/O，而是由 nginx 内存中直接构造一个 43 字节的 GIF 响应体（header + palette + pixel），响应头固定为 Content-Type: image/gif，状态码始终是 200。这意味着：
– 没有文件读取延迟
– 没有动态脚本执行开销
– 没有额外内存分配（复用静态 buffer）
– 客户端能正常加载（浏览器/邮件客户端兼容性好）
用 location 匹配像素请求路径
典型像素追踪 URL 形如：/pixel.gif?uid=123&event=login&ts=171…。你需要用 location 精准捕获这类请求，避免干扰其他资源：
- 推荐用前缀匹配：
location = /pixel.gif { ... }（严格等于，最快） - 或带参数的正则（若路径含版本号等）：
location ~ ^/tracking/pixel\.(gif|png)$ { ... } - 避免用
location /pixel.gif（前缀匹配，可能误中/pixel.gif?v=1后续路径）
配置 empty_gif + 自定义日志字段
核心配置示例：
log_format tracking '$remote_addr - $remote_user [$time_local] '
'"$request" $status $body_bytes_sent '
'"$http_referer" "$http_user_agent" '
'uid="$arg_uid" event="$arg_event" ts="$arg_ts"';
<p>server {
location = /pixel.gif {
empty_gif;
log_format tracking ...; # 或引用已定义的 format
access_log /var/log/nginx/tracking.log tracking;</p><h1>可选：关闭 gzip（小响应不值得压缩）</h1><pre class="brush:php;toolbar:false;"> gzip off;
# 可选：设置极短缓存，避免浏览器/CDN缓存导致漏记
expires -1;
add_header Cache-Control "no-store, no-cache, must-revalidate, max-age=0";
}}
说明：
– $arg_uid 等变量自动提取 query string 参数
– 日志写入独立文件，便于用 logstash/fluentd 实时采集分析
– 不启用 gzip 和 expires 是关键，否则可能丢数据或重复计数
注意事项与替代建议
empty_gif 仅适用于 GET 请求，且无法做条件逻辑（比如按参数值跳转或拒绝）。如果需要更灵活控制（如过滤爬虫、限频、写入 Kafka），应改用 return 204（无响应体，更省带宽）或 proxy_pass 到轻量服务（如 Go/Python 小 API）。但对简单埋点场景，empty_gif 仍是零依赖、零延迟、零维护的最优解。
