قم بإعداد اسم مستعار مخصص لغرفة المصفوفة على نطاقك الخاص
امنح غرفة Matrix عنوانًا سهل المشاركة على نطاقك باستخدام Element أو Matrix API، مع عمليات التحقق من الأذونات وتسمية Synapse والاتحاد.
بالنسبة لمكالمات المصفوفة التي تفشل عندما يكون المشاركون على شبكات مختلفة، قم بتثبيت coturn على مضيف ذي عنوان IP عام، وفعّل بيانات اعتماد TURN REST محدودة المدة، وقم بتهيئة Synapse باستخدام نفس السر المشترك وعناوين URI الخاصة بـ TURN. ثم اسمح لمستمع TURN ونطاق ترحيل UDP بالمرور عبر جميع جدران الحماية. يمكن أن يساعد STUN العملاء في اكتشاف مسارات الشبكة، لكن TURN هو المرحل الذي ينقل الوسائط عندما يتعذر إنشاء مسار مباشر.
هذا الإعداد مناسب لخادم Synapse منزلي مُستضاف ذاتيًا ومضيف TURN منفصل يعمل بنظام Debian أو Ubuntu مع عنوان IPv4 عام ثابت. يستخدم المثال مستمع coturn الافتراضي على المنفذ 3478 ونطاق ترحيل UDP الافتراضي من 49152 إلى 65535. استبدل اسم النطاق والكلمة السرية والمسارات المذكورة في المثال ببياناتك الخاصة. إذا كان coturn خلف جدار حماية NAT، فراجع ملاحظة NAT أدناه؛ يُعدّ استخدام مضيف عام يمكن الوصول إليه مباشرةً أبسط وأكثر موثوقية.
أنشئ سجل DNS من النوع A turn.example.comيشير إلى عنوان IPv4 العام لجهاز coturn. استخدم اسم مضيف مخصصًا بحيث يمكن إدارة إعدادات الشبكة والشهادة بشكل مستقل عن خدمة الويب Matrix. لا تنشر سجل AAAA إلا إذا كان لدى coturn اتصال IPv6 فعال وقواعد جدار الحماية المناسبة؛ فقد يتسبب عنوان IPv6 غير قابل للوصول في اختيار بعض العملاء مسارًا غير صالح.
تشير وثائق TURN الحالية من Synapse إلى أن خدمة TURN تتطلب نقطة نهاية IP عامة. لا يمكن لتقنية NAT العمل إلا إذا كان للبوابة عنوان IP عام وتُعيد توجيه المنافذ المطلوبة بشكل صحيح، وتحذر الوثائق من أن إعدادات NAT قد تكون غير موثوقة. راجع وثائق إعداد Synapse TURN .
على نظامي ديبيان أو أوبونتو، قم بتثبيت حزمة التوزيع:
sudo apt update
sudo apt install coturn
افتح الملف /etc/turnserver.confباستخدام محرر نصوص، ثم اضبط الإعدادات الأساسية الموضحة أدناه. أنشئ كلمة مرور عشوائية طويلة باستخدام مدير كلمات مرور أو مولد كلمات مرور آمن تشفيرياً. ضع هذه الكلمة السرية نفسها في Synapse لاحقاً؛ لا تستخدم كلمة مرور مستخدم Matrix مرة أخرى، ولا تنشرها في أي مستودع عام.
listening-port=3478
fingerprint
use-auth-secret
static-auth-secret=REPLACE_WITH_A_LONG_RANDOM_SECRET
realm=turn.example.com
server-name=turn.example.com
min-port=49152
max-port=65535
use-auth-secretقم static-auth-secretبتمكين آلية بيانات اعتماد TURN REST التي يستخدمها Synapse لإصدار بيانات اعتماد مؤقتة. realmيجب أن يكون اسم نطاق لخدمة TURN الخاصة بك. نطاق منفذ الترحيل منفصل عن المستمع: يتصل العملاء بالمنفذ 3478 لطلب تخصيص، ثم تستخدم الوسائط منافذ الترحيل المخصصة. توضح وثائق تكوين coturn المثال خيارات المستمع والترحيل وTLS وعنوان IP الخارجي؛ قد تختلف الإعدادات الافتراضية لحزمة التوزيع والمسارات.
قم بتمكين الخدمة وتشغيلها، ثم تحقق من حالتها:
sudo systemctl enable --now coturn
sudo systemctl status coturn
إذا كانت حزمتك تحتوي على علامة تفعيل منفصلة في ملف .org /etc/default/coturn، فاتبع تعليمات ذلك الملف قبل بدء تشغيل الخدمة. تحقق من السجلات باستخدام الأمر .org sudo journalctl -u coturn -eإذا لم تبدأ الخدمة.
اسمح بوصول بروتوكولي UDP وTCP الواردين على المنفذ 3478، بالإضافة إلى منافذ UDP الواردة من 49152 إلى 65535، في جدار الحماية الخاص بالمضيف وأي جدار حماية على مستوى مزود الخدمة. على سبيل المثال، مع UFW:
sudo ufw allow 3478/udp
sudo ufw allow 3478/tcp
sudo ufw allow 49152:65535/udp
sudo ufw status
اجعل نطاق الترحيل ضيقًا قدر الإمكان ضمن إمكانيات النشر لديك، واجعل نطاق TURN min-portمطابقًا max-portلنطاق جدار الحماية. إذا قمتَ بتمكين مستمع TLS، فافتح منفذه المُهيأ أيضًا، واستخدم عنوان turns:URI وإعدادات الشهادة المطابقة. يُعدّ استخدام TLS على اتصال TURN اختياريًا في هذا المثال الأساسي؛ إذ تشير تعليمات Synapse إلى أن وسائط الصوت والفيديو WebRTC تظل مُشفّرة حتى عندما يستخدم TURN مستمع UDP/TCP العادي، بينما يعتمد أمان الإشارة على إعداد Matrix HTTPS لديك.
بالنسبة للمضيف الموجود خلف جدار حماية NAT، قم بتكوين external-ip=PUBLIC_IP/PRIVATE_IPتعيين coturn وإعادة توجيه كل من المنفذ 3478 ونطاق الترحيل بالكامل إلى مضيف coturn دون تغيير أرقام منافذ الترحيل الخارجية. على سبيل المثال، يجب أن يصل منفذ الترحيل العام 52000 إلى المنفذ الداخلي 52000. تشير إرشادات Synapse إلى أن NAT قد يسبب مشاكل؛ إذا لم تتمكن من إعادة توجيه نطاق UDP واسع، فإن وضع coturn على خادم افتراضي خاص (VPS) ذي عنوان IP عام يُعد عادةً خيارًا أكثر عملية.
أضف الإعدادات التالية إلى ملف تكوين Synapse النشط، والذي يكون عادةً ملف homeserver.yamlالتكوين الرئيسي. طابق اسم المضيف والمنفذ والكلمة السرية مع تكوين coturn:
turn_uris:
- "turn:turn.example.com:3478?transport=udp"
- "turn:turn.example.com:3478?transport=tcp"
turn_shared_secret: "REPLACE_WITH_A_LONG_RANDOM_SECRET"
turn_user_lifetime: 86400000
turn_allow_guests: false
مدة الصلاحية بالمللي ثانية؛ يطلب هذا المثال من Synapse إصدار بيانات اعتماد صالحة لمدة 24 ساعة. اضبط وصول الضيوف وفقًا لسياسة التسجيل الخاصة بك؛ ليس من الضروري تمكين المكالمات للمستخدمين المسجلين فقط. حافظ على turn_shared_secretخصوصية بيانات اعتماد TURN ومطابقتها لبيانات اعتماد coturn static-auth-secret. لا تُضف stun:عنوان URI كبديل لبروتوكول TURN: فالبروتوكولان يؤديان أدوارًا متشابهة ولكنها مختلفة.
أعد تشغيل برنامج Synapse بعد التحقق من صحة صيغة YAML:
sudo systemctl restart matrix-synapse.service
sudo systemctl status matrix-synapse.service
يجب على عمليات نشر الحاويات تحديث إعدادات Synapse المُثبّتة وإعادة تشغيل حاوية Synapse. قد يحتاج العملاء إلى إعادة تحميل أو تحديث إعدادات الخادم الخاصة بهم؛ وتشير Synapse إلى أن العملاء قد يستغرقون ما يصل إلى ساعة لتحديث إعدادات TURN.
اختبر الاتصال من متصفح أو جهاز على شبكة مختلفة عن خادم TURN، مثل هاتف يستخدم بيانات الجوال. في عميل Matrix المستند إلى المتصفح، افحص طلب الخادم الرئيسي المُصادق عليه /_matrix/client/v3/voip/turnServer(قد تستخدم الأجهزة القديمة /r0/المسار القديم). يجب أن تتضمن الاستجابة عناوين TURN URI وحقول اسم المستخدم/كلمة المرور المؤقتة؛ يحدد معيار Matrix استجابة بيانات الاعتماد لهذه النقطة النهائية.
استخدم بيانات الاعتماد هذه في اختبار WebRTC Trickle ICE الرسمي ، وأدخل خادمًا مثل turn:turn.example.com:3478?transport=udp، وحدد اختبار الترحيل إذا كانت الصفحة توفر تصفية أنواع المرشحين. تتضمن النتيجة الناجحة مرشحًا من نوعه relay. أخيرًا، قم بإجراء مكالمة Matrix بين أجهزة على شبكات منفصلة. غالبًا ما تشير المكالمة التي ترن ولكنها تبقى في حالة "جارٍ الاتصال" إلى منافذ ترحيل محظورة، أو تعيين NAT خاطئ، أو بيانات اعتماد غير متطابقة؛ تحقق من سجلات coturn وملاحظات استكشاف أخطاء TURN وإصلاحها في Synapse قبل تغيير إعدادات المكالمات غير ذات الصلة.
لتشخيص المتصفح، توصي Synapse chrome://webrtc-internals/باستخدام Chrome و about:webrtcFirefox. إذا لم يظهر مرشح الترحيل، فتأكد أولاً من تطابق كلمة المرور تمامًا، ثم تحقق من منفذ UDP 3478 ونطاق الترحيل الكامل في جداري حماية كل من المضيف ومزود الخدمة. يوثق مشروع coturn خيارات المنفذ وعنوان IP الخارجي في مرجع turnserver الخاص به .
امنح غرفة Matrix عنوانًا سهل المشاركة على نطاقك باستخدام Element أو Matrix API، مع عمليات التحقق من الأذونات وتسمية Synapse والاتحاد.
قم بتكوين coturn و Synapse باستخدام بيانات اعتماد TURN المطابقة، وافتح منافذ الترحيل المطلوبة، وتحقق من أن عملاء Matrix يمكنهم الحصول على مرشحي الترحيل.
قم بإعداد خادم Synapse منزلي دائم باستخدام Docker Compose و PostgreSQL وتكوين خاص وفحوصات قبل عرضه عبر HTTPS.
قم بتعيين اسم ذي علامة تجارية وألوان مخصصة وأصول تسجيل دخول لنشر Element Web الخاص بك مع فهم الأجزاء التي ستظل تحمل علامة Element التجارية.
قم بتشخيص ما إذا كان برنامج Synapse قد وصل إلى الحد الأقصى للملفات المفتوحة لكل عملية، وقم بتعيين ملف systemd drop-in للخدمة أو العامل المناسب، وتحقق من الحد الأقصى للتشغيل.
اكتشف ما إذا كان الخطأ يقتصر على متصفح واحد أو حدث واحد، ثم استخدم مفتاح استرداد Element أو جهازًا موثوقًا به دون المخاطرة بسجل التصفح المشفر المتبقي.
استخدم واجهات برمجة تطبيقات Synapse الخاصة بحذف السجلات والوسائط أو إعدادات الاحتفاظ لإزالة البيانات القديمة بأمان، ثم تحقق من اكتمال العملية واستعادة مساحة القرص.
قم بتثبيت المكتبة الحالية، وقم بتوصيل حساب Matrix مخصص، وقم بتشغيل روبوت !echo صغير مع معالجة بيانات اعتماد أكثر أمانًا واختبار واضح.
قم بإعداد ثلاثة جسور mautrix مع تسجيلات وتسجيلات دخول واختبارات منفصلة - وتجنب مفاجآت شبكات Docker وسياسة الحساب والمزامنة.
ابحث عن الأشياء التي تملأ مساحة تخزين Synapse، وقم بتعيين الاحتفاظ الآمن بالوسائط، وقم بمسح ذاكرة التخزين المؤقت عن بعد دون حذف الملفات مباشرة من القرص.