يمكن تشغيل Agent DVR على ZimaOS كتطبيق Docker مخصص. الإعداد المنظّم هو استخدام صورة Docker الحالية لـ Agent DVR، وربط الإعدادات والتسجيلات بوحدة تخزين ZimaOS دائمة، وإتاحة واجهة الويب على المنفذ 8090، وإضافة منافذ TURN/WebRTC عبر UDP فقط عندما يتطلب سير عمل الكاميرا/العميل ذلك.
تمكّن المستخدم الأصلي من استيراد أمر Docker الخاص بالمورّد، لكنه اضطر إلى إنشاء مجلدات AppData يدويًا. وتوضح وثائق حاوية Agent DVR الحالية الآن المسارات الدائمة المطلوبة وعمليات ربط أجهزة GPU بشكل أكثر وضوحًا.


استخدم حاوية Agent DVR الحالية
يوثّق دليل Agent DVR لـ Docker التخطيط المُدار لحاوية Docker ونطاق منافذ WebRTC الحالي.
أنشئ مجلدات ZimaOS الدائمة
/DATA/AppData/agentdvr/config
/DATA/AppData/agentdvr/media
/DATA/AppData/agentdvr/models
/DATA/AppData/agentdvr/commands
نفّذ ذلك قبل استيراد التطبيق حتى لا تكتب الحاوية الإعدادات المهمة في مساحة تخزين مؤقتة.
استخدم تخطيط وحدات التخزين الحالي
/DATA/AppData/agentdvr/config:/AgentDVR/Media/XML
/DATA/AppData/agentdvr/media:/AgentDVR/Media/WebServerRoot/Media
/DATA/AppData/agentdvr/models:/AgentDVR/Media/Models
/DATA/AppData/agentdvr/commands:/AgentDVR/Commands
أتح واجهة الويب على المنفذ 8090
افتح http://ZIMA-IP:8090 بعد بدء الحاوية. إذا لم تظهر الواجهة، فتحقّق من سجلات الحاوية قبل تغيير إعدادات الكاميرا.
افهم منافذ UDP
يستخدم دليل حاوية Agent DVR الحالي منفذ UDP 3478، بالإضافة إلى المنافذ 50000–50100 لـ TURN/WebRTC. إذا كان استخدامك محليًا بحتًا وتعمل الواجهة دون WebRTC عن بُعد، فتجنّب إتاحة منافذ أكثر من اللازم.
أضف الكاميرات بعد التأكد من سلامة الحاوية
ابدأ بكاميرا واحدة، وتحقّق من العرض المباشر ومسار التسجيل، ثم أضف مزيدًا من الأجهزة. يسهّل ذلك عزل مشكلات الترميز وبيانات الاعتماد والاكتشاف والتخزين.
اربط أجهزة GPU عند الحاجة فقط
يستخدم تسريع الأجهزة على Intel/AMD عادةً /dev/dri. وتتطلب NVIDIA وقت تشغيل وأدوات NVIDIA على المضيف. تحقّق أولًا من عمل فك الترميز البرمجي قبل تعقيد الحاوية بتمرير GPU.
تحقّق من أذونات AppData والتسجيلات
تدعم الحاوية الحالية PUID/PGID. طابق هذه القيم مع مالك أدلة ZimaOS لتجنّب جعل ملفات XML/الإعدادات للقراءة فقط أو فشل التسجيلات.
انسخ ملفات XML احتياطيًا قبل التحديث
يخزّن Agent DVR الإعدادات المهمة ضمن دليل XML الخاص به. أنشئ نسخة احتياطية منه قبل تغيير وسوم الصور أو الترقية إلى إصدارات رئيسية.
يوفّر دليل التطبيقات المخصصة سير العمل العام في ZimaOS.
الأسئلة الشائعة
ما منفذ واجهة الويب لـ Agent DVR؟
المنفذ 8090 افتراضيًا في أمثلة الحاوية الحالية.
أين تُخزّن التسجيلات؟
اربط /AgentDVR/Media/WebServerRoot/Media بمجلد دائم على المضيف.
هل أحتاج إلى جميع منافذ TURN/WebRTC؟
ليس في كل إعداد محلي فقط. أضفها فقط للميزات التي تتطلب هذه المسارات.
هل يمكن لـ Agent DVR استخدام تسريع GPU على Intel أو AMD؟
نعم، عند إعداد أجهزة /dev/dri المطلوبة وإعدادات التطبيق بشكل صحيح.
