Agent DVR은 사용자 지정 Docker 앱으로 ZimaOS에서 실행할 수 있습니다. 깔끔하게 설정하려면 최신 Agent DVR Docker 이미지를 사용하고, 구성 파일과 녹화 영상을 영구 ZimaOS 저장소에 매핑하며, 웹 UI를 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웹 UI를 8090 포트로 노출
컨테이너가 시작된 후 http://ZIMA-IP:8090을 여세요. UI가 표시되지 않으면 카메라 설정을 변경하기 전에 컨테이너 로그를 확인하세요.
UDP 포트 이해하기
Agent DVR의 현재 컨테이너 가이드에서는 TURN/WebRTC에 UDP 3478 및 50000–50100을 사용합니다. 사용 환경이 엄격히 로컬이고 원격 WebRTC 없이 UI가 작동한다면 필요한 것보다 많은 포트를 노출하지 마세요.
컨테이너가 정상 상태가 된 후 카메라 추가
카메라 한 대로 시작해 실시간 보기와 녹화 경로를 확인한 다음 장치를 더 추가하세요. 이렇게 하면 코덱, 자격 증명, 검색 및 저장소 문제를 더 쉽게 분리할 수 있습니다.
필요할 때만 GPU 장치 매핑
Intel/AMD 하드웨어 가속은 일반적으로 /dev/dri를 사용합니다. NVIDIA는 호스트에 NVIDIA 런타임/툴킷이 필요합니다. 먼저 소프트웨어 디코딩이 작동하는지 확인한 후 GPU 패스스루로 컨테이너를 복잡하게 구성하세요.
AppData 및 녹화 영상의 권한 확인
현재 컨테이너는 PUID/PGID를 지원합니다. 읽기 전용 XML/구성 파일 또는 녹화 실패를 방지하려면 이 값을 ZimaOS 디렉터리 소유자의 값과 일치시키세요.
업데이트 전에 XML 백업
Agent DVR은 XML 디렉터리에 중요한 구성을 저장합니다. 이미지 태그나 주요 버전을 변경하기 전에 해당 디렉터리를 백업하세요.
사용자 지정 앱 가이드에서 일반적인 ZimaOS 작업 흐름을 확인할 수 있습니다.
FAQ
Agent DVR 웹 UI의 포트는 무엇인가요?
현재 컨테이너 예시에서는 기본적으로 8090입니다.
녹화 영상은 어디에 저장되나요?
/AgentDVR/Media/WebServerRoot/Media를 영구 호스트 폴더에 매핑하세요.
모든 TURN/WebRTC 포트가 필요한가요?
모든 로컬 전용 설정에 필요한 것은 아닙니다. 해당 경로가 필요한 기능에만 추가하세요.
Agent DVR에서 Intel 또는 AMD GPU 가속을 사용할 수 있나요?
필요한 /dev/dri 장치와 애플리케이션 설정이 올바르게 구성되어 있으면 사용할 수 있습니다.
