Immich 웹 인터페이스를 서버 및 모바일 앱과 분리하기
처음 나타난 증상은 단순한 컨테이너 충돌이 아니었습니다. Immich는 브라우저에서 열리고 탐색 메뉴도 표시했지만, 사진 라이브러리를 불러오지 못했으며 Immich 탭과 ZimaOS 탭이 모두 멈출 수 있었습니다.
여러 사용자는 Android 앱은 계속 작동하지만 Chrome, Firefox 또는 다른 브라우저에서는 문제가 발생한다고 보고했습니다. 한 작성자는 이전에 Immich를 사용한 기록이 없는 Firefox에서도 테스트했으므로, 캐시 문제만으로 모든 사례를 설명할 수는 없었습니다.
브라우저의 새 세션과 모바일 앱을 비교하고 사진에 계속 접근할 수 있는지 확인하세요. 모바일에서는 정상 작동하고 브라우저에서만 실패한다면 문제 범위를 웹 경로나 패키지된 프런트엔드로 좁힐 수 있습니다. 모든 클라이언트에서 실패한다면 서버, 데이터베이스, 저장소 및 리소스를 더 광범위하게 점검해야 합니다.
미디어 파일과 데이터베이스 상태를 별도로 보호하기
볼륨을 제거하거나 변경하기 전에 Immich가 업로드된 파일 또는 외부 라이브러리를 저장하는 위치를 확인하세요. 중요한 사진과 동영상을 다른 디스크, NAS 또는 컴퓨터에 복사한 뒤 복사본에서 일부 파일을 열어 보세요.
앨범, 사용자 및 기타 메타데이터는 데이터베이스에 의존하므로 이미지 파일 폴더만으로는 완전한 애플리케이션 백업이 되지 않습니다. 사용 가능한 데이터베이스 덤프를 미디어와 함께 보존하고 현재 볼륨 매핑과 Immich 버전을 기록하세요.
앱을 제거하는 동안 사진 저장 디렉터리를 삭제하지 마세요. 미디어 복사본이나 데이터베이스 복구 입력 자료 중 하나라도 없다면 재설치하기 전에 중단하고 백업 범위를 먼저 보완하세요.
원인이라고 단정하지 말고 리소스 부족 여부 확인하기
Immich의 머신러닝 작업은 초기 처리 중 상당한 CPU와 메모리를 사용할 수 있습니다. 한 커뮤니티 답변에서는 머신러닝을 일시적으로 비활성화하고 인터페이스가 안정되는지 확인해 보라고 제안했습니다.
다른 참여자들은 이미 머신러닝 작업을 완료했거나 충분한 성능의 하드웨어를 사용하고 있었으며, 모바일에서는 계속 탐색할 수 있었습니다. 따라서 이 주제만으로 머신러닝이 공통 브라우저 증상의 원인이었다고 입증할 수는 없습니다.
시스템 부하가 높다면 작업 하나를 일시 중지한 후 동일한 라이브러리 화면을 다시 테스트하세요. 개선되면 리소스 문제 경로를 뒷받침하는 결과입니다. 변화가 없다면 의도한 설정을 복원하고 계속 진행하세요. 효과 없이 기능을 비활성화한 상태로 두지 마세요.
재설치하기 전에 사용 가능한 ZimaOS 또는 Immich 업데이트 적용하기
여러 보고가 Immich 2.2.x에 집중되었으며, 한 사용자는 업그레이드 전에는 2.2.1이 작동했다고 말했습니다. 또 다른 참여자는 안정적인 2.1.0 설치를 사용 중이라며 롤백을 제안했지만, 해당 주제에는 롤백을 완료한 검증 사례가 기록되어 있지 않습니다.
확인된 복구 사례는 컨테이너 업데이트가 완료되기를 기다린 뒤 ZimaOS를 통해 Immich를 업데이트한 사용자에게서 나왔습니다. 재설치하거나 데이터를 복원하지 않고도 웹 인터페이스가 다시 작동했습니다.
업데이트 후 브라우저에서 같은 앨범을 다시 열고, 라이브러리를 스크롤하고, 항목을 연 다음 앱을 재시작한 뒤 다시 반복해 보세요. 성공 여부를 한 번의 페이지 로드만으로 판단하지 않도록 모바일 접근과 업로드도 계속 관찰하세요.
업데이트 경로와 백업을 확인한 후에만 재설치하기
한 사용자는 외부 라이브러리를 사용하는 상태에서 제거 후 재설치했지만 여전히 문제가 발생했습니다. 따라서 재설치는 해당 사례에서 확인된 해결 방법이 아니며 첫 단계로 시도해서는 안 됩니다.
업데이트로 해결되지 않는다면 로그를 확인하고 정확한 오류 발생 버전을 보존하세요. 검증된 미디어, 데이터베이스 백업, 볼륨 매핑 및 버전 호환 복원 지침이 있을 때만 재설치하세요.
복구가 완료되었다고 보려면 원래 작업 환경에서 앨범, 사용자, 항목, 모바일 백업 및 브라우저 라이브러리가 모두 정상적으로 작동해야 합니다. 메타데이터가 사라졌거나 서비스가 계속 멈춘다면 컨테이너를 반복해서 삭제하지 말고 중단한 뒤 이전 상태를 복원하세요.
FAQ
사진을 잃지 않고 Immich를 재설치할 수 있나요?
저장 디렉터리를 보존한 경우에만 가능합니다. 하지만 사진만 보호해서는 모든 앨범과 메타데이터가 보존되지 않습니다. 복구 가능한 데이터베이스 백업도 함께 보관하세요.
모바일에서는 Immich가 작동하는데 브라우저에서는 왜 멈추나요?
이 패턴은 문제가 발생하는 경로를 좁혀 주지만, 이 주제만으로 브라우저 측의 보편적인 단일 원인을 입증할 수는 없습니다. 확인된 사용자 복구 방법은 패키지 업데이트였습니다.
Immich를 2.1.0으로 다운그레이드해야 하나요?
한 참여자는 2.1.0이 작동한다고 보고했지만, 해당 스레드에는 롤백 성공 사례가 기록되어 있지 않습니다. 먼저 지원되는 사용 가능한 업데이트를 시도하고 복구에 필요한 자료를 보관하세요.
