HomeAssistant(HA) 2025.12.2 이상 버전에서 하이크비전(Hikvision) 카메라를 연결하는 가장 좋은 방법은 사실 이름에 Hikvision이 들어간 예전 통합(주로 알람 상태만 볼 수 있고 화면은 볼 수 없음)이 아니라 ONVIF 프로토콜을 사용하는 것입니다.
쉽게 설명하면:ONVIF를 카메라 세계의 표준어라고 생각하면 됩니다. 하이크비전에는 자체 방언(전용 프로토콜)이 있어 HomeAssistant가 완전히 알아듣지 못할 수 있습니다. 하지만 카메라가 표준어를 쓰게 하면(ONVIF 활성화) HomeAssistant가 즉시 알아듣습니다. 화면을 바로 볼 수 있을 뿐 아니라 카메라에 설정한 동작 감지 알람도 자동으로 찾아냅니다.
아래는 2025.12.2 버전에 기반한 자세한 초보자 튜토리얼입니다. 가장 중요한 단계는 사실 카메라 쪽에 있으니 1단계를 꼭 주의 깊게 보세요.
1단계: 하이크비전 카메라 관리 화면에서 표준어 자격증 따기 (ONVIF 활성화)
많은 초보자가 여기서 막힙니다. 하이크비전은 기본적으로 ONVIF가 꺼져 있고, 게다가 ONVIF 계정과 비밀번호는 카메라 로그인 계정과 비밀번호와 별개입니다.
- 컴퓨터 브라우저로 카메라 로그인: 브라우저 주소창에 카메라 IP 주소(예: 192.168.1.64)를 입력하고 관리자 계정과 비밀번호로 로그인합니다.
- 설정 진입점 찾기: 상단 메뉴의 구성(Configuration) -> 왼쪽 메뉴 네트워크(Network) -> 고급 설정(Advanced Settings) -> 통합 프로토콜(Integration Protocol) 을 클릭합니다.
- ONVIF 활성화:
- ONVIF 활성화(Enable ONVIF)를 체크합니다.
- 핵심 포인트: 아래의 추가(Add) 버튼을 클릭해 HA 전용 ONVIF 사용자를 만듭니다.
- 사용자 이름: ha_admin 을 권장합니다(카메라 로그인 계정 admin 과 혼동하지 마세요).
- 비밀번호: 나만 아는 비밀번호를 설정합니다(영문과 숫자 조합을 권장하고 너무 복잡한 기호는 피하세요).
- 권한: 사용자 유형이라고도 하며, 관리자(Media User/Operator/Admin)를 선택합니다. 권한 부족을 피하려면 관리자를 권장합니다.
확인 을 클릭해 저장합니다.
시간 동기화(실수 방지):시스템(System) -> 시스템 설정(System Settings) -> 시간 설정(Time Settings) 으로 이동합니다. 카메라 시간이 HA 시간과 일치하는지 확인하세요(가능하면 둘 다 NTP를 켜세요). 시간이 맞지 않으면 인증에 실패합니다.
2단계: HomeAssistant에서 카메라 등록하기
1단계를 마치면 카메라가 표준어를 할 수 있게 되었습니다. 이제 HA로 돌아가 추가합니다.
통합 페이지 열기:HA 왼쪽 메뉴에서 설정(Settings) -> 장치 및 서비스(Devices & Services)를 클릭합니다.
통합 추가:오른쪽 아래의 + 통합 추가(+ ADD INTEGRATION) 버튼을 클릭합니다.
ONVIF 검색:검색 상자에 ONVIF 를 입력하고 나타나는 아이콘을 클릭합니다.
정보 입력:이때 대화 상자가 나타납니다. 운이 좋으면 HA가 카메라를 자동으로 찾았으므로 제출만 누르면 됩니다. 자동으로 찾지 못했다면 직접 입력하세요:
호스트(Host): 카메라 IP 주소(예: 192.168.1.64)를 입력합니다.
포트(Port): 기본값은 80입니다. 작동하지 않고 따로 바꾼 적이 없다면 일부 구형 하이크비전 기종은 8000이나 8080일 수 있지만, 대부분은 비워 두거나 80을 입력합니다.
이름(Name): 카메라에 이름을 붙입니다. 예를 들어 대문 이라고 합니다.
사용자 이름:
주의!
여기에는 1단계에서 따로 만든 ONVIF 사용자 이름(예: ha_admin)을 입력합니다. 카메라 로그인용 admin 이 아닙니다.
비밀번호: 1단계에서 설정한 ONVIF 비밀번호입니다.
완료:제출을 클릭합니다. 오류가 없으면 HA가 발견한 장치(메인 스트림, 서브 스트림, 각종 센서)를 방에 배정하라고 합니다. 그대로 완료를 클릭하면 됩니다.
3단계: 화면을 대시보드에 올리기
- HA의 개요(Overview) 페이지로 돌아갑니다.
- 오른쪽 위의 연필 아이콘(대시보드 편집)을 클릭합니다.
- 오른쪽 아래의 + 카드 추가(Add Card)를 클릭합니다.
- 그림 개요(Picture Glance) 또는 그림 엔티티(Picture Entity)를 검색합니다.
- 엔티티(Entity) 항목에서 방금 추가한 카메라 엔티티(보통 camera.damenkou_main_stream 같은 이름)를 선택합니다.
- 이제 화면이 보일 것입니다(보통 몇 초마다 갱신되는 정지 이미지이고, 클릭하면 라이브 스트림이 나옵니다).
- 참고: 저지연 실시간 화면을 원한다면 카드 설정에서 보기 방식을 다음으로 설정하는 것을 권장합니다:
자주 발생하는 실패 상황과 응급 처치(Troubleshooting)
- 문제 A: 인증 실패 또는 연결할 수 없음 이 계속 표시됩니다.
- 원인 1: ONVIF 사용자 비밀번호가 아니라 카메라 로그인 비밀번호를 사용했습니다. 1단계를 다시 확인하세요.
- 원인 2: 하이크비전 보안 설정에서 불법 로그인 잠금 이 켜져 있습니다. 카메라 관리 화면 -> 시스템 -> 보안 -> 보안 서비스 로 가서 불법 로그인 잠금 사용 을 잠시 끄거나, 카메라를 재부팅해 잠금을 해제하세요.
- 원인 3: 인증 유형 문제입니다. 카메라 관리 화면의 통합 프로토콜 페이지에서 ONVIF 인증(ONVIF Authentication) 또는 Web 인증(Web Authentication) 옵션이 보이면 Digest/Basic 또는 Digest(Basic 호환 우선)를 선택했는지 확인하세요.
문제 B: 화면은 보이지만 매우 끊기고 지연이 십몇 초나 됩니다.
- 이것은 정상입니다. HA 기본 스트리밍에는 지연이 있습니다.
- 최적화 방법: HA 통합에서 이 장치를 찾아 기본 미리보기로 Substream(서브 스트림) 사용 을 체크하세요. 메인 스트림 4K는 화질이 너무 커서 WIFI가 감당하지 못합니다.
- 또는 카드의 스트림 미리 로드(Preload stream)를 체크합니다.
문제 C: ONVIF가 도무지 추가되지 않습니다.
- 대안: Generic Camera(범용 카메라) 통합을 사용합니다.
- 통합을 추가할 때 Generic Camera 를 검색합니다.
- 정지 이미지 URL: http://admin:비밀번호@IP주소:80/ISAPI/Streaming/channels/101/picture
- 스트리밍 소스 URL(RTSP): rtsp://admin:비밀번호@IP주소:554/Streaming/Channels/101
- (참고: 여기서는 카메라 로그인에 쓰는 admin 과 비밀번호를 사용하며, ONVIF 것이 아닙니다.)
이 튜토리얼대로 하면 99%의 하이크비전 카메라가 5분 안에 Home Assistant 2025.12에 연결됩니다. 성공을 빕니다!
