إصلاح النسخ الفاشلة
حين تفشل نسخة يقولها Dockstash بصوت عالٍ ويريك الموضع: بريد تنبيه بالخطأ، شارة حالة على بطاقة المشروع، ومخرجات restic كاملة في لوحة السجلات الحية. يمر هذا الدليل بأشكال الفشل الشائعة — تشغيلات حمراء، وكلاء غير متصلين، إنذار الصمت — وعلاجاتها.
كيف تفعلها
ابدأ من بطاقة المشروع
تعرض شاشة Projects شارة حالة ووقت آخر نسخة وحجمًا لكل مشروع. يصل التشغيل الفاشل أيضًا بريدَ تنبيه بالخطأ ورابط مباشر — ابدأ من أيهما. تعرض شاشة التفاصيل تفصيل آخر فشل مباشرة.
اقرأ مخرجات restic للتشغيل
افتح لوحة سجلات التشغيل الفاشل. تسمي الأسطر الأخيرة السبب غالبًا: authentication failed (مفتاح SSH أو بيانات القاعدة)، no space left on device (جهاز التخزين ممتلئ)، connection refused (خادم التخزين غير مُبلغ)، أو خطأ أمر تفريغ من داخل الحاوية.
أقفال restic القديمة تشفي نفسها
إن انهار تشغيل أو أُعيد تشغيل الخادم في منتصف نسخة فقد يبقى المستودع مقفولًا. لا تدخّل: يكتشف التشغيل التالي القفل اليتيم وينفّذ restic unlock تلقائيًا. قفل تمسكه مهمة عاملة فعلًا لا يُكسر أبدًا.
مشاريع الوكلاء: افحص الوكيل أولًا
إن توقف مشروع على وكيل أسطول عن النسخ فانظر شاشة Fleet. غير متصل يعني توقف النبضات: على الخادم تأكد أن حاويتي الوكيل تعملان وأن عنوان Dockstash مُبلغ وأن الرمز لم يُدوَّر دون تحديث الحاوية. تكرار 401 في السجلات يعني حاوية قديمة في مكان ما ما تزال تنبض برمز ملغى.
docker compose -f docker-compose.agent.yml psافهم تنبيهات «لم تعمل نسخة»
تنبيه heartbeat يعني أن لا نسخة ناجحة وصلت داخل النافذة — لم يفشل شيء ولم يعمل شيء. المشتبهون المعتادون: جدول معطّل، خطة بلا جداول، مشروع موقوف بعد تخفيض، أو وكيل مسنَد غير متصل. أصلح السبب فيمسح التشغيل الأخضر التالي الإنذار.
أنجزه بنقرة واحدة مع Dockstash
ينفّذ Dockstash التفريغ أعلاه بالضبط ويسلّمه إلى restic خارجيًا ويختبر الاستعادة بتدريب تلقائيًا — بلا سكربت تصونه.
آخر تحديث: July 2026
أدلة ذات صلة
ربط وكيل أسطول
شغّل وكيلًا صغيرًا صادر الاتصال فقط على أي خادم وانسخ حاوياته من لوحة واحدة — التسجيل والتثبيت وأدلة المشاريع والإسناد الأول.
إعداد التنبيهات والإشعارات
رسائل فشل ونبضة «مفتاح الرجل الميت» تلتقط التوقفات الصامتة وبثّ webhook إلى Slack أو PagerDuty وسجل تدقيق غير قابل للتغيير.
MySQL
نسخ MySQL في Docker
MongoDB
نسخ MongoDB في Docker
الأسئلة الشائعة
فشلت نسخة مرة ونجحت عند الإعادة. أأهتم؟
انظر سبب الفشل. تعيد المهام المحاولة بتراجع أسّي محدود: عثرات الشبكة العابرة تشفي نفسها. أما الإعادات المتكررة على الخطأ نفسه — قرص يمتلئ أو SSH متقلب — فتستحق إصلاحًا حقيقيًا قبل أن تصير عطلًا صلبًا.
لماذا ينتظر جدولي الثاني بدل العمل؟
مهمة واحدة لكل مستودع، دائمًا. تفسد عمليات restic المتزامنة المستودعات، فالجداول المتصادمة على المستودع نفسه تُسلسل عمدًا. المستودعات المختلفة تعمل بتوازٍ.
منتقي Add-Project لوكيلي فارغ. لماذا؟
يقرأ المنتقي اللقطة التي دفعها الوكيل في آخر نبضة. فارغ يعني: لم يبلّغ الوكيل بعد، أو دليل مشاريع غير مركّب فعلًا في حاوية الوكيل، أو وكيل مقبس Docker غير مُبلغ — تخبرك لافتة المنتقي أيها. أصلح ثم انقر Refresh now بدل انتظار دورة الاكتشاف التالية.
كيف أثبت أن المستودع نفسه سليم؟
شغّل مهمة check. يتحقق restic check من بنية المستودع؛ ومع نسبة قراءة بيانات يقرأ محتوى الحزم فعلًا ويتحقق منه. النجاح يستلزم رمز خروج صفرًا — لا أخضر كاذبًا.
أين أرى سبب فشل تدريب؟
تخزن نتيجة التدريب رسالة تفصيل بعدد الاختلافات، ظاهرة في تبويب Restore drill وفي بريد التنبيه. اختلافات البايتات تشير إلى ملفات تغيرت أثناء النسخ؛ واختلافات الصفوف إلى اتساق التفريغ — في الحالين عُدَّ النسخة غير مثبتة حتى ينجح تشغيل جديد.