تفعيل خاصية مزامنة انزلاق المصفوفة الأصلية لتحميل أسرع على الأجهزة المحمولة

بالنسبة لعميل 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ما يلي إذا كان لخدمتك اسم آخر:

نافذة طرفية تعرض أمر Docker Compose لسحب صورة Synapse.
قم بسحب صورة Synapse بعد تحديث علامتها إلى الإصدار المحدد لعملية النشر الخاصة بك.
docker compose pull synapse
نافذة طرفية تعرض أمر Docker Compose لإعادة إنشاء خدمة Synapse.
أعد إنشاء خدمة Synapse حتى يقوم Compose بتشغيل الصورة المحددة.
docker compose up -d synapse
docker compose logs --tail=100 synapse

راجع سجلات النظام بحثًا عن أخطاء بدء التشغيل وتحديث قاعدة البيانات قبل المتابعة. لا تقم بتخفيض الإصدار دون الرجوع إلى الإصدار السابق في حال فشل بدء التشغيل؛ راجع إرشادات الترقية الخاصة بالإصدار، واستعد نسخة احتياطية باستخدام عملية الاسترداد المناسبة لقاعدة بياناتك فقط.

تأكد من تفعيل خاصية Sliding Sync الأصلية

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

محرر YAML يعرض الميزات التجريبية مع ضبط msc3575_enabled على القيمة true.
إذا كان تكوين 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 الخاصة فقط.

طرفية تحتوي على أمر curl و jq يقرأ إمكانية MSC3575 المبسطة من نقطة نهاية إصدارات Matrix العامة.
تحقق من استجابة الخادم المنزلي العام لمعرفة إمكانية simplified_msc3575 الأصلية.
curl -fsS https://matrix.example.org/_matrix/client/versions | jq '.unstable_features["org.matrix.simplified_msc3575"]'

بالنسبة لإصدار Synapse مع تفعيل الدعم الأصلي ونقطة نهاية موجهة بشكل صحيح، يجب أن يُطبع هذا الأمر true. إذا jqلم يكن متاحًا، فقم بتشغيل curlالطلب بدون علامة الأنبوب (pipe) وافحص حقل JSON. تُعد القيمة المفقودة أو الخاطئة إشارة خطأ مفيدة: تحقق من وصول DNS وHTTPS إلى الخادم المتوقع، وأن الوكيل العكسي يمرر مسار واجهة برمجة تطبيقات العميل إلى Synapse، وأن الصورة قيد التشغيل هي الإصدار الذي حددته، وأنه لا يوجد تكوين صريح يُعطل الميزة. لا تُفصح عن رموز الوصول عند مشاركة مخرجات التشخيص؛ فهذا الطلب الخاص بالإصدارات العامة لا يحتاج إلى رمز.

اختبر النتيجة على هاتف متوافق

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

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

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

اترك تعليقاً

استعادة برنامج Matrix Synapse بأمان باستخدام نسخة احتياطية من قاعدة بيانات PostgreSQL

قم بعمل نسخة احتياطية من Synapse باستخدام pg_dump، وقم بحماية مفتاح التوقيع والوسائط الخاصة به، واستعدها في قاعدة بيانات PostgreSQL نظيفة دون إعادة استخدام المفاتيح القديمة التي تستخدم لمرة واحدة.

قم بتشغيل Mjölnir كبوت لإدارة غرف المصفوفة باستخدام Docker

قم بتشغيل Mjölnir كبوت لإدارة غرف المصفوفة باستخدام Docker

قم بإعداد Mjölnir باستخدام حساب Matrix مخصص، وغرفة إدارة مشفرة، وDocker Compose، وقائمة السياسات، وفحوصات الأذونات.

تفعيل خاصية مزامنة انزلاق المصفوفة الأصلية لتحميل أسرع على الأجهزة المحمولة

تفعيل خاصية مزامنة انزلاق المصفوفة الأصلية لتحميل أسرع على الأجهزة المحمولة

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

استضافة موقع Element Web على خادم Nginx مع خادم منزلي مخصص

قم بنشر Element Web كموقع ثابت، وقم بتوجيهه إلى خادم Matrix الرئيسي الخاص بك، وأضف HTTPS، وقم بتكوين Nginx لتقديم التحديثات بدون ملفات قديمة.

تشغيل خادم منزلي خفيف الوزن بتقنية المصفوفة على جهاز Raspberry Pi 4

قم بإعداد Conduit على جهاز Raspberry Pi 4 ذي 64 بت مع بيانات دائمة، واتحاد HTTPS، وتسجيل محمي، وفحوصات لخادم منزلي يعمل.

قم بإعداد اسم مستعار مخصص لغرفة المصفوفة على نطاقك الخاص

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

إعداد نظام كوتور لإجراء مكالمات صوتية ومرئية موثوقة عبر المصفوفة

قم بتكوين coturn و Synapse باستخدام بيانات اعتماد TURN المطابقة، وافتح منافذ الترحيل المطلوبة، وتحقق من أن عملاء Matrix يمكنهم الحصول على مرشحي الترحيل.

نشر Matrix Synapse باستخدام Docker Compose و PostgreSQL

نشر Matrix Synapse باستخدام Docker Compose و PostgreSQL

قم بإعداد خادم Synapse منزلي دائم باستخدام Docker Compose و PostgreSQL وتكوين خاص وفحوصات قبل عرضه عبر HTTPS.

تخصيص مظهر وعلامة Element Web التجارية

قم بتعيين اسم ذي علامة تجارية وألوان مخصصة وأصول تسجيل دخول لنشر Element Web الخاص بك مع فهم الأجزاء التي ستظل تحمل علامة Element التجارية.

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

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

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