| DOCKER(1) | Docker User Manuals | DOCKER(1) |
نام (NAME)
docker-container-ls - فهرست کردن کانتینرها
خلاصه دستور (SYNOPSIS)
docker container ls [OPTIONS]
شرح (DESCRIPTION)
فهرست کردن کانتینرها در مخزن محلی. بهطور پیشفرض تنها کانتینرهای در حال اجرا نمایش داده میشوند.
فیلترها (Filters)
فیلتر
کردن خروجی
بر اساس این
شرایط:
- ancestor=([:tag]||image@digest ⟨mailto:image@digest⟩)
کانتینرهای
ایجادشده
از یک ایمیج
یا فرزندان
آن.
- before=(|)
- expose=([/]|/[])
- exited= یک کد خروج
- health=(starting|healthy|unhealthy|none)
- id= شناسه یک
کانتینر
- isolation=(default|process|hyperv)
(تنها دیمن
ویندوز)
- is-task=(true|false)
- label= یا label==
- name= نام یک
کانتینر
- network=(|)
- publish=([/]|/[])
- since=(|)
- status=(created|restarting|removing|running|paused|exited)
- volume=(|)
قالب (Format)
گزینه قالببندی (--format) خروجی کانتینر را با استفاده از یک الگوی Go بهزیبایی چاپ میکند.
جایگزینهای
معتبر برای
الگوی Go در
زیر فهرست
شدهاند:
- .ID - شناسه
کانتینر.
- .Image - شناسه
ایمیج.
- .Command - دستور
نقلقولشده.
- .CreatedAt - زمان
ایجاد
کانتینر.
- .RunningFor -
مدتزمان
سپریشده
از شروع
کانتینر.
- .Ports -
درگاههای
اکسپوزشده.
- .Status - وضعیت
کانتینر.
- .Size - اندازه
دیسک
کانتینر.
- .Names - نامهای
کانتینر.
- .Labels - تمام
برچسبهای
اختصاصیافته
به کانتینر.
- .Label - مقدار یک
برچسب خاص
برای این
کانتینر.
برای نمونه
'{{.Label "com.docker.swarm.cpu"}}'.
- .Mounts - نامهای
حجمهای
متصلشده
به این
کانتینر.
- .Networks - نامهای
شبکههای
متصل به این
کانتینر.
مثالها (EXAMPLES)
نمایش همه کانتینرها، از جمله متوقفشدهها (Display all containers, including non-running)
$ docker container ls -a CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES a87ecb4f327c ubuntu:24.04 /bin/sh -c #(nop) MA 20 minutes ago Exit 0 desperate_brattain 01946d9d34d8 busybox /bin/sh -c #(nop) MA 33 minutes ago Exit 0 thirsty_bell c1d3b0166030 acffc0358b9e /bin/sh -c yum -y up 2 weeks ago Exit 1 determined_torvalds 41d50ecd2f57 ubuntu:24.04 /bin/sh -c #(nop) MA 2 weeks ago Exit 0 drunk_pike
نمایش تنها شناسههای همه کانتینرها، از جمله متوقفشدهها (Display only IDs of all containers, including non-running)
$ docker container ls -a -q a87ecb4f327c 01946d9d34d8 c1d3b0166030 41d50ecd2f57
نمایش تنها شناسه کانتینرهایی که نام determined_torvalds دارند (Display only IDs of all containers that have the name determined_torvalds)
$ docker container ls -a -q --filter=name=determined_torvalds c1d3b0166030
نمایش کانتینرها به همراه دستورات آنها (Display containers with their commands)
$ docker container ls --format "{{.ID}}: {{.Command}}"
a87ecb4f327c: /bin/sh -c #(nop) MA
01946d9d34d8: /bin/sh -c #(nop) MA
c1d3b0166030: /bin/sh -c yum -y up
41d50ecd2f57: /bin/sh -c #(nop) MA
نمایش کانتینرها به همراه برچسبهای آنها در یک جدول (Display containers with their labels in a table)
$ docker container ls --format "table {{.ID}}\t{{.Labels}}"
CONTAINER ID LABELS
a87ecb4f327c com.docker.swarm.node=ubuntu,com.docker.swarm.storage=ssd
01946d9d34d8
c1d3b0166030 com.docker.swarm.node=debian,com.docker.swarm.cpu=6
41d50ecd2f57 com.docker.swarm.node=fedora,com.docker.swarm.cpu=3,com.docker.swarm.storage=ssd
نمایش کانتینرها به همراه برچسب نود آنها در یک جدول (Display containers with their node label in a table)
$ docker container ls --format 'table {{.ID}}\t{{(.Label "com.docker.swarm.node")}}'
CONTAINER ID NODE
a87ecb4f327c worker-1
01946d9d34d8
c1d3b0166030 worker-1
41d50ecd2f57 worker-2
نمایش کانتینرهای دارای حجم مانتشده remote-volume (Display containers with remote-volume mounted)
$ docker container ls --filter volume=remote-volume --format "table {{.ID}}\t{{.Mounts}}"
CONTAINER ID MOUNTS
9c3527ed70ce remote-volume
نمایش کانتینرهای دارای یک حجم مانتشده در data/ (Display containers with a volume mounted in /data)
$ docker container ls --filter volume=/data --format "table {{.ID}}\t{{.Mounts}}"
CONTAINER ID MOUNTS
9c3527ed70ce remote-volume
نمایش کانتینرهایی که پورت ۸۰ را منتشر کردهاند (Display containers that have published port of 80)
$ docker ps --filter publish=80 CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES fc7e477723b7 busybox "top" About a minute ago Up About a minute 0.0.0.0:32768->80/tcp admiring_roentgen
نمایش کانتینرهایی که پورت TCP در بازه ۸۰۰۰-۸۰۸۰ اکسپوز کردهاند (Display containers that have exposed TCP port in the range of 8000-8080)
$ docker ps --filter expose=8000-8080/tcp CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES 9833437217a5 busybox "top" 21 seconds ago Up 19 seconds 8080/tcp dreamy_mccarthy
نمایش کانتینرها در قالب JSON (Display containers in JSON format)
$ docker ps --format json
{"Command":"\"/docker-entrypoint.…\"","CreatedAt":"2021-03-10 00:15:05 +0100 CET","ID":"a762a2b37a1d","Image":"nginx","Labels":"maintainer=NGINX Docker Maintainers \u003cdocker-maint@nginx.com\u003e","LocalVolumes":"0","Mounts":"","Names":"boring_keldysh","Networks":"bridge","Ports":"80/tcp","RunningFor":"4 seconds ago","Size":"0B","State":"running","Status":"Up 3 seconds"}
گزینهها (OPTIONS)
-a, --all[=false] نمایش همه کانتینرها (پیشفرض فقط در حال اجرا را نشان میدهد)
-f, --filter= فیلتر کردن خروجی بر اساس شرایط ارائهشده
--format="" قالببندی خروجی با استفاده از یک الگوی سفارشی: 'table': چاپ خروجی در قالب جدول همراه با سرستونها (پیشفرض) 'table TEMPLATE': چاپ خروجی در قالب جدول با استفاده از الگوی Go دادهشده 'json': چاپ در قالب JSON 'TEMPLATE': چاپ خروجی با استفاده از الگوی Go دادهشده. برای اطلاعات بیشتر درباره قالببندی خروجی با الگوها به https://docs.docker.com/go/formatting مراجعه کنید
-n, --last=-1 نمایش n کانتینر ایجادشده اخیر (شامل همه وضعیتها)
-l, --latest[=false] نمایش آخرین کانتینر ایجادشده (شامل همه وضعیتها)
--no-trunc[=false] عدم کوتاه کردن خروجی
-q, --quiet[=false] تنها نمایش شناسههای کانتینر
-s, --size[=false] نمایش کل اندازههای فایل
ببینید (SEE ALSO)
| Aug 2026 | Docker Community |