Lighthouseでテキスト圧縮を勧められたときの直し方と転送量
Lighthouse 13 の「Document request latency」(日本語の表示では「ドキュメント リクエストのレイテンシ」)に「No compression applied」(圧縮の適用なし)と出たときは、Web サーバーで gzip か Brotli の圧縮を有効にすれば直ります。スマホでページが重いと感じるときや、サーバーから送るデータ量(転送量)を減らしたいときに見る項目です。
検証したページでは、nginx で CSS と JavaScript まで圧縮するようにしたところ、HTML・CSS・JavaScript の転送量の合計が 356,663 バイトから、gzip で 62,343 バイト、Brotli で 55,689 バイトになりました。ただし、Lighthouse 13 が圧縮を確かめるのは HTML だけです。指摘が消えても、CSS や JavaScript が圧縮されているとは限りません。
検証環境は Ubuntu 24.04、Node.js 22、Lighthouse 13.6.0(npm のパッケージ)、nginx 1.24.0(Ubuntu のパッケージ)と Brotli のモジュール(libnginx-mod-http-brotli-filter と libnginx-mod-http-brotli-static 1.0.0~rc)です。Lighthouse はコマンドラインから既定の設定(モバイル)で実行し、パフォーマンスのカテゴリーだけを調べました。Chrome は Playwright 1.63.0 に入っている Chrome for Testing 153 を、環境変数 CHROME_PATH で指定しました。検証用のページは、300行の表を並べた HTML(50,080 バイト)に、Bootstrap 5.3.3 の bootstrap.min.css と lodash 4.17.21 の lodash.min.js を読み込ませたものです。サーバーは同じ VM の中の localhost で動かし、HTTP/1.1 でつないでいます。Chrome の DevTools にある Lighthouse パネル、PageSpeed Insights、デスクトップの設定、HTTPS や HTTP/2、Apache や CDN での設定、zstd での圧縮は試していません。
Lighthouse 13では「Document request latency」の中に出る
圧縮の設定をしていない nginx からページを配り、Lighthouse を実行しました。結果の JSON から必要なところを小さなスクリプト(summarize.mjs)で抜き出すと、次のようになりました。
$ npx lighthouse http://localhost:8080/index.html --only-categories=performance --output=json --output=html --output-path=./out/none --chrome-flags="--headless=new --no-sandbox" --quiet
exit: 0
$ node summarize.mjs out/none.report.json
lighthouseVersion: 13.6.0 formFactor: mobile
performance score: 97 FCP: 2.1 s LCP: 2.1 s
document-latency-insight: score=0.5 displayValue="Est savings of 33 KiB" title="Document request latency" metricSavings={"FCP":0,"LCP":0}
checklist noRedirects: pass "Avoids redirects"
checklist serverResponseIsFast: pass "Server responds quickly (observed 4 ms)"
checklist usesCompression: FAIL "No compression applied"
debugData: {"redirectDuration":0,"serverResponseTime":4,"uncompressedResponseBytes":33554,"wastedBytes":33554}
audits with "compress" in id: []
(読み込んだファイルの一覧などの行は省いています。)
HTML のレポートでは、オレンジの四角が付いた「Document request latency」の項目に出ます。項目を開くと、リダイレクト、サーバーの応答時間、圧縮の3つの行が並びます。圧縮の行だけ、緑のチェックではなく、赤い丸に斜線のアイコンが付きます。

Lighthouse 12 までは、「Enable text compression」(uses-text-compression)という専用の項目がありました。Lighthouse 13.0.0 の変更履歴には、パフォーマンスのインサイト(insights)に置き換えられた項目を取り除いたと書かれています。13.6.0 には、compress を名前に含む項目はありませんでした。uses-text-compression(Enable text compression)を説明した公式の解説は、Lighthouse 12 までの項目についてのものです。
この項目は、Lighthouse 13.6.0 の設定でパフォーマンスの点数への重みが 0 で、レポートにも「Unscored」と出ます。点数には直接入りません。
見ているのはHTMLだけ
Lighthouse 13.6.0 で、この判定をしているコードは、依存しているパッケージ @paulirish/trace_engine(0.0.67)の DocumentLatency.js にあります。調べるのは、最初に読み込んだ HTML(ドキュメント)の1件だけです。
- レスポンスの
Content-Encodingがgzip、br、deflate、zstdのどれかなら、圧縮しているとみなす - 圧縮していなければ、減らせる大きさを見積もる。HTML なら、元の大きさの 67% を減らせるとみなす
- 見積もりが 1,400 バイト未満なら、指摘を出さない
今回の HTML は 50,080 バイトなので、見積もりは 33,554 バイトです。これがレポートの「Est savings of 33 KiB」です。1,822 バイトの小さなページを圧縮せずに配ったときは、見積もりが 1,400 バイトに届かず、「Applies text compression」(テキスト圧縮の適用あり)と出ました。実際には圧縮していなくても、こう表示されます。
古い項目についての公式の解説には、圧縮されていないテキストのファイルをすべて集め、gzip で実際に圧縮して見込みを出すと書かれています。13.6.0 のコードは HTML だけを調べ、圧縮もせずに割合で見積もります。
このため、HTML だけ圧縮して CSS と JavaScript を圧縮しないサーバーでも、指摘は消えます。nginx で gzip on; だけを書いたサーバーで試すと、HTML は gzip で届きましたが、bootstrap.min.css(232,803 バイト)と lodash.min.js(73,015 バイト)はそのまま届きました。それでも Lighthouse の表示は次のとおりでした。

指摘が消えた後も、CSS と JavaScript が圧縮されているかは、自分で確かめる必要があります。
nginxで、CSSとJavaScriptも圧縮する
nginx の gzip on; だけでは HTML しか圧縮されないのは、nginx の gzip モジュールの解説にあるとおり、圧縮する種類を決める gzip_types の既定値が text/html だからです。ほかの種類は、gzip_types に書き足します。同じ解説によると、圧縮のレベル(gzip_comp_level)の既定値は 1 です。
Ubuntu の nginx のパッケージに入っている /etc/nginx/nginx.conf も、gzip on; だけが有効で、gzip_types の行はコメントになっていました。
$ grep -n gzip /etc/nginx/nginx.conf
46: gzip on;
48: # gzip_vary on;
49: # gzip_proxied any;
50: # gzip_comp_level 6;
51: # gzip_buffers 16 8k;
52: # gzip_http_version 1.1;
53: # gzip_types text/plain text/css application/json application/javascript text/xml application/xml application/xml+rss text/javascript;
CSS と JavaScript も圧縮するには、server の中を次のようにしました。nginx の mime.types では、.js は application/javascript です。gzip_vary on; は、レスポンスに Vary: Accept-Encoding を付ける設定です。MDN の Vary の解説によると、Vary に書いたヘッダーの値ごとに、レスポンスが別々にキャッシュされます。
gzip on;
gzip_types text/css application/javascript application/json image/svg+xml;
gzip_comp_level 6;
gzip_vary on;
JPEG や PNG のように、すでに圧縮された形式は入れていません。MDN の Content-Encoding の解説では、.zip や .jpeg のような圧縮済みの形式を重ねて圧縮すると、かえって大きくなることがあると説明されています。
Brotliを足して、gzipは予備にする
Ubuntu 24.04 では、nginx の Brotli のモジュールが libnginx-mod-http-brotli-filter というパッケージで入ります。入れると、モジュールを読み込む設定が /etc/nginx/modules-enabled/ に置かれます。設定の書き方は ngx_brotli の README にあり、brotli_types の既定値も text/html だけです。レベル(brotli_comp_level)の既定値は 6 です。
brotli on;
brotli_types text/css application/javascript application/json image/svg+xml;
brotli_comp_level 6;
gzip on;
gzip_types text/css application/javascript application/json image/svg+xml;
gzip_comp_level 6;
gzip_vary on;
Lighthouse が使った Chrome は、Accept-Encoding: gzip, deflate, br, zstd を送ってきました(nginx のアクセスログで確かめました)。この設定のサーバーは、Chrome には Brotli で返しました。curl で Accept-Encoding を変えて確かめると、br を含むときは Brotli、gzip だけなら gzip、何も送らなければ圧縮せずに返しました。
$ curl -s -o /dev/null -D - -H 'Accept-Encoding: gzip, deflate, br, zstd' http://localhost:8083/bootstrap.min.css -w 'downloaded: %{size_download} bytes\n'
HTTP/1.1 200 OK
Server: nginx/1.24.0 (Ubuntu)
Content-Type: text/css
Transfer-Encoding: chunked
Connection: keep-alive
Vary: Accept-Encoding
Content-Encoding: br
downloaded: 27432 bytes
$ curl -s -o /dev/null -D - -H 'Accept-Encoding: gzip' http://localhost:8083/bootstrap.min.css -w 'downloaded: %{size_download} bytes\n'
HTTP/1.1 200 OK
Server: nginx/1.24.0 (Ubuntu)
Content-Type: text/css
Transfer-Encoding: chunked
Connection: keep-alive
Vary: Accept-Encoding
Content-Encoding: gzip
downloaded: 31118 bytes
(Date などのヘッダーの行は省いています。)
curl --compressed で受け取って展開した中身は、圧縮した3つの設定(gzip、Brotli、事前圧縮)のどれでも、元のファイルと同じでした。
転送量の違い
Lighthouse の結果の network-requests から、HTML・CSS・JavaScript の転送量(transferSize)を足して比べました。

| 設定 | HTML | CSS | JavaScript | FCP |
|---|---|---|---|---|
| 圧縮なし | 50,330 | 233,054 | 73,279 | 2.1 秒 |
gzip on; だけ |
5,122 | 233,054 | 73,279 | 2.0 秒 |
| gzip(レベル 6) | 4,687 | 31,420 | 26,236 | 0.9 秒 |
| Brotli(レベル 6) | 2,555 | 27,725 | 25,409 | 0.9 秒 |
| 事前圧縮の Brotli(レベル 11) | 2,515 | 22,981 | 23,375 | 0.9 秒 |
(単位はバイト。FCP は Lighthouse がモバイルの回線を想定して見積もった値です。)
HTML だけを圧縮しても、FCP(テキストか画像が初めて表示されるまでの時間)は 2.1 秒から 2.0 秒にしか縮みませんでした。CSS と JavaScript も圧縮すると 0.9 秒になりました。「Render-blocking requests」(レンダリングをブロックしているリクエスト)には bootstrap.min.css が挙がっていて、このファイルが圧縮なしのときの転送量の約3分の2を占めています。この項目の見込みは、圧縮なしで 1,180 ms、HTML だけ圧縮したときは 1,340 ms で、CSS も圧縮すると 290 ms でした。
ほかの項目の数字も変わりました。「Reduce unused CSS」(使用していない CSS の削減)の見込みは、圧縮なしで 221 KiB、gzip で 30 KiB、Brotli で 26 KiB です。どの項目から手を付けるかは、圧縮した後のレポートで決め直します。
レベルを上げたときの大きさと時間
Node.js の zlib で、同じファイルをレベルを変えて圧縮し、大きさと時間(20回の中央値)を測りました。Node.js 22 の Brotli は 1.1.0 で、レベル 6 の CSS と JavaScript の大きさは、nginx が返したものと一致しました。
| ファイル | gzip 6 | gzip 9 | Brotli 6 | Brotli 11 |
|---|---|---|---|---|
index.html(50,080) |
4,395(0.18 ms) | 4,420(0.43 ms) | 2,266(0.40 ms) | 2,244(71.36 ms) |
bootstrap.min.css(232,803) |
30,829(2.81 ms) | 30,665(4.70 ms) | 27,432(3.34 ms) | 22,709(332.40 ms) |
lodash.min.js(73,015) |
26,014(2.36 ms) | 25,968(3.06 ms) | 25,102(2.41 ms) | 23,089(109.77 ms) |
(単位はバイト。かっこの中は圧縮にかかった時間です。)
gzip は 6 から 9 に上げても、ほとんど小さくなりませんでした。Brotli は 11 にすると bootstrap.min.css が 27,432 バイトから 22,709 バイトになった一方、1回の圧縮に 332 ms かかりました。レベル 6 の約 100 倍です。
あらかじめ圧縮したファイルを置く
変わらないファイルなら、配る前に一度だけ最高のレベルで圧縮しておき、nginx にはそのファイルを返させる方法があります。.gz と .br のファイルを、元のファイルの横に作りました。
$ gzip -9 -k site-static/bootstrap.min.css && brotli -q 11 -k site-static/bootstrap.min.css
(site-static は、配るファイルを置いたフォルダです。)
nginx では、gzip_static(gzip_static モジュールの解説)と brotli_static(libnginx-mod-http-brotli-static のパッケージ)を有効にします。
brotli_static on;
gzip_static on;
gzip_vary on;
この設定では、Chrome には .br のファイル(bootstrap.min.css は 22,709 バイト)がそのまま返り、Accept-Encoding: gzip だけを送ったときは .gz のファイル(30,777 バイト)が返りました。リクエストのたびに圧縮するのではなく、圧縮しておいたファイルをそのまま送ります。元のファイルを書き換えたときは、.gz と .br も作り直します。試しに、元の CSS だけを書き換えて .br を古いまま残すと、Brotli に対応したリクエストには古い中身が返り、Accept-Encoding を送らないリクエストには新しい中身が返りました。
設定を変えた後は、Lighthouse の表示だけでなく、curl で CSS や JavaScript のレスポンスに Content-Encoding が付いているかを見ると、どのファイルが圧縮されて届いているかが分かります。





