Docker の 401 とは何か？（公式の定義）

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

Docker の文脈では、このコードは次のことを意味します。

認証情報が提供されていないか、認証に失敗した。

このエラーが出たときは、次の「原因」の節を確認してください。

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

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

  • docker login を実行していない
  • 認証トークン（アクセス認可用の一時的な文字列）の有効期限が切れている
  • レジストリ（イメージを保存するサーバー）の URL が間違っている

具体的な解決手順とチェックリスト

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

  1. docker login コマンドで再度ログインします
  2. ~/.docker/config.json を削除して docker login をやり直します
  3. 接続先のレジストリ URL を公式ドキュメントで確認します

解決しない場合の次のステップ

上記の手順で解決しない場合は、次の方法を試してください。

  • Docker の公式ドキュメントで最新の情報を確認する
  • エラーメッセージの全文をコピーして検索エンジンで調べる
  • 公式のコミュニティフォーラムやサポートに問い合わせる

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