2026年5月20日
2026年5月20日
LiteSpeed Cacheの設定方法|キャッシュ・ページ最適化・画像最適化とWP-CLI
LiteSpeed Cache(LSCWP)は、LiteSpeed Technologies が提供する WordPress 用の無料プラグインです。サーバー側のキャッシュ(LSCache)と連携するページキャッシュに加えて、CSS・JavaScript の最適化、画像最適化、オブジェクトキャッシュとの連携などの機能をまとめて持っています。
設定項目が多いため、この記事では「どの機能がどの環境で動くか」を先に確認し、キャッシュ → ページ最適化 → 画像最適化の順に、公式ドキュメント(docs.litespeedtech.com)で確認できる内容だけを説明します。内容は2026年10月時点のものです。設定項目名は管理画面を英語表示にしたときの名前で書いています。日本語表示では訳語で表示されるので、位置と説明文で対応を確かめてください。
機能ごとに必要な環境
LiteSpeed Cache のページキャッシュは、プラグインだけでは動きません。サーバー側に LSCache の仕組みが必要です。
| 機能 | 必要なもの |
|---|---|
| ページキャッシュ(Cache) | LiteSpeed Web Server、OpenLiteSpeed、LiteSpeed Web ADC、または QUIC.cloud CDN |
| ESI(ページの一部だけを別扱いにする) | LiteSpeed Web Server(Enterprise)、LiteSpeed Web ADC、または QUIC.cloud CDN。OpenLiteSpeed は非対応 |
| CSS/JS の最小化・結合、遅延読み込みなど | サーバーを問わず使える |
| UCSS・クリティカルCSS・LQIP・Viewport Images | QUIC.cloud のサービス |
| 画像最適化 | QUIC.cloud のサービス |
| オブジェクトキャッシュ | サーバーで動く Memcached(または LSMCD)か Redis |
Apache や Nginx のサーバーでは、ページキャッシュは働かず、最適化の機能だけが使えます。その場合は、ページキャッシュに別のプラグインやサーバーの仕組みを使い、LiteSpeed Cache と二重にならないようにします。
使っているサーバーが LiteSpeed かどうかは、契約しているレンタルサーバーの仕様ページで確認できます。設定後に、後述の「キャッシュが効いているか確かめる」の方法でも確認できます。
インストールと設定のバックアップ
管理画面の「プラグイン」→「新規追加」で「LiteSpeed Cache」を検索してインストールするか、WP-CLI で次のように入れます。
wp plugin install litespeed-cache --activate
設定を変える前後で、設定内容をファイルに書き出しておくと、元に戻すときに使えます。
# 現在の設定をファイルに書き出す
wp litespeed-option export --filename=/tmp/lscwp-options.txt
# 書き出した設定を読み込む
wp litespeed-option import /tmp/lscwp-options.txt
# 個別の設定値を見る・変える(例: ログインユーザーのキャッシュ)
wp litespeed-option get cache-priv
wp litespeed-option set cache-priv false
管理画面には「Presets」メニューもあり、用意された組み合わせを一括で適用できます(WP-CLI では wp litespeed-presets apply basic のように指定)。適用前の設定はバックアップとして残り、wp litespeed-presets get_backups で一覧、wp litespeed-presets restore <番号> で戻せます。
ページキャッシュの設定(Cache)
「LiteSpeed Cache」→「Cache」の「Cache」タブに、キャッシュの基本の項目があります。主な項目と既定値は次のとおりです。
| 項目 | 既定値 | 内容 |
|---|---|---|
| Enable Cache | ON | オフにするとキャッシュを止め、保存済みのキャッシュも消える |
| Cache Logged-in Users | ON | ログインユーザーのページを、そのユーザー専用(プライベート)のキャッシュとして保存する |
| Cache Commenters | ON | コメント投稿者に、キャッシュ済みのページを見せるかどうか |
| Cache REST API | ON | REST API の応答をキャッシュする |
| Cache Login Page | OFF | ログインページをキャッシュする |
| Cache Mobile | OFF | モバイルとデスクトップで別のキャッシュを持つ |
Cache Mobile は、主にスマートフォン専用の表示を別に作っている(レスポンシブでない)テーマ向けの項目です。レスポンシブなテーマでは、通常はオフのままでかまいません。オンにすると、キャッシュの種類が増え、クローラーの負荷も増えます。
キャッシュしたくない URL は、「Excludes」タブの Do Not Cache URIs に1行に1つずつ書きます(部分一致。^ で先頭一致、$ で完全一致)。
更新時にキャッシュを消す
「Purge」タブの Purge All On Upgrade は既定でオフですが、公式ドキュメントはオンにすることを勧めています。プラグイン・テーマ・WordPress 本体の更新時に、古い HTML がキャッシュに残るのを防げます。
手動でキャッシュを消すときは、管理バーの LiteSpeed のアイコンから操作するか、WP-CLI の litespeed-purge を使います。
# すべてのキャッシュを消す
wp litespeed-purge all
# 特定の URL のキャッシュを消す
wp litespeed-purge url https://example.com/sample-page/
# 投稿 ID を指定して消す
wp litespeed-purge post_id 12 34
キャッシュが効いているか確かめる
ログアウトした状態(またはブラウザーのプライベートウィンドウ)でページを2回開き、レスポンスヘッダーに x-litespeed-cache: hit が出るかを確認します。
curl -sI https://example.com/ | grep -i "x-litespeed-cache"
# 1回目は miss、2回目以降に hit になれば、サーバー側のキャッシュが働いている
LiteSpeed Web ADC 経由では X-LSADC-Cache、QUIC.cloud CDN 経由では X-QC-Cache が代わりに出ることがあります。どのヘッダーもまったく出ない場合は、サーバーが LiteSpeed 系でないか、LSCache の設定に問題があります。ログイン中のブラウザーはキャッシュを通らないことがあるので、確認はログアウトした状態で行います。
ページ最適化(Page Optimization)
「Page Optimization」には、CSS・JS・HTML・画像の読み込みに関する設定があります。表示崩れや動作不良が起きやすいところなので、公式ドキュメントも本番で有効にする前に十分に試すよう注意しています。1項目ずつ変更し、トップページ・記事・フォーム・カートなど主要なページを確かめてから次へ進んでください。
| タブ | 主な項目 |
|---|---|
| CSS Settings | CSS Minify、CSS Combine、Generate UCSS、Load CSS Asynchronously |
| JS Settings | JS Minify、JS Combine、Load JS Deferred(Off / Deferred / Delayed) |
| HTML Settings | HTML Minify、DNS Prefetch、Remove WordPress Emoji など |
| Media Settings | Lazy Load Images、Lazy Load iframes、Add Missing Sizes など |
| Tuning / Tuning CSS | 最適化から除外する JS・CSS・URI の指定 |
進め方の例です。
CSS MinifyとJS Minifyをオンにして、表示を確認する。- 必要なら
CSS Combine・JS Combineを試す。結合で不具合が出る場合、公式ドキュメントはCSS Combine External and Inline・JS Combine External and Inlineをオンにして読み込み順を保つ方法を挙げています。 Load JS DeferredはDeferredから試す。Delayedは操作があるまで JS を実行しないため、スライダーやフォームなどが動かなくなることがあります。- 不具合の原因になったファイルは、「Tuning」の
JS Excludesなどで最適化の対象から外す。
Generate UCSS(使っている CSS だけを抜き出す)、Load CSS Asynchronously(クリティカルCSS を作って CSS を非同期に読む)、Viewport Images は QUIC.cloud のサービスで生成されます。QUIC.cloud を使わない場合、これらは働きません。
画像の遅延読み込みは「Media Settings」の Lazy Load Images です。ファーストビューの大きな画像(LCP の対象)まで遅延させると表示が遅く見えるため、その画像は「Media Excludes」の Lazy Load Image Excludes で除外します。
画像最適化(Image Optimization)
画像最適化は、画像を QUIC.cloud のサーバーに送り、圧縮した画像を受け取る仕組みです。先に「General」→「Online Services」で Enable QUIC.cloud services を押してサイトを QUIC.cloud につなぎます。サーバーにファイアウォールがある場合は、QUIC.cloud の IP アドレスを許可しておく必要があります。
- 「Image Optimization」の設定タブで、
Optimize Original Images(既定オン。元画像は.bk付きでバックアップされる)などを確認する。 - 「Send Optimization Request」を押す。最初の1回はテストとして1枚だけ送られ、以降は最大200枚ずつ送られます。
- 処理が終わった画像は、cron または「Pull Images」で取り込まれます。
WebP や AVIF の画像は、設定で有効にしない限り作られません。画面の説明に沿って次世代形式の生成と置き換えを有効にし、メディアライブラリで WebP や AVIF の表示が付くかを確かめます。
WP-CLI でも同じ操作ができます。
wp litespeed-image push # 最適化を依頼する
wp litespeed-image pull # 最適化済みの画像を取り込む
wp litespeed-image status # 進み具合を見る
Remove Original Backups をオンにすると元画像のバックアップが消え、元に戻せなくなります。最適化の結果を確かめてから判断してください。
QUIC.cloud の画像最適化には無料で使える標準の処理枠と、月ごとの無料分を超えると有料になる優先処理の枠があります(2026年10月時点の公式ドキュメント)。料金や無料分は変わることがあるため、使う前に QUIC.cloud の公式サイトで確認してください。
ESI(ページの一部を別扱いにする)
ESI(Edge Side Includes)は、ページを部品に分け、部品ごとに「共通のキャッシュ」「ユーザー専用のキャッシュ」「キャッシュしない」を使い分ける仕組みです。これにより、ログインユーザーにもキャッシュ済みのページを返せます。
- 「Cache」→「ESI」タブの
Enable ESIで有効にします。 - 有効にすると、管理バー、コメントフォームなどが ESI の部品として扱われます(
Cache Admin Bar、Cache Comment Form)。 - LiteSpeed Web Server(Enterprise)、LiteSpeed Web ADC、QUIC.cloud CDN で動きます。OpenLiteSpeed では使えません。
ログインユーザーや会員向けの表示が多いサイトで、キャッシュの効き目を上げたいときに検討する機能です。有効にしたら、ログイン状態の表示(ユーザー名、カートの中身など)が他人のものと混ざっていないかを、複数のアカウントで確かめてください。
オブジェクトキャッシュ(Object)
「Cache」→「Object」タブで、Memcached(LSMCD を含む)または Redis をオブジェクトキャッシュとして使えます。プラグイン自身はオブジェクトキャッシュを持たないため、サーバーでこれらが動いていることが前提です。レンタルサーバーで使えるかは、各社の仕様を確認してください。
QUIC.cloud CDN
QUIC.cloud CDN を使うと、LiteSpeed 以外のサーバーでもページキャッシュを CDN 側で効かせられます。「General」→「Online Services」で QUIC.cloud につないだあと、「CDN」の画面の案内に沿ってドメインを設定します。状態は WP-CLI でも確認できます。
wp litespeed-online cdn_status
DNS の切り替えを伴う作業なので、TTL を短くしておく、作業時間を決めるなど、通常の DNS 変更と同じ準備をしてから行ってください。
不具合が出たときの戻し方
- 表示が崩れた: 「Page Optimization」で直前にオンにした項目をオフにし、
wp litespeed-purge allでキャッシュを消してから確認する。 - ログイン状態の表示がおかしい:
Cache Logged-in Usersや ESI の設定を見直す。 - 設定全体を戻したい: 書き出しておいた設定を
wp litespeed-option importで読み込むか、wp litespeed-presets restoreでバックアップに戻す。
まとめ
- ページキャッシュは LiteSpeed 系サーバーか QUIC.cloud CDN が前提。Apache・Nginx では最適化の機能だけが使える。
- WP-CLI のコマンドは
wp litespeed-purge・wp litespeed-option・wp litespeed-imageなど。wp litespeed-cacheというコマンドは無い。 Cache Mobileはレスポンシブでないテーマ向け。Purge All On Upgradeはオンが勧められている。- CSS/JS の最適化は1項目ずつ試し、問題のあるファイルは Tuning で除外する。
- 画像最適化・UCSS・クリティカルCSS は QUIC.cloud のサービスで、料金と無料分は公式サイトで確かめる。
関連記事: