رفع حد ملفات Systemd في Synapse بدون تخمين
قم بتشخيص ما إذا كان برنامج Synapse قد وصل إلى الحد الأقصى للملفات المفتوحة لكل عملية، وقم بتعيين ملف systemd drop-in للخدمة أو العامل المناسب، وتحقق من الحد الأقصى للتشغيل.
اعتبارًا من 10 أكتوبر 2026، يُدرج موقع PyPI الإصدار 2.13.1 من مكتبة Simple-Matrix-Bot-Lib، الصادر في 29 مارس 2026. تتطلب هذه الحزمة Python 3.9 أو أحدث، ولكن دعم Python 3.9 قد انتهى؛ لذا يُنصح باستخدام إصدار Python مدعوم ومتوافق مع الحزمة. لا تزال وثائق المشروع المُستضافة تُشير إلى الإصدار 2.11.0 وتُحذّر من عدم تحديثها، لذلك يتبع هذا الدليل مثال PyPI الحالي لواجهة برمجة تطبيقات البوت، ويستخدم الدليل القديم فقط لملاحظات التكوين المُوضّحة بوضوح. يُرجى مراجعة إصدار الحزمة وبياناتها الوصفية على PyPI ، والاطلاع على حالة توثيق المشروع .
أسرع إعداد موثوق به هو مستخدم مخصص لبرنامج Matrix، وبيئة افتراضية بلغة Python، وبرنامج روبوت صغير يستجيب !echoفي غرفة اختبار. هذا المثال لغرفة غير مشفرة؛ أما الغرف المشفرة فتتطلب إعدادات إضافية.
أنشئ حسابًا عاديًا على الخادم الرئيسي لتشغيل البوت، أو اطلب إنشاء حساب جديد. اختر له اسم مستخدم مميزًا، مثل echo_bot"اسم المستخدم"؛ فهو لا يحتاج إلى صلاحيات مدير الخادم. قد يكون التسجيل معطلاً أو مقيدًا من قِبل الخادم، لذا اتبع سياسة إنشاء الحسابات الخاصة به. ادعُ الحساب فقط إلى غرفة اختبار خاصة حيث يُسمح له بإرسال الرسائل.
استخدم بايثون 3.11 أو أي إصدار آخر مدعوم حاليًا من بايثون. مع أن بيانات الحزمة لا تزال تسمح باستخدام بايثون 3.9، إلا أن موقع Python.org يُشير إلى انتهاء دعم هذا الإصدار في 31 أكتوبر 2025، لذا فإن الحد الأدنى للإصدار المطلوب ليس توصية جيدة للنشر. راجع إشعار دعم بايثون 3.9 على موقع Python.org .
نفّذ هذه الأوامر من مجلد مشروع جديد. تحافظ البيئة الافتراضية على حزم هذا البوت منفصلة عن مشاريع بايثون الأخرى. يضمن تثبيت الإصدار إمكانية إعادة إنتاج المثال باستخدام أحدث إصدار تم التحقق منه لهذه المقالة؛ عند الترقية، تحقق من إصدار PyPI الحالي وملاحظات التوافق الخاصة به.
python3 --version
python3 -m venv .venv
source .venv/bin/activate
python -m pip install "simplematrixbotlib==2.13.1"
في Windows PowerShell، فعّل البيئة باستخدام الأمر .venv\Scripts\Activate.ps1بدلاً من sourceالأمر السابق. ثم أنشئ ملفًا باسم bot.py. توثّق صفحة مشروع PyPI اسم الحزمة وأمر التثبيت، ويستخدم مثالها المنشور Creds، و Bot، و ، و ، و MessageMatch. راجع مثال الاستخدام الحالي على PyPI .

احفظ ما يلي باسم bot.py. سيطلب منك إدخال كلمة مرور البوت عند بدء التشغيل، لذا لن تُكتب كلمة المرور في ملف المصدر. لنشر الخدمة تلقائيًا، اقرأ السر من مدير الأسرار في نظام التشغيل أو من متغير بيئة محمي بدلًا من تضمينه مباشرةً في الكود. تعامل مع أي جلسة أو رمز وصول مخزن بواسطة المكتبة كبيانات اعتماد: احتفظ به خاصًا وخارج نظام التحكم في الإصدارات.
import getpass
import simplematrixbotlib as botlib
creds = botlib.Creds(
homeserver="https://matrix.example.org",
username="echo_bot",
password=getpass.getpass("Bot password: "),
)
bot = botlib.Bot(creds)
PREFIX = "!"
@bot.listener.on_message_event
async def echo(room, message):
match = botlib.MessageMatch(room, message, bot, PREFIX)
if (match.is_not_from_this_bot()
and match.prefix()
and match.command("echo")):
text = " ".join(match.args())
reply = text or "Usage: !echo <text>"
await bot.api.send_text_message(room.room_id, reply)
bot.run()
استبدل عنوان URL الخاص بخادم المنزل (المثال) بعنوان URL الأساسي لخادمك، واستخدم اسم المستخدم وكلمة المرور لحساب البوت. يستقبل المستمع رسائل الغرفة، MessageMatchويتجاهل رسائله الخاصة، ويتعامل فقط مع !echoالأمر المطلوب. تُعيد استدعاءات واجهة برمجة التطبيقات (API) الكلمات المتبقية إلى نفس الغرفة. تتبع هذه الأسماء واستدعاءات الدوال مثال PyPI المنشور للمكتبة. قارن ذلك مع دليل البدء السريع لمكتبة Simple-Matrix-Bot-Lib .


من البيئة الافتراضية المُفعّلة، قم بتشغيل ما يلي:
python bot.py
أدخل كلمة مرور حساب البوت عند المطالبة. في غرفة الاختبار، أرسل رسالة !echo hello. سيرد بوت أساسي يعمل بشكل صحيح hello. إذا لم يرد، فتأكد من انضمام حساب البوت إلى تلك الغرفة، وأن المستخدم لديه إذن لإرسال الرسائل هناك، وأن عنوان URL الخاص بالخادم الرئيسي صحيح، وأن الرسالة تبدأ بالبادئة الصحيحة !. أبقِ العملية قيد التشغيل؛ إغلاق نافذة الأوامر الخاصة بها يوقف هذا النشر البسيط في المقدمة.

لا تعالج هذه العينة رسائل الغرف المشفرة تشفيرًا تامًا. تُعلن المكتبة عن دعمها للتشفير التام، لكن دليلها المُستضاف حاليًا يحمل الإصدار 2.11.0 وقد يكون قديمًا؛ إذ يصف هذا الدليل matrix-nio[e2e]تبعيات إضافية وإعدادًا Config.encryption_enabled. تأكد من خطوات التثبيت والتحقق الدقيقة للإصدار الذي تُثبّته قبل تفعيل التشفير. تُتيح الوثائق القديمة أيضًا إعدادًا join_on_invite؛ ادعُ الروبوت فقط إلى الغرف التي يجب أن يصل إليها، وتحقق من هذا الإعداد إذا كان نظامك يتطلب التحكم في عمليات الانضمام التلقائي إلى الغرف. راجع دليل التشفير التام والتكوين الخاص بالمكتبة .
يكتمل الإعداد عندما يبقى الروبوت مسجلاً دخوله، وعضواً في غرفة الاختبار، ويستجيب !echo helloبـ hello. أما في بيئة الإنتاج، فيُشغّل تحت إدارة العمليات، ويجب حماية كلمة المرور وبيانات الجلسة الخاصة به.
قم بتشخيص ما إذا كان برنامج Synapse قد وصل إلى الحد الأقصى للملفات المفتوحة لكل عملية، وقم بتعيين ملف systemd drop-in للخدمة أو العامل المناسب، وتحقق من الحد الأقصى للتشغيل.
اكتشف ما إذا كان الخطأ يقتصر على متصفح واحد أو حدث واحد، ثم استخدم مفتاح استرداد Element أو جهازًا موثوقًا به دون المخاطرة بسجل التصفح المشفر المتبقي.
استخدم واجهات برمجة تطبيقات Synapse الخاصة بحذف السجلات والوسائط أو إعدادات الاحتفاظ لإزالة البيانات القديمة بأمان، ثم تحقق من اكتمال العملية واستعادة مساحة القرص.
قم بتثبيت المكتبة الحالية، وقم بتوصيل حساب Matrix مخصص، وقم بتشغيل روبوت !echo صغير مع معالجة بيانات اعتماد أكثر أمانًا واختبار واضح.
قم بإعداد ثلاثة جسور mautrix مع تسجيلات وتسجيلات دخول واختبارات منفصلة - وتجنب مفاجآت شبكات Docker وسياسة الحساب والمزامنة.
ابحث عن الأشياء التي تملأ مساحة تخزين Synapse، وقم بتعيين الاحتفاظ الآمن بالوسائط، وقم بمسح ذاكرة التخزين المؤقت عن بعد دون حذف الملفات مباشرة من القرص.
راجع نشاط الجهاز، وقم بتعطيل حسابات Synapse غير النشطة المؤكدة من خلال واجهة برمجة تطبيقات المسؤول، وتعرف على ما الذي تزيله علامة المسح الاختيارية فعليًا.
حدد ما إذا كانت ذاكرة PostgreSQL تأتي من عمليات الاستعلام، أو المخازن المؤقتة المشتركة، أو الاتصالات، أو الصيانة، ثم قم بإجراء تغييرات مستهدفة آمنة لـ Synapse.
تتبع عمليات انضمام غرفة المصفوفة البطيئة إلى خادم منزلي بعيد واحد، أو تراجع الاتحاد، أو تحميل قاعدة البيانات المحلية، أو قائمة انتظار المرسل الصادر قبل تغيير إعدادات Synapse.
أوقف إنشاء الحسابات المفتوحة على خادم Synapse المستضاف ذاتيًا، أو اجعل عمليات التسجيل مقتصرة على الدعوات فقط باستخدام رموز تسجيل محدودة الاستخدام.