Lighthouseでテキスト圧縮を勧められたときの直し方と転送量

​​Lighthouse​Brotli,gzip,HTTP,nginx,パフォーマンス

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)で抜き出すと、次のようになりました。

console
$ 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のレポートでDocument request latencyの項目を開いた画面。Est savings of 33 KiBと出ていて、Avoids redirectsとServer responds quickly (observed 4 ms)には緑のチェック、No compression appliedには赤い丸に斜線のアイコンが付いている
圧縮していないページのレポート

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件だけです。

  1. レスポンスの Content-Encoding が gzip、br、deflate、zstd のどれかなら、圧縮しているとみなす
  2. 圧縮していなければ、減らせる大きさを見積もる。HTML なら、元の大きさの 67% を減らせるとみなす
  3. 見積もりが 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 の表示は次のとおりでした。

LighthouseのレポートでDocument request latencyの項目を開いた画面。3つの行すべてに緑のチェックが付き、Applies text compressionと出ている
HTML だけを圧縮したページのレポート

指摘が消えた後も、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 の行はコメントになっていました。

console
$ 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 に書いたヘッダーの値ごとに、レスポンスが別々にキャッシュされます。

nginx
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 です。

nginx
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、何も送らなければ圧縮せずに返しました。

console
$ 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)を足して比べました。

設定ごとの転送量の合計を比べた横棒グラフ。圧縮なしは356,663バイト、gzip on だけは311,455バイトで、HTMLだけ圧縮されCSSとJSはそのままと注記がある。gzip(レベル6)は62,343バイト、Brotli(レベル6)は55,689バイト、事前圧縮のBrotli(レベル11)は48,871バイト
設定ごとの、ページを開くときの転送量
設定 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 のファイルを、元のファイルの横に作りました。

console
$ 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 のパッケージ)を有効にします。

nginx
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 が付いているかを見ると、どのファイルが圧縮されて届いているかが分かります。

​Posted by 86