Agent DVR은 ZimaOS에서 사용자 지정 Docker 앱으로 실행할 수 있습니다. 깔끔하게 설정하려면 최신 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/Commands8090 포트에서 웹 UI 공개하기
컨테이너가 시작된 후 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 장치와 애플리케이션 설정이 올바르게 구성되어 있으면 가능합니다.
