ZimaOS MotionEye 패키지가 오래된 빌드에 멈춰 있다면, 일반적인 컨테이너 자동 업데이트 도구가 주요 MotionEye 버전을 변경 사항 확인 없이 건너뛰어 업데이트할 것이라고 기대하지 마세요. 구성 및 녹화 영상을 백업하고 실행 중인 이미지를 확인한 다음, 버전과 마이그레이션 변경 사항을 검토하고 관리되는 MotionEye 이미지로 전환하세요.
MotionEye 0.44.0은 보안상 중요한 릴리스입니다. 인증 방식이 변경되고 여러 취약점이 수정되었으며, 원격 MotionEye 인스턴스 간 인증 방식도 바뀌었기 때문에 이 점이 더욱 중요합니다.
실행 중인 버전 및 이미지 확인
docker ps --format 'table {.Names} {.Image}' | grep -i motioneye
docker logs --tail 100 motioneye앱 스토어에 표시된 버전과 실제 실행 중인 이미지 버전이 같다고 가정하지 마세요.
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 인증 방식이 변경되었습니다. 업그레이드 후 원격 카메라가 작동을 멈추면 롤백하기 전에 새로운 공유 비밀/자격 증명 처리 방식을 확인하세요.
설정의 롤백용 사본 보관
첫 업그레이드를 시도할 때 현재 작동 중인 유일한 설정을 덮어쓰지 마세요. 마이그레이션에 문제가 생기면 이전 컨테이너와 설정을 복원할 수 있도록 설정 디렉터리를 날짜와 시간이 표시된 사본으로 보관하세요.
자주 묻는 질문
현재 MotionEye 릴리스는 무엇인가요?
업스트림에서는 0.44.0을 최신 릴리스로 안내하고 있습니다.
이미지 태그만 바꾸면 되나요?
데이터를 백업하고 릴리스 노트를 읽은 뒤에만 진행하세요. 특히 0.44.0에서는 인증 동작이 변경됩니다.
Tugtainer가 모든 업그레이드를 안전하게 처리하나요?
아니요. 이미지 업데이트는 자동화할 수 있지만, 애플리케이션 수준의 호환성을 깨는 마이그레이션이 유효한지는 확인할 수 없습니다.
이전 버전이 아직 작동하는데 왜 업데이트해야 하나요?
0.44.0에는 보안 수정 사항이 포함되어 있으므로, 취약한 이전 버전을 계속 사용하면 피할 수 있는 위험을 감수하게 됩니다.
