الرئيسية
» مسؤول الشبكة
»
كيفية إعداد الجسور في ماتريكس: واتساب، تيليجرام، وديسكورد
كيفية إعداد الجسور في ماتريكس: واتساب، تيليجرام، وديسكورد
لربط Matrix مع WhatsApp أو Telegram أو Discord، شغّل خدمة ربط متوافقة بجانب خادمك الرئيسي، وسجّل هذه الخدمة كخدمة تطبيق Matrix، ثم اربط الحساب الخارجي أو فعّله. كل شبكة تحتاج إلى إعدادات وبيانات اعتماد خاصة بها. لا يكفي تشغيل عملية ما للتأكد من ربط الغرفة: اختبر إرسال رسالة في كلا الاتجاهين بعد الإعداد.
يمكن لخادم Matrix المنزلي الواحد الاتصال بثلاث خدمات جسرية مُهيأة بشكل منفصل.
هل ينبغي عليك استضافة الجسور بنفسك أم استخدام نسخة عامة؟
تتيح لك الاستضافة الذاتية التحكم في مكان تشغيل الجسر، وكيفية تخزين السجلات وبيانات الاعتماد، والمستخدمين المسموح لهم بالاتصال. كما تعني أيضًا أنك ستتولى صيانة ثلاث خدمات، وتحديثها، وحماية قواعد بياناتها، واستكشاف أخطاء الاتصال وإصلاحها. قد يكون الجسر العام أسرع في التجربة، لكن مُشغّله يتحكم في التوافر وسياسة الوصول ومعالجة البيانات. لذا، يُنصح بمراجعة وثائق الجسر الحالية وقسم الدعم قبل اختيار أي نسخة؛ إذ قد تتغير الميزات والتوافر.
لا تُعادل هذه الاتصالات الدعم الأصلي من خدمات المراسلة. قد تختلف الميزات المُدمجة من شبكة لأخرى، وقد تكون المكالمات الصوتية/المرئية، والتفاعلات، والتعديلات، والمحادثات، وإشعارات القراءة، وسجل المحادثات، وإدارة المجموعات غير مكتملة. اختبر الميزات التي يعتمد عليها مجتمعك فعليًا قبل نقل المحادثات المهمة.
ما الذي تحتاجه قبل تثبيت أي شيء؟
خادم منزلي من نوع Matrix يدعم خدمات التطبيقات وصلاحيات المسؤول لتسجيلها. تستخدم الأمثلة أدناه برنامج Synapse؛ أما الخوادم المنزلية الأخرى فلها عملية تسجيل خاصة بها.
مسار شبكي متاح بين الخادم الرئيسي وكل جسر. في Docker، localhostيُقصد بـ "داخل حاوية واحدة" تلك الحاوية نفسها؛ استخدم شبكة Docker مشتركة واسم شبكة خدمة الجسر عندما يحتاج الخادم الرئيسي إلى الوصول إلى حاوية أخرى.
يلزم وجود ملف تكوين وتسجيل وموقع بيانات دائم ومخزن بيانات سرية منفصل لكل جسر. اتبع تعليمات المشروع الحالية لقواعد البيانات المدعومة وإصدارات وقت التشغيل وصور الحاويات؛ تختلف المتطلبات وتتغير.
بالنسبة لتطبيق واتساب، يلزم وجود هاتف عليه الحساب الذي ترغب بربطه. أما بالنسبة لتطبيق تيليجرام، فيلزم وجود حساب مسجل دخوله مسبقاً عبر تطبيق تيليجرام الرسمي. وبالنسبة لتطبيق ديسكورد، يلزم وجود تطبيق/بوت ديسكورد وإذن من مالك الخادم أو مديره.
يقرأ برنامج Synapse كل ملف تسجيل جسر من المسار المُكوّن ضمن app_service_config_files؛ المسارات المعروضة هي أمثلة.
كيف يتم تسجيل جسر مع Synapse؟
قم بتثبيت جسر واحد في كل مرة. ابدأ بإصدار حالي وإعداداته النموذجية. حدد عنوان الخادم الرئيسي، واسم الخادم العام، وعنوان مستمع الجسر، وقاعدة البيانات، ومسارات التخزين وفقًا لدليل المشروع. تجنب مشاركة قاعدة بيانات واحدة بين خدمات جسر غير مرتبطة.
أنشئ ملف التسجيل الخاص به. تُنشئ عملية إعداد الجسر ملف YAML للتسجيل يحتوي على رموز هوية التطبيق والخدمة ورموز المصادقة. تعامل مع هذه الرموز كما لو كانت كلمات مرور: قيّد صلاحيات الوصول إلى الملف، ولا تُضِفها إلى Git، ولا تلصقها في غرف الدردشة العامة أو لقطات الشاشة أو منشورات الدعم.
اجعل الملف مرئيًا لبرنامج Synapse. انسخ ملف التسجيل أو قم بتثبيته في مكان يمكن لبرنامج Synapse قراءته. أضف مساره أسفل ملف التسجيل app_service_config_filesفي Synapse homeserver.yaml. أضف مدخلًا منفصلًا لكل جسر؛ لا تستبدل مدخل خدمة أخرى. يشرح دليل تسجيل خدمة تطبيق mautrix هذه العملية، ويشير إلى ضرورة إعادة تشغيل Synapse بعد تغيير قائمة التسجيل.
أعد تشغيل البرنامج وافحص سجلات النظام. أعد تشغيل Synapse بعد أي تغيير في التسجيل، ثم شغّل الجسر. إذا فشل Synapse في التشغيل، فتحقق أولاً من مسافة YAML البادئة، ومسار الملف داخل الحاوية، وأذونات القراءة. إذا بدأ الجسر ولكنه لم يتمكن من الاتصال، فتحقق من عنوان URL للخادم الرئيسي، ومسار الشبكة، وشهادة TLS، وعنوان المستمع.
بالنسبة لعمليات نشر Docker، يجب أن يكون عنوان خدمة التطبيق المُكوّن للجسر قابلاً للوصول من حاوية الخادم الرئيسي. توضح ملاحظات التكوين الأولي لـ mautrix سبب نجاح اسم حاوية على شبكة مشتركة في حين أنه قد localhostلا ينجح في حالات أخرى. كما يوثق مشروع Discord آلية التسجيل الخاصة به ونموذج التكوين في ملف README الخاص بالمشروع .
كيف يتم ربط حساب واتساب؟
بعد تسجيل تطبيق Matrix-WhatsApp وتشغيله، افتح محادثة Matrix خاصة مع بوت الجسر وأرسل رسالة login qr. افتح تطبيق WhatsApp على الهاتف الذي يملك الحساب، وانتقل إلى الأجهزة المرتبطة ، وامسح الرمز الذي يعرضه الجسر. تشرح وثائق الجسر أيضًا خيار رمز الاقتران برقم الهاتف؛ استخدم الطريقة المدعومة حاليًا في إصدارك المُثبّت. لا تنسخ رمز تسجيل الدخول أو صورة رمز الاستجابة السريعة (QR) إلى غرفة عامة.
تطلب منك عملية مصادقة جسر واتساب ربط الجسر كجهاز من حساب واتساب الموجود على هاتفك.
أبقِ الهاتف والحساب متاحين أثناء عملية الاقتران، وتأكد من أن الجسر يُبلغ عن تسجيل دخول ناجح قبل فتح غرف البوابة. هذا يربط الحساب عبر جلسة جهاز مُصاحب؛ ولا يُحوّل الجسر إلى تكامل رسمي مع واجهة برمجة تطبيقات واتساب للأعمال. قد يُغيّر واتساب سلوك ربط الأجهزة، لذا اتبع تعليمات المصادقة الحالية لـ mautrix-whatsapp . يُمكن للجسر مزامنة سجل المحادثات فقط الذي تُوفّره الخدمة الخارجية للجهاز المرتبط والذي يُنفّذه الجسر.
كيف يمكنني الاتصال بتطبيق تيليجرام؟
ابدأ محادثة خاصة مع بوت mautrix-telegram. يدعم هذا البوت تسجيل الدخول عبر رمز الاستجابة السريعة (QR) ورمز دخول مكون من ستة أرقام يُرسل إلى تطبيق Telegram مُسجّل الدخول إليه مُسبقًا؛ ولا يُنشئ حساب Telegram جديدًا. لتسجيل الدخول عبر رمز الاستجابة السريعة، افتح تطبيق Telegram على هاتفك، وانتقل إلى الإعدادات > الأجهزة > ربط جهاز سطح المكتب ، ثم أرسل login qrالرمز إلى بوت البوت وامسحه ضوئيًا. اتبع تعليمات البوت إذا كان حسابك على Telegram مُفعّلًا فيه التحقق بخطوتين.
تُستخدم شاشة ربط الأجهزة المكتبية في تطبيق Telegram لتفويض جلسة الربط؛ ويمكن أن تختلف تسميات القوائم حسب إصدار التطبيق.
استخدم حسابًا موجودًا مسبقًا والتزم بقواعد تسجيل الدخول الخاصة بتليجرام. يحذر القائمون على صيانة الجسر من أن تليجرام قد يتعامل مع الحسابات الجديدة التي تستخدم تطبيقات خارجية على أنها مشبوهة؛ وهذا خطر من جانب المنصة، ولا يمكن لمسؤول ماتريكس ضمان تجنبه. راجع دليل مصادقة mautrix-telegram قبل تسجيل الدخول، واحتفظ بأي رمز أو كلمة مرور لمرة واحدة داخل دردشة البوت الخاصة.
كيف يتم ضبط إعدادات ديسكورد؟
يستخدم مشروع matrix-appservice-discord تطبيق Discord وبوتًا. أنشئ التطبيق في بوابة مطوري Discord ، ثم أنشئ مستخدم البوت وقم بتهيئته، وحدد بيانات اعتماد البوت في إعدادات الجسر باستخدام المثال الحالي للمشروع. لا تكشف رمز البوت. شغّل أمر أو مسار authorization-link الموثق للجسر، ثم اطلب من مالك خادم Discord تفويض البوت للخادم المقصود بالصلاحيات التي يتطلبها الجسر فقط.
يبدأ إعداد Discord بتطبيق وبوت؛ وتتبع الحقول الدقيقة وخيارات التفويض بوابة Discord الحالية ونموذج تكوين الجسر.
للحصول على معرفات الخادم والقناة لقناة معينة، استخدم أدوات المطورين المدعومة من Discord، ثم ادعُ بوت الجسر الخاص بـ Matrix إلى غرفة Matrix، واستخدم أمر الغرفة الموثق الخاص بالجسر. يُقدّم ملف README الخاص بالمشروع مثالًا على ذلك !discord bridge ServerID ChannelID؛ وقد يتطلب الأمر موافقة المسؤول لإتمام الربط. لا تستخدم المعرفات من الرسم التوضيحي، بل استبدلها بالمعرفات الفعلية، وتأكد من الأمر والأذونات بالرجوع إلى ملف README الخاص بإصدارك المُثبّت.
يربط أمر غرفة ديسكورد غرفة ماتريكس بخادم ديسكورد وقناة؛ استبدل المعرفات الحقيقية واتبع أي مطالبة بالموافقة.
يعتمد ديسكورد بشكل خاص على صلاحيات البوت وسياسة الخادم. إذا تمكن البوت من الانضمام ولكن الرسائل لا تصل، فتأكد من أن القناة مرئية له، وأن صلاحيات الرسائل المطلوبة مُنحت، وأن الجسر قد أكمل أي تأكيد إداري. يُصنّف المشروع نفسه على أنه في مرحلة تجريبية (بيتا) في ملف README الخاص به، لذا تأكد من حالة المشروع الحالية والسلوك المدعوم بدلاً من افتراض أن جميع ميزات ديسكورد مُطبقة.
كيف يمكنك التأكد من أن الجسر يعمل؟
استخدم غرفة اختبار خاصة صغيرة وقناة منخفضة المخاطر أولًا. أرسل رسالة نصية عادية فريدة من Matrix وتأكد من ظهورها على الخدمة البعيدة؛ ثم أجب من الجانب البعيد وتأكد من ظهور الرد في Matrix. تحقق من الإسناد، وسلسلة الردود، والمرفقات، والتعديلات، والتفاعلات بشكل منفصل إذا كانت مهمة لحالة استخدامك. يشير ظهور حالة العملية باللون الأخضر فقط إلى أن البرنامج قيد التشغيل: فهو لا يثبت نجاح تسجيل الدخول، أو أن البوت لديه حق الوصول إلى القناة، أو أن ربط الغرفة بالقناة صحيح.
تتمثل إحدى طرق التحقق المفيدة من البداية إلى النهاية في إرسال رسالة اختبار في كل اتجاه والتحقق من ظهور نظيرتها في الغرفة المرتبطة.
عند فشل الاختبار، قارن وقت الرسالة بدقة مع سجلات الجسر والخادم الرئيسي. احجب رموز الوصول وأرقام الهواتف ومعرّفات Discord (إن وُجدت) وأسماء جهات الاتصال قبل مشاركة السجلات. بالنسبة لعمليات نشر الحاويات، تأكد أيضًا من تثبيت ملف التسجيل داخل Synapse، وأن نقطة نهاية الجسر تعمل على الشبكة المشتركة، وأنه لا يوجد جدار حماية يحظر المستمع المُكوّن.
استخدم سجلات الجسر والخادم المنزلي للتحقق من سلامة العملية والاتصال؛ أسطر الحالة هذه ليست نتيجة تشخيصية تم التقاطها.
ما الذي يجب أن تعرفه عن التشفير والخصوصية؟
تستقبل خدمات التطبيقات الأحداث في مساحات الأسماء والغرف المُهيأة للتعامل معها. لا تفترض أن غرفة Matrix المُشفّرة قابلة للقراءة تلقائيًا بواسطة كل جسر. تدعم بعض جسور Matrix التشفير من طرف إلى طرف، والذي يتطلب تهيئة مُحددة ومتطلبات خاصة لإدارة المفاتيح؛ راجع دليل التشفير من طرف إلى طرف في Matrix وتحقق من دعم الجسر المُحدد. قد تختلف إمكانيات تشفير جسور Discord. إذا لم يتمكن جسر من التعامل مع وضع تشفير الغرفة، فاستخدم غرفة اختبار غير مُشفّرة مناسبة أو اختر جسرًا بدعم موثق بدلاً من إضعاف غرفة الإنتاج بالتخمين.
أخيرًا، تذكر أن محتوى الرسائل وبيانات اعتماد الحساب تمر عبر البرامج التي تستخدمها أو التي يستخدمها مشغل الجسر العام. لذا، حدد من يمكنه دعوة روبوتات الجسر، واحمِ قواعد البيانات والنسخ الاحتياطية، وقم بتغيير الرمز المميز في حال تسريبه، وراجع إرشادات الخصوصية والأمان الحالية للجسر. أعد فحص الوثائق الأصلية قبل التحديثات: فقد تتغير مفاتيح التكوين، وخطوات تسجيل الدخول، والتبعيات، وسياسات النظام الأساسي بشكل مستقل.
قائمة التحقق من اتخاذ القرار السريع
اختر مثيل جسر تثق في مشغله وسياسة الوصول الخاصة به.
قم بتسجيل كل جسر على حدة وحماية كل رمز تم إنشاؤه.
تحقق من قدرة الخادم المنزلي على الوصول إلى عنوان الجسر بعد النشر.
قم بربط حسابات واتساب/تيليجرام بشكل خاص وقم بتفويض بوت ديسكورد مع مسؤول الخادم.
اختبر الرسائل في كلا الاتجاهين، ثم اختبر فقط الميزات الإضافية التي تحتاجها.
تأكد من دعم التشفير، وسلوك السجل، وحالة الصيانة قبل الاعتماد على الجسر للاتصالات الحساسة أو الأساسية.