💾 تثبيت Borgmatic — نسخ احتياطي مشفّر وآلي بواسطة Borg

انشر Borgmatic على Ubuntu بـ Docker — غلاف مبني على إعدادات YAML حول BorgBackup يُشغّل نسخاً احتياطية مشفّرة ومُزالة التكرار ومجدولة من ملف واحد. بدون واجهة ويب.

⚠️ راجع أي سكريبت دائمًا قبل تشغيله على سيرفرك، واختبره في بيئة تجريبية أولاً.

📦 الملفات والأكواد المطلوبة

قبل البدء، يرجى التأكد من تحميل الأكواد المطلوبة من مستودعنا على GitHub لتتمكن من تطبيق الخطوات مع الفيديو بسهولة.

سكريبت تثبيت آلي — أمر واحد ينشر Borgmatic بعبارة مرور تشفير مولّدة وجدولة cron يومية عند الساعة 2 صباحاً. إنه بلا واجهة رسومية؛ تضبطه في ملف config.yaml واحد.
عرض على GitHub

التثبيت السريع:

wget https://raw.githubusercontent.com/mhmdali94/Docker/main/backup/borgmatic/borgmatic-ubuntu.sh
chmod +x borgmatic-ubuntu.sh
sudo bash borgmatic-ubuntu.sh

خطوات التنفيذ

1 تحميل السكريبت

wget https://raw.githubusercontent.com/mhmdali94/Docker/main/backup/borgmatic/borgmatic-ubuntu.sh

2 منحه صلاحية التنفيذ

chmod +x borgmatic-ubuntu.sh

3 تشغيل المثبّت

يثبّت السكريبت Docker إن لزم ويُشغّل Borgmatic بعبارة مرور BORG_PASSPHRASE مولّدة وجدولة cron ليلية (الساعة 02:00). احفظ عبارة المرور التي يطبعها — بدونها لا يمكن استعادة نسخك الاحتياطية المشفّرة. مصدرك ومستودعك وإعداداتك وذاكرتك المؤقتة كلها مُعلّقة كأحجام.

sudo bash borgmatic-ubuntu.sh

4 تهيئة المستودع والتحقق

لا توجد واجهة ويب. عدّل config/config.yaml لتحديد مصادرك وسياسة الاحتفاظ، هيّئ مستودع Borg مرة واحدة، ثم اعرض الأرشيفات للتأكد من أن النسخ الاحتياطية تُنشأ فعلاً:

docker exec -it borgmatic borgmatic list

المنافذ المستخدمة

المنفذالغرض
No portsHeadless, cron-driven — no web UI
BORG_PASSPHRASEGenerated encryption key — save it or backups are unrecoverable
config.yaml + cronOne YAML file defines the policy; nightly 02:00 backup

نظرة عامة

Borgmatic هو غلاف مبني على إعدادات YAML حول BorgBackup (Borg)، برنامج النسخ الاحتياطي السريع والمشفّر ومُزيل التكرار. بدلاً من حفظ أوامر borg الطويلة عن ظهر قلب، تصف مصادرك ومستودعك وسياسة الاحتفاظ والخطافات مرة واحدة في ملف YAML، ويقوم borgmatic بتشغيل أوامر Borg الصحيحة — الإنشاء، التقليم، الضغط، والفحص — حسب جدول زمني. إنه أداة بلا واجهة، تعامل النسخ الاحتياطي كأنه كود: لا لوحة تحكم، لا حسابات، فقط ملف إعدادات ومهمة cron إما تعمل بنجاح أو تنبّهك عند فشلها.

لماذا تستخدمه

BorgBackup الخام قوي لكنه غير متسامح مع الأخطاء — تذكّر العلامات الصحيحة لإنشاء الأرشيفات وتطبيق قواعد الاحتفاظ وتقليم النسخ القديمة والتحقق من السلامة عبر مصادر متعددة يصبح معقداً بسرعة. يختصر Borgmatic كل ذلك في ملف YAML واحد مقروء وأمر واحد، مع الحفاظ على نقاط قوة Borg الأساسية: التشفير من جهة العميل، والنسخ التزايدية السريعة مُزالة التكرار، والضغط. ولأنه بلا واجهة ومبني على الإعدادات، يندمج بشكل طبيعي في سير عمل البنية التحتية ككود — سياسة النسخ الاحتياطي لديك تعيش في نظام التحكم بالإصدارات بجانب باقي إعدادات سيرفرك.

متى تحتاجه

  • تريد نسخاً احتياطية مجدولة ومشفّرة دون كتابة أوامر borg create/prune/check وإدخالات cron يدوياً بنفسك
  • تدير عدة سيرفرات أو مصادر وتريد صيغة إعدادات نسخ احتياطي واحدة متسقة وقابلة للتحكم بالإصدارات
  • تحتاج نسخاً احتياطية تزايدية مُزالة التكرار لا تتضخم في الحجم كما تفعل النسخ الكاملة
  • تريد تعريف سياسة النسخ الاحتياطي والاحتفاظ بشكل تصريحي في YAML بدلاً من دمجها في سكريبتات shell مرتجلة
  • تحتاج النسخ الاحتياطي لمستودعات بعيدة عبر SSH (VPS، أو Borgbase، أو rsync.net، أو سيرفر تخزين خاص بك)
  • أنت مرتاح للعمل دون واجهة ويب وتفضّل التحقق من النسخ الاحتياطية من السجلات وسطر الأوامر

من يحتاجه

  • المستضيفون الذاتيون ومديرو المختبرات المنزلية الذين يريدون نسخاً احتياطية موثوقة ومشفّرة لأحجام Docker وقواعد البيانات وملفات الإعدادات
  • مديرو الأنظمة الذين يديرون عدة سيرفرات Linux ويريدون أداة نسخ احتياطي واحدة متسقة عبر جميعها
  • المطورون ومهندسو DevOps الذين يفضّلون البنية التحتية ككود ويريدون سياسة النسخ الاحتياطي مخزّنة في مستودع git
  • المستخدمون المهتمون بالخصوصية الذين يريدون تشفيراً من جهة العميل بحيث لا يستطيع حتى مزوّد التخزين البعيد قراءة بياناتهم
  • أي شخص يستخدم BorgBackup بالفعل ويريد طريقة أكثر سهولة وقابلية للصيانة لتشغيله
  • الفرق الصغيرة التي تحتاج نسخاً احتياطية آلية خارج الموقع دون دفع مقابل أو تشغيل منصة نسخ احتياطي تجارية

حالات الاستخدام الشائعة

  • نسخ احتياطي ليلي مشفّر لأحجام Docker وبيانات التطبيقات ودلائل الإعدادات إلى مستودع بعيد
  • نسخ احتياطي آلي لسيرفر منزلي أو NAS إلى مزوّد تخزين متوافق مع Borg مثل Borgbase أو rsync.net
  • نسخ احتياطي لعدة سيرفرات إلى مستودع Borg مركزي بقواعد احتفاظ متسقة عبرها جميعاً
  • لقطات ما قبل الترحيل قبل الترقيات الكبيرة، حتى يمكن التراجع عن تحديث معطل إلى حالة معروفة وسليمة
  • سياسات احتفاظ مدفوعة بالامتثال حيث تحتاج سياسات أرشفة يومية/أسبوعية/شهرية/سنوية قابلة للإثبات
  • دمج حالة النسخ الاحتياطي في المراقبة عبر الخطافات — Healthchecks.io أو ntfy أو إشعارات webhook مخصصة عند النجاح أو الفشل

الميزات الرئيسية

  • ملف إعدادات YAML واحد يحدد المصادر والمستودع وسياسة الاحتفاظ والتشفير والخطافات — بدون سكريبتات متناثرة
  • تشفير من جهة العميل موروث من Borg — تُشفّر البيانات قبل أن تغادر سيرفرك أبداً، والمفتاح تحت سيطرتك الكاملة
  • نسخ احتياطية تزايدية مضغوطة ومُزالة التكرار — تُخزَّن فقط كتل البيانات المتغيرة، مما يبقي المستودعات صغيرة بمرور الوقت
  • سياسات احتفاظ مرنة (keep-hourly، keep-daily، keep-weekly، keep-monthly، keep-yearly) تُطبَّق تلقائياً عبر التقليم
  • فحوصات سلامة مدمجة (borgmatic check) للتحقق من أن الأرشيفات متسقة وقابلة للاستعادة، وليس فقط موجودة
  • خطافات قبل/بعد لتشغيل أوامر (مثل تفريغ قواعد البيانات) قبل النسخ الاحتياطي والتنظيف أو الإشعار بعده
  • تكامل أصلي مع خدمات مراقبة مثل Healthchecks.io وntfy للتنبيه بالنجاح/الفشل في كل تشغيل
  • يدعم عدة مستودعات ومصادر في إعداد واحد، بحيث يمكن لنسخة borgmatic واحدة نسخ عدة أهداف احتياطياً

كيفية الاستخدام بعد التثبيت

  • عدّل config/config.yaml لتحديد دلائل مصادرك وموقع المستودع وسياسة الاحتفاظ قبل الاعتماد عليه
  • هيّئ مستودع Borg مرة واحدة (borgmatic init أو borg init) مع تفعيل التشفير إن لم يكن قد أُنشئ بعد
  • شغّل نسخة احتياطية يدوية فوراً بعد الإعداد بـ docker exec -it borgmatic borgmatic create للتأكد من أن كل شيء يعمل
  • تحقق من وجود الأرشيفات بـ docker exec -it borgmatic borgmatic list وافحص واحداً منها بـ borgmatic info
  • تأكد من أن مهمة cron الليلية تعمل فعلاً بمراجعة سجلات الحاوية في صباح اليوم التالي للتشغيل المجدول الأول
  • أعدّ خطافات إشعار (Healthchecks.io أو ntfy) لتُنبَّه تلقائياً إذا فشلت نسخة احتياطية مجدولة بصمت
  • اختبر استعادة حقيقية بـ borgmatic extract أو borgmatic mount على مسار غير إنتاجي للتأكد من إمكانية الاستعادة
  • وثّق سياسة الاحتفاظ وموقع المستودع في مكان خارج السيرفر نفسه، تحسباً لفقدان السيرفر

أفضل ممارسات الأمان

  • احفظ BORG_PASSPHRASE المولّدة فوراً في مدير كلمات مرور — بدونها تصبح الأرشيفات المشفّرة غير قابلة للقراءة نهائياً
  • لا تخزّن عبارة المرور أبداً في نفس مكان النسخ الاحتياطية نفسها — إذا فُقد الاثنان معاً تصبح النسخة الاحتياطية عديمة القيمة
  • استخدم مصادقة مفتاح SSH (وليس كلمات المرور) عند النسخ الاحتياطي لمستودع بعيد عبر SSH
  • قيّد حساب المستودع البعيد بوضع الإلحاق فقط (append-only) حيثما أمكن، حتى لا يستطيع سيرفر مصدر مخترق حذف النسخ الموجودة
  • حافظ على تحديث حاوية borgmatic وإصدار Borg الأساسي لتلقّي إصلاحات الأمان والتوافق
  • قيّد الوصول إلى config/config.yaml ودليل الذاكرة المؤقتة، لأنهما قد يكشفان مصادر نسخك الاحتياطي وموقع مستودعك
  • شفّر النسخ الاحتياطية حتى للمستودعات المحلية — الأقراص تُسرق أو تُباع أو تُعاد استخدامها دون مسح
  • شغّل borgmatic check دورياً لاكتشاف التلف الصامت قبل أن تحتاج فعلياً للاستعادة من أرشيف تالف

المنافذ وإعدادات جدار الحماية

لا يكشف Borgmatic أي منافذ شبكية على الإطلاق — إنه أداة بلا واجهة تعمل عبر cron دون واجهة ويب أو خدمة استماع. النشاط الشبكي الوحيد صادر: اتصال SSH يبدأه للوصول إلى مستودع Borg بعيد (عادةً عبر المنفذ 22، أو منفذ مخصص يحدده مزوّد التخزين البعيد لديك). لا حاجة لأي قواعد جدار حماية واردة على السيرفر الذي يشغّل borgmatic؛ فقط تأكد من السماح بحركة مرور SSH الصادرة إذا كان مستودعك بعيداً.

النسخ الاحتياطي والصيانة

  • شغّل borgmatic check دورياً للتحقق من سلامة الأرشيف، وليس فقط أن النسخ الاحتياطية تبدو مكتملة بنجاح
  • اختبر استعادات كاملة على جهاز تجريبي بجدول منتظم — النسخة الاحتياطية غير المُختبرة ليست نسخة احتياطية حقيقية
  • انسخ احتياطياً config/config.yaml وBORG_PASSPHRASE نفسها في مكان منفصل عن المستودع الأساسي
  • راقب نمو حجم المستودع بمرور الوقت واضبط قواعد الاحتفاظ إذا لم يكن التقليم يبقي تكاليف التخزين تحت السيطرة
  • احتفظ بمستودع نسخ احتياطي ثانوي ومستقل (مزوّد أو موقع مختلف) للبيانات الحرجة — مستودع واحد هو نقطة فشل وحيدة
  • راجع سجلات borgmatic أو نتائج خطافات الإشعار بعد كل تشغيل مجدول، وليس فقط عندما يبدو شيء خاطئاً

الأخطاء الشائعة

  • فقدان BORG_PASSPHRASE — لا توجد آلية استرداد، وفقدانها يجعل كل أرشيف موجود غير قابل للقراءة نهائياً
  • عدم اختبار الاستعادة أبداً حتى وقوع طارئ حقيقي لفقدان البيانات، ليُكتشف حينها أن النسخة الاحتياطية كانت معطلة الإعداد أو ناقصة
  • النسخ الاحتياطي إلى نفس القرص المادي أو السيرفر المحمي، بحيث يدمّر عطل الأجهزة البيانات والنسخة الاحتياطية معاً
  • ضبط سياسة احتفاظ متشددة جداً تحذف الأرشيفات القديمة قبل أن تدرك أنك تحتاج شيئاً من قبل ثلاثة أسابيع
  • نسيان إضافة مصادر بيانات جديدة إلى config.yaml بعد نشر خدمات جديدة، تاركاً إياها غير محمية بصمت
  • عدم إعداد إشعارات الفشل — يمكن أن تمر مهمة cron ليلية معطلة بصمت دون ملاحظة لأسابيع
  • تشغيل النسخ الاحتياطي دون التحقق من المساحة الحرة في وجهة المستودع، مما يسبب أرشيفات جزئية أو فاشلة
  • اعتبار نجاح cron الخاص بـ borgmatic دليلاً على نسخة احتياطية جيدة بدلاً من التحقق دورياً بـ borgmatic check

استكشاف الأخطاء وإصلاحها

  • فشل النسخ الاحتياطي بخطأ قفل — تحقق من وجود قفل قديم تركه تشغيل سابق مقاطَع واكسره بـ borgmatic break-lock إن كان آمناً
  • تعذّر الاتصال بمستودع بعيد — تحقق من عمل مصادقة مفتاح SSH يدوياً بـ borg خارج borgmatic أولاً
  • cron لا يبدو أنه يعمل — تحقق من أن خدمة cron في الحاوية نشطة وراجع docker logs في الوقت المجدول
  • المستودع ينمو بشكل غير متوقع — راجع سياسة الاحتفاظ لديك وتأكد من أن borgmatic prune وcompact يعملان فعلاً
  • فشل الاستعادة أو كانت ناقصة — شغّل borgmatic check على المستودع للبحث عن تلف قبل افتراض خطأ المستخدم
  • ملفات خاطئة أو مصادر مفقودة في الأرشيف — تحقق مرة أخرى من مسارات المصدر وأي أنماط استبعاد في config.yaml
  • ظهور طلب عبارة مرور غير متوقع — تأكد من ضبط BORG_PASSPHRASE بشكل صحيح في بيئة الحاوية
  • استخدام عالٍ للمعالج أو الذاكرة أثناء النسخ الاحتياطي — النسخ الاحتياطية الكاملة الأولى تكون متوقعة أن تكون مكلفة بالموارد؛ التزايدية اللاحقة أخف بكثير

البدائل

Restic هو المنافس المباشر الأقرب — ملف تنفيذي ثابت واحد بدعم أوسع لخلفيات التخزين السحابي (S3، Backblaze B2، Azure) جاهزاً من الصندوق ونموذج ذهني أبسط، رغم افتقاره لطبقة إعدادات YAML التصريحية التي يوفرها borgmatic. Kopia يضيف واجهة ويب أنيقة وأداءً سريعاً جداً بتخزين قائم على المحتوى، ويناسب من يريد تصفح الاستعادة بصرياً بدلاً من أداة سطر أوامر فقط. Duplicati يقدّم واجهة رسومية ودعماً واسعاً لمزوّدي السحابة لكنه تاريخياً واجه مشاكل موثوقية أكبر مع المستودعات الكبيرة. سكريبتات rsync أبسط لكنها تفتقر تماماً للتشفير وإزالة التكرار واللقطات المُرقّمة. للفرق التي تريد تشفير Borg الناضج وإزالة التكرار مع إعدادات قابلة للصيانة ومتحكم بإصدارها، يبقى borgmatic الخيار المعياري.

متى لا تستخدمه

لا تلجأ إلى borgmatic إذا كنت تريد لوحة تحكم ويب للنقر عبر مهام النسخ الاحتياطي وتصفح الأرشيفات بصرياً أو إدارة الجداول دون لمس ملف إعدادات — Duplicati أو واجهة Kopia الرسومية أنسب. إذا كانت وجهة تخزينك تدعم فقط تخزين الكائنات بنمط S3 دون وصول SSH/SFTP، فإن Restic أو Kopia لديهما دعم خلفي أصلي أوسع جاهزاً من الصندوق. وإذا كنت تحتاج فقط مزامنة ملفات بسيطة وغير مشفّرة لبيانات غير حساسة، فإن مهمة rsync cron بسيطة أخف وزناً من نشر مكدس كامل مبني على Borg.

هل تحتاج مساعدة احترافية؟

توفر PrismaTechWork خدمات بنية تحتية شاملة — من النشر الأولي وتصليب الأمان إلى المراقبة المستمرة والنسخ الاحتياطي التلقائي والدعم المخصص. سواء كنت تحتاج إعداد سيرفر واحد أو شبكة متعددة المواقع، يضمن فريقنا بناء بنيتك التحتية بشكل صحيح وتأمينها بالشكل المناسب وصيانتها باستمرار.

  • التثبيت وتجهيز السيرفر
  • الإعداد المتقدم وإعداد التوجيه
  • تصليب الأمان وتحسين جدار الحماية
  • إعداد شهادات SSL/TLS مع Let's Encrypt
  • ربط النطاق المخصص والوكيل العكسي
  • جدولة النسخ الاحتياطي التلقائي والتعافي من الكوارث
  • المراقبة الفورية وتنبيهات الجاهزية
  • الترحيل من المنصات القائمة
  • استكشاف مشكلات الاتصال والأداء وإصلاحها
  • سكريبتات أتمتة مخصصة وعقود دعم مستمر
تواصل مع PrismaTechWork

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

ما هو Borgmatic؟

هو غلاف مبني على إعدادات YAML حول BorgBackup. يوفر BorgBackup نسخاً احتياطية مشفّرة ومُزالة التكرار ومضغوطة بنسخ تزايدية سريعة لكنه أداة سطر أوامر منخفضة المستوى — يغلّفه borgmatic بملف إعدادات YAML واحد وأمر واحد لتشغيل النسخ الاحتياطي والتقليم والفحص معاً.

هل له واجهة ويب؟

لا — إنه بلا واجهة عمداً. كل شيء يُضبط عبر config.yaml ويعمل عبر cron، وهذا بالضبط الهدف: نسخ احتياطي كأنه كود، قابل للتكرار والتحكم بالإصدارات. تتحقق منه بقراءة سجلات الحاوية وعرض أرشيفات Borg بدلاً من فتح لوحة تحكم.

ماذا يحدث إذا فقدت عبارة المرور؟

تصبح نسخك الاحتياطية غير قابلة للاستعادة نهائياً. يشفّر Borg كل شيء من جهة العميل بـ BORG_PASSPHRASE، ولا يوجد باب خلفي أو مسار استرداد بدونها — هذا هو نموذج الأمان بأكمله.

كيف يجدول النسخ الاحتياطية؟

يضبط هذا النشر مهمة cron ليلية عند الساعة 02:00 عبر إعداد BACKUP_CRON، بحيث تعمل النسخ الاحتياطية تلقائياً كل ليلة. يمكنك تغيير هذا الجدول ليناسب احتياجاتك بتعديل تعبير cron.

كيف يختلف عن Restic أو Kopia؟

الثلاثة جميعاً يقومون بنسخ احتياطي مشفّر ومُزال التكرار. يشغّل Borgmatic محرك BorgBackup من إعدادات YAML واحدة حسب جدول، بلا واجهة. Restic أداة أبسط بملف تنفيذي واحد مع دعم واسع جداً لخلفيات السحابة، وKopia يضيف واجهة رسومية ودّية وأداءً قوياً.