ドキュメントCommerceCommerce on Cloud

Fastly キャッシュをバイパスするカスタム VCL

最終更新日： 2025年10月14日

作成対象：

  • {"id":"c66ffd68-0f65-42bb-aa23-b4020f12e0bd"},{"id":"ff6a42d2-313e-452e-93a6-792e4fad9ff8"}

Fastly キャッシュをバイパスするようにカスタム VCL スニペットを作成することで、オリジンサーバーへのリクエストトラフィックをトラブルシューティングできます。 例えば、サイトの問題がキャッシュによって発生しているかどうかを判断したり、ヘッダーのトラブルシューティングを行うためにスニペットを作成できます。

特定のIP アドレスまたはURLからのリクエストに対して、Fastlyのキャッシュをバイパスするようにスニペットを設定できます。

NOTE
カスタム VCL設定を実稼動環境にマージする前に、必ずステージング環境でコードをテストしてください。

前提条件：

  • Fastly CDN を使用するように環境を設定する必要があります。 詳しくは、Fastly サービスの設定 ​ を参照してください。

  • Magento 2 の Fastly CDN モジュールが最新バージョンであることを確認してください。 Fastly モジュールのアップグレード ​ を参照してください。

  • Fastly サービスの環境設定を確認します。 Fastly キャッシュの確認 ​ を参照してください。

  • ステージング環境と実稼動環境にアクセスするには、管理者資格情報が必要です。

IP アドレスまたはURL​に基づいてFastly キャッシュをバイパスするには：

  1. 管理者に ログインします。

  2. ストア / 設定/構成 / 詳細 / システム​をクリックします。

  3. フルページキャッシュ > Fastly設定 > カスタム VCL スニペット​を展開します。

  4. 「カスタムスニペットを作成」をクリックします。

  5. VCL スニペット値を追加します。

    • 名前 — bypass_fastly

    • 種類 — recv

    • 優先度 — 5

    • VCL スニペットコンテンツ —

      次の例では、特定のIP アドレスに対してFastlyをバイパスします。

      code language-conf 
      if (client.ip == "<Your IPv4 IP address>" || client.ip == "<Your IPv6 IP address>") {
  return(pass);
}

      次の例では、特定のURL パターンに対してFastlyをバイパスします。

      code language-conf 
      if (req.url ~ "/media/feeds/GoogleShoppingHiVisNew.xml") {  return (pass);}

      正確なURL一致を得るには、~演算子の代わりに==演算子を使用します。 詳しくは、Fastly VCL リファレンスを参照してください。

  6. 「作成」をクリックします。

    FastlyでVCL スニペットをバイパスする を作成

  7. ページが再読み込みされたら、「Fastly設定」セクションの「VCLをFastly​にアップロード」をクリックします。

  8. アップロードが完了したら、ページ上部の通知に従ってキャッシュを更新します。

    アップロードプロセス中に、更新されたVCL バージョンをFastlyが検証します。 検証が失敗した場合は、カスタム VCL スニペットを編集して問題を修正します。 次に、VCLをもう一度アップロードします。

VCL スニペットを追加した後、次の例に示すように、cURL コマンドを使用して、指定したIP アドレスまたはURLからオリジンサーバーにリクエストを送信できます。

curl -svo /dev/null www.example.com/index.html

次に、応答を調べて、キャッシュされていないコンテンツに関する問題をトラブルシューティングします。

NOTE
カスタム VCL スニペットを手動でアップロードする代わりに、環境内の$MAGENTO_CLOUD_APP_DIR/var/vcl_snippets_custom ディレクトリにスニペットを追加できます。 このディレクトリのスニペットは、Commerce管理者で​_VCLをFastly_​にアップロードをクリックすると、自動的にアップロードされます。 Magento 2用Fastly CDN モジュールの自動カスタム VCL スニペットのデプロイメント ​を参照してください。

カスタム VCL スニペットの変更

  1. 管理者に ​ ログイン ​ します。

  2. ストア/設定/設定/詳細/システム をクリックします。

  3. フルページキャッシュ/Fastly 設定/カスタム VCL スニペット の順に展開します。

    ​ カスタム VCL スニペットの管理 ​

  4. アクション 列で、編集するスニペットの横にある設定アイコンをクリックします。

  5. ページのリロード後、「Fastly 設定 _セクションの​Fastly に VCL をアップロード_ をクリックします。

  6. アップロードが完了したら、ページ上部の通知に従ってキャッシュを更新します。

WARNING
「カスタム VCL スニペット UI オプションには、Adobe Commerce管理を通じて追加されたスニペットのみが表示されます。 Fastly API を使用してスニペットを追加する場合は、API を使用して ​ スニペットを管理 ​ します。

カスタム VCL スニペットの削除

  1. 管理者に ​ ログイン ​ します。

  2. ストア/設定/設定/詳細/システム をクリックします。

  3. フルページキャッシュ/Fastly 設定/カスタム VCL スニペット の順に展開します。

    ​ カスタム VCL スニペットの管理 ​

  4. アクション 列で、削除するスニペットの横にあるごみ箱アイコンをクリックします。

  5. 次のモーダルウィンドウで、「DELETE」をクリックし 新しいバージョンをアクティベートします。

WARNING
「カスタム VCL スニペット UI オプションには、Adobe Commerce管理を通じて追加されたスニペットのみが表示されます。 Fastly API を使用してスニペットを追加する場合は、API を使用して ​ スニペットを管理 ​ します。
recommendation-more-help
commerce-on-cloud-help-cloud-guide