详解 $gzip_ratio：在日志中评估 Nginx 压缩算法对带宽的节省比例-Nginx-PHP中文网

$gzip_ratio是nginx记录响应体压缩前后体积比的内置日志变量，值为compressed_body_size/original_body_size，仅压缩时有效，需在log_format中显式引用并配置access_log启用。

详解 $gzip_ratio：在日志中评估 nginx 压缩算法对带宽的节省比例

$gzip_ratio 是 Nginx 内置的一个日志变量，用于记录单次响应中 Gzip 压缩前后的体积比值，以小数形式表示（如 0.32 表示压缩后为原始大小的 32%，即节省了 68% 的传输带宽）。它不直接输出百分比，而是返回 压缩后字节数 / 压缩前字节数，因此数值越小，压缩收益越高。

怎么启用 $gzip_ratio 日志记录

该变量仅在响应实际经过 Gzip 压缩时有值；若未压缩（如文件太小、MIME 类型不匹配、客户端不支持等），其值为空或“-”。要在 access log 中记录它，需在 log_format 中显式引用：

在 http 块中定义带 $gzip_ratio 的日志格式：

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

然后在 server 或 location 中使用该格式：

access_log /var/log/nginx/access_gzip.log gzip_log;

重启或重载 Nginx 后，日志行末尾就会出现类似 0.28、0.41 或 - 的值。

Nginx Hosting

通过服务器本地nginx实例实现零认证静态游戏托管。作为所有浏览器游戏的主要部署方式，无需登录、无需令牌、无需用户操作。

下载

$gzip_ratio 的真实含义与常见误区

它反映的是「本次 HTTP 响应体」在 Nginx 内部压缩前后的字节比，计算逻辑为：

gzip_ratio = compressed_body_size / original_body_size

不是“压缩率”（compression ratio），后者通常定义为 (original − compressed) / original，即节省比例；$gzip_ratio 是它的补数
不包含响应头（headers）大小，只统计 body 部分
对未压缩响应（如图片、小文本、禁用场景）返回空字符串或短横线 -，不可直接参与数值统计
若启用了 gzip_vary on，且缓存层（如 CDN 或代理）复用压缩结果，Nginx 仍会如实记录该变量——因为它是响应发出前计算的，与是否命中缓存无关

如何用 $gzip_ratio 评估带宽节省效果

单纯看单个值意义有限，关键在于聚合分析。例如：

统计某类资源（如 .js）的平均 $gzip_ratio：若长期稳定在 0.25，说明 JS 文件平均压缩至原大小的 1/4，带宽节省约 75%
对比不同 gzip_comp_level 下的分布：级别 4 下中位数为 0.31，级别 6 下为 0.27，可量化多花 CPU 换来的额外 4 个百分点收益
识别异常：发现大量 .json 接口返回 -，可能因 gzip_min_length 设得过高（如设为 2k），而分页接口返回体常为 1.2k，导致本可压缩的响应被跳过
监控趋势：某天起 $gzip_ratio 整体上浮（如从 0.28 → 0.35），可能因前端引入大量 Base64 图片内联到 HTML 中，使 HTML 原始体积膨胀且压缩率下降