Docker inspect 入門：コンテナとイメージの詳細情報を確認する（-f 形式の例）

docker inspect は Docker オブジェクトの設定と状態を JSON 形式で表示します。対象はコンテナ、イメージ、Volume、ネットワークです。

構文

docker inspect [オプション] 名前またはID [名前またはID...]

全出力

$ docker inspect web | head -n 12
[
    {
        "Id": "1ec4fdc5c592b09b64e8f28869c37f89ab17163f88bfcb09e82815a44b0e1164",
        "Created": "2026-10-13T05:28:35.05807319Z",
        "Path": "/docker-entrypoint.sh",
        "Args": [
            "nginx",
            "-g",
            "daemon off;"
        ],
        "State": {
            "Status": "running",

全出力は数百行に及びます。実際にはほとんどの場合、-f を付けて必要なフィールドだけを取得します。

-f テンプレート：よく使う検索

以下では、起動時に -e APP_MODE=demo を設定した web という名前の nginx コンテナを調べます。

$ docker inspect -f "{{.State.Status}} {{.State.StartedAt}}" web
running 2026-10-13T05:28:40.584115149Z

$ docker inspect -f "{{range .NetworkSettings.Networks}}{{.IPAddress}}{{end}}" web
172.18.0.2

$ docker inspect -f "{{json .Config.Env}}" web
["APP_MODE=demo","PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin","NGINX_VERSION=1.30.5","PKG_RELEASE=1","DYNPKG_RELEASE=1","NJS_VERSION=1.0.1","NJS_RELEASE=1","ACME_VERSION=0.4.1"]

$ docker inspect -f "{{.Config.Image}} {{.HostConfig.RestartPolicy.Name}}" web
nginx:1.30-alpine no

テンプレートの構文：

• {{.フィールド.子フィールド}}：値を 1 つ取得します。
• {{json .フィールド}}：全体（配列やオブジェクト）を JSON で出力します。
• {{range .リスト}}...{{end}}：リストまたはオブジェクトの各項目を順に処理します。

Docker 29 での変更：以前のチュートリアルでよく見かける {{.NetworkSettings.IPAddress}} は削除されており、実行すると template parsing error: ... map has no entry for key "IPAddress" が表示されます。上の表にある range の書き方を使ってください。

イメージ、Volume、ネットワーク

$ docker inspect -f "{{.Config.Cmd}} {{.Config.Entrypoint}}" nginx:1.30-alpine
[nginx -g daemon off;] [/docker-entrypoint.sh]

$ docker inspect -f "{{.Architecture}} {{.Os}} {{.Size}}" nginx:1.30-alpine
amd64 linux 92750711

$ docker volume create v1
v1

$ docker inspect -f "{{.Mountpoint}}" v1
/var/lib/docker/volumes/v1/_data

$ docker inspect --type network -f "{{range .IPAM.Config}}{{.Subnet}}{{end}}" bridge
172.18.0.0/16

$ docker volume rm v1
v1

• イメージの .Config.Cmd と .Config.Entrypoint はデフォルトの起動コマンドです。.Architecture は CPU アーキテクチャ、.Size はバイト数です（92750711 は約 92.8 MB）。
• Volume の .Mountpoint は、Docker ホスト上にあるデータの実際の場所です。Docker Desktop ではこのパスは仮想マシン内にあるため、Windows や macOS から直接開くことはできません。
• --type network はネットワークの検索を指定し、.IPAM.Config はサブネットの設定を示します。

関連する章

• docker ps：--format も同じテンプレート構文を使います
• ネットワークとコンテナの接続
• 内部の仕組み：.State.Pid を使ってホスト上でコンテナのプロセスを見つけます

練習問題

練習：web コンテナがどのパスをマウントしているか、またポートがどう割り当てられているかを調べてください。

docker inspect -f "{{json .Mounts}}" web
docker inspect -f "{{json .NetworkSettings.Ports}}" web

更新日 2026年10月14日