高度な設定

ソース詳細ページでは、あなたのソースの現在のステータスと設定可能な追加オプションが表示されます。Status フィールドは、ソースを作成してから数秒以内に「Queued」から「Deployed」に変わるべきです。一旦これが完了すると、ソースの使用準備が整ったことを意味します。

このページの設定を調整したい場合は、Edit ボタンをクリックし、変更したいフィールドを編集し、Review and Deploy をクリックしてソース構成を更新します。ほとんどのフィールドは説明不要ですが、(?) アイコンにカーソルを合わせると詳細が表示されます。

ソースタイプの変更

既に作成済みのソースが単一のソースタイプとして設定されている場合でも、いつでも別の種類に変更可能です。ドメイン、デフォルトパラメータ、デフォルト画像、キャッシュ TTL 設定などの構成設定はそのまま維持されますが、新しいソースタイプに応じて Imgix をオリジンアセットに接続する方法を変更する必要があります。

1. Source Details ページで Edit をクリック。
2. Source Type の横にあるドロップダウンメニューを開きます。
   
3. 切り替えたいソースタイプを選択します。
4. アクセスキー、ベース URL など、再デプロイするために必要な特定設定を確認・実装します。
5. 設定が完了したら Review & Deploy ボタンをクリックし、新しいソースタイプでソースを再デプロイします。

ドメイン

Imgix イメージサブドメイン

サブドメインを指定して Imgix で使用します。サブドメインは .imgix.net の前に来る URL の最初の部分で、ソースのベース URL を作成するために使用されます。たとえば、サブドメインを example に設定すると、ソースのベース URL は https://example.imgix.net となります。

カスタムドメイン

カスタムドメインをソースのベース URL として追加できます。標準のサブドメインとカスタムサブドメインの両方が、同じオリジン画像を指します。

1. Source Details ページで Edit をクリック。
2. 「Domains」欄で Custom Domain（モバイル端末ではまず Add Domain）をクリック。
   
3. 使用したいカスタムサブドメインを入力し、Review & Deploy をクリックして新しいカスタムドメインでソースを再デプロイ。
4. DNS レジストラに移動し、CNAME が新しい *.imgix.net ホスト名（* は使用する imgix のサブドメイン）を指すように DNS 設定を構成します。Google Domains での CNAME レコード設定例を以下に示します。
   
5. DNS が変更を反映（伝播）するのを待ちます。プロバイダによっては最大24時間かかることがあります。

Imgix によって提供される標準ホスト名（例: subdomain.imgix.net）はすべて、SSL/TLS による保護通信を自動的にサポートします。

注意： デフォルトでは、カスタムサブドメインは HTTP のみで使用可能です。HTTPS を利用するには、CDN パートナー経由の SSL 証明書が必要です。設定を希望される場合は、アカウントマネージャーまたは サポート に連絡してください。詳細は SSL ドキュメント をご覧ください。

アセットマネージャー処理ルール

アセットマネージャー・クロールが有効になっている場合、Asset Manager Asset Rule では、アセットマネージャーに含めるまたは除外するフォルダを指定できます。これにより、どのアセットがアセットマネージャーに表示されるかを制御できます。

デフォルトの動作では、ソースのベースパス接頭辞におけるすべてのメディアおよびサブディレクトリがクロール対象となっています。

アセットデフォルト

あなたのソースには、エラーや欠落アセット時に代替表示される画像を設定できるように基本的な保護機能が備わっています。これにより、アセットに問題があっても空白として表示されることがなくなります。レンダリング API を使って画像を提供する場合、オリジナルリクエストのパラメータを既定またはエラー画像に適用できます。

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

1. Source Details ページで Edit をクリック。
2. 「Image Defaults」欄で該当フィールドをクリックし、画像の URL を入力。
   
3. オリジナル画像リクエストからのデフォルトを適用したい場合は、画像欄の下にあるチェックボックスをオン。
4. Review & Deploy ボタンをクリックして、変更設定を反映するためにソースを再デプロイ。

Default Image と Error Image の設定は異なる挙動を持ち、使用クォータに影響を及ぼす可能性があります。以下に続けて説明します。

デフォルトアセット

「Default Image」が設定されている場合、ソースの 404 が通常返す挙動を変更します。有効化されていると、通常 404 となるリクエストも、指定された画像とともに 200 レスポンスを返します。

これは、画像の有無に関わらず毎回 200 レスポンスとデフォルト画像を受信したい場合に有用です。

もし Default Image と Error Image の両方が構成されている場合、404 によって Error Image が想定される状況では Default Image が優先されます。

404 がエラー応答ではなくデフォルト画像を返すため、帯域幅の大きな使用となる可能性があるため、ファイルサイズが小さいデフォルト画像を使用することを推奨します。

エラーアセット

「Error Image」が有効化されている場合、通常エラー (4xx, 5xx など) を返すアセットに対して、指定された画像を返しつつ正しいエラーコードも継続されます。

Default Images と異なり、エラー応答は保持されます。エラー画像表示を引き起こすアセットは、404 を含めて、使用クォータにカウントされません。

ただし、Default Image が有効な場合、リクエストが 404 になると Error Image の設定は上書きされてしまい、レスポンスが 200 に変わってしまいます。この場合、月々の使用クォータに対してカウント対象になります。

注意： エラー画像を構成済みで、この設定を変更または削除する場合、変更が反映されるまで最大6時間かかることがあります。速くクリアしたい場合は support@imgix.com までご連絡ください。

パラメータのデフォルト

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

注意： キャッシュインフラとの関係上、 ch はデフォルトパラメータとして設定できません。

1. Source Details ページで Edit をクリック。
2. Image Defaults 下でドロップダウンメニューからパラメータを選択し、値を入力。必要に応じて複数のパラメータ／値ペアを追加します。
   
3. Review & Deploy ボタンをクリックして、ソースを新しい設定で再デプロイ。

デフォルトパラメータを設定すると、ソース内のすべての画像が Imgix のレンダリングサービスを通過するようになります。これは、パラメータなしでオリジナル品質／サイズの画像を配信するという既定機能を無効化する可能性があります。PDFを配信していたり、パラメータを省略して画像を提供している場合、デフォルトパラメータの適用はその既定の挙動に影響を与えます。

デフォルトパラメータ、上書き方法、および推奨利用法の詳細については、このブログ記事をご参照ください。

アセットキャッシュ設定

キャッシュ設定は、 Imgix が生成した派生画像と、エンドユーザーのブラウザキャッシュにどれだけ長くアセットを保持するかを決定します。オリジン画像が変わる可能性が低いため、少なくとも1年間の TTL（Time‑To‑Live）を設定することを推奨します。これにより、ユーザーのローカルキャッシュから配信されやすくなり、ページの読み込み速度が向上し、帯域幅コストも削減されます。

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

TTL に関してさらに知りたい場合は Wikipedia を参照してください。

Cache TTL Behavior ドロップダウンでは、オリジン画像の Cache‑Control: max-age ヘッダーに対して Imgix がどのように対応するかを設定できます。選択肢は以下の3つです：

• Respect origin (オリジンを尊重)：もしヘッダーが存在すればそれを尊重し、無ければ Default Cache TTL 値を適用。
• Override origin (オリジンを上書き)：ヘッダーが存在しても Override Cache TTL 値で上書き、無ければその値を適用。
• Enforce minimum (デフォルト) (最低値を強制)：ヘッダーが存在しない場合、Minimum Cache TTL 値で Cache‑Control: max-age ヘッダーを適用。既存ヘッダーの値が最低値よりも低ければ上書き。

アセットキャッシュの既定の挙動および値を設定できるほか、デフォルトエラー画像（設定している場合）の Cache‑Control: max-age ヘッダーも設定可能です。この値は、エラーが解消された後もエラー画像が表示され続けるのを防ぐため、短く設定すべきです。

TTL 値を設定する手順：

1. Source Details ページで Edit をクリック。
2. 「Cache Settings」欄で好みの Cache TTL Behavior をドロップダウンから選択。
   
3. TTL に変更したい時間値を入力し、単位をドロップダウンメニューから選択。
4. Review & Deploy ボタンをクリックして、キャッシュ設定を反映するためにソースを再デプロイ。

私たちは、ご指定の期間できる限りアセットおよび派生画像をキャッシュするよう努めます。ただし、可能な画像生成バリエーション数の多さゆえ、理想的にはすべての派生画像を永続的にキャッシュすることは不可能です。

時として、派生画像をキャッシュから削除し、必要に応じて再レンダリングすることがあります。その際、設定されたキャッシュ期限または30日間のうち最短の期間より前であっても再レンダリングされた派生画像については請求対象にはなりません。

また、アセットをストレージに追加する際には、すべてのアセットに対して Cache‑Control: max-age=86400 のヘッダーを設定することを推奨します。これにより、 Imgix が処理しないファイル（例：CSS）でのキャッシュミスが減るだけでなく、処理対象ファイルがオリジンから再取得されるのを防ぐことができます。既存ファイルを更新する必要がある場合、Amazon S3 用の s3cmd などのスクリプトを実行してヘッダーを設定できます。

キャッシュ戦略の全体像および Imgix との相互作用については、イメージのフィンガープリンティング・ガイド をご参照ください。

レンダリング設定

Render Settings セクションでは、レンダリング API を使用する際に、あなたのソースで有効にするレンダリング機能を制御します。

レンダリング機能が無効化されている場合、その機能に関連付けられたパラメータはレンダリング API 使用時に無視されます。

アセットセキュリティ

セキュア URL

セキュア URL は、承認されていないユーザーによる画像アクセスを保護する手段です。有効化すると、Imgix はトークンで画像 URL に署名し、一定期間後に有効期限が切れます。

セキュア URL を正しく動作させるには追加設定が必要です。詳細については セキュア化されたアセットのガイド をご参照ください。

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

あなたのウェブサイトやアプリが、ドメインを越えてアセットを正しく提供するためにクロスドメインポリシーファイルを必要とする場合、ダッシュボードの Security settings 下でチェックボックスをオンにできます：

有効化すると、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>  

robots.txt

robots.txt ファイルはあなたの imgix ドメインパス内、/robots.txt（例： yourimgixsubdomain.imgix.net/robots.txt）にあります。

このファイルは検索エンジンのクローラーがあなたのアセットにどのようにアクセスするかを制御します。可能な値は：

• Origin：ソースに設定されたパス接頭辞に基づき、オリジンの robots.txt ファイルをそのまま通過。
• Allow All（デフォルト）：すべてのアセットへのクローラーアクセスを許可。
• Disallow All：すべてのアセットへのアクセスをクローラーに対して禁止。

ただし、robots.txt ファイルは robots.txt の標準に従うクローラーにのみ使用されます。アクセス制限の手段としては機能しません。

robots.txt の変更は、変更後約5分で更新されます。

詳細はこの Google リソース をご参照ください。

ソースの無効化、再有効化、または削除

ソースを無効化、有効化、または削除するには、ソースビューの右上にある設定アイコンにカーソルを合わせます。現在のソースステータスに応じて、無効化／有効化／削除のオプションが表示されます。

無効化または削除されたソースであっても、アセット TTL が切れるまで、もしくはそれらがパージされるまで、キャッシュからアセットを提供し続けます。