DOCKER(1) Docker User Manuals DOCKER(1)

docker-volume-create - ایجاد یک حجم (Volume) جدید

docker volume create [OPTIONS] [VOLUME]

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

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

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

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

برخی از درایورهای حجم ممکن است گزینه‌هایی را برای سفارشی‌سازی نحوه ایجاد حجم دریافت کنند. از فلگ‌های -o یا --opt برای ارسال گزینه‌های درایور استفاده کنید:

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

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

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

درایور پیش‌ساخته local در Linux گزینه‌هایی مشابه دستور mount لینوکس را می‌پذیرد:

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

مثالی دیگر:

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

--availability="active" در دسترس بودن حجم کلاستر (Cluster Volume) ("active"، "pause"، "drain")

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

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

--label= تنظیم متاداده برای یک حجم

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

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

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

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

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

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

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

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

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

docker-volume(1)

Aug 2026 Docker Community