Advanced Settings

Source Details ページでは、現在のソースのステータスおよび追加で設定可能な項目を確認できます。Status フィールドは、ソース作成後数秒以内に「Queued」から「Deployed」に変更されます。これが完了すると、ソースは使用可能になります。

このページの設定を変更する場合は、Edit ボタンをクリックし、変更したい項目を編集してから Review and Deploy をクリックしてソース構成を更新してください。ほとんどの項目は直感的に理解できますが、(?) アイコンにカーソルを合わせると詳細が表示されます。

Screenshot-Editing Source Configuration

ソースの変更は、新しくレンダリングされる画像にのみ適用されます。すでにキャッシュされているアセットは、キャッシュ時にデプロイされていたソース設定で引き続き配信されます。

現在の画像に新しいソース設定を適用するには、purging functionality を使用するか、contact support してソース全体をパージしてください。


Changing Source Type

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

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

Domains

Imgix Image Subdomains

Imgix で使用するサブドメインを指定します。サブドメインは .imgix.net の前に付く URL の最初の部分です。たとえば example を設定した場合、ベース URL は https://example.imgix.net になります。

Custom Domains

Video Domains Not Supported

Currently, custom domains are supported only for the Rendering API (*.imgix.net domains).

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

  1. Source Details ページで Edit をクリックします。
  2. 「Domains」セクションで Custom Domain をクリックします(モバイルでは Add Domain をクリック)。
  3. 使用したいカスタムサブドメインを入力し、Review & Deploy をクリックします。
  4. DNS レジストラで CNAME を *.imgix.net に向けるよう設定します(* は Imgix で使用しているソースのサブドメイン)。
  5. DNS の変更が反映されるまで待ちます(最大 24 時間)。

標準の Imgix ホスト名(例:subdomain.imgix.net)は、自動的に SSL/TLS に対応しています。

Note: カスタムサブドメインはデフォルトでは HTTP のみ使用可能です。HTTPS を利用するには、CDN パートナー経由で SSL 証明書の設定が必要です。詳細は the SSL documentation を参照してください。


Asset Manager Processing Rule

Asset Manager のクロールが有効な場合、Asset Manager Asset Rule で含める/除外するフォルダを指定できます。これにより、Asset Manager に表示されるアセットを制御できます。

デフォルトでは、ソースのベースパス配下にあるすべてのメディアおよびサブディレクトリをクロールします。


Asset Defaults

ソースでは、欠損アセットやエラー発生時に表示する画像を設定できます。これにより、問題があっても画像が空白で表示されることを防げます。

Default Asset

Default Image を設定すると、通常 404 になるリクエストが 200 レスポンスとともに指定画像を返すようになります。

これは、画像が存在するかどうかに関わらず、常に 200 レスポンスとデフォルト画像を受け取りたい場合に便利です。

Default ImageError Image の両方が設定されている場合、404 が発生した際には Default Image が優先されます。

Credit Consumption Warning

Default Image を使用すると、欠損アセットへのリクエストも 200 として処理されるため、クレジット消費の対象になります。

Error Assets は使用量クォータにカウントされません。

404 がエラーではなくデフォルト画像を返すため、帯域幅の無駄を防ぐためにもファイルサイズの小さい画像を使用することを推奨します。

Error Asset

Error Image を設定すると、4xx5xx など適切なエラーコードを維持したまま、指定画像を返します。

Default Image と異なり、エラーレスポンスは保持されます。エラー画像が表示されたアセットは、404 を含めクォータ消費にカウントされません。

Default Image が有効な場合、404 発生時には Error Image よりも優先され、200 に変換されます。その場合は使用量にカウントされます。

Note: エラー画像の変更または削除は、反映まで最大 6 時間かかる場合があります。急ぎの場合は support@imgix.com までご連絡ください。


Parameter Defaults

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

Note: ch はキャッシュの仕組み上、デフォルトパラメータとして設定できません。

デフォルトパラメータを設定すると、ソース内のすべての画像が Imgix のレンダリングサービスを経由します。これにより、serving images as pass-throughs のデフォルト動作は無効になります。


Asset Cache Settings

キャッシュ設定は、Imgix によって生成されたアセットおよび派生画像がエンドユーザーのブラウザキャッシュにどのくらい保持されるかを決定します。

最大値は 1 年、最小値は 30 分です。

Cache TTL Behavior

  • Respect origin
  • Override origin
  • Enforce minimum(デフォルト)

デフォルトの Enforce Minimum: 5184000 seconds(60日) は、多くのユースケースで推奨されています。

Imgix は可能な限り指定された期間キャッシュを保持しますが、生成可能な画像バリエーションが非常に多いため、すべてを永久に保持することはできません。

キャッシュから削除され再レンダリングされた派生画像については、元のキャッシュ期限または 30 日のいずれか短い期間より前に再生成された場合、課金対象にはなりません。


Render Settings

Render Settings セクションでは、Rendering API を使用する際に有効化されるレンダリング機能を制御します。

特定のレンダリング機能を無効にすると、それに関連するパラメータは Rendering API で使用しても無視されます。


Asset Security

Secure URLs

Secure URLs を有効にすると、期限付きトークンで画像 URL を署名できます。不正アクセスから画像を保護するための機能です。

詳細は Securing Assets を参照してください。

Cross-Domain Policy File

有効にすると、以下のファイルが配信されます。

    <?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
  • Allow All(デフォルト)
  • Disallow All

変更は約 5 分で反映されます。


Disabling, Enabling, or Deleting a Source

ソースは一時的に無効化することも、再度有効化することもできます。不要になった場合は完全に削除できます。

Disabling a Source

ソースを無効化すると、即座にアセットの配信が停止されます。特定アセットパスへのリクエストは、再度有効化されるまでエラーを返します。

Enabling a Source

無効化されたソースを再度有効化すると、割り当てられた Imgix ドメインでの配信が再開されます。

Deleting a Source

ソースを削除すると、アカウントから完全に削除されます。一度削除すると構成は復元できず、関連する Imgix ドメインはアセットを配信しなくなります。

Disabled/Deleted Source Interactions

無効化または削除されたソースでも、アセットの TTL が期限切れになるまで、またはパージされるまでキャッシュから配信される場合があります。

ソースを無効化しても、オリジンのデータは削除されません。

ソースを削除しても、オリジンストレージ上のデータは削除されません。


Root Imgix URLs

Root Imgix URL(例: https://your-source.imgix.net/)は、ソースが有効か無効かに関わらず常に応答します。

ただし、ソースが無効な場合、特定のアセットパス(例: https://your-source.imgix.net/image.jpg)へのリクエストはエラー応答を返します。

  • ベースドメインは常に応答します。
  • アセット配信はソースのアクティブ状態によって制御されます。
  • ソースを再度有効化すれば、ドメインを変更せずに通常配信が復元されます。

配信トラブルを調査する場合は、まず Imgix ダッシュボードでソースが有効になっているか確認してください。