📹 تثبيت Frigate NVR — كشف كائنات بالذكاء الاصطناعي لكاميرات IP
انشر Frigate NVR على Ubuntu — مسجّل فيديو شبكي مدعوم بالذكاء الاصطناعي في الوقت الفعلي يكشف الأشخاص والمركبات والحيوانات وكائنات مخصصة في بث الكاميرات المباشر باستخدام Coral TPU أو NVIDIA GPU أو استدلال المعالج.
📦 الملفات والأكواد المطلوبة
قبل البدء، يرجى التأكد من تحميل الأكواد المطلوبة من مستودعنا على GitHub لتتمكن من تطبيق الخطوات مع الفيديو بسهولة.
التثبيت السريع:
wget https://raw.githubusercontent.com/mhmdali94/Docker/refs/heads/main/cameras/frigate/frigate-ubuntu.sh
chmod +x frigate-ubuntu.sh
sudo bash frigate-ubuntu.sh
خطوات التنفيذ
1 تحميل السكريبت
wget https://raw.githubusercontent.com/mhmdali94/Docker/refs/heads/main/cameras/frigate/frigate-ubuntu.sh
2 منح صلاحية التنفيذ
chmod +x frigate-ubuntu.sh
3 تشغيل المثبّت
يثبّت السكريبت Docker إن لزم، يسحب صورة Frigate، ينشئ دليل الإعداد في /opt/frigate/config/، ويشغّل الحاوية بذاكرة مشتركة وتمرير أجهزة اختياري للتسريع بالأجهزة.
sudo bash frigate-ubuntu.sh
4 الدخول إلى واجهة الويب
افتح المتصفح وانتقل إلى واجهة Frigate:
http://<your-server-ip>:5000
المنافذ المستخدمة
| المنفذ | الغرض |
|---|---|
| 5000 | Web UI (HTTP) |
| 8554 | RTSP restream server (go2rtc) |
| 8555 | WebRTC live view (TCP/UDP) |
نظرة عامة
Frigate هو مسجّل فيديو شبكي (NVR) مفتوح المصدر يعالج البيانات محلياً ويستخدم كشف كائنات بتعلم الآلة لتحديد الأشخاص والمركبات والحيوانات وكائنات مخصصة في الوقت الفعلي. مبني حول go2rtc لاستقبال الكاميرات وTensorFlow Lite للاستدلال، يخزّن Frigate فقط المقاطع واللقطات المُحفّزة بأحداث بدلاً من التسجيل المستمر، ما يقلل متطلبات التخزين بشكل كبير. يعرض لوحة تحكم ويب للبث المباشر ومراجعة الأحداث والإحصائيات، ويندمج بشكل أصلي مع Home Assistant ووسطاء MQTT. يُدعم التسريع بالأجهزة عبر Google Coral TPU وNVIDIA GPU (TensorRT) وAMD ROCm أو Intel OpenVINO لتحقيق كشف بمعدل 5-30+ إطاراً في الثانية لكل كاميرا دون إرهاق المعالج.
لماذا تستخدمه
تفرض أنظمة الكاميرات الذكية السحابية رسوماً شهرية لكل كاميرا وترسل تسجيلاتك لخوادم طرف ثالث. يُبقي Frigate كل معالجة وتخزين الفيديو على جهازك الخاص — دون اشتراكات، ودون خروج بيانات من شبكتك. نموذج التسجيل القائم على الأحداث يعني أنك تحتفظ فقط بالمقاطع المهمة، بينما دقة الكشف بالذكاء الاصطناعي مع Coral TPU تضاهي أنظمة NVR الذكية التجارية بجزء يسير من التكلفة. بالنسبة لمستخدمي Home Assistant، Frigate هو المعيار الفعلي لدمج كشف الكاميرات بالذكاء الاصطناعي في سير عمل أتمتة المنزل.
متى تحتاجه
- تُشغّل عدة كاميرات IP وتريد تصفية قائمة على الذكاء الاصطناعي بدلاً من مراجعة ساعات من التسجيلات الخام غير المهمة
- تريد تحفيز أتمتة المنزل أو التنبيهات أو الإضاءة بناءً على كائنات مكتشفة فعلياً بدلاً من حركة بسيطة
- تحتاج استبدال التسجيل المستمر بمقاطع قائمة على الأحداث للحفاظ على تكلفة التخزين وتآكل القرص ضمن حدود معقولة
- تستخدم Home Assistant بالفعل وتريد ربط أحداث كشف الكاميرات مباشرة بأتمتتك
- تريد NVR ذكياً دون رسوم اشتراك متكررة لكل كاميرا تفرضها خدمات الكاميرات السحابية
من يحتاجه
- مستخدمو Home Assistant الذين يبنون أتمتة تتفاعل مع كشف شخص أو مركبة فعلياً على الكاميرا
- عشاق المختبرات المنزلية والاستضافة الذاتية الراغبون في إعداد نظام أمن منزلي يحترم الخصوصية
- أصحاب الأعمال الصغيرة الذين يراقبون متجراً أو مستودعاً أو منطقة انتظار سيارات دون اشتراك سحابي شهري للكاميرات
- الأسر المهتمة بالخصوصية التي لا تريد رفع تسجيلات الكاميرات لخدمة سحابية تابعة لطرف ثالث
- الهواة المُجرِّبون لـ Coral TPU أو GPU احتياطي من NVIDIA لاستدلال تعلم آلي في الوقت الفعلي على الحافة
- مديرو تقنية المعلومات الذين يحتاجون تسجيل أحداث موثوقاً وكشف كائنات لنقاط الدخول والمناطق الحساسة
- المزارعون وملاك العقارات الريفية الذين يستخدمون الكشف بالذكاء الاصطناعي للتمييز بين الحياة البرية والمركبات والأشخاص في عقارات واسعة
حالات الاستخدام الشائعة
- احصل على تنبيه فقط عندما يدخل شخص إلى ممر منزلك، مع تصفية السيارات المارة في الشارع
- حفّز أتمتة Home Assistant — تشغيل الإضاءة أو إرسال إشعار — عند اكتشاف مركبة في الفناء
- سجّل وراجع مقاطع أحداث قصيرة لتسليم الطرود بدلاً من تصفح ساعات من التسجيلات
- راقب فناءً خلفياً أو حظيرة بحثاً عن الحيوانات مع تجاهل الحركة غير المهمة من الأشجار أو الظلال
- غذِّ أحداث الكشف في مسار Node-RED لبناء خطوط إشعارات أو تسجيل مخصصة
- أعد بث كاميرات RTSP عبر go2rtc للمشاهدة بزمن استجابة منخفض في لوحة تحكم Home Assistant أو تطبيق موبايل
الميزات الرئيسية
- كشف كائنات في الوقت الفعلي للأشخاص والمركبات والحيوانات وعشرات فئات الكائنات القابلة للتدريب الأخرى
- استدلال مسرّع بالأجهزة عبر Google Coral TPU أو NVIDIA GPU (TensorRT) أو Intel OpenVINO أو AMD ROCm
- تسجيل مقاطع ولقطات قائم على الأحداث يحفظ التسجيل فقط عند كشف كائن مُعرَّف
- إعادة بث go2rtc مدمجة لعرض RTSP وWebRTC مباشر بزمن استجابة منخفض دون إعادة ترميز بث كل مشاهد
- تكامل أصلي مع Home Assistant يعرض الكاميرات والكائنات المكتشفة والمقاطع ككيانات
- نشر أحداث عبر MQTT لمحفزات الكشف، ما يتيح أتمتة مخصصة خارج Home Assistant
- إعداد مناطق وأقنعة لكل كاميرا لتجاهل المناطق غير المهمة وتقليل الإيجابيات الكاذبة
- سياسات احتفاظ قابلة للتهيئة لكل كاميرا تتحكم بمدة الاحتفاظ بالمقاطع واللقطات
كيفية الاستخدام بعد التثبيت
- عدّل frigate.yml لإضافة رابط بث RTSP والدقة ومعدل الإطارات لكل كاميرا
- اضبط قسم detector لاستخدام استدلال قائم على المعالج أو Coral TPU أو GPU حسب جهازك
- عرّف مناطق وأقنعة الكشف لكل كاميرا لاستبعاد المناطق غير المهمة مثل الشوارع المزدحمة أو الأشجار
- اضبط أنواع الكائنات المتتبعة لكل كاميرا (شخص، سيارة، كلب، إلخ) بناءً على ما تحتاج تنبيهات له فعلياً
- اضبط إعدادات الاحتفاظ (retain.days وretention.mode) للتحكم في نمو التخزين لكل كاميرا
- اربط Frigate بوسيط MQTT حتى تستطيع أحداث الكشف تحفيز أتمتة Home Assistant
- أضف تكامل Frigate في Home Assistant لعرض الكاميرات والمقاطع وكيانات الكائنات المكتشفة
- تحقق من تحميل البث المباشر والمقاطع المسجلة بشكل صحيح في لوحة التحكم قبل الاعتماد على النظام
أفضل ممارسات الأمان
- ضع واجهة ويب Frigate (المنفذ 5000) خلف وكيل عكسي مع مصادقة — لا تكشفها مباشرة للإنترنت أبداً
- استخدم Nginx Proxy Manager أو Authelia لفرض تسجيل الدخول قبل الوصول للوحة التحكم أو بث الكاميرات المباشر
- قيّد منفذ إعادة بث RTSP (8554) على شبكتك المحلية فقط، لأنه يُستخدم عادة من عملاء NVR محليين آخرين
- استخدم بيانات اعتماد قوية وفريدة على كل كاميرا IP نفسها وليس فقط على Frigate — الكاميرات هدف هجوم شائع
- اعزل الكاميرات على VLAN منفصلة حتى لا تصل كاميرا مخترقة لبقية شبكتك
- حافظ على تحديث صورة Frigate Docker لتلقي تحسينات الأمان ونماذج الكشف
- قيّد وصول وسيط MQTT بمصادقة حتى لا يمكن تزييف أحداث الكشف أو اعتراضها
- راجع أتمتة Home Assistant المحفَّزة بأحداث Frigate للتأكد أنها لا يمكن إساءة استخدامها إذا زُيِّفت
المنافذ وإعدادات جدار الحماية
تعرض Frigate المنفذ 5000 لواجهة الويب، والمنفذ 8554 لإعادة بث RTSP عبر go2rtc، والمنفذ 8555 (TCP/UDP) لعرض WebRTC المباشر في المتصفح. يجب ألا يُكشف المنفذ 5000 للعامة دون مصادقة أبداً — استخدم Nginx Proxy Manager أو Authelia لإضافة HTTPS والتحكم بالوصول. المنفذ 8554 هو نقطة نهاية إعادة بث RTSP التي يستخدمها Home Assistant وعملاء NVR آخرون؛ قيّده على شبكتك المحلية. مثال قاعدة جدار ناري: ufw allow from 192.168.1.0/24 to any port 5000.
النسخ الاحتياطي والصيانة
- انسخ frigate.yml احتياطياً — يحتوي رابط RTSP ومناطق الكشف وإعدادات الاحتفاظ لكل كاميرا
- انسخ مسار تخزين المقاطع والتسجيلات احتياطياً إذا كان الاحتفاظ الطويل بالتسجيلات مهماً لحالة استخدامك
- صدّر أتمتة Home Assistant التي تشير لكيانات Frigate حتى يمكن استعادتها معاً
- وثّق بيانات اعتماد الكاميرات وروابط RTSP بشكل منفصل في مدير كلمات مرور تحسباً لفقدان الإعداد
- خزّن نسخ الإعداد الاحتياطية خارج مضيف NVR — فقدان الإعداد مع عطل قرص يعني البدء من الصفر
- اختبر نشراً جديداً دورياً باستخدام frigate.yml المنسوخ احتياطياً للتأكد أنه يستعيد اتصال الكاميرات
الأخطاء الشائعة
- تشغيل كشف قائم على المعالج فقط على أربع كاميرات أو أكثر ثم التساؤل عن سبب تأخر الكشف أو فقدان الأحداث
- عدم إعداد مناطق أو أقنعة، ما يسبب كشفاً إيجابياً كاذباً مستمراً من الأشجار أو الظلال أو حركة المرور
- كشف المنفذ 5000 مباشرة للإنترنت دون وكيل عكسي أو مصادقة أمامه
- ضبط احتفاظ أعلى من مساحة القرص المتاحة، ما يسبب امتلاء حجم التخزين وفشل التسجيلات
- استخدام بث فرعي RTSP متدهور أو مضغوط بشدة للكشف، ما يقلل دقة نموذج الذكاء الاصطناعي
- نسيان تفعيل التسريع بالأجهزة عندما يكون Coral TPU أو GPU متاحاً فعلياً على المضيف
- عدم إعادة تشغيل الحاوية بعد تعديل frigate.yml، ما يعني عدم تفعيل تغييرات الإعداد أبداً
- خلط بث الكشف والتسجيل بشكل غير صحيح، ما يهدر النطاق الترددي بفك ترميز نفس البث عدة مرات دون داعٍ
استكشاف الأخطاء وإصلاحها
- لا يحدث كشف — تحقق أن قسم detector في frigate.yml يطابق جهازك الفعلي (معالج أو Coral أو GPU) وراجع سجلات الحاوية للأخطاء
- استخدام مرتفع للمعالج وإطارات مفقودة — تأكد أن التسريع بالأجهزة مفعّل فعلياً؛ الاستدلال بالمعالج فقط على كاميرات كثيرة سيُرهق معظم السيرفرات
- بث الكاميرا لا يُحمَّل في لوحة التحكم — تحقق أن رابط RTSP متاح من داخل الحاوية باستخدام ffprobe وراجع بيانات اعتماد الكاميرا
- Home Assistant لا يستقبل الأحداث — تأكد أن تفاصيل اتصال وسيط MQTT في frigate.yml تطابق وسيطك وأن التكامل مُعدّ
- المقاطع مفقودة بعد فترة الاحتفاظ المُعدّة — راجع إعدادات retain.days وretention.mode لكل كاميرا في frigate.yml
- كشف كاذب من الظلال أو الانعكاسات — نقّح مناطق الكشف واضبط عتبة ثقة الكائن لكل كاميرا
- عرض WebRTC المباشر لا يتصل — تحقق أن المنفذ 8555 (TCP/UDP) مفتوح وأن مرشحات WebRTC في go2rtc مضبوطة لشبكتك
- امتلاء التخزين بشكل غير متوقع — راجع إعدادات الاحتفاظ لكل كاميرا وعطّل التسجيل المستمر إذا كنت تحتاج فقط مقاطع الأحداث
البدائل
go2rtc (مُغطى في هذه الأكاديمية) بوابة بث كاميرات خفيفة دون كشف بالذكاء الاصطناعي — استخدمه إذا كنت تحتاج فقط إعادة بث RTSP/WebRTC. Shinobi هو NVR كامل الميزات بكشف حركة لكن دون تصنيف كائنات بالذكاء الاصطناعي. Zoneminder هو NVR ناضج ومُختبَر جيداً لكنه أكثر تعقيداً بكثير في الإعداد. يوفر Scrypted مركز كاميرات بدعم HomeKit Secure Video ويدمج أيضاً Frigate كإضافة للكشف بالذكاء الاصطناعي.
متى لا تستخدمه
إذا كان لديك فقط 1-2 كاميرا ولا تحتاج كشفاً بالذكاء الاصطناعي، فقد يكفي NVR أبسط مثل go2rtc أو Shinobi. إذا كنت تفتقر لـ Coral TPU أو GPU من NVIDIA، فإن الكشف بالمعالج فقط على 4+ كاميرات سيُرهق السيرفرات الحديثة — خطط للتسريع بالأجهزة قبل التوسع. Frigate غير مناسب للكاميرات التي تُخرج فقط بث H.265+ دون دعم إعادة ترميز، أو للمواقع التي تتطلب تكراراً معقداً متعدد السيرفرات.
هل تحتاج مساعدة احترافية؟
توفر PrismaTechWork خدمات بنية تحتية شاملة — من النشر الأولي وتصليب الأمان إلى المراقبة المستمرة والنسخ الاحتياطي التلقائي والدعم المخصص. سواء كنت تحتاج إعداد سيرفر واحد أو شبكة متعددة المواقع، يضمن فريقنا بناء بنيتك التحتية بشكل صحيح وتأمينها بالشكل المناسب وصيانتها باستمرار.
- التثبيت وتجهيز السيرفر
- الإعداد المتقدم وإعداد التوجيه
- تصليب الأمان وتحسين جدار الحماية
- إعداد شهادات SSL/TLS مع Let's Encrypt
- ربط النطاق المخصص والوكيل العكسي
- جدولة النسخ الاحتياطي التلقائي والتعافي من الكوارث
- المراقبة الفورية وتنبيهات الجاهزية
- الترحيل من المنصات القائمة
- استكشاف مشكلات الاتصال والأداء وإصلاحها
- سكريبتات أتمتة مخصصة وعقود دعم مستمر
الأسئلة الشائعة
هل يتطلب Frigate وحدة Coral TPU للعمل؟
لا. يعمل Frigate باستدلال المعالج فقط جاهزاً، لكن الكشف سيكون أبطأ. للكشف في الوقت الفعلي بمعدل 5+ إطارات في الثانية لكل كاميرا، يُنصح بشدة بمسرّع Coral USB أو وحدة Coral M.2. يدعم Frigate أيضاً تسريع NVIDIA GPU وAMD GPU عبر ROCm وIntel OpenVINO.
ما الكاميرات التي يدعمها Frigate؟
يدعم Frigate أي كاميرا IP توفر بث RTSP. يشمل هذا Hikvision وDahua وReolink وAmcrest ومعظم الكاميرات المتوافقة مع ONVIF. تضبط رابط RTSP في frigate.yml. كاميرات USB غير مدعومة مباشرة دون أدوات إضافية.
كيف يتكامل Frigate مع Home Assistant؟
يتكامل Frigate مع Home Assistant عبر تكامل Frigate الرسمي وMQTT. تظهر الكائنات المكتشفة والمقاطع واللقطات ككيانات في Home Assistant. يمكنك تحفيز أتمتة عند أحداث person_detected أو car_detected عبر MQTT من موضوع frigate/events.
كم من التخزين يستخدم Frigate؟
يعتمد التخزين على إعدادات الاحتفاظ لديك. يسجّل Frigate مقاطع فقط عند كشف كائنات، وليس تسجيلاً مستمراً افتراضياً. إعداد نموذجي بأربع كاميرات واحتفاظ لمدة 7 أيام يستخدم 50-200 غيغابايت. اضبط retain.days وretention.mode لكل كاميرا في frigate.yml للتحكم في نمو التخزين.
هل يمكن لـ Frigate إرسال إشعارات فورية؟
ينشر Frigate أحداث الكشف على مواضيع MQTT مثل frigate/events وfrigate/<camera>/<object>/snapshot. يمكنك بعدها استخدام أتمتة Home Assistant أو Node-RED أو مشترك MQTT مخصص لإرسال إشعارات فورية عبر ntfy أو Gotify أو Telegram أو أي خدمة إشعارات.