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

.SH "نام (NAME)"
docker-image-ls \- فهرست کردن ایمیج‌ها


.SH "خلاصه دستور (SYNOPSIS)"
\fBdocker image ls [OPTIONS] [REPOSITORY[:TAG]]\fP


.SH "شرح (DESCRIPTION)"
این دستور ایمیج‌های ذخیره‌شده در مخزن محلی Docker را فهرست می‌کند.

.PP
به‌طور پیش‌فرض، ایمیج‌های میانی که حین ساخت استفاده می‌شوند، فهرست نمی‌شوند. بخشی از خروجی، مانند شناسه ایمیج، به دلایل کمبود فضا کوتاه‌سازی می‌شود. با این حال، شناسه کوتاه‌شده ایمیج و اغلب چند نویسه اول آن، برای استفاده در سایر دستورات Docker که از شناسه ایمیج استفاده می‌کنند کافی است. خروجی شامل مخزن، تگ، شناسه ایمیج، تاریخ ایجاد و اندازه مجازی است.

.PP
عنوان REPOSITORY به عنوان عنوان نخست ممکن است گیج‌کننده به نظر برسد. این اساساً همان نام ایمیج است. با این حال، از آنجا که می‌توانید یک ایمیج مشخص را تگ‌گذاری کنید، و چندین تگ (نمونه‌های ایمیج) می‌توانند با یک نام واحد مرتبط باشند، این نام در واقع مخزنی برای تمام ایمیج‌های تگ‌گذاری‌شده با همان نام است. برای نمونه، ایمیجی به نام ubuntu را در نظر بگیرید. ممکن است برای مدیریت نسخه‌های مختلف با 24.04 یا 22.04 و غیره تگ‌گذاری شده باشد.

.SH "فیلترها (Filters)"
فیلتر کردن خروجی بر اساس این شرایط:
.IP \(bu 2
dangling=(true|false) \- یافتن ایمیج‌های بی‌استفاده
.IP \(bu 2
label= یا label==
.IP \(bu 2
before=([:tag]||image@digest
\[la]mailto:image@digest\[ra])
.IP \(bu 2
since=([:tag]||image@digest
\[la]mailto:image@digest\[ra])
.IP \(bu 2
reference=(الگوی یک ارجاع ایمیج)

.SH "قالب (Format)"
قالب‌بندی خروجی با استفاده از الگوی Go داده‌شده.
   جایگزین‌های معتبر:
      .ID - شناسه ایمیج
      .Repository - مخزن ایمیج
      .Tag - تگ ایمیج
      .Digest - دایجست ایمیج
      .CreatedSince - مدت‌زمان سپری‌شده از ایجاد ایمیج
      .CreatedAt - زمان ایجاد ایمیج
      .Size - اندازه دیسک ایمیج


.SH "مثال‌ها (EXAMPLES)"
.SH "فهرست کردن ایمیج‌ها (Listing the images)"
برای فهرست کردن ایمیج‌ها در یک مخزن محلی (نه رجیستری) اجرا کنید:

.EX
docker image ls
.EE

.PP
این فهرست شامل نام مخزن ایمیج، تگ ایمیج، شناسه ایمیج، زمان ایجاد آن و اندازه مجازی آن خواهد بود. ستون‌ها: REPOSITORY، TAG، IMAGE ID، CREATED و SIZE.

.PP
دستور \fBdocker image ls\fR یک آرگومان اختیاری \fB[REPOSITORY[:TAG]]\fR می‌پذیرد که فهرست را به ایمیج‌های منطبق با آن آرگومان محدود می‌کند. اگر \fBREPOSITORY\fR را بدون \fBTAG\fR مشخص کنید، دستور \fBdocker image ls\fR همه ایمیج‌های موجود در مخزن داده‌شده را فهرست می‌کند.

.EX
docker image ls java
.EE

.PP
مقدار \fB[REPOSITORY[:TAG]]\fR باید یک «تطابق دقیق» باشد. این بدان معناست که برای نمونه، \fBdocker image ls jav\fR با ایمیج \fBjava\fR\& مطابقت ندارد.

.PP
اگر هر دو مقدار \fBREPOSITORY\fR و \fBTAG\fR ارائه شوند، تنها ایمیج‌های منطبق با آن مخزن و تگ فهرست می‌شوند. برای یافتن همه ایمیج‌های محلی در مخزن "java" با تگ "8" می‌توانید از این دستور استفاده کنید:

.EX
docker image ls java:8
.EE

.PP
برای دریافت فهرستی با جزئیات کامل از ایمیج‌ها که شامل همه ایمیج‌های میانی استفاده‌شده در بیلدها است، از \fB-a\fP استفاده کنید:

.EX
docker image ls -a
.EE

.PP
پیش‌تر، دستور docker image ls از آرگومان‌های --tree و --dot پشتیبانی می‌کرد که مصورسازی‌های متفاوتی از داده‌های ایمیج را نمایش می‌دادند. هسته Docker این قابلیت را در نسخه 1.7 حذف کرد. اگر این قابلیت را می‌پسندید، همچنان می‌توانید آن را در ابزار شخص ثالث dockviz بیابید: https://github.com/justone/dockviz

.SH "فهرست کردن ایمیج‌ها در قالب دلخواه (Listing images in a desired format)"
هنگام استفاده از گزینه --format، دستور image یا داده‌ها را دقیقاً همان‌گونه که الگو مشخص می‌کند خروجی می‌دهد یا هنگام استفاده از دستورالعمل \fBtable\fR، سرستون‌ها را نیز شامل خواهد شد. می‌توانید از نویسه‌های ویژه‌ای مانند \fB\\t\fR برای درج فاصله تب میان ستون‌ها استفاده کنید. دستورالعمل \fBjson\fR اشیاء را در قالب JSON خروجی می‌دهد.

.PP
مثال زیر از یک الگو بدون سرستون استفاده کرده و ورودی‌های ID و Repository را که با دونقطه از هم جدا شده‌اند برای تمام ایمیج‌ها خروجی می‌دهد:

.EX
docker image ls --format "{{.ID}}: {{.Repository}}"
77af4d6b9913: <none>
b6fa739cedf5: commit
78a85c484bad: ipbabble
30557a29d5ab: docker
5ed6274db6ce: <none>
746b819f315e: postgres
746b819f315e: postgres
746b819f315e: postgres
746b819f315e: postgres
.EE

.PP
برای فهرست کردن همه ایمیج‌ها به همراه مخزن و تگ آن‌ها در قالب جدول می‌توانید استفاده کنید:

.EX
docker image ls --format "table {{.ID}}\\t{{.Repository}}\\t{{.Tag}}"
IMAGE ID            REPOSITORY                TAG
77af4d6b9913        <none>                    <none>
b6fa739cedf5        commit                   latest
78a85c484bad        ipbabble                  <none>
30557a29d5ab        docker                    latest
5ed6274db6ce        <none>                    <none>
746b819f315e        postgres                  9
746b819f315e        postgres                  9.3
746b819f315e        postgres                  9.3.5
746b819f315e        postgres                  latest
.EE

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

.PP
برای فهرست کردن همه ایمیج‌ها در قالب JSON می‌توانید استفاده کنید:

.EX
docker image ls --format json
{"Containers":"N/A","CreatedAt":"2021-01-18 11:29:06 +0100 CET","CreatedSince":"24 hours ago","Digest":"\\u003cnone\\u003e","ID":"fbcf509fa16f","Repository":"docker","SharedSize":"N/A","Size":"235MB","Tag":"stable-dind","UniqueSize":"N/A"}
{"Containers":"N/A","CreatedAt":"2021-01-18 11:24:48 +0100 CET","CreatedSince":"24 hours ago","Digest":"\\u003cnone\\u003e","ID":"08656a69ab2b","Repository":"docker-cli-e2e","SharedSize":"N/A","Size":"1.21GB","Tag":"latest","UniqueSize":"N/A"}
{"Containers":"N/A","CreatedAt":"2021-01-18 10:43:44 +0100 CET","CreatedSince":"24 hours ago","Digest":"\\u003cnone\\u003e","ID":"abca5c07c1ba","Repository":"docker-cli-dev","SharedSize":"N/A","Size":"608MB","Tag":"latest","UniqueSize":"N/A"}
.EE

.SH "فهرست کردن تنها شناسه‌های کوتاه ایمیج (Listing only the shortened image IDs)"
فهرست کردن تنها شناسه‌های کوتاه ایمیج. این می‌تواند برای برخی از ابزارهای خودکار مفید باشد.

.EX
docker image ls -q
.EE


.SH "گزینه‌ها (OPTIONS)"
\fB-a\fP, \fB--all\fP[=false]
	نمایش همه ایمیج‌ها (پیش‌فرض ایمیج‌های میانی و معلق را پنهان می‌کند)

.PP
\fB--digests\fP[=false]
	نمایش دایجست‌ها

.PP
\fB-f\fP, \fB--filter\fP=
	فیلتر کردن خروجی بر اساس شرایط ارائه‌شده

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

.PP
\fB--no-trunc\fP[=false]
	کوتاه نکردن خروجی

.PP
\fB-q\fP, \fB--quiet\fP[=false]
	تنها نمایش شناسه‌های ایمیج

.PP
\fB--tree\fP[=false]
	فهرست کردن ایمیج‌های چندسکویی به صورت درخت (آزمایشی)


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