📹 تثبيت MiroTalk — مكالمات فيديو WebRTC ذاتية الاستضافة
انشر MiroTalk P2P على Ubuntu — سيرفر مؤتمرات فيديو WebRTC خفيف يعمل من المتصفح لمكالمات فيديو آمنة وذاتية الاستضافة مع مشاركة الشاشة والدردشة، بدون أي حسابات.
📦 الملفات والأكواد المطلوبة
قبل البدء، يرجى التأكد من تحميل الأكواد المطلوبة من مستودعنا على GitHub لتتمكن من تطبيق الخطوات مع الفيديو بسهولة.
التثبيت السريع:
wget https://raw.githubusercontent.com/mhmdali94/Docker/main/communication/mirotalk/mirotalk-ubuntu.sh
chmod +x mirotalk-ubuntu.sh
sudo bash mirotalk-ubuntu.sh
خطوات التنفيذ
1 تحميل السكريبت
wget https://raw.githubusercontent.com/mhmdali94/Docker/main/communication/mirotalk/mirotalk-ubuntu.sh
2 منح صلاحية التنفيذ
chmod +x mirotalk-ubuntu.sh
3 تشغيل المثبّت
يثبّت السكريبت Docker إن لزم الأمر، يسحب صورة mirotalk/p2p، ويُشغّلها على المنفذ 3025 (معيّن من المنفذ الداخلي 3000 للحاوية) مع استماع السيرفر على جميع الواجهات.
sudo bash mirotalk-ubuntu.sh
4 فتح غرفة فيديو
افتح متصفحك وانتقل إلى MiroTalk، ثم أنشئ غرفة أو انضم إليها وشارك الرابط مع المشاركين:
http://<your-server-ip>:3025
المنافذ المستخدمة
| المنفذ | الغرض |
|---|---|
| 3025 | Web UI + Signaling WebSocket (host → container 3000) |
نظرة عامة
MiroTalk P2P منصة مؤتمرات فيديو WebRTC مجانية ومفتوحة المصدر حيث يتصل متصفح كل مشارك مباشرة بمتصفح كل مشارك آخر — تنتقل بيانات الصوت والفيديو ومشاركة الشاشة بشكل نظير-إلى-نظير بدلاً من المرور عبر سيرفر وسائط مركزي. مبني بلغة Node.js ومُرخّص بموجب AGPLv3، لا يتطلب أي حسابات ولا إضافات ولا تنزيل تطبيقات؛ يستطيع أي شخص بمتصفح حديث ورابط الغرفة الانضمام فوراً.
لماذا تستخدمه
MiroTalk P2P مثالي عندما تريد أدنى عائق ممكن أمام مكالمة فيديو — بلا شاشات تسجيل، بلا تنزيلات، بلا غرف انتظار، فقط رابط. ولأن الوسائط تنتقل مباشرة بين المتصفحات بدلاً من المرور عبر سيرفر ترحيل، يكون زمن الاستجابة أقل ويبقى السيرفر نفسه خفيفاً، يحتاج فقط VPS صغيراً لاستضافة غرف لمجموعات صغيرة. يمنحك ملكية كاملة لمكالماتك، دون أن تلمس منصة فيديو طرف ثالث البث أبداً.
متى تحتاجه
- تحتاج مكالمات فيديو فورية عبر رابط بدون حسابات أو تنزيلات أو غرف انتظار للمشاركين
- تريد تحكماً كاملاً في بيانات مكالماتك دون توجيه المحادثات عبر منصة فيديو طرف ثالث
- تستضيف مكالمات مجموعات صغيرة (2-6 مشاركين) حيث تبقي الاتصالات النظير-إلى-نظير زمن الاستجابة منخفضاً والجودة عالية
- تريد سيرفر مؤتمرات فيديو خفيفاً يعمل على أجهزة سيرفر متواضعة ومنخفضة التكلفة
- تحتاج طريقة سريعة لمشاركة شاشتك مع عميل أو زميل دون تثبيت برنامج مؤتمرات مخصص
من يحتاجه
- المستقلون والاستشاريون الذين يريدون رابط مكالمة فيديو احترافياً بعلامتهم الخاصة دون الدفع لمنصة تجارية
- الفرق الصغيرة والشركات الناشئة التي تعقد مكالمات فردية أو جماعية سريعة ولا تحتاج ميزات ندوات المؤسسات
- المؤسسات المهتمة بالخصوصية التي تريد ألا تمر وسائط المكالمات عبر سيرفر طرف ثالث أبداً
- فرق الدعم التي تحتاج مشاركة الشاشة بسرعة مع عميل دون أن تطلب منه تثبيت تطبيق
- عشاق المختبرات المنزلية والاستضافة الذاتية الذين يريدون أداة مكالمات فيديو شخصية بجانب خدماتهم الأخرى ذاتية الاستضافة
- المعلمون الذين يديرون جلسات تدريس خصوصية صغيرة أو ساعات مكتبية مع عدد قليل من الطلاب في كل مرة
- المطورون الذين يريدون منصة WebRTC مفتوحة المصدر وقابلة للتضمين والتخصيص بعلامتهم الخاصة
- كل من يريد رابط غرفة اجتماع قابلاً للاستخدام مرة واحدة يشاركه ثم لا يفكر فيه مجدداً
حالات الاستخدام الشائعة
- عقد مكالمات فيديو سريعة وغير مخطط لها مع عملاء أو زملاء بمشاركة رابط غرفة واحد
- مشاركة شاشتك لشرح مستند أو برنامج أو تقرير خطأ لشخص آخر
- تشغيل جلسات دراسة أو تدريس جماعية صغيرة دون مطالبة الطلاب بإنشاء حسابات
- تقديم دعم فني عن بُعد مع مشاركة شاشة مباشرة ودردشة بجانب مكالمة الفيديو
- تضمين أداة مكالمات فيديو ذاتية الاستضافة داخل أداة داخلية أو بوابة عملاء
- استضافة مكالمات فيديو عائلية أو مع الأصدقاء دون الاعتماد على منصة فيديو من شركة تقنية كبرى
الميزات الرئيسية
- بنية WebRTC نظير-إلى-نظير حقيقية — بلا ترحيل عبر سيرفر وسائط، ما يبقي زمن الاستجابة منخفضاً للمجموعات الصغيرة
- لا حسابات ولا تنزيلات ولا إضافات متصفح مطلوبة — ينضم المشاركون فوراً من رابط مشترك
- مشاركة شاشة مدمجة لعرض المستندات أو الشرائح أو البرامج مباشرة أثناء المكالمة
- حماية الغرفة بكلمة مرور لمنع انضمام مشاركين غير مدعوين عبر رابط مشترك
- دردشة نصية بجانب الفيديو، مفيدة لمشاركة الروابط أو الملاحظات دون مقاطعة المكالمة
- تسجيل محلي داخل المتصفح يتيح للمشاركين حفظ المكالمة دون تخزين على السيرفر
- دعم جودة فيديو تصل إلى 8K و60 إطاراً بالثانية حسب إمكانيات الجهاز والشبكة
- واجهة مترجمة إلى 133 لغة، ما يجعلها متاحة للمشاركين غير الناطقين بالإنجليزية
كيفية الاستخدام بعد التثبيت
- افتح http://your-server-ip:3025 في متصفحك وأنشئ غرفة جديدة من الشاشة الرئيسية
- شارك رابط الغرفة المُولّد مع المشاركين — يكفيهم النقر عليه والسماح بالوصول للكاميرا والميكروفون
- عيّن كلمة مرور للغرفة من إعداداتها إذا أردت تقييد من يمكنه الانضمام بالرابط
- استخدم زر مشاركة الشاشة أثناء المكالمة لعرض المستندات أو الشرائح أو نافذة تطبيق
- فعّل التسجيل المحلي من أدوات التحكم أثناء المكالمة إذا احتجت حفظ المحادثة على جهازك
- اختبر الغرفة من جهازين أو شبكتين مختلفتين قبل الاعتماد عليها في مكالمة مهمة
- ضع MiroTalk خلف وكيل عكسي بشهادة HTTPS صالحة — تحظر المتصفحات الوصول للكاميرا/الميكروفون عبر HTTP عادي للمضيفين البعيدين
- أعدّ سيرفر STUN/TURN مثل coturn إذا كان المشاركون خلف NAT مقيّد ولا يستطيعون الاتصال مباشرة
أفضل ممارسات الأمان
- قدّم MiroTalk دائماً عبر HTTPS من خلال وكيل عكسي — ترفض المتصفحات الوصول للكاميرا والميكروفون عبر HTTP غير آمن للعناوين غير المحلية
- عيّن كلمة مرور للغرفة في أي مكالمة تحتوي معلومات حساسة لمنع انضمام مشاركين غير مدعوين
- تجنّب إعادة استخدام نفس اسم الغرفة الثابت لاجتماعات حساسة متكررة — ولّد رابط غرفة جديداً في كل مرة
- أبقِ صورة MiroTalk Docker محدّثة لتحصل على تصحيحات أمان وتوافق WebRTC
- قيّد الوصول لأدوات تحكم المسؤول/المضيف إذا كان نشرك يعرضها، لأنها تستطيع إنهاء المكالمات أو إزالة مشاركين
- شغّل MiroTalk على شبكة Docker معزولة وتجنّب كشف منافذ حاويات غير مرتبطة بجانبه
- إذا كنت تستضيف سيرفر TURN ذاتياً، أمّنه بمصادقة سر مشترك قوية لمنع استغلاله في ترحيل حركة مرور غير مرتبطة
- راجع من يملك رابط الغرفة دورياً لأي غرف طويلة الأمد أو عامة، لأن أي شخص يملك الرابط يمكنه الانضمام
المنافذ وإعدادات جدار الحماية
يستمع سيرفر الإشارات في MiroTalk على المنفذ 3000 داخل الحاوية؛ سكريبت هذا الدرس ينشره على المنفذ 3025 على المضيف لواجهة الويب واتصال WebSocket المستخدم لإعداد المكالمات. الصوت والفيديو الفعليان لا ينتقلان عبر المنفذ 3025 — بمجرد إنشاء المكالمة، يتفاوض WebRTC على مسارات وسائط UDP خاصة به مباشرة بين متصفحات المشاركين. إذا كان المشاركون خلف NAT مقيّد أو جدران حماية للشركات، قد تحتاج لإعداد سيرفر STUN/TURN (مثل coturn) وفتح نطاق منافذ UDP الخاص به لترحيل الوسائط.
النسخ الاحتياطي والصيانة
- MiroTalk P2P عديم الحالة إلى حد كبير — لا توجد قاعدة بيانات مكالمات لنسخها احتياطياً، لأن المكالمات لا تُخزّن على السيرفر
- احفظ نسخة من docker-compose.yml وأي متغيرات بيئة مخصصة (إعدادات STUN/TURN والعلامة التجارية) لإعادة إنشاء النشر
- إذا فعّلت التسجيل المحلي، تأكد أن المشاركين يحفظون التسجيلات على أجهزتهم لأن MiroTalk لا يخزّنها مركزياً
- احفظ نسخة من أي شهادات SSL مخصصة أو إعدادات وكيل عكسي مستخدمة لتقديم MiroTalk عبر HTTPS
- وثّق بيانات اعتماد وإعدادات سيرفر TURN بشكل منفصل، لأن فقدانها سيُعطّل الاتصال للمشاركين البعيدين
- اختبر دورياً أن حاوية جديدة مُعاد إنشاؤها من ملف compose المحفوظ تبدأ وتخدم الغرف بشكل صحيح
الأخطاء الشائعة
- الوصول إلى MiroTalk عبر HTTP عادي من جهاز بعيد ثم التساؤل عن سبب عدم عمل الكاميرا والميكروفون
- عدم تعيين كلمة مرور للغرفة في الاجتماعات الحساسة، ما يسمح لأي شخص يكتشف الرابط بالانضمام دون دعوة
- توقّع أن يتوسع وضع P2P لاجتماعات كبيرة — كل مشارك إضافي يضاعف تكلفة النطاق الترددي والمعالج على كل جهاز
- نسيان إعداد سيرفر TURN للمشاركين البعيدين خلف NAT شركات أو شبكات جوال مقيّدة، ما يسبب فشل الاتصالات
- كشف المنفذ 3025 مباشرة للإنترنت دون وكيل عكسي، ما يفوّت HTTPS وتحديد معدل الطلبات
- افتراض أن التسجيلات تُحفظ على السيرفر — تسجيل MiroTalk يحدث محلياً داخل متصفح المشارك
- تشغيل الحاوية بدون restart: unless-stopped، ما يترك MiroTalk غير متصلة بعد إعادة تشغيل السيرفر
- عدم اختبار الغرفة من شبكة خارجية قبل مكالمة مهمة، ما يفوّت مشكلات NAT أو الجدار الناري مسبقاً
استكشاف الأخطاء وإصلاحها
- الكاميرا أو الميكروفون لا يعملان — تأكد من الوصول إلى MiroTalk عبر HTTPS وليس HTTP عادي، من جهاز بعيد
- لا يستطيع المشاركون الاتصال ببعضهم — أعدّ سيرفر STUN/TURN؛ غالباً ما تحظر شبكات NAT المقيّدة الاتصالات المباشرة P2P
- المكالمة متقطعة أو تنقطع كثيراً — قلّل عدد المشاركين أو تحقق من النطاق الترددي الصاعد لكل جهاز، لأن P2P لا يتوسع جيداً فوق عدد قليل من الأشخاص
- مشاركة الشاشة لا تبدأ — تحقق من منح صلاحيات التقاط الشاشة في المتصفح ومن استخدام متصفح مدعوم (Chrome أو Firefox أو Edge)
- رابط الغرفة يظهر خطأ اتصال — تحقق من تشغيل الحاوية بـ docker ps ومن فتح المنفذ 3025 في الجدار الناري
- زر التسجيل لا يفعل شيئاً — تحقق أن المتصفح يدعم واجهة MediaRecorder API وأن أذونات التخزين المحلي/التنزيل غير محظورة
- لا تظهر مطالبة كلمة مرور الغرفة للمشاركين الآخرين — تأكد أن كلمة المرور فعلاً تم تعيينها وحفظها قبل مشاركة رابط الغرفة
- استخدام معالج مرتفع على السيرفر — تذكّر أن MiroTalk P2P لا يعالج الوسائط على السيرفر؛ ابحث عن حاويات أخرى تعمل أو حمل النظام بدلاً من ذلك
البدائل
يستخدم Jitsi Meet وحدة SFU (توجيه انتقائي) تُمرر الوسائط عبر السيرفر، ما يوفر قابلية توسع أفضل بكثير للاجتماعات الكبيرة لكن يتطلب نشراً أثقل. يقدّم MiroTalk أيضاً نسخة SFU للغرف الأكبر إذا أصبح حد المجموعات الصغيرة في نسخة P2P عائقاً. صُمم BigBlueButton خصيصاً للفصول الدراسية الإلكترونية باستطلاعات وغرف فرعية وتسجيل، مقابل موارد أكبر بكثير للاستضافة الذاتية. لأبسط مكالمة فيديو فورية ممكنة بدون أي معالجة وسائط على السيرفر، يبقى MiroTalk P2P الخيار الأخف.
متى لا تستخدمه
تجنّب MiroTalk P2P للاجتماعات الأكبر من حفنة مشاركين — لأن كل متصفح يتصل مباشرة بكل متصفح آخر، ينمو استهلاك النطاق الترددي والمعالج على كل جهاز بسرعة مع امتلاء الغرفة، ويصبح غير عملي عادةً فوق 4-6 أشخاص. إذا احتجت تسجيلاً مدمجاً إلى التخزين السحابي، أو غرفاً فرعية، أو بثاً بأسلوب الندوات لجمهور كبير، اختر منصة تعتمد على SFU مثل Jitsi Meet أو BigBlueButton أو نسخة SFU من MiroTalk نفسها.
هل تحتاج مساعدة احترافية؟
توفر PrismaTechWork خدمات بنية تحتية شاملة — من النشر الأولي وتصليب الأمان إلى المراقبة المستمرة والنسخ الاحتياطي التلقائي والدعم المخصص. سواء كنت تحتاج إعداد سيرفر واحد أو شبكة متعددة المواقع، يضمن فريقنا بناء بنيتك التحتية بشكل صحيح وتأمينها بالشكل المناسب وصيانتها باستمرار.
- التثبيت وتجهيز السيرفر
- الإعداد المتقدم وإعداد التوجيه
- تصليب الأمان وتحسين جدار الحماية
- إعداد شهادات SSL/TLS مع Let's Encrypt
- ربط النطاق المخصص والوكيل العكسي
- جدولة النسخ الاحتياطي التلقائي والتعافي من الكوارث
- المراقبة الفورية وتنبيهات الجاهزية
- الترحيل من المنصات القائمة
- استكشاف مشكلات الاتصال والأداء وإصلاحها
- سكريبتات أتمتة مخصصة وعقود دعم مستمر
الأسئلة الشائعة
ما الفرق بين MiroTalk P2P وJitsi Meet؟
MiroTalk P2P نظير-إلى-نظير: تنتقل الوسائط مباشرة بين المتصفحات، خفيف وبزمن استجابة منخفض لكنه الأفضل للمجموعات الصغيرة. يستخدم Jitsi Meet وحدة SFU تُمرر البث عبر السيرفر، ما يوفر توسعاً لاجتماعات أكبر مقابل نشر أثقل. يقدّم MiroTalk أيضاً نسخة SFU.
هل يحتاج المشاركون حساباً أو تطبيقاً؟
لا. يعمل MiroTalk بالكامل من المتصفح. يفتح المشاركون رابط الغرفة، يمنحون أذونات الكاميرا والميكروفون، وينضمون. لا حسابات ولا شيء يُثبَّت.
ما المنفذ الذي يستخدمه MiroTalk؟
يستمع سيرفر الإشارات على المنفذ 3025 على المضيف، معيّن من المنفذ الداخلي 3000 للحاوية، ويخدم واجهة الويب وWebSocket. الصوت والفيديو الفعليان يستخدمان مسارات UDP المتفاوض عليها في WebRTC بين النظراء، وليس المنفذ 3025.
لماذا لا تعمل الكاميرا؟
تسمح المتصفحات بالوصول للكاميرا والميكروفون فقط في سياق آمن. إذا وصلت إلى MiroTalk عبر HTTP عادي من جهاز بعيد، يحظر المتصفح الأجهزة. ضع MiroTalk خلف وكيل عكسي بشهادة HTTPS صالحة.
هل أحتاج سيرفر TURN؟
للمكالمات على نفس الشبكة المحلية، عادةً لا. للمشاركين البعيدين عبر الإنترنت، غالباً ما تحظر شبكات NAT المقيّدة الاتصالات المباشرة نظير-إلى-نظير، لذا تحتاج سيرفر STUN للاكتشاف وسيرفر TURN لترحيل الوسائط.