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

.SH "نام (NAME)"
docker-volume-create \- ایجاد یک حجم (Volume) جدید


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


.SH "شرح (DESCRIPTION)"
یک حجم (volume) جدید ایجاد می‌کند که کانتینرها می‌توانند از آن استفاده کرده و داده‌ها را درون آن ذخیره کنند. اگر نامی مشخص نشود، Docker یک نام تصادفی تولید می‌کند. شما ابتدا یک حجم ایجاد می‌کنید و سپس کانتینر را برای استفاده از آن پیکربندی می‌نمایید؛ به عنوان مثال:

.EX
$ docker volume create hello
hello
$ docker run -d -v hello:/world busybox ls /world
.EE

.PP
نقطه اتصال (mount) درون دایرکتوری \fB/src\fR کانتینر ایجاد می‌شود. Docker از مسیرهای نسبی برای نقاط اتصال درون کانتینر پشتیبانی نمی‌کند.

.PP
چندین کانتینر می‌توانند در بازه زمانی یکسان از یک حجم مشترک استفاده کنند. این قابلیت زمانی مفید است که دو کانتینر نیاز به دسترسی به داده‌های مشترک داشته باشند؛ برای مثال، هنگامی که یک کانتینر داده‌ها را می‌نویسد و کانتینر دیگر آن‌ها را می‌خواند.

.SH "گزینه‌های اختصاصی درایور (Driver specific options)"
برخی از درایورهای حجم ممکن است گزینه‌هایی را برای سفارشی‌سازی نحوه ایجاد حجم دریافت کنند. از فلگ‌های \fB-o\fR یا \fB--opt\fR برای ارسال گزینه‌های درایور استفاده کنید:

.EX
$ docker volume create --driver fake --opt tardis=blue --opt timey=wimey
.EE

.PP
این گزینه‌ها مستقیماً به درایور حجم ارسال می‌شوند. گزینه‌های مربوط به درایورهای مختلف حجم ممکن است کارهای متفاوتی انجام دهند (یا اصلاً هیچ کاری انجام ندهند).

.PP
درایور پیش‌ساخته \fBlocal\fR در Windows از هیچ گزینه‌ای پشتیبانی نمی‌کند.

.PP
درایور پیش‌ساخته \fBlocal\fR در Linux گزینه‌هایی مشابه دستور \fBmount\fR لینوکس را می‌پذیرد:

.EX
$ docker volume create --driver local --opt type=tmpfs --opt device=tmpfs --opt o=size=100m,uid=1000
.EE

.PP
مثالی دیگر:

.EX
$ docker volume create --driver local --opt type=btrfs --opt device=/dev/sda2
.EE


.SH "گزینه‌ها (OPTIONS)"
\fB--availability\fP="active"
	در دسترس بودن حجم کلاستر (Cluster Volume) ("active"، "pause"، "drain")

.PP
\fB-d\fP, \fB--driver\fP="local"
	مشخص کردن نام درایور حجم

.PP
\fB--group\fP=""
	گروه حجم کلاستر (cluster volumes)

.PP
\fB--label\fP=
	تنظیم متاداده برای یک حجم

.PP
\fB--limit-bytes\fP=0
	حداقل اندازه حجم کلاستر (Cluster Volume) به بایت

.PP
\fB-o\fP, \fB--opt\fP=map[]
	تنظیم گزینه‌های اختصاصی درایور

.PP
\fB--required-bytes\fP=0
	حداکثر اندازه حجم کلاستر (Cluster Volume) به بایت

.PP
\fB--scope\fP="single"
	دامنه دسترسی حجم کلاستر ("single"، "multi")

.PP
\fB--secret\fP=map[]
	سکرت‌های حجم کلاستر (Cluster Volume secrets)

.PP
\fB--sharing\fP="none"
	اشتراک‌گذاری دسترسی حجم کلاستر ("none"، "readonly"، "onewriter"، "all")

.PP
\fB--topology-preferred\fP=
	توپولوژی ترجیحی که حجم کلاستر ترجیحاً در آن قرار گیرد

.PP
\fB--topology-required\fP=
	توپولوژی لازم که حجم کلاستر باید حتماً از آن قابل دسترس باشد

.PP
\fB--type\fP="block"
	نوع دسترسی حجم کلاستر ("mount"، "block")


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