DOCKER(1) Docker User Manuals DOCKER(1)

docker-image-ls - فهرست کردن ایمیج‌ها

docker image ls [OPTIONS] [REPOSITORY[:TAG]]

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

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

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

فیلتر کردن خروجی بر اساس این شرایط:

  • dangling=(true|false) - یافتن ایمیج‌های بی‌استفاده
  • label= یا label==
  • before=([:tag]||image@digest ⟨mailto:image@digest⟩)
  • since=([:tag]||image@digest ⟨mailto:image@digest⟩)
  • reference=(الگوی یک ارجاع ایمیج)

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

برای فهرست کردن ایمیج‌ها در یک مخزن محلی (نه رجیستری) اجرا کنید:

docker image ls

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

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

docker image ls java

مقدار [REPOSITORY[:TAG]] باید یک «تطابق دقیق» باشد. این بدان معناست که برای نمونه، docker image ls jav با ایمیج java مطابقت ندارد.

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

docker image ls java:8

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

docker image ls -a

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

هنگام استفاده از گزینه --format، دستور image یا داده‌ها را دقیقاً همان‌گونه که الگو مشخص می‌کند خروجی می‌دهد یا هنگام استفاده از دستورالعمل table، سرستون‌ها را نیز شامل خواهد شد. می‌توانید از نویسه‌های ویژه‌ای مانند \t برای درج فاصله تب میان ستون‌ها استفاده کنید. دستورالعمل json اشیاء را در قالب JSON خروجی می‌دهد.

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

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

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

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

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

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

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"}

فهرست کردن تنها شناسه‌های کوتاه ایمیج. این می‌تواند برای برخی از ابزارهای خودکار مفید باشد.

docker image ls -q

-a, --all[=false] نمایش همه ایمیج‌ها (پیش‌فرض ایمیج‌های میانی و معلق را پنهان می‌کند)

--digests[=false] نمایش دایجست‌ها

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

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

--no-trunc[=false] کوتاه نکردن خروجی

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

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

docker-image(1)

Aug 2026 Docker Community