رفع حد ملفات Systemd في Synapse بدون تخمين
قم بتشخيص ما إذا كان برنامج Synapse قد وصل إلى الحد الأقصى للملفات المفتوحة لكل عملية، وقم بتعيين ملف systemd drop-in للخدمة أو العامل المناسب، وتحقق من الحد الأقصى للتشغيل.
لربط واتساب، وتليجرام، وديسكورد، أنشئ ثلاث جسور منفصلة، وسجّل كل جسر كخدمة تطبيق، وسجّل الدخول عبر مساره الخاص. النجاح يعني أن كل بوت يُبلغ عن جلسة مصادقة وأن رسائل الاختبار تنتقل في كلا الاتجاهين عبر غرف البوابة؛ مجرد ظهور البوت متصلاً بالإنترنت لا يكفي.
هذا مخصص لمسؤول خادم منزلي يسمح بخدمات التطبيقات. لا يمكنك إضافة جسر مُستضاف ذاتيًا إلى matrix.org إلا إذا كان مُديروه يُوفرونه؛ استخدم خادمًا تتحكم به أو جسرًا مُستضافًا مُتاحًا. تمت مراجعة وثائق المشروع في 10 أكتوبر 2026.
هذه ثلاث خدمات منفصلة، لكل منها إعداداتها وتسجيلها وقاعدة بياناتها وتسجيل دخولها الخاص. يعتمد Mautrix بشكل أساسي على تقنية "الدمى": تنتقل الرسائل عبر حسابك البعيد المرتبط وتظهر في Matrix باسم ذلك الحساب. أما روبوت الترحيل فهو مختلف؛ اختره فقط إذا كنت ترغب في هوية روبوت مشتركة بدلاً من حسابك الشخصي.
تحتاج إلى خادم منزلي يدعم خدمة التطبيقات، وصلاحيات إدارية، واتصال شبكي لكل جسر. يتوفر توثيق لـ Docker. خصص لكل جسر دليل بيانات خاص به، واختر علامة إصدار مُحدّثة؛ تشير ملاحظات mautrix إلى أن هذه العلامة latestقد تُشير إلى آخر تحديث بدلاً من إصدار رسمي.
استخدم قاعدة بيانات منفصلة لكل جسر؛ يمكن مشاركة خادم PostgreSQL، ولكن يجب عدم مشاركة قاعدة البيانات نفسها مع جسر آخر أو Synapse. يُعد SQLite خيارًا مناسبًا للحالات الصغيرة. حدد خيار تشفير البيانات من طرف إلى طرف قبل تسجيل الدخول، لأن تفعيله لاحقًا لغرف البوابة الحالية أمرٌ صعب.

http://synapse:8008`. يجب أن يشير عنوان خدمة التطبيق إلى اسم خدمة الجسر ومنفذ الاستماع الخاص به. localhostيشير عنوان `<اسم الخدمة>` داخل حاوية الجسر إلى نفس الحاوية، وليس إلى Synapse أو جسر آخر، لذا فإنه عادةً ما يقطع الاتصال. إذا كان الخادم الرئيسي خارج Docker، فانشر أو وجّه منفذ الجسر المطلوب بدلاً من ذلك.homeserver.yaml، أضف مساراتها تحت app_service_config_files، على سبيل المثال:app_service_config_files:
- /data/appservices/mautrix-whatsapp-registration.yaml
- /data/appservices/mautrix-telegram-registration.yaml
- /data/appservices/mautrix-discord-registration.yaml
قم بتثبيت ملفات التسجيل داخل حاوية Synapse إذا كان Synapse يعمل في Docker. أعد تشغيل Synapse بعد تعديل القائمة. قد يؤدي خطأ إملائي في ملف YAML، أو مسار خاطئ، أو تثبيت غير قابل للقراءة، أو عنوان جسر غير متطابق إلى منع التسجيل أو إيقاف تشغيل Synapse. إذا قمت بتغيير إعدادات الجسر المتعلقة بالتسجيل لاحقًا، فأعد إنشاء ملف التسجيل ذي الصلة وأعد تشغيل Synapse مرة أخرى.


شغّل تطبيق Matrix-WhatsApp وافتح رسالة مباشرة مع بوت الربط الخاص به، عادةً ما يكون @whatsappbot:your.server. أرسل login qr، ثم امسح رمز الاستجابة السريعة (QR code) من شاشة الأجهزة المرتبطة في واتساب على هاتفك. انتظر حتى يؤكد البوت عملية المصادقة؛ تشير وثائق الربط إلى أن ظهور غرف البوابة قد يستغرق حوالي دقيقة. واتساب مرتبط كجهاز، لذا فهو ليس حسابًا سحابيًا مستقلًا. تشير وثائق الربط إلى أن الأجهزة المرتبطة تنقطع إذا ظل الهاتف غير متصل بالإنترنت لأكثر من أسبوعين. إذا لم تتمكن من إبقاء الهاتف نشطًا، ففكّر مليًا فيما إذا كان هذا الربط يلبي احتياجاتك من حيث الموثوقية قبل الاعتماد عليه في المحادثات المهمة.
قبل تسجيل الدخول إلى تيليجرام، أنشئ تطبيق API على my.telegram.org/apps وأضف بياناته api_idإلى api_hashإعدادات mautrix-telegram. تُمكّن هذه القيم الجسر من الاتصال بواجهة برمجة تطبيقات تيليجرام، ولا تُستخدم للتحقق من حساب تيليجرام بشكل مباشر. ثم أرسل رسالة @telegrambot:your.serverواستخدم login qrرمز التحقق، وامسحه ضوئيًا من تطبيق تيليجرام على الهاتف المحمول ضمن الإعدادات، ثم الأجهزة، ثم ربط جهاز سطح المكتب. يمكن إرسال رمز التحقق إلى جلسة تيليجرام الحالية بدلًا من الرسائل النصية القصيرة، ويمكن للجسر طلب كلمة مرور التحقق بخطوتين. تحقق من إعدادات استعادة الرسائل القديمة للجسر قبل تسجيل الدخول إذا كان استيراد الرسائل القديمة مهمًا؛ فقد يكون تغيير التوقعات بعد إنشاء غرف البوابة متأخرًا جدًا.
بالنسبة للخادم، استخدم بوت ديسكورد مخصصًا، وليس أتمتة حسابك الشخصي: يمنع ديسكورد استخدام البوتات الذاتية وقد يُغلق الحسابات. أنشئ تطبيقًا وبوتًا في بوابة المطورين، وفعّل فقط النوايا المميزة التي يتطلبها الجسر والتي يمكن لتطبيقك الحصول عليها، ثم قم بدعوته باستخدام نطاق بوت OAuth2 والحد الأدنى من أذونات القناة. يتم التحكم في الوصول إلى النوايا من خلال السياسات؛ وبدون الوصول إلى محتوى الرسائل أو الأعضاء، قد لا تعمل بعض الوظائف. في Matrix، راسلهم مباشرةً @discordbot:your.serverواتبع تعليمات تسجيل الدخول باستخدام رمز البوت في mautrix-discord. لا يوفر البوت نفس إمكانية الوصول إلى الرسائل الخاصة الشخصية التي يوفرها جسر حساب المستخدم.

أرسل رسالة خاصة إلى كل بوت جسر وتأكد من حالة المصادقة. في غرفة بوابة واحدة لكل خدمة، أرسل رسالة اختبار من ماتريكس وأجب عليها من التطبيق البعيد. تأكد من وصول كلتا الرسالتين إلى الغرفة الصحيحة. بالنسبة للمجموعات أو قنوات ديسكورد، تأكد أولاً من وجود حساب الجسر ومنحه صلاحيات القراءة والنشر. تسجيل الدخول الناجح وحده لا يثبت وصول الرسالة.
إذا كان البوت صامتًا، فتحقق من سجلاته بحثًا عن قيم مفقودة أو أخطاء في قاعدة البيانات أو مشاكل في اتصال الخادم الرئيسي. إذا نجح تسجيل الدخول ولكن لم تظهر الغرف، فتحقق من إعدادات البوابة وإعادة ملء البيانات. بالنسبة لرسائل قنوات ديسكورد المفقودة، تحقق من عضوية البوت وأذوناته وصلاحيات الوصول. إذا فشل تشغيل Synapse، فتحقق من مسافة YAML البادئة وملفات التسجيل المقروءة.
يختلف دعم الميزات باختلاف إصدار الجسر ونوع الحساب؛ فقد تختلف المكالمات، والتفاعلات، والمحادثات المشفرة، والوسائط، واستيراد السجل، أو قد لا تكون مدعومة. تحقق من قائمة الميزات الحالية لكل جسر قبل الاعتماد عليه كنقطة وصولك الوحيدة. قيّد الوصول إلى ملفات التسجيل وبيانات الاعتماد، واحفظ نسخة احتياطية من بيانات الجسر بشكل آمن، وألغِ الجلسة أو الرمز المميز المرتبط في حال انكشافه.
استخدم تعليمات Docker الحالية الخاصة بـ mautrix ، ودليل التسجيل ، ومرجع التكوين ، وصفحات المصادقة الخاصة بـ WhatsApp و Telegram و Discord للاطلاع على الأوامر الخاصة بكل إصدار. راجع سياسة Discord المتعلقة بالبوتات الذاتية .
قم بتشخيص ما إذا كان برنامج Synapse قد وصل إلى الحد الأقصى للملفات المفتوحة لكل عملية، وقم بتعيين ملف systemd drop-in للخدمة أو العامل المناسب، وتحقق من الحد الأقصى للتشغيل.
اكتشف ما إذا كان الخطأ يقتصر على متصفح واحد أو حدث واحد، ثم استخدم مفتاح استرداد Element أو جهازًا موثوقًا به دون المخاطرة بسجل التصفح المشفر المتبقي.
استخدم واجهات برمجة تطبيقات Synapse الخاصة بحذف السجلات والوسائط أو إعدادات الاحتفاظ لإزالة البيانات القديمة بأمان، ثم تحقق من اكتمال العملية واستعادة مساحة القرص.
قم بتثبيت المكتبة الحالية، وقم بتوصيل حساب Matrix مخصص، وقم بتشغيل روبوت !echo صغير مع معالجة بيانات اعتماد أكثر أمانًا واختبار واضح.
قم بإعداد ثلاثة جسور mautrix مع تسجيلات وتسجيلات دخول واختبارات منفصلة - وتجنب مفاجآت شبكات Docker وسياسة الحساب والمزامنة.
ابحث عن الأشياء التي تملأ مساحة تخزين Synapse، وقم بتعيين الاحتفاظ الآمن بالوسائط، وقم بمسح ذاكرة التخزين المؤقت عن بعد دون حذف الملفات مباشرة من القرص.
راجع نشاط الجهاز، وقم بتعطيل حسابات Synapse غير النشطة المؤكدة من خلال واجهة برمجة تطبيقات المسؤول، وتعرف على ما الذي تزيله علامة المسح الاختيارية فعليًا.
حدد ما إذا كانت ذاكرة PostgreSQL تأتي من عمليات الاستعلام، أو المخازن المؤقتة المشتركة، أو الاتصالات، أو الصيانة، ثم قم بإجراء تغييرات مستهدفة آمنة لـ Synapse.
تتبع عمليات انضمام غرفة المصفوفة البطيئة إلى خادم منزلي بعيد واحد، أو تراجع الاتحاد، أو تحميل قاعدة البيانات المحلية، أو قائمة انتظار المرسل الصادر قبل تغيير إعدادات Synapse.
أوقف إنشاء الحسابات المفتوحة على خادم Synapse المستضاف ذاتيًا، أو اجعل عمليات التسجيل مقتصرة على الدعوات فقط باستخدام رموز تسجيل محدودة الاستخدام.