الرئيسية
» مسؤول الشبكة
»
حل مشكلة عدم تحميل كاميرا الويب BigBlueButton: فشل اتصال مقبس ICE
حل مشكلة عدم تحميل كاميرا الويب BigBlueButton: فشل اتصال مقبس ICE
عندما تبقى كاميرا الويب BigBlueButton فارغةً ويُظهر المتصفح أو الاجتماع رسالة "فشل اتصال ICE Socket"، فإن هذه الرسالة تُشير إلى فشل في اتصال الوسائط، لكنها لا تُحدد سببًا واحدًا مُحددًا. قد يكون لصلاحيات الكاميرا، وشبكة المستخدم، وجدار حماية الخادم، وعناوين NAT، وإعدادات ترحيل TURN دورٌ في ذلك. ابدأ بإجراء فحوصات لتحديد المشكلة قبل تغيير إعدادات الخادم.
يصف دليل استكشاف الأخطاء وإصلاحها الحالي لـ BigBlueButton خطأً ذا صلة، وهو 1007: فشل التفاوض على بروتوكول ICE ، بأنه فشل في التفاوض على مسار بين المتصفح وخادم الوسائط. ويذكر الدليل NAT، ومنافذ UDP المحظورة، واحتمالية الحاجة إلى تفعيل TURN على الشبكات المقيدة. قد تختلف العبارة الدقيقة في متصفحك باختلاف إصدار BigBlueButton أو منصة الاستضافة أو العميل. اعتبرها مجرد دليل، وليست تشخيصًا. اقرأ دليل استكشاف الأخطاء وإصلاحها لـ BigBlueButton 4.0 .
أولاً، حدد ما إذا كانت الكاميرا أو الاتصال معطلاً.
يتطلب الوصول إلى كاميرا الويب من المتصفح إذنًا للكاميرا، ويجب أن تستخدم صفحة الاجتماع سياقًا آمنًا مثل HTTPS. تحدد هذه الفحوصات ما إذا كان بإمكان المتصفح التقاط الفيديو المحلي. ICE هي عملية WebRTC التي تجد مسارًا شبكيًا لإرسال الوسائط بين المتصفح وBigBlueButton. يُعد رفض إذن الكاميرا وفشل مسار ICE مشكلتين مختلفتين، على الرغم من أن كلتيهما قد تجعل كاميرا الويب غير متاحة. توثق MDN متطلبات إذن المتصفح والسياق الآمن .
لوحة أذونات متصفح افتراضية مع تشغيل الكاميرا؛ الرموز توضيحية ولا تمثل متصفحًا محددًا أو شاشة BigBlueButton.
تحقق من أيقونة الكاميرا بجوار شريط العنوان وإعدادات الموقع في المتصفح. اسمح لموقع BigBlueButton بالوصول إلى الكاميرا، وتأكد من تحديد الكاميرا المطلوبة، وأغلق التطبيقات الأخرى التي قد تستخدمها. إذا عرض المتصفح معاينة محلية ولكن لا يزال الاجتماع غير قادر على نشر الفيديو، فمن المحتمل أن يكون الوصول إلى الجهاز المحلي يعمل؛ تابع فحص الشبكة. إذا لم تظهر أي معاينة، فقم أولاً بحل مشكلة تحديد الجهاز، أو إعدادات خصوصية نظام التشغيل، أو أذونات المتصفح.
جرّب عمليات التحقق هذه للمشاركين بالترتيب
أعد تحميل الصفحة وانضم مجددًا. اخرج من الاجتماع، ثم أعد تحميل الصفحة، ثم انضم مرة أخرى وحاول استخدام كاميرا الويب. قد يحل هذا مشكلة مؤقتة في المتصفح أو جلسة الوسائط، ولكن فشل بروتوكول ICE المتكرر عادةً ما يتطلب إصلاحًا من جانب الشبكة أو الخادم.
قم بتحديث المتصفح أو التبديل إلى متصفح مدعوم. جرّب إصدارًا حديثًا من متصفح سطح مكتب آخر مدعوم. إذا عملت كاميرا الويب هناك، فسجّل المتصفح الأصلي وإصداره لعرضه على مُضيف الاجتماع. قد تختلف طريقة عمل المتصفح، لذا فإن نجاح متصفح واحد لا يضمن إعداد الخادم بشكل صحيح لجميع المستخدمين.
قارن بشبكة أخرى. إذا كان ذلك مسموحًا، فانضم من نقطة اتصال هاتفية أو شبكة موثوقة أخرى. يُشير نجاح كاميرا الويب في الاتصال الثاني بقوة إلى أن شبكة Wi-Fi الأصلية أو VPN أو الخادم الوكيل أو جدار الحماية الخاص بالشركة يُقيّد حركة مرور الوسائط. لكن هذا لا يُثبت أي قاعدة مُحددة مسؤولة عن ذلك.
اختبر نفس الغرفة مع مشارك آخر. إذا لم يتمكن عدة أشخاص على شبكات مختلفة من نشر كاميرات الويب، فأبلغ مسؤول الاجتماع عن مشكلة محتملة في الخادم أو الاستضافة. إذا فشل شخص واحد فقط، فركز أولاً على جهاز ذلك المشارك ومتصفحه وشبكته.
جرّب غرفة أو عرضًا تجريبيًا آخر من BigBlueButton. إذا سمحت مؤسستك بذلك، فاستخدم غرفة منفصلة أو خدمة اختبار BigBlueButton الرسمية. إذا عملت الكاميرا هناك ولكنها لم تعمل على خادم مؤسستك، فأبلغ المسؤول بذلك.
تمثل نقطة اتصال الهاتف وقائمة شبكة Wi-Fi الخاصة بجهاز الكمبيوتر المحمول مقارنة سريعة بين شبكة مقيدة واتصال منفصل.
ما الذي يجب على المسؤولين التحقق منه
عند تأثر عدة مستخدمين، تحقق من مسار الوسائط عند كل حدود الشبكة: جدار حماية المضيف، ومجموعة أمان السحابة، وجهاز التوجيه أو جهاز NAT، وأي جدار حماية شبكة في اتجاه المنبع. تشير وثائق جدار حماية BigBlueButton إلى استخدام منفذي TCP 80 و443 لحركة مرور الويب، وفي التكوين الافتراضي الموثق، استخدام منافذ UDP من 16384 إلى 32768 للوسائط. قد يستخدم تثبيتك نطاقًا مخصصًا أو حزمة وسائط خاصة بالإصدار، لذا تأكد من التكوين الفعلي قبل تغيير القواعد. لا تفتح نطاقًا أوسع مما يتطلبه التثبيت. راجع دليل تكوين جدار حماية BigBlueButton الحالي .
يوضح مسار الشبكة المفاهيمي مرور وسائط الاجتماع عبر جدار الحماية إلى الخادم؛ تحقق من القواعد الفعلية ونطاق المنافذ المستخدمة في عملية التثبيت الخاصة بك.
بالنسبة للخوادم الموجودة خلف جدار الحماية NAT، تأكد من أن خدمة الوسائط تُعلن عن عنوان IP خارجي قابل للوصول. يستخدم BigBlueButton 2.5 والإصدارات الأحدث مكتبة mediasoup لوسائط HTML5 WebRTC؛ ويشرح دليل جدار الحماية الرسمي كيفية تكوين العنوان الخارجي المُعلن عنه /etc/bigbluebutton/bbb-webrtc-sfu/production.yml. قد يمنع عنوان IP خاص، أو عنوان IP عام قديم، أو إعادة توجيه منفذ غير صحيحة، أو عدم وجود إعدادات IPv6، العملاء من الوصول إلى خدمة الوسائط. طبّق فقط التعليمات التي تتوافق مع إصدار BigBlueButton الخاص بك وتصميم شبكتك، ثم أعد تشغيل الخدمات وفقًا لتوجيهات الدليل.
تحقق أيضًا مما إذا كان المستخدمون المتأثرون يستخدمون شبكات تحظر بروتوكول UDP الصادر. يمكن لخادم TURN إعادة توجيه حركة مرور WebRTC عندما يكون المسار المباشر غير متاح، ولكن يجب تثبيته وإمكانية الوصول إليه وتهيئته لإصدار BigBlueButton ذي الصلة. تختلف وثائق TURN والإعدادات الافتراضية للحزمة بين الإصدارات؛ اتبع الدليل الخاص بالإصدار الذي تستخدمه. لا تنسخ بيانات الاعتماد أو إعدادات المنفذ من إصدار آخر. راجع إرشادات خادم TURN الخاص بـ BigBlueButton 4.0 .
يوضح مسار WebRTC المفاهيمي نقاط النهاية التي تستخدم خادم ترحيل عندما يتعذر إنشاء اتصال مباشر.
الافتراضات الشائعة التي يجب تجنبها
"خطأ كاميرا الويب يعني أن الكاميرا معطلة."
ليس بالضرورة. إذا ظهرت المعاينة المحلية وكان المتصفح يملك الإذن، فقد يكون الجهاز يعمل بينما يتعطل مسار الوسائط. الإجراء: جرّب شبكة أخرى واسأل عما إذا كان المستخدمون الآخرون متأثرين قبل استبدال الكاميرا.
"إن السماح للكاميرا بإصلاح كل عطل في كاميرات الويب."
يُتيح هذا الإذن للمتصفح فقط التقاط الفيديو. ولا يفتح حركة مرور UDP المحظورة أو يُصحح عنوان NAT الخاص بالخادم. الإجراء: بعد تأكيد الإذن، اختبر الاتصال من شبكة أخرى.
"إن تحميل الاجتماع بشكل طبيعي يثبت أن شبكة الوسائط الخاصة به مفتوحة."
يمكن تحميل عناصر التحكم في الصفحة والاجتماع عبر بروتوكول HTTPS، بينما لا يمكن للصوت أو الفيديو المباشر إنشاء مسار وسائط منفصل. توثق BigBlueButton حالات فشل ICE إلى جانب حظر UDP وNAT كأسباب محتملة. الإجراء: استخدم اختبار كاميرا الويب وقارن النتائج عبر الشبكات.
"ينبغي أن يستخدم كل خادم نفس المنافذ وإعدادات TURN."
تُعدّ الإعدادات الافتراضية الموثقة نقاط انطلاق مفيدة، وليست دليلاً على التكوين الفعلي. يمكن تخصيص المنافذ، ويختلف إعداد TURN باختلاف الإصدار. الإجراء: راجع الإصدار والتكوين المُثبّت قبل تعديل قواعد جدار الحماية أو قواعد الترحيل.
كيفية تأكيد الإصلاح
بعد حدوث تغيير، انضم إلى اجتماع جديد وانشر كاميرا الويب لمدة دقيقة على الأقل. تأكد من ظهور معاينة البث المحلية، وأن المشاركين الآخرين يمكنهم رؤية البث، وأن إعادة الاتصال لا تؤدي إلى ظهور خطأ ICE. اطلب من مستخدم على الشبكة المتأثرة سابقًا إعادة الاختبار نفسه. إذا نجح اختبار نقطة الاتصال فقط، فأبلغ مسؤول الشبكة بهذه النتيجة واطلب مراجعة حركة مرور WebRTC الصادرة. إذا فشلت جميع الشبكات لعدة مستخدمين، فأرسل إلى مضيف BigBlueButton إصدار الخادم، والوقت التقريبي، والمتصفحات المتأثرة، ورمز الخطأ أو رسالته بالتفصيل، وما إذا كان الصوت يعمل، ونتائج كل اختبار شبكة. تجنب نشر روابط الاجتماعات أو رموز الوصول أو سجلات المتصفح غير المنقحة علنًا.
يُساعد التشخيص الدقيق في تحديد الطبقة المُعطّلة: الوصول المحلي للكاميرا، أو شبكة أحد المستخدمين، أو مسار الوسائط الخاص بالخادم. لا يُمكن للرسالة وحدها التمييز بين هذه الحالات، ولكن هذه الفحوصات تُزوّد مسؤول النظام بالأدلة اللازمة للتغيير التالي.