spupuz/VibeNVR

어떤 프로젝트인가요?

핵심 기능

• 01RTSP IP 카메라를 상시 녹화하거나 모션 감지 시 녹화합니다.
• 02OpenCV, ONVIF 엣지 감지, Hikvision ISAPI 또는 YOLOv8 같은 AI 모델을 통한 모션 감지.
• 03카메라, 이벤트 유형, 객체, 날짜별 필터를 제공하는 이벤트 타임라인.
• 04PTZ 제어와 함께 WebCodecs, MSE 또는 MJPEG를 통한 라이브 뷰.
• 05자동 정리, 할당량, 아카이빙을 지원하는 로컬 또는 SFTP 저장소.
• 06카메라별 RBAC 권한, JWT 로그인, SSO, 2FA.
• 07Home Assistant 검색 기능을 지원하는 MQTT 서비스.

활용 사례

• 로컬 녹화를 지원하는 Raspberry Pi 또는 미니 PC에서 홈 보안 시스템 운영.
• 클라우드 카메라 구독을 셀프 호스팅 저장소로 대체.
• 페더레이션을 통해 하나의 마스터 인스턴스에서 여러 사이트 모니터링.
• 카메라의 모션 및 객체 이벤트를 Home Assistant 자동화에 연동.

빠른 시작

1. 1

   Docker와 Docker Compose V2를 설치합니다

2. 2

   저장소를 클론합니다

   git clone https://github.com/spupuz/VibeNVR.git
3. 3

   프로젝트 디렉터리로 이동하고 .env에 안전한 값을 설정합니다

   cd VibeNVR
4. 4

   프로덕션용 compose 파일로 서비스를 시작합니다

   docker compose -f docker-compose.prod.yml up -d

사용 전 알아둘 점

• !Docker와 Docker Compose가 필요하므로 설정하려면 컨테이너 관련 지식이 필요합니다.
• !vibe coding 프로젝트로 표시되어 있으므로 안정성 관련 주의사항을 염두에 두고 업데이트 전에 릴리스 노트를 확인하세요.
• !하드웨어 가속 및 AI 감지 기능은 호스트 하드웨어에 따라 달라집니다.

토픽

자주 묻는 질문

VibeNVR은(는) 무엇인가요?

IP 카메라용 셀프 호스팅 Docker 기반 NVR로 로컬 녹화, 모션·AI 객체 감지와 이벤트 타임라인을 제공합니다. VibeNVR은 IP 카메라를 관리하는 컨테이너 기반 네트워크 비디오 레코더입니다. PyAV와 FFmpeg를 기반으로 직접 구축한 Python 엔진으로 RTSP 스트림을 수신하고, 상시 또는 모션 감지 시 녹화합니다. 카메라, 이벤트 유형, 감지된 객체, 날짜별 필터를 제공하는 통합 이벤트 타임라인에서 녹화 영상과 스냅샷을 확인할 수 있습니다.

VibeNVR은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?

VibeNVR은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.

VibeNVR은(는) 아직 유지보수되고 있나요?

활발히 유지보수 중. VibeNVR의 마지막 커밋은 2026년 10월 19일입니다.

VibeNVR은(는) 어디에 사용할 수 있나요?

로컬 녹화를 지원하는 Raspberry Pi 또는 미니 PC에서 홈 보안 시스템 운영. 클라우드 카메라 구독을 셀프 호스팅 저장소로 대체. 페더레이션을 통해 하나의 마스터 인스턴스에서 여러 사이트 모니터링. 카메라의 모션 및 객체 이벤트를 Home Assistant 자동화에 연동.

VibeNVR는 어떻게 설치하나요?

Docker와 Docker Compose V2를 설치합니다 저장소를 클론합니다: git clone https://github.com/spupuz/VibeNVR.git 프로젝트 디렉터리로 이동하고 .env에 안전한 값을 설정합니다: cd VibeNVR 프로덕션용 compose 파일로 서비스를 시작합니다: docker compose -f docker-compose.prod.yml up -d

VibeNVR은(는) 어디서 받을 수 있나요?

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/spupuz/VibeNVR