ドキュメントCommerce設定ガイド

[PaaS のみ]{class="badge informative" title="Adobe Commerce on Cloud プロジェクト（Adobeが管理する PaaS インフラストラクチャ）およびオンプレミスプロジェクトにのみ適用されます。"}

Web サーバーの設定

Last update: Tue Oct 07 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

作成対象：

  • 経験者
  • 管理者
  • 開発者

Web サーバーは Web サーバーではなく、受信 HTTP リクエストに Varnish が直接応答するため、デフォルトのポート 80 以外のポートでリッスンするように web サーバーを設定します。

次のセクションでは、例としてポート 8080 を使用します。

Apache 2.4 リッスンポートを変更するには:

  1. /etc/httpd/conf/httpd.conf をテキストエディターで開きます。
  2. Listen ディレクティブを見つけます。
  3. listen ポートの値を 8080 に変更します。 （利用可能な任意のリッスンポートを使用できます）。
  4. httpd.conf への変更を保存し、テキストエディターを終了します。

Varnish システムの設定を変更します。

Varnish システムの設定を変更するには：

  1. root 権限を持つユーザーとして、Vanish 設定ファイルをテキストエディターで開きます。

    • CentOS 6:/etc/sysconfig/varnish
    • CentOS 7: /etc/varnish/varnish.params
    • Debian: /etc/default/varnish
    • Ubuntu: /etc/default/varnish

  2. Varnish listen ポートを 80 に設定します。

    code language-conf 
    VARNISH_LISTEN_PORT=80

    Varnish 4.x の場合、DAEMON_OPTS に -a パラメータの正しいリスニング ポートが含まれていることを確認してください（VARNISH_LISTEN_PORT が正しい値に設定されている場合でも）。

    code language-conf 
    DAEMON_OPTS="-a :80 \
   -T localhost:6082 \
   -f /etc/varnish/default.vcl \
   -S /etc/varnish/secret \
   -s malloc,256m"

  3. 変更内容を Varnish 設定ファイルに保存し、テキストエディタを終了します。

デフォルトの VCL の修正

この節では、Varnish が HTTP 応答ヘッダーを返すための最小限の設定を提供する方法について説明します。 これにより、Commerce アプリケーションを Varnish を使用するように設定する前に、Varnish が機能することを確認できます。

ワニスを最小限に設定するには：

  1. default.vcl のバックアップ：

    code language-bash 
    cp /etc/varnish/default.vcl /etc/varnish/default.vcl.bak

  2. /etc/varnish/default.vcl をテキストエディターで開きます。

  3. 次のスタンザを探します。

    code language-conf 
    backend default {
    .host = "127.0.0.1";
    .port = "80";
}

  4. .host の値を、Varnish バックエンド または オリジンサーバー の完全修飾ホスト名または IP アドレスおよびリッスンポートに置き換えます。つまり、Varnish が高速化するコンテンツを提供するサーバーです。

    通常、これは web サーバーです。 Varnish ガイド ​ の バックエンドサーバー を参照してください。

  5. .port の値を web サーバーのリッスンポート（この例では 8080）に置き換えます。

    例：Apache がホスト 192.0.2.55 にインストールされ、Apache がポート 8080 をリッスンしている

    code language-conf 
    backend default {
    .host = "192.0.2.55";
    .port = "8080";
}
    note info
    INFO
    Varnish と Apache が同じホスト上で実行されている場合、Adobeは localhost ではなく、IP アドレスまたはホスト名を使用することをお勧めします。

  6. default.vcl への変更を保存し、テキストエディターを終了します。

  7. Varnish を再起動します。

    code language-bash 
    service varnish restart

Varnish を起動できない場合は、次のようにコマンドラインから実行してみてください。

varnishd -d -f /etc/varnish/default.vcl

エラーメッセージが表示されます。

INFO
Varnish がサービスとして開始しない場合は、SELinux ルールを設定して実行できるようにする必要があります。

ワニスが機能していることを確認します

次の節では、Varnish が機能しているが、それを使用するようにCommerceを設定 せずに 確認する方法について説明します。 Commerceを設定する前に、これを試してください。

以下のセクションで説明するタスクを、示された順序で実行します。

ワニスを開始

Enter: service varnish start

Varnish をサービスとして起動できない場合は、次のようにコマンドラインから起動します。

  1. Varnish CLI を起動します。

    code language-bash 
    varnishd -d -f /etc/varnish/default.vcl

  2. Varnish 子プロセスを開始します。

    プロンプトが表示されたら、start と入力します

    正常に開始されたことを確認する次のメッセージが表示されます。

    code language-none 
    child (29805) Started
200 0

Child (29805) said
Child (29805) said Child starts

netstat

Varnish サーバにログインし、次のコマンドを入力します。

netstat -tulpn

特に、次の出力を探します。

tcp        0      0 0.0.0.0:80                  0.0.0.0:*                   LISTEN      32614/varnishd
tcp        0      0 127.0.0.1:58484             0.0.0.0:*                   LISTEN      32604/varnishd
tcp        0      0 :::8080                     :::*                        LISTEN      26822/httpd
tcp        0      0 ::1:48509                   :::*                        LISTEN      32604/varnishd

前述の例では、ポート 80 で動作する Varnish と、ポート 8080 で動作する Apache を示しています。

varnishd の出力が表示されない場合は、Varnish が実行されていることを確認します。

netstat のオプションを参照してください ​。

Commerce ソフトウェアのインストール

まだインストールしていない場合は、Commerce ソフトウェアをインストールします。 ベース URL の入力を求められたら、Varnish ホストおよびポート 80 （Varnish の場合）を使用します。これは、Varnish がすべての受信 HTTP リクエストを受信するためです。

Commerceのインストール中にエラーが発生した可能性があります：

Error 503 Service Unavailable
Service Unavailable
XID: 303394517
Varnish cache server

このエラーが発生した場合は、default.vcl を編集して、backend のスタンザに次のようにタイムアウトを追加します。

backend default {
   .host = "127.0.0.1";
   .port = "8080";
   .first_byte_timeout = 600s;
}

HTTP 応答ヘッダーの検証

これで、任意のページから返されたHTML応答ヘッダーを確認することで、Varnish がページを提供していることを確認できます。

ヘッダーを確認する前に、Commerceを開発者モードに設定する必要があります。 それには複数の方法があります。最も簡単な方法は、Commerce アプリケーションのルートの .htaccess を変更することです。 magento deploy:mode:set コマンドを使用することもできます。

Commerceを開発者モードに設定

Commerceを開発者モードに設定するには、magento deploy:mode:set コマンドを使用します。

Varnish ログを見る

Varnish が実行されていることを確認し、Varnish サーバで次のコマンドを入力します。

varnishlog

Web ブラウザーで、任意のCommerce ページに移動します。

応答ヘッダーの長いリストがコマンドプロンプトウィンドウに表示されます。 次のようなヘッダーを探します。

-   BereqHeader    X-Varnish: 3
-   VCL_call       BACKEND_FETCH
-   VCL_return     fetch
-   BackendOpen    17 default(10.249.151.10,,8080) 10.249.151.10 60914
-   Backend        17 default(10.249.151.10,,8080)
-   Timestamp      Bereq: 1440449534.261791 0.000618 0.000618
-   ReqHeader      Host: 10.249.151.10
-   ReqHeader      Connection: keep-alive
-   ReqHeader      Content-Length: 86
-   ReqHeader      Cache-Control: max-age=0
-   ReqHeader      Accept: text/html,application/xhtml+xml,application/xml;q=0.9,image/webp,*/*;q=0.8
-   ReqHeader      Origin: http://10.249.151.10

このようなヘッダーが表示 されない 場合は、Varnish を停止し、default.vcl を確認して、もう一度試してください。

HTMLの応答ヘッダーの確認

応答ヘッダーを調べる方法はいくつかあり、ブラウザーのプラグインやブラウザーインスペクターを使用する方法などがあります。

次の例では、curl を使用しています。 このコマンドは、HTTP を使用してCommerce サーバーにアクセスできる任意のマシンから入力できます。

curl -I -v --location-trusted '<your Commerce base URL>'

以下に例を挙げます。

curl -I -v --location-trusted 'http://192.0.2.55/magento2'

次のようなヘッダーを探します。

Content-Type: text/html; charset=iso-8859-1
X-Varnish: 15
Age: 0
Via: 1.1 varnish-v6
X-Magento-Cache-Debug: HIT
recommendation-more-help
386822bd-e32c-40a8-81c2-ed90ad1e198c