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

.SH "نام (NAME)"
docker-container-exec \- اجرای یک دستور در یک کانتینر در حال اجرا


.SH "خلاصه دستور (SYNOPSIS)"
\fBdocker container exec [OPTIONS] CONTAINER COMMAND [ARG...]\fP


.SH "شرح (DESCRIPTION)"
اجرای یک پردازه در یک کانتینر در حال اجرا.

.PP
دستوری که با استفاده از \fBdocker exec\fR شروع می‌شود، تنها زمانی اجرا خواهد شد که پردازه اصلی کانتینر (\fBPID 1\fR) در حال اجرا باشد و در صورت راه‌اندازی مجدد کانتینر، مجدداً راه‌اندازی نخواهد شد.

.PP
اگر کانتینر در حالت مکث (paused) باشد، دستور \fBdocker exec\fR تا زمان خروج کانتینر از حالت مکث صبر کرده و سپس اجرا می‌شود.


.SH "قابلیت‌ها (CAPABILITIES)"
گزینه \fBprivileged\fR قابلیت‌های گسترش‌یافته لینوکس
\[la]https://man7.org/linux/man\-pages/man7/capabilities.7.html\[ra]
را هنگام اجرا در یک کانتینر به پردازه اعطا می‌کند.

.PP
بدون این فلگ، پردازه‌ای که توسط \fBdocker exec\fR در یک کانتینر در حال اجرا اجرا می‌شود، دارای همان قابلیت‌های کانتینر است که ممکن است محدود باشند. برای اعطای تمام قابلیت‌ها به پردازه، \fB--privileged\fR را تنظیم کنید.


.SH "کاربر (USER)"
گزینه \fBuser\fR نام کاربری یا UID مورد استفاده و در صورت تمایل نام گروه یا GID را برای دستور مشخص‌شده تعیین می‌کند.

.PP
مثال‌های زیر همگی معتبر هستند:
.nf
   --user [user | user:group | uid | uid:gid | user:gid | uid:group ]
.fi

.PP
بدون این آرگومان، دستور به‌صورت root در کانتینر اجرا خواهد شد.


.SH "وضعیت خروج (EXIT STATUS)"
کد خروج از \fBdocker exec\fR اطلاعاتی درباره علت شکست کانتینر در اجرای دستور یا علت خروج آن ارائه می‌دهد. هنگامی که \fBdocker exec\fR با یک کد غیرصفر خارج می‌شود، کدهای خروج از استاندارد \fBchroot\fR پیروی می‌کنند، به موارد زیر نگاه کنید:

.PP
\fB126\fR اگر \fB\fIcontained command\fP\fP قابل فراخوانی نباشد

.EX
$ docker exec busybox /etc; echo $?
# exec: "/etc": permission denied
  docker: Error response from daemon: Contained command could not be invoked
  126
.EE

.PP
\fB127\fR اگر \fB\fIcontained command\fP\fP پیدا نشود

.EX
$ docker exec busybox foo; echo $?
# exec: "foo": executable file not found in $PATH
  docker: Error response from daemon: Contained command not found or does not exist
  127
.EE

.PP
در غیر این صورت، \fBExit code\fR مربوط به \fB\fIcontained command\fP\fP

.EX
$ docker exec busybox /bin/sh -c 'exit 3'
# 3
.EE


.SH "گزینه‌ها (OPTIONS)"
\fB-d\fP, \fB--detach\fP[=false]
	حالت تفکیک‌شده (Detached): اجرای دستور در پس‌زمینه

.PP
\fB--detach-keys\fP=""
	بازنویسی توالی کلیدها برای جدا شدن از کانتینر

.PP
\fB-e\fP, \fB--env\fP=
	تنظیم متغیرهای محیطی

.PP
\fB--env-file\fP=
	خواندن یک فایل از متغیرهای محیطی

.PP
\fB-i\fP, \fB--interactive\fP[=false]
	باز نگه داشتن STDIN حتی در صورت متصل نبودن

.PP
\fB--privileged\fP[=false]
	اعطای دسترسی‌های گسترش‌یافته به دستور

.PP
\fB-t\fP, \fB--tty\fP[=false]
	تخصیص یک شبه TTY (pseudo-TTY)

.PP
\fB-u\fP, \fB--user\fP=""
	نام کاربری یا UID (قالب: "[:]")

.PP
\fB-w\fP, \fB--workdir\fP=""
	دایرکتوری کاری درون کانتینر


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