أدلة
النسخ الاحتياطي لـSaaS مستضاف ذاتيًا، وكيف تثبت أن الاستعادة تعمل
نُشر في · قراءة في 6 دقائق· Anton Shubin
متوفرة أيضًا باللغات: Deutsch وEnglish وEspañol وFrançais و日本語 وPortuguês (Brasil) وРусский و简体中文

باختصار
- انسخ قاعدة البيانات والملفات المرفوعة وكل مفتاح لا يوجد إلا على الخادم، إلى bucket عند مزوّد آخر.
- لا يثبت النسخة الاحتياطية إلا استعادتها. جرّب استعادة في قاعدة احتياطية؛ في Seed هي أربعة أوامر.
- يحفظ Seed كل يوم pg_dump والملفات ومفاتيح إشعارات الدفع عبر restic، وينبّهك حين يصبح عمر آخر نسخة يومين.
- لا توجد استعادة إلى لحظة محددة، فقد يضيع ما يصل إلى يوم من الكتابات، ولا يتحقق بنفسه من البيانات المخزّنة.
لتأخذ نسخة احتياطية من SaaS مستضاف ذاتيًا، احفظ كل يوم ثلاثة أشياء في تخزين عند مزوّد آخر: تفريغًا (dump) لقاعدة البيانات، والملفات التي رفعها مستخدموك، وكل مفتاح لا يوجد إلا على الخادم. شفّر النسخة، واحفظ كلمة مرورها في مكان غير الخادم، واجعل أحدًا ينبّهك حين يفشل تشغيل. ثم افعل الجزء الذي يتخطاه أكثر الناس: استعد نسخة واحدة إلى قاعدة احتياطية وتأكد أن الجداول موجودة. وإلى أن تفعل ذلك، فما لديك مجلد مليء بالأمل.
خادم واحد بسعر ثابت هو فكرة Seed كلها، وما يمنع الناس من الاستضافة الذاتية هو الخوف من فقدان البيانات. لذلك يتناول هذا المقال النسخ الاحتياطي الذي يأتي مع Seed: ما يحفظه، وكيف تتمرّن على الاستعادة، وبالصراحة نفسها ما لا يفعله. الأوامر مأخوذة من دليل النسخ الاحتياطي ودليل الاستعادة.
ما الذي يجب نسخه في SaaS مستضاف ذاتيًا؟
كل ما لا تستطيع إعادة بنائه من git. هذه قائمة Seed من docs/backups.md:
| ماذا | في النسخة؟ | لماذا |
|---|---|---|
قاعدة Postgres، بصيغة pg_dump |
نعم | الحسابات والمجموعات وكل ما أنشأه المستخدمون. |
| الملفات المرفوعة (Garage المدمج) | نعم | كتل بياناته وآخر نسختين بالساعة من بياناته الوصفية. |
مفاتيح إشعارات الدفع، vapid.json |
نعم | لا توجد إلا على الخادم؛ ومن دونها تتوقف الإشعارات. |
| Valkey | لا | ذاكرة مؤقتة تمتلئ من جديد وحدها. |
| ملف البيئة للإنتاج | لا | فيه مفاتيح النسخة نفسها. احتفظ بنسختك منه في مكان آخر. |
| ملفات على تخزين S3 آخر | لا | تغطيها نسخ ذلك التخزين الاحتياطية. |
ملف البيئة هو الأكثر نسيانًا. فيه مفتاح تخزين الملفات وكلمة مرور النسخة، فلو احتوته النسخة لأعطت الاثنين لكل من يقرؤها. ضعه في مدير كلمات المرور أو مشفّرًا في git، لكن لا تتركه على الخادم وحده.
أين تُحفظ النسخ الاحتياطية؟
ليس على الخادم نفسه، والأفضل ألا تكون عند المزوّد نفسه. النسخة على القرص الذي مات ليست نسخة، والنسخة في الحساب نفسه تسقط مع الحساب إذا أُغلق. يكتب Seed نسخته في أي bucket متوافق مع S3. ومقال النشر على خادم Hetzner يحسب كلفتها على Hetzner Object Storage، وهو خارج الخادم؛ أما bucket عند مزوّد ثانٍ فينجو أيضًا من مشكلة مع الأول.
ثلاثة إعدادات أهم من اختيار المزوّد:
- مفتاح لهذا الـbucket وحده، يقرأ ويكتب ويحذف فيه ولا شيء غيره.
- تفعيل الإصدارات (versioning) أو object lock على الـbucket إن وفّرها المزوّد. المفتاح موجود على الخادم، ومن يستولي على الخادم يستطيع من دونها أن يحذف النسخ أيضًا. هذا الإعداد هو ما يحوّل «مسحوا خادمي» إلى مساء سيئ بدل شركة مغلقة.
- كلمة مرور المستودع بعيدًا عن الخادم. من دونها لا تُقرأ أي لقطة، لا للمهاجم ولا لك.
كيف يأخذ Seed النسخة الاحتياطية؟
حين يكون backup ضمن COMPOSE_PROFILES، تعمل حاوية backup مرة عند بدئها ثم كل 24 ساعة
(infra/backup/backup.sh). وهي
تحفظ في مستودع restic، الذي يشفّر كل لقطة ولا ينقل إلا ما تغيّر منذ
السابقة.
بضعة قرارات في هذا السكربت تصنع الفرق بين نسخة احتياطية وملف يشبهها فقط:
- restic يشغّل
pg_dumpبنفسه ولا يحفظ شيئًا إذا فشلpg_dump، فالتفريغ المقطوع في منتصفه لا يصبح لقطة أبدًا. وpg_dumpيصدّر نسخة متسقة بينما يواصل التطبيق القراءة والكتابة، ولا يحجب المستخدمين الآخرين (توثيق Postgres)، فيبقى التطبيق شغّالًا. - التفريغ بإصدار Postgres الخاص بالخادم نفسه. صورة النسخ مبنية على صورة قاعدة البيانات
(infra/backup/Dockerfile)،
فلا يتأخر
pg_dumpوpg_restoreعن الخادم أبدًا. - التفريغ غير مضغوط. restic يضغط بنفسه، ولا يجد ما لم يتغير إلا في بيانات غير مضغوطة، فيبقى التفريغ اليومي لقاعدة قليلة التغيّر صغيرًا.
- اللقطات القديمة تُخفَّف. تبقى كل لقطات اليومين الأخيرين، ثم واحدة لكل يوم لأسبوع، وواحدة لكل
أسبوع لشهر، وواحدة لكل شهر لنصف سنة
(أمر
forgetفي restic). - التشغيل المقطوع ينظّف وراءه. إعادة التشغيل أو قاتل نفاد الذاكرة (OOM killer) قد يتركان قفلًا لـrestic؛ فكل تشغيل يزيل الأقفال القديمة أولًا، والتشغيل الذي يصادف قفلًا حيًّا يعيد المحاولة بعد ساعة.
التفعيل هو ملف backup التعريفي وأربعة متغيرات في ملف البيئة، ثم نشر واحد. والملف التعريفي (profile) مطفأ حتى تُعدّه، فالمنتج
الجديد بلا نسخة احتياطية إلى أن تفعل.
كيف تعرف أن النسخ الاحتياطي ما زال يعمل؟
النسخ الذي توقف في مارس يُكتشف في يونيو، في اليوم الذي تحتاج إليه فيه. يخبرك Seed بثلاث طرق:
- يُظهر
docker psحاوية النسخ بحالة unhealthy حين يتجاوز عمر آخر نسخة كاملة يومين. - تنبيه
BackupMissing(infra/configs/alerts.yml) يرسل الخبر نفسه إلى ntfy. - صفحة System في لوحة الإدارة تحذّر حين يبلغ عمر آخر نسخة 26 ساعة، وتعرض خطأ بعد 48 (libs/domain/identity/admin-system.ts).
والسجل يذكر السبب: كلمة مرور أو مفتاح خاطئ، أو قفل، أو مستودع لا يجيب.
كيف تثبت أن الاستعادة تعمل؟
بأن تستعيد. ليس الخادم كله، بل لقطة واحدة إلى قاعدة احتياطية بجانب الحقيقية، والتطبيق يعمل. في
Seed، على الخادم وفي مجلد التطبيق (<db> هو DB_NAME عندك):
deno task compose exec db psql -d postgres -c 'CREATE DATABASE "<db>_restore_test"'
deno task compose run --rm backup restore
deno task compose run --rm -e PGDATABASE=<db>_restore_test backup restore <snapshot id>
deno task compose exec db psql -d <db>_restore_test -c '\dt'
السطر الثاني يعرض اللقطات ولا يغيّر شيئًا، والثالث يحمّل اللقطة التي سمّيتها. يجب أن تطابق قائمة الجداول قائمة القاعدة الحقيقية. ثم احذف القاعدة الاحتياطية. يستغرق ذلك دقائق، وبعدها تصبح عبارة «لدينا نسخ احتياطية» حقيقة لا شعورًا.
افعل ذلك مرة بعد تفعيل النسخ، ثم بعد كل تغيير كبير: إصدار جديد من Postgres، أو bucket جديد، أو كلمة مرور جديدة.
ويختبر Seed السكربت نفسه أيضًا. deno task test:backup وخطوة backup-restore في CI، في كل pull
request، تأخذ نسخة من قاعدة بالسكربت الحقيقي، وتستعيدها إلى قاعدة فارغة، وتقارن الصفوف
(infra/backup/restore.test.sh).
والاختبار نفسه يقتل تشغيلًا في منتصفه ويتأكد أن التالي ينجح، ويُبقي مشروعين يتشاركان مستودعًا
منفصلين. هذا يثبت السكربت؛ أما الـbucket والمفتاح وكلمة المرور التي لديك فلا يثبتها إلا تمرينك أنت.
كيف تستعيد فعلًا؟
على مهل، ومن دون الكتابة فوق أي شيء. كل الأوامر في دليل الاستعادة، وهذه الأفكار التي وراءها:
- ضع القاعدة التالفة جانبًا، ولا تكتب فوقها أبدًا. أوقف التطبيق، وأعد تسمية القاعدة، وأنشئ قاعدة فارغة. الاستعادة ترفض قاعدة فيها جداول، حتى لا تختلط حالتان.
- اختر اللقطة بتاريخها. الأحدث ليست دائمًا الصحيحة: اللقطة التي أُخذت بعد الضرر تحمل الضرر.
لذلك لا قيمة افتراضية لـ
restore، وهو يسمّي اللقطة ووقتها قبل أن يحمّل أي شيء. - حمّلها في معاملة واحدة. الاستعادة التي تفشل في منتصفها تترك قاعدة فارغة لا نصف ممتلئة
(
pg_restore --single-transaction، توثيق Postgres). - أعد تشغيل الذاكرة المؤقتة، ثم التطبيق. الترحيلات الأحدث من اللقطة تُطبَّق كما في أي بدء.
- استعد الملفات من الليلة نفسها التي أُخذت فيها القاعدة.
على خادم جديد، أبقِ النسخ الاحتياطي مطفأً حتى تنتهي الاستعادة. وإلا فسيحفظ الخادم الجديد قاعدته الفارغة كل يوم في المستودع نفسه، وبعد سبعة تشغيلات يبدأ التنظيف بحذف لقطات الخادم القديم. أفضّل أن تقرأ هذا هنا على أن تكتشفه بنفسك.
ما الذي لا يفعله النسخ الاحتياطي في Seed؟
- لا استعادة إلى لحظة محددة. إنه تفريغ واحد في اليوم، فقد يكلّفك عطل ما يصل إلى يوم من الكتابات. لا يؤرشف Seed سجل WAL؛ فإن كانت ساعة من الطلبات الضائعة كثيرة على منتجك، فأنت تحتاج ذلك فوقه.
- لا يعيد قراءة البيانات المخزّنة بنفسه.
restic checkيتحقق من بنية المستودع، و--read-dataيقرأ كل حزمة مخزّنة (توثيق restic)، لكن السكربت لا يشغّل أيًّا منهما. يمكنك تشغيله يدويًا:deno task compose run --rm backup restic check --read-data-subset=10%. - لا يتمرّن على الاستعادة نيابة عنك. CI يختبر السكربت، لا الـbucket الخاص بك.
- لا يحفظ ملف البيئة، عن قصد، ولا يكتب عبر SSH: يجب أن يكون المستودع bucket على S3.
- مطفأ إلى أن تشغّله.
هذا أمان يومي صادق لخادم واحد، لا أمان مصرف. ولأغلب المنتجات هو القدر المناسب: الثغرة الخطرة نادرًا ما تكون الساعة الضائعة، بل النسخة التي لم يستعدها أحد قط.
دورك
إن كان Seed يعمل لديك، فتمرّن على استعادة اليوم: أربعة أوامر وبضع دقائق. وإن كنت ما زلت تختار أين تستضيف، فابدأ بـتثبيت Seed وتشغيله محليًا، ثم انشره على خادم Hetzner واحد، وفعّل النسخ الاحتياطي في الجلسة نفسها. هل في الأدلة شيء غير واضح؟ افتح issue وسأصلحه.


