ZimaOS MotionEye 패키지가 오래된 빌드에서 멈춰 있다면, 일반적인 컨테이너 자동 업데이트 도구에 의존해 MotionEye 메이저 버전을 무작정 올리지 마세요. 구성을 백업하고 녹화 파일을 보존한 뒤, 현재 실행 중인 이미지를 확인하고 버전 및 마이그레이션 변경 사항을 검토한 후 유지 관리되는 MotionEye 이미지로 전환하세요.
이는 MotionEye 0.44.0이 보안 측면에서 중요한 릴리스이기 때문에 더욱 중요합니다. 이 버전은 인증 방식을 변경하고 여러 취약점을 패치했으며, 원격 MotionEye 인스턴스 간 인증 방식도 변경했습니다.
실행 중인 버전 및 이미지 확인
docker ps --format 'table {.Names} {.Image}' | grep -i motioneye
docker logs --tail 100 motioneyeApp Store 카드에 표시된 버전과 실제 실행 중인 이미지가 동일하다고 가정하지 마세요.
MotionEye 0.44.0은 현재 보안 기준선입니다
현재 MotionEye 릴리스 페이지에는 0.44.0이 최신 릴리스로 표시되어 있으며, 인증 강화와 보안 권고에 대한 수정 사항이 포함되어 있습니다.
먼저 구성과 동영상을 백업하세요
MotionEye 구성 및 미디어에 매핑된 호스트 경로를 기록하세요. 컨테이너 이미지를 교체하기 전에 해당 디렉터리를 복사하세요.
유지 관리되는 GHCR 이미지 사용
업스트림 프로젝트는 이제 ghcr.io/motioneye-project/motioneye에서 멀티 아키텍처 이미지를 게시합니다. 오래되어 방치된 이미지나 변동되는 개발 태그보다 0.44.0과 같은 고정된 안정 태그를 우선 사용하세요.
릴리스 노트를 읽지 않고 자동 업데이트하지 마세요
MotionEye 0.44.0은 원격 MotionEye 인증 방식을 변경하며, 이전 배포에서는 허용되었을 수 있는 빈 자격 증명 대신 비밀번호를 요구합니다. 따라서 자동 컨테이너 풀은 성공적으로 실행되더라도 원격 카메라의 연결이 중단될 수 있습니다.
Tugtainer만으로는 충분하지 않은 이유
포럼 답변에서는 컨테이너 업데이트를 위해 Tugtainer를 추천했습니다. 컨테이너 업데이트 도구는 이미지를 가져와 재배포할 수 있지만, 기존 볼륨 구조, 자격 증명, 원격 카메라 비밀 값 또는 호환성을 깨뜨리는 변경 사항이 서로 호환되는지는 판단할 수 없습니다.
업그레이드 후 카메라 확인
로컬 카메라, 원격 MotionEye 카메라, 녹화 경로, 알림 및 필요한 Telegram 연동을 확인하세요. 8765 포트의 UI가 정상적으로 표시되는지 확인하고 인증 또는 카메라 오류가 있는지 로그를 살펴보세요.
MotionEye를 인터넷에 직접 노출하지 마세요
보안 업데이트를 적용한 후에도 관리 UI는 포트 포워딩으로 직접 노출하기보다 사설 네트워크, VPN 또는 인증된 HTTPS 경로 뒤에 두세요.
사용자 지정 Docker 가이드에서 ZimaOS 컨테이너 작업 흐름을 확인할 수 있습니다.
이미지 아키텍처 확인
ZimaOS 호스트 아키텍처에 맞는 이미지를 사용하세요. 현재 업스트림 컨테이너 레지스트리는 여러 Linux 아키텍처를 지원하므로 amd64 지원을 위해 오래된 이미지를 다시 빌드할 이유가 없습니다.
0.44.0 이후 인증 변경에 대비
MotionEye 0.44.0은 더 강력한 자격 증명 동작을 요구하며 원격 MotionEye 인증 방식을 변경했습니다. 업그레이드 후 원격 카메라가 중단되면 롤백하기 전에 새로운 공유 비밀 값 및 자격 증명 흐름을 확인하세요.
구성 롤백 복사본 보관
첫 번째 업그레이드 시도 중 유일하게 작동하는 구성을 덮어쓰지 마세요. 마이그레이션으로 문제가 발생할 경우 이전 컨테이너와 설정을 복원할 수 있도록 구성 디렉터리의 타임스탬프가 포함된 복사본을 보관하세요.
FAQ
현재 MotionEye 릴리스는 무엇인가요?
업스트림에는 0.44.0이 최신 릴리스로 표시되어 있습니다.
이미지 태그만 변경하면 되나요?
데이터를 백업하고 릴리스 노트를 읽은 후에만 변경하세요. 특히 0.44.0은 인증 동작을 변경합니다.
Tugtainer가 모든 업그레이드를 안전하게 처리하나요?
아니요. 이미지 업데이트를 자동화할 수는 있지만, 애플리케이션 수준에서 호환성을 깨뜨리는 마이그레이션을 검증할 수는 없습니다.
이전 버전이 아직 작동하는데 왜 업데이트해야 하나요?
0.44.0에는 보안 수정 사항이 포함되어 있으므로, 이전의 취약한 버전을 계속 사용하면 피할 수 있는 위험에 노출됩니다.
