건강해 보이는 사진 타임라인은 원본, 데이터베이스, 생성된 미리보기가 모두 온전하다는 증거가 아닙니다.
셀프 호스팅 갤러리는 원본이 사라진 뒤에도 캐시된 썸네일을 계속 제공할 수 있고, 작업자가 새 파생 파일을 생성하지 못하는 동안에도 원본은 완벽하게 보존될 수 있습니다. 필수 상태와 재구축 가능한 상태를 분리하고, 앱 외부에서 원본 바이트를 검증하며, 파일과 데이터베이스 레코드를 대조하고, 격리된 복원을 테스트하기 전에 카나리 하나만 재생성하십시오. 체크섬이 변경되거나, 원본 스토리지가 불안정해지거나, 작업이 원본에 기록하면 즉시 중단하십시오.
필수 상태와 재생성 가능한 상태 정의
원본, 업로드된 동영상, 사이드카, 데이터베이스, 구성, 비밀 정보, 사용자 계정, 앨범, 편집 내용, 공유 기록을 필수 상태로 목록화하십시오. 썸네일, 트랜스코딩된 동영상, 얼굴 임베딩, 검색 인덱스는 원본과 애플리케이션 상태가 온전하게 유지되는 경우에만 재생성할 수 있는 파생 파일로 별도 목록화하십시오.
셀프 호스팅 배포에서는 일반적으로 라이브러리를 대용량 스토리지에, 데이터베이스나 작업 경로를 더 빠른 미디어에 배치합니다. 한 Immich 스토리지 구성 사례에서는 라이브러리와 핫패스 스토리지 분리를 설명합니다. 따라서 무결성 검사는 사용자가 탐색하는 폴더뿐 아니라 마운트된 모든 경로를 대상으로 해야 합니다.
애플리케이션 버전, 컨테이너 이미지, 마운트 정의, 데이터베이스 스키마 상태, 스토리지 여유 공간, 작업 큐 상태를 기록하십시오. 필수 경로가 없거나 예상치 않게 읽기 전용이면 중단하십시오. 원본 데이터가 무엇인지 확실하지 않은 상태에서는 재생성 작업을 시작해서는 안 됩니다.
갤러리와 독립적으로 원본 바이트 입증
원본에 대한 신뢰할 수 있는 체크섬 매니페스트를 생성하거나 기존 매니페스트를 사용하여 현재 트리와 읽기 전용 모드로 비교하십시오. 파일 수, 총 바이트 수, 읽을 수 없는 파일, 예상치 못한 0바이트 객체, 고아 경로를 대조하십시오. 갤러리 외부에서 JPEG, HEIC, RAW, 동영상, 오래된 연도의 파일, 최근 업로드를 포함한 층화 표본을 열어 보십시오.
표시되는 썸네일만으로 원본의 상태를 추정하지 마십시오. 갤러리는 원본이 손실된 뒤에도 캐시된 파생 파일을 계속 제공할 수 있고, 미리보기 파이프라인에 문제가 생기면 정상적인 원본도 표시되지 않을 수 있습니다. 원본과 재생성 가능한 파생 파일의 차이 때문에 직접 파일 검사가 첫 번째 안전 관문이 됩니다.
해시가 변경되거나 읽기에 실패하면 가져오기, 정리, 파생 파일 재생성을 일시 중지하십시오. 데이터베이스 레코드를 변경하기 전에 문제가 있는 스토리지를 복원하거나 이미지를 생성하십시오. 필수 원본을 읽을 수 있고, 설명되지 않은 차이에 담당자, 원인, 복구 조치가 정해졌을 때 이 단계가 통과됩니다.
레코드, 경로, 파생 파일 작업 대조
데이터베이스의 자산 레코드와 파일 시스템 경로를 양방향으로 비교하십시오. 파일이 없는 레코드와 레코드가 없는 파일을 모두 확인하십시오. 자산이 누락되었다고 판단하기 전에 UID와 GID, 바인드 마운트, 외부 라이브러리 루트, 대소문자 구분, 이름이 변경된 디렉터리를 확인하십시오. 어느 한쪽도 자동으로 삭제하지 말고 고아 목록을 보존하십시오.
그런 다음 썸네일, 미리보기, 트랜스코딩, 메타데이터 추출, 머신러닝 작업을 표본 검사하십시오. 온전한 원본과 실패한 파생 파일에 관한 독립적인 문제 해결 문서는 스토리지, 작업자, 파생 파일 경로에 문제가 있을 때 정상적으로 업로드된 파일과 회색 타일이 공존할 수 있음을 보여 줍니다.
원본과 데이터베이스 행이 일치하는 것을 확인한 후에만 카나리 파생 파일 하나를 재생성하십시오. 성공은 예상한 소유자, 경로, 클라이언트 응답을 갖춘 새 미리보기가 생성되는 것입니다. 실패하면 작업자 로그, 디코더, 출력 스토리지, 큐 상태 중 하나로 범위를 제한하십시오. 카나리가 재시작 후에도 올바르게 유지되는 것을 확인하기 전에는 전체 라이브러리 재구축을 시작하지 마십시오.
격리된 대상에 전체 라이브러리 복원
원본, 데이터베이스, 구성, 비밀 정보, 필수 사이드카를 서로 다른 포트와 경로를 사용하는 폐기 가능한 환경에 복원하십시오. 종속 서비스를 순서대로 시작하고 사용자가 존재하는지와 앨범을 확인한 다음, 표본 세트에 필요한 파생 파일 작업만 허용하십시오. 테스트 인스턴스가 운영 환경의 쓰기 가능한 스토리지를 가리키게 하지 마십시오.
로그인, 타임라인, 검색, 앨범 소속, 원본 바이트 다운로드, 편집 하나, 공유 하나, 동영상 재생을 테스트하십시오. 다운로드한 해시를 매니페스트와 비교하고, 두 번째 재시작 후에도 경로 매핑이 사라지지 않으며 필수 상태가 잘못된 소유자로 다시 생성되지 않는지 확인하십시오.
실행 중인 라이브러리와 격리된 복원이 필수 상태에서 일치하고, 카나리 파생 파일이 원본에서 재생성될 때만 무결성이 입증되었다고 선언하십시오. 데이터베이스와 파일의 불일치, 증가하는 체크섬 오류, 원본을 변경하는 작업이 발생하면 즉시 에스컬레이션하십시오. 복구가 문서화되지 않은 재가져오기로 변하지 않도록 매니페스트와 로그를 보존하십시오.
지원 및 팁
더 읽어보기

저장 장치 교체 후 NAS 공유 폴더에 이전 파일이 표시될 때: 점검 및 해결 방법
로컬 저장소를 활성 공유 및 새 클라이언트와 비교하세요. 오래된 것으로 확인된 계층만 복구한 다음, 다시 연결하고 재부팅한 후에도 결과가 유지되는지 확인하세요.

팬, 통풍구 및 열 기준선을 위한 미니 PC 냉각 유지 관리 가이드
반복 가능한 유휴 상태 및 부하 상태 측정값을 사용하세요. 먼저 외부 공기 흐름을 깨끗하게 정리하고, 팬 작동을 확인한 다음, 통제된 재테스트에서도 문제가 지속될 때만...

BIOS, 부팅 순서 및 장치를 위한 홈 서버 펌웨어 업데이트 체크리스트
버전, UEFI 항목, 스토리지 및 패스스루 상태를 먼저 기록하세요. 한 번에 한 계층씩 업데이트하고, 검증이 통과할 때까지 콘솔 및 롤백 액세스를 유지하세요.

