ZimaOS에서는 보관 처리된 기존 kerberos/kerberos 이미지가 아니라 최신 Kerberos Agent 컨테이너를 사용하세요. 최신 프로젝트는 kerberos/agent를 사용하고 AMD64 Docker를 지원하며, 카메라당 Agent 인스턴스 하나를 사용하도록 설계되었습니다.
녹화 파일을 Synology NAS에 저장하려면 먼저 ZimaOS에 Synology 공유 폴더를 안정적으로 마운트하고, 실제 호스트 마운트 경로를 확인한 다음 해당 경로를 Agent 녹화 디렉터리에 바인드 마운트하세요. NAS가 다시 연결될 때마다 사라지는 네트워크 경로를 Kerberos에 지정하지 마세요.
기존 Kerberos Docker 저장소는 보관 처리되었습니다
기존 Kerberos Open Source 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 볼륨의 녹화 디렉터리에 용량 제한이 없다고 가정하지 마세요.
자주 묻는 질문
지금은 어떤 Kerberos 이미지를 사용해야 하나요?
현재는 kerberos/agent 이미지를 사용하세요. 이전 kerberos/kerberos 프로젝트는 보관 처리되었습니다.
Synology에 녹화 파일을 저장할 수 있나요?
네. Synology 공유 폴더가 ZimaOS 호스트에 안정적으로 마운트되어 있고, 해당 호스트 경로가 Agent 녹화 디렉터리에 바인드 마운트되어 있다면 가능합니다.
컨테이너 하나로 여러 대의 카메라를 관리할 수 있나요?
현재 Agent 모델은 카메라당 Agent 인스턴스 하나를 사용하는 방식으로 설계되었습니다.
Agent UI는 어떤 포트를 사용하나요?
컨테이너는 80 포트에서 수신 대기합니다. 이를 8080과 같은 사용 가능한 ZimaOS 호스트 포트에 매핑하세요.
