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

.SH "نام (NAME)"
docker-create \- ایجاد یک کانتینر جدید


.SH "خلاصه (SYNOPSIS)"
\fBdocker create [OPTIONS] IMAGE [COMMAND] [ARG...]\fP


.SH "شرح (DESCRIPTION)"
نام مستعار برای \fBdocker container create\fR\&.


.SH "گزینه‌ها (OPTIONS)"
\fB--add-host\fP=
	افزودن نگاشت سفارشی میزبان به آی‌پی (host:ip)

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

.PP
\fB-a\fP, \fB--attach\fP=
	اتصال به STDIN، STDOUT یا STDERR

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

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

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

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

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

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

.PP
\fB--cidfile\fP=""
	نوشتن شناسه کانتینر درون فایل

.PP
\fB--cpu-count\fP=0
	تعداد پردازنده (تنها در ویندوز)

.PP
\fB--cpu-percent\fP=0
	درصد پردازنده (تنها در ویندوز)

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

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

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

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

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

.PP
\fB--cpus\fP=
	تعداد پردازنده‌ها

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

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

.PP
\fB--device\fP=
	افزودن دستگاه میزبان به کانتینر

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

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

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

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

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

.PP
\fB--dns\fP=
	تنظیم کارسازهای DNS سفارشی

.PP
\fB--dns-option\fP=
	تنظیم گزینه‌های DNS

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

.PP
\fB--domainname\fP=""
	نام دامنه NIS کانتینر

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

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

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

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

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

.PP
\fB--group-add\fP=
	افزودن گروه‌های اضافی جهت عضویت

.PP
\fB--health-cmd\fP=""
	دستور جهت اجرا برای بررسی وضعیت سلامت

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

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

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

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

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

.PP
\fB--help\fP[=false]
	چاپ نحوه استفاده

.PP
\fB-h\fP, \fB--hostname\fP=""
	نام میزبان کانتینر

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

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

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

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

.PP
\fB--ip\fP=
	آدرس IPv4 (مانند 172.30.100.104)

.PP
\fB--ip6\fP=
	آدرس IPv6 (مانند 2001:db8::33)

.PP
\fB--ipc\fP=""
	حالت IPC مورد استفاده

.PP
\fB--isolation\fP=""
	فناوری جداسازی کانتینر

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

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

.PP
\fB--link\fP=
	افزودن پیوند به کانتینری دیگر

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

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

.PP
\fB--log-opt\fP=
	گزینه‌های راه‌انداز ثبت وقایع

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

.PP
\fB-m\fP, \fB--memory\fP=0
	محدودیت حافظه

.PP
\fB--memory-reservation\fP=0
	محدودیت نرم حافظه

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

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

.PP
\fB--mount\fP=
	اتصال یک فایل‌سیستم به کانتینر

.PP
\fB--name\fP=""
	اختصاص یک نام به کانتینر

.PP
\fB--network\fP=
	اتصال یک کانتینر به یک شبکه

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

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

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

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

.PP
\fB--pid\fP=""
	فضای نام PID مورد استفاده

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

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

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

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

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

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

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

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

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

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

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

.PP
\fB--security-opt\fP=
	گزینه‌های امنیتی

.PP
\fB--shm-size\fP=0
	اندازه مسیر /dev/shm

.PP
\fB--stop-signal\fP=""
	سیگنال متوقف کردن کانتینر

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

.PP
\fB--storage-opt\fP=
	گزینه‌های راه‌انداز ذخیره‌سازی برای کانتینر

.PP
\fB--sysctl\fP=map[]
	گزینه‌های sysctl

.PP
\fB--tmpfs\fP=
	سوار کردن یک دایرکتوری tmpfs

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

.PP
\fB--ulimit\fP=[]
	گزینه‌های ulimit

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

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

.PP
\fB--userns\fP=""
	فضای نام کاربر مورد استفاده

.PP
\fB--uts\fP=""
	فضای نام UTS مورد استفاده

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

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

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

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


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