cURL と ImageMagick によるリモート画像の合成
cURL で背景とオーバーレイをダウンロードし、ImageMagick でリサイズして、ひとつの JPEG として保存します。以下の Bash スクリプトは両方の HTTPS 転送を確認し、ダウンロードまたは画像処理が失敗した場合は、不完全なファイルを削除します。
ツールの確認
この処理構成は、Linux 上の Bash 5.3.15、cURL 8.22.0、および JPEG と PNG に対応した
ImageMagick 7.1.2-31 でテスト済みです。これらは検証したバージョンであり、必須のパッチリリースではありません。メンテナンスされているビルドの
cURL と ImageMagick 7 を使用してください。cURL のビルドは 8.4 以上が必要です。それ以前のバージョンでは、レスポンスサイズが不明な場合に
--max-filesize を適用できません。
スクリプトを保存する前に、bash --version、curl --disable --version、magick -version を確認してください。単一フレームの RGB 画像を使用し、背景は不透明にしてください。PNG オーバーレイは透過を含められます。この例では、NASA の JPEG 写真と PNG ロゴを使用します。NASA の画像とメディアの使用ガイドラインに従い、記章や推奨・支持の表明に関する制限も守ってください。
合成スクリプトの保存
各ソースは、新しく作成した非公開ディレクトリにダウンロードされます。<(curl ...) を ImageMagick に直接渡すと、背景の転送の終了ステータスを確認しにくくなります。実際の入力を保存して確認することで、あるリクエストで URL をテストした後、別の未確認のレスポンスを処理することも避けられます。
以下を compose.sh として保存してください。引数には、信頼できる HTTPS URL をふたつと、親ディレクトリがすでに存在する新規の出力ディレクトリを指定します。
#!/bin/bash
set -euo pipefail
if [ "$#" -ne 3 ]; then
echo "Usage: $0 <background-https-url> <overlay-https-url> <new-output-directory>" >&2
exit 1
fi
background_url=$1
overlay_url=$2
output_dir=$3
if ! command -v curl >/dev/null || ! command -v magick >/dev/null; then
echo "Install cURL and ImageMagick 7 before running this script" >&2
exit 1
fi
[[ $output_dir = /* ]] || output_dir=$PWD/$output_dir
if ! mkdir -m 700 -- "$output_dir"; then
echo "Use a new output directory" >&2
exit 1
fi
cleanup() {
local status=$?
rm -f -- "$output_dir/background.image" "$output_dir/overlay.image" "$output_dir/magick.log"
if [ "$status" -ne 0 ]; then
rm -f -- "$output_dir/result.jpg"
rmdir -- "$output_dir"
fi
}
trap cleanup EXIT
fetch_image() {
curl --disable --globoff --fail --silent --show-error --location \
--proto '=https' --proto-redir '=https' --max-redirs 3 \
--connect-timeout 10 --max-time 30 --retry 2 --retry-max-time 60 \
--max-filesize 10485760 --output "$2" --url "$1"
}
fetch_image "$background_url" "$output_dir/background.image"
fetch_image "$overlay_url" "$output_dir/overlay.image"
cd -P -- "$output_dir"
output_dir=$PWD
if ! magick -limit memory 256MiB -limit map 512MiB -limit disk 1GiB \
-limit width 10000 -limit height 10000 \
background.image -resize '1600x1600>' \
\( overlay.image -resize '300x300>' \) \
-gravity southeast -geometry +20+20 -composite result.jpg 2>magick.log ||
[ -s magick.log ]; then
cat magick.log >&2
echo "ImageMagick reported a failure or diagnostic" >&2
exit 1
fi
[ -s result.jpg ] || { echo "No image produced" >&2; exit 1; }
echo "Composite saved: $output_dir/result.jpg"
サンプルの実行
compose.sh があるディレクトリから、保存したスクリプトを実行してください。
bash compose.sh \
'https://images-assets.nasa.gov/image/as11-40-5874/as11-40-5874~orig.jpg' \
'https://www.nasa.gov/wp-content/uploads/2023/04/nasa-logo-web-rgb.png' \
nasa-composite
nasa-composite/result.jpg を開いてください。月面着陸の写真の右下隅に
NASA ロゴが表示されるはずです。ロゴの白い長方形は、ソース PNG に含まれています。
背景は 1600 × 1600 ピクセル以内、オーバーレイは 300 × 300 ピクセル以内に、アスペクト比を維持して収まります。各リサイズ指定にある、引用符で囲まれた > は拡大を防ぎます。-gravity southeast -geometry +20+20 は、オーバーレイのキャンバスを右端と下端から
20 ピクセル離して配置します。より小さい画像に差し替える場合は、オーバーレイと両方の余白に十分な領域を確保してください。スクリプトは、大きすぎるオーバーレイを背景に合わせて縮小しません。
処理が成功すると、Composite saved: に続けて絶対パスが出力され、新しいディレクトリには result.jpg だけが残ります。同じディレクトリを指定して再実行すると、ダウンロードを開始する前に失敗し、前回の結果は保持されます。スクリプトの実行中は、ほかのプロセスが処理用ディレクトリにアクセスしないようにしてください。
失敗と再試行への対処
HTTP エラー、ソースごとに 10 MiB を超える転送、デコードできない画像があると、終了ステータスが非ゼロになり、新しい処理用ディレクトリが削除されます。URL または入力を修正し、同じディレクトリ名で再試行してください。ディレクトリがすでに存在する場合や親ディレクトリがない場合は、初期設定の失敗となり、スクリプトは既存のストレージを変更しません。
中断された転送では、一時的に上限を超えて書き込まれる場合があります。その一時ファイルはクリーンアップで削除されます。
ImageMagick は、破損した JPEG からピクセルを復元し、警告を報告しながらも成功を返す場合があります。このスクリプトでは、stderr に診断メッセージが出力された場合も処理を失敗とし、診断メッセージを表示してクリーンアップを実行します。意図的にエラーだけでなく警告も拒否します。デコーダーが何も報告せずに受け入れる破損は検出できないため、公開前に完成した画像を確認してください。
ダウンロード用ヘルパーは、HTTPS リダイレクトを三回、cURL が再試行可能とする失敗の再試行を二回まで許可します。各試行のタイムアウトは 30 秒です。60 秒の再試行期間は、次の試行を開始するかどうかを制御します。すでに実行中の試行は、その期間を過ぎてから終了する場合があります。
信頼できる入力への上限設定
圧縮された小さなファイルでも、デコードすると大きな画像になる場合があります。スクリプトは入力画像の寸法と ImageMagick のピクセルキャッシュのリソースに上限を設けます。ピクセルキャッシュはディスクに退避される場合があります。これらの設定は、プロセスの総メモリ使用量や処理時間を制限するものではありません。本番環境のワーカーでは、ImageMagick のセキュリティポリシーと OS の制限を使用してください。
リクエストを HTTPS のみに制限しても、プライベートネットワーク内のサービスへの URL やリダイレクトは許可されます。信頼できるソースを使用してください。任意の URL を取得する公開機能には、ネットワークと取得元に対する別途の制御が必要です。TLS 検証は有効のままにしてください。先頭に配置した --disable は、cURL がデフォルトの設定ファイルを読み込み、これらのダウンロードオプションが変更されることを防ぎます。
マネージド環境でのリサイズと合成のワークフローについては、Transloadit の画像処理サービスをご覧ください。
