BombVault¶
بيانات Unraid الخاصة بك، مختومة في خزنة. أسقط نسخة احتياطية. فجّر استعادة.

BombVault تطبيق ويب تستضيفه بنفسك لـ النسخ الاحتياطي والتعافي الكامل من الكوارث على Unraid ومضيفات Docker الأخرى، مثل TrueNAS SCALE أو ZimaOS أو جهاز Linux عادي. ينسخ حاويات Docker وأجهزة KVM/libvirt الافتراضية والمجلدات ومجموعات بيانات ZFS وفلاش Unraid. يعمل كحاوية Docker واحدة متعددة المعماريات، ويمنحك واجهة ويب بمظهر داكن أو فاتح أو مظهر النظام، ويتولى دورة الحياة كلها: النسخ والجدولة والتحقق والاستعادة.
الاستعادة تلقائية. في Unraid تعود الحاويات إلى تبويب Docker تمامًا كما كانت، وتُعاد تعريف الأجهزة الافتراضية في VM Manager مع إعادة ربط أقراصها وUEFI NVRAM. لا إعادة تثبيت يدوية، ولا إعادة تهيئة، ولا دراما. وعلى TrueNAS تعمل الحاوية المستعادة بجانب الأصل كحاوية Docker عادية لا تسردها شاشة Apps.
يعمل بـ restic، فكل نسخة احتياطية مُزالة التكرار وتزايدية ومشفّرة افتراضيًا.
احفظ APP_KEY بأمان
يشتق BombVault كلمة مرور مستودع restic من سر بحجم 32 بايتًا اسمه APP_KEY. فقدانه، مع حقيبة الاستعادة، يجعل النسخ المشفرة غير قابلة للاسترداد. أنشئ واحدًا بـ openssl rand -hex 32 واحفظه في مكان آمن. راجع التهيئة.
ما الذي يحميه BombVault¶
كل حاوية وجهاز افتراضي ومجموعة مجلدات والفلاش وكل مجموعة بيانات ZFS وإعدادات BombVault نفسه عنصر له صفحته الخاصة. العناصر من نوع واحد تشكل قسمًا، تفعّله ضمن الإعدادات، عام.
| القسم | ما الذي يُحفظ |
|---|---|
| الحاويات | مجلد appdata وتعريف الحاوية (الصورة ومتغيرات البيئة والمنافذ والوسوم والأحجام). |
| VMs | صورة (صور) قرص الجهاز الافتراضي وتعريف XML وUEFI NVRAM، تُنسخ عبر SSH (دون تركيب libvirt). |
| Flash | كامل فلاش USB (/boot): النظام والترخيص وإعداد المصفوفة والمشاركات والشبكة وإعداد الإضافات. |
| النسخ الذاتي | /config الخاص بـ BombVault: قاعدة بيانات إعداداته وبيانات اعتماد وجهاته وزوج مفاتيح SSH لـ libvirt ومفتاح خوادم ZFS وبصمات مضيفيها المثبّتة والشهادات. |
| المجلدات | أي مجلد على الخادم كمجموعة مجلدات، لكل منها أنماط استبعاد اختيارية. |
| مجموعات بيانات ZFS | مجموعة بيانات وكل مجموعة تحتها، تُقرأ من لقطة ZFS واحدة وتُخزَّن كمجلد. راجع مجموعات بيانات ZFS. |
الاستعادة هي النجم¶
بعد نسخ البيانات من لقطة restic، يعيد BombVault تشغيل تعريف الحاوية المحفوظ على واجهة Docker، فتظهر الحاوية في تبويب Docker في Unraid كأنها كانت هناك دائمًا (الصورة نفسها والإعدادات نفسها وربط المنافذ نفسه). تحصل الأجهزة الافتراضية على XML معاد تعريفه عبر SSH وتُعاد أقراصها وUEFI NVRAM، حتى بعد حذف الجهاز الافتراضي.
نافذة واحدة تستعيد كل نوع. تختار افتراضيًا بجانب الأصل، الذي يعيد النسخة كنسخة ويترك الأصل كما هو. استبدال الأصل ينسخ الحالة الحالية أولًا، فيمكن التراجع عن استعادة. المجلد أو مجموعة بيانات ZFS جديدة وجهتان أخريان.
حين توقف نسخة احتياطية حاويات تابعة، فإنها تعود بالترتيب الصحيح: يعيد BombVault تشغيلها بترتيب depends_on في Compose وينتظر أن تبلّغ كل منها بأنها سليمة قبل أن يبدأ التي تعتمد عليها، فلا يتقدم شيء على قاعدة بيانات أو بوابة لم تعمل بعد. راجع الاستعادة والأوامر والحاويات الأخرى.
كيف يعمل¶
Browser --HTTPS--> BombVault container
|- Go binary: JSON API + embedded React UI
|- Background worker (per-section scheduler + job executor)
|
|- /var/run/docker.sock -> Docker API (container stop/inspect/recreate)
|- qemu+ssh://host -> libvirt / KVM on the HOST over SSH (no mount)
|- /mnt/ -> /host/user -> appdata, VM disks + restic repos (read/write)
|- /boot/ -> /host/boot -> Unraid flash backup (whole USB)
|- /config -> BombVault's own settings + sign-ins (self-backup)
'- <repo path> -> restic repository (local or remote: rclone/s3/rest/sftp)
يستخدم BombVault مقبس Docker لإيقاف الحاويات قبل نسخة احتياطية ولإعادة إنشائها بعد استعادة. وللأجهزة الافتراضية يشغّل virsh على المضيف عبر SSH (qemu+ssh://) ليوقف نطاقًا بسلام أو يأخذ لقطة حية. ولا يركّب أي مسار libvirt أبدًا، فلا يمكنه أن يعترض طريق VM Manager على المضيف.
BombVault طبقة تنسيق وواجهة، لا محرك تخزين. كل نقل فعلي للبيانات يمر عبر restic.
بداية سريعة¶
جديد هنا؟ توجّه إلى البدء لتثبيت BombVault وإجراء أول نسخة احتياطية، ثم أعدّ خارج الموقع والاستعادة. تمرّ الأمثلة خطوة بخطوة على المهام الشائعة من أولها إلى آخرها، وتسرد صفحة الإعدادات كل بلاطة، وتمثل الميزات الفهرس الموجز لكل ما يفعله BombVault.
يستطيع كل قسم النسخ إلى عدة وجهات معًا، ويستطيع BombVault مقترن أن يحتفظ بنسخك خارج الموقع في خادم يرفض الحذف، ويعيد معالج الطوارئ خادمًا مفقودًا من حقيبة استعادته أو عبر مجموعتك أو بمفتاحه المكتوب. لنقل إعداداتك إلى جهاز جديد استخدم بطاقة تصدير / استيراد الإعدادات. راجع خارج الموقع والاستعادة والتهيئة.
يضع تطبيق Android كل خادم في مجموعتك على هاتفك، مع سجل نشاطها كلها على شاشة واحدة.
التوثيق متاح بـ 26 لغة والواجهة بـ 42. تظهر الصفحات التي لا ترجمة لها بعد بالإنجليزية.
كلمات مستخدمة هنا¶
لعدة كلمات معنى ثابت في BombVault وفي هذه الصفحات.
| الكلمة | المعنى |
|---|---|
| عنصر | شيء واحد ينسخه BombVault: حاوية أو جهاز افتراضي أو مجموعة مجلدات أو الفلاش أو مجموعة بيانات ZFS مع ما تحتها أو إعداداته الخاصة. لكل منها صفحته الخاصة. |
| قسم | كل العناصر من نوع واحد، مثل الحاويات. تفعّل الأقسام ضمن الإعدادات، عام. |
| وجهة | مكان تذهب إليه النسخ: مجلد على هذا الخادم أو مشاركة أو خادم خاص بك أو خدمة سحابية. راجع الوجهات. |
| محلي | الوجهة على هذا الخادم التي تحتفظ بمجلدات الأقسام. |
| المجلد الخاص | المستودع الذي يكتب فيه قسم نسخه أولًا. هو على هذا الخادم افتراضيًا ويمكن أن يقع في وجهة. راجع المجلد الخاص بقسم. |
| نسخة | نسخة احتياطية منسوخة من المجلد الخاص إلى وجهة أخرى بـ restic copy. |
| مستودع مباشر | مستودع في موقع خارجي تنسخ إليه العناصر مباشرة، دون نسخة محلية بينهما. راجع المستودعات المباشرة. |
| بيانات الاعتماد | المفتاح أو كلمة المرور المحفوظان لخدمة S3 أو rest-server. إحداها هي الافتراضية. راجع بيانات الاعتماد. |
| التوزيع | أي الوجهات تحصل على نسخ عنصر، يُضبط على العنصر أو كافتراضي لقسمه. راجع التوزيع لكل عنصر. |
| نسخة طبق الأصل | نسخة على مستوى الكتل من عنصر ZFS على خادم ZFS ثانٍ، تُصنع بـ zfs send. تقف بجانب النسخة الاحتياطية ولا تحل محلها. راجع النسخة المتماثلة. |
| دور | ما يفعله مثيل في مجموعتك لمثيل آخر: المستقبِل أو الساحب أو خادم ZFS أو حافظ المفتاح. راجع المثيلات والأدوار. |
| عقدة | BombVault بلا واجهة ويب، على VPS مثلًا، يخبره مثيل آخر، هو مثيله الأم، بما ينسخه ومتى وإلى أين. راجع العُقد. |
| المثيل الأم | المثيل الذي أضاف عقدة ويتحكم بها. يحتفظ بمفتاح العقدة ويخبرها بما تنسخه ومتى وإلى أين. راجع العُقد. |
شكر وتقدير¶
- VolumeVault من @Darkdragon14 (Apache-2.0) منح BombVault فكرته الأولى: النسخ الاحتياطي بنقرة واحدة لحاويات Docker وإعادة تثبيتها تلقائيًا. BombVault تنفيذ منفصل على Go وrestic ينقل الفكرة إلى الأجهزة الافتراضية والفلاش وغيرها.
- restic هو محرك النسخ الاحتياطي السريع الآمن المُزيل للتكرار الذي يقوده BombVault.
- rclone يوفر الواجهات الخلفية السحابية.
- معظم الرموز على الأزرار من مجموعة Core Solid المجانية من Streamline (CC BY 4.0، المصدر). والبقية من Font Awesome Free وMaterial Design Icons وSimple Icons وTabler Icons، أو رُسمت للمشروع.
الترخيص¶
Copyright (C) 2026 Junker der Provinz. BombVault برنامج حر بموجب GNU Affero General Public License v3.0 (LICENSE). يمكنك تشغيله ودراسته ومشاركته وتعديله. إذا وزّعته أو شغّلت نسخة معدّلة كخدمة شبكية، فعليك نشر مصدرك بالترخيص نفسه والإبقاء على إشعارات حقوق النشر والإسناد القائمة.
الاسم والعلامة غير مرخّصين. يغطي AGPL الشيفرة المصدرية فقط: «BombVault» وشعاره وعلامته تبقى محفوظة، فعلى النسخة المتفرعة (fork) أن تستخدم اسمًا وعلامة خاصين بها ولا يجوز أن تقدّم نفسها على أنها BombVault.
روابط¶
- الشيفرة المصدرية: github.com/junkerderprovinz/bombvault
- موضوع دعم Unraid: forums.unraid.net
- المسائل (Issues): github.com/junkerderprovinz/bombvault/issues
تحكم يعادل root في المضيف
عبر مقبس Docker يستطيع BombVault إيقاف الحاويات وإزالتها وإعادة إنشائها وقراءة appdata وكتابتها، وللنسخ الاحتياطي للأجهزة الافتراضية يسجّل الدخول إلى المضيف عبر SSH ليشغّل virsh. كل من يستطيع الوصول إلى واجهته يملك فعليًا root على المضيف. شغّل BombVault فقط على شبكة موثوقة غير معرّضة، واضبط كلمة مرور دخول ضمن الإعدادات، الأمان. تحتاج إليها حقيبة الاستعادة وإيداعات المفاتيح وملف ZIP للفلاش وتصدير نسخة فلاش أو نسخة ذاتية. راجع التهيئة لنموذج الأمان الكامل.