Nginx不支持运行时Brotli压缩，但可通过离线生成.br/.gz文件并启用brotli_static和gzip_static实现自动按Accept-Encoding返回压缩文件；需安装brotli工具、编写预压缩脚本、编译加载ngx_brotli模块，并正确配置MIME类型与静态服务指令。
Nginx 本身不支持运行时动态压缩为 Brotli（br），但支持直接提供预压缩好的 .br 和 .gz 文件。关键在于：用脚本离线生成这些文件，并配置 Nginx 启用 gzip_static 和 brotil_static，让它自动按 Accept-Encoding 选择返回 .br、.gz 或原始文件。
1. 安装 Brotli 命令行工具
确保系统有 brotil 命令（注意拼写是 brotil，不是 brotli）：
- Ubuntu/Debian：
sudo apt install brotli - CentOS/RHEL 8+：
sudo dnf install brotli - macOS（Homebrew）：
brew install brotli - 源码编译（如需更高压缩等级）：见官方仓库
2. 编写预压缩脚本（bash 示例）
以下脚本会遍历静态资源目录（如 dist/），对所有文本类文件（.html、.css、.js、.json、.svg 等）生成 .br 和 .gz 文件：
#!/bin/bash
ASSET_DIR="./dist"
MIME_TYPES=("text/html" "text/css" "application/javascript" "application/json" "image/svg+xml" "font/woff2")
<p>find "$ASSET_DIR" -type f ( -name "<em>.html" -o -name "</em>.css" -o -name "<em>.js" -o -name "</em>.json" -o -name "<em>.svg" -o -name "</em>.woff2" ) | while read file; do</p><div class="aritcle_card flexRow">
<div class="artcardd flexRow">
<a class="aritcle_card_img" href="/xiazai/skill6848" title="Nginx Hosting"><img
src="https://img.php.cn/upload/skill/000/000/081/179116929868126.jpg" alt="Nginx Hosting" ></a>
<div class="aritcle_card_info flexColumn">
<a href="/xiazai/skill6848" title="Nginx Hosting">Nginx Hosting</a>
<p>通过服务器本地nginx实例实现零认证静态游戏托管。作为所有浏览器游戏的主要部署方式，无需登录、无需令牌、无需用户操作。</p>
</div>
<a href="/xiazai/skill6848" title="Nginx Hosting" class="aritcle_card_btn flexRow flexcenter"><b></b><span>下载</span> </a>
</div>
</div><h1>跳过已压缩文件</h1><p>[[ "$file" == <em>.br ]] && continue
[[ "$file" == </em>.gz ]] && continue</p><h1>生成 .br（推荐等级 11，平衡体积与 CPU）</h1><p>brotli -Z -f -q 11 "$file"</p><h1>生成 .gz（默认级别，或加 -9）</h1><p>gzip -f -k "$file"
done说明：
- -Z 启用最高压缩（等价于 -q 11）；
- -f 强制覆盖；-k 保留原文件（gzip 默认会删源文件，加 -k 避免丢失）；
- 运行前确保 ./dist 可写，建议在构建流程末尾执行（如 CI 中 npm run build && ./compress.sh）。
3. Nginx 配置启用静态压缩文件服务
在 server 或 location 块中添加：
gzip on; gzip_vary on; gzip_min_length 1024; gzip_types text/plain text/css application/json application/javascript text/xml application/xml application/xml+rss text/javascript image/svg+xml font/woff2; <h1>启用静态 gzip 和 brotli 文件查找</h1><p>gzip_static on; # 自动找 .gz 文件 brotli_static on; # 自动找 .br 文件（需 nginx-brotli 模块） brotli_types text/plain text/css application/json application/javascript text/xml application/xml application/xml+rss text/javascript image/svg+xml font/woff2; brotli_comp_level 6;
⚠️ 注意：
- brotli_static on 依赖第三方模块 google/ngx_brotli，必须在编译 Nginx 时显式加载；
- Ubuntu 官方源或 yum 仓库的 Nginx 默认不含该模块，需自行编译或使用预编译包（如 nginx.org 官方 stable 包 不含，但某些第三方 repo 如 ppa:ondrej/nginx 已集成）；
- 验证是否生效：请求时带 Accept-Encoding: br，检查响应头是否有 Content-Encoding: br 及文件后缀是否为 .br（可用 curl 测试）。
4. 验证与调试技巧
快速验证是否走到了预压缩文件：
- 用 curl 模拟请求：
curl -H "Accept-Encoding: br" -I https://yoursite.com/app.js，看响应头是否含Content-Encoding: br和Vary: Accept-Encoding - 手动检查文件存在性：
ls -l dist/app.js.br dist/app.js.gz - 若返回原始文件，检查：
– Nginx 是否重载（nginx -s reload）；
–brotli_static模块是否加载（nginx -V 2>&1 | grep -o with-http_brotli_module）；
– 文件权限是否允许 Nginx 读取.br文件；
– MIME 类型是否匹配（brotli_types必须包含该文件类型）。
不复杂但容易忽略：Brotli 预压缩不是开箱即用功能，它依赖外部工具生成文件 + Nginx 模块支持 + 正确 MIME 配置三者协同。只要每步到位，就能稳定提供更小的传输体积。
