الرئيسية
» كيف
»
تفعيل خاصية مزامنة انزلاق المصفوفة الأصلية لتحميل أسرع على الأجهزة المحمولة
تفعيل خاصية مزامنة انزلاق المصفوفة الأصلية لتحميل أسرع على الأجهزة المحمولة
بالنسبة لعميل Matrix الحالي على الأجهزة المحمولة، لا تُضِف وكيل Sliding Sync Proxy القديم المستقل إلى Docker Compose. تمت أرشفة هذا الوكيل في نوفمبر 2025؛ إذ يُقدّم Synapse ميزة Simplified Sliding Sync الأصلية بنفسه، وهي مُفعّلة افتراضيًا منذ الإصدار 1.114 من Synapse. حدّث Synapse إلى إصدار مدعوم، وتأكد من وصول الميزة الأصلية إلى العملاء عبر عنوان URL العام الخاص بك، وقِس سرعة التحميل على عميل يدعمها.
ما الذي تغير، وما الذي تحتاجه
كان مصطلح "المزامنة المنزلقة" يشير في الأصل إلى تطبيق الوكيل MSC3575، الذي كان يعمل كواجهة أمامية لبرنامج Synapse ويتطلب خدمة وإعدادات اكتشاف منفصلة. تطورت مواصفات Matrix لاحقًا، حيث حلّت MSC4186، وهي المزامنة المنزلقة المبسطة، محل هذا التصميم. تم أرشفة مستودع الوكيل الرسمي ، ويشير إلى أنه لم يعد من المتوقع أن تعمل معه البرامج الحديثة. أضاف برنامج Synapse دعمًا أصليًا لـ MSC3575 وMSC4186، وقام بتفعيله افتراضيًا بدءًا من الإصدار 1.114.0، كما هو مسجل في سجل تغييرات Synapse .
يفترض هذا الدليل أن Synapse يعمل بالفعل مع Docker Compose خلف عنوان URL عام HTTPS https://matrix.example.org. ستحتاج إلى الوصول إلى سطر الأوامر لمشروع Compose، وطريقة لتعديل علامة الصورة وإعدادات الخادم الرئيسي، وتطبيق جوال يدعم إصداره الحالي ميزة Sliding Sync الأصلية. إذا كنت ترغب فقط في تسريع التحميل الأولي في عميل لا يدعم هذه الميزة، فلن يؤدي إضافة وكيل إلى تفعيلها في ذلك العميل.
قم بإعداد تحديث آمن لبرنامج Synapse
استخدم إصدارًا مُحدّثًا من Synapse بدلاً من تثبيت إصدار جديد على الحد الأدنى من الميزات القديمة. راجع إصدارات Synapse الرسمية وملاحظات الترقية للإصدار الذي تنتقل منه. أنشئ نسخة احتياطية من قاعدة البيانات ووحدات تخزين بيانات/تكوين Synapse قبل الترقية، وتحقق مما إذا كانت الملاحظات تتطلب خطوات ترقية وسيطة. هذا الأمر بالغ الأهمية، خاصةً في عمليات التثبيت القديمة: إذ تُدرج إشعارات أمان Synapse الخاصة بكشف حالة غرفة Sliding Sync الإصدارات المتأثرة حتى الإصدار 1.120.0، وتُصلحها في الإصدار 1.120.1. اختر إصدارًا مدعومًا حاليًا يتضمن إصلاحات أحدث، وليس فقط أول إصدار مُصحّح.
في ملف Compose الخاص بك، حدد مفتاح خدمة Synapse ووسم الصورة الذي يستخدمه. إذا كان الوسم مثبتًا على إصدار قديم، فغيّره إلى الإصدار المدعوم الذي اخترته. ثم اسحب وأعد إنشاء تلك الخدمة فقط؛ استبدل synapseما يلي إذا كان لخدمتك اسم آخر:
قم بسحب صورة Synapse بعد تحديث علامتها إلى الإصدار المحدد لعملية النشر الخاصة بك.
docker compose pull synapse
أعد إنشاء خدمة Synapse حتى يقوم Compose بتشغيل الصورة المحددة.
docker compose up -d synapse
docker compose logs --tail=100 synapse
راجع سجلات النظام بحثًا عن أخطاء بدء التشغيل وتحديث قاعدة البيانات قبل المتابعة. لا تقم بتخفيض الإصدار دون الرجوع إلى الإصدار السابق في حال فشل بدء التشغيل؛ راجع إرشادات الترقية الخاصة بالإصدار، واستعد نسخة احتياطية باستخدام عملية الاسترداد المناسبة لقاعدة بياناتك فقط.
تأكد من تفعيل خاصية Sliding Sync الأصلية
يُفعّل برنامج Synapse عادةً ميزة Sliding Sync الأصلية افتراضيًا، لذا غالبًا لا يتطلب التثبيت الجديد أي ملف YAML إضافي. يحتفظ الإعداد باسم MSC القديم، مما قد يُسبب بعض الالتباس: فهو يتحكم في التنفيذ الأصلي لبرنامج Synapse وليس طلبًا لتشغيل الوكيل المُلغى. تحقق من ملفك الحالي homeserver.yamlبحثًا عن قيمة خاطئة صريحة. إذا وجدت واحدة، فغيّرها في قسم الميزة الحالي.
إذا كان تكوين Synapse الخاص بك يعطل هذه الإمكانية بشكل صريح، فقم بتمكينها في كتلة experimental_features الموجودة.
experimental_features:
msc3575_enabled: true
إذا كان experimental_featuresهذا الجزء موجودًا بالفعل، فقم بتعديله بدلًا من إضافة مفتاح YAML مكرر. إذا كان الإعداد غير موجود أو مُفعّلًا بالفعل، فاتركه كما هو. أعد إنشاء خدمة Synapse بعد أي تغيير في الإعدادات، وتحقق من سجلاتها. قد يمنع خطأ في مسافة بادئة YAML بدء تشغيل Synapse.
قم بإزالة مسار الوكيل المتوقف واختبر عملية الاكتشاف
افحص ملف JSON المُقدّم على العنوان المحدد https://matrix.example.org/.well-known/matrix/client. إذا كان يحتوي على الخاصية القديمة org.matrix.msc3575.proxy، فاحذفها مع الاحتفاظ بإدخالات اكتشاف العميل غير ذات الصلة. احذف أيضًا أي قاعدة وكيل عكسي تُرسل طلبات عميل Matrix إلى الوكيل المُلغى؛ /_matrix/client/يجب أن يصل مسار API القياسي إلى Synapse. لا تُضف منفذ وكيل جديدًا أو تُعلن عن عنوان URL للوكيل لـ MSC4186 الأصلي. احتفظ بأي قيم أخرى معروفة، بما في ذلك عنوان URL لخادمك الرئيسي، حسب متطلبات إعدادك.
من جهاز يمكنه الوصول إلى الخادم المنزلي العام، استعلم عن نقطة نهاية إصدارات العميل والخادم. يتحقق هذا من الخدمة التي يكتشفها العملاء فعليًا، بدلاً من التحقق من حاوية على شبكة Docker الخاصة فقط.
تحقق من استجابة الخادم المنزلي العام لمعرفة إمكانية simplified_msc3575 الأصلية.
بالنسبة لإصدار Synapse مع تفعيل الدعم الأصلي ونقطة نهاية موجهة بشكل صحيح، يجب أن يُطبع هذا الأمر true. إذا jqلم يكن متاحًا، فقم بتشغيل curlالطلب بدون علامة الأنبوب (pipe) وافحص حقل JSON. تُعد القيمة المفقودة أو الخاطئة إشارة خطأ مفيدة: تحقق من وصول DNS وHTTPS إلى الخادم المتوقع، وأن الوكيل العكسي يمرر مسار واجهة برمجة تطبيقات العميل إلى Synapse، وأن الصورة قيد التشغيل هي الإصدار الذي حددته، وأنه لا يوجد تكوين صريح يُعطل الميزة. لا تُفصح عن رموز الوصول عند مشاركة مخرجات التشخيص؛ فهذا الطلب الخاص بالإصدارات العامة لا يحتاج إلى رمز.
اختبر النتيجة على هاتف متوافق
سجّل الدخول أو أعد الاتصال باستخدام إصدار عميل يدعم البروتوكول الأصلي، باستخدام نفس الحساب والهاتف اللذين ستستخدمهما للمقارنة. سجّل بيانات أساسية قبل تغيير الخادم إن أمكن. قارن بدء تشغيل التطبيق بعد مسح بيانات التطبيق المحلية أو إعادة بنائها فقط إذا كنتَ على دراية بأن هذا يُزيل المحتوى المخزّن مؤقتًا؛ ثم قارن بدء التشغيل العادي وإعادة الاتصال بعد انقطاع اتصال الهاتف بالإنترنت. حافظ على ثبات الشبكة والحساب ومجموعة الغرفة وطريقة الاختبار.
قم بقياس الوقت من فتح التطبيق حتى تصبح قائمة الغرف قابلة للاستخدام، وليس فقط حتى تختفي شاشة البداية.
تحقق مما إذا كانت أسماء الغرف الأخيرة وحالة الرسائل غير المقروءة والرسائل الجديدة تظهر فور إعادة الاتصال.
راقب سجلات Synapse بحثًا عن أخطاء نقطة النهاية، أو عمليات إعادة المحاولة المتكررة، أو ضغط العامل/قاعدة البيانات أثناء نفس الاختبار.
يُعدّ ظهور قائمة الغرف الأولى بشكل أسرع، واستكمال الاتصال بسلاسة بعد إعادة الاتصال، مؤشرين عمليين على أن العميل يستخدم المسار المتوقع. لا يوجد تحسن عام في السرعة، إذ يؤثر كل من تطبيق العميل وذاكرة التخزين المؤقت المحلية، وزمن استجابة الشبكة، وأداء قاعدة البيانات، وعدد غرف الحساب، وحمل الخادم على النتيجة. كما أن ميزة المزامنة المتدرجة لا تُسرّع تنزيلات الوسائط أو تُصلح قاعدة البيانات المُثقلة. إذا اجتاز فحص الإمكانيات بنجاح، ولكن التطبيق لا يزال بطيئًا، قارنه بعميل آخر مدعوم، وتحقق من أسباب الاختناقات قبل تغيير إعدادات الوكيل أو ذاكرة التخزين المؤقت. إذا كنت لا تزال تستخدم عملاء قدامى يعتمدون على وكيل MSC3575 المُتوقف، فاختبر توافقهم بشكل منفصل قبل إزالة مسار الاكتشاف القديم؛ ولا تفترض أن نقطة نهاية واحدة تخدم جميع أجيال العملاء.