ابدأ الآن

كيف تنسخ حاوية Docker لـValkey احتياطيًا (2026)

نسخ Valkey بأمان قاعدةٌ واحدة: فرّغ ولا تنسخ. ينتج `valkey-cli SAVE # then capture the resulting dump.rdb` تفريغًا متسقًا قابلًا للاستعادة من الحاوية العاملة، يشفّره restic بعدها خارجيًا. يتفرع SAVE/BGSAVE بلقطة RDB لحظية إلى القرص: تنسخ dump.rdb المكتمل (مع AOF إن فُعّل) لا الحالة المتقلبة في الذاكرة. كل ما ينسخ /data حيًا يخاطر بنسخة غير قابلة للاستعادة.

الاكتشاف

ما يكتشفه Dockstash

متغيرات البيئة المكتشفةVALKEY_PASSWORD, VALKEY_ARGS, REDIS_PASSWORD
المنفذ الافتراضي6379
مسارات البيانات الحية (لا تُنسخ حية أبدًا)/data, /data/dump.rdb, /data/appendonly.aof
أمثلة الصورvalkey/valkey:8, valkey/valkey:7, valkey/valkey
خطوة بخطوة

انسخ Valkey مع Dockstash خطوة بخطوة

  1. أنشئ حساب Dockstash وافتح لوحة التحكم

    سجّل مجانًا على app.dockstash.com/register. يسألك معالج الإعداد لمرة واحدة عن خادم التخزين VPS (الجهاز الذي سيحتفظ بالنسخ الاحتياطية المشفّرة) ويولّد كلمة مرور تشفير — احفظها فورًا في مدير كلمات مرور، فهي تُعرض مرة واحدة فقط.

  2. أضف مشروع Docker الذي يشغّل Valkey

    في شاشة Projects يكتشف Dockstash تلقائيًا كل مجلد مشروع Compose على الخادم (افتراضيًا تحت /var/www). اختر المشروع الذي يحتوي خدمة Valkey. لم يُنسخ شيء بعد — أنت فقط تخبر Dockstash أين يقيم المشروع.

  3. تحقق من اكتشاف Valkey

    افتح المشروع وتبويب Plan. يقرأ Dockstash ملف docker-compose.yml ويتعرف على صورة valkey/valkey ويضيف طبقة باستراتيجية «احفظ ثم التقط» — مع اسم الحاوية والمتغيرات المكتشفة (VALKEY_PASSWORD وVALKEY_ARGS والقديم REDIS_PASSWORD). فعّل أو عطّل الملفات والقواعد وإعدادات الوكيل قبل الحفظ.

  4. اختياري: تحقق من اللقطة يدويًا

    إن أردت دليلًا قبل الأتمتة، أطلق الحفظ نفسه: valkey-cli BGSAVE داخل الحاوية. يجيب Valkey بـ«Background saving started» ويتفرع ويكتب dump.rdb للحظة محددة في /data — استمرارية RDB نفسها الموروثة من Redis. هذا الملف المكتمل هو ما يُنسخ، لا الحالة الحية في الذاكرة.

    docker exec <valkey-container> valkey-cli BGSAVE
  5. أكّد وجهة التخزين

    تُخزَّن النسخ كلقطات restic مشفّرة على خادم التخزين VPS الخاص بك عبر SSH. إن أكملت معالج الإعداد فهي مهيّأة بالفعل؛ ويمكنك تغيير المضيف والمستخدم والمنفذ ومفتاح SSH في أي وقت من Settings → Storage.

  6. اضبط جدول النسخ الاحتياطي

    في تبويب Schedule اختر يوميًا أو أسبوعيًا أو cron مخصصًا (يُتحقق أثناء الكتابة). لـValkey كمخزن أساسي (طوابير وجلسات) اليومي حد أدنى معقول والساعي شائع. أضف prune أسبوعيًا مع سياسة الاحتفاظ.

  7. شغّل أول نسخة احتياطية الآن

    انقر Backup Now. يطلق Dockstash حفظًا خلفيًا وينتظر dump.rdb المكتمل ثم ينسخه — مع appendonly.aof عند تفعيل AOF — مباشرة إلى restic. تابع المخرجات الحية في لوحة السجلات.

  8. تأكد من وجود اللقطة

    عند انتهاء التشغيل تعرض بطاقة المشروع وقت آخر نسخة وعدد اللقطات وحجم المستودع. افتح شاشة Snapshots وسترى نقطة الاستعادة في الخط الزمني — هذا دليلك على وصول النسخة إلى موقعها الخارجي.

الأوامر

أمر التفريغ

valkey-cli SAVE # then capture the resulting dump.rdb

أمر الاستعادة

place dump.rdb in the data dir and start valkey-server

يتفرع SAVE/BGSAVE بلقطة RDB لحظية إلى القرص: تنسخ dump.rdb المكتمل (مع AOF إن فُعّل) لا الحالة المتقلبة في الذاكرة.

الاستعادة والتحقق

استعد نسخة Valkey وأثبت أنها تعمل

نسخة Valkey الاحتياطية لا تصبح حقيقية إلا بعد استعادتها. استعادات Dockstash لا تكتب فوق النسخة الحية افتراضيًا — إلى موقع جديد أولًا، فحص، ثم ترقية واعية.

  1. اختر نقطة استعادة

    افتح Snapshots واختر المشروع وتصفح الخط الزمني. كل صف يحوي dump.rdb كاملًا للحظة محددة (مع AOF إن فُعّل) وملفات المشروع من التشغيل نفسه.

  2. استعد إلى موقع جديد

    انقر Restore وأبقِ الوضع الافتراضي «Restore to new location». اكتب اسم المشروع للتأكيد — إجراء متعمّد بتأكيد مكتوب. يهبط التفريغ والملفات في المسار الهدف الذي تختاره دون المساس بالمشروع الحي.

  3. تحقق من البيانات المستعادة

    ضع dump.rdb المستعاد في دليل بيانات حاوية Valkey تجريبية وشغّلها — يحمّل Valkey ملف RDB عند الإقلاع. نفّذ valkey-cli PING فيصلك PONG، ثم افحص مفاتيح تطبيقك بـ DBSIZE وبضع أوامر GET.

    docker exec <valkey-container> valkey-cli PING
  4. رقِّ النتيجة عند الاقتناع

    بعد التحقق من البيانات المستعادة وجّه تطبيقك إليها (أو أعد الاستعادة بوضع «Overwrite existing» — موافقة صريحة). الأفضل: دع تدريب الاستعادة الأسبوعي ينتج هذا الدليل تلقائيًا كي لا تكون الاستعادة الحقيقية أول بروفة لك.

المطبات

مطبات يجب تجنبها

  • كما مع Redis: لا تلتقط dump.rdb في منتصف إعادة الكتابة — أطلق SAVE/BGSAVE أولًا وانسخ الملف المكتمل.
  • valkey-cli هو ثنائي العميل؛ بعض صور التوافق تصل redis-cli — يكتشف Dockstash الموجود.
  • فعّل والتقط AOF حين تحتاج أحدث الكتابات؛ RDB وحده قد يتأخر.
استكشاف الأخطاء

مشكلات شائعة في نسخ Valkey

العرض
فشل تحميل dump.rdb المستعاد: خطأ ملف مبتور أو قراءة قصيرة.
السبب
نُسخ RDB بينما كان Valkey يعيد كتابته — خطر منتصف إعادة الكتابة نفسه كما في Redis؛ نموذج استمرارية RDB مطابق.
العلاج
أطلق دائمًا SAVE أو BGSAVE وانتظر الاكتمال قبل التقاط dump.rdb. هذا بالضبط ما يفعله Dockstash.
العرض
اختبار يدوي بـ redis-cli يعمل لكن valkey-cli يرد بـ«not found» (أو العكس).
السبب
ثنائي العميل يختلف حسب الصورة: صور valkey/valkey الرسمية تحمل valkey-cli، وبعض صور التوافق تصل redis-cli بوصلة رمزية.
العلاج
استخدم الثنائي الذي تحمله الصورة — البروتوكول والأوامر متطابقة. يكتشف Dockstash العميل الموجود تلقائيًا؛ النسخ يعمل في الحالتين.
العرض
وضعت dump.rdb المستعاد في /data لكن Valkey العامل ما زال يقدم البيانات القديمة.
السبب
كـRedis، يقرأ Valkey ملف RDB عند الإقلاع فقط — لا استبدال حي. ومع appendonly مفعّل يتقدم AOF عند الإقلاع ويُتجاهل RDB.
العلاج
أوقف الحاوية وضع dump.rdb المستعاد (وAOF عند الحاجة) في دليل البيانات ثم أعد التشغيل. إن استعدت RDB فقط في إعداد AOF فاضبط مؤقتًا appendonly no للإقلاع الأول.
العرض
نجحت الاستعادة لكن أحدث الكتابات مفقودة.
السبب
استمرارية AOF مفعّلة وappendonly.aof كان يحمل كتابات أحدث من لقطة RDB.
العلاج
انسخ الملفين معًا. يلتقطهما Dockstash في التشغيل نفسه.

أنجزه بنقرة واحدة مع Dockstash

ينفّذ Dockstash التفريغ أعلاه بالضبط ويسلّمه إلى restic خارجيًا ويختبر الاستعادة بتدريب تلقائيًا — بلا سكربت تصونه.

آخر تحديث: July 2026

الأسئلة الشائعة

بمَ يختلف نسخ Valkey عن Redis؟

لا فرق جوهري. Valkey تفرّع من Redis واحتفظ بنموذج استمرارية RDB وAOF نفسه. الفرق العملي الوحيد اسم ثنائي العميل (valkey-cli) ويكتشفه Dockstash تلقائيًا.

هل يمكن استعادة RDB من Redis في Valkey؟

نعم للإصدارات الحالية — صيغة RDB مشتركة منذ نقطة التفرع. ومع تباعد المشروعين أبقِ الاستعادات في المحرك نفسه احتياطًا.

هل يكتشف Dockstash نظام Valkey تلقائيًا؟

نعم. تُعرف صور valkey/valkey وثنائي valkey-cli، ويُلتقط كل من VALKEY_PASSWORD والقديم REDIS_PASSWORD.

هل ألتقط AOF أيضًا؟

إن كان appendonly مفعّلًا ولا تحتمل خسارة ثواني الكتابة الأخيرة فنعم. ينسخ Dockstash ملفات RDB وAOF معًا.

كم مرة يجب نسخ Valkey؟

وائم الجدول مع المحتوى. للطوابير والجلسات الساعي شائع؛ وللبيانات البطيئة اليومي كافٍ. في Free النسخ يدوي (Backup Now)؛ Pro حتى الساعي وBusiness أي cron.

أين تعيش النسخ الاحتياطية فعليًا؟

على خادم التخزين VPS الخاص بك، كلقطات restic مشفّرة تُدفع عبر SSH. لا يحتفظ Dockstash ببياناتك أبدًا على سحابة طرف ثالث — أنت توجّهه إلى جهاز تتحكم فيه، والمستودع مشفّر بكلمة مرور لا يملكها سواك.

كيف أعرف أن نسخة Valkey تُستعاد فعلًا؟

جدوِل تدريب استعادة. يستعيد Dockstash أحدث لقطة إلى مساحة معزولة ويقارن الملفات بايتًا ببايت ويتحقق من التفريغ — ثم يختم بشارة نجاح/فشل.