DOCKER(1) Docker User Manuals DOCKER(1)

docker-image-history - نمایش تاریخچه یک ایمیج

docker image history [OPTIONS] IMAGE

نمایش تاریخچه زمان و نحوه ساخت یک ایمیج.

$ docker history fedora
IMAGE          CREATED          CREATED BY                                      SIZE                COMMENT
105182bb5e8b   5 days ago       /bin/sh -c #(nop) ADD file:71356d2ad59aa3119d   372.7 MB
73bd853d2ea5   13 days ago      /bin/sh -c #(nop) MAINTAINER Lokesh Mandvekar   0 B
511136ea3c5a   10 months ago                                                    0 B                 Imported from -

دستور docker commit دارای فلگ -m برای افزودن توضیحات به ایمیج است. این توضیحات در تاریخچه ایمیج نمایش داده خواهند شد.

$ sudo docker history docker:scm
IMAGE               CREATED             CREATED BY                                      SIZE                COMMENT
2ac9d1098bf1        3 months ago        /bin/bash                                       241.4 MB            Added Apache to Fedora base image
88b42ffd1f7c        5 months ago        /bin/sh -c #(nop) ADD file:1fd8d7f9f6557cafc7   373.7 MB
c69cab00d6ef        5 months ago        /bin/sh -c #(nop) MAINTAINER Lokesh Mandvekar   0 B
511136ea3c5a        19 months ago                                                       0 B                 Imported from -

گزینه قالب‌بندی (--format) خروجی تاریخچه را با استفاده از الگوی Go زیبا‌چاپ می‌کند.

جایگزین‌های معتبر برای الگوی Go در زیر فهرست شده‌اند:

Placeholder Description
.ID شناسه ایمیج
.CreatedSince مدت زمان سپری‌شده از زمان ایجاد ایمیج اگر --human=true باشد، در غیر این صورت برچسب زمانی ایجاد ایمیج
.CreatedAt برچسب زمانی ایجاد ایمیج
.CreatedBy دستوری که برای ایجاد ایمیج استفاده شد
.Size اندازه دیسک ایمیج
.Comment توضیحات برای ایمیج

هنگام استفاده از گزینه --format، دستور history داده‌ها را یا دقیقاً همان‌گونه که الگو تعیین می‌کند چاپ می‌کند یا هنگام استفاده از دستورالعمل table، سرستون‌ها را نیز شامل می‌شود.

مثال زیر از یک الگو بدون سرستون استفاده می‌کند و ورودی‌های ID و CreatedSince را برای همه ایمیج‌ها با دو‌نقطه جدا کرده و چاپ می‌کند:

$ docker images --format "{{.ID}}: {{.CreatedSince}} ago"
cc1b61406712: 2 weeks ago
<missing>: 2 weeks ago
<missing>: 2 weeks ago
<missing>: 2 weeks ago
<missing>: 2 weeks ago
<missing>: 3 weeks ago
<missing>: 3 weeks ago
<missing>: 3 weeks ago

--format="" قالب‌بندی خروجی با استفاده از یک الگوی سفارشی: 'table': چاپ خروجی در قالب جدول همراه با سرستون‌ها (پیش‌فرض) 'table TEMPLATE': چاپ خروجی در قالب جدول با استفاده از الگوی Go داده‌شده 'json': چاپ در قالب JSON 'TEMPLATE': چاپ خروجی با استفاده از الگوی Go داده‌شده. برای اطلاعات بیشتر درباره قالب‌بندی خروجی با الگوها به https://docs.docker.com/go/formatting مراجعه کنید

-H, --human[=true] چاپ اندازه‌ها و تاریخ‌ها در قالب خوانا برای انسان

--no-trunc[=false] عدم کوتاه‌سازی خروجی

--platform="" نمایش تاریخچه برای پلتفرم داده‌شده. قالب‌بندی‌شده به‌صورت "os[/arch[/variant]]" (مانند "linux/amd64")

-q, --quiet[=false] فقط نمایش شناسه‌های ایمیج

docker-image(1)

Aug 2026 Docker Community