اجعل خادم Matrix Synapse الخاص بك قابلاً للوصول إليه من أجل الاتحاد
قم بتكوين اكتشاف Synapse و HTTPS وتوجيه الوكيل حتى تتمكن خوادم Matrix المنزلية الأخرى من العثور على خادمك والاتصال به.
إذا نفدت ذاكرة Matrix Synapse أثناء مزامنة العملاء، فتحقق أولاً مما إذا كان نظام Linux قد أوقف عملية Synapse بالفعل، ثم قِس حجم الذاكرة المستخدمة أثناء /_matrix/client/v3/syncالاستخدام العادي. إذا كان نمو ذاكرة التخزين المؤقت هو السبب، فقم بتعديلها بشكل طفيف بدلاً من فرض حد منخفض للغاية عليها؛ إذ قد يؤدي بطء استجابة قاعدة البيانات إلى تراكم الطلبات، مما يزيد المشكلة سوءًا.
اعتبارًا من 10 أكتوبر 2026، يُشير سجل إصدارات Synapse الرسمي إلى أن الإصدار 1.162.0 (29 سبتمبر) هو أحدث إصدار مستقر، بينما يُعد الإصدار 1.163.0rc1 إصدارًا تجريبيًا. يُنصح بتحديث التثبيتات القديمة، ولكن رقم الإصدار وحده لا يُشخّص أو يضمن حل مشكلة استنفاد الذاكرة المرتبطة بالمزامنة.
لا تُنشئ البرامج التي تُظهر مزامنة لا نهائية، أو خطأ في البوابة، أو جلسة غير متصلة، حدث نفاد الذاكرة تلقائيًا. في تثبيت نظام Linux systemd النموذجي، تحقق من سجل النواة وسجل الخدمات بالقرب من وقت تعطل البرنامج.
sudo journalctl -k --since "1 hour ago" | grep -Ei 'oom|out of memory|killed process'
sudo journalctl -u matrix-synapse --since "1 hour ago" --no-pager
ابحث عن رسالة من نواة النظام تُشير إلى عملية Synapse أو Python، أو حالة systemd مثل `<systemd>` oom-kill، أو Python MemoryError. تُشير هذه الرسائل إلى آليات فشل مختلفة: قد تُنهي النواة عمليةً ما عند الوصول إلى حد ذاكرة المضيف أو الحاوية، بينما MemoryErrorقد يحدث خطأ `<systemd>` داخل Python قبل إنهاء النظام بالكامل بسبب نفاد الذاكرة. يختلف اسم الخدمة باختلاف الحزم؛ استبدله باسم وحدتك أو حاويتك الفعلية.
بعد ذلك، قم بتسجيل ضغط المضيف وأكبر العمليات أثناء إعادة إنتاج عملية مزامنة عادية:
free -h
ps -eo pid,rss,%mem,args --sort=-rss | head -n 12
systemctl show matrix-synapse -p MemoryCurrent -p MemoryMax
RSSالذاكرة المقيمة بالكيلوبايت ليست مقياسًا دقيقًا لذاكرة التطبيق الفريدة؛ إذ يمكن احتساب الصفحات المشتركة ضمن عمليات متعددة. في Docker، تحقق أيضًا docker statsمن حد ذاكرة الحاوية المُكوّن. إذا كانت PostgreSQL وRedis والعديد من عمليات Synapse تشترك في نفس المضيف، فقم بتقييم حجم استهلاكها الإجمالي بدلاً من إلقاء اللوم على عملية Synapse الرئيسية وحدها.
يحتفظ برنامج Synapse عمدًا بالأحداث الحديثة وبيانات الغرف في الذاكرة لتسريع معالجة طلبات المزامنة. caches.global_factorالقيمة الافتراضية الموثقة هي 1 0.5؛ تقليل هذه القيمة يقلل حجم ذاكرة التخزين المؤقت عمومًا، ولكنه يزيد من احتمالية زيادة عمليات قاعدة البيانات. تحذر الأسئلة الشائعة لمسؤولي Synapse من أن صغر حجم ذاكرة التخزين المؤقت بشكل مفرط على وحدات التخزين البطيئة قد يؤدي إلى تراكم الطلبات وزيادة استخدام الذاكرة بشكل عام.
قم بعمل نسخة احتياطية من الملف النشط homeserver.yaml، وتحقق من وجود caches:كتلة موجودة، ثم غيّر القيم ذات الصلة فقط. هذا إعداد تجريبي لحالة تُظهر زيادة في استخدام ذاكرة التخزين المؤقت، وليس هدفًا عامًا للضبط.
caches:
global_factor: 0.3
sync_response_cache_duration: 1m
يتحكم إعداد ذاكرة التخزين المؤقت للاستجابة المتزامنة في مدة /syncبقاء النتائج المكتملة مخزنة مؤقتًا؛ وتوثق Synapse القيمة 2mالافتراضية. قد يؤدي تقليل مدة التخزين المؤقت إلى تقليل عدد الاستجابات المحفوظة، ولكنه قد يزيد أيضًا من الجهد المطلوب من العملاء ذوي الاتصالات المتقطعة. لا تُضف caches:مفتاحًا ثانيًا إذا كان موجودًا بالفعل. إذا تم تعيين هذا الإعداد SYNAPSE_CACHE_FACTORفي بيئة الخدمة أو الحاوية الخاصة بتثبيتك، فإن هذا المتغير له الأولوية على عامل YAML.
تحقق من صحة الملف باستخدام بيئة بايثون المستخدمة في تثبيت Synapse الخاص بك، مع تعديل مسار التكوين حسب الحاجة:
python -m synapse.config -c /etc/matrix-synapse/homeserver.yaml
أعد التشغيل فقط بعد التحقق. في حزم systemd بنمط Debian، يكون هذا هو الإجراء المعتاد sudo systemctl restart matrix-synapse؛ أما في عمليات نشر الحاويات، فيتم استخدام نظام إدارة خاص بها. تحقق من سجل الخدمة فورًا بعد ذلك بحثًا عن أخطاء في التكوين. يشير مرجع تكوين Synapse أيضًا إلى إمكانية إعادة تحميل عوامل التخزين المؤقت باستخدام الأمر SIGHUP`setup`، ولكن هذا لا يعني إمكانية إعادة تحميل الإعدادات الأخرى، بما في ذلك الاحتفاظ باستجابة المزامنة. ستكون إعادة التشغيل المُتحكَّم بها أكثر وضوحًا عند تغيير كلا الإعدادين.
إذا استمر استهلاك الذاكرة في الارتفاع بينما لا تزال عمليات العملاء عالقة، فقد يكون تقليل حجم ذاكرة التخزين المؤقت أكثر من اللازم غير مجدٍ. قارن توقيت ارتفاع استهلاك الذاكرة مع ضغط وحدة المعالجة المركزية، وعمليات الإدخال/الإخراج للقرص، ونشاط قاعدة البيانات. قد يتسبب ازدحام الخادم أو بطء استعلامات PostgreSQL في زيادة عدد الطلبات الجارية المتزامنة، والتي قد يحتفظ كل منها بالبيانات حتى اكتمالها.
تحقق أولاً من استجابة قاعدة البيانات وسلامة مساحة القرص وعمليات الإدخال/الإخراج. تم تصميم Synapse للإنتاج للعمل مع PostgreSQL وليس SQLite، كما هو موثق في مرجع تكوين Synapse . إذا كانت هذه نسخة قديمة مدعومة بـ SQLite، فخطط لترحيل قاعدة البيانات بشكل مدعوم مع وجود نسخة احتياطية مُختبرة؛ ولا تحاول استبدال قاعدة البيانات أثناء التشغيل كحل طارئ لمشكلة نقص الذاكرة.
إذا قمتَ سابقًا بتخفيض global_factorقيمة ذاكرة التخزين المؤقت إلى حدٍّ كبير وتفاقم زمن استجابة المزامنة، فاستعد القيمة السابقة أو جرّب إعدادًا أعلى قليلًا مع مراقبة كلٍّ من أوقات الاستجابة وإجمالي الذاكرة. تشير الأسئلة الشائعة لمسؤولي Synapse صراحةً إلى أن زيادة ذاكرة التخزين المؤقت قد تُساعد عندما تتسبب الخوادم الخلفية البطيئة في حدوث ازدحام. لا يوجد هدف ثابت وآمن لذاكرة الوصول العشوائي (RAM) يُناسب جميع أحجام الغرف، وأحمال الاتحاد، وتخطيطات النشر.
في بيئة نشر متعددة العمليات ذات كثافة عالية، حدد ما إذا كانت العملية الرئيسية أو عامل مزامنة محدد هو الذي يتزايد حجمه. تسمح عوامل المزامنة بتوزيع حركة مرور مزامنة العميل، ولكن كل عامل يحتاج أيضًا إلى ذاكرة، لذا فإن إضافة عوامل دون سعة إضافية قد يزيد من ضغط نفاد الذاكرة على المضيف. اتبع توثيق عامل المزامنة في Synapse بدلاً من توجيه طلبات العميل إلى عوامل عشوائية دون التكوين المشترك المطلوب.
في نظام يدعم إعداد jemalloc المناسب والمُتحقق منه، يوفر Synapse هذه الميزة cache_autotuning. تتطلب هذه الميزة القيم الثلاث الموثقة max_cache_memory_usage- ، target_cache_memory_usage، و min_cache_ttl- وتستخدم آلية إخلاء الذاكرة المؤقتة للحفاظ على استخدام الذاكرة المؤقتة ضمن نطاق محدد. الأشكال التالية توضيحية، ويجب ضبط حجمها بحيث تترك مساحة كافية لـ Python وقاعدة البيانات والخدمات الأخرى وتدفقات الطلبات النشطة.
caches:
cache_autotuning:
max_cache_memory_usage: 512M
target_cache_memory_usage: 384M
min_cache_ttl: 5m
ادمج هذا الجزء مع إعدادات التخزين المؤقت الحالية بدلاً من استبدالها. هذه الأرقام تمثل ميزانيات التخزين المؤقت، وليست حدود RSS للعملية ؛ استخدامها لا يضمن بقاء حجم العملية أقل من 512 ميجابايت. يتطلب مرجع تكوين Synapse مكتبة jemalloc لهذه الميزة، وتحذر الأسئلة الشائعة لمسؤول Synapse من أن مُخصِّص الذاكرة في بايثون قد يتداخل مع حسابات jemalloc، مما قد يتطلب تعديلات PYTHONMALLOC=malloc. نظرًا لاختلاف مسارات التحميل المسبق للمُخصِّص وتغليفه، تحقق من مكتبة النشر وبيئة بدء التشغيل الفعلية قبل إجراء أي تغيير LD_PRELOAD. لا تنسخ مسار مكتبة خاص ببنية معينة دون تدقيق.
بعد كل تغيير، نفّذ نفس نشاط العميل الواقعي الذي تسبب في العطل سابقًا: أعد توصيل عميل موجود، واسمح بمزامنة أولية حيثما أمكن، وانتظر حتى اكتمال عدة عمليات مزامنة تزايدية عادية. سجّل أعلى قيمة لـ RSS لجميع عمليات Synapse، ونشاط الذاكرة الافتراضية، واستجابة قاعدة البيانات، وما إذا كانت النواة تسجل حدث نفاد ذاكرة آخر. لا يُعدّ الانخفاض الطفيف مباشرةً بعد إعادة التشغيل دليلًا على إصلاح دائم؛ فمن الطبيعي أن تبدأ ذاكرة التخزين المؤقت باردة.
في حال تفعيل خاصية المراقبة، قارن بين ذاكرة العمليات وسلوك الطلبات بمرور الوقت باستخدام نقطة نهاية مقاييس Synapse. توضح وثائق مراقبة Synapse أن العمال يعرضون المقاييس بشكل مستقل، ويجب مراقبتهم بشكل منفصل؛ لذا يُنصح بالحفاظ على نقاط نهاية المقاييس خاصة أو محمية بدلاً من نشر البيانات الداخلية علنًا.
نجح التغيير إذا أكمل العملاء عملية المزامنة دون إعادة اتصال متكررة، ولم تُظهر السجلات أي عمليات إيقاف جديدة للذاكرة، واستقر استهلاك الذاكرة عند مستوى مستدام في ظل نفس عبء العمل. إذا استمرت مشكلات نفاد الذاكرة (OOM) على الرغم من زمن استجابة المزامنة السليم وضبط ذاكرة التخزين المؤقت بعناية، فإن الخطوة العملية التالية هي زيادة ذاكرة الوصول العشوائي (RAM) المتاحة أو تقليل عبء العمل لكل مضيف، باستخدام ذروة الاستهلاك المقاسة بدلاً من حجم خادم مُوصى به بشكل عشوائي.
قم بتكوين اكتشاف Synapse و HTTPS وتوجيه الوكيل حتى تتمكن خوادم Matrix المنزلية الأخرى من العثور على خادمك والاتصال به.
قم بتكوين عميل Keycloak OIDC وموفر Synapse حتى يتمكن مستخدمو Element Web من تسجيل الدخول من خلال خادم الهوية الخاص بك دون الكشف عن أسرار العميل.
احفظ مفتاح الاسترداد، وتحقق من جلسات Element الخاصة بك، وتأكد من إمكانية استعادة مفاتيح الرسائل المشفرة دون الخلط بين النسخة الاحتياطية وكلمة مرور حسابك.
تشخيص حالات فشل نفاد الذاكرة في Synapse أثناء المزامنة، وضبط التخزين المؤقت بأمان، وتحديد تراكم الطلبات، والتحقق من استخدام الذاكرة بشكل مستقر.
تتبع حالات فشل شهادات اتحاد المصفوفة إلى الخادم الصحيح، وإصلاح سلسلة TLS أو ثقة CA، والتحقق من الإصلاح دون تعطيل عمليات التحقق الأمني.
توجيه عملاء Matrix والاتحاد عبر Cloudflare على HTTPS 443، والحفاظ على اكتشاف Synapse، وتجنب تخزين حركة مرور API مؤقتًا أو تعطيل عمليات تحميل الوسائط.
قم بعمل نسخة احتياطية من Synapse باستخدام pg_dump، وقم بحماية مفتاح التوقيع والوسائط الخاصة به، واستعدها في قاعدة بيانات PostgreSQL نظيفة دون إعادة استخدام المفاتيح القديمة التي تستخدم لمرة واحدة.
قم بإعداد Mjölnir باستخدام حساب Matrix مخصص، وغرفة إدارة مشفرة، وDocker Compose، وقائمة السياسات، وفحوصات الأذونات.
تجاوز استخدام الخادم الوكيل القديم وقم بتكوين ميزة المزامنة المنزلقة المدمجة في Synapse. تحقق من اكتشاف العميل، ثم قم بقياس تحميل قائمة الغرف وسلوك إعادة الاتصال على هاتف متوافق.
قم بنشر Element Web كموقع ثابت، وقم بتوجيهه إلى خادم Matrix الرئيسي الخاص بك، وأضف HTTPS، وقم بتكوين Nginx لتقديم التحديثات بدون ملفات قديمة.