nginx可通过user-agent结合map指令动态设置gzip开关,实现按终端类型差异化启用压缩;gzip_comp_level不支持变量,需通过多location配置不同压缩级别或gzip_static预压缩文件方案。

Nginx 本身不直接识别“手机/平板/桌面”这类终端设备类型,但它可以通过 User-Agent 请求头中的特征字符串(如 Mobile、Android、iPhone、iPad、Windows NT、Mac OS X 等)做条件判断,并结合 map 指令动态设置变量,进而控制 Gzip 压缩行为——实现按终端类型差异化启用或调整压缩策略。
这不是靠多个 server 块区分(那是按域名),而是利用 Nginx 的运行时变量能力,在同一个 server 或 http 块中,根据请求来源设备特征,决定是否压缩、用多高级别压缩。
1. 用 map 指令识别终端类型并设置压缩开关
在 http 块顶部(必须在 server 外)定义一个映射关系,将 User-Agent 转为布尔型变量(如 $gzip_enabled):
http {
# 根据 User-Agent 判断是否为移动设备
map $http_user_agent $gzip_enabled {
default on; # 默认开启(桌面端)
"~*Mobile" on; # 含 Mobile(安卓、iOS 微信/QQ 内置浏览器等)
"~*Android" on;
"~*iPhone" on;
"~*iPad" on;
"~*Windows Phone" on;
"~*UCBrowser" on;
"~*MQQBrowser" on;
# 显式排除某些低性能老旧移动 UA(可选)
"~*MSIE [1-8]\." off; # IE8 及以下禁用
"~*Trident.*rv:11" off; # IE11 兼容模式也关
}
# 全局启用 gzip,但实际是否生效由 gzip on/off 控制
gzip on;
gzip_vary on;
gzip_min_length 1024;
gzip_types text/plain text/css application/json application/javascript text/xml application/xml text/javascript;
server {
listen 80;
server_name example.com;
# 根据 $gzip_enabled 动态控制本请求是否压缩
gzip $gzip_enabled;
# 其他配置...
location / {
root /var/www/html;
index index.html;
}
}
}
⚠️ 注意:gzip 指令支持变量值(gzip $gzip_enabled),但仅接受 on/off 字符串。map 输出必须是纯字符串,不能是数字或空值。
2. 进阶:按终端类型设置不同压缩级别
Nginx 的 gzip_comp_level 不支持变量(编译期固定),无法直接写 gzip_comp_level $level。但可通过两个技巧间接实现:
✅ 方案一:用多个 location + gzip 开关 + 不同 gzip_comp_level(推荐)
把关键路径(如 API、静态资源)拆开,结合 if 或 map + location 匹配,再在各 location 中设独立压缩参数:
# 在 http 块中定义终端类型变量
map $http_user_agent $is_mobile {
default 0;
"~*Mobile|Android|iPhone|iPad" 1;
}
server {
location /api/ {
# 移动端 API 响应更轻量,关闭压缩以节省 CPU
if ($is_mobile) {
set $gzip_off "on";
}
gzip $gzip_off;
gzip_comp_level 1; # 即使开启,也用最低级
# ...
}
location /static/ {
# 静态资源对所有终端都强压缩
gzip on;
gzip_comp_level 6;
gzip_types text/css application/javascript image/svg+xml;
}
}
? 提示:
if在location内可用,但避免在server根作用域滥用;优先用map+location组合更稳定。
✅ 方案二:用 gzip_static 配合预压缩文件(适合静态资源)
对移动端单独提供 .gz 文件(如 style.css.gz),并启用 gzip_static on;,Nginx 会自动匹配并返回,无需实时压缩:
location /static/ {
gzip_static on; # 优先返回 .gz 文件
gzip_http_version 1.1;
# 不需要 gzip on,因为不走实时压缩
}
你只需为移动端资源生成更低压缩比的 .gz 版本(比如用 -1 级 gzip -1 style.css > style.css.gz),桌面端用 -6 级,再通过 CDN 或后端路由分发不同版本。
3. 实际部署注意事项
-
map必须定义在http块最外层,不能嵌套在server里; -
gzip $variable只能用于开启/关闭,不能控制gzip_comp_level或gzip_types; -
gzip_vary on必须开启,否则 CDN 或代理可能缓存错版本(比如把桌面压缩版返回给未声明Accept-Encoding的移动端); - 避免对图片、字体、PDF 等二进制文件启用 Gzip —— 它们本身已压缩,Gzip 可能增大体积;
- 测试时用
curl -H "User-Agent: Mozilla/5.0 (iPhone; CPU iPhone OS 17_0 like Mac OS X)" -I http://example.com/检查响应头是否有Content-Encoding: gzip。
4. 验证是否按终端生效
打开 Chrome DevTools → Network → 点击任意 HTML/JS/CSS 请求 → 查看 Response Headers:
- 若含
Content-Encoding: gzip且Vary: Accept-Encoding,说明压缩已启用; - 对比不同 UA(如模拟 iPhone 和 Windows Chrome)的响应大小和 Header,确认策略差异;
- 日志中可添加
$gzip_ratio变量观察压缩率:log_format main '$remote_addr - $remote_user [$time_local] "$request" ' '$status $body_bytes_sent "$http_referer" ' '"$http_user_agent" $gzip_ratio';
不复杂但容易忽略细节。











