効率的な画像ホスティング:CDN と画像処理
静的配信と画像変換は、それぞれ異なる問題を解決します。静的 CDN は既存のファイルをキャッシュしますが、?width=800 を付けるだけで JPEG をリサイズするわけではありません。ここでは、信頼できるローカルの写真からバージョン付きファイルを生成し、一度だけ画像をフォールバックするレスポンシブプレビューを開きます。その後、同じファイルを画像ホスティング CDN に公開できます。
静的ファイルと動的変換の選択
事前生成すると、新しい画像 URL がリクエストされたときのデコード処理を省けます。一度もリクエストされない可能性があるバリアントも含め、所定のファイル群を保存して公開します。バージョン付き URL は、寸法と形式が固定された単一のファイルを識別するため、生成の失敗と配信の失敗を切り分けやすくなります。
事前生成したバリアントと変換サービスは、要件に応じて選んでください。任意のサイズへのリサイズが必要な場合は、画像処理を行うオリジンや、Transloadit の Smart CDN などのサービスを使用します。そのサービスのパラメーターと署名の仕様を確認してください。静的な S3/CloudFront オブジェクトは、変換用のクエリパラメーターを解釈しません。
Cloudinary
ホスト型の変換サービスでは、URL の構文と許可されるソースの場所が独自に定義されています。Cloudinary の変換リファレンス、または利用するプロバイダーの同等のドキュメントに従ってください。あるプロバイダーの URL を、別の CDN で汎用的なリサイズ仕様として使うことはできません。
画像処理用のツールとライブラリー
Sharp(Node.js)
保守されている Node.js 26 リリースと、別途インストールした Corepack を使用してください。この例は Node.js 26.12.1 および 26.13.0 と Yarn 4.12.0 でテストしました。Sharp 0.35.4 は再現性のために固定したバージョンであり、最新のパッチであるという意味ではありません。対応プラットフォームとオプションのネイティブパッケージについては、Sharp のインストール要件を参照してください。
書き込み可能なディレクトリで、次の Bash ブロックを実行してください。独立した Yarn プロジェクトが作成され、シェルの作業ディレクトリは元のまま維持されます。空のロックファイルにより、既存のワークスペース内でもプロジェクトの境界が確立されます。ただし、適用対象となる親ディレクトリの設定は引き続き Yarn に読み込まれます。
(
command -v node >/dev/null &&
command -v corepack >/dev/null &&
mkdir image-publish &&
cd image-publish &&
printf '%s\n' '{"private":true,"packageManager":"yarn@4.12.0"}' > package.json &&
touch yarn.lock &&
corepack yarn add --exact sharp@0.35.4
)
image-publish がすでに存在する場合は、中身を削除せず、別の新しいディレクトリ名を選んでください。作成後にインストールが失敗した場合は、そのディレクトリを調べ、次のセットアップでは新しい名前を選びます。インストールが成功したら、image-publish でターミナルを開いてください。スクリプトには corepack yarn node を使用します。これにより、Yarn のデフォルトの Plug’n’Play インストールと
node-modules リンカーの両方で動作します。
photo.jpg を用意してください。ファイル名は固定ですが、内容は JPEG または PNG にできます。アルファチャンネルのない、信頼できる 8 ビット sRGB 画像を使用してください。入力は空であってはならず、サイズは 8 MiB 以下、画素数は 12,000,000 以下、EXIF の向き補正後の幅は 1280 ピクセル以上である必要があります。デコード後の形式、色空間、サンプル深度がこれ以外の場合は拒否します。これは順次実行する公開用の処理であり、アップロードエンドポイントでも、悪意のあるファイル向けの汎用バリデーターでもありません。JPEG と PNG のコンテナーは主画像の静止画として読み取ります。MPO の付随画像、APNG アニメーション、HDR ゲインマップの処理を確認するものではありません。
次の内容を build-images.mts として保存してください。
import { mkdir, open, writeFile } from 'node:fs/promises'
import sharp, { type SharpOptions } from 'sharp'
async function main() {
const file = await open('photo.jpg', 'r')
let source
try {
const stat = await file.stat()
if (!stat.isFile() || stat.size < 1 || stat.size > 8 * 1024 * 1024) {
throw new Error('Use a regular source image no larger than 8 MiB.')
}
source = Buffer.alloc(stat.size)
let offset = 0
while (offset < source.length) {
const { bytesRead } = await file.read(source, offset, source.length - offset, null)
if (bytesRead === 0) throw new Error('Source changed during publishing.')
offset += bytesRead
}
} finally {
await file.close()
}
const options: SharpOptions = { limitInputPixels: 12_000_000, failOn: 'warning' }
const metadata = await sharp(source, options).metadata()
if (!['jpeg', 'png'].includes(metadata.format) || (metadata.pages ?? 1) !== 1) {
throw new Error('Use a JPEG or PNG primary image.')
}
if (metadata.space !== 'srgb' || metadata.depth !== 'uchar' || metadata.hasAlpha) {
throw new Error('Use an 8-bit sRGB image without an alpha channel.')
}
const orientedWidth = metadata.autoOrient?.width ?? metadata.width
if (!orientedWidth || orientedWidth < 1280) throw new Error('Source must be at least 1280px wide.')
await mkdir('images', { recursive: true })
for (const width of [320, 640, 1280]) {
const result = await sharp(source, options).rotate().resize({ width }).webp({ quality: 80 })
.toBuffer({ resolveWithObject: true })
await writeFile('images/photo-' + width + '-v1.webp', result.data, { flag: 'wx' })
}
const fallback = await sharp(source, options).rotate().resize({ width: 640 })
.jpeg({ quality: 80 }).toBuffer({ resolveWithObject: true })
await writeFile('images/photo-640-v1.jpg', fallback.data, { flag: 'wx' })
console.log(JSON.stringify({ width: fallback.info.width, height: fallback.info.height }))
}
main().catch((error: unknown) => {
console.error(error instanceof Error ? error.message : 'Image publishing failed.')
process.exitCode = 1
})
そのディレクトリで、保存したプログラムを実行してください。
corepack yarn node build-images.mts
幅だけを指定した 320、640、1280 ピクセルの三つの WebP バリアントと、640 ピクセル幅の JPEG フォールバックを書き出します。いずれも向き補正後のアスペクト比を維持します。最後の JSON 行には、JPEG の実際の幅と高さが出力されます。何かをアップロードする前に、ローカルのプレビューを開いて画像を確認してください。品質値 80 はエンコーダーの設定であり、特定のファイルサイズや知覚品質を保証するものではありません。
実行中は入力を変更しないでください。排他的な書き込みにより、JPEG フォールバックを含め、既存の出力ファイル名への書き込みは拒否されます。失敗すると、不完全な出力が残る場合があります。内容を確認し、新しいバージョンで再試行してください。新しいバージョンを公開するときは、すべての出力名と HTML 内の参照にある
v1 をまとめて変更してください。すでに書き込んだファイルは、この処理ではロールバックされません。
Sharp の自動向き補正は、リサイズ前に EXIF の向きを適用します。デフォルトの出力動作では、元のメタデータを削除します。表示された色と向きは、自分で確認してください。これらの制限を満たしても、破損した元画像の完全性を証明することにはなりません。
ImageMagick
JPEG と WebP に対応した ImageMagick 7 がすでにある場合は、次の Bash コマンドで、同じ確認済みのソースから小さな WebP を一つ作成できます。ImageMagick 7.1.2-32 でテストしました。保守されている更新版は ImageMagick のダウンロードページから入手してください。
(
set -o noclobber
magick photo.jpg -auto-orient -resize '640x640>' -strip -quality 80 webp:- > photo-small.webp
)
引用符で囲んだリサイズジオメトリーは、拡大せずに 640 × 640 以内に収めます。1280 × 720 の画像は 640 × 360 になり、320 × 180 の画像はそのままのサイズになります。これは Sharp スクリプトの幅だけを指定するバリアントとは異なり、プレビューに必要な一式をすべて作成するものではありません。シェルは、変換開始前に既存の photo-small.webp への書き込みを拒否します。変換に失敗すると、空または不完全な新規ファイルが残る場合があります。確認してから、新しい名前で再試行してください。このコマンドには、Sharp スクリプトにある入力の保護機能はありません。ここでは、確認済みの 8 ビット sRGB ソースだけを使用してください。信頼できないファイルには、プロセスの分離とデコーダー/リソースのポリシーが必要です。
事前生成したレスポンシブ画像のプレビュー
このページ全体を、生成した images/ ディレクトリと同じ階層に
index.html として保存してください。直後のエラー処理ブロックを fallback.js として保存し、ブラウザーで index.html を開きます。相対パスは、ローカルディレクトリから直接使用できます。
<!doctype html>
<html lang="en">
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>Responsive image preview</title>
<body style="margin: 0">
<picture>
<source
type="image/webp"
data-srcset="images/photo-320-v1.webp 320w, images/photo-640-v1.webp 640w, images/photo-1280-v1.webp 1280w"
sizes="(max-width: 640px) 100vw, 640px"
>
<img
id="hero"
data-src="images/photo-640-v1.jpg"
data-fallback="images/placeholder.png"
alt="A description of your photograph"
width="640"
height="360"
style="display: block; width: 100%; max-width: 640px; height: auto"
>
</picture>
<script src="fallback.js"></script>
</body>
</html>
width と height には、スクリプトが出力した JPEG フォールバックの実際の寸法を設定してください。640 × 360 は 16:9 のソースに適した値です。アスペクト比が異なる場合は、高さも変更する必要があります。代替テキストは、使用する画像の説明に置き換えてください。sizes の値は、640 CSS ピクセルで幅の拡大が止まるこのページのレイアウトに合わせています。ブラウザーは、ビューポートとピクセル密度に応じて WebP の候補を選択できます。WebP が選択されない場合は、JPEG がデフォルトになります。
data-src 属性と data-srcset 属性は、fallback.js がハンドラーを登録するまでリクエストを遅らせます。このプレビューには JavaScript が必要です。images/placeholder.png として実際の PNG を用意するか、確認済みの PNG のコピーを使用してください。復旧を試すには、選択された WebP ファイルの名前を一時的に変更して、ページを再読み込みします。その後、元に戻してください。プレースホルダーが見つからない場合は、再試行を繰り返すことなく画像の代替テキストが残るはずです。
画像読み込みエラーの処理
次の内容を、index.html と同じ階層に
fallback.js として保存してください。プレビューの URL を有効にする前にハンドラーを登録します。レスポンシブ画像の候補を削除することで、プレースホルダーを選択対象にします。
function installImageFallback(image, fallbackUrl) {
image.addEventListener('error', () => {
for (const source of image.closest('picture')?.querySelectorAll('source') ?? []) {
source.remove()
}
image.removeAttribute('srcset')
image.removeAttribute('sizes')
image.src = fallbackUrl
}, { once: true })
}
const hero = document.getElementById('hero')
if (hero instanceof HTMLImageElement) {
installImageFallback(hero, hero.dataset.fallback ?? '/images/placeholder.png')
for (const source of hero.closest('picture')?.querySelectorAll('source') ?? []) {
if (source.dataset.srcset) source.srcset = source.dataset.srcset
}
if (hero.dataset.src) hero.src = hero.dataset.src
}
ハンドラーは画像要素ごとに一度だけ実行されます。プレースホルダーも読み込みに失敗した場合、ブラウザーはアクセシブルな代替テキストを維持し、それ以上フォールバック先を設定しません。既存のアプリケーションでは、画像 URL を設定する前にハンドラーを登録してください。これにより、登録前に即座に読み込みが失敗する事態を防ぎます。
バージョン付きファイルの CDN への公開
images/ に生成した WebP ファイルと JPEG フォールバックを、プレースホルダーとともに、承認済みの公開コンテンツ用プレフィックスへアップロードしてください。相対パスを維持するか、プレビュー内のすべての画像 URL を CDN の URL に置き換えます。各ファイルに対応するコンテンツタイプとして、image/webp、image/jpeg、image/png を設定してください。非公開の元画像をこのプレフィックスにアップロードしないでください。
不変のバージョン付きオブジェクトには、長いキャッシュ有効期間を使用します。意図に沿って cache-control メタデータを設定し、CDN のレスポンスヘッダーを確認してください。オリジンのメタデータを変更しても、キャッシュ済みのレスポンスは即座には置き換わりません。
このローカルの例にクラウドアカウントは不要です。インフラストラクチャーのプロビジョニングについては、別途 S3 と CloudFront のセットアップガイドを参照してください。補足資料であり、プレビューの前提条件ではありません。
そのデプロイでは、最新の AWS の非公開オリジン要件を確認してください。OAC はウェブサイトエンドポイントではなく、通常の S3 バケットオリジンを使用します。バケット所有者強制の所有権設定、常に署名する OAC リクエスト、ディストリビューションに範囲を限定したバケットポリシーを設定すると、CloudFront は非公開オリジンを読み取れます。SSE-KMS で暗号化されたオブジェクトには、適切な KMS キーポリシーも必要です。閲覧者向け HTTPS と閲覧者の認可は別の設定です。OAC は、公開 CDN URL への訪問者を認証しません。
CDN 利用時のセキュリティ上の考慮事項
非公開オリジンと非公開配信は、別々の制御です。閲覧者のアクセスを非公開にするには、CloudFront の署名付き URLと、対応する信頼されたキーグループを設定してください。S3 の署名付き URL が CloudFront にも自動的に署名するわけではありません。
署名キーはサーバー側に保持し、アクセスを許可する前に、リクエストされたオブジェクトへの認可を行ってください。署名付きクエリ文字列のログ記録は避けます。非公開レスポンスを、共有の公開キャッシュポリシーで公開しないでください。
CDN 画像ホスティングでよくある問題の対処
キャッシュの無効化
新しい画像には、新しい不変のファイル名を使用することを推奨します。無効化が必要な場合は、対象のディストリビューションとパスだけに限定してください。無効化はアカウントに対する実際の操作であり、費用が発生する場合があります。汎用的なデバッグコマンドとして本番環境に対して実行しないでください。
パフォーマンス監視
ブラウザーのネットワークパネルで、選択された画像のリクエスト、レスポンスサイズ、キャッシュヘッダーを確認してください。代表的なデバイスと、コールドキャッシュ、ウォームキャッシュの両方でテストします。ローカルプレビューで確認できるのは、ファイルの選択と復旧です。デプロイ済み CDN のレイテンシーを測定したり、帯域幅の節約を証明したりするものではありません。
