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><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><div class="aritcle_card flexRow artxards">
											<div class="artcardd flexRow">
												<a class="aritcle_card_img" rel="nofollow" href="/xiazai/skill6848" title="Nginx Hosting"><img
														src="https://img.php.cn/upload/skill/000/000/081/179116929868126.jpg" alt="Nginx Hosting" onerror="this.onerror='';this.src='/static/lhimages/moren/morentu.png'" ></a>
												<div class="aritcle_card_info flexColumn">
													<a rel="nofollow" href="/xiazai/skill6848" title="Nginx Hosting" class="overflowclass">Nginx Hosting</a>
													<p class="overflowclass">通过服务器本地nginx实例实现零认证静态游戏托管。作为所有浏览器游戏的主要部署方式，无需登录、无需令牌、无需用户操作。</p>
												</div>
												<a rel="nofollow" href="/xiazai/skill6848" title="Nginx Hosting" class="aritcle_card_btn flexRow flexcenter"><b></b><span>下载</span>
												</a>
											</div>
										</div><h1>生成 .gz（默认级别，或加 -9）</h1><p>gzip -f -k "$file"
done</p>

说明：
- -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;</p>

⚠️ 注意：
- 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 配置三者协同。只要每步到位，就能稳定提供更小的传输体积。