Home Assistant 데이터 폴더의 권한 변경을 방지하는 방법

에바 왕

IceWhale author

에바 왕 는 기술 작가 그리고 이자 ZimaSpace의 상주 장인입니다. 평생을 기술에 열정을 가진 사람으로서 홈랩과 오픈소스 소프트웨어에 열정을 가지고 있으며,복잡한 기술 개념을 쉽게 이해할 수 있는 실습 가이드로 번역하는 데 전문성을 가지고 있습니다.에바는 셀프 호스팅이 어렵지 않고 재미있어야 한다고 믿습니다. 그녀의 튜토리얼을 통해 커뮤니티가 하드웨어 설정의 신비를 풀도록돕고 있습니다. 첫 NAS 구축부터 Docker 컨테이너 마스터링까지.

How to Prevent Permission Drift in Home Assistant Data Folders

Home Assistant 데이터가 여전히 존재하더라도, 이를 현재 마운트하는 프로세스가 데이터를 생성한 프로세스와 다른 소유권, UID/GID 매핑, 접근 모드 또는 보안 컨텍스트를 인식하면 권한 드리프트가 발생합니다. 이 문제는 호스트 마이그레이션, 복원, Docker 모드 변경, NAS 복사 또는 수동 chown/chmod 작업 후에 자주 나타납니다.

변경 전에 예상되는 마운트 및 소유권 모델을 문서화하고, 복사할 때 메타데이터를 보존하며, 재생성 후 읽기 및 쓰기 접근을 모두 테스트하여 예방하세요. 모든 오류를 chmod -R 777로 해결하려 하지 마세요. 이렇게 하면 불일치가 숨겨지고 복구 모델이 약화됩니다.

권한을 변경하기 전에 스토리지 경계를 문서화하세요

먼저 /config가 Docker에서 관리하는 볼륨인지, Linux 바인드 마운트인지, 네트워크 마운트인지, 아니면 VM 내부 경로인지 확인하세요. 올바른 소유권 전략은 실제로 파일을 소유하는 계층에 따라 달라집니다.

현재 Home Assistant Container 설치 안내에서는 이 스토리지 계약을 구체적으로 제시합니다. 선택한 호스트 폴더를 읽기/쓰기 권한으로 /config에 마운트합니다. 폴더 이름만 믿지 말고 정확한 원본 경로, 마운트 대상 및 접근 모드를 기록하세요.

또한 Home Assistant가 표준 Docker, 루트리스 Docker, 사용자 네임스페이스 재매핑 환경 또는 NAS 컨테이너 관리자를 통해 실행되는지도 기록하세요. 컨테이너 내부와 외부에서 확인되는 숫자형 ID가 서로 다를 수 있습니다.

파일이 이동하지 않아도 UID와 GID 매핑은 변경될 수 있습니다

호스트 경로는 그대로인 상태에서 유효 사용자 매핑만 변경될 수 있습니다. 이는 루트 권한 Docker에서 루트리스 Docker로 전환하거나, 사용자 네임스페이스 재매핑을 활성화하거나, 로컬 계정이 다른 호스트로 데이터를 복원할 때 흔히 발생합니다.

Docker의 최신 UID/GID 매핑 문서에서는 루트리스 및 사용자 네임스페이스 모드가 컨테이너 ID를 서로 다른 호스트 ID로 변환하는 방식을 설명합니다. 따라서 한 호스트에서 올바르게 소유된 것으로 보이는 파일이 배포 모델을 변경한 후에는 쓰기 불가 상태가 될 수 있습니다.

새 호스트에서는 계정 이름이 다른 숫자에 매핑될 수 있으므로, 계정 이름에만 의존하지 말고 ls -ln 또는 이에 준하는 도구로 숫자형 소유권을 비교하세요.

Home Assistant 데이터를 복사할 때 메타데이터를 보존하세요

마이그레이션 도구나 GUI 파일 복사 기능은 파일 내용은 보존해도 소유권, 모드 비트, ACL, 확장 속성 또는 보안 레이블은 보존하지 않을 수 있습니다. 이 경우 YAML 파일은 읽을 수 있지만 데이터베이스, 숨겨진 스토리지, 인증서 또는 쓰기에 필요한 디렉터리에서 나중에 오류가 발생할 수 있습니다.

플랫폼에서 실제로 사용하는 메타데이터를 보존하는 복사 방법을 사용하세요. 전송이 끝나면 Home Assistant를 시작하기 전에 원본과 대상의 대표적인 파일 및 디렉터리를 비교하세요.

계정과 권한을 반복 가능한 가정용 정책으로 관리하는 ZimaSpace 가이드의 원칙이 여기에도 적용됩니다. 소유권은 일회성 응급 조치의 연속이 아니라 의도적으로 관리되는 인프라여야 합니다.

-15% OFF

ZimaBoard 2 - 당신의 큰 아이디어를 위한 미니 홈 서버

Single board computer zimaboard2

Home Assistant에 쓰기가 필요한 경우에만 마운트를 읽기/쓰기로 유지하세요

Home Assistant는 영구 구성과 데이터베이스를 업데이트할 수 있어야 합니다. 마운트가 실수로 읽기 전용으로 재생성되면 시작 및 읽기는 가능해도 이후 쓰기, 백업, 데이터베이스 커밋 또는 구성 변경이 실패할 수 있습니다.

바인드 마운트된 호스트 경로는 읽기/쓰기 또는 읽기 전용으로 노출할 수 있습니다. Docker의 파일 공유 가이드에서는 실제 마운트 모드가 컨테이너의 호스트 디렉터리 수정 가능 여부를 결정한다고 설명합니다. Compose 파일이 의도한 대로 적용되었다고 가정하지 말고 실행 중인 마운트를 확인하세요.

반대로 Home Assistant가 하나의 구성 경로에 접근해야 한다는 이유만으로 관련 없는 호스트 디렉터리를 쓰기 가능하게 만들지는 마세요. 권한 경계를 좁게 유지하세요.

모든 복원 또는 재생성 후 권한 승인 테스트를 수행하세요

정상적으로 시작되었다는 사실만으로 파일 시스템 계약이 완전히 충족되었다고 볼 수는 없습니다. Home Assistant가 기존 파일은 읽을 수 있어도 데이터베이스에 쓰거나, 백업을 생성하거나, 레지스트리를 업데이트하거나, 대시보드를 저장해야 할 때 나중에 실패할 수 있습니다.