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

العُقد

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

بطاقة العقدة vps-falkenstein في صفحة المثيلات: متصل، وإصدارها، ونسخها على خادم الاستقبال، ومتى ينسخ كل قسم، وتغيير الوجهة واستبدال وتحرير. بطاقة العقدة vps-falkenstein في صفحة المثيلات: متصل، وإصدارها، ونسخها على خادم الاستقبال، ومتى ينسخ كل قسم، وتغيير الوجهة واستبدال وتحرير.

كيف تعمل

  • المثيل الأم يحمل مفتاح العقدة. حين تضيف عقدة، ينشئ المثيل الأم APP_KEY الخاص بها، ويحتفظ بنسخة مختومة منه، ويسلّمه لك مرة واحدة في ملف compose الخاص بالعقدة. بهذه النسخة يصل المثيل الأم إلى العقدة ويفتح نسخها الاحتياطية.
  • لا تحتاج العقدة إلى منفذ مفتوح. يتحدث المثيل الأم والعقدة عبر المُرحِّل من خلال رابط خاص بهما، منفصل عن مجموعة الاقتران لديك. المثيل الأم يبدأ كل مكالمة ويوقّعها، ولا تطلب العقدة منه شيئًا سوى تحيتها الأولى. الوجهة الوحيدة التي تحتاج إلى منفذ مفتوح هي الاحتفاظ بالنسخ على العقدة.
  • لا تعبر النسخ الاحتياطية المُرحِّل أبدًا. ترسلها العقدة مباشرة إلى المكان الذي اخترته: خادم الاستقبال في المثيل الأم، أو إحدى وجهات المثيل الأم، أو rest-server على العقدة نفسها.
  • لا تخطط العقدة لشيء بنفسها. فهي لا تشغّل جداول، ولا ترسل إشعارات، ولا تنضم إلى مجموعة أو حصن. المثيل الأم يبدأ نسخها الاحتياطية، ويتابع سيرها، ويرسل التنبيهات.
  • تنسخ العقدة الحاويات ومجموعات المجلدات. الأجهزة الافتراضية والفلاش ومجموعات بيانات ZFS والنسخ الذاتي تبقى للتثبيتات الكاملة.

يستخدم الرابط مُرحِّل المثيل الأم نفسه حين يكون لمجموعته مُرحِّل خاص، ومُرحِّل المشروع في غير ذلك، حتى لو كان المثيل الأم يقترن دون مُرحِّل.

قبل أن تبدأ

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

إضافة عقدة

  1. على المثيل الأم افتح المثيلات واختر إضافة عقدة أسفل اليمين.
  2. الاسم. اكتب الاسم الذي تظهر به العقدة هنا، كاسم الخادم مثلًا، واختر التالي.

    نافذة إضافة عقدة في خطوتها الأولى، وقد كُتب الاسم vps-helsinki. نافذة إضافة عقدة في خطوتها الأولى، وقد كُتب الاسم vps-helsinki.

  3. النسخ الاحتياطية. اختر إلى أين تذهب النسخ واملأ ما يطلبه ذلك المكان. النسخ الاحتياطي يوميًا في هو وقت بدء القسمين كليهما. يقترح المثيل الأم نصف ساعة بعد نسخه الاحتياطي لحاوياته، كي لا يتزاحم الاثنان على الأقراص نفسها في آن واحد. يمكنك لاحقًا أن تعطي كل قسم خطة خاصة به من البطاقة. اختر التالي.

    الخطوة الثانية: خادم الاستقبال مختار، وعنوان للعُقد مملوء بعنوان https، والنسخ الاحتياطي يوميًا في 03:00. الخطوة الثانية: خادم الاستقبال مختار، وعنوان للعُقد مملوء بعنوان https، والنسخ الاحتياطي يوميًا في 03:00.

  4. التشغيل. تعرض النافذة ملف compose الخاص بالعقدة وقد مُلئت فيه MODE وAPP_KEY وNODE_HOME وNODE_NAME. انسخه واحفظ APP_KEY في مكان آمن. على خادم العقدة:

    mkdir -p /opt/bombvault-node && cd /opt/bombvault-node
    nano docker-compose.yml   # paste the file from the window
    docker compose up -d
    

    قبل التشغيل وجّه وحدة التخزين Host Data إلى البيانات التي تريد نسخها، واضبط HOST_SOURCE_ROOT على المسار نفسه، كما يُظهر المثال أدناه.

  5. تنتظر النافذة العقدة. حين تجيب العقدة يخبرها المثيل الأم إلى أين تذهب نسخها ويتحقق من أنها تصل إليه، وتقول النافذة vps-helsinki متصلة وتتلقى أوامرها من هذا المثيل.

    الخطوة الأخيرة: ملف compose، ثم العقدة متصلة ونسخها موضوعة على خادم الاستقبال. الخطوة الأخيرة: ملف compose، ثم العقدة متصلة ونسخها موضوعة على خادم الاستقبال.

يمكنك إغلاق النافذة قبل أن تجيب العقدة. تقول بطاقتها حينئذ في انتظار العقدة، ويخبرها المثيل الأم إلى أين تذهب نسخها حين تظهر.

مثال: VPS ينسخ إلى خادم الاستقبال

المثيل الأم جهاز Unraid اسمه tower يشغّل خادم الاستقبال. وكيل عكسي ينشره باسم https://backup.tower.example.org. خادم VPS المسمى vps-helsinki يشغّل Nextcloud وCaddy وبياناتهما تحت /srv/appdata.

  1. على tower: المثيلات، ثم إضافة عقدة، والاسم vps-helsinki، ثم التالي.
  2. اختر خادم الاستقبال في هذا المثيل واكتب https://backup.tower.example.org تحت عنوان للعُقد. حاويات المثيل الأم تُنسخ عند 02:30، لذا تقترح النافذة 03:00. أبقِه كما هو واختر التالي.
  3. على VPS احفظ الملف من النافذة بعد تغيير وحدات التخزين وHOST_SOURCE_ROOT إلى /srv/appdata:

    services:
      bombvault-node:
        image: junkerderprovinz/bombvault:latest
        restart: unless-stopped
        hostname: bombvault-node
        container_name: bombvault-node
        volumes:
          - ./config:/config
          - /var/run/docker.sock:/var/run/docker.sock
          - /srv/appdata:/host/user
        environment:
          MODE: node
          APP_KEY: "<filled in by home>"
          NODE_HOME: "<filled in by home>"
          NODE_NAME: "vps-helsinki"
          PLATFORM: generic
          HOST_SOURCE_ROOT: /srv/appdata
    
  4. شغّل docker compose up -d. بعد ثوانٍ تقول النافذة على tower إن العقدة متصلة، وتذهب النسخ الاحتياطية إلى https://backup.tower.example.org.

  5. عند 03:00 يبدأ المثيل الأم النسخ الاحتياطي للعقدة. في صباح اليوم التالي تعرض بطاقة العقد في النظرة العامة آخر نسخة لـ vps-helsinki، وتسرد النسخ الاحتياطية حاوياتها في قسم خاص بها.

كيف تُعثر على بيانات حاوية على مضيف Docker عادي موصوف تحت اكتشاف مصدر النسخ الاحتياطي.

إلى أين تذهب النسخ الاحتياطية

لكل عقدة وجهة واحدة لقسميها كليهما. تغيير الوجهة على بطاقتها يغيّرها حين تكون العقدة متصلة. يحصل المكان الجديد على مستودعات جديدة، وتبقى النسخ في المكان القديم حيث هي.

خادم الاستقبال في هذا المثيل

تكتب العقدة إلى خادم الاستقبال في المثيل الأم بوضع append-only: يمكنها إضافة نسخ لكن لا يمكنها حذف أي منها. تحصل هناك على بيانات دخول خاصة بها تحمل اسم العقدة، وعلى مستودع لكل قسم في مجلد خاص بها. يضيف المثيل الأم مفتاحه إلى كل مستودع ويرتّبها بنفسه، لأن العقدة لا تستطيع ذلك.

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

  • https://، مثلًا خلف وكيل عكسي أو Pangolin أو نفق. حين يعرض الخادم شهادة خاصة به بدل شهادة من جهة إصدار عامة، الصقها بصيغة PEM تحت الشهادة.
  • http:// مع عنوان IP خاص، مثل 10.0.0.5 على رابط WireGuard أو 100.101.102.103 على Tailscale.

يُرفض http:// العادي إلى عنوان عام، لأن العقدة سترسل نسخها عبر الإنترنت دون تشفير. حين تغيّر العنوان يخبر المثيل الأم كل عقدة على خادم الاستقبال، والعقدة الغائبة تعرف ذلك حين تعود.

وجهة

تكتب العقدة إلى إحدى وجهات المثيل الأم التي تستطيع الوصول إليها بنفسها: خدمة S3 أو خادم REST، عبر https:// أو على عنوان خاص. تقع مستودعاتها هناك في bombvault-node-<node id>-containers وbombvault-node-<node id>-files.

تسجّل العقدة الدخول بـبيانات اعتماد محفوظة أُنشئت لها، ويجب أن تختلف عن البيانات التي يكتب بها المثيل الأم إلى الوجهة. إن قالت النافذة إنه لا توجد بيانات، فأضف واحدة أولًا. بهذه البيانات تستطيع العقدة عادةً حذف ما هو موجود في الوجهة، بخلاف خادم الاستقبال، والنافذة تقول ذلك.

الاحتفاظ بها على العقدة

تحتفظ العقدة بنسخها بنفسها، خلف rest-server خاص بها بوضع append-only، ويسحب المثيل الأم نسخة من كل قسم إلى تخزينه. يناسب هذا عقدة لا يستطيع المثيل الأم أن يعرض عليها مكانًا. وهي الوجهة الوحيدة التي تحتاج إلى منفذ مفتوح.

الخطوة الثانية وقد اختير الاحتفاظ بها على العقدة، مع العنوان https://203.0.113.7:8443 والملاحظة عن المنفذ المفتوح. الخطوة الثانية وقد اختير الاحتفاظ بها على العقدة، مع العنوان https://203.0.113.7:8443 والملاحظة عن المنفذ المفتوح.

  1. تحت عنوان العقدة اكتب أين يصل المثيل الأم إلى العقدة: عنوانها العام ومنفذًا حرًا، مثل https://203.0.113.7:8443، دون مجلد بعده. استخدم http:// مع عنوان خاص فقط، كما سبق.
  2. تشغّل العقدة الحاوية bombvault-node-rest-server على ذلك المنفذ، ومستودعاتها في المجلد bombvault-node تحت Host Data. مع https:// تنشئ شهادة لذلك العنوان، ويثبّتها المثيل الأم.
  3. اسمح بالمنفذ في جدار الحماية على العقدة، حتى يصل إليه المثيل الأم. يُرفض المنفذ الذي تشغله حاوية أخرى على العقدة مع ذكر اسمها.

يسحب المثيل الأم القسم فور انتهاء النسخ الاحتياطي للعقدة له، وكل ساعة عند الدقيقة الخامسة عشرة احتياطًا، حتى مع إيقاف سحب. ما سحبه المثيل الأم يبقى معه مثل أي نسخة مسحوبة، حتى بعد زوال العقدة. ترتّب العقدة مستودعاتها بنفسها حين يطلب المثيل الأم، لأن rest-server الخاص بها لا يقبل الحذف، ومجموعات مجلداتها تستثني المجلد bombvault-node، فلا تنسخ أبدًا نسخها الاحتياطية نفسها.

متى تنسخ العُقد

جدول كل عقدة ملك للمثيل الأم. تعرض البطاقة خطة لكل قسم، مثل الحاويات يوميًا عند 2:00 والمجلدات أسبوعيًا (الأحد) عند 4:00. النقر يفتح المحرر نفسه الموجود تحت الجداول، ويُحفظ التغيير فورًا.

خطة حاويات عقدة مفتوحة من بطاقتها، مع إيقاف ويومي وأسبوعي وكل N أيام وCron. خطة حاويات عقدة مفتوحة من بطاقتها، مع إيقاف ويومي وأسبوعي وكل N أيام وCron.

  • العقدة التي كانت غائبة تبدأ النسخ التي فاتتها فور عودتها. يتحقق المثيل الأم كل خمس دقائق.
  • العقدة المشغولة يُطلب منها من جديد بعد خمس دقائق.
  • بينما يرتّب المثيل الأم النسخ القديمة لعقدة، لا تبدأ العقدة شيئًا حتى ينتهي. على خادم الاستقبال وعلى العقدة نفسها تُفتح هذه النافذة كل أحد عند 03:00 وتدوم حتى ست ساعات. وفي الوجهة تتبع خطة النسخ خارج الموقع التي يضعها المثيل الأم لتلك الوجهة. يحتفظ المثيل الأم بالنسخ وفق قاعدته الخاصة للقسم تحت مدة الاحتفاظ، أو وفق قاعدة الوجهة حين تكون لها قاعدة.
  • في قائمة تشغيلات العقدة تظهر النسخ والاستعادات التي بدأها المثيل الأم على أنها بدأها المثيل الأم.

متابعة عُقدك

تسرد بطاقة العقد في النظرة العامة كل عقدة مع حالتها وآخر نسخة لها وأخطائها وحالاتها الشاذة المفتوحة. تظهر البطاقة حين تصبح لديك عقدة.

بطاقة العقد في النظرة العامة مع ثلاث عُقد: واحدة متصلة، وواحدة غير نشطة مع خطأين، وواحدة ما زالت في انتظار العقدة. بطاقة العقد في النظرة العامة مع ثلاث عُقد: واحدة متصلة، وواحدة غير نشطة مع خطأين، وواحدة ما زالت في انتظار العقدة.

يرسل المثيل الأم تنبيهًا واحدًا لكل حادثة عبر قنوات الإشعارات الخاصة به، ولا يرسل التالي إلا بعد انتهاء تلك الحادثة:

  • فشل نسخة احتياطية، مثل BombVault: vps-helsinki: backup failed، مع العنصر والسبب. نسخة لاحقة ناجحة لذلك العنصر تُنهي الحادثة.
  • العقدة بعيدة المنال، مثل BombVault: vps-helsinki is out of reach. ينتظر المثيل الأم أقصر مفتاح رجل ميت على مستودعات العقدة، 26 ساعة ما لم تغيّره، أو 6 ساعات ما دامت العقدة بلا وجهة بعد.

ترعى مراقبة المستقبِل في المثيل الأم أيضًا كل مستودع لعقدة، بمفتاح رجل ميت وrestic check يومي عند 04:00، راجع المستقبِل والساحب.

عناصر العقدة

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

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

قسم العقدة vps-falkenstein في قائمة الحاويات: nextcloud وnextcloud-db وcaddy وuptime-kuma. قسم العقدة vps-falkenstein في قائمة الحاويات: nextcloud وnextcloud-db وcaddy وuptime-kuma.

تذكر صفحة عنصر العقدة اسم العقدة، مثل على vps-falkenstein، وتسرد نسخه. استعادة على إحداها تستعيد العنصر على العقدة وتستبدل ما هو موجود الآن. وتُوقَف الحاوية لذلك، كما في المثيل الأم.

صفحة nextcloud على vps-falkenstein مع نسخها وزر استعادة بجانب كل منها. صفحة nextcloud على vps-falkenstein مع نسخها وزر استعادة بجانب كل منها.

عبر المثيل الأم تصل إلى قائمة ثابتة من مسارات العقدة نفسها: حاوياتها ومجموعات مجلداتها وتشغيلاتها وحالاتها الشاذة، ونسخها احتياطيًا واستعادتها. تبقى إعدادات العقدة ومفاتيحها وتخزينها بعيدة المنال، ولا شيء في تلك القائمة يحذف. راجع العقد في API.

الاستبدال والتحرير

استبدال يعرض ملف compose الخاص بالعقدة من جديد، بعد تسجيل دخول بكلمة المرور. استخدمه لنقل العقدة إلى خادم آخر أو لإعادة بنائها: شغّل الملف هناك وأوقف الخادم القديم. APP_KEY وNODE_HOME نفسهما يجعلانها العقدة نفسها من جديد، بنسخها وسجلها. يحتفظ المثيل الأم لكل عقدة بمجموعات مجلداتها، وبحاوياتها مع ما يلزم لإعادة إنشائها، وبتشغيلاتها. حين تبدأ العقدة بمجلد config فارغ، يضمّها المثيل الأم إليه من جديد، ويخبرها أين تذهب نسخها، ويعيد إليها كل ذلك قبل النسخ الاحتياطي التالي، فتستطيع استعادة حاوية لم تعد موجودة. على خادم جديد، تبدأ العقدة التي تحتفظ بنسخها بنفسها بمستودعات فارغة. وتبقى نسخها السابقة في النسخ التي سحبها المثيل الأم. خادمان بنفس APP_KEY يُعدّان عقدة واحدة، فلا تشغّلهما معًا أبدًا.

تحرير يُطلق العقدة. تتوقف عن تلقي الأوامر من المثيل الأم ولا تنسخ شيئًا بعد ذلك. تبقى نسخها حيث هي، وكذلك كل نسخة سحبها المثيل الأم. تُزال بيانات دخولها على خادم الاستقبال، ويتوقف المثيل الأم عن مراقبة مستودعاتها. العقدة الغائبة حين تحررها تبقى بطاقتها بحالة جارٍ التحرير حتى تعرف بذلك. العقدة المحرَّرة لا تقبل مثيلًا أمًّا مرة أخرى بنفس APP_KEY. لاستخدام الخادم من جديد أضفه عقدةً جديدة، وشغّله بملف compose الجديد ومجلد config فارغ.

الأمان

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

في حقيبة الاستعادة فصل العقد فيه APP_KEY كل عقدة وكلمة مرور restic الخاصة بها ومستودعاتها، فتستطيع إعادة عقدة أو استعادة نسخها بـ restic العادي.