ZimaOS에서는 오래된 보관 이미지 kerberos/kerberos가 아니라 현재 Kerberos Agent 컨테이너를 사용하세요. 현재 프로젝트는 kerberos/agent를 사용하고 AMD64 Docker를 지원하며, 카메라당 하나의 Agent 인스턴스를 기준으로 설계되었습니다.
녹화 파일을 Synology NAS에 저장하려면 먼저 ZimaOS에 Synology 공유 폴더를 안정적으로 마운트하고, 실제 호스트 마운트 경로를 확인한 다음 해당 경로를 Agent 녹화 디렉터리에 바인드 마운트하세요. NAS가 다시 연결될 때마다 사라지는 네트워크 경로를 Kerberos 대상으로 지정하지 마세요.
기존 Kerberos Docker 저장소는 보관 처리되었습니다
기존 Kerberos 오픈 소스 Docker 저장소는 이제 사용자에게 새로운 Kerberos Agent 프로젝트 저장소를 안내합니다.
현재 Agent 이미지로 시작하기
docker run -p 8080:80 --name camera1 -d --restart=always kerberos/agent:latest호스트 포트 8080을 사용하면 ZimaOS 호스트의 포트 80을 점유하지 않습니다.
구성 및 녹화 파일 유지하기
docker run -p 8080:80 --name camera1 -v /DATA/AppData/kerberos/camera1/config:/home/agent/data/config -v /DATA/AppData/kerberos/camera1/recordings:/home/agent/data/recordings -d --restart=always kerberos/agent:latest현재 Agent 문서에서는 구성과 녹화 파일에 영구 볼륨을 사용할 것을 명시적으로 권장합니다.
카메라당 하나의 Agent 사용
Kerberos Agent는 카메라 처리를 격리된 인스턴스에서 수행하도록 설계되었습니다. 여러 카메라를 사용하려면 고유한 이름, 웹 포트, 영구 디렉터리를 사용하는 별도의 컨테이너를 만드세요.
Synology를 녹화 대상으로 사용할 때 주의하기
먼저 ZimaOS에 Synology SMB/NFS 공유 폴더를 마운트하고, 재부팅 후에도 계속 마운트된 상태인지 확인한 다음 findmnt로 실제 호스트 마운트 경로를 확인하세요. 해당 안정적인 호스트 경로를 /home/agent/data/recordings에 바인드 마운트하세요.
구성을 Synology 공유 폴더에만 저장하지 마세요
ZimaOS에는 Agent 구성을 로컬로 저장하고 녹화 파일은 Synology에 저장하면 시작 안정성을 높일 수 있습니다. Synology를 일시적으로 사용할 수 없더라도 Agent가 계속 시작되어 스토리지 문제를 정상적으로 보고할 수 있습니다.
기본 로그인 정보 변경하기
현재 Kerberos Agent 문서에는 새 Agent의 기본 인증 정보가 여전히 안내되어 있습니다. 로컬 테스트를 넘어 배포에 사용하기 전에 즉시 변경하세요.
IP 카메라에는 RTSP 사용하기
일반적인 IP 카메라 사용 시 Kerberos Agent는 RTSP H264/H265 카메라 스트림을 요구합니다. 컨테이너를 의심하기 전에 스트림이 독립적으로 정상 작동하는지 확인하세요.
사용자 지정 Docker 가이드에서 일반적인 사용자 지정 앱 작업 흐름을 확인할 수 있습니다.
녹화 전에 Synology 마운트 테스트하기
findmnt
touch /path/to/synology/test-write
rm /path/to/synology/test-writeKerberos Agent에 매핑하기 전에 의도한 권한으로 ZimaOS 호스트가 마운트된 공유 폴더에 쓸 수 있는지 확인하세요. 카메라 앱으로는 내부의 SMB/NFS 권한 문제를 해결할 수 없습니다.
Synology 중단 상황에 대비하기
Synology가 재부팅되거나 네트워크 공유가 끊기면 카메라 스트림이 정상이어도 Agent 녹화가 실패할 수 있습니다. 소규모 로컬 녹화 버퍼를 사용할지, NAS 중단 중 녹화 누락을 허용할지 결정하세요.
여유 공간 및 보존 기간 관리하기
동영상은 저장 공간을 빠르게 채웁니다. 보존 기간 및 자동 정리 규칙을 신중하게 설정하고 Synology 저장 위치를 모니터링하세요. 공유 NAS 볼륨의 녹화 디렉터리에 공간 제한이 없다고 가정하지 마세요.
FAQ
현재 어떤 Kerberos 이미지를 사용해야 하나요?
현재 kerberos/agent 이미지를 사용하세요. 기존 kerberos/kerberos 프로젝트는 보관 처리되었습니다.
녹화 파일을 Synology에 저장할 수 있나요?
가능합니다. Synology 공유 폴더가 ZimaOS 호스트에 안정적으로 마운트되어 있고 해당 호스트 경로가 Agent 녹화 디렉터리에 바인드 마운트되어 있어야 합니다.
하나의 컨테이너로 여러 카메라를 관리할 수 있나요?
현재 Agent 모델은 카메라당 하나의 Agent 인스턴스를 사용하는 방식으로 설계되었습니다.
Agent UI는 어떤 포트를 사용하나요?
컨테이너는 포트 80에서 수신 대기하므로, 8080과 같이 사용 가능한 ZimaOS 호스트 포트에 매핑하세요.
