الموضوع الأصلي هو مقدمة لبرنامج تعليمي خارجي من عام 2023، وليس سجلًا كاملًا لنشر Frigate. ويذكر أن البرنامج التعليمي سيثبّت Frigate على CasaOS ويدمج الكاميرات مع Google Coral، لكنه لا يحتفظ بصورة Docker أو وحدات التخزين أو المنافذ أو حجم الذاكرة المشتركة أو إعداد الكاشف المستخدم آنذاك.
بالنسبة إلى الإعداد الحالي، ينبغي أن تكون وثائق Frigate الرسمية المُحدّثة هي الأساس التقني. يظل Docker Compose طريقة التثبيت الموصى بها، ولم يعد Google Coral سوى أحد خيارات تسريع الأجهزة العديدة الممكنة لمسارات الكاشف والفيديو.
يوصي Frigate حاليًا باستخدام Docker Compose
يستخدم دليل التثبيت الحالي لـ Frigate الصورة ghcr.io/blakeblackshear/frigate:stable، وإعدادات ووسائط دائمة، وحجمًا صريحًا للذاكرة المشتركة، وتعيينات للأجهزة مناسبة لمسرّع الأجهزة المحدد.
استخدم نموذج التثبيت الحالي لـ Frigate بدلًا من نسخ فيديو من عام 2023 حرفيًا.
احفظ /config خارج الحاوية
ينبغي أن يكون إعداد Frigate بصيغة YAML في مجلد على المضيف مرتبط بـ /config. احتفظ به على وحدة تخزين CasaOS دائمة حتى لا تؤدي إعادة إنشاء الحاوية إلى حذف إعدادات الكاميرات والكاشف والتسجيل والمناطق واللقطات.
اربط التسجيلات والمقاطع بوحدة تخزين فعلية
قد تنمو فيديوهات NVR بسرعة أكبر بكثير من بيانات AppData العادية. ضع التسجيلات والمقاطع والملفات المُصدّرة على وحدة تخزين ذات سعة كافية بدلًا من قرص نظام التشغيل الصغير.
يجب أن تتوافق الذاكرة المشتركة مع عبء عمل الكاميرات
يستخدم Frigate الذاكرة المشتركة لمعالجة الفيديو. يتضمن مثال Compose الحالي قيمة صريحة لـ shm_size، وتعتمد القيمة الصحيحة على دقة الكاميرات وعددها.
Google Coral اختياري وليس متطلبًا عامًا
ركّز المصدر من عام 2023 على Google Coral. ولا يزال Frigate الحالي يوثّق تعيينات Coral عبر USB وPCIe، لكن عمليات النشر الحديثة قد تستخدم أيضًا تسريع الفيديو من Intel/AMD أو Intel NPU أو مسارات كاشف أخرى مدعومة، بحسب الأجهزة.
يتطلب تسريع الأجهزة تعيين الجهاز الصحيح
تتضمن الأمثلة الحالية /dev/bus/usb لـ Coral عبر USB، و/dev/apex_0 لـ Coral عبر PCIe، و/dev/dri/renderD128 لرسوميات Intel/AMD، و/dev/accel لمسارات Intel NPU المدعومة. امنح Frigate صلاحية الأجهزة التي يحتاج إليها فعليًا فقط.
الوضع المميّز ليس مطلوبًا دائمًا
يشير مثال Compose الحالي لـ Frigate إلى أن privileged: true قد لا يكون ضروريًا لجميع الإعدادات. يُفضَّل الالتزام بأقل قدر من الصلاحيات عندما تكون تعيينات الأجهزة والأذونات الصريحة كافية.
حافظ على خصوصية بيانات اعتماد الكاميرات ونقاط نهاية RTSP
يحتوي إعداد Frigate عادةً على أسماء مستخدمي الكاميرات وكلمات المرور وعناوين RTSP. تجنّب نشر ملفات الإعداد الكاملة أو لقطات الشاشة من دون إخفاء الأسرار، وتجنّب تعريض RTSP مباشرةً للإنترنت.
CasaOS هو مضيف الحاوية، وليس طبقة إعداد Frigate
يمكن لـ CasaOS تشغيل الحاوية وربط وحدات التخزين والأجهزة، بينما يتحكم ملف YAML في Frigate بسلوك NVR. إذا فُتح التطبيق لكن فشلت الكاميرات، فتحقق من سجلات وإعدادات Frigate بدلًا من إعادة تثبيت CasaOS مرارًا.
اكتشاف الكائنات وفك ترميز الفيديو مهمتا تسريع مختلفتان
يُستخدم مسرّع Coral لاستدلال اكتشاف الكائنات المدعوم، بينما يمكن لأجهزة فيديو Intel/AMD/NVIDIA تسريع فك الترميز والترميز. ولا يحل أحدهما محل الآخر تلقائيًا.
صمّم حزمة Frigate مع مراعاة كلٍّ من عبء عمل الكاشف وعبء ترميز الكاميرات وتحويلها، بدلًا من التعامل مع «تسريع الأجهزة» باعتباره خيارًا واحدًا.
اضبط مدة الاحتفاظ قبل تفعيل عدد كبير من الكاميرات
يمكن أن تملأ التسجيلات المستمرة الأقراص بسرعة. قدّر معدل البت × عدد الكاميرات × أيام الاحتفاظ، واترك مساحة احتياطية لنظام الملفات، وحدد الأحداث التي تحتاج إلى احتفاظ طويل مقابل التسجيلات الدورية.
تحقق من سجلات Frigate وحالته بعد التشغيل الأول
قبل إضافة كل الكاميرات، اختبر بثًا واحدًا، وتأكد من التعرّف على الكاشف أو الجهاز، وراجع سجلات الحاوية بحثًا عن أخطاء الذاكرة المشتركة أو FFmpeg أو الأذونات. إن توسيع الإعداد انطلاقًا من كاميرا واحدة تعمل جيدًا أسهل من تصحيح خمسة أعطال متزامنة.
الأسئلة الشائعة حول Frigate على CasaOS
هل يحتوي منشور المجتمع الأصلي على ملف Frigate Compose الكامل؟
لا. فهو يشير أساسًا إلى برنامج تعليمي خارجي من عام 2023.
هل Google Coral إلزامي في Frigate الحالي؟
لا. يظل Coral أحد الخيارات المدعومة، لكن Frigate الحالي يدعم مسارات أخرى للأجهزة بحسب المضيف.
ما الذي ينبغي أن يكون دائمًا؟
على الأقل، إعداد Frigate ووحدة تخزين الوسائط والتسجيلات التي تريد الاحتفاظ بها.
