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

.SH "نام (NAME)"
docker-plugin-ls \- فهرست کردن افزونه‌ها


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


.SH "شرح (DESCRIPTION)"
تمام افزونه‌های نصب‌شده در سیستم را فهرست می‌کند. برای نصب افزونه‌ها می‌توانید از دستور
\fBdocker plugin install\fR
استفاده کنید.
همچنین می‌توانید با استفاده از فلگ
\fB-f\fR
یا
\fB--filter\fR
خروجی را فیلتر کنید.

.SH "فیلترها (Filters)"
فیلتر کردن خروجی بر اساس این شرایط:
   - enabled=(true|false) - افزونه‌هایی که فعال هستند یا خیر
   - capability= - فیلتر کردن افزونه‌ها بر اساس قابلیت‌ها (در حال حاضر \fBvolumedriver\fR، \fBnetworkdriver\fR، \fBipamdriver\fR، یا \fBauthz\fR)

.SH "قالب‌بندی (Format)"
قالب‌بندی خروجی با استفاده از الگوی Go داده‌شده.
   متغیرهای معتبر (Placeholders):
      .ID - شناسه افزونه.
      .Name - نام افزونه.
      .Description - شرح افزونه.
      .Enabled - آیا افزونه فعال است یا خیر.


.SH "مثال‌ها (EXAMPLES)"
.SH "نمایش تمام افزونه‌ها"
.EX
$ docker plugin ls
ID                  NAME                                    DESCRIPTION                         ENABLED
869080b57404        tiborvass/sample-volume-plugin:latest   A sample volume plugin for Docker   true
141bf6c02ddd        vieux/sshfs:latest                      sshFS plugin for Docker             false
.EE

.SH "نمایش افزونه‌ها به همراه شناسه و نام آن‌ها"
.EX
$ docker plugin ls --format "{{.ID}}: {{.Name}}"
869080b57404: tiborvass/sample-volume-plugin:latest
.EE

.SH "نمایش افزونه‌ها در قالب JSON"
.EX
$ docker plugin ls --format json
{"Description":"A sample volume plugin for Docker","Enabled":true,"ID":"2788a2da7e12","Name":"tiborvass/sample-volume-plugin:latest","PluginReference":"docker.io/tiborvass/sample-volume-plugin:latest"}
.EE

.SH "نمایش افزونه‌های فعال"
.EX
$ docker plugin ls --filter enabled=true
ID                  NAME                                    DESCRIPTION                         ENABLED
869080b57404        tiborvass/sample-volume-plugin:latest   A sample volume plugin for Docker   true
.EE

.SH "نمایش افزونه‌های دارای قابلیت \fBvolumedriver\fR"
.EX
$ docker plugin ls --filter capability=volumedriver --format "table {{.ID}}\\t{{.Name}}"
ID                  Name
869080b57404        tiborvass/sample-volume-plugin:latest
.EE


.SH "گزینه‌ها (OPTIONS)"
\fB-f\fP, \fB--filter\fP=
	ارائه مقادیر فیلتر (مانند "enabled=true")

.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]
	تنها نمایش شناسه‌های افزونه


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