Docker の 502 とは何か?(公式の定義)

502 は、HTTP 標準仕様(RFC 9110)で定められているステータスコードの一つです。

HTTP 仕様では、次のことを意味します。

中継サーバー(プロキシや上流のサーバー)から不正な応答を受け取った。

Docker の文脈でも、同じ意味で使用されます。 このエラーが出たときは、以下の「原因」の節を確認してください。


このエラーが発生する主な原因

502 が出るときに、最もよく見られる原因を挙げます。 自分の状況に当てはまるものを探してください。


具体的な解決手順

上の原因ごとの対処法を、実行できる手順の形でまとめました。 上から順番に試すことで、問題の解決に近づけます。

  1. curl でレジストリの URL に直接アクセスできるか確認する
  2. /etc/docker/daemon.json のプロキシ設定を見直す

免責事項:本記事の内容は、執筆時点の公開情報をもとに作成したものです。ソフトウェアの仕様やAPIの動作は予告なく変更されることがあります。最新かつ正確な情報については、各ツールの公式ドキュメントを必ずご確認ください。本記事の情報を利用した結果生じたいかなる損害についても、著者および運営者は責任を負いかねます。