ひとことで言うと

# コンテナの全情報をJSONで表示
docker inspect <コンテナ名またはID>

# 特定の項目だけ取り出す（IPアドレスの例）
docker inspect -f '{{.NetworkSettings.IPAddress}}' <コンテナ名>

やりたかったこと / 現象

コンテナの中で何が起きているのか調べたい、コンテナに割り当てられたIPアドレスを知りたい、マウントされているボリュームのパスを確認したい——docker ps や docker logs では表示されないこうした詳細情報を探しているときに docker inspect にたどり着く人が多いはずです。

docker inspect はコンテナやイメージ、ネットワーク、ボリュームなど、Dockerが管理するオブジェクトの設定情報をJSON形式で丸ごと出力してくれるコマンドです。情報量が多い分、目的の項目をどう絞り込むかがポイントになります。

環境

  • Docker: 20.10以降で動作確認
  • OS: Linux / macOS / Windows（WSL2）

解決策

1. 基本構文

docker inspect <コンテナ名/ID>
docker inspect <イメージ名/ID>

コンテナ名とイメージ名が重複していない限り、docker inspect は自動的に対象の種類を判別します。明示的に指定したい場合は --type オプションを使います。

docker inspect --type container <名前>
docker inspect --type image <名前>

2. IPアドレスを確認する

docker inspect -f '{{.NetworkSettings.IPAddress}}' <コンテナ名>

デフォルトブリッジネットワーク以外（docker network create で作った独自ネットワークなど）に接続している場合は、以下のように取得します。

docker inspect -f '{{range .NetworkSettings.Networks}}{{.IPAddress}}{{end}}' <コンテナ名>

3. 環境変数を確認する

docker inspect -f '{{.Config.Env}}' <コンテナ名>

4. マウントされているボリュームを確認する

docker inspect -f '{{.Mounts}}' <コンテナ名>

見やすく整形したい場合はJSON全体を jq に渡すのがおすすめです。

docker inspect <コンテナ名> | jq '.[0].Mounts'

5. ヘルスチェックの状態を確認する

docker inspect -f '{{.State.Health.Status}}' <コンテナ名>

healthy / unhealthy / starting のいずれかが返ります。HEALTHCHECK を定義していないイメージでは <no value> になります。

6. 終了コードを確認する

docker inspect -f '{{.State.ExitCode}}' <コンテナ名>

コンテナが異常終了した原因調査の第一歩として、終了コードの確認はよく行われます。

7. 複数のコンテナをまとめて調べる

docker inspect -f '{{.Name}}: {{.State.Status}}' $(docker ps -aq)

よくあるエラーと対処

Error: No such object: <名前>

コンテナ名やイメージ名のタイプミス、または対象がすでに削除されていることが原因です。docker ps -a や docker images で正確な名前を確認してください。

docker ps -a
docker inspect <正しい名前>

template: :1: unexpected "}" in operand

-f（--format）で指定するGoテンプレートの構文ミスです。{{ }} の対応や . の位置を確認してください。

# 誤り
docker inspect -f '{{.NetworkSettings.IPAddress' <コンテナ名>

# 正しい
docker inspect -f '{{.NetworkSettings.IPAddress}}' <コンテナ名>

出力結果が空 []

コンテナ名・イメージ名を1つも指定していないか、複数指定した際に該当するものが1つもない場合に発生します。引数を確認してください。

JSONが長すぎて読みにくい

docker inspect の出力はネストが深く、そのまま見ると情報量が多すぎます。jq や --format を使って必要な項目だけに絞り込むと読みやすくなります。

docker inspect <コンテナ名> | jq '.[0] | {Name, State, NetworkSettings}'

よくある質問

Q: docker inspect と docker stats の違いは？ docker inspect は設定情報（IPアドレス・環境変数・マウント等）の静的なスナップショットを表示します。一方 docker stats はCPU・メモリ使用率などのリアルタイムなリソース状況を表示するコマンドで、目的が異なります。

Q: コンテナが停止していても docker inspect は使えますか？ 使えます。停止中のコンテナでも設定情報や最後の終了コード（State.ExitCode）などを確認できます。ただしネットワーク情報の一部は停止中には取得できません。

Q: --format と -f は何が違いますか？ 同じオプションの省略形と正式名です。動作に違いはありません。

Q: イメージに対して docker inspect を使うと何がわかりますか？ イメージのレイヤー構成、デフォルトの環境変数、CMD/ENTRYPOINT、公開ポート、作成日時などがわかります。

Q: ネットワークやボリュームにも docker inspect は使えますか？ 使えます。docker network inspect <ネットワーク名> や docker volume inspect <ボリューム名> のように、対象ごとのサブコマンドとしても実行できます。

関連記事

おすすめのVPS／ドメイン／スクール

VPSを使って本番環境を構築するなら、以下のサービスがおすすめです。