DOCKER(1) Docker User Manuals DOCKER(1)

docker-container-run - ایجاد و اجرای یک کانتینر جدید از یک ایمیج

docker container run [OPTIONS] IMAGE [COMMAND] [ARG...]

نام مستعار برای docker run.

--add-host= افزودن نگاشت سفارشی میزبان به آی‌پی (host:ip)

--annotation=map[] افزودن یادداشت (annotation) به کانتینر (منتقل‌شده به زمان اجرای OCI)

-a, --attach= اتصال به STDIN، STDOUT یا STDERR

--blkio-weight=0 ورودی/خروجی بلوکی (وزن نسبی)، بین 10 تا 1000، یا 0 برای غیرفعال‌سازی (پیش‌فرض 0)

--blkio-weight-device=[] وزن ورودی/خروجی بلوکی (وزن نسبی دستگاه)

--cap-add= افزودن قابلیت‌های لینوکس (Linux capabilities)

--cap-drop= حذف قابلیت‌های لینوکس (Linux capabilities)

--cgroup-parent="" گروه کنترلی (cgroup) والد اختیاری برای کانتینر

--cgroupns="" فضای نام cgroup مورد استفاده (host|private) 'host': اجرای کانتینر در فضای نام cgroup میزبان داکر 'private': اجرای کانتینر در فضای نام cgroup خصوصی خودش '': استفاده از فضای نام cgroup پیکربندی‌شده توسط گزینه default-cgroupns-mode در دیمن (پیش‌فرض)

--cidfile="" نوشتن شناسه کانتینر درون فایل

--cpu-count=0 تعداد پردازنده (تنها در ویندوز)

--cpu-percent=0 درصد پردازنده (تنها در ویندوز)

--cpu-period=0 محدود کردن دوره CFS (زمان‌بند کاملاً منصفانه) پردازنده

--cpu-quota=0 محدود کردن سهمیه CFS (زمان‌بند کاملاً منصفانه) پردازنده

--cpu-rt-period=0 محدود کردن دوره بی‌درنگ (real-time) پردازنده بر حسب میکروثانیه

--cpu-rt-runtime=0 محدود کردن زمان اجرای بی‌درنگ (real-time) پردازنده بر حسب میکروثانیه

-c, --cpu-shares=0 سهم پردازنده (وزن نسبی)

--cpus= تعداد پردازنده‌ها

--cpuset-cpus="" پردازنده‌های مجاز برای اجرا (0-3, 0,1)

--cpuset-mems="" گره‌های حافظه مجاز برای اجرا (0-3, 0,1)

-d, --detach[=false] اجرای کانتینر در پس‌زمینه و چاپ شناسه کانتینر

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

--device= افزودن دستگاه میزبان به کانتینر

--device-cgroup-rule= افزودن یک قانون به فهرست دستگاه‌های مجاز cgroup

--device-read-bps=[] محدود کردن نرخ خواندن (بایت در ثانیه) از یک دستگاه

--device-read-iops=[] محدود کردن نرخ خواندن (ورودی/خروجی در ثانیه) از یک دستگاه

--device-write-bps=[] محدود کردن نرخ نوشتن (بایت در ثانیه) روی یک دستگاه

--device-write-iops=[] محدود کردن نرخ نوشتن (ورودی/خروجی در ثانیه) روی یک دستگاه

--dns= تنظیم کارسازهای DNS سفارشی

--dns-option= تنظیم گزینه‌های DNS

--dns-search= تنظیم دامنه‌های جستجوی DNS سفارشی

--domainname="" نام دامنه NIS کانتینر

--entrypoint="" بازنویسی ENTRYPOINT پیش‌فرض ایمیج

-e, --env= تنظیم متغیرهای محیطی

--env-file= خواندن فایلی از متغیرهای محیطی

--expose= در دسترس قرار دادن (expose) یک درگاه یا محدوده‌ای از درگاه‌ها

--gpus= دستگاه‌های پردازنده گرافیکی (GPU) جهت افزودن به کانتینر ('all' برای ارسال همه GPUها)

--group-add= افزودن گروه‌های اضافی جهت عضویت

--health-cmd="" دستور جهت اجرا برای بررسی وضعیت سلامت

--health-interval=0s فاصله زمانی بین اجرای بررسی (ms|s|m|h) (پیش‌فرض 0s)

--health-retries=0 تعداد شکست‌های پیاپی لازم برای گزارش ناسالم بودن

--health-start-interval=0s فاصله زمانی بین اجرای بررسی در طول دوره راه‌اندازی (ms|s|m|h) (پیش‌فرض 0s)

--health-start-period=0s دوره راه‌اندازی کانتینر برای مقداردهی اولیه قبل از آغاز شمارش معکوس health-retries بر حسب (ms|s|m|h) (پیش‌فرض 0s)

--health-timeout=0s حداکثر زمان مجاز برای اجرای یک بررسی (ms|s|m|h) (پیش‌فرض 0s)

--help[=false] چاپ نحوه استفاده

-h, --hostname="" نام میزبان کانتینر

--init[=false] اجرای یک فرایند init درون کانتینر جهت هدایت سیگنال‌ها و جمع‌آوری فرایندهای زامبی

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

--io-maxbandwidth=0 حداکثر پهنای باند ورودی/خروجی درایو سیستم (تنها در ویندوز)

--io-maxiops=0 حداکثر سقف IOps برای درایو سیستم (تنها در ویندوز)

--ip= آدرس IPv4 (مانند 172.30.100.104)

--ip6= آدرس IPv6 (مانند 2001:db8::33)

--ipc="" حالت IPC مورد استفاده

--isolation="" فناوری جداسازی کانتینر

-l, --label= تنظیم فراداده (metadata) روی یک کانتینر

--label-file= خواندن فایلی از برچسب‌ها که با خط جدا شده‌اند

--link= افزودن پیوند به کانتینری دیگر

--link-local-ip= آدرس‌های پیوند-محلی (link-local) مربوط به IPv4/IPv6 کانتینر

--log-driver="" راه‌انداز ثبت وقایع (log driver) برای کانتینر

--log-opt= گزینه‌های راه‌انداز ثبت وقایع

--mac-address="" آدرس MAC کانتینر (مانند 92:d0:c6:0a:29:33)

-m, --memory=0 محدودیت حافظه

--memory-reservation=0 محدودیت نرم حافظه

--memory-swap=0 حد حافظه مبادله‌ای (swap) برابر با مجموع حافظه به‌علاوه swap؛ مقدار '-1' برای فعال کردن swap نامحدود

--memory-swappiness=-1 تنظیم میزان مبادله حافظه کانتینر (swappiness) از 0 تا 100

--mount= اتصال یک فایل‌سیستم به کانتینر

--name="" اختصاص یک نام به کانتینر

--network= اتصال یک کانتینر به یک شبکه

--network-alias= افزودن نام مستعار در سطح شبکه برای کانتینر

--no-healthcheck[=false] غیرفعال کردن هرگونه HEALTHCHECK تعیین‌شده توسط کانتینر

--oom-kill-disable[=false] غیرفعال کردن کشنده کمبود حافظه (OOM Killer)

--oom-score-adj=0 تنظیم اولویت‌های OOM میزبان (از -1000 تا 1000)

--pid="" فضای نام PID مورد استفاده

--pids-limit=0 تنظیم محدودیت تعداد شناسه‌های فرایند (pids) کانتینر (مقدار -1 برای نامحدود)

--platform="" تنظیم پلتفرم در صورتی که کارساز قابلیت چندپلتفرمی داشته باشد

--privileged[=false] اعطای دسترسی‌های گسترده به این کانتینر

-p, --publish= انتشار درگاه(های) کانتینر روی میزبان

-P, --publish-all[=false] انتشار تمامی درگاه‌های در دسترس به درگاه‌های تصادفی

--pull="missing" دریافت ایمیج پیش از اجرا ("always"، "missing"، "never")

-q, --quiet[=false] بی‌صدا کردن خروجی دریافت ایمیج

--read-only[=false] سوار کردن فایل‌سیستم ریشه کانتینر به‌صورت فقط‌خواندنی

--restart="no" سیاست راه‌اندازی مجدد هنگام خروج کانتینر

--rm[=false] حذف خودکار کانتینر و حجم‌های ناشناس وابسته به آن پس از خروج

--runtime="" زمان اجرا (runtime) مورد استفاده برای این کانتینر

--security-opt= گزینه‌های امنیتی

--shm-size=0 اندازه مسیر /dev/shm

--sig-proxy[=true] هدایت تمام سیگنال‌های دریافتی به فرایند

--stop-signal="" سیگنال متوقف کردن کانتینر

--stop-timeout=0 مهلت زمانی (بر حسب ثانیه) برای متوقف کردن کانتینر

--storage-opt= گزینه‌های راه‌انداز ذخیره‌سازی برای کانتینر

--sysctl=map[] گزینه‌های sysctl

--tmpfs= سوار کردن یک دایرکتوری tmpfs

-t, --tty[=false] تخصیص یک شبه-TTY

--ulimit=[] گزینه‌های ulimit

--use-api-socket[=false] سوار کردن سوکت Docker API و احراز هویت لازم به‌صورت bind mount

-u, --user="" نام کاربری یا شناسه کاربری UID (قالب: <name|uid>[:<group|gid>])

--userns="" فضای نام کاربر مورد استفاده

--uts="" فضای نام UTS مورد استفاده

-v, --volume= سوار کردن یک حجم به‌صورت bind mount

--volume-driver="" راه‌انداز حجم اختیاری برای کانتینر

--volumes-from= سوار کردن حجم‌ها از کانتینر(های) مشخص‌شده

-w, --workdir="" دایرکتوری کاری درون کانتینر

docker-container(1)

Aug 2026 Docker Community