Nginx正确压缩静态文本和JSON需精准配置：启用gzip模块，http块中设gzip on、gzip_min_length 1024、gzip_comp_level 5、显式列出gzip_types（含application/json等）、gzip_vary on及gzip_http_version 1.1，避免压缩已压缩二进制文件。

要在 Nginx 中正确压缩静态文本（如 HTML、CSS、JS）和 JSON 数据，关键不是简单打开 gzip，而是精准控制压缩对象、强度与执行方式——否则可能白开、压错、甚至拖慢服务。

确认模块已就位

运行以下命令检查 gzip 模块是否编译进当前 Nginx：

nginx -V 2>&1 | grep -o with-http_gzip_module

有输出说明支持；若无结果，需重新编译并添加 --with-http_gzip_module 参数。注意：gzip_static 是独立模块，不能替代基础 gzip 功能。

在 http 块中配置核心参数

所有配置必须写在 http { } 块内（不是 server 或 location），否则不生效。推荐配置如下：

arcgis-js

提供 ArcGIS Maps SDK for JavaScript 开发辅助，涵盖 2D/3D 地图视图、图层管理、数据可视化、空间分析等功能模块的参考和示例指导。

下载

• gzip on; —— 必须开启，全局启用压缩
• gzip_min_length 1024; —— 小于 1KB 的响应不压，避免小文件因压缩头开销反而变大
• gzip_comp_level 5; —— 级别 5 是实测平衡点：压缩率约 68%，CPU 开销可控；级别 6 以上提升有限但 CPU 显著上升，不建议
• gzip_types —— 显式列出类型，务必包含：
  text/plain text/css application/javascript application/json text/xml application/xml+rss image/svg+xml
  特别注意：application/json 必须显式写入，否则 API 返回的 JSON 不会被压缩
• gzip_vary on; —— 添加 Vary: Accept-Encoding 响应头，确保 CDN 和代理缓存不混淆
• gzip_http_version 1.1; —— 避免 HTTP/1.0 兼容性问题

避开常见无效操作

• 不要对 JPEG、PNG、WOFF2、MP4、PDF 等二进制格式启用 gzip——它们本身已高压缩，再压几乎不减体积，反而浪费 CPU，甚至导致“越压越大”
• 若站点含 PHP 动态内容（如 index.php 输出 JSON 或 HTML），gzip_types 必须包含 application/x-httpd-php，否则 PHP 响应不会被压缩
• 不建议在 location 块里单独开 gzip；如确需局部控制，应在 server 块顶层先定义 gzip on 和完整 gzip_types，再用 location 配合 gzip off 关闭特定路径

验证是否真正生效

用 curl 测试：

curl -H "Accept-Encoding: gzip" -I https://yoursite.com/api/data.json

查看响应头中是否含：

Content-Encoding: gzip
Vary: Accept-Encoding

若缺失 Content-Encoding，说明配置未命中或 MIME 类型未匹配；若缺失 Vary，缓存可能出错。