.nh
.TH "DOCKER" "1" "Aug 2026" "Docker Community" "Docker User Manuals"

.SH "نام (NAME)"
docker\-inspect \- بازگرداندن اطلاعات سطح پایین درباره اشیاء Docker


.SH "خلاصه (SYNOPSIS)"
\fBdocker inspect [OPTIONS] NAME|ID [NAME|ID...]\fP


.SH "شرح (DESCRIPTION)"
این دستور اطلاعات سطح پایین درباره شیء یا اشیاء Docker (مانند کانتینر،
ایمیج، حجم، شبکه، گره، سرویس یا وظیفه) مشخص‌شده با نام یا شناسه را نمایش می‌دهد. به‌طور پیش‌فرض،
تمام نتایج در یک آرایه JSON ارائه می‌شوند. اگر کانتینر و ایمیج
نام یکسانی داشته باشند، در صورت مشخص نشدن نوع، خروجی JSON کانتینر بازگردانده می‌شود. اگر یک قالب
مشخص شده باشد، الگوی ارائه‌شده برای هر نتیجه اجرا خواهد شد.


.SH "مثال‌ها (EXAMPLES)"
دریافت اطلاعات درباره یک ایمیج هنگامی که نام ایمیج با نام کانتینر تداخل دارد،
برای مثال هر دو ایمیج و کانتینر rhel7 نام دارند:

.EX
$ docker inspect --type=image rhel7
[
{
 "Id": "fe01a428b9d9de35d29531e9994157978e8c48fa693e1bf1d221dffbbb67b170",
 "Parent": "10acc31def5d6f249b548e01e8ffbaccfd61af0240c17315a7ad393d022c5ca2",
 ....
}
]
.EE

.SH "دریافت اطلاعات مربوط به یک کانتینر (Getting information on a container)"
برای دریافت اطلاعات درباره یک کانتینر از شناسه یا نام نمونه آن استفاده کنید:

.EX
$ docker inspect d2cc496561d6
[{
"Id": "d2cc496561d6d520cbc0236b4ba88c362c446a7619992123f11c809cded25b47",
"Created": "2015-06-08T16:18:02.505155285Z",
"Path": "bash",
"Args": [],
"State": {
    "Running": false,
    "Paused": false,
    "Restarting": false,
    "OOMKilled": false,
    "Dead": false,
    "Pid": 0,
    "ExitCode": 0,
    "Error": "",
    "StartedAt": "2015-06-08T16:18:03.643865954Z",
    "FinishedAt": "2015-06-08T16:57:06.448552862Z"
},
"Image": "ded7cd95e059788f2586a51c275a4f151653779d6a7f4dad77c2bd34601d94e4",
"NetworkSettings": {
    "Networks": {
        "bridge": {
            "NetworkID": "7ea29fc1412292a2d7bba362f9253545fecdfa8ce9a6e37dd10ba8bee7129812",
            "EndpointID": "7587b82f0dada3656fda26588aee72630c6fab1536d36e394b2bfbcf898c971d",
            "Gateway": "172.17.0.1",
            "IPAddress": "172.17.0.2",
            "IPPrefixLen": 16,
            "IPv6Gateway": "",
            "GlobalIPv6Address": "",
            "GlobalIPv6PrefixLen": 0,
            "MacAddress": "02:42:ac:12:00:02"
        }
    },
    "Ports": {
        "80/tcp": [
            {
                "HostIp": "0.0.0.0",
                "HostPort": "8080"
            },
            {
                "HostIp": "::",
                "HostPort": "8080"
            }
        ]
    },
    "SandboxID": "6b4851d1903e16dd6a567bd526553a86664361f31036eaaa2f8454d6f4611f6f",
    "SandboxKey": "/var/run/docker/netns/6b4851d1903e"
},
"ResolvConfPath": "/var/lib/docker/containers/d2cc496561d6d520cbc0236b4ba88c362c446a7619992123f11c809cded25b47/resolv.conf",
"HostnamePath": "/var/lib/docker/containers/d2cc496561d6d520cbc0236b4ba88c362c446a7619992123f11c809cded25b47/hostname",
"HostsPath": "/var/lib/docker/containers/d2cc496561d6d520cbc0236b4ba88c362c446a7619992123f11c809cded25b47/hosts",
"LogPath": "/var/lib/docker/containers/d2cc496561d6d520cbc0236b4ba88c362c446a7619992123f11c809cded25b47/d2cc496561d6d520cbc0236b4ba88c362c446a7619992123f11c809cded25b47-json.log",
"Name": "/adoring_wozniak",
"RestartCount": 0,
"Driver": "overlay2",
"MountLabel": "",
"ProcessLabel": "",
"Mounts": [
  {
    "Source": "/data",
    "Destination": "/data",
    "Mode": "ro,Z",
    "RW": false
    "Propagation": ""
  }
],
"AppArmorProfile": "",
"ExecIDs": null,
"HostConfig": {
    "Binds": null,
    "ContainerIDFile": "",
    "Memory": 0,
    "MemorySwap": 0,
    "CpuShares": 0,
    "CpuPeriod": 0,
    "CpusetCpus": "",
    "CpusetMems": "",
    "CpuQuota": 0,
    "BlkioWeight": 0,
    "OomKillDisable": false,
    "Privileged": false,
    "PortBindings": {},
    "Links": null,
    "PublishAllPorts": false,
    "Dns": null,
    "DnsSearch": null,
    "DnsOptions": null,
    "ExtraHosts": null,
    "VolumesFrom": null,
    "Devices": [],
    "NetworkMode": "bridge",
    "IpcMode": "",
    "PidMode": "",
    "UTSMode": "",
    "CapAdd": null,
    "CapDrop": null,
    "RestartPolicy": {
        "Name": "no",
        "MaximumRetryCount": 0
    },
    "SecurityOpt": null,
    "ReadonlyRootfs": false,
    "Ulimits": null,
    "LogConfig": {
        "Type": "json-file",
        "Config": {}
    },
    "CgroupParent": ""
},
"GraphDriver": {
    "Data": {
        "LowerDir": "/var/lib/docker/overlay2/44b1d1f04db6b1b73a86f9a62678673bf5d16d9a6b62c13e859aa34a99cce5ea/diff:/var/lib/docker/overlay2/ef637181eb13e30e84b7382183364ed7fd7ff7be22d8bb87049e36b75fb89a86/diff:/var/lib/docker/overlay2/64fb0f850b1289cd09cbc3b077cab2c0f59a4f540c67f997b094fc3652b9b0d6/diff:/var/lib/docker/overlay2/68c4d1411addc2b2bd07e900ca3a059c9c5f9fa2607efd87d8d715a0080ed242/diff",
        "MergedDir": "/var/lib/docker/overlay2/c7846fe68c6f18247ab9b8672114dde9f506bc164081a895c465716eeb10f2bc/merged",
        "UpperDir": "/var/lib/docker/overlay2/c7846fe68c6f18247ab9b8672114dde9f506bc164081a895c465716eeb10f2bc/diff",
        "WorkDir": "/var/lib/docker/overlay2/c7846fe68c6f18247ab9b8672114dde9f506bc164081a895c465716eeb10f2bc/work"
    },
    "Name": "overlay2"
},
"Config": {
    "Hostname": "d2cc496561d6",
    "Domainname": "",
    "User": "",
    "AttachStdin": true,
    "AttachStdout": true,
    "AttachStderr": true,
    "ExposedPorts": null,
    "Tty": true,
    "OpenStdin": true,
    "StdinOnce": true,
    "Env": null,
    "Cmd": [
        "bash"
    ],
    "Image": "fedora",
    "Volumes": null,
    "VolumeDriver": "",
    "WorkingDir": "",
    "Entrypoint": null,
    "NetworkDisabled": false,
    "MacAddress": "",
    "OnBuild": null,
    "Labels": {},
    "Memory": 0,
    "MemorySwap": 0,
    "CpuShares": 0,
    "Cpuset": "",
    "StopSignal": "SIGTERM"
}
}
]
.EE

.SH "دریافت نشانی IP یک نمونه کانتینر (Getting the IP address of a container instance)"
برای دریافت نشانی IP یک کانتینر استفاده کنید از:

.EX
$ docker inspect --format='{{range .NetworkSettings.Networks}}{{.IPAddress}}{{end}}' d2cc496561d6
172.17.0.2
.EE

.SH "فهرست کردن تمام نگاشت‌های درگاه (Listing all port bindings)"
می‌توان روی آرایه‌ها و نگاشت‌ها در نتایج پیمایش کرد تا خروجی متنی ساده
تولید شود:

.EX
$ docker inspect --format='{{range $p, $conf := .NetworkSettings.Ports}} \\
  {{$p}} -> {{(index $conf 0).HostPort}} {{end}}' d2cc496561d6
  80/tcp -> 80
.EE

.PP
می‌توانید اطلاعات بیشتری درباره نحوه نوشتن یک الگوی Go از نشانی زیر دریافت کنید:
<https://pkg.go.dev/text/template>.

.SH "دریافت اطلاعات اندازه یک کانتینر (Getting size information on a container)"
.EX
$ docker inspect -s d2cc496561d6
[
{
\&....
"SizeRw": 0,
"SizeRootFs": 972,
\&....
}
]
.EE

.SH "دریافت اطلاعات درباره یک ایمیج (Getting information on an image)"
از شناسه یا نام ایمیج (مانند repository/name[:tag]) برای دریافت اطلاعات
درباره ایمیج استفاده کنید:

.EX
docker inspect hello-world
[
    {
        "Id": "sha256:54e66cc1dd1fcb1c3c58bd8017914dbed8701e2d8c74d9262e26bd9cc1642d31",
        "RepoTags": [
            "hello-world:latest"
        ],
        "RepoDigests": [
            "hello-world@sha256:54e66cc1dd1fcb1c3c58bd8017914dbed8701e2d8c74d9262e26bd9cc1642d31"
        ],
        "Parent": "",
        "Comment": "buildkit.dockerfile.v0",
        "Created": "2025-08-08T19:05:17Z",
        "DockerVersion": "",
        "Author": "",
        "Config": {
            "Env": [
                "PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin"
            ],
            "Cmd": [
                "/hello"
            ],
            "WorkingDir": "/"
        },
        "Architecture": "arm64",
        "Variant": "v8",
        "Os": "linux",
        "Size": 16963,
        "RootFS": {
            "Type": "layers",
            "Layers": [
                "sha256:50163a6b11927e67829dd6ba5d5ba2b52fae0a17adb18c1967e24c13a62bfffa"
            ]
        },
        "Metadata": {
            "LastTagTime": "2025-09-30T14:06:24.148634215Z"
        },
        "Descriptor": {
            "mediaType": "application/vnd.oci.image.index.v1+json",
            "digest": "sha256:54e66cc1dd1fcb1c3c58bd8017914dbed8701e2d8c74d9262e26bd9cc1642d31",
            "size": 12341
        }
    }
]
.EE


.SH "گزینه‌ها (OPTIONS)"
\fB-f\fP, \fB--format\fP=""
	قالب‌بندی خروجی با استفاده از یک الگوی سفارشی:
\&'json':             چاپ در قالب JSON
\&'TEMPLATE':         چاپ خروجی با استفاده از الگوی Go ارائه‌شده.
برای اطلاعات بیشتر درباره قالب‌بندی خروجی با الگوها به <https://docs.docker.com/go/formatting> مراجعه کنید

.PP
\fB-s\fP, \fB--size\fP[=false]
	نمایش اندازه کل فایل‌ها در صورتی که نوع شیء کانتینر باشد

.PP
\fB--type\fP=""
	بررسی اشیاء فقط از نوع مشخص‌شده


.SH "ببینید (SEE ALSO)"
\fBdocker(1)\fP