📡 تثبيت go2rtc — بوابة بث الكاميرات لـ RTSP وWebRTC وHLS
انشر go2rtc على Ubuntu — بوابة بث كاميرات فائقة الخفة تستقبل تدفقات RTSP من أي كاميرا IP وتعيد بثها كـ WebRTC أو HLS أو MSE أو RTSP بزمن استجابة أقل من ثانية.
📦 الملفات والأكواد المطلوبة
قبل البدء، يرجى التأكد من تحميل الأكواد المطلوبة من مستودعنا على GitHub لتتمكن من تطبيق الخطوات مع الفيديو بسهولة.
التثبيت السريع:
wget https://raw.githubusercontent.com/mhmdali94/Docker/refs/heads/main/cameras/go2rtc/go2rtc-ubuntu.sh
chmod +x go2rtc-ubuntu.sh
sudo bash go2rtc-ubuntu.sh
خطوات التنفيذ
1 تحميل السكريبت
wget https://raw.githubusercontent.com/mhmdali94/Docker/refs/heads/main/cameras/go2rtc/go2rtc-ubuntu.sh
2 منحه صلاحية التنفيذ
chmod +x go2rtc-ubuntu.sh
3 تشغيل المثبّت
يثبّت السكريبت Docker إن لزم الأمر، وينشئ /opt/go2rtc/go2rtc.yaml، ويشغّل الحاوية مع كشف المنفذ 1984 (API/الواجهة) والمنفذ 8554 (إعادة بث RTSP).
sudo bash go2rtc-ubuntu.sh
4 الدخول إلى واجهة الويب
افتح المتصفح وانتقل إلى واجهة go2rtc:
http://<your-server-ip>:1984
المنافذ المستخدمة
| المنفذ | الغرض |
|---|---|
| 1984 | REST API + Web UI |
| 8554 | RTSP restream server |
| 8555 | WebRTC (TCP/UDP) |
نظرة عامة
go2rtc تطبيق بث كاميرات بملف تنفيذي واحد وبدون أي اعتماديات، مكتوب بلغة Go. يعمل كبوابة بث شاملة — يستقبل الفيديو من كاميرات RTSP، وتغذيات RTMP، ومصادر HTTP، وأجهزة USB، أو مسارات FFmpeg، ثم يعيد بث تلك التدفقات في وقت واحد كـ WebRTC (بزمن استجابة أقل من ثانية) وإعادة بث RTSP وHLS وMSE أو MJPEG. على عكس حلول NVR الكاملة، لا يقوم go2rtc بأي تسجيل أو استدلال ذكاء اصطناعي — إنه جسر بروتوكول عالي الأداء بحت. مُدمج داخل Frigate NVR كمحرك بثه، ويُستخدم أصلياً بواسطة Home Assistant لعرض الكاميرات المباشر. نسخة واحدة من go2rtc يمكنها التعامل مع عشرات الكاميرات على عتاد متواضع.
لماذا تستخدمه
معظم كاميرات IP توفر تدفقات RTSP يصعب مشاهدتها مباشرة في المتصفح دون إضافات. يحل go2rtc هذه المشكلة بترميز أو إعادة تغليف التدفق إلى بروتوكولات أصلية للمتصفح (WebRTC، HLS) بأقل استهلاك للمعالج. بما أنه مكتوب بلغة Go ويستخدم تمرير الترميز الأصلي حيثما أمكن، فهو يستهلك جزءاً بسيطاً من المعالج مقارنة بالحلول القائمة على FFmpeg فقط. إذا كنت تستخدم Home Assistant، فإن go2rtc هو الخلفية الرسمية للبث لبطاقة عرض الكاميرا المباشر.
متى تحتاجه
- لديك كاميرات IP توفر فقط تدفقات RTSP وتحتاج مشاهدتها في المتصفح دون تثبيت إضافات أو تطبيق أصلي
- تبني أو تشغّل إعداد Frigate NVR وتحتاج فهم أو تخصيص طبقة البث التي يعتمد عليها
- تريد عرض كاميرا مباشراً بزمن استجابة أقل من ثانية في لوحة Lovelace في Home Assistant
- تحتاج إعادة بث تدفق كاميرا واحدة بعدة صيغ في وقت واحد (WebRTC للمتصفحات، RTSP لبرامج NVR)
- تريد بوابة بث خفيفة دون عبء NVR كامل يسجّل ويحلل اللقطات
- تحتاج دمج عدة مصادر كاميرات (RTSP، RTMP، USB، HTTP) في نقطة بث موحّدة واحدة
من يحتاجه
- مستخدمو Home Assistant الذين يريدون عرض كاميرا مباشراً سريعاً وأصلياً دون NVR منفصل
- مستخدمو Frigate NVR ومشغلو المختبرات المنزلية الذين يريدون فهم محرك البث الذي يشغّل إعدادهم
- هواة كاميرات الأمان الذين يبنون لوحة مراقبة متعددة الكاميرات مخصصة
- المطورون الذين يبنون تطبيقات عرض كاميرا مخصصة ويحتاجون خلفية بث مستقرة
- مستخدمو الكاميرات القديمة التي تتحدث RTSP فقط ويريدون تشغيلاً أصلياً في المتصفح دون إضافات
- مدمجو الأنظمة الذين يبنون تركيبات منزل ذكي أو أمان ويحتاجون بثاً موثوقاً منخفض زمن الاستجابة
- أي شخص يريد اختبار أو معاينة بث كاميرا بسرعة دون نشر حزمة NVR كاملة
حالات الاستخدام الشائعة
- تغذية لوحة Lovelace في Home Assistant بتدفقات كاميرا WebRTC شبه معدومة زمن الاستجابة
- العمل كخلفية بث لإعداد Frigate NVR، والتعامل مع الاستقبال وإعادة البث
- إعادة بث كاميرا RTSP واحدة لعدة مشاهدين في وقت واحد دون إثقال الكاميرا نفسها
- تحويل كاميرا قديمة تدعم RTSP فقط إلى تدفق قابل للتشغيل في المتصفح عبر HLS أو WebRTC
- دمج عدة مصادر كاميرات في نسخة go2rtc واحدة للحصول على لوحة عرض موحّدة متعددة الكاميرات
- توفير نقطة إعادة بث RTSP يمكن لبرامج NVR أو المراقبة الأخرى استهلاكها
الميزات الرئيسية
- دعم إدخال متعدد البروتوكولات: RTSP وRTMP وHTTP وأجهزة USB (كاميرات الويب) ومسارات FFmpeg كمصادر كاميرات
- إخراج متعدد البروتوكولات: WebRTC للتشغيل في المتصفح بزمن استجابة أقل من ثانية، وإعادة بث RTSP، وHLS/MSE، ولقطات MJPEG
- ملف تنفيذي ثابت واحد بدون أي اعتماديات خارجية، مكتوب بلغة Go لأقل استهلاك للموارد
- تمرير ترميز أصلي يتجنب الترميز غير الضروري، مما يقلل استهلاك المعالج بشكل كبير مقارنة بالحلول القائمة على FFmpeg فقط
- واجهة ويب مدمجة لتصفح تدفقات الكاميرات المُعدّة واختبار التشغيل بأي صيغة
- تكامل عميق مع Home Assistant كمزود رسمي لـ WebRTC وإعادة بث RTSP لبطاقات الكاميرا
- مُدمج داخل Frigate NVR كمحرك بثه الأساسي، بحيث تستفيد التحسينات كلا المشروعين
- إعداد قائم على YAML (go2rtc.yaml) يدعم عشرات الكاميرات بإعدادات لكل تدفق
كيفية الاستخدام بعد التثبيت
- عدّل /opt/go2rtc/go2rtc.yaml لإضافة روابط RTSP لكاميراتك تحت قسم streams
- أعد تشغيل الحاوية بعد تعديل ملف الإعداد حتى يلتقط go2rtc قائمة الكاميرات الجديدة
- افتح واجهة الويب على المنفذ 1984 وانقر على تدفق مُعدّ لمعاينته في المتصفح
- اختبر نقطة إعادة بث RTSP على المنفذ 8554 من عميل NVR أو مشغل وسائط مثل VLC
- إذا كنت تستخدم Home Assistant، أضف تكامل go2rtc أو وجّه مصدر تدفق كيان الكاميرا إلى رابط إعادة بث RTSP
- إذا كنت تستخدم Frigate، تأكد أنه يستخدم نفس نسخة go2rtc بدلاً من إنشاء نسخة مكررة
- اضبط إعدادات كل كاميرا مثل الدقة أو الترميز في go2rtc.yaml إذا احتجت تقليل استهلاك النطاق الترددي أو المعالج
- ضع وكيلاً عكسياً أمام المنفذ 1984 إذا احتجت وصولاً آمناً عن بُعد لواجهة الويب
أفضل ممارسات الأمان
- واجهة ويب وAPI في go2rtc على المنفذ 1984 لا تملك مصادقة مدمجة افتراضياً — قيّد الوصول على مستوى الشبكة
- لا تكشف المنافذ 1984 أو 8554 أو 8555 مباشرة للإنترنت دون وكيل عكسي وطبقة مصادقة أبداً
- قيّد منافذ بث الكاميرا على شبكتك المحلية أو VPN، لأنها تكشف تدفقات فيديو مباشرة لأي شخص يستطيع الوصول إليها
- استخدم قاعدة جدار ناري للسماح فقط للشبكات الفرعية الموثوقة بالوصول لمنافذ go2rtc، كما هو موضح في قسم المنافذ وجدار الحماية
- خزّن بيانات اعتماد RTSP للكاميرا (اسم المستخدم/كلمة المرور) بأمان في go2rtc.yaml وقيّد صلاحيات الملف على المضيف
- حافظ على تحديث صورة go2rtc لتحصل على إصلاحات الأخطاء وتحسينات توافق البروتوكولات
- إذا كنت تكشف WebRTC خارجياً، تأكد أن وكيلك العكسي يتعامل بشكل صحيح مع نطاق منافذ UDP الإضافي الذي يتطلبه
- راجع دورياً أي التدفقات المُعدّة للتأكد من عدم بقاء أي تدفقات كاميرا غير مستخدمة أو منسية مكشوفة
المنافذ وإعدادات جدار الحماية
يستخدم go2rtc المنفذ 1984 لواجهة REST API والويب، والمنفذ 8554 لإعادة بث RTSP، والمنفذ 8555 (TCP/UDP) لـ WebRTC. يجب تقييد المنفذ 1984 على شبكتك المحلية أو حمايته بوكيل عكسي. المنفذ 8554 يُستهلك بواسطة عملاء NVR وHome Assistant — قيّده على الشبكات الداخلية. مثال جدار ناري: ufw allow from 192.168.0.0/16 to any port 1984,8554,8555.
النسخ الاحتياطي والصيانة
- انسخ احتياطياً ملف الإعداد go2rtc.yaml الذي يحتوي كل تعريفات وإعدادات تدفقات الكاميرات
- انسخ احتياطياً docker-compose.yml أو أمر التشغيل حتى يمكن إعادة إنشاء تعيينات المنافذ الدقيقة بشكل مطابق
- go2rtc نفسه عديم الحالة بخلاف ملف إعداده — لا توجد بيانات تسجيل أو قاعدة بيانات يجب نسخها احتياطياً
- إذا كان go2rtc مُدمجاً داخل نشر Frigate، انسخه احتياطياً كجزء من إعداد Frigate بدلاً من ذلك
- وثّق روابط RTSP لكاميراتك وبيانات اعتمادها بشكل منفصل تحسباً لاحتياجك إعادة بناء go2rtc.yaml من الصفر
- إعادة النشر بنفس go2rtc.yaml كافية عادة لاستعادة الوظائف الكاملة بعد ترحيل المضيف
الأخطاء الشائعة
- تشغيل نسخة go2rtc منفصلة إلى جانب النسخة المُدمجة في Frigate، مما يسبب تعارض منافذ وازدواج حمل الكاميرا
- كشف واجهة الويب على المنفذ 1984 مباشرة للإنترنت دون أي مصادقة أو وكيل عكسي
- نسيان إعادة تشغيل الحاوية بعد تعديل go2rtc.yaml، بحيث لا تُطبَّق تغييرات الإعداد أبداً
- توقع أن يسجّل go2rtc اللقطات أو يكشف الحركة — فهو لا يملك طبقة استمرارية أو ذكاء اصطناعي، على عكس NVR كامل
- استخدام صيغة رابط RTSP خاطئة أو نسيان بيانات اعتماد الكاميرا، مما يسبب فشل اتصال التدفقات بصمت
- عدم تقييد المنفذ 8554 على الشبكات الموثوقة، مما يكشف تدفقات RTSP الخام للكاميرا لأي شخص على الشبكة
- إثقال كاميرا واحدة بسحب تدفق RTSP الخاص بها مباشرة في أماكن متعددة بدلاً من ترك go2rtc يعيد بثها مرة واحدة
- تجاهل ارتفاع استهلاك المعالج الناتج عن ترميز غير ضروري بينما كان يمكن استخدام تمرير الترميز الأصلي بدلاً منه
استكشاف الأخطاء وإصلاحها
- التدفق لا يُحمّل في المتصفح — تحقق أن رابط RTSP للكاميرا صحيح ويمكن الوصول إليه من حاوية go2rtc
- تشغيل WebRTC يفشل — تحقق أن نطاق منافذ UDP المطلوب لمرشحي ICE مفتوح وغير محظور بجدار ناري
- زمن استجابة عالٍ رغم استخدام WebRTC — تأكد أن تدفق RTSP للكاميرا نفسه ليس متأخراً بالفعل من المصدر
- تغييرات الإعداد لا تُطبَّق — أعد تشغيل حاوية go2rtc بعد تعديل go2rtc.yaml
- إعادة بث RTSP على المنفذ 8554 غير متاحة من عميل NVR — تحقق من تعيين المنفذ وقواعد جدار الحماية
- لا يوجد صوت في التدفق — تحقق أن الكاميرا فعلاً تُخرج مساراً صوتياً وأن الترميز مدعوم
- استهلاك عالٍ للمعالج — تحقق ما إذا كان go2rtc يرمّز بدلاً من تمرير الترميز الأصلي، واضبط إعداد التدفق
- Frigate ونسخة go2rtc مستقلة يحاولان استخدام نفس الكاميرا — وحّدهما في نسخة go2rtc واحدة لتجنب التعارض
البدائل
Frigate NVR (مشروح في هذه الأكاديمية) يُدمج go2rtc داخلياً ويضيف كشف كائنات بالذكاء الاصطناعي وتسجيلاً فوقه. MediaMTX (المعروف سابقاً بـ rtsp-simple-server) بوابة RTSP/WebRTC مشابهة مبنية بـ Go بمجموعة ميزات مختلفة قليلاً. وحدة Nginx RTMP يمكنها التعامل مع إعادة البث القائم على RTMP لكنها تفتقر لدعم WebRTC. لحلول NVR كاملة مع التسجيل، ففكّر في Frigate أو Shinobi أو ZoneMinder.
متى لا تستخدمه
إذا كنت تحتاج تسجيلاً أو كشف كائنات بالذكاء الاصطناعي أو تخزين مقاطع حسب الأحداث، استخدم Frigate NVR بدلاً منه. go2rtc بوابة بث بحتة بدون طبقة استمرارية. إذا كان لديك كاميرا واحدة فقط وتريد فقط مشاهدتها في المتصفح، فالعديد من كاميرات IP الحديثة توفر بالفعل بثاً مدمجاً عبر HTTP قد يكون كافياً.
هل تحتاج مساعدة احترافية؟
توفر PrismaTechWork خدمات بنية تحتية شاملة — من النشر الأولي وتصليب الأمان إلى المراقبة المستمرة والنسخ الاحتياطي التلقائي والدعم المخصص. سواء كنت تحتاج إعداد سيرفر واحد أو شبكة متعددة المواقع، يضمن فريقنا بناء بنيتك التحتية بشكل صحيح وتأمينها بالشكل المناسب وصيانتها باستمرار.
- التثبيت وتجهيز السيرفر
- الإعداد المتقدم وإعداد التوجيه
- تصليب الأمان وتحسين جدار الحماية
- إعداد شهادات SSL/TLS مع Let's Encrypt
- ربط النطاق المخصص والوكيل العكسي
- جدولة النسخ الاحتياطي التلقائي والتعافي من الكوارث
- المراقبة الفورية وتنبيهات الجاهزية
- الترحيل من المنصات القائمة
- استكشاف مشكلات الاتصال والأداء وإصلاحها
- سكريبتات أتمتة مخصصة وعقود دعم مستمر
الأسئلة الشائعة
ما البروتوكولات التي يدعمها go2rtc؟
يدعم go2rtc RTSP وRTMP وWebRTC وHLS وMSE وMJPEG وFFmpeg كمصادر إدخال. صيغ الإخراج تشمل WebRTC (بزمن استجابة أقل من ثانية)، وإعادة بث RTSP على المنفذ 8554، وHLS/MSE للتشغيل في المتصفح، ولقطات MJPEG.
كيف يقارَن go2rtc بـ Frigate؟
go2rtc بوابة بث بحتة بدون تسجيل أو كشف بالذكاء الاصطناعي. Frigate في الواقع يُدمج go2rtc داخلياً كمحرك بثه. استخدم go2rtc مستقلاً عندما تحتاج فقط بثاً مباشراً دون عبء حزمة NVR كاملة.
هل يمكن لـ go2rtc البث إلى Home Assistant؟
نعم. يمكن لتكامل الكاميرا في Home Assistant استخدام إعادة بث RTSP الخاصة بـ go2rtc على المنفذ 8554 أو ضبطه كمزود WebRTC لعرض مباشر شبه معدوم زمن الاستجابة في بطاقة الكاميرا بلوحة Lovelace.
ما منفذ API لـ go2rtc؟
يكشف go2rtc واجهة REST API والويب على المنفذ 1984 افتراضياً. خادم إعادة بث RTSP يستمع على المنفذ 8554. WebRTC ICE يستخدم المنفذ 8555 (TCP/UDP). يجب تقييد الثلاثة جميعاً على شبكتك الداخلية.
هل يدعم go2rtc الصوت؟
نعم. يمرر go2rtc أو يرمّز الصوت جنباً إلى جنب مع الفيديو. يشمل تسليم WebRTC كلاً من الصوت والفيديو. يدعم ترميزات G.711 وG.722 وPCMU وPCMA وAAC وOpus حسب ما توفره الكاميرا المصدر.