詳細設定

ソース詳細ページでは、ソースの現在の状態と設定可能な追加設定が表示されます。ソースを作成して数秒後、ステータスフィールドがキューからデプロイ済みに変更されます。これが完了すると、ソースは使用準備が整います。

このページに記載されている設定を調整したい場合は、編集ボタンをクリックし、変更したいフィールドを編集して、レビューとデプロイをクリックしてソース設定を更新します。ほとんどのフィールドは自己説明的ですが、**（？）**アイコンにマウスを合わせると詳細が表示されます。

ソースタイプの変更

既に特定のソースタイプとして作成されたソースは、いつでも異なるタイプに変更できます。ドメイン、デフォルトパラメータ、デフォルト画像、キャッシュTTL設定などの設定はそのままですが、新しいソースタイプに応じてimgixとオリジンアセットの接続方法を変更する必要があります。

1. ソース詳細ページで、編集をクリックします。
2. ソースタイプの隣のドロップダウンメニューを開きます。
3. 切り替えるソースタイプを選択します。
4. 特定の設定（アクセスキー、ベースURLなど）を確認し、新しいタイプでソースを再デプロイするために実装します。
5. 設定が完了したら、レビュー＆デプロイボタンをクリックして、新しいソースタイプでソースを再デプロイします。

カスタムドメイン

ソースのベースURLとしてカスタムドメインを使用したい場合は、追加することができます。標準サブドメインとカスタムの両方が同じオリジン画像に解決されます。imgixサブドメインとカスタムドメインを最大100個追加できます。

1. ソース詳細ページで、編集をクリックします。
2. 「ドメイン」の下で、「カスタムドメイン」をクリックします（モバイルデバイスでは、先にドメイン追加をクリックします）。
3. 使用したいカスタムサブドメインを入力し、レビュー＆デプロイボタンをクリックして、新しいカスタムドメインでソースを再デプロイします。
4. DNSレジストラにアクセスし、CNAMEが新しい*.imgix.netホスト名を指すようにDNS設定を構成します。ここで*はimgixで使用しているソースのサブドメインです。以下にGoogle DomainsでのCNAMEレコード設定の例を示します。
5. DNSが新しい変更を伝播するまで待ちます。これにはDNSプロバイダーによって最大24時間かかる場合があります。

すべての標準ホスト名はimgixによって自動的にセキュアトランスポート（SSL/TLS）をサポートします。

注意: デフォルトでは、カスタムサブドメインはhttpでのみ使用できます。httpsを使用するには、CDNパートナーを通じてSSL証明書が必要であり、現在はプレミアムプランのお客様のみが利用可能です。 プレミアムユーザーの場合は、アカウントマネージャーに連絡するか、サポートに連絡して設定してください。詳細については、アセットのセキュリティガイドを参照してください。

デフォルトおよびエラー画像

ソースにはいくつかの基本的なエラー防止機能が装備されており、欠落しているアセットやエラーがあるアセットの代わりに表示される画像を設定できます。これにより、アセットに問題があっても画像が空白で表示されることはありません。画像を配信するためにレンダリングAPIを使用する場合、オリジナルの画像リクエストからパラメータをデフォルトまたはエラー画像に適用するオプションもあります。

デフォルト画像またはエラー画像を追加するには：

1. ソース詳細ページで、編集をクリックします。
2. 「画像デフォルト」の下で適切なフィールドをクリックし、画像のURLを入力します。
3. オリジナルの画像リクエストからデフォルトを適用したい場合は、画像フィールドの下のチェックボックスをクリックします。
4. レビュー＆デプロイボタンをクリックして、新しい設定でソースを再デプロイします。

デフォルト画像設定とエラー画像設定は異なる動作をしますが、どちらも使用量のクオータに影響を与える可能性があります。以下で続けて説明します。

デフォルト画像

デフォルト画像が設定されている場合、ソースの404の動作が変更されます。これが有効になっていると、通常404になるリクエストが、指定された画像とともに200レスポンスを返すようになります。

画像が存在するかどうかに関わらず、すべてのリクエストで200レスポンスとデフォルト画像を受け取ることが重要な場合に役立ちます。

デフォルト画像とエラー画像が設定されている場合、リクエストが404エラーになる場合はデフォルト画像がエラー画像を上書きします。

レスポンスが200に変換されるため、このリクエストは月間オリジン画像使用量のクオータにカウントされます。使用量のクオータを超えないようにするために、存在しないアセットへのリクエスト数を制限することをお勧めします。

エラー画像

エラー画像が有効な場合、imgixは通常エラーを引き起こすアセット（4xx、5xxなど）に適切なエラーコードを返し続けながら、エラー画像設定で指定された画像も返します。

デフォルト画像とは異なり、エラーレスポンスは保存されます。エラー画像をトリガする任意のアセットはクオータにカウントされず、404を含みます。

デフォルト画像が有効な場合、リクエストが404エラーになる場合にはエラー画像設定を上書きし、レスポンスを200に変換します。このシナリオでは、月間使用量のクオータにカウントされます。

注意: エラー画像を設定して変更または削除する必要がある場合、この変更が有効になるまで最大6時間かかる場合があります。より早くクリアする必要がある場合は、support@imgix.comまでご連絡ください。

デフォルトパラメータ

すべての画像に適用したい基本レベルの画像最適化を指定したい場合、ソースレベルでデフォルトパラメータを指定できます。

注意: chはキャッシングインフラストラクチャとの相互作用の方法のため、デフォルトパラメータとして設定できません。

1. ソース詳細ページで、編集をクリックします。
2. 画像デフォルトの下で、ドロップダウンメニューからパラメータを選択し、値を提供します。デフォルトを設定したいパラメータ/値のペアを追加します。
3. レビュー＆デプロイボタンをクリックして、新しい設定でソースを再デプロイします。

デフォルトパラメータを適用すると、ソース内のすべての画像がimgixのレンダリングサービスを通過するようになります。これにより、元のアセットをそのまま提供する機能が無効になります。PDFを提供している場合や、ソースで元の品質/サイズの画像を提供するためにパラメータを省略している場合、デフォルトパラメータの適用はこれらのアセットのデフォルト動作 (opens in a new tab)に影響を与えます。

デフォルトパラメータに関する詳細情報、それらを上書きする方法、および推奨使用法については、このブログ投稿をチェックしてください.

クロスドメインポリシーファイル

ウェブサイトまたはアプリがドメイン間でアセットを正しく提供するためにクロスドメインポリシーファイルを必要とする場合、ダッシュボードでセキュリティ設定の下のチェックボックスをクリックすることで有効にすることができます：

有効にすると、imgixは以下のファイルをリクエストするクライアントに提供します：

<?xml version="1.0"?>
<!DOCTYPE cross-domain-policy SYSTEM "http://www.adobe.com/xml/dtds/cross-domain-policy.dtd">
<cross-domain-policy>
    <site-control permitted-cross-domain-policies="all" />
    <allow-access-from domain="*" secure="false"/>
</cross-domain-policy>

キャッシュ設定

キャッシュ設定は、imgixによって生成されたアセットおよび派生画像がエンドユーザーのブラウザキャッシュにどの程度存在するかを決定します。一般的に、オリジン画像がその時間内に変更されることはほとんどないため、TTL（存続時間）値を少なくとも1年に設定することをお勧めします。このようにすると、アセットがユーザーのローカルキャッシュから提供される可能性が高くなり、imgixシステムの中間キャッシュから再生成または提供されることなく、ユーザーにより速いページロードが提供され、帯域幅コストが削減されます。

デフォルトキャッシュTTLの最大値は1年です。最小値は30分です。

TTLに関する詳細情報は、Wikipedia (opens in a new tab)を参照してください。

キャッシュTTL動作ドロップダウンは、imgixがオリジン画像のCache-Control: max-ageヘッダーとどのように相互作用するかを決定します。これには次の3つのオプションがあり、それぞれに対応するTTL値が設定されています：

• オリジンを尊重: ヘッダーが存在する場合はCache-Control: max-ageヘッダーを尊重し、存在しない場合はデフォルトキャッシュTTL値でヘッダーを適用します。
• オリジンを上書き: ヘッダーが存在する場合はCache-Control: max-ageヘッダーを上書きキャッシュTTL値で上書きし、存在しない場合はその値でヘッダーを適用します。
• 最小限を強制: ヘッダーが存在しない場合は最小キャッシュTTL値でCache-Control: max-ageヘッダーを適用し、既存のヘッダーの値が最小キャッシュTTL値より低い場合はそれを上書きします。

アセットキャッシングのデフォルト動作と値を設定するだけでなく、デフォルトのエラー画像に対してCache-Control: max-ageヘッダーを設定することもできます（設定されている場合）。この値は短くする必要があり、エラーが解決した後にエラー画像が表示され続けないようにします。

TTL値の設定方法は以下の通りです。

1. ソース詳細ページで、編集をクリックします。
2. 「キャッシュ設定」の下で、ドロップダウンから好みのキャッシュTTL動作を選択します。
3. 変更したいTTLの時間値を入力し、ドロップダウンメニューから時間単位を選択します。
4. レビュー＆デプロイボタンをクリックして、新しいキャッシュ設定でソースを再デプロイします。

imgixは指定された期間であなたのアセットと派生画像をキャッシュするために最善を尽くしますが、imgixが作成可能な画像の組み合わせの膨大な数により、派生画像を永遠に完全にキャッシュすることは不可能です。

時には、キャッシュから画像派生物を排出し、必要に応じて再レンダリングすることがあります。意図されたキャッシュタイムアウトまたは30日のいずれか短い期間前に排出され再レンダリングされた派生画像については請求しません。

また、アセットをアセットストレージに追加する際には、すべてのアセットにCache-Control: max-age=31536000ヘッダーを設定することをお勧めします。これにより、imgixが処理しないファイル（CSSなど）のキャッシュミスが減少し、オリジンからのアセットの再取得も防ぐことができます。すでにあるファイルを更新する必要がある場合は、s3cmd (opens in a new tab)（Amazon S3用）などのスクリプトを実行してアップロード後にヘッダーを設定できます。

注意: ソースがデプロイされた後にキャッシュTTL設定を変更する場合、古い設定の下で要求されたアセットは、新しい設定が有効になるためにパージする必要があります。

一般的なキャッシング戦略とimgixとの相互作用についての詳細は、画像のフィンガープリントガイドをご覧ください。

アセットマネージャーアセットの除外

アセットマネージャーで含めるまたは除外するフォルダを指定できます。これにより、アセットマネージャーに表示されるアセットが制御されます。

デフォルトの動作は、ソースのベースパスプレフィックス内のすべてのメディアとサブディレクトリをクロールするように設定されています。

特にビデオの場合は、 動画APIによってエンコードされるビデオを制御します。

動画APIを有効にしたソースは定期的に当社のサービスによってクロールされ、エンコード可能なビデオアセットを識別します。これにより、発信元プロバイダーでのエグレス帯域幅の使用が発生します。

動画APIによって提供されるビデオのみをクロールするようにビデオパスを設定し整理することを強くお勧めします。

ソースの無効化、有効化、削除

ソースのビューページの右上にある設定アイコンをホバーすることで、現在のソースの状態に応じて無効化/有効化/削除オプションが表示されます。

無効化または削除されたソースは、アセットのTTLが期限切れになるまで、またはパージされるまでキャッシュからアセットを提供し続けます。