离线内网中为专用静态库配置Nginx Gzip白名单，需精准声明application/javascript、text/css、application/json等必要MIME类型，禁用image/jpeg等无效类型，全局http块配置并验证生效。
在离线内网环境中为专用静态库配置 Nginx Gzip 压缩白名单，核心是**精准控制哪些 MIME 类型必须压缩、哪些必须跳过，并确保不依赖外部网络或动态生成机制**。由于内网无外网访问能力，所有资源和配置需本地预置、验证可靠，且避免启用可能引入兼容性风险的模块（如 gzip_static 若未配套预压缩文件则反而失效）。
明确静态库资源的典型 MIME 类型
专用静态库（如前端组件库、GIS 工具包、内部 SDK）常见文件后缀及对应 MIME 类型需手动确认并写入白名单，不能依赖默认或通配符。常见类型包括：
-
application/javascript（.js、.mjs） -
text/css（.css） -
application/json（.json配置/元数据） -
application/wasm（若含 WebAssembly 模块） -
application/font-woff2、font/woff2（自定义字体） -
text/plain（.txt、.md文档说明） -
image/svg+xml（矢量图标）
⚠️ 注意：image/jpeg、image/png 等二进制图片**不应加入白名单**——Gzip 对已压缩图像无效，反而增加 CPU 开销；同理避免 */* 或 application/octet-stream 这类宽泛类型。
在 http 块中声明最小化白名单配置
因是离线环境，推荐在全局 http 块统一配置（而非分散到每个 server），便于审计与同步。配置示例（直接写入 /etc/nginx/nginx.conf 的 http { } 内）：
gzip on; gzip_min_length 1024; # 小于 1KB 的响应不压缩，防微小响应开销 gzip_comp_level 5; # 平衡速度与压缩率，避免设为 9（耗 CPU） gzip_vary on; # 告诉代理/CDN 此响应内容可变，避免缓存混淆 gzip_buffers 16 8k; # 缓冲区适配内网常见带宽与并发 gzip_http_version 1.1; gzip_types application/javascript text/css application/json application/wasm font/woff2 text/plain image/svg+xml;
✅ 关键点：
– 不写 gzip off（那是预压缩场景才用）；
– 不启用 gzip_static on（除非你已为每个 .js、.css 手动预生成 .js.gz 文件并放同目录）；
– gzip_types 中只列你确认存在的类型，宁缺毋滥。
验证白名单是否生效且无副作用
离线环境下无法用在线工具，可用以下本地方式验证：
- 用
curl -I -H "Accept-Encoding: gzip" http://内网IP/static_xxx/lib.js查看响应头是否有Content-Encoding: gzip和Vary: Accept-Encoding - 对比压缩前后大小：
curl -H "Accept-Encoding: gzip" http://.../lib.js | wc -cvscurl http://.../lib.js | wc -c - 检查错误日志：
tail -f /var/log/nginx/error.log，确认无gzip: unsupported encoding或 MIME 匹配失败提示
若某类文件（如 .wasm）未被压缩，需确认 Nginx 的 mime.types 文件中已正确定义其类型——离线安装包常缺失该映射，可手动追加一行：application/wasm wasm; 到 /etc/nginx/mime.types 的 types { } 块内。
针对专用静态库路径做独立 location 控制（可选增强）
若该静态库部署在特定路径（如 /sdk/ 或 /geotools/），可在对应 location 块中覆盖压缩策略，实现更精细管理：
location ^~ /sdk/ {
alias /usr/share/nginx/html/sdk/;
gzip on;
gzip_types application/javascript text/css application/json;
# 显式禁用不必要类型，强化白名单意图
gzip_disable "msie6";
}
这样即使全局 gzip_types 更宽泛，该路径下也只按需压缩，提升可控性与安全性。
