SSD Nodes Learn Hosting plans →
راهنماها Matt Connorتوسط Matt Connor · به‌روزرسانی شده 2026-10-15

آموزش آزادسازی فضای دیسک در Docker با دستور prune

اگر دیسک VPS شما توسط Docker پر شده است، با دستور docker system df منابع اشغال شده را شناسایی کنید. این راهنما نحوه پاکسازی ایمیج، کانتینر و کش بدون حذف داده‌های حیاتی را آموزش می‌دهد.

پیش از هرگونه پاک‌سازی، بررسی کنید چه چیزی فضای دیسک را اشغال کرده است

Docker فضای دیسک را در یک VPS در چهار بخش اشغال می‌کند: ایمیج‌ها، کانتینرهای متوقف‌شده، کشِ ساخت (build cache) و ولوم‌های محلی. ابتدا docker system df را اجرا کنید تا مشخص شود کدام بخش فضا را اشغال کرده است، سپس محدودترین دستور prune را برای آزادسازی آن اجرا کنید. ترتیب اهمیت دارد، زیرا آخرین دستور در این راهنما، یعنی docker volume prune -a، داده‌ها را حذف می‌کند و امکان بازگردانی وجود ندارد.

با سیستم فایل شروع کنید، نه با Docker.

df -h /
sudo du -xh --max-depth=1 /var/lib/docker | sort -h
sudo du -xh --max-depth=1 /var/lib/containerd | sort -h

دستور df به شما می‌گوید وضعیت چقدر بحرانی است. دستور du مشخص می‌کند فضا کجا رفته است. فلگ -x باعث می‌شود du در همان سیستم فایل باقی بماند تا از mountها به ولوم‌های جداگانه عبور نکند و فضا را دو بار محاسبه نکند. اینکه کدام دایرکتوری‌ها اهمیت دارند به backend ذخیره‌سازی بستگی دارد. در نصب تازه Docker Engine 29.0 یا نسخه‌های بعد از آن، image store از نوع containerd پیش‌فرض است و محتوای ایمیج‌ها و snapshotهای کانتینر در /var/lib/containerd قرار دارند؛ به همین دلیل خط دوم du وجود دارد. در هر دو backend، دو دایرکتوری در /var/lib/docker مهم هستند: volumes که داده‌های ولوم را نگه می‌دارد و containers که متادیتای کانتینر و فایل‌های لاگ را در خود جای می‌دهد. میزبانی که از نسخه قدیمی Docker ارتقا یافته باشد، ساختار کلاسیک overlay2 را تا زمانی که آن را تغییر ندهید حفظ می‌کند و در آن ساختار، سه دایرکتوری دیگر نیز مهم هستند: overlay2 که لایه‌های ایمیج و کانتینر را نگه می‌دارد، buildkit که کشِ ساخت را در خود دارد و image که متادیتای لایه‌ها را ذخیره می‌کند. دستور docker info | grep -i driver-type در image store از نوع containerd مقدار io.containerd.snapshotter.v1 را چاپ می‌کند و برای overlay2 چیزی نمایش نمی‌دهد. image store از نوع containerd هم نسخه فشرده و هم نسخه استخراج‌شده هر لایه را نگه می‌دارد، بنابراین ایمیج‌های یکسان نسبت به حالت overlay2 فضای بیشتری از دیسک را اشغال می‌کنند.

نکته‌ای درباره sudo و wildcardهای shell، زیرا باعث اتلاف وقت بسیاری از کاربران می‌شود. مالکیت /var/lib/docker متعلق به root است و توسط کاربر معمولی شما قابل خواندن نیست، بنابراین ls /var/lib/docker مقدار Permission denied را برمی‌گرداند. دستوری مانند sudo du -sh /var/lib/docker/* نیز با شکست مواجه می‌شود، زیرا shell شما پیش از اجرای sudo، کاراکتر * را بسط می‌دهد و shell شما اجازه خواندن آن دایرکتوری را ندارد. به همین دلیل، تمام دستورات زیر به‌جای wildcard از find یا --max-depth استفاده می‌کنند.

اکنون دیدگاه خودِ Docker را بررسی کنید.

docker system df
TYPE            TOTAL     ACTIVE    SIZE      RECLAIMABLE
Images          24        6         12.4GB    8.91GB (71%)
Containers      31        6         1.42GB    1.39GB (97%)
Local Volumes   14        5         6.03GB    4.11GB (68%)
Build Cache     212       0         9.87GB    9.87GB

این ارقام مربوط به یک ماشین خاص هستند و درباره ماشین شما چیزی نمی‌گویند. به ساختار خروجی توجه کنید. TOTAL تعداد آبجکت‌ها را می‌شمارد، ACTIVE تعداد مواردی که در حال حاضر در حال استفاده هستند را نشان می‌دهد و RECLAIMABLE برآورد Docker از فضایی است که با یک دستور prune در آن ردیف آزاد می‌شود.

دو نکته درباره RECLAIMABLE وجود دارد که کاربران را به اشتباه می‌اندازد. این دستور لایه‌های ایمیج مشترک را برای هر ایمیجی که از آن‌ها استفاده می‌کند یک بار می‌شمارد، بنابراین ردیف ایمیج معمولاً فضایی بیش از آنچه واقعاً آزاد می‌شود را وعده می‌دهد. همچنین این دستور هرگز فایل‌های لاگ کانتینر را شامل نمی‌شود، زیرا Docker فایل لاگ را به عنوان یک آبجکت قابل بازیافت در نظر نمی‌گیرد. زمانی که du دایرکتوری بسیار بزرگ‌تری نسبت به آنچه docker system df گزارش می‌دهد نشان می‌دهد، دلیل آن فایل‌های لاگ هستند و در ادامه بخشی درباره آن وجود دارد.

برای مشاهده جزئیات به تفکیک هر آبجکت، -v را اضافه کنید.

docker system df -v

این کار خلاصه را به بخش‌های مجزا برای هر نوع آبجکت تقسیم می‌کند. بخش ایمیج‌ها ستون‌های SHARED SIZE و UNIQUE SIZE را اضافه می‌کند تا بتوانید هزینه واقعی یک ایمیج خاص را ببینید. بخش ولوم‌ها یک شمارنده LINKS اضافه می‌کند که تعداد کانتینرهای متصل به آن ولوم است. LINKS را به خاطر بسپارید، زیرا مقدار 0 به این معنی است که هیچ کانتینری از آن ولوم استفاده نمی‌کند و این همان شرطی است که هر دستور prune ولوم از آن شروع می‌شود.

تصاویر معلق (Dangling) در مقابل تصاویر استفاده‌نشده (Unused)

این دو عبارت ممکن است مترادف به نظر برسند، اما چنین نیستند. رفتار فیلترها متفاوت است زیرا ماهیت اشیاء با هم فرق دارد.

تصویر معلق (Dangling)، تصویری است که هیچ برچسبی (Tag) ندارد. این تصاویر در خروجی docker images با مقدار <none> نمایش داده می‌شوند. شما با هر بار بازسازی (Rebuild)، یکی از آن‌ها را ایجاد می‌کنید: docker build -t myapp:latest . برچسب myapp:latest را به تصویر جدید منتقل می‌کند و تصویر قدیمی تمام لایه‌های خود را حفظ می‌کند اما نامش را از دست می‌دهد. هیچ‌چیز به آن ارجاع نمی‌دهد و هیچ فرآیندی به‌طور خودکار آن را پاکسازی نمی‌کند.

تصویر استفاده‌نشده (Unused)، هر تصویری است—چه برچسب‌دار و چه بدون برچسب—که در حال حاضر هیچ کانتینری به آن ارجاع نمی‌دهد. یک postgres:16 که ماه گذشته دریافت (Pull) کرده‌اید و هیچ کانتینری (چه در حال اجرا و چه متوقف‌شده) به آن اشاره نمی‌کند، استفاده‌نشده محسوب می‌شود و لزوماً معلق نیست.

docker image prune        # dangling images only
docker image prune -a     # every image no container refers to

دومی ابتدا سوال می‌پرسد.

WARNING! This will remove all images without at least one container associated to them.
Are you sure you want to continue? [y/N]

آن اعلان را با دقت بخوانید. عبارت "Associated to them" به یک شیء کانتینر موجود اشاره دارد، چه در حال اجرا باشد و چه متوقف شده باشد. اگر دستور docker compose down را اجرا کرده باشید، کانتینرها حذف شده‌اند؛ بنابراین تمام تصاویری که آن سرویس‌ها استفاده می‌کردند اکنون استفاده‌نشده هستند و -a همه آن‌ها را پاک می‌کند. هیچ‌چیز غیرقابل‌بازگشتی از دست نمی‌رود، اما دستور docker compose up -d بعدی، تمام آن‌ها را دوباره دریافت یا بازسازی می‌کند که این کار باعث مصرف پهنای باند و صرف زمان برای ساخت در یک VPS کوچک می‌شود. این یکی از دلایل عملی برای درک تفاوت حذف با docker compose down و آنچه با stop باقی می‌ماند پیش از اجرای هرگونه عملیات پاکسازی (Prune) است.

یک فیلتر، تصاویر اخیر را از محدوده عملیاتی خارج نگه می‌دارد.

docker image prune -a --filter "until=240h"

این دستور، تصاویر استفاده‌نشده‌ای که بیش از 240 ساعت (10 روز) پیش ایجاد شده‌اند را حذف می‌کند و تصاویر جدیدتر را دست‌نخورده باقی می‌گذارد. مقدار until یک رشته زمانی Go مانند 240h یا یک مهر زمانی مطلق مانند 2026-08-01T00:00:00 را می‌پذیرد.

کش ساخت (build cache) چیست و چرا حجم آن تا این حد افزایش می‌یابد

BuildKit ابزار ساخت پیش‌فرضی است که Docker از نسخه Docker Engine 23.0 برای docker build و docker compose build استفاده می‌کند. این ابزار نتیجهٔ هر مرحله از هر Dockerfile که اجرا می‌کند را کش می‌کند و در ساختار کلاسیک overlay2، این کش را در مسیر /var/lib/docker/buildkit نگه می‌دارد. دلیل این‌که ساخت دوم شما در چند ثانیه به پایان می‌رسد، همین کش است؛ بنابراین وظیفهٔ خود را به‌درستی انجام می‌دهد. Docker Engine به‌صورت پیش‌فرض عملیات garbage collection را روی آن اجرا می‌کند: کش‌هایی که تا 60 روز استفاده نشده‌اند حذف می‌شوند و مابقی تنها زمانی پاکسازی می‌شوند که از محدودیت‌هایی که Docker Engine بر اساس حجم دیسک محاسبه کرده است، فراتر روند. در یک VPS کوچک، این یعنی دیسک ممکن است از قبل تا حد زیادی پر شده باشد. اگر یک ایمیج را پنجاه بار با مرحله‌ای مانند COPY که هر بار تغییر می‌کند بسازید، تا زمانی که عملیات پاکسازی فعال نشود، پنجاه مجموعه از لایه‌ها را در دیسک نگه می‌دارید.

کش ساخت برای docker image prune نامرئی است. این یک نوع شیء مجزا با دستور اختصاصی خود است.

docker builder prune                        # dangling cache
docker builder prune -a                     # all unused cache
docker builder prune --filter until=168h    # cache untouched for 7 days

هیچ‌کدام از این دستورات ایمیج‌ها یا داده‌های شما را تحت تأثیر قرار نمی‌دهند. تنها هزینهٔ پاکسازی کش ساخت این است که ساخت بعدی یک‌بار به‌کندی انجام می‌شود. در یک VPS که به‌طور مرتب ایمیج‌ها را بازسازی می‌کند، Build Cache اغلب بزرگ‌ترین ردیف در docker system df است و همین موضوع آن را به امن‌ترین مورد حجیمی تبدیل می‌کند که می‌توانید حذف کنید.

دستورات prune، مرتب‌شده از ایمن تا مخرب

این فهرست را به ترتیب دنبال کنید و به محض اینکه df -h / دوباره سالم به نظر رسید، متوقف شوید. هر دستور پس از پایان کار، یک خط Total reclaimed space: چاپ می‌کند.

  1. docker container prune کانتینرهای متوقف‌شده را حذف می‌کند. لایه‌های قابل‌نوشتن آن‌ها نیز پاک می‌شوند، بنابراین هر چیزی که کانتینر خارج از یک volume نوشته باشد، همراه با آن حذف خواهد شد. به volumeها دست زده نمی‌شود.
  2. docker image prune فقط imageهای معلق (dangling) را حذف می‌کند. این ایمن‌ترین دستور برای imageها است.
  3. docker builder prune کش ساخت (build cache) معلق را حذف می‌کند. هزینه آن، یک بار build کندتر در آینده است.
  4. docker image prune -a تمام imageهایی که هیچ کانتینری به آن‌ها ارجاع نمی‌دهد را حذف می‌کند. هزینه آن، نیاز به pull یا build مجدد است.
  5. docker system prune سه مورد اول را هم‌زمان انجام داده و شبکه‌های استفاده‌نشده را نیز اضافه می‌کند.
  6. docker volume prune volumeهای ناشناس (anonymous) استفاده‌نشده را حذف می‌کند.
  7. docker volume prune -a volumeهای استفاده‌نشده، شامل volumeهای نام‌گذاری‌شده را حذف می‌کند. این دستوری است که پایگاه‌های داده را حذف می‌کند.

docker system prune پیش از اجرا، محدوده عملکرد خود را اعلام می‌کند.

WARNING! This will remove:
        - all stopped containers
        - all networks not used by at least one container
        - all dangling images
        - unused build cache
Are you sure you want to continue? [y/N]

volumeها عمداً از آن فهرست حذف شده‌اند. افزودن --volumes، volumeهای ناشناس را به محدوده عملیات بازمی‌گرداند. افزودن -a، مرحله imageها را از imageهای معلق به تمام imageهای استفاده‌نشده گسترش می‌دهد. اجرای یک docker system prune -a --volumes -f کامل روی یک میزبان عملیاتی (production)، روشی است که افراد در حین تلاش برای آزادسازی فضا، داده‌های خود را از دست می‌دهند.

چرا پاک‌سازی (pruning) ولوم‌ها باعث حذف دیتابیس شما می‌شود

این بخشی است که باید دو بار بخوانید.

یک ولوم زمانی «استفاده‌نشده» (unused) تلقی می‌شود که هیچ کانتینری به آن متصل نباشد. این تنها معیار بررسی است. Docker بررسی نمی‌کند که آیا ولوم خالی است، آیا یک فایل compose همچنان آن را تعریف کرده است، یا اینکه آیا تنها نسخه از دیتابیس شما در آن قرار دارد. LINKS 0 در docker system df -v به معنای استفاده‌نشده است و docker volume prune -a با هر ولوم استفاده‌نشده‌ای به عنوان یک منبع قابل حذف برخورد می‌کند، مگر اینکه فیلتر label که شما اضافه کرده‌اید، آن را مستثنی کند.

اکنون دو اقدام متداول را پشت سر هم در نظر بگیرید. شما دستور docker compose down را برای راه‌اندازی مجدد و تمیز یک stack اجرا می‌کنید. این دستور کانتینرها را حذف می‌کند و ولوم‌های نام‌گذاری‌شده (named volumes) را باقی می‌گذارد؛ دقیقاً همان‌طور که مستندات آن بیان کرده است. ولوم Postgres شما اکنون به هیچ‌چیز متصل نیست. ده دقیقه بعد، شما دستور docker volume prune -a را برای آزادسازی فضا اجرا می‌کنید و دیتابیس از بین می‌رود. هر دو دستور به درستی عمل کرده‌اند. این توالی باعث نابودی داده‌ها شده است.

از نسخه Docker Engine 23.0 (نسخه API 1.42) به بعد، دستور ساده پاک‌سازی محدودتر از گذشته شده است.

WARNING! This will remove anonymous local volumes not used by at least one container.

یک ولوم ناشناس (anonymous volume) ولومی است که Docker برای شما ایجاد کرده است، معمولاً به این دلیل که یک image دستور VOLUME را اعلام کرده و شما نامی برای آن تعیین نکرده‌اید. این ولوم‌ها معمولاً داده‌هایی را نگه می‌دارند که شما درخواست نگهداری آن‌ها را نداشته‌اید. یک ولوم نام‌گذاری‌شده، یعنی همان نوعی که در فایل compose خود نوشته‌اید، تنها زمانی حذف می‌شود که شما پرچم -a را اضافه کنید. نسخه‌های قدیمی‌تر Docker هر دو نوع را با دستور ساده حذف می‌کردند، بنابراین به عادت‌هایی که در سیستمی قدیمی شکل گرفته و اکنون آن را ارتقا داده‌اید، اعتماد نکنید. این تفاوت تنها زمانی معنا پیدا می‌کند که بدانید ولوم‌های نام‌گذاری‌شده چه تفاوتی با bind mountها دارند، زیرا یک bind mount اصلاً یک ولوم Docker نیست و هیچ دستور prune هرگز به آن دسترسی نخواهد داشت.

پیش از حذف، بررسی کنید. به جای myapp_pgdata، نام ولومی که در حال بررسی آن هستید را قرار دهید.

docker volume ls -f dangling=true
docker volume inspect myapp_pgdata
sudo ls -la /var/lib/docker/volumes/myapp_pgdata/_data

فیلتر dangling=true روی یک ولوم به معنای بدون ارجاع (unreferenced) است، نه خالی. لیست کردن _data به شما نشان می‌دهد که واقعاً چه چیزی در داخل آن وجود دارد. اگر یک دایرکتوری pgdata یا mysql در آن پیدا کردید، متوقف شوید و پیش از هر اقدام دیگری، یک کپی از آن تهیه کنید. همین تخریب از طریق docker compose down -v نیز رخ می‌دهد که ولوم‌های نام‌گذاری‌شده‌ای که در فایل compose تعریف شده‌اند را حذف می‌کند (به جز مواردی که با external علامت‌گذاری شده‌اند) و پیش از آن هیچ سوالی از شما نمی‌پرسد.

ولوم تنها چیزی در یک میزبان Docker است که با بازسازی (rebuild) قابل بازیابی نیست. به همین دلیل است که داده‌های ولوم باید در یک نسخه پشتیبان restic که خارج از سرور اجرا می‌شود قرار بگیرند، جایی که یک پرچم اشتباه تایپ‌شده نتواند به آن دسترسی پیدا کند.

وقتی هیچ‌چیز پاک نمی‌شود: فایل‌های لاگ کانتینر

شما همه چیز را پاکسازی کرده‌اید، docker system df تقریباً هیچ فضای قابل‌بازگشتی را نشان نمی‌دهد و دیسک همچنان پر است. لاگ‌ها را بررسی کنید.

sudo find /var/lib/docker/containers -name '*-json.log' -exec du -h {} + | sort -h | tail -10

هر کانتینر خروجی استاندارد و خطای استاندارد خود را در یک فایل JSON در مسیر /var/lib/docker/containers/ می‌نویسد. در نصب پیش‌فرض، max-size تنظیم نشده است که به معنای نامحدود بودن آن است؛ بنابراین یک کانتینر که در حلقهٔ crash گیر کرده باشد، تا زمانی که پارتیشن پر شود به نوشتن ادامه می‌دهد. هیچ دستور پاکسازی این فایل‌ها را حذف نمی‌کند، زیرا کانتینرهایی که آن‌ها را تولید می‌کنند در حال اجرا هستند و طبق تعریف، قابل پاکسازی نیستند.

فایل را حذف نکنید. اجرای rm روی یک فایل لاگ باز، هیچ فضایی را آزاد نمی‌کند، زیرا Docker daemon همچنان یک file descriptor باز نگه می‌دارد و هسته تا زمانی که آن handle بسته نشود، بلوک‌ها را تخصیص‌یافته نگه می‌دارد. df اصلاً تغییر نخواهد کرد. به‌جای آن، فایل را truncate کنید؛ این کار inode را ثابت نگه می‌دارد و به daemon اجازه می‌دهد به نوشتن ادامه دهد.

sudo find /var/lib/docker/containers -name '*-json.log' -exec truncate -s 0 {} +
df -h /

این یک راهکار موقت است. docker logs برای آن کانتینرها اکنون چیزی برنمی‌گرداند و فایل‌ها بلافاصله دوباره شروع به رشد می‌کنند. راهکار اصلی، چرخش لاگ (rotation) است که در بخش بعدی آمده است.

اندازه‌گیری قبل و بعد، همیشه

هرگز حدس نزنید که عملیات prune چه تغییری ایجاد کرده است. ابتدا یک اندازه‌گیری انجام دهید، دستور را اجرا کنید و سپس اندازه‌گیری مجدد را انجام دهید.

df -h /
docker system df
docker builder prune -f --filter until=168h
docker image prune -f
docker system df
df -h /

خروجی‌های df را با هم مقایسه کنید. این تنها عددی است که تعیین می‌کند آیا سرور شما به سرویس‌دهی ادامه می‌دهد یا خیر. سپس docker system df به شما می‌گوید که کدام ردیف واقعاً جابه‌جا شده است و هر عملیات prune، مقدار Total reclaimed space: مربوط به خود را چاپ می‌کند.

اگر df تغییری نکرد اما docker system df نشان می‌دهد که فضا آزاد شده است، یک file handle باز، بلوک‌های حذف‌شده را نگه داشته است که همان مشکل فایل لاگ ذکر شده در بالا است. اگر هر دو تغییر کردند و دیسک ظرف یک روز دوباره پر شد، شما با مشکل رشد داده‌ها مواجه هستید، نه مشکل پاک‌سازی؛ و راه‌حل آن چرخش لاگ‌ها (rotation) به همراه یک job زمان‌بندی‌شده است.

چگونه از پر شدن مجدد دیسک جلوگیری کنیم

محدودیت حجم لاگ‌ها را تعیین کنید. فایل /etc/docker/daemon.json را ایجاد یا ویرایش کنید.

{
  "log-driver": "json-file",
  "log-opts": {
    "max-size": "10m",
    "max-file": "3"
  }
}

این تنظیمات باعث می‌شود حجم لاگ هر کانتینری که پس از راه‌اندازی مجدد ایجاد می‌شود، به 30 مگابایت محدود شود. تمام مقادیر در log-opts باید به صورت رشته (string) باشند، حتی مقادیر عددی. پیش از راه‌اندازی مجدد، صحت فایل را بررسی کنید، زیرا یک فایل daemon.json با فرمت نادرست باعث می‌شود daemon اصلاً اجرا نشود و تمام کانتینرها از دسترس خارج شوند.

python3 -m json.tool /etc/docker/daemon.json
sudo systemctl restart docker
docker info | grep -i 'logging driver'

docker info اکنون باید Logging Driver: json-file را گزارش دهد. محدودیت‌ها در بخش LogConfig از خروجی docker inspect برای کانتینرهایی که پس از راه‌اندازی مجدد ایجاد شده‌اند، قابل مشاهده است. این نکته مهمی است: این تنظیم فقط برای کانتینرهای جدید اعمال می‌شود. کانتینرهای موجود، پیکربندی زمان ساخت خود را حفظ می‌کنند، بنابراین باید آن‌ها را دوباره ایجاد کنید.

docker compose up -d --force-recreate

همین محدودیت را می‌توان برای هر سرویس در فایل compose نیز اعمال کرد؛ این روش زمانی که یک سرویس پرمصرف نیاز به مقدار متفاوتی دارد، انتخاب بهتری است.

services:
  app:
    logging:
      driver: json-file
      options:
        max-size: "10m"
        max-file: "3"

یک پاک‌سازی محدود زمان‌بندی کنید. به‌صورت هفتگی، پاک‌سازی را فقط به تصاویر معلق (dangling images) و کش قدیمی build محدود کنید. هرگز -a یا --volumes را در یک job زمان‌بندی‌شده قرار ندهید، زیرا اگر job زمانی اجرا شود که یک stack غیرفعال است، تصاویر آن stack را حذف می‌کند و با وجود --volumes، داده‌های شما را نیز پاک خواهد کرد.

sudo tee /etc/cron.weekly/docker-prune >/dev/null <<'EOF'
#!/bin/sh
docker image prune -f
docker builder prune -f --filter until=168h
EOF
sudo chmod +x /etc/cron.weekly/docker-prune
sudo /etc/cron.weekly/docker-prune

خط آخر، اسکریپت را یک بار به‌صورت دستی اجرا می‌کند تا پیش از اجرای خودکار، خروجی آن را مشاهده کنید. فایل باید قابل‌اجرا (executable) باشد و نام آن نباید شامل نقطه باشد، زیرا run-parts فایل‌های غیرقابل‌اجرا و فایل‌هایی که دارای پسوند هستند را نادیده می‌گیرد.

برای فضای خالی دیسک هشدار تنظیم کنید. پاک‌سازی پس از پر شدن دیسک، یک اقدام بازیابی است. هشدار در 80 درصد، یک اقدام پیشگیرانه است.

usage=$(df --output=pcent / | tr -dc '0-9')
[ "$usage" -ge 80 ] && echo "root filesystem at ${usage} percent full"

این دستور را در cron با هر سیستم اطلاع‌رسانی که استفاده می‌کنید، قرار دهید. فضای خالی تنها نیمی از تصویر است، بنابراین این هشدار را با مانیتورینگ سلامت دیسک در VPS ترکیب کنید، زیرا خرابی دیسک و پر شدن دیسک هر دو باعث توقف کانتینرها می‌شوند اما هر کدام به راه‌حل متفاوتی نیاز دارند.

تمام موارد فوق فرض را بر نصب استاندارد با ریشه داده در /var/lib/docker می‌گذارند. اگر آن را با کلید data-root در daemon.json جابه‌جا کرده‌اید، در تمام دستورات مسیر خود را جایگزین کنید. در image store مربوط به containerd، دستور data-root داده‌های تصاویر و کانتینرها را در /var/lib/containerd جابه‌جا نمی‌کند، زیرا آن مکان توسط root در /etc/containerd/config.toml تعیین می‌شود. تنظیم صحیح این ساختار در یک سرور تازه، بخشی از راه‌اندازی Docker روی VPS است و تصمیم‌گیری در مورد آن پیش از اینکه 40 گیگابایت کانتینر روی پارتیشن اشتباه داشته باشید، بسیار آسان‌تر است.

FAQ

آیا دستور docker system prune حجم‌های (volumes) من را حذف می‌کند؟

خیر. دستور سادهٔ آن فقط کانتینرهای متوقف‌شده، شبکه‌های بدون استفاده، ایمیج‌های معلق (dangling) و کش ساخت (build cache) بلااستفاده را حذف می‌کند و اعلان تأیید آن دقیقاً همین موارد را فهرست می‌کند. حجم‌ها فقط زمانی در محدودهٔ حذف قرار می‌گیرند که از --volumes استفاده کنید، و از نسخهٔ Docker Engine 23.0 به بعد، این فلگ فقط شامل حجم‌های بی‌نام (anonymous) می‌شود و حجم‌های نام‌گذاری‌شده را در بر نمی‌گیرد. حجم‌های نام‌گذاری‌شده توسط docker volume prune -a و docker compose down -v حذف می‌شوند. این دو دستور همان مواردی هستند که باید هنگام استفاده از آن‌ها دقت کنید.

چرا پس از اجرای docker prune دیسک من همچنان پر است؟

دو دلیل معمول برای این اتفاق وجود دارد. دلیل اول فایل‌های لاگ کانتینر در مسیر /var/lib/docker/containers/ هستند که هیچ دستور prune به آن‌ها دسترسی ندارد و تا زمانی که max-size را تنظیم نکنید، بدون محدودیت رشد می‌کنند. دلیل دوم فایلی است که حذف شده اما یک پردازش همچنان آن را باز نگه داشته است: اگر لاگی را با rm در حین اجرای کانتینر حذف کرده باشید، دیمون همچنان توصیف‌گر فایل (file descriptor) را نگه می‌دارد و کرنل بلوک‌های آن را آزاد نمی‌کند، بنابراین df هیچ تغییری را گزارش نمی‌کند. خروجی sudo du -xh --max-depth=1 /var/lib/docker را با docker system df مقایسه کنید تا متوجه شوید با کدام مورد مواجه هستید.

تفاوت docker image prune و docker image prune -a چیست؟

دستور ساده فقط ایمیج‌های معلق (dangling) را حذف می‌کند؛ یعنی ایمیج‌هایی که تگ خود را از دست داده‌اند و تقریباً همیشه نتیجهٔ بازسازی (rebuild) هستند. فرم -a هر ایمیجی را که هیچ کانتینر موجودی (شامل کانتینرهای متوقف‌شده) به آن ارجاع نمی‌دهد حذف می‌کند، که شامل ایمیج‌های تگ‌داری که عمداً دانلود کرده‌اید نیز می‌شود. پس از یک docker compose down، کانتینرها از بین می‌روند، بنابراین -a ایمیج‌های آن استک را نیز همراه خود حذف می‌کند. هیچ چیزی برای همیشه از دست نمی‌رود، زیرا در شروع بعدی، ایمیج‌ها دوباره دانلود یا ساخته می‌شوند، اما در یک اتصال اینترنت کند، این کار زمان زیادی می‌برد.

چگونه از پر شدن دیسک توسط لاگ‌های Docker جلوگیری کنم؟

گزینه‌های max-size و max-file را در بخش log-opts از فایل /etc/docker/daemon.json تنظیم کنید، سپس دیمون را با sudo systemctl restart docker ری‌استارت کنید. این تنظیمات فقط برای کانتینرهایی اعمال می‌شود که پس از آن ری‌استارت ایجاد شده‌اند، بنابراین کانتینرهای در حال اجرا را با docker compose up -d --force-recreate دوباره ایجاد کنید. می‌توانید همین دو گزینه را برای هر سرویس در یک فایل compose تحت کلید logging تنظیم کنید؛ این همان کاری است که وقتی یک سرویس بسیار پرمصرف‌تر از بقیه است، باید انجام دهید.

آیا اجرای docker system prune در یک cron job ایمن است؟

دستور سادهٔ docker system prune -f روی میزبانی که تمام استک‌های آن همیشه فعال هستند ایمن است، اما چون کانتینرهای متوقف‌شده را حذف می‌کند، کانتینری را که عمداً متوقف کرده‌اید و قصد داشتید بعداً دوباره اجرا کنید، پاک خواهد کرد. کار ایمن‌تر برای زمان‌بندی، استفاده از docker image prune -f به همراه docker builder prune -f --filter until=168h است که دو موردی را که سریع‌تر رشد می‌کنند آزاد می‌کند و به هیچ حجم (volume) دست نمی‌زند. هرگز -a یا --volumes را زمان‌بندی نکنید.

آیا این مقاله مفید بود؟