원본 스레드는 완전한 Frigate 배포 기록이 아니라, 외부의 2023년 튜토리얼을 소개하는 내용입니다. 튜토리얼에서 CasaOS에 Frigate를 설치하고 카메라를 Google Coral과 통합한다고 설명하지만, 당시 사용된 Docker 이미지, 볼륨, 포트, 공유 메모리 크기 또는 디텍터 구성은 보존되어 있지 않습니다.
현재 설정에서는 Frigate의 공식 유지 관리 문서를 기술 기준으로 삼아야 합니다. Docker Compose는 여전히 권장 설치 방법이며, Google Coral은 여러 가능한 디텍터 및 비디오 처리 경로 중 하나일 뿐입니다.
현재 Frigate는 Docker Compose를 권장합니다
Frigate의 최신 설치 가이드는 ghcr.io/blakeblackshear/frigate:stable, 영구 구성 및 미디어 저장소, 명시적인 공유 메모리 크기, 선택한 가속기에 맞는 디바이스 매핑을 사용합니다.
2023년 영상을 그대로 따라 하기보다 현재 Frigate 설치 모델을 사용하세요.
컨테이너 외부에 /config를 영구 저장하세요
Frigate의 YAML 구성은 /config에 매핑된 호스트 폴더에 있어야 합니다. 컨테이너를 다시 생성해도 카메라, 디텍터, 녹화, 영역 및 스냅샷 설정이 삭제되지 않도록 CasaOS의 영구 저장소에 보관하세요.
녹화 및 클립을 실제 저장소에 매핑하세요
NVR 비디오는 일반적인 AppData보다 훨씬 빠르게 증가할 수 있습니다. 녹화, 클립 및 내보낸 파일은 용량이 충분한 저장소 볼륨에 저장하고, 작은 운영 체제 디스크에는 저장하지 마세요.
공유 메모리는 카메라 작업량에 맞아야 합니다
Frigate는 비디오 처리에 공유 메모리를 사용합니다. 현재 Compose 예시에는 명시적인 shm_size가 포함되어 있으며, 적절한 값은 카메라의 해상도와 수에 따라 달라집니다.
Google Coral은 선택 사항이며 보편적인 필수 조건이 아닙니다
2023년 원본은 Google Coral을 강조했습니다. 현재 Frigate도 USB 및 PCIe Coral 매핑을 문서화하고 있지만, 최신 배포에서는 하드웨어에 따라 Intel/AMD 비디오 가속, Intel NPU 또는 기타 지원되는 디텍터 경로를 사용할 수도 있습니다.
하드웨어 가속에는 올바른 디바이스 매핑이 필요합니다
현재 예시에는 USB Coral용 /dev/bus/usb, PCIe Coral용 /dev/apex_0, Intel/AMD 그래픽용 /dev/dri/renderD128, 지원되는 Intel NPU 경로용 /dev/accel이 포함되어 있습니다. Frigate에 실제로 필요한 하드웨어만 권한을 부여하세요.
권한 모드는 항상 필요하지 않습니다
Frigate의 현재 Compose 예시에서는 모든 설정에 privileged: true가 필요하지 않을 수 있다고 설명합니다. 명시적인 디바이스 매핑과 권한만으로 충분하다면 최소 권한 원칙을 따르는 것이 좋습니다.
카메라 자격 증명과 RTSP 엔드포인트를 비공개로 유지하세요
Frigate 구성에는 일반적으로 카메라 사용자 이름, 비밀번호 및 RTSP URL이 포함됩니다. 비밀 정보를 가리지 않은 전체 구성 파일이나 스크린샷을 공개하지 말고, RTSP를 인터넷에 직접 노출하지 마세요.
CasaOS는 컨테이너 호스트이며 Frigate 구성 계층이 아닙니다
CasaOS는 컨테이너를 실행하고 저장소와 디바이스를 매핑할 수 있으며, Frigate의 YAML은 NVR 동작을 제어합니다. 앱은 열리지만 카메라가 작동하지 않는다면 CasaOS를 반복해서 재설치하기보다 Frigate 로그와 구성을 확인하세요.
객체 감지와 비디오 디코딩은 서로 다른 가속 작업입니다
Coral 가속기는 지원되는 객체 감지 추론에 사용되며, Intel/AMD/NVIDIA 비디오 하드웨어는 디코딩과 인코딩을 가속할 수 있습니다. 어느 하나가 자동으로 다른 하나를 대체하지는 않습니다.
“하드웨어 가속”을 하나의 확인란처럼 취급하지 말고, 디텍터 작업량과 카메라 코덱 및 트랜스코딩 작업량을 모두 고려해 Frigate 스택을 설계하세요.
여러 카메라를 활성화하기 전에 보존 기간을 설정하세요
연속 녹화는 디스크를 빠르게 가득 채울 수 있습니다. 비트레이트 × 카메라 수 × 보존 일수로 필요한 용량을 추정하고, 파일 시스템 여유 공간을 남겨 두며, 어떤 이벤트를 장기간 보존할지와 순환 녹화로 처리할 영상을 결정하세요.
처음 시작한 후 Frigate 로그와 상태를 확인하세요
모든 카메라를 추가하기 전에 스트림 하나를 검증하고, 디텍터와 디바이스가 인식되는지 확인하며, 공유 메모리, FFmpeg 또는 권한 오류가 있는지 컨테이너 로그를 검토하세요. 동시에 발생한 다섯 가지 문제를 디버깅하는 것보다 정상 작동이 확인된 카메라 하나를 확장하는 편이 쉽습니다.
CasaOS에서 Frigate 사용하기 FAQ
원본 Community 게시물에 전체 Frigate Compose 파일이 포함되어 있나요?
아니요. 주로 외부의 2023년 튜토리얼을 안내합니다.
현재 Frigate에 Google Coral이 필수인가요?
아니요. Coral은 지원되는 옵션 중 하나이며, 현재 Frigate는 호스트에 따라 다른 하드웨어 경로도 지원합니다.
항상 영구 저장해야 하는 것은 무엇인가요?
최소한 Frigate 구성과 보존하려는 미디어 및 녹화 저장소는 영구 저장해야 합니다.
