اربط تطبيق ماتريكس بتطبيقات واتساب وتليجرام وديسكورد باستخدام جسور منفصلة

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

هذا مخصص لمسؤول خادم منزلي يسمح بخدمات التطبيقات. لا يمكنك إضافة جسر مُستضاف ذاتيًا إلى matrix.org إلا إذا كان مُديروه يُوفرونه؛ استخدم خادمًا تتحكم به أو جسرًا مُستضافًا مُتاحًا. تمت مراجعة وثائق المشروع في 10 أكتوبر 2026.

1. حدد ما الذي تقوم بتوصيله وقم بإعداد الخادم

هذه ثلاث خدمات منفصلة، ​​لكل منها إعداداتها وتسجيلها وقاعدة بياناتها وتسجيل دخولها الخاص. يعتمد Mautrix بشكل أساسي على تقنية "الدمى": تنتقل الرسائل عبر حسابك البعيد المرتبط وتظهر في Matrix باسم ذلك الحساب. أما روبوت الترحيل فهو مختلف؛ اختره فقط إذا كنت ترغب في هوية روبوت مشتركة بدلاً من حسابك الشخصي.

تحتاج إلى خادم منزلي يدعم خدمة التطبيقات، وصلاحيات إدارية، واتصال شبكي لكل جسر. يتوفر توثيق لـ Docker. خصص لكل جسر دليل بيانات خاص به، واختر علامة إصدار مُحدّثة؛ تشير ملاحظات mautrix إلى أن هذه العلامة latestقد تُشير إلى آخر تحديث بدلاً من إصدار رسمي.

استخدم قاعدة بيانات منفصلة لكل جسر؛ يمكن مشاركة خادم PostgreSQL، ولكن يجب عدم مشاركة قاعدة البيانات نفسها مع جسر آخر أو Synapse. يُعد SQLite خيارًا مناسبًا للحالات الصغيرة. حدد خيار تشفير البيانات من طرف إلى طرف قبل تسجيل الدخول، لأن تفعيله لاحقًا لغرف البوابة الحالية أمرٌ صعب.

قائمة دليل الطرفية مع مجلدات منفصلة لـ mautrix-whatsapp و mautrix-telegram و mautrix-discord، يعرض كل منها ملف التكوين وقاعدة البيانات الخاصة به.
احتفظ بتكوين كل جسر وقاعدة بياناته في دليل العمل الخاص به قبل بدء تشغيل الحاويات.

2. قم بتهيئة وتسجيل جميع خدمات التطبيق الثلاثة

  1. أنشئ التكوين الأولي لكل جسر. اتبع صفحة إعداد Docker الخاصة بهذا الجسر، وشغّل حاويته مرة واحدة مع ربط دليل البيانات الخاص به. عدّل التكوين المُنشأ قبل تشغيله بشكل طبيعي. املأ اسم نطاق الخادم الرئيسي وعنوانه، وعنوان الجسر، ومعرّف الموارد الموحد لقاعدة البيانات، والأذونات. هذه القيم خاصة بنشرك؛ لا تلصق بيانات الأمان النموذجية في بيئة الإنتاج.
  2. استخدم عناوين يمكن الوصول إليها من الحاويات. عندما تشترك Synapse والجسور في شبكة Docker، يمكن لعنوان الخادم الرئيسي للجسر استخدام اسم خدمة Synapse، مثل `<اسم الخدمة> http://synapse:8008`. يجب أن يشير عنوان خدمة التطبيق إلى اسم خدمة الجسر ومنفذ الاستماع الخاص به. localhostيشير عنوان `<اسم الخدمة>` داخل حاوية الجسر إلى نفس الحاوية، وليس إلى Synapse أو جسر آخر، لذا فإنه عادةً ما يقطع الاتصال. إذا كان الخادم الرئيسي خارج Docker، فانشر أو وجّه منفذ الجسر المطلوب بدلاً من ذلك.
  3. أنشئ ملف تسجيل واحد لكل جسر وقم بتثبيته. شغّل أمر الإعداد الخاص بكل جسر لإنشاء ملف YAML الخاص بالتسجيل، ثم ضع الملفات الثلاثة في مكان يمكن لبرنامج Synapse قراءتها. في ملف 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 مرة أخرى.

محرر الأكواد يعرض ملف Synapse homeserver.yaml مع ثلاثة مسارات تسجيل منفصلة لخدمات التطبيقات الخاصة بـ WhatsApp و Telegram و Discord.
يحتاج برنامج Synapse إلى مسار تسجيل منفصل وقابل للقراءة لكل جسر، متبوعًا بإعادة تشغيل الخادم الرئيسي.
لوحة حالة الحاويات التي تعرض Synapse وثلاث حاويات جسر mautrix تعمل على شبكة Matrix مشتركة.
تأكد من أن برنامج Synapse وجميع حاويات الجسر الثلاثة تعمل على شبكة يتم فيها حل أسماء خدماتها.

3. أضف بيانات الاعتماد الخاصة بالخدمة وسجّل الدخول

واتساب

شغّل تطبيق 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، وعنوان خدمة mautrix-whatsapp، واسم قاعدة بيانات جسر مميز.
راجع اسم مضيف الخدمة، ومستمع الجسر، وتفاصيل قاعدة البيانات الفريدة في التكوين الخاص بكل جسر.

4. اختبر التسليم، ثم عدّل فقط ما تُظهره النتيجة

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

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

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

استخدم تعليمات Docker الحالية الخاصة بـ mautrix ، ودليل التسجيل ، ومرجع التكوين ، وصفحات المصادقة الخاصة بـ WhatsApp و Telegram و Discord للاطلاع على الأوامر الخاصة بكل إصدار. راجع سياسة Discord المتعلقة بالبوتات الذاتية .

اترك تعليقاً

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

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

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

هل تظهر رسالة "فشل فك التشفير"؟ استعد مفتاح الغرفة المفقود

هل تظهر رسالة "فشل فك التشفير"؟ استعد مفتاح الغرفة المفقود

اكتشف ما إذا كان الخطأ يقتصر على متصفح واحد أو حدث واحد، ثم استخدم مفتاح استرداد Element أو جهازًا موثوقًا به دون المخاطرة بسجل التصفح المشفر المتبقي.

تنظيف رسائل Synapse القديمة والوسائط دون فقدان البيانات

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

قم بإنشاء روبوت صدى المصفوفة باستخدام بايثون مع مكتبة Simple-Matrix-Bot-Lib

قم بإنشاء روبوت صدى المصفوفة باستخدام بايثون مع مكتبة Simple-Matrix-Bot-Lib

قم بتثبيت المكتبة الحالية، وقم بتوصيل حساب Matrix مخصص، وقم بتشغيل روبوت !echo صغير مع معالجة بيانات اعتماد أكثر أمانًا واختبار واضح.

اربط تطبيق ماتريكس بتطبيقات واتساب وتليجرام وديسكورد باستخدام جسور منفصلة

اربط تطبيق ماتريكس بتطبيقات واتساب وتليجرام وديسكورد باستخدام جسور منفصلة

قم بإعداد ثلاثة جسور mautrix مع تسجيلات وتسجيلات دخول واختبارات منفصلة - وتجنب مفاجآت شبكات Docker وسياسة الحساب والمزامنة.

استعادة مساحة قرص Synapse Media دون الإضرار بالملفات المشتركة

ابحث عن الأشياء التي تملأ مساحة تخزين Synapse، وقم بتعيين الاحتفاظ الآمن بالوسائط، وقم بمسح ذاكرة التخزين المؤقت عن بعد دون حذف الملفات مباشرة من القرص.

تعطيل حسابات مستخدمي المصفوفة غير النشطين دون حذف سجل الغرفة

تعطيل حسابات مستخدمي المصفوفة غير النشطين دون حذف سجل الغرفة

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

تقليل الضغط على ذاكرة PostgreSQL في Matrix Synapse

حدد ما إذا كانت ذاكرة PostgreSQL تأتي من عمليات الاستعلام، أو المخازن المؤقتة المشتركة، أو الاتصالات، أو الصيانة، ثم قم بإجراء تغييرات مستهدفة آمنة لـ Synapse.

لماذا تكون عمليات ربط غرف المشبك العصبي في المصفوفة بطيئة - وما الذي يجب فحصه

لماذا تكون عمليات ربط غرف المشبك العصبي في المصفوفة بطيئة - وما الذي يجب فحصه

تتبع عمليات انضمام غرفة المصفوفة البطيئة إلى خادم منزلي بعيد واحد، أو تراجع الاتحاد، أو تحميل قاعدة البيانات المحلية، أو قائمة انتظار المرسل الصادر قبل تغيير إعدادات Synapse.

إغلاق عمليات التسجيل في ماتريكس أو طلب رموز دعوة على سينابس

أوقف إنشاء الحسابات المفتوحة على خادم Synapse المستضاف ذاتيًا، أو اجعل عمليات التسجيل مقتصرة على الدعوات فقط باستخدام رموز تسجيل محدودة الاستخدام.