استخدم تنسيق النسخ الاحتياطي المخصص لـ PostgreSQL لإنشاء نسخة احتياطية من قاعدة بيانات Synapse، مع استبعاد جدول مفتاح التشفير لمرة واحدة، ثم استعد البيانات في قاعدة بيانات فارغة تم إنشاؤها حديثًا. لا يُعدّ النسخ الاحتياطي لقاعدة البيانات وحده نسخة احتياطية كاملة للخادم الرئيسي: احتفظ أيضًا بإعدادات Synapse ومفتاح التوقيع والوسائط المحلية. وتحذر إرشادات النسخ الاحتياطي الرسمية لـ Synapse، التي تم التحقق منها في 10 أكتوبر 2026، تحديدًا من الاستعادة فوق الجداول الموجودة ومن استعادة مفاتيح التشفير القديمة لمرة واحدة.
ما يحتويه النسخ الاحتياطي لقاعدة البيانات - وما لا يحتويه
تم التحقق: pg_dump يُنشئ هذا الأمر لقطة متسقة مع بقاء PostgreSQL متصلاً بالإنترنت؛ ولا يلزم إيقاف Synapse أثناء عملية النسخ الاحتياطي. لا يتضمن النسخ الاحتياطي لقاعدة البيانات فقط ملفات من مخزن وسائط Synapse، homeserver.yamlأو ملفات التكوين المُشار إليها، أو مفتاح توقيع الخادم. احتفظ بهذه الملفات في مجموعة نسخ احتياطية محمية منفصلة. يتعرف Synapse على المحتوى المُحمّل محليًا، وعند تعطيل الصور المصغرة الديناميكية، يتعرف على الصور المصغرة المحلية كبيانات يجب الاحتفاظ بها. يمكن عمومًا جلب أو إعادة بناء ذاكرة التخزين المؤقت للوسائط البعيدة ومعاينة عناوين URL.
الإجراء: حدد اسم قاعدة البيانات النشطة، ودور PostgreSQL، ودليل تكوين Synapse، ومسار مفتاح التوقيع، ومسار مخزن الوسائط قبل إنشاء خطة الاسترداد. استخدم المسارات المُكوّنة على خادمك؛ فهي تختلف باختلاف الحزمة والحاوية والنشر.
مفهوم خاطئ شائع: لا يُعدّ نجاح عملية تفريغ قاعدة بيانات SQL دليلاً على إمكانية استعادة الخادم بالكامل. الإجراء: قم بعمل نسخة احتياطية من قاعدة البيانات، وملف الإعدادات، ومفتاح التوقيع، والوسائط المحلية المطلوبة، واختبر استعادتها معًا بشكل دوري.
أنشئ ملف تفريغ بتنسيق مخصص وتحقق منه
تفترض الأوامر أدناه وجود خادم Linux مثبت عليه أدوات سطر أوامر PostgreSQL، وقاعدة بيانات باسم معين synapse، وصلاحية تشغيل أوامر PostgreSQL باستخدام postgresحساب نظام التشغيل. استبدل اسم قاعدة البيانات والمسارات بقيم النشر الخاصة بك. خزّن النسخة الاحتياطية على وحدة تخزين محمية بمساحة كافية؛ إذ يمكن أن تحتوي على رسائل خاصة وبيانات الحساب.
قم بإنشاء ملف النسخ الاحتياطي، باستثناء محتويات الجدول الذي تنص عليه Synapse أنه لا يجب إعادة تشغيله من نسخة احتياطية أقدم:
sudo -u postgres pg_dump -Fc --exclude-table-data=e2e_one_time_keys_json synapse > /secure-backups/synapse.dump
-Fcيختار هذا الخيار تنسيق الأرشيف المخصص لـ PostgreSQL، وهو مناسب لـ pg_restoreSQL العادي وغالبًا ما يكون أصغر حجمًا منه. يؤثر هذا الاستثناء على بيانات الجدول، ولكنه لا يزيل تعريف الجدول.
تأكد من وجود الملف وأنه غير فارغ، ثم اذكر جدول محتويات الأرشيف:
ls -lh /secure-backups/synapse.dump
sudo -u postgres pg_restore --list /secure-backups/synapse.dump
يؤكد وجود قائمة الملفات أن PostgreSQL قادر على قراءة بنية الأرشيف، لكنه لا يثبت إمكانية استعادة كل صف أو اكتمال ملفات النسخ الاحتياطي الأخرى. لإجراء فحوصات أكثر دقة، انسخ النسخة الاحتياطية إلى وحدة تخزين منفصلة وتحقق من مجموع التحقق الخاص بها بعد النقل.
مفهوم خاطئ شائع: إيقاف Synapse ضروري لكل عملية نسخ احتياطي pg_dumpمنطقي. تشير صفحة Synapse الرسمية إلى أن pg_dumpالنسخ الاحتياطي العادي يكون متسقًا دون إيقاف Synapse أو PostgreSQL. الإجراء: أبقِ الخدمة متصلة بالإنترنت لهذا النسخ الاحتياطي المنطقي، ولكن خطط لفترة صيانة لإجراء استعادة كاملة.
استعادة البيانات إلى قاعدة بيانات فارغة
عملية الاستعادة هي عملية استبدال. أولاً، أوقف برنامج Synapse وجميع عمليات Synapse العاملة حتى لا يتصل أي شيء بالهدف أو يكتب إليه أثناء عملية الاستعادة. تأكد من اسم قاعدة البيانات الهدف ونسخة احتياطية منها قبل إصدار أي أوامر لتغيير قاعدة البيانات.
أنشئ قاعدة بيانات جديدة باستخدام ترميز UTF-8 والمالك المستخدم في إعدادات Synapse. يستخدم المثال التالي الدور التالي synapse_user:
sudo -u postgres createdb --encoding=UTF8 --locale=C --template=template0 --owner=synapse_user synapse
إذا كان اسم قاعدة البيانات موجودًا بالفعل، فلا تقم باستعادتها بشكل أعمى. اتبع إجراءات الاستعادة الخاصة بك للاحتفاظ بقاعدة البيانات القديمة أو إزالتها فقط بعد التأكد من محتوياتها والتأكد من وجود نسخة احتياطية منفصلة قابلة للاستعادة.
قم بتحميل الأرشيف في قاعدة البيانات الفارغة:
sudo -u postgres pg_restore --dbname=synapse /secure-backups/synapse.dump
تحقق من حالة خروج الأمر ومخرجات PostgreSQL. ابحث عن الأخطاء قبل تشغيل Synapse. تجنب استخدام خيارات مثل --cleanاختصار استعادة البيانات فوق قاعدة بيانات إنتاجية ممتلئة؛ إذ يحذر Synapse من أن الجداول الموجودة مسبقًا قد تتسبب في أخطاء أو تناقضات دقيقة.
إذا لم يستثنِ ملف النسخ الاحتياطي بيانات المفاتيح المؤقتة، فامسحها قبل بدء التشغيل. اتصل بقاعدة البيانات المستعادة وقم بتشغيل ما يلي:
sudo -u postgres psql --dbname=synapse -c 'TRUNCATE e2e_one_time_keys_json;'
يوثق Synapse هذا الاستثناء لأن استعادة المفاتيح القديمة ذات الاستخدام الواحد قد تتسبب في إعادة استخدام العميل لمفاتيح سبق استخدامها، مما قد يؤدي إلى مشاكل في فك تشفير الرسائل. يؤدي مسح هذه المفاتيح إلى مطالبة العملاء بتحميل مفاتيح جديدة. إذا اتبعت الاستثناء الموصى به، فلن يحتوي الجدول على أي صفوف مستعادة، وبالتالي فإن هذا الاقتطاع الإضافي غير ضروري.
مفهوم خاطئ شائع: يمكن استعادة جميع جداول قاعدة البيانات معًا بأمان. الإجراء: استبعادها e2e_one_time_keys_jsonأثناء النسخ الاحتياطي أو حذف محتوياتها بعد الاستعادة، ويجب القيام بذلك قبل بدء أي عملية Synapse.
أعد تشغيل الخادم المنزلي وتحقق منه
استعد التكوين المطابق ومفتاح التوقيع وملفات الوسائط المحلية المطلوبة من نقطة الاستعادة نفسها إن أمكن. احتفظ بمفتاح التوقيع الأصلي: يستخدمه Synapse لتوقيع الأحداث وطلبات الاتحاد. إذا اضطررت لاستبداله، فاتبع إرشادات Synapse الخاصة بمفتاح التوقيع، وقم بتكوين المفتاح العام القديم كمفتاح توقيع قديم. قد لا تعكس قاعدة البيانات والوسائط والتكوينات المستعادة من نقاط زمنية متباعدة الحالة نفسها، لذا تحقق من خطة الاستعادة للتأكد من اتساقها.
لا تُشغّل Synapse وبرامجه العاملة إلا بعد اكتمال عملية الاستعادة ومعالجة المفتاح لمرة واحدة. راجع سجلات الخدمة بحثًا عن أعطال في اتصال قاعدة البيانات، أو أخطاء في المخطط أو الأذونات، أو مشاكل في تحديثات الخلفية. ثم سجّل الدخول باستخدام حساب تجريبي، واطلع على سجل غرفة معروفة، وافتح مرفقًا تم تحميله محليًا. تحقق من خدمات الاتحاد والتطبيقات إذا كان نشرك يعتمد عليها. هذه الفحوصات هي اختبار مبدئي، وليست ضمانًا لاستعادة جميع الغرف أو الوسائط.
يعتمد ذلك على بيئة النشر لديك: مسارات الأوامر، وأسماء الخدمات، وأدوار قواعد البيانات، وتنسيق الحاويات، وفترة الاحتفاظ بالنسخ الاحتياطية، كلها أمور خاصة بكل تثبيت. يغطي هذا الإجراء عملية تفريغ واستعادة منطقية لقاعدة بيانات PostgreSQL، ولا يشمل الاستعادة إلى نقطة زمنية محددة، أو أدوار مجموعة PostgreSQL، أو تصميم تجاوز الفشل عالي التوفر. بالنسبة لأنظمة الإنتاج، راجع وثائق النسخ الاحتياطي لـ Synapse ووثائق النسخ الاحتياطي والاستعادة لـ PostgreSQL للاطلاع على الطرق التي تتوافق مع إصدار PostgreSQL لديك وأهداف الاستعادة. سجّل تاريخ اختبار الاستعادة، وإصدارات البرامج، والنتيجة؛ ولا تفترض أن الأرشيف غير المختبر هو نسخة احتياطية قابلة للاستعادة.