ファイルを置く
見せる:配信と公開範囲
倉庫は閉じたまま、受付が渡す
R2に入れた画像は、そのままでは誰にも見えません。
倉庫は、鍵がかかっているのが初期状態です。
この章で外に出します。
ただし出し方が3つあって、選び方を間違えると事故になります。
この章でできるようになること
- 3つの公開方法の違いと、選び方が分かる
- Workerを通して画像を配れるようにする
- 「全部見せる」と「選んで見せる」を自分で決められる
公開の方法は3つあります
- 倉庫は閉じたまま
- Workerが取り出して渡す
- 見せる相手を選べる
- 枚数制限などもかけられる
- この教科書はこれ
- 1クリックで全部公開
- お手軽だが速度制限あり
- キャッシュも使えない
- 本番では使わない
- img.example.com など
- キャッシュが使える
- 守りの機能も使える
- ドメインが必要
- 大量配信ならこれ
2つめの r2.dev について、はっきり書いておきます。
公式ドキュメントには、こう明記されています。
「r2.devサブドメイン経由の公開アクセスには速度制限があり、開発目的にだけ使ってください」。
管理画面のボタン1つで有効にできるので、つい本番で使いたくなりますが、そこは我慢する所です。
Worker経由で配る、という考え方
倉庫の鍵は閉めたままにして、受付(Worker)に取りに行かせます。
- 1見る人/file/ のあとにキーを付けたURLを開く
- 2受付(Worker)見せてよいかを判断して、取りに行く
- 3倉庫(R2)鍵は閉めたまま
この形の良いところは、受付で判断を挟めることです。
「この画像は非公開だから断る」「この人には見せる」といった制御が、あとからいくらでも足せます。
倉庫を開けっぱなしにすると、この判断ができません。
R2に保存した画像を、Worker経由で表示できるようにしてください。 ・/file/ のあとにキーを付けたURLで、その画像が表示されるようにする ・保存したときのContent-Typeをそのまま使って返す ・存在しないキーのときは、日本語のメッセージで404を返す ・R2バケットは公開設定にしないでください。Worker経由だけで配ります 作ったあと、動作確認用のURLを教えてください。
中心はこの部分です。
const object = await env.BUCKET.get(key);
if (!object) return new Response("見つかりません", { status: 404 });
const headers = new Headers();
object.writeHttpMetadata(headers); // 保存時の種類の札を貼り直す
return new Response(object.body, { headers });
writeHttpMetadata の行が大事です。
第8章で一緒に保存した種類の札を、返すときに貼り直しています。
これがないと、ブラウザは「何だか分からないファイル」として扱い、画像を表示せずにダウンロードを始めます。
404(ヨンマルヨン)
「そんなものはありません」という返事です。
エラーではなく、正しい返事の一種。
存在しないキーを頼まれたときに、黙って何も返さないのではなく、はっきり404と答えるのが行儀のよい作りです。
「全部見せる」か「選んで見せる」か
ここは、あとで揉めやすいところなので先に決めておきます。
いまの作りは、キーを知っている人は誰でも見られます。
キーはでたらめな文字列なので、当てずっぽうで探し当てるのは現実的ではありません。
ただ、URLを人に転送されたら、その人は見られます。
- 作品ギャラリー
- 公開したい写真
- 限定公開の資料
- 個人の写真
いまはキーを知っていれば誰でも画像を見られる状態です。これを、決められた人だけが見られる形に変えたいです。 初心者でも運用できる方法を、簡単な順に2つか3つ提案してください。それぞれの長所と短所も日本語で説明してください。まだ実装はしないでください。
まず提案だけ聞いて、必要になってから実装する。
この頼み方は、他の場面でも使えます。


うまくいったか確認する
/file/images/〜のURLをブラウザで開くと、画像が表示される(ダウンロードが始まらない)- 存在しないキーを指定すると、404のメッセージが出る
- スマホでも同じURLで画像が見える
- R2の管理画面で、バケットが公開設定になっていない(閉じたままである)
よくあるつまずき
- 画像が表示されず、ダウンロードが始まる
種類の札(Content-Type)が付いていません。
保存時に付け忘れたか、返すときに貼り直していないかのどちらかです。
「Content-Typeが返せていないので直してください」と伝えてください。
- いつも404になる
キーが1文字でも違うと見つかりません。
images/abc.pngとimage/abc.pngは別物です。一覧を出してもらって、実際のキーと見比べてください。
- 日本語のファイル名で保存したら開けない
- URLの中で日本語は変換され、扱いにくくなります。
キーは英数字で作るのが安全です。 - r2.devで公開したら、たまに表示されない
公式が明記している速度制限に当たっています。
本番で使う想定の窓口ではありません。Worker経由か独自ドメインに切り替えてください。
この章のまとめ
倉庫は閉じたまま、受付が取り出して渡す形にしました。
種類の札を貼り直すことで、ブラウザがちゃんと画像として表示してくれます。
そして、公開範囲は自分で決められる状態。
次の章では、増えていくファイルを整理します。
消す、並べる、情報を持たせる。
地味ですが、ここができると急に実用的になります。
章末チェックリスト
配信できました。次の第10章で、ファイルを整理します。