시스템 무결성

폴더 확인

정보

이 확인에서 고려되는 폴더는 다음과 같습니다: upload/, library/, thumbs/, encoded-video/, profile/, backups/

Immich가 시작될 때, 스토리지 시스템에서 사용되는 볼륨 마운트에 대해 파일을 읽고 쓰기 가능 여부를 확인하기 위해 일련의 검사를 수행합니다. 필요한 모든 작업을 수행할 수 없으면 시작하지 못합니다. 다음과 같은 검사를 포함합니다:

• 각 폴더에 초기 숨김 파일(.immich) 생성
• 각 폴더에서 숨김 파일(.immich) 읽기
• 각 폴더에서 숨김 파일(.immich) 덮어쓰기

이 검사는 다음과 같은 상황을 잡아내기 위해 설계되었습니다:

• 잘못된 권한 설정(파일을 읽거나 쓸 수 없음)
• 볼륨 마운트 누락(.immich 파일이 존재해야 하지만 없음)

일반적인 문제

참고

.immich 파일은 마커 역할을 하며 Immich에서 사용하는 볼륨 마운트를 추적하는 데 도움을 줍니다. 아래에 나열된 상황을 제외하고는 절대 수동으로 생성하거나 삭제하지 않아야 합니다.

.immich 파일 누락

시스템 마운트 폴더 확인 중(활성화=true)
...
ENOENT: 해당 파일이나 디렉터리가 없습니다. 열기 'upload/encoded-video/.immich'

위의 오류 메시지는 서버가 이전에 각 폴더에 .immich 파일을 성공적으로 작성했지만 이제는 이를 감지하지 못함을 나타냅니다. 이것은 다음과 같은 이유 때문일 수 있습니다:

• 권한 오류 - 파일을 읽을 수 없지만 존재함
• 파일이 존재하지 않음 - 볼륨 마운트가 변경되어 수정해야 함
• 파일이 존재하지 않음 - 사용자가 수동으로 삭제하여 수동으로 다시 생성해야 함(touch .immich)
• 파일이 존재하지 않음 - 사용자가 백업에서 복원했지만 각 폴더를 복원하지 않았음(사용자는 모든 폴더를 복원하거나 누락된 폴더에 .immich를 수동으로 생성해야 함)

검사 무시

경고

이 검사는 사용자가 과거에 직면했던 일반적인 문제를 잡아내기 위해 설계되었으며, 해결이 필요한 무언가가 잘못되었음을 나타내는 경우가 많습니다. 자신이 무엇을 하고 있는지 알고 있고 이를 비활성화하려면 다음 환경 변수를 설정할 수 있습니다:

IMMICH_IGNORE_MOUNT_CHECK_ERRORS=true