재시작 후 Immich에서 검색 가능한 비공개 사진이 더 이상 표시되지 않는 이유는 무엇인가요?

Immich는 일반적으로 재시작 후 검색 가능한 비공개 사진을 더 이상 반환하지 않습니다. Smart Search가 머신러닝 경로를 잃었거나, 모델 준비가 아직 끝나지 않았거나, 검색 임베딩을 생성하는 작업과 스토리지 읽기를 완료하지 못했기 때문입니다.

타임라인에 원본이 계속 표시된다면 사진이 사라진 것이 아니라 검색 계층이 완전하지 않은 것일 가능성이 큽니다. 빈 결과가 나오면 먼저 서비스 경로 문제로 간주하고 데이터베이스와 업로드 라이브러리를 보존한 다음, 무엇이 문제인지 구분하세요. 머신러닝 컨테이너를 사용할 수 없는지, 작업이 지연되고 있는지, 엔드포인트가 일치하지 않는지, 영구 경로 권한에 문제가 있는지 확인하기 전에는 아무것도 재구성하지 마세요.

검색 결과 누락과 사진 누락 구분하기

검색을 테스트하기 전에 타임라인, 앨범, 비공개 라이브러리에서 알려진 자산 몇 개를 직접 열어 보세요. 통과하면 데이터베이스가 레코드를 찾을 수 있고 Immich가 파일을 읽을 수 있다는 뜻입니다. 실패하면 더 광범위한 라이브러리 또는 스토리지 장애이므로 검색 관련 변경을 중단하고 영향을 받은 경로를 보호하세요.

반복 가능한 검색을 세 가지 실행하세요. 이전에 작동했던 용어, 시각적으로 명확한 용어, 그리고 백그라운드 작업이 완료되었어야 하는 최근 업로드 자산을 검색합니다. 결과가 비어 있는지, 오래된 결과인지, 이전 사진으로만 제한되는지 기록하세요. 이러한 결과를 통해 전체 엔드포인트 장애와 인덱싱 대기열을 구분할 수 있습니다.

커뮤니티 문제 해결 스레드에는 재시작과 관련된 Smart Search 점검 항목이 정리되어 있으며, 엔드포인트 연결 가능 여부와 작업 재실행도 포함되어 있습니다. 해당 검색 계층 진단 절차를 사례 증거로 활용하되, 데이터베이스를 삭제하거나 모든 자산을 다시 생성하는 근거로 사용하지는 마세요.

재시작 후 머신러닝 경로 확인하기

서버와 머신러닝 컨테이너의 상태를 확인한 다음, 이를 호출하는 네트워크 네임스페이스에서 설정된 머신러닝 URL을 테스트하세요. 연결 가능한 엔드포인트에서 모델 요청이 성공하면 이 분기를 통과한 것입니다. 연결 거부, 이름 확인 실패 또는 비정상 컨테이너가 발생하면 복구해야 할 서비스 경로가 드러난 것입니다.

배포된 서비스 이름, 포트, 환경 변수 값, 이미지 버전, 네트워크 소속을 마지막으로 정상 작동했던 Compose 정의와 비교하세요. 불일치를 수정한 후 영향을 받은 컨테이너만 다시 생성하세요. 단순히 재시작한다고 오래된 컨테이너 환경이 교체되지는 않으므로, 다시 생성된 워크로드에서 실제 적용된 값을 확인하세요.

보고된 Immich v2.6.1 사례에서는 비정상 머신러닝 컨테이너가 Smart Search 실패의 원인으로 확인되었습니다. 이 버전별 장애 보고서는 상태와 로그를 확인해야 한다는 점을 뒷받침하지만, 모든 재시작 후 장애가 해당 회귀 문제라는 뜻은 아닙니다.

모델 준비 상태, 작업, 영구 경로 확인하기

알려진 검색 하나를 전송하면서 머신러닝 로그를 확인하세요. 첫 요청에서 모델을 로드하거나 다운로드하느라 일시적으로 메모리 사용량이 증가할 수 있습니다. 진행 상황이 나타난 뒤 응답이 성공하면 통과입니다. 반복적인 축출, 메모리 부족 종료 또는 다운로드 실패가 발생하면 메모리, 캐시 영속성 또는 네트워크를 복구해야 합니다.

Smart Search 작업 수와 최근 실패 항목을 확인하되 삭제하지는 마세요. 엔드포인트는 정상인데 작업이 계속 실패하거나 대기 중이라면, 소규모의 통제된 배치를 재시도하고 작업 수가 줄어드는지 관찰하세요. 자산 하나가 성공한다면 전체 재인덱싱을 예약하기 전에 워커 동시성 또는 실패한 종속 항목을 복구하세요.

데이터베이스, 업로드 라이브러리, 모델 캐시가 예상되는 영구 경로에 마운트되어 있고 올바른 사용자 및 그룹 ID를 사용하는지 확인하세요. 관련 ZimaSpace 가이드인 Immich 인식 동작은 원본이 사라진 경우와 접근 권한 및 인덱싱 범위 문제를 구분하는 데 도움이 됩니다.

Featured

ZimaCube 2 개인용 클라우드 홈 NAS

ZimaCube2

$799.00 - $2,499.00

Buy Now

원인에 맞는 수정 적용 후 두 번 재시작하여 재테스트하기

확인된 원인만 수정하세요. 엔드포인트 이름을 복구하고, 올바른 환경으로 컨테이너를 다시 생성하고, 모델 캐시를 영속화하고, 측정된 동시성을 낮추고, 소유권을 수정하거나, 실패한 Smart Search 작업을 재시도합니다. 이전 Compose 파일과 데이터베이스 백업을 바로 사용할 수 있게 보관하고, 첫 대응으로 임베딩을 삭제하지 마세요.

동일한 세 가지 검색어, 오래된 자산 하나, 새 업로드 하나를 다시 테스트하세요. 통과하려면 유용한 결과가 나오고, 작업 대기열이 줄어들며, 원본을 읽을 수 있고, 머신러닝 상태가 안정적이어야 합니다. 정상적인 종속 순서로 스택을 재시작한 뒤 다시 테스트하고, 마운트와 이름 확인이 부팅 후에도 유지되는지 확인하기 위해 호스트도 한 번 재시작하세요.

결과가 줄어들거나, 원본을 읽을 수 없게 되거나, 데이터베이스에서 일관성 오류가 보고되면 롤백하세요. 두 번 재시작한 후에도 같은 장애가 다시 발생하면 Immich 버전, 실제 적용된 엔드포인트, 컨테이너 상태, 관련 로그, 작업 수, 모델 이름, 마운트 매핑을 포함해 에스컬레이션하세요. 이전의 검색 가능한 인스턴스는 격리하되 복구 가능한 상태로 유지하세요.