كل المقالات التقنية

نسخ واستعادة Docker Volume احتياطيًا

كيف تنسخ volumes في Docker بـ tar وتستعيدها بأمان وتتعامل مع قواعد البيانات وتثبت أن النسخة تعمل.

نسخ واستعادة Docker Volume احتياطيًا

الحاوية قابلة للاستبدال لكن البيانات في Docker volume الخاص بها عادةً ليست كذلك. قواعد البيانات والملفات المرفوعة وحالة التطبيق تعيش في volumes، وحذف volume أو تعطل قرص يعني ضياع تلك البيانات. تنسخ فرق كثيرة ملفات compose وتنسى volumes ثم تكتشف الفجوة أثناء حادث. يبين هذا الدليل كيف تعثر على volumes وتنسخها بحاوية مؤقتة وتستعيدها بأمان وتتعامل مع قواعد البيانات بالشكل الصحيح وتثبت أن النسخة تعمل فعلًا.

١. اعرف ما يوجد وأين

لدى Docker مجلدات مسماة وbind mounts وطبقة الكتابة الخاصة بالحاوية. تُدار المجلدات المسماة بواسطة Docker وتوجد تحت دليل بياناته. أما bind mounts فهي أدلة عادية على المضيف اخترتها بنفسك. وتزول طبقة الكتابة بحذف الحاوية. لا يبقى سوى أول اثنين، لذا لا يحتاج خطة نسخ احتياطي إلا هما، ومهمتك الأولى سرد ما تربطه كل حاوية فعلًا:

docker volume ls
docker volume inspect app_data
docker ps --format '{{.Names}}	{{.Mounts}}'

دوّن كل volume يحمل بيانات تأسف على فقدانها. أما volumes التي تحمل ذاكرة مؤقتة فقط فيمكن تجاهلها.

٢. لماذا لا تنسخ دليل الـ volume يدويًا

توجد المجلدات المسماة على المضيف تحت مسار تملكه Docker، ونسخ هذا المسار مباشرة هش. فهو يعتمد على بنية التخزين ويحتاج root ولا يعمل على مضيفي Docker البعيدين. الطريقة القابلة للنقل هي ربط volume داخل حاوية قصيرة العمر وأرشفته من الداخل. وهذا يعمل على أي مضيف يشغّل Docker.

٣. انسخ volume باستخدام tar

يربط هذا الأمر volume للقراءة فقط ويربط الدليل الحالي وجهةً ويكتب أرشيفًا مؤرخًا:

docker run --rm \
  -v app_data:/data:ro \
  -v "$PWD":/backup \
  alpine:3.20 \
  tar czf /backup/app_data-$(date +%F).tar.gz -C /data .

يحمي الخيار :ro المصدر من الأخطاء. ويخزّن الجزء -C /data . المسارات نسبةً إلى جذر الـ volume مما يسهل استعادة الأرشيف في أي volume مهما كان اسمه. وتُحذف الحاوية عند انتهائها.

٤. استعد في volume جديد

استعد أولًا في volume جديد لا فوق الحي. هذا يتيح لك فحص النتيجة قبل تبديل أي شيء:

docker volume create app_data_restore
docker run --rm \
  -v app_data_restore:/data \
  -v "$PWD":/backup:ro \
  alpine:3.20 \
  tar xzf /backup/app_data-2026-10-14.tar.gz -C /data

بعد تأكدك من المحتوى وجّه ملف compose إلى الـ volume المستعاد، أو انسخ البيانات إلى الأصلي بعد إيقاف الخدمة.

٥. فكّر في اتساق البيانات

قد يكون أرشيف ملفات قيد الكتابة غير متسق. فالتطبيق المزدحم قد تكون لديه ملفات نصف مكتوبة. أبسط نهج آمن هو إيقاف الخدمة للفترة القصيرة التي يستغرقها النسخ ثم تشغيلها مجددًا:

docker compose stop app
# run the backup or restore command here
docker compose start app

وللخدمات التي يجب أن تبقى تعمل استخدم أداة snapshot أو export الخاصة بالتطبيق بدل النسخ على مستوى الملفات، كما يشرح القسم التالي.

٦. انسخ قواعد البيانات بأدواتها الخاصة

قد يعطي نسخ volume قاعدة بيانات أثناء تشغيلها نسخة لا تبدأ. استخدم أداة dump الخاصة بالقاعدة التي تنشئ نسخة منطقية متسقة أثناء عمل الخدمة:

docker compose exec -T db sh -c 'mysqldump --single-transaction -u root -p"$MYSQL_ROOT_PASSWORD" appdb' > appdb-$(date +%F).sql
docker compose exec -T db sh -c 'pg_dump -U postgres appdb' > appdb-$(date +%F).dump

يعطي الخيار --single-transaction لـ MySQL InnoDB لقطة متسقة دون قفل الجداول. اعتبر الـ dump النسخة الأساسية لقاعدة البيانات وأرشيف الـ volume نسخة ثانوية. تختلف الأدوات والخيارات بين المحركات، فاقرأ وثائق ما تشغّله، وراجع استراتيجية النسخ الاحتياطي 3-2-1 واختبار الاستعادة لمعرفة موقع النسخ ضمن خطة أوسع.

٧. احمِ الأسرار في الـ dump والأرشيفات

تحوي النسخ كل ما يحويه الـ volume، بما فيه بيانات المستخدمين والرموز وأحيانًا بيانات الاعتماد. خزّنها بصلاحيات مقيدة وشفّرها قبل خروجها من الخادم ولا تضع كلمة مرور قاعدة البيانات في سطر أوامر يراه مستخدمون آخرون. تقرأ الأمثلة أعلاه كلمة المرور من بيئة الحاوية بدل كتابتها. وأبقِ ملف compose وملف البيئة والنسخ في أماكن منفصلة بصلاحيات مختلفة.

٨. تحقق من كل أرشيف

النسخة التي لم تُفحص قط مجرد أمل. سجّل على الأقل checksum وتأكد أن الأرشيف قابل للقراءة:

sha256sum app_data-2026-10-14.tar.gz > app_data-2026-10-14.tar.gz.sha256
sha256sum -c app_data-2026-10-14.tar.gz.sha256
tar tzf app_data-2026-10-14.tar.gz | head

يثبت checksum أن الملف لم يتغير في التخزين، ويثبت سرد الأرشيف أنه مقروء. ولا يثبت أي منهما أن التطبيق سيعمل منه، ولهذا يهم اختبار استعادة حقيقي.

٩. نفّذ اختبار استعادة

استعد أحدث نسخة دوريًا في volume تجريبي وشغّل نسخة من الخدمة عليه. تأكد أن البيانات موجودة وأن التطبيق يعمل:

docker run --rm -v app_data_restore:/data:ro alpine:3.20 ls -la /data
docker compose up -d
docker compose logs --tail 50 app

نفّذ هذا على مضيف staging أو باسم مشروع ومنافذ مختلفة حتى لا يمس الاختبار بيئة الإنتاج. اختبار استعادة يفشل اليوم أرخص بكثير من اختبار يفشل أثناء انقطاع.

١٠. انقل الـ volumes بين الخوادم

تنقل طريقة الأرشيف نفسها البيانات إلى مضيف جديد. أنشئ الأرشيف وانسخه بأمان وأنشئ volume على الخادم الجديد واستخرج داخله. انقل ملف compose على حدة وأبقِ إصدارات الصور متطابقة حتى يتأكد الترحيل. وإذا كان المضيف الجديد يستخدم معرّف مستخدم مختلفًا للتطبيق فقد تحتاج ملكية الملفات داخل الأرشيف إلى تعديل بعد الاستعادة.

١١. التدوير والاحتفاظ

تتراكم النسخ. قرر كم نسخة يومية وأسبوعية وشهرية تحتفظ بها، وانسخ واحدة على الأقل خارج الخادم، واحذف الملفات القديمة بقاعدة لا يدويًا. يُظهر أمر السرد ما ستحذفه القاعدة قبل أن تشغّله بإجراء الحذف:

find /srv/backups -name 'app_data-*.tar.gz' -mtime +14 -print

احتفظ بنسخة واحدة على الأقل في مكان آخر، لأن نسخة على القرص نفسه تتعطل معه. وتنمو سجلات الحاويات أيضًا، ويبين منع امتلاء القرص عبر تدوير سجلات Docker كيف تمنعها من ملء القرص الذي يحمل نسخك.

١٢. الإيقاف النظيف مهم

قد تترك حاوية تُقتل بدل أن تُوقف ملفات نصف مكتوبة. امنح التطبيقات وقتًا لإنهاء عملها عند إيقافها وتأكد أن العملية الرئيسية تستقبل إشارة الإيقاف. يشرح إيقاف Docker بأمان: SIGTERM وPID 1 ومهلة SIGKILL كيف تعمل إشارات الإيقاف والمهل، وهو يؤثر مباشرة في اتساق نسخة تؤخذ بعد الإيقاف.

١٣. الأخطاء الشائعة

  • نسخ ملف compose فقط دون الـ volumes.
  • نسخ ملفات قاعدة بيانات تعمل وتوقع استعادة نظيفة.
  • الاستعادة مباشرة فوق الـ volume الحي دون نسخة تجريبية.
  • إبقاء كل النسخ على قرص البيانات نفسه.
  • عدم اختبار الاستعادة أبدًا.
  • وضع كلمات المرور في سطر الأوامر أو سكربتات مشتركة.

١٤. مثال تطبيقي

يشغّل فريق صغير تطبيقًا وقاعدة بيانات في compose. يوقفون التطبيق قليلًا كل ليلة ويؤرشفون volume البيانات بـ tar ويأخذون dump منطقيًا لقاعدة البيانات وينسخون الملفين خارج الخادم مع checksum. مرة كل شهر يستعيدون أحدث زوج في بيئة تجريبية ويفتحون التطبيق للتأكد من البيانات. يكشف الاختبار الأول ملف بيئة مفقودًا يضيفونه إلى ملاحظاتهم. هذا توضيح لروتين وليس قياسًا من فريق حقيقي.

١٥. أسئلة شائعة

هل أنسخ مجلد الـvolume مباشرة؟ لقاعدة بيانات تعمل لا. قد تحصل على نسخة غير متسقة. أوقف الحاوية أو استخدم أداة النسخ المنطقي الخاصة بالقاعدة مثل mysqldump.

كيف أختبر أن الاستعادة تعمل؟ أنشئ volume جديدًا وحاوية تجريبية واستعد النسخة فيهما، ثم افحص أن التطبيق يقلع وأن عدد السجلات صحيح. نسخة لم تُختبر لا تُعدّ نسخة احتياطية.

أين أخزن النسخ؟ خارج الخادم نفسه، في تخزين آخر أو مزوّد مختلف، مع الاحتفاظ بعدة نسخ قديمة لا بنسخة واحدة تُستبدل كل مرة.

هل bind mount مثل volume؟ لا. الـbind mount مسار موجود على المضيف مباشرة، أما الـvolume فتديره Docker. تختلف طريقة النسخ والصلاحيات بينهما.

١٦. قائمة تحقق سريعة

  1. اسرد الـ volumes وbind mounts التي تحمل بيانات حقيقية.
  2. أرشفها عبر حاوية مؤقتة بربط للقراءة فقط.
  3. استخدم أداة dump الخاصة بقواعد البيانات.
  4. سجّل checksum واحتفظ بنسخة خارج الخادم.
  5. استعد في volume جديد واختبر التطبيق.
  6. كرر اختبار الاستعادة بجدول وأدِر النسخ القديمة.

تجد مزيدًا من أدلة الخوادم في أرشيف المقالات.

المراجع الرسمية

Docker: Volumes (backup, restore, migrate) · Docker Compose: Volumes reference · GNU tar manual