| DOCKER(1) | Docker User Manuals | DOCKER(1) |
نام (NAME)
docker-network-ls - فهرست کردن شبکهها
خلاصه دستور (SYNOPSIS)
docker network ls [OPTIONS]
شرح (DESCRIPTION)
تمام شبکههایی را که دیمن موتور Docker (daemon) از آنها آگاه است، فهرست میکند. این شامل شبکههایی است که در سرتاسر چندین میزبان در یک کلاستر گسترده شدهاند، برای نمونه:
$ docker network ls NETWORK ID NAME DRIVER SCOPE 7fca4eb8c647 bridge bridge local 9f904ee27bf5 none null local cf03ee007fb4 host host local 78b03ee04fc4 multi-host overlay swarm
برای نمایش شناسه کامل شبکه از گزینه --no-trunc استفاده کنید:
$ docker network ls --no-trunc NETWORK ID NAME DRIVER 18a2866682b85619a026c81b98a5e375bd33e1b0936a26cc497c283d27bae9b3 none null c288470c46f6c8949c5f7e5099b5b7947b07eabe8d9a27d79a9cbf111adcbf47 host host 7b369448dccbf865d397c8d2be0cda7cf7edc6b0945f77d2529912ae917a0185 bridge bridge 95e74588f40db048e86320c6526440c504650a1ff3e9f7d60a497c4d2163e5bd foo bridge 63d1ff1f77b07ca51070a8c227e962238358bd310bde1529cf62e6c307ade161 dev bridge
فیلتر کردن (Filtering)
قالب فلگ فیلتر (-f یا --filter) بهصورت یک جفت key=value است. اگر بیش از یک فیلتر وجود دارد، چندین فلگ ارسال کنید (مانند --filter "foo=bar" --filter "bif=baz"). چندین فلگ فیلتر با یکدیگر بهصورت فیلتر OR ترکیب میشوند. برای نمونه، -f type=custom -f type=builtin هر دو شبکه custom و builtin را برمیگرداند.
فیلترهایی که در حال حاضر پشتیبانی میشوند عبارتند از:
- driver
- id (شناسه شبکه)
- label (label=<key> یا label=<key>=<value>)
- name (نام شبکه)
- scope (swarm|global|local)
- type (custom|builtin)
درایور (Driver)
فیلتر driver شبکهها را بر اساس درایور آنها تطبیق میدهد.
مثال زیر شبکههای دارای درایور bridge را مطابقت میدهد:
$ docker network ls --filter driver=bridge NETWORK ID NAME DRIVER db9db329f835 test1 bridge f6e212da9dfd test2 bridge
شناسه (ID)
فیلتر id با تمام یا بخشی از شناسه شبکه مطابقت پیدا میکند.
فیلتر زیر همه شبکههای دارای شناسهای شامل رشته 63d1ff1f77b0... را مطابقت میدهد.
$ docker network ls --filter id=63d1ff1f77b07ca51070a8c227e962238358bd310bde1529cf62e6c307ade161 NETWORK ID NAME DRIVER 63d1ff1f77b0 dev bridge
همچنین میتوانید مانند این نمونه، برای یک زیررشته در شناسه فیلتر کنید:
$ docker network ls --filter id=95e74588f40d NETWORK ID NAME DRIVER 95e74588f40d foo bridge $ docker network ls --filter id=95e NETWORK ID NAME DRIVER 95e74588f40d foo bridge
برچسب (Label)
فیلتر label شبکهها را بر اساس وجود یک label بهتنهایی یا یک label و یک مقدار مطابقت میدهد.
فیلتر زیر شبکههای دارای برچسب usage را بدون در نظر گرفتن مقدار آن مطابقت میدهد.
$ docker network ls -f "label=usage" NETWORK ID NAME DRIVER db9db329f835 test1 bridge f6e212da9dfd test2 bridge
فیلتر زیر شبکههای دارای برچسب usage با مقدار prod را مطابقت میدهد.
$ docker network ls -f "label=usage=prod" NETWORK ID NAME DRIVER f6e212da9dfd test2 bridge
نام (Name)
فیلتر name با تمام یا بخشی از نام شبکه مطابقت پیدا میکند.
فیلتر زیر همه شبکههای دارای نامی شامل رشته foobar را مطابقت میدهد.
$ docker network ls --filter name=foobar NETWORK ID NAME DRIVER 06e7eef0a170 foobar bridge
همچنین میتوانید مانند این نمونه، برای یک زیررشته در نام فیلتر کنید:
$ docker network ls --filter name=foo NETWORK ID NAME DRIVER 95e74588f40d foo bridge 06e7eef0a170 foobar bridge
دامنه (Scope)
فیلتر scope شبکهها را بر اساس دامنه آنها مطابقت میدهد.
مثال زیر شبکههای دارای دامنه swarm را مطابقت میدهد:
$ docker network ls --filter scope=swarm NETWORK ID NAME DRIVER SCOPE xbtm0v4f1lfh ingress overlay swarm ic6r88twuu92 swarmnet overlay swarm
مثال زیر شبکههای دارای دامنه local را مطابقت میدهد:
$ docker network ls --filter scope=local NETWORK ID NAME DRIVER SCOPE e85227439ac7 bridge bridge local 0ca0e19443ed host host local ca13cc149a36 localnet bridge local f9e115d2de35 none null local
نوع (Type)
فیلتر type از دو مقدار پشتیبانی میکند؛ builtin شبکههای از پیشتعریفشده (bridge، none، host) را نمایش میدهد، در حالی که custom شبکههای تعریفشده توسط کاربر را نمایش میدهد.
فیلتر زیر تمام شبکههای تعریفشده توسط کاربر را مطابقت میدهد:
$ docker network ls --filter type=custom NETWORK ID NAME DRIVER 95e74588f40d foo bridge 63d1ff1f77b0 dev bridge
داشتن این فلگ امکان پاکسازی دستهای را فراهم میکند. برای نمونه، از این فیلتر برای حذف تمام شبکههای تعریفشده توسط کاربر استفاده کنید:
$ docker network rm `docker network ls --filter type=custom -q`
هنگام تلاش برای حذف شبکهای که کانتینرهایی به آن متصل هستند، هشداری صادر خواهد شد.
قالب (Format)
قالب از یک الگوی Go برای چاپ خروجی استفاده میکند. متغیرهای زیر پشتیبانی میشوند:
- .ID - شناسه شبکه
- .Name - نام شبکه
- .Driver - درایور شبکه
- .Scope - دامنه شبکه (local، global)
- .IPv6 - فعال بودن یا نبودن IPv6 روی شبکه
- .Internal - داخلی بودن یا نبودن شبکه
- .Labels - تمام برچسبهای اختصاصیافته به شبکه
- .Label - مقدار یک برچسب خاص برای این شبکه. برای نمونه {{.Label "project.version"}}
گزینهها (OPTIONS)
-f, --filter= ارائه مقادیر فیلتر (مانند "driver=bridge")
--format="" قالببندی خروجی با استفاده از یک الگوی سفارشی: 'table': چاپ خروجی در قالب جدول همراه با سربرگ ستونها (پیشفرض) 'table TEMPLATE': چاپ خروجی در قالب جدول با استفاده از الگوی Go دادهشده 'json': چاپ در قالب JSON 'TEMPLATE': چاپ خروجی با استفاده از الگوی Go دادهشده. برای اطلاعات بیشتر درباره قالببندی خروجی با الگوها، به https://docs.docker.com/go/formatting مراجعه کنید
--no-trunc[=false] خروجی کوتاهسازی نشود
-q, --quiet[=false] تنها شناسههای شبکه نمایش داده شوند
ببینید (SEE ALSO)
| Aug 2026 | Docker Community |