画像だけを、別のドメインから配信する
R2やS3の公開URLを使う構成で、保存先と読者が開くURL、公開範囲を確認します。
目次
画像をR2やS3互換の保存先で管理するEmDashでは、画像の表示用URLを別に指定できます。たとえば、記事はexample.com、写真はmedia.example.comから配信する構成です。
R2はCloudflareのファイル保存サービスです。S3互換は、Amazon S3と同じ方式でファイルをやり取りできる保存サービスを指します。表示用のドメインを変えても、画像ファイルの保存場所は変わりません。保存場所も変えたい場合は、ファイルを別にコピーします。
作業するのは、画像の保存先とドメイン設定を管理する担当者です。画像を管理画面から登録できるだけでは、この設定を変更できるとは限りません。先に、現在の保存先と、使いたい画像用ドメインを確認します。ドメインの準備は独自ドメインのガイドでも説明しています。
3つの場所を分けて考える
| 役割 | 説明用の例 |
|---|---|
| 記事の住所 | https://example.com/blog/coffee/(別タブで開く) |
| ファイルの保存先 | R2の画像用バケット |
| 読者が画像を開く住所 | https://media.example.com/uploads/coffee.jpg(別タブで開く) |
バケットは、クラウド上でファイルをまとめて保存する場所です。保存キーは、その中でファイルを区別する名前です。表の例ではuploads/coffee.jpgに当たります。実際の名前は登録したファイルで確認し、この例をそのまま使う必要はありません。サイトのドメインを変えずに、画像の表示URLだけを分けられます。
設定する前に、公開してよいファイルを確認する
画像用のバケットに、バックアップや非公開資料も入っていないかを確認します。バケットへ公開ドメインをつなぐと、管理画面の権限とは別の入口からファイルへアクセスできる構成になります。
EmDashのJSONバックアップが同じ保存先のbackups/以下にある場合、そのまま公開するとバックアップまで見えるおそれがあります。公開用の保存先を分けるか、公開経路を画像に限定する設計を先に行います。公式の保存先ガイド(別タブで開く)にも、この条件が記載されています。
公開ドメインと、EmDashの設定を揃える
作業場所は2つあります。まずCloudflare側で、対象のR2バケットに独自ドメインを接続し、HTTPSで画像ファイルが開ける状態を作ります。詳しい接続操作は公式の公開用ドメインの説明(別タブで開く)から進めます。
次にコードエディターで、プロジェクトのastro.config.mjsにあるEmDashの保存先設定を開きます。R2とつなぐ部品(アダプター)のpublicUrlへ、画像用の住所を設定します。管理画面の「サイトのURL」を変更する作業とは違います。
storage: r2({
binding: 'MEDIA',
publicUrl: 'https://media.example.com',
}),これは設定項目の抜粋です。r2の読み込みや既存のEmDash設定を含むファイル全体ではありません。bindingは、プログラムからどのR2バケットを使うか指定する接続設定です。MEDIAはその接続名なので、自分のサイトの設定に合わせます。
Node.jsのS3構成にもpublicUrlがありますが、使う設定と認証方法はR2 binding構成と同じではありません。公開用URLの変更だけなら、ファイルの保存先まで同時に切り替えないほうが、原因を分けて確認できます。
管理画面のURLが元のままでも、異常とは限らない
publicUrlを指定すると、対応する表示部品やサイト設定の画像URLに使われます。一方、管理画面、REST API、本文に保存されたURLには、EmDashのメディア取得用の経路が残ります。
publicUrlを変えても、保存済みの本文にあるURLは一括で置き換わりません。独自のHTMLに画像URLを直接書いている場合は、その表示方法も確認します。管理画面で見たURLだけで、新しい配信先が使われていないと判断しないでください。
既存画像と、新しく登録した画像を両方見る
まず確認用サイトで、前からある写真と、新しい写真を1枚ずつ表示します。読者向けページで画像を新しいタブに開き、住所と見た目を確かめます。
ロゴ、共有用の画像、本文画像、PDFなど、使っている種類も確認します。画像の差し替え後に古い表示が残る場合は、配信側のキャッシュも調べます。
Cloudflareのr2.devは開発向けです。本番での配信には、用途に合う独自ドメインを準備してください。
保存先も移すときは、別の移行として計画する
新しいバケットへ切り替えるなら、元ファイル、保存キー、参照情報を揃えて移す必要があります。URL設定だけ変えてもファイルは移りません。旧画像が読めることを確認するまで、元の保存先を残してください。
新しいドメインで画像を直接開けるのにページ内では出ない場合は、表示側の設定を調べます。直接開いても見えなければ、ドメインの接続・公開範囲・ファイルの場所から確かめます。
表示の問題は画像が表示されないときで、登録・保存先・配信のどこで止まっているかを切り分けられます。