تنظيف رسائل Synapse القديمة والوسائط دون فقدان البيانات

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

اختر عملية التنظيف التي تتناسب مع هدفك

ما الذي يشغل حيزاً؟استخدمحد هام
الرسائل القديمة وأحداث الغرفة الأخرىواجهة برمجة تطبيقات إدارة سجل الحذف، أو الاحتفاظ التلقائي بالرسائليتم حذف سجل العمليات بشكل خاص بكل غرفة. يتم الاحتفاظ بحالة الغرفة؛ ويحتفظ برنامج Synapse برسالة واحدة على الأقل في كل غرفة.
الوسائط المخزنة بواسطة خادمك المنزليحذف واجهة برمجة تطبيقات الوسائط المحلية، أو الاحتفاظ بالوسائط المحليةيتم حماية الوسائط المستخدمة في الملفات الشخصية وصور الغرف افتراضيًا بواسطة نقطة نهاية التاريخ/الحجم.
الوسائط المخزنة مؤقتًا من خوادم منزلية أخرىواجهة برمجة تطبيقات حذف الوسائط عن بُعد، أو الاحتفاظ بالوسائط عن بُعدإذا طُلب مرة أخرى، يقوم برنامج Synapse بجلبها مرة أخرى من الخادم الأصلي.

تؤثر هذه الإعدادات على قاعدة بيانات Synapse ومستودع الوسائط الخاص بها. إذا كنت تستخدم مستودع وسائط خارجي، مثل Matrix Media Repository، فلن تقوم نقطة نهاية حذف الوسائط المحلية في Synapse بإزالة الملفات المخزنة هناك. لذا، يُرجى مراجعة وثائق المستودع وسياسة النسخ الاحتياطي الخاصة به قبل حذف البيانات.

استعد قبل أن تقوم بالتطهير

  1. تأكد من أي نسخة من Synapse تتولى معالجة الوسائط. في بيئة عاملة، يتم تشغيل عملية تنظيف الوسائط على العامل باستخدام الأمر enable_media_repo: true`subject`؛ وقد تكون هذه هي العملية الرئيسية. تأكد من توجيهك وتكوينك قبل تشخيص عملية التنظيف التي يبدو أنها لا تعمل.
  2. قم بعمل نسخة احتياطية من قاعدة البيانات ومخزن الوسائط. خذ نسخة احتياطية حديثة قابلة للاستعادة قبل حذف البيانات نهائيًا. سجّل مُعرّف الغرفة ووقت الإيقاف، واستخدم رمز وصول مسؤول الخادم. لا تلصق الرمز في سجل أوامر النظام المشترك أو تنشره في سجلات النظام.
  3. خطط لوقت القطع بعناية. تقبل نقاط نهاية الحذف الطوابع الزمنية بالمللي ثانية في نظام يونكس. استخدم وقت قطع مُشتق من التوقيت العالمي المنسق (UTC) وتحقق من الرقم قبل إرسال الطلب. وقت القطع ليس معاينة: فقد يؤدي إلى حذف البيانات المؤهلة نهائيًا.

في الأمثلة أدناه، استبدل https://matrix.example.comعنوان URL الأساسي الخاص بالعميل لخادمك المنزلي، وحدد معرّف غرفة صالحًا، وقم بتصدير رمز المسؤول في ملف ADMIN_TOKEN. احتفظ برمز الحامل سرًا.

حذف سجل الرسائل القديمة من غرفة واحدة

تقوم واجهة برمجة تطبيقات "حذف السجل" بإزالة الأحداث الأقدم من تاريخ محدد من قاعدة بيانات Synapse. لا تُخفي هذه الواجهة الرسائل الخاصة بالخوادم الأخرى، وهي تختلف عن حذف غرفة. افتراضيًا، يحذف Synapse الأحداث المرسلة من المستخدمين البعيدين، ولكنه يحتفظ بأحداث المستخدمين المحليين؛ لذا يُنصح delete_local_eventsبتفعيل trueهذا الخيار فقط عند الرغبة في حذف أحداث المستخدمين المحليين أيضًا. يتم الحفاظ على حالة الغرفة، مثل العضوية والموضوع.

على سبيل المثال، لتعيين حد زمني قبل 180 يومًا من الوقت الحالي على مضيف Linux، احسب الطابع الزمني بالمللي ثانية، وافحصه، ثم أرسل الطلب لغرفة واحدة:

export SYNAPSE_URL='https://matrix.example.com'
export ROOM_ID='!roomid:example.com'
export ADMIN_TOKEN='replace-with-a-server-admin-token'
PURGE_BEFORE_MS=$(python3 -c 'import time; print(int((time.time() - 180*86400) * 1000))')
printf 'Cutoff (Unix milliseconds): %s\n' "$PURGE_BEFORE_MS"

curl -sS -X POST "$SYNAPSE_URL/_synapse/admin/v1/purge_history/$ROOM_ID" \
  -H "Authorization: Bearer $ADMIN_TOKEN" \
  -H 'Content-Type: application/json' \
  -d "{\"purge_up_to_ts\":$PURGE_BEFORE_MS,\"delete_local_events\":true}"

احذف هذا الخيار delete_local_eventsأو عيّنه على "صحيح" falseإذا كنت ترغب في استخدام سلوك Synapse الافتراضي. إذا أعادت واجهة برمجة التطبيقات (API) قيمة فارغة purge_id، فهذا يعني أن عملية التنظيف قد بدأت، ولكنها لم تنتهِ بالضرورة. استعلم عن نقطة نهاية الحالة حتى تُبلغ عن الحالة، completeأو تحقق errorمما إذا كانت حالتها هي failed:

curl -sS "$SYNAPSE_URL/_synapse/admin/v1/purge_history_status/$PURGE_ID" \
  -H "Authorization: Bearer $ADMIN_TOKEN"

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

احذف الوسائط القديمة والملفات المخزنة مؤقتًا عن بُعد

لتنظيف الوسائط المحلية المستخدمة قبل تاريخ انتهاء الصلاحية لمرة واحدة، استخدم نقطة نهاية الوسائط المحلية الحالية. وهي before_tsعبارة عن طابع زمني يونكس بالمللي ثانية، ويمكنها أيضًا size_gtاستهداف الملفات التي تتجاوز حدًا معينًا من البايتات. يُبقي الإعداد الافتراضي الوسائط المستخدمة لصور الملف الشخصي أو صور الغرفة؛ لا تقم بتغييره keep_profiles=falseإلا إذا كنت ترغب في إزالة هذه الملفات عمدًا.

curl -sS -X POST "$SYNAPSE_URL/_synapse/admin/v1/media/delete?before_ts=$PURGE_BEFORE_MS" \
  -H "Authorization: Bearer $ADMIN_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{}'

راجع totalمعرّفات الوسائط المحذوفة والمستجيبة. تحذف نقطة النهاية الملفات الأصلية المحلية والصور المصغّرة. تجنّب المسار القديم الذي يحتوي على /media/<server_name>/delete; تشير وثائق Synapse إلى أن هذا المسار مُهمل منذ الإصدار 1.78.0. لا تعمل نقطة نهاية الوسائط المحلية الحالية على مستودع وسائط خارجي منفصل.

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

curl -sS -X POST "$SYNAPSE_URL/_synapse/admin/v1/purge_media_cache?before_ts=$PURGE_BEFORE_MS" \
  -H "Authorization: Bearer $ADMIN_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{}'

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

قم بتعيين فترة احتفاظ متكررة بدلاً من عمليات الحذف اليدوية المتكررة.

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

retention:
  enabled: true
  default_policy:
    max_lifetime: 1y

استخدم وحدات المدة التي يدعمها Synapse، مثل d10 أيام و 10 سنوات. يمكن لمسؤولي الغرف والمشرفين أيضًا تحديد حالة حدث yالغرفة ، بينما يمكن لمسؤولي الخادم تحديد الحد الأقصى المسموح به لفترات بقاء الأحداث باستخدام ` . راجع سياستك بالكامل قبل تفعيلها: تُزال الأحداث المؤهلة نهائيًا بواسطة عمليات تنظيف الخلفية. يخفي Synapse الأحداث منتهية الصلاحية عن العملاء بمجرد انتهاء صلاحيتها، ولكن عملية تنظيف قاعدة البيانات تُنفذ دوريًا، لذا قد تبقى بعض الصفوف حتى يتم تشغيل إحدى العمليات. لا يشمل الاحتفاظ بالرسائل أحداث الحالة.m.room.retentionallowed_lifetime_minallowed_lifetime_max

بالنسبة للوسائط، أضف media_retentionفترات صلاحية، على سبيل المثال:

media_retention:
  local_media_lifetime: 90d
  remote_media_lifetime: 14d

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

اقرأ الوثائق الرسمية لواجهة برمجة تطبيقات سجل الحذف ، وواجهة برمجة تطبيقات إدارة الوسائط ، ودليل تكوين Synapse ، وسياسة الاحتفاظ بالرسائل قبل تطبيق أي تغييرات. يعكس سلوك واجهة برمجة التطبيقات الموضح هنا الوثائق الرسمية التي تم التحقق منها في 10 أكتوبر 2026؛ تأكد من توافق نقاط النهاية والتكوين مع الإصدار المُثبّت لديك.

تم التحقق من استعادة مساحة التخزين

  • قم بفحص حالة مسح السجل حتى تظهر كلمة "مسح" complete؛ احتفظ بمعرف المسح والاستجابة لسجل الصيانة الخاص بك.
  • تحقق من عدد عمليات الحذف في الوسائط المحلية واستجابات ذاكرة التخزين المؤقت البعيدة، ثم افحص سجلات Synapse واستخدام نظام الملفات بعد عملية التنظيف.
  • لا تفترض أن تقليل عدد صفوف قاعدة البيانات يعني بالضرورة صغر حجم ملف قاعدة البيانات. تشير وثائق Synapse إلى أن PostgreSQL قد يعيد استخدام المساحة المُحررة دون إعادتها إلى نظام التشغيل. بالنسبة لـ PostgreSQL، VACUUM FULLيمكن استعادة مساحة القرص، ولكن يتطلب ذلك قفلًا حصريًا؛ لذا، يُنصح بجدولة العملية مع مراعاة وقت التوقف/التأثير، واتباع وثائق VACUUM الخاصة بـ PostgreSQL . أما بالنسبة لـ SQLite، فتُحدد وثائق الاحتفاظ الخاصة بـ Synapse VACUUMالعملية المقابلة.
  • تأكد من عدم تقديم الملفات المتوقعة أو الأحداث القديمة، وتحقق من أن النسخة الاحتياطية الخاصة بك لا تزال متاحة قبل إغلاق مهمة الصيانة.

اترك تعليقاً

رفع حد ملفات Systemd في Synapse بدون تخمين

رفع حد ملفات Systemd في Synapse بدون تخمين

قم بتشخيص ما إذا كان برنامج Synapse قد وصل إلى الحد الأقصى للملفات المفتوحة لكل عملية، وقم بتعيين ملف systemd drop-in للخدمة أو العامل المناسب، وتحقق من الحد الأقصى للتشغيل.

هل تظهر رسالة "فشل فك التشفير"؟ استعد مفتاح الغرفة المفقود

هل تظهر رسالة "فشل فك التشفير"؟ استعد مفتاح الغرفة المفقود

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

تنظيف رسائل Synapse القديمة والوسائط دون فقدان البيانات

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

قم بإنشاء روبوت صدى المصفوفة باستخدام بايثون مع مكتبة Simple-Matrix-Bot-Lib

قم بإنشاء روبوت صدى المصفوفة باستخدام بايثون مع مكتبة Simple-Matrix-Bot-Lib

قم بتثبيت المكتبة الحالية، وقم بتوصيل حساب Matrix مخصص، وقم بتشغيل روبوت !echo صغير مع معالجة بيانات اعتماد أكثر أمانًا واختبار واضح.

اربط تطبيق ماتريكس بتطبيقات واتساب وتليجرام وديسكورد باستخدام جسور منفصلة

اربط تطبيق ماتريكس بتطبيقات واتساب وتليجرام وديسكورد باستخدام جسور منفصلة

قم بإعداد ثلاثة جسور mautrix مع تسجيلات وتسجيلات دخول واختبارات منفصلة - وتجنب مفاجآت شبكات Docker وسياسة الحساب والمزامنة.

استعادة مساحة قرص Synapse Media دون الإضرار بالملفات المشتركة

ابحث عن الأشياء التي تملأ مساحة تخزين Synapse، وقم بتعيين الاحتفاظ الآمن بالوسائط، وقم بمسح ذاكرة التخزين المؤقت عن بعد دون حذف الملفات مباشرة من القرص.

تعطيل حسابات مستخدمي المصفوفة غير النشطين دون حذف سجل الغرفة

تعطيل حسابات مستخدمي المصفوفة غير النشطين دون حذف سجل الغرفة

راجع نشاط الجهاز، وقم بتعطيل حسابات Synapse غير النشطة المؤكدة من خلال واجهة برمجة تطبيقات المسؤول، وتعرف على ما الذي تزيله علامة المسح الاختيارية فعليًا.

تقليل الضغط على ذاكرة PostgreSQL في Matrix Synapse

حدد ما إذا كانت ذاكرة PostgreSQL تأتي من عمليات الاستعلام، أو المخازن المؤقتة المشتركة، أو الاتصالات، أو الصيانة، ثم قم بإجراء تغييرات مستهدفة آمنة لـ Synapse.

لماذا تكون عمليات ربط غرف المشبك العصبي في المصفوفة بطيئة - وما الذي يجب فحصه

لماذا تكون عمليات ربط غرف المشبك العصبي في المصفوفة بطيئة - وما الذي يجب فحصه

تتبع عمليات انضمام غرفة المصفوفة البطيئة إلى خادم منزلي بعيد واحد، أو تراجع الاتحاد، أو تحميل قاعدة البيانات المحلية، أو قائمة انتظار المرسل الصادر قبل تغيير إعدادات Synapse.

إغلاق عمليات التسجيل في ماتريكس أو طلب رموز دعوة على سينابس

أوقف إنشاء الحسابات المفتوحة على خادم Synapse المستضاف ذاتيًا، أو اجعل عمليات التسجيل مقتصرة على الدعوات فقط باستخدام رموز تسجيل محدودة الاستخدام.