انتقل إلى المحتوى

التهيئة

تغطي هذه الصفحة متغيرات بيئة الحاوية، والتركيبات التي يوفرها القالب، ونموذج الأمان، والنسخ الاحتياطي للأجهزة الافتراضية عبر SSH، وإعداد النسخ خارج الموقع. أما أين تذهب النسخ الاحتياطية فيُضبط داخل التطبيق كـ وجهات، لا عبر متغيرات البيئة.

متغيرات البيئة

المتغير مطلوب الوصف
APP_KEY نعم سر من 32 بايتًا بالنظام الست عشري (64 رمزًا ست عشريًا) يُشتق منه كلمة مرور مستودع restic. أنشئه بـ openssl rand -hex 32. احفظه بأمان: فقدانه يجعل النسخ الاحتياطية المشفرة غير قابلة للاسترداد.
LIBVIRT_HOST للأجهزة الافتراضية ومجموعات بيانات ZFS مضيف Unraid الذي يُوصَل إليه عبر SSH لنسخ الأجهزة الافتراضية ومجموعات بيانات ZFS (حقل القالب Host SSH: Address، الافتراضي host.docker.internal). يملأ القالب مسبقًا العنصر النائب 192.168.x.x، وهو يُعدّ غير مضبوط. استخدم عنوان IP لجهاز Unraid في الشبكة المحلية، وهو مطلوب في شبكة br0.x مخصصة. حين لا يُحلّ host.docker.internal، كما في تطبيق TrueNAS، ولا يسمّي LIBVIRT_URI مضيفًا أيضًا، يستخدم BombVault البوابة الافتراضية للحاوية ويسمّيها سجل الإقلاع.
LIBVIRT_SSH_PORT لا منفذ SSH للمضيف لنسخ الأجهزة الافتراضية ومجموعات بيانات ZFS (حقل القالب Host SSH: Port، الافتراضي 22).
LIBVIRT_SSH_USER لا مستخدم SSH على المضيف لنسخ الأجهزة الافتراضية ومجموعات بيانات ZFS (حقل القالب Host SSH: User، الافتراضي root).
LIBVIRT_URI لا عنوان اتصال libvirt الكامل، يُستخدم كما هو بدل بناء واحد من متغيرات LIBVIRT_* الثلاثة أعلاه (التي تُتجاهل حينئذ لسلسلة الاتصال). الافتراضي غير مضبوط. مطلوب على TrueNAS Scale، الذي يستمع libvirtd فيه على مقبس غير قياسي لا يستطيع شكل السلسلة المبنية التعبير عنه: qemu+ssh://<user>@<truenas-host>/system?socket=/run/truenas_libvirt/libvirt-sock. راجع دليل نسخ الأجهزة الافتراضية. إذا كان عنوان qemu+ssh://، فكل من LIBVIRT_HOST وLIBVIRT_SSH_USER وLIBVIRT_SSH_PORT غير المضبوط يؤخذ منه، وكذلك لأوامر SSH الخاصة بـ BombVault (نقل NVRAM ومجموعات بيانات ZFS).
PORT لا منفذ HTTP (الافتراضي 3000. يُستخدم فقط مع HTTP_ONLY=true).
HTTPS_PORT لا منفذ HTTPS (الافتراضي 3443. ينشره القالب 1:1، فتجيب واجهة الويب على https://<ip>:3443).
HTTP_ONLY لا اضبطه على true لتعطيل مستمع HTTPS الموقّع ذاتيًا وتقديم HTTP عادي فقط (للاستخدام خلف وكيل عكسي ينهي TLS).
BIND_HOST لا العنوان الذي تستمع عليه واجهة الويب (الافتراضي 0.0.0.0، كل واجهة). اتركه غير مضبوط في الحاوية، لأن المنافذ المنشورة تحتاج إلى كل واجهة. 127.0.0.1 يناسب التشغيل خارج Docker. يسأل فحص السلامة العنوان نفسه.
TRUSTED_PROXY لا عناوين أو نطاقات CIDR للوكيل العكسي أمام BombVault مفصولة بفواصل (مثل 192.168.20.11 أو 10.0.0.0/8). فقط من تلك القفزات يُصدَّق X-Forwarded-For، ويعدّ مقيّد الدخول الإخفاقات حينئذ لكل عميل حقيقي بدل وضع كل من خلف الوكيل في سلة واحدة. غير المضبوط (الافتراضي) لا يثق بأحد: ترويسة يُصدَّق بها دون قيد تتيح لأي متصل اختيار سلته.
HOST_SOURCE_ROOT لا مسار المضيف المركّب كـ Host Data (الافتراضي /mnt). يترجم BombVault مصادر bind-mount التي يبلّغ عنها Docker إلى مسارات تحت هذا التركيب. غيّره فقط إذا ركّبت جذر مضيف مختلفًا.
HOST_MOUNT_ROOT لا مكان تركيب Host Data داخل الحاوية (الافتراضي /host/user). في TrueNAS يُركَّب Host Data على مسار المضيف نفسه، لذا يسمّي هذا وHOST_SOURCE_ROOT ذلك المسار، مثل /mnt/tank (راجع TrueNAS SCALE).
DATA_ROOT_SEGMENTS لا أسماء مقاطع مسار مفصولة بفواصل تعلّم مصدر bind-mount كبيانات نسخ احتياطي (الافتراضي appdata، بما يطابق عُرف Unraid /mnt/user/appdata/<container>). يُختار bind-mount للحاوية للنسخ تلقائيًا حين يظهر أي مقطع مسرود كمقطع مسار كامل من مصدره على المضيف. مثلًا DATA_ROOT_SEGMENTS=appdata,config يلتقط أيضًا bind في .../config. المطابقة تتجاهل حالة الأحرف، فيغطي الافتراضي أيضًا /DATA/AppData/<container> في ZimaOS. راجع اكتشاف مصدر النسخ الاحتياطي لسائر الطرق الدائمة للعثور على مجلد بيانات الحاوية.
PLATFORM لا يفرض أي منصة يعدّ BombVault نفسه يعمل عليها، بدل الاكتشاف التلقائي: unraid أو generic أو truenas (الافتراضي غير مضبوط: يكتشف Unraid بفحص علامة dockerMan تحت تركيب الفلاش، وإلا generic. القيمة غير المعروفة تعود أيضًا إلى generic، مع تسجيل ذلك). اضبطه صراحة على مضيف Docker عام أو TrueNAS Scale بدل الاعتماد على الفحص التلقائي الخاص بـ Unraid. يفعل ملف compose العام ذلك. يغيّر عُرف appdata الاحتياطي، وافتراضيات وجهات الاستعادة بين المثيلات، وهل تُجرَّب أصلًا خطوات الإشعار/الإضافة المرافقة الخاصة بـ Unraid (راجع internal/platform).
BOMBVAULT_SELF_CONTAINER لا اسم حاوية BombVault نفسها، حتى لا ينسخ نفسه (وبالتالي لا يوقفها) أبدًا.
BACKUP_MAX_HOURS لا أقصى عدد ساعات من الوقت الحقيقي يستطيع تشغيل نسخة واحد أن يحتفظ فيها بقفل قسمه قبل أن يُلغى قسرًا (حماية حتى لا يحجب تشغيل عالق القسم إلى الأبد). الفارغ (الافتراضي) يستخدم 48. ارفعه للنسخ السحابية الكبيرة أو البطيئة جدًا (التشغيل الملغى عند الحد يفشل بـ context deadline exceeded). اضبط 0 لتعطيل الحد كليًا. يخضع التقليم للحد نفسه، ويعمل الفحص أو التقليم ما دام restic يواصل الإبلاغ عن التقدم.
BACKUP_STALL_HOURS لا الساعات التي يجوز فيها لنسخة أن لا تتقدم أبدًا قبل أن تُلغى. الفارغ (الافتراضي) يستخدم 2. اضبط 0 لعدم الإلغاء عند الركود أبدًا. هذا هو الأدق من الحمايتين وغالبًا هو الذي يُطلق: يراقب هل ما زال شيء يحدث لا كم استغرق التشغيل، فتُترك نسخة بطيئة لكن سليمة بحجم عدة تيرابايت، بينما تُوقف نسخة عالقة على مشاركة لا تستجيب خلال ساعات بدل أيام. يُسجَّل تحذير بعد 30 دقيقة من الصمت، قبل أن يُلغى أي شيء. المسح يُحتسب تقدمًا: لا يكتب restic بايتات بينما يتجول في شجرة كبيرة، وتُراقب تلك المرحلة عبر مجاميع ملفاتها وبايتاتها لا عبر البايتات المكتوبة. المتغيران مستقلان، ويبقى BACKUP_MAX_HOURS يحدّ المراحل بعد النسخة نفسها (الاحتفاظ والإحصاءات والنسخ خارج الموقع)، حيث لا عدّادات تُراقب.
DB_DUMP_MAX_HOURS لا الساعات التي يجوز لتفريغ قاعدة بيانات تلقائي واحد أن يعمل فيها قبل أن يُوقف. الفارغ (الافتراضي) يستخدم 6. القيم المسموحة من 1 إلى 48، ويُبقى الحد أقل بساعة من BACKUP_MAX_HOURS (عند نصفه حين يكون أقل من ساعتين)، فيُقطع تفريغ طويل بحده الخاص ويُبلَّغ عنه كذلك بدل أن يسقط معه النسخة. التفريغ الذي لا يتقدم يُوقف أبكر، بعد BACKUP_STALL_HOURS. التفريغ الموقوف يفشل وحده وتستمر نسخة الحاوية. في Unraid أضفه إلى حاوية BombVault بـ Add another Path, Port, Variable.
TZ لا المنطقة الزمنية للمجدول (مثل Europe/Berlin). إذا تُركت غير مضبوطة تعمل كل الجداول بتوقيت UTC: جدول مضبوط على 02:30 يُطلق حينئذ عند 02:30 UTC لا حسب ساعتك الجدارية. في Unraid لا تضبط هذا بنفسك أبدًا: يمرّر النظام منطقته الزمنية إلى كل حاوية. يقول سجل الإقلاع أي منطقة حلّها. المنطقة بتوقيت صيفي تتخطى تشغيلًا في الربيع وتشغّل واحدًا مرتين في الخريف، بينما لا يفعل UTC هذا ولا ذاك لكنه ينحرف ساعة عن ساعتك مرتين في السنة.
DATA_DIR لا حيث يحتفظ BombVault بقاعدة بياناته ومفاتيحه وذاكراته المؤقتة (الافتراضي /config). دعه كما هو في الحاوية. يهم عند تشغيل الملف الثنائي خارج Docker.
FLASH_DIR, FLASH_TEMPLATES_DIR لا أين يُركَّب الفلاش وقوالب Docker الخاصة به داخل الحاوية (الافتراضيان /host/boot و/host/boot/config/plugins/dockerMan/templates-user). يتبعان تركيب /boot في القالب، لذا اتركهما غير مضبوطين.
MODE لا full (الافتراضي) يشغّل التطبيق كله. node يشغّل عقدة: بلا واجهة ويب وبلا جداول خاصة بها، فقط ما يأمرها به مثيلها الأم. أي قيمة أخرى توقف البدء مع رسالة. يملؤه المثيل الأم لك في ملف compose الخاص بالعقدة.
NODE_HOME على العقدة إلى أي مثيل أم تنتمي العقدة، مع مفتاح المثيل الأم ومُرحِّله، في قيمة واحدة تبدأ بـ bvhome1.. يكتبه المثيل الأم في ملف compose الخاص بالعقدة. بدونه تبدأ العقدة، لكن لا يصل إليها أي مثيل أم. العقدة التي تبنّاها مثيل أم ترفض البدء حين يسمّي NODE_HOME مثيلًا أمًّا آخر، إلى أن يحررها الأول.
NODE_NAME لا اسم العقدة، كما ملأه المثيل الأم من الاسم الذي أعطيتها إياه.

التركيبات

ركّب مقبس Docker والفلاش (/boot) وجذر Host Data (/mnt) كما في قالب CA. مصادر النسخ الاحتياطي ووجهاتها كلاهما يقع تحت Host Data، ويُركَّب slave حتى تصبح مشاركة بعيدة تُركَّب بعد بدء الحاوية (مثلًا تحت /mnt/remotes) مرئية دون إعادة تشغيل.

في TrueNAS يكون Host Data مسار مجموعة بيانات مثل /mnt/tank، لا ixVolume أبدًا. البيانات التي يحتفظ بها تطبيق في ixVolume تقع خارجه ولا تُنسخ. راجع TrueNAS SCALE.

تحتاج نسخ مجموعات بيانات ZFS إلى هذا الوضع أيضًا: لا يركّب المضيف لقطة مجموعة بيانات إلا بعد بدء الحاوية. راجع مجموعات بيانات ZFS.

تقع المستودعات المحلية افتراضيًا في /mnt/user/bombvault/{container,vms,flash,config,files,zfs}، وتُنشأ في أول نسخة. هي المجلدات الخاصة للأقسام وتشكل الوجهة محلي. في صفحتها تحت الوجهات تغيّر بطاقة الاتصال مجلد كل قسم.

يمكن أيضًا أن يقع المجلد الخاص بقسم في وجهة تملكها بالفعل، مثل NAS أو حاوية S3: ينقله استخدام مجلدًا خاصًا في صفحة تلك الوجهة إلى هناك ويقول أولًا ما يحدث للنسخ المأخوذة سابقًا. راجع المجلد الخاص بقسم.

تبقى مجلدات المستودعات المحلية بالأذونات 0755 و0644، فلا يُحرم مستخدم مزامنة غير root عبر SMB، والمستودعات مشفرة، لذا لا يكشف هذا شيئًا. تعيش تعريفات الاسترداد داخل كل مستودع، فالمجلد المنسوخ كامل بذاته. ويبقى مستودع النسخ الذاتي قابلًا للقراءة لـ root فقط.

فحص تكامل المضيف

تفحص بطاقة تكامل المضيف في النظرة العامة (أضفها تحت تخصيص) كل تركيب وكل أداة سطر أوامر (مقبس Docker وlibvirt وrestic وqemu-img وrclone) وتبلّغ عن أي نقص.

اكتشاف مصدر النسخ الاحتياطي

لكل حاوية يختار BombVault تلقائيًا أي bind mounts والأحجام المسماة تُنسخ. يُلتقط مسار حين ينطبق أي مما يلي (ويمكنك دائمًا تجاوز النتيجة في بطاقة مجلدات النسخ الاحتياطي في تبويب إعدادات الحاوية):

  • مطابقة مقطع جذر البيانات: يحتوي مصدر bind على المضيف على أحد مقاطع DATA_ROOT_SEGMENTS كمكوّن مسار كامل (الافتراضي appdata فقط).
  • أحجام Docker المسماة تُضمَّن دائمًا، لأنه لا مقابل مؤقتًا لها ولا شيء ليُصفّى، لكن فقط حين يكون مسار تخزين الحجم الحقيقي على المضيف نفسه قابلًا للوصول عبر تركيب Host Data، تمامًا كأي مسار مضيف آخر ينسخه BombVault. يخزّن مشغّل أحجام Docker المحلي الافتراضي الحجم تحت جذر بيانات الخفي نفسه (/var/lib/docker/volumes/<name>/_data ما لم تخصصه. تحقق بـ docker info -f '{{.DockerRootDir}}')، وهو غير مغطى بتركيب Host Data الضيق ذي المجلد الواحد الذي يستخدمه docker-compose.yml العام افتراضيًا. الحجم غير القابل للوصول يُتخطى بصمت، وليس خطأ. لنسخ الأحجام المسماة فعلًا على مضيف عام، وجّه Host Data (وHOST_SOURCE_ROOT) إلى سلف مشترك يغطي أيضًا جذر بيانات Docker. يشرح تعليق Host Data في ملف compose المفاضلة (يتجنب Unraid ذلك بتركيب كل /mnt، عُرفه الشامل على المستوى الأعلى، للسبب نفسه).
  • دليل مشروع Docker Compose: إذا حملت الحاوية الوسم القياسي com.docker.compose.project.working_dir (يضعه docker compose up تلقائيًا)، فيُضاف ذلك الدليل أيضًا، سواء طابق أي bind مقطع جذر بيانات أم لا.
  • تجاوز بالوسم bombvault.data: اضبط الوسم bombvault.data=true على حاوية لتضمين كل bind mounts لها، لتخطيط لا يلتقطه أي من العُرفين أعلاه (مثلًا bind واحد /srv/plex/config بلا مشروع Compose). أي قيمة غير فارغة غير false تُعدّ صحيحة. الوسم الغائب أو bombvault.data=false لا يغيّر شيئًا.
  • الوسم bombvault.dbdump: اضبط bombvault.dbdump=false على حاوية لتعطيل تفريغ قاعدة بياناتها التلقائي (0 وno وoff تفعل الشيء نفسه)، أو سمِّ المحرك (postgres أو mysql أو mariadb) لتفريغ حاوية لا يتعرف عليها BombVault بنفسه. يتغلب الوسم على المفتاح في بطاقة قاعدة البيانات في تبويب إعدادات الحاوية، وهو الطريقة في Unraid.

نموذج الأمان

تحكم يعادل root في المضيف

عبر مقبس Docker يستطيع BombVault إيقاف الحاويات وإزالتها وإعادة إنشائها وقراءة appdata وكتابتها، وللنسخ الاحتياطي للأجهزة الافتراضية يسجّل الدخول إلى المضيف عبر SSH (qemu+ssh://، root افتراضيًا) ليشغّل virsh. كل من يستطيع الوصول إلى واجهة الويب لديه فعليًا root على المضيف.

الدخول

  • حماية اختيارية بكلمة مرور (بطاقة كلمة المرور ضمن الإعدادات، الأمان): اضبط كلمة مرور لتطلب الدخول، وامسحها للتعطيل. معطّلة افتراضيًا للاستخدام في شبكة محلية موثوقة. تُخزَّن كلمة المرور بـ Argon2id فوق فلفل مرتبط بـ APP_KEY، فيكون /config منسوخ بلا قيمة بدون المفتاح وبطيئًا في مهاجمته حتى معه. تحتاج كلمة المرور الجديدة إلى 12 حرفًا على الأقل. وتستمر كلمة مرور أقصر موجودة في العمل إلى أن تُغيَّر. الجلسات موقّعة (HMAC مشتق من APP_KEY) وتغيير كلمة المرور يبطلها. الدخول محدود بخمس إخفاقات في الدقيقة لكل عميل. وتغيير كلمة المرور أو مسحها يطلب كلمة المرور الحالية ومع تفعيل المصادقة بخطوتين الرمز.
  • بعض الأمور تحتاج إلى كلمة مرور. تنزيل حقيبة الاستعادة وبلاغ الخطأ وملف ZIP لنسخة فلاش، وتصدير نسخة فلاش أو نسخة ذاتية، وإيداع المفتاح لدى حافظ مفتاح، والسماح بتسليم إيداع، وإنشاء رمز استعادة جديد، وتصدير الإعدادات مع بيانات الاعتماد، والمصادقة بخطوتين ومفاتيح المرور، وإضافة عقدة، وعرض ملف compose لعقدة من جديد، وفتح عناصر عقدة، كلها مرفوضة إلى أن تُضبط كلمة مرور دخول، وتحتاج إلى تسجيل دخول على المثيل نفسه. حذف النسخ يعمل دون كلمة مرور، وإن ضُبطت واحدة فهو يحتاج أيضًا إلى تسجيل الدخول هذا.
  • الوجهة لا تُظهر كلمة مرور. قد تحمل الوجهة بيانات اعتماد، كما في rest:https://user:password@host/repo، وكل صفحة وكل إجابة API تعرضها بالشكل rest:https://[redacted]@host/repo، بكلمة مرور دخول أو بدونها. غيّر المسار الذي خلفها وتبقى كلمة المرور المخزَّنة. ولتوجيه الوجهة إلى خادم آخر اكتب الوجهة كاملة مع كلمة مرورها، لأن كلمة المرور المخفية تبقى مع خادمها.
  • المصادقة بخطوتين (الإعدادات، الأمان): رمز زمني من تطبيق مصادقة فوق كلمة المرور، إضافةً إلى ثمانية رموز استعادة تُستخدم مرة واحدة وتُسلَّم مرة واحدة عند تفعيلها. يُخزَّن السر المشترك مشفرًا بـ APP_KEY، وإيقاف العامل ثانيةً يتطلب رمزًا حاليًا.
  • مفاتيح المرور (WebAuthn) في بطاقتها الخاصة حين تُضبط كلمة مرور، بجانب كلمة المرور ولا بديلًا عنها أبدًا، فإزالة كل مفتاح مرور لا تُقفل أحدًا. تحتاج إلى اسم نطاق حقيقي وشهادة يثق بها المتصفح. العنوان الافتراضي https://<ip>:3443 هو بالضبط ما يرفضه WebAuthn، وتقول البطاقة ذلك بدل أن تعرض زرًا يفشل. ومع تفعيل المصادقة بخطوتين يجب أن يتحقق مفتاح المرور من PIN أو بصمة أو وجهك، وإلا يطلب الدخول الرمز أيضًا.
  • استعادة إعدادات (استعادة الإعدادات في معالج الطوارئ) تنهي كل جلسة وتزيل كل مفتاح مرور وتلغي كل رمز API ومفتاح MCP، لأن الإعدادات المستعادة قد تعيد ما أُزيل بعد حفظها. سجّل الدخول بكلمة المرور وأعد إعداد مفاتيح المرور ضمن الإعدادات، الأمان.
  • تُعاد تعيين كلمة المرور المنسية في صفحة الدخول. يجعل نسيان كلمة المرور؟ BombVault يكتب رمزًا من 12 حرفًا، في ثلاث مجموعات من أربعة، في سجل حاويته (في Unraid: تبويب Docker، أيقونة BombVault، السجلات). يسجّل ذلك الرمز وكلمة مرور جديدة دخولك. وتعطّل إعادة التعيين أيضًا المصادقة بخطوتين، وتزيل كل مفتاح مرور، وتلغي كل رمز API ومفتاح MCP وتسجيل دخول OAuth، وتنهي كل جلسة أخرى، وتُخرج كل هاتف مقترن، وتوقف اقتران الهواتف. تسرد الصفحة بعد ذلك ما ذهب. الرمز صالح 10 دقائق، والتخمينات الخاطئة لا تستهلكه. تبقى رموز الودجة والمقاييس لأنها تقرأ فقط.
  • كل من يستطيع قراءة سجل الحاوية يستطيع إعادة تعيين كلمة المرور. هذا root على المضيف، وكذلك عارض سجلات مثل Dozzle، وأي حاوية مُنحت مقبس Docker (القراءة فقط تكفي)، وشاحن سجلات يعيد توجيه مخرجات الحاويات. امنح هذه فقط لمن تثق بهم بكلمة المرور. من يصل إلى واجهة الويب فحسب لا يرى الرمز أبدًا.

الهواتف وأعضاء المجموعة

  • تصل الهواتف المقترنة إلى قائمة سماح. الهاتف الذي يعرف الكلمات الاثنتي عشرة للمجموعة يسجّل الدخول دون كلمة المرور، ما دام يمكن للهواتف الاقتران بالكلمات الاثنتي عشرة للمجموعة مفعّلًا في بطاقة تطبيق Android ضمن الإعدادات، الأمان. لا تصل جلسته إلا إلى ما يعرضه التطبيق: النظرة العامة والتشغيلات والنسخ الاحتياطية للاطلاع والبدء والاستعادة والحالات الشاذة للقراءة وصفحة المثيلات للاطلاع. تصله الوجهات والأوامر وقد أُزيلت عناوينها وأسرارها، والاستعادة التي تستبدل الأصل تنسخ الحالة الحالية أولًا. والاستعادة إلى مجلد لا تقبل إلا مجلدًا جديدًا أو فارغًا داخل مجلد الاستعادة، ولا يستطيع الهاتف النظر في أي مجلد آخر. كل ما عدا ذلك يجيب بأنه يحتاج إلى تسجيل دخول على المثيل نفسه: المفاتيح وحقيبة الاستعادة وإيداعات المفاتيح والإعدادات وحذف النسخ. تُوقف إعادة تعيين كلمة المرور اقتران الهواتف إلى أن تفعّله ثانية. الهاتف المزال من صفحة المثيلات، أو الذي عُطّل الاستعلام عن هذه النسخة في تفاصيله، يفقد جلسته فورًا، ويعود الهاتف المزال الذي يفتح تطبيقه من جديد معطّلًا.
  • خارج المنزل يفتح الهاتف الصفحات عبر المُرحِّل. يُختم كل طلب في الصفحة بمفتاح المجموعة، الذي لا يستطيع المُرحِّل قراءته ولا تغييره، ويُوقَّع بمفتاح خاص بالهاتف يثبّته الخادم عند أول نداء من الهاتف ويسمح له بالدخول بعد أن يوافق أحد على الهاتف في صفحة الاقتران. ينفّذ الخادم طلبًا مرة واحدة وما دام حديثًا فقط. ولا يجيب إلا هاتفًا مسرودًا في صفحة المثيلات ما دام اقتران الهواتف مفعّلًا، ولا يجيب إلا بجلسة منحها لذلك الهاتف، فتُنهي كل من الخروج في كل مكان وإعادة تعيين كلمة المرور هذه الصفحات أيضًا. يوقّع الخادم كل إجابة، ويتحقق التطبيق من التوقيع بالمفتاح الذي ثبّته لذلك الخادم ويحذّر حين يتغير المفتاح. تصل مثل هذه الصفحة إلى قائمة السماح نفسها التي يصل إليها هاتف مقترن، بكلمة مرور دخول أو بدونها، إضافة إلى حالة الدخول التي تقرؤها الصفحة أولًا. يبقى تسجيل الدخول والخروج وإعادة تعيين كلمة المرور والتنزيلات على عنوان الخادم نفسه، والإجابة الواحدة محدودة بـ 16 ميغابايت.
  • يوقّع الأعضاء ما يطلبونه. طلبات الأدوار وإجاباتها، وعروض التخزين، وتسليم كلمة مرور restic لمستقبِل أو ساحب، وبيانات دخول المستقبِل وإيداعات المفاتيح، تُوقَّع بمفتاح كل عضو، يثبّته المثيل أول مرة يرى فيها ذلك العضو. النداء الموقّع بمفتاح آخر يُرفض. يُسقط نسيان المفتاح في تفاصيل مثيل المفتاح المثبَّت، لحالة أن المعروف هنا ليس مفتاح العضو نفسه. يُطلب من العضو مفتاحه ثانية عند ندائه الموقّع التالي. الأعضاء على BombVault 9.x لا يوقّعون ويمكن انتحال صفتهم من أي شخص يملك الكلمات، كما في 9.9. ويُرفض طلب الدور أو عرض التخزين من عضو على 10.4 أو أقدم إلى أن يُحدَّث ذلك العضو.
  • الكلمات الاثنتا عشرة كلمة مرور. كل من يملكها ينضم إلى المجموعة ويرى حالة حماية الأعضاء ويستطيع طلب أدوار، يجب مع ذلك أن يسمح بها شخص على المثيل الآخر. وبدون كلمة مرور دخول يستطيع كل من يفتح واجهة الويب قراءتها، وتقول بطاقة الاقتران ذلك إلى أن تُضبط كلمة مرور.

المفاتيح

  • APP_KEY يفعل أمرين. يختم ما يخزّنه هذا التثبيت (كلمات المرور وبيانات الاعتماد والرموز) وهو مفتاح النسخ الاحتياطية: تُشتق منه كلمة مرور restic، وتُختم به تعريفات الحاويات والأجهزة الافتراضية.
  • المفتاح المتبنَّى يُحفظ منفصلًا. حين يتولى معالج الطوارئ نسخ خادم آخر، يواصل هذا التثبيت الختم بـ APP_KEY الخاص به ويخزّن مفتاح الخادم الآخر كـ مفتاح النسخ، مختومًا مثل كل سر آخر. تطبع حقيبة الاستعادة حينئذ الاثنين. إذا غُيّر APP_KEY بعد ذلك، لا يعود مفتاح النسخ قابلًا للفتح: يتوقف BombVault عن النسخ ويقول ذلك تحت يحتاج إلى اهتمام، بدل الكتابة بمفتاح خاطئ. ارفع حقيبة الاستعادة ثانية تحت استعادة، الطوارئ، أو أعد APP_KEY. راجع معالج الطوارئ.
  • التشفير مفعّل افتراضيًا (تشفير النسخ الاحتياطية في بطاقة التشفير ضمن الإعدادات، الأمان). يشفّر restic النسخ بكلمة المرور المشتقة من مفتاح النسخ.
  • إيداعات المفاتيح. يحتفظ حافظ مفتاح في مجموعتك بنسخة مختومة من حقيبة استعادة هذا الخادم لا يستطيع فتحها بنفسه. لا يفتحها إلا رمز الاستعادة المؤلف من 20 حرفًا، ولا يسلّمها الحافظ إلا بعد أن يضغط شخص عنده سماح. راجع حافظ المفتاح.

العُقد

العقدة هي BombVault بلا واجهة ويب تتلقى أوامرها من مثيل أم.

  • المثيل الأم يمسك العقدة. تركّب العقدة مقبس Docker لخادمها، أي صلاحيات root هناك، والمثيل الأم يتحكم بالعقدة. إذا استولى مهاجم على المثيل الأم فإنه يتحكم أيضًا بكل عُقده. اضبط للمثيل الأم كلمة مرور دخول وأبقِ واجهة الويب الخاصة به بعيدة عن الإنترنت.
  • العقدة تحمل القليل. إذا استولى مهاجم على عقدة فلا يحصل على مجموعة اقتران ولا حصن ولا عقدة أخرى ولا مستودع آخر. ليس لدى العقدة إلا رابط إلى مثيلها الأم وحده، وبيانات دخول خاصة بها على خادم الاستقبال، ومجلد خاص بها في وجهة. على خادم الاستقبال لا تستطيع حذف السجل، لأن الخادم append-only. لكنها تستطيع ملء قرص الخادم، لأن rest-server لا يضع حصة، لذا أعطِ خادم الاستقبال مساحة كافية أو مشاركة خاصة به. وفي الوجهة تستطيع بيانات اعتمادها عادةً حذف ما هو موجود هناك. النسخ المحفوظة على العقدة تصبح في يد المهاجم، ولهذا يسحب المثيل الأم نسخة منها.
  • الرابط خاص وموقَّع. يتحدث المثيل الأم والعقدة عبر المُرحِّل من خلال رابط خاص بهما، مختوم بسر مشتق من APP_KEY الخاص بالعقدة. كل طرف يعرف مفتاح الآخر قبل المكالمة الأولى، فلا توجد خطوة موافقة. يوقّع المثيل الأم كل مكالمة بمفتاحه وبعدّاد، وترفض العقدة أي مكالمة لم يوقّعها المثيل الأم أو سبق أن تلقتها. ولا تستدعي العقدة شيئًا لدى المثيل الأم سوى تحيتها الأولى.
  • المثيل الأم يصل إلى قائمة ثابتة. الطلبات التي يمررها المثيل الأم إلى عقدة لا تعمل إلا على قائمة ثابتة من مسارات العقدة، مسرودة في GET /api/nodes/routes، وتجيب عنها العقدة بصيغة JSON فقط. لا شيء في القائمة يحذف، أو يصل إلى الإعدادات أو التخزين أو المفاتيح أو المجموعة أو الرموز. وعلى المثيل الأم تحتاج إلى تسجيل دخول بكلمة المرور: لا تصل الهواتف المقترنة ولا رموز API ولا مفاتيح MCP إلى عقدة. النسخ والاستعادات التي تبدأ بهذه الطريقة تظهر على أنها بدأها المثيل الأم.
  • إيداعات المفاتيح تحمل مفاتيح العقد. يحتفظ المثيل الأم بـ APP_KEY كل عقدة، وتطبعه حقيبة الاستعادة في فصلها العقد، لذا تحمله وديعة المفتاح أيضًا. حافظ المفتاح الذي يحصل على الوديعة ورمز الاستعادة يستطيع فتح مستودعات عُقدك، لكنه لا يستطيع أن يأمر عقدة، لأن ذلك يحتاج إلى توقيع المثيل الأم.
  • التحرير نهائي. العقدة المحرَّرة لا تقبل مثيلًا أمًّا مرة أخرى بنفس APP_KEY. والعقدة الغائبة حين تحررها تعرف ذلك من المثيل الأم حين تعود.

الشبكة

  • التغييرات تحتاج JSON. الطلب الذي يغيّر شيئًا يجب أن يرسل Content-Type: application/json ولا يجوز أن يعلّمه المتصفح كعابر للمواقع، فلا تستطيع صفحة على موقع آخر أن تجعل متصفحك يغيّر إعدادات على عنوان في الشبكة المحلية. السكربت الذي يقود الواجهة يرسل هذه الترويسة. وكل شيء آخر يُرفض بـ 415.
  • ولأن البوابة اختيارية، فحين لا تُضبط تكون الواجهة كلها وواجهة API (بما فيها الوجهات ومسارات اختبار العبث ومسارات الاستعادة) في متناول كل من يصل إلى المنفذ. اضبط كلمة مرور دخول متى استُخدمت نسخ append-only خارج الموقع أو التشفير.
  • شغّل BombVault فقط على شبكة موثوقة غير معرّضة. للوصول عن بُعد ضعه خلف وكيل عكسي يضيف المصادقة وTLS. تحمل الإجابات ترويسات أمان أساسية (CSP وnosniff وX-Frame-Options وReferrer-Policy).
  • خلف وكيل عكسي يحمل كل طلب عنوان الوكيل، لذا بدون TRUSTED_PROXY يعدّ مقيّد الدخول كل العملاء في سلة واحدة وتحجبك إخفاقات مهاجم أنت أيضًا. سمِّ الوكيل في TRUSTED_PROXY لاستعادة العدّ لكل عميل.
  • يجب أن يمرّر وكيل عكسي أمام BombVault الترويسة Authorization أو X-API-Key إلى /mcp ولا يخزّن إجاباته مؤقتًا، وإلا لا يستطيع المساعدون الاتصال. راجع خادم MCP.
  • تجيب نقطة نهاية MCP /mcp بـ 404 إلى أن يوجد مفتاح أو يُفعَّل الدخول عبر OAuth، وتطلب من كل عميل مفتاحه أو رمزه حتى مع تعطيل كلمة مرور الدخول. لا عنوان معفى، ولا localhost حتى. ليست فيها أدوات استعادة أو حذف، واستعادة نسخة إعدادات تلغي كل مفتاح. راجع خادم MCP.
  • مع HTTP_ONLY=true تفقد كعكة الجلسة العلم Secure (يجب ذلك لتعمل على HTTP عادي)، لذا فعّل كلمة المرور خلف وكيل ينهي TLS فقط إن كانت السرية مهمة.
  • يثق اتصال SSH لنسخ الأجهزة الافتراضية بمفتاح المضيف عند أول اتصال (TOFU) ثم يثبّته. تحقق من مفتاح المضيف بطريقة أخرى إذا لم يكن المسار من الحاوية إلى المضيف موثوقًا.
  • الروابط لا تقود إلى خارج نقطة التحميل. تتوقف النسخة الاحتياطية أو الاستعادة في المكان برسالة حين يقود رابط فوق مسارها إلى خارج نقطة تحميل المضيف، لأن حاوية تكتب في مشاركتها الخاصة قد تزرع رابطًا كهذا. وتُرفض بالطريقة نفسها الوجهة التي يبدأ مضيفها أو remote الخاص بـ rclone بشرطة، عند الحفظ وعند التشغيل التالي، لأن ssh أو rclone سيقرؤه خيارًا.

خادم MCP

لا يحتاج خادم MCP إلى متغير بيئة. تفعّله بإنشاء مفتاح ضمن الإعدادات، التكاملات، خادم MCP، ويجيب على /mcp عبر المنفذ نفسه لواجهة الويب (مثل https://192.168.1.10:3443/mcp). بدون مفتاح نشط يجيب ذلك المسار بـ 404. تُوصف العملاء والشهادات والحدود في خادم MCP.

نسخ الأجهزة الافتراضية عبر SSH

ينسخ BombVault أجهزة KVM/libvirt الافتراضية دون تركيب أي مسار libvirt. يشغّل virsh على المضيف عبر SSH (qemu+ssh://)، لذلك لا يستطيع أبدًا التأثير في VM Manager على مضيفك.

تركيب مقبس libvirt للمضيف في حاوية هش في Unraid: يملك VM Manager تلك المسارات، وتبديل «Enable VMs» قد يترك libvirt عاجزًا عن البدء. يمنح مفتاح SSH صلاحية root على المضيف، وهو مستوى الثقة نفسه لمقبس Docker الذي يستخدمه BombVault بالفعل.

إعداد سريع:

  1. الإعدادات، التكاملات، SSH المضيف: انسخ المفتاح العام المعروض.
  2. أضفه إلى /root/.ssh/authorized_keys في Unraid (ويُحفظ أيضًا على الفلاش ليبقى بعد إعادة التشغيل).
  3. اضغط اختبار الاتصال.

يضيف القالب --add-host=host.docker.internal:host-gateway ليصل الحاوية إلى المضيف. اضبط LIBVIRT_HOST على IP الشبكة المحلية لجهاز Unraid إن لم يُحلّ ذلك الاسم (مثلًا حين تعمل الحاوية على شبكة br0.x مخصصة). وإذا غيّرت منفذ SSH في Unraid فاضبط LIBVIRT_SSH_PORT ليطابقه. تحتاج اللقطات الحية أيضًا إلى وكيل qemu guest agent في الجهاز الافتراضي وإلى القرص على /mnt/cache (لا /mnt/user).

الدليل الكامل لإعداد الأجهزة الافتراضية والشبكة

الدليل الكامل خطوة بخطوة (تفعيل SSH، تخويل المفتاح الدائم، توجيه الشبكة المخصصة وVLAN، الطريقة لكل جهاز افتراضي واستكشاف الأخطاء على جانب المضيف) هو دليل نسخ الأجهزة الافتراضية.

إعداد خارج الموقع

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

  • الواجهات الخلفية: SMB/CIFS وWebDAV عبر rclone دون تركيب على المضيف، وNFS (ركّب التصدير على المضيف واستخدمه كمجلد محلي)، وواجهات restic الأصلية بلا rclone (s3:... وrest:http://host:8000/repo وsftp:user@host:/repo)، أو أي rclone remote (rclone:<remote>:<bucket>/path). ليس لـ Backblaze B2 هنا واجهة خلفية أصلية: صِل إليه عبر نقطة نهاية S3 الخاصة به (s3:https://s3.<region>.backblazeb2.com/<bucket>/<path>) مع معرّف المفتاح ومفتاح التطبيق كبيانات اعتماد S3.
  • بيانات الاعتماد تُخزَّن مشفرة، كقائمة واحدة من بيانات الاعتماد المحفوظة في بطاقة بيانات الاعتماد ضمن الإعدادات، الوجهات. تعلّم نجمة الافتراضي، الذي يُستخدم حيث لا تُختار أي بيانات. تختار صفحة الوجهة نفسها ما تستخدمه في بطاقة بيانات الاعتماد الخاصة بها. راجع بيانات الاعتماد.
  • أهداف SSH لا تحتاج إلى تثبيت شيء على الطرف البعيد. يحتاج sftp: إلى خادم SSH فقط. أضف المفتاح العام من الإعدادات، التكاملات، SSH المضيف (وهو أيضًا في /config/ssh/id_ed25519.pub) إلى ~/.ssh/authorized_keys لمستخدم الهدف، أو دع إضافة المفتاح في إضافة وجهة يضعه هناك بكلمة مرور الحساب.
  • rest-server بشهادة موقّعة ذاتيًا: ضع شهادته، أو شهادة الجهة التي وقّعتها، كملف PEM في مجلد certs ضمن مجلد بيانات BombVault (/config/certs في الحاوية، appdata/bombvault/certs في Unraid). تثق بها النسخ والنسخ خارج الموقع واختبار الحماية من الحذف دون إعادة تشغيل.
  • النسخ خارج الموقع: ينسخ BombVault اللقطات الجديدة بـ restic copy بأفضل جهد، فوق (محلي عادةً) أساسي. تحدد بطاقة نسخ للوجهة هل تنسخ بعد كل نسخة احتياطية أم وفق خطة خاصة، والإعدادات، الجدول الزمني، النسخ الخارجية لكل قسم تعطي قسمًا واحدًا خطة نسخ خاصة. يقع النسخ الآن في صف القسم من بطاقة نسخ خارج الموقع ضمن الإعدادات، الوجهات.
  • عدة وجهات لكل قسم: تبدّل بطاقة الوجهات لكل قسم في صفحة الوجهات كل سطر من قسم إلى وجهة بنقرة واحدة، محلي أيضًا. القسم الذي له وجهات خارج الموقع فقط ينسخ إليها مباشرة، والذي كل سطوره معطّلة لا يُنسخ. تعطي القواعد لكل قسم للوجهة قسمًا مستودعه أو احتفاظه أو ضغطه الخاص هناك.
  • التوزيع لكل عنصر: تضيء كل حاوية وجهاز افتراضي ومجموعة مجلدات محلي والوجهات التي تحصل على نسخها، في بطاقة الجدول الزمني والوجهة في تبويب إعداداتها. العناصر التي لا اختيار خاصًا لها تتبع قسمها. راجع التوزيع لكل عنصر.
  • الاحتفاظ: تحتفظ كل وجهة بالنسخ وفق بطاقة مدة الاحتفاظ، ويمكن لقسم أن يحتفظ بقيمه الخاصة هناك تحت القواعد لكل قسم. يشمل ذلك النسخة في حقل خارج الموقع لقسم. الأصفار كلها لا تقلّم لقطات الوجهة أبدًا.
  • حدود النطاق: حدّ معدل رفع/تنزيل restic في بطاقة نطاق التراسل خارج الموقع ضمن الإعدادات، الوجهات، أو لكل وجهة في بطاقة نسخ الخاصة بها. تدخل KiB/s، ويعرض الحقل المعدل نفسه بالميغابايت/ث وميغابت/ث.
  • البث أولًا: في بطاقة البث في صفحة الوجهات اختر خوادم الوسائط (Plex وJellyfin وEmby محددة مسبقًا باسم الصورة)، ومعدل الإرسال الذي يُعدّ منه البث، وحد الرفع أثناء البث، ومتى يعود الحد العادي بعد البث.
  • فئة التخزين البارد والأرشيفي (S3): لوجهة S3 اختر في صفحتها طبقة قابلة للاستعادة (Standard وStandard-IA وOne Zone-IA وIntelligent-Tiering وGlacier Instant Retrieval). تضبط rclone remotes فئتها في إعداد rclone.
  • مجلد خاص في وجهة بدل المحلي: يمكن لمجلد قسم الخاص أن يقع في إحدى الوجهات أعلاه، دون نسخة محلية ودون خطوة نسخ. راجع المجلد الخاص بقسم.

الحالات الشاذة

لا يحتاج اكتشاف الحالات الشاذة إلى متغير بيئة. يُعدّ في بطاقة الحالات الشاذة ضمن الإعدادات، تحقق، ويوصف في الحالات الشاذة.

الإعدادات القابلة للنقل (التصدير والاستيراد)

تكتب بطاقة تصدير / استيراد الإعدادات ضمن الإعدادات، النظام كامل تهيئة BombVault (إعدادات الأقسام والوجهات والجداول والاحتفاظ والإشعارات) في ملف JSON قابل للنقل يمكنك استيراده على مثيل آخر، فالانتقال إلى جهاز جديد أو استنساخ إعداد لا يعني إعادة إدخال كل شيء يدويًا. يعرض الاستيراد معاينة ويطلب تأكيدًا، ولا يمس أبدًا بيانات نسخك الاحتياطية أو تاريخها. تُترك الروابط في الملف إلى وجهات أو مستودعات لم تعد موجودة، وتسمّيها المعاينة. وبينما تعمل نسخة ZFS متماثلة يُرفض الاستيراد قبل أن يُكتب أي شيء.

قد يحتوي التصدير على بيانات اعتماد

أنت تختار هل تُضمَّن في الملف بيانات اعتماد النسخ خارج الموقع والإشعارات ووسيط MQTT. مع تضمين بيانات الاعتماد يكون التصدير بحساسية حقيبة الاستعادة نفسها، فاحفظه في مكان آمن. وبدونها يحتوي الملف على الإعدادات غير السرية فقط.

لا ينتقل APP_KEY مع الملف

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