Immich 데이터 폴더의 권한이 바뀌지 않도록 하는 방법

Eva Wong 는 테크니컬 라이터 이자 상주 메이커 로 ZimaSpace에서 활동합니다. 평생 기술을 사랑해 온 그녀는 홈랩과 오픈 소스 소프트웨어에 열정을 품고 있으며, 복잡한 기술 개념을 누구나 이해하기 쉬운 실습 가이드로 풀어내는 데 전문성을 갖추고 있습니다. Eva는 셀프 호스팅이 어렵고 부담스러운 일이 아니라 즐거워야 한다고 믿습니다. 그녀는 튜토리얼을 통해 커뮤니티가 하드웨어 설정의 어려움을 풀어내고, 첫 NAS를 조립하는 것부터 Docker 컨테이너를 능숙하게 다루는 것까지 도전하도록 돕습니다.

Immich의 권한 드리프트를 방지하려면 서로 다른 컨테이너, NAS 프로토콜, 업데이트 또는 유지 관리 작업이 서로 다른 ID로 새 파일을 만들기 전에 파일 소유권과 액세스 규칙을 예측 가능하게 설정해야 합니다.

지속 가능한 해결책은 주기적으로 권한을 재귀적으로 초기화하는 것이 아닙니다. 숫자 UID/GID와 각 작업 흐름에 실제로 필요한 액세스 권한을 기록하고, 마운트 소유권과 ACL 상속을 신중하게 설정하고, 읽기 전용 경로와 쓰기 가능 경로를 분리하고, 변경 후 파일 생성 경로를 테스트하세요. 오늘 라이브러리를 읽을 수 있는지가 아니라, 비상시에 `chown`을 하지 않아도 내일 새 파일이 올바르게 생성될 때 권한 드리프트를 막을 수 있습니다.

각 Immich 경로에서 읽고 쓰는 ID를 기록하기

Immich에 마운트된 호스트 경로를 나열하고 각 경로에서 읽기, 생성, 이름 변경 또는 삭제를 수행할 프로세스를 확인하세요. 각 파일 작성자에 대해 호스트와 컨테이너 내의 숫자 UID 및 GID를 기록하세요. 파일에는 소유권이 숫자로 저장되므로 사용자 이름이 일치하는지보다 숫자 ID가 중요합니다.

Immich 외부에서 파일을 쓰는 주체도 목록에 포함하세요. SMB 업로드, NFS 클라이언트, 백업 도구, 가져오기 스크립트, 미디어 관리 컨테이너, 관리자 셸 모두 같은 디렉터리에 파일을 만들 수 있습니다. 서로 다른 ID로 파일을 생성하면 라이브러리에 소유자와 권한 모드가 점차 뒤섞여, 한 경로에서는 작동하지만 다른 경로에서는 실패할 수 있습니다.

이 ID 매핑을 Compose 구성과 함께 보관하세요. 그러면 향후 이미지 업데이트, 서버 이전 또는 NAS 계정 복원 시 새 업로드가 실패하기 시작한 뒤에야 불일치를 발견하는 대신, 정상 작동이 확인된 기준과 비교할 수 있습니다.

소유자, 공유 그룹, 최소 권한 모델을 신중하게 설정하기

애플리케이션이 관리하는 데이터를 소유할 ID와 액세스가 필요한 공유 그룹이 있다면 해당 그룹을 정하세요. 각 작업 흐름에 필요한 읽기 또는 쓰기 권한만 부여하세요. 컨테이너 하나가 썸네일을 만들거나 가져온 파일을 이동할 수 없다는 이유만으로 Immich 디렉터리 전체에 모든 사용자의 쓰기 권한을 부여하지 마세요.

UID/GID 불일치와 지나치게 광범위한 권한은 공유 볼륨 장애의 흔한 원인입니다. 제한 없는 액세스 권한을 부여하기보다는 컨테이너와 볼륨의 권한을 일치시키는 것이 더 안전한 방법입니다. 여러 서비스가 같은 스토리지 풀에 접근할 수 있는 홈 서버에서는 특히 중요합니다.

여러 서비스에 쓰기 권한이 필요하다면 애플리케이션마다 소유권을 번갈아 재귀적으로 변경하는 대신 공유 그룹과 일관된 그룹 권한 또는 ACL을 사용하세요. 먼저 대표 디렉터리 하나에서 확인하세요. 사진 라이브러리 전체에 광범위하게 재귀적 변경을 적용하는 것은 최신 백업이 있을 때만 최후의 수단으로 사용해야 하며, 일상적인 유지 관리 방법이 되어서는 안 됩니다.

새 파일 권한을 예측 가능하게 설정하기

기존 파일은 문제없어 보여도 생성 규칙이 잘못되면 새 파일의 권한은 즉시 틀어질 수 있습니다. 상위 디렉터리의 ACL, 기본 ACL 항목, umask, 서비스 사용자, 해당 경로에 적용되는 SMB 또는 NFS 생성 설정을 확인하세요. 예방의 핵심은 사후 정리가 아니라 권한 상속입니다.

모드를 재귀적으로 변경하기 전에 호스트의 숫자형 소유권을 컨테이너 내부에서 실제로 실행 중인 UID/GID와 비교하세요. 이 UID/GID 바인드 마운트 확인으로 사용자 ID 불일치와 실제 권한 누락을 빠르게 구분할 수 있습니다. 지나치게 허용적인 모드로 문제를 가리지 말고 소유자와 그룹의 관계를 바로잡으세요.

일반적인 쓰기 경로마다 작은 테스트 파일을 하나씩 만드세요. Immich 업로드, 가져오기 작업, 사용하는 경우 SMB/NFS 전송, 백업 복원이 이에 해당합니다. 각 테스트 후 소유자, 그룹, 모드, ACL을 확인하세요. 두 경로에서 호환되지 않는 결과가 나오면 데이터를 더 가져오기 전에 해당 정책 충돌을 해결하세요.

마운트 및 업데이트 변경으로 소유권이 다시 기록되지 않도록 하세요

Compose 수정, 이미지 업데이트, NAS 재마운트 또는 마이그레이션은 권한에 영향을 줄 수 있는 변경으로 취급하세요. 적용하기 전에 현재 마운트의 소스와 대상, 경로의 읽기 전용 또는 읽기-쓰기 여부, 컨테이너에서 실제로 사용하는 사용자, 각 주요 디렉터리의 숫자형 소유권 샘플을 기록하세요.

전송 및 네트워크 저장소 사용 시 SMB/NFS 사용자 ID, 숫자형 ID, ACL 상속, umask 동작이 달라질 수 있습니다. Immich 데이터를 파일시스템이나 접근 방식이 다른 곳으로 옮길 때마다 변경 전 체크리스트로 NAS 권한 변경 실패 지점을 확인하세요.

변경 후 대량 작업을 실행하기 전에 동일한 샘플을 비교하세요. 시작 시 소유권이 갑자기 바뀌면 스택을 중지하고 어떤 엔트리포인트, 유지 관리 작업 또는 매핑된 사용자 ID가 원인인지 파악하세요. 원인을 알 수 없는 재귀적 소유권 변경이 대규모 라이브러리 전체로 계속 확산되게 두지 마세요.

작고 반복 가능한 테스트로 권한 변경 여부 감사

정기적으로 또는 업그레이드 후 간단한 권한 감사를 수행하세요. 변동이 적은 원본 파일 몇 개, 최근 업로드 파일, 새로 생성된 파생 파일, 외부 라이브러리 마운트를 확인하세요. 예상치 못한 소유자, 누락된 그룹 접근 권한, 읽기 전용 마운트의 쓰기 가능 전환, 예상대로 상속되지 않는 ACL이 있는지 살펴보세요.

그런 다음 처음부터 끝까지 쓰기 테스트를 수행하세요. 일반 클라이언트를 통해 테스트용 파일을 업로드하고 Immich가 처리할 때까지 기다린 다음 파일을 열고 애플리케이션에서 삭제하세요. 외부 라이브러리나 가져오기 경로를 사용한다면 해당 경로로 대표 파일 하나를 추가하고, 소유권을 예상치 않게 변경하지 않고도 Immich가 파일을 읽을 수 있는지 확인하세요.

새 파일이 Immich 재시작과 호스트 재부팅 후에도 계속 의도한 사용자 및 접근 권한으로 생성되어야 예방 작업이 완료된 것입니다. 두 경우 중 하나라도 지나고 나서 권한을 수동으로 복구해야 한다면 시스템이 여전히 불안정한 상태입니다. 접근 권한을 확대하기 전에 생성 규칙이나 사용자 매핑을 수정하세요.

지원 및 팁

더 읽어보기

Get More Builds Like This

Stay in the Loop

Get updates from Zima - new products, exclusive deals, and real builds from the community.

Stay in the Loop preferences

We respect your inbox. Unsubscribe anytime.