스택을 다시 만들면 Home Assistant가 영구 데이터에 액세스할 수 없는 이유는 무엇인가요?

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

같은 영구 /config 데이터를 다시 마운트하면 Home Assistant Docker 또는 Compose 스택을 다시 만들어도 설정이 지워지지 않아야 합니다. 스택을 다시 만든 뒤 온보딩 화면이 나타나거나 통합 기능이 사라진 것처럼 보인다면, Home Assistant가 집의 상태 데이터를 삭제했다고 생각하기보다 새 컨테이너가 다른 저장소 뷰를 보고 있다고 먼저 의심해야 합니다.

이전 백업을 복원하기 전에 실제 마운트, 호스트 경로, 이름 지정 볼륨, 숨겨진 파일 및 권한을 확인하세요. 잘못된 빈 디렉터리는 호스트의 다른 위치에 원본 데이터가 그대로 남아 있는데도 설정이 사라진 것처럼 보일 수 있습니다.

실제로 /config에 마운트된 항목 확인하기

실행 중인 컨테이너를 검사하고 /config에 연결된 마운트 소스를 확인하세요. 익숙해 보이는 폴더 이름만 믿지 말고 기존 Compose 파일이나 배포 기록과 비교하세요.

Docker 바인드 마운트는 대상 디렉터리에 대한 컨테이너의 뷰를 바꾸며, 최신 바인드 마운트 문서에 따르면 호스트 디렉터리를 컨테이너의 비어 있지 않은 경로에 마운트하면 기존 파일이 가려집니다. 따라서 비어 있거나 잘못된 소스 경로를 지정하면 Home Assistant에서 빈 /config를 보게 됩니다.

마운트가 올바른 것으로 확인될 때까지 온보딩을 진행하거나 새 통합 기능을 만들지 마세요. 잘못된 디렉터리에 새 데이터를 쓰면 나중에 복구하기가 더 혼란스러워집니다.

바인드 마운트와 이름 지정 볼륨 구분하기

Compose 스택은 명시적인 호스트 경로나 Docker가 관리하는 이름 지정 볼륨을 사용할 수 있습니다. 프로젝트 이름, 볼륨 이름 또는 경로를 바꾸어 프로젝트를 다시 만들면 기존 볼륨이 남아 있는 동안 비어 있는 새 영구 저장소가 생성될 수 있습니다.

최신 Docker 볼륨 가이드에 따르면 이름이 지정된 볼륨은 개별 컨테이너와 독립적으로 데이터를 저장하며 컨테이너를 교체한 후에도 다시 연결할 수 있습니다. 따라서 컨테이너를 제거하는 것과 영구 저장소를 제거하거나 교체하는 것은 다릅니다.

기존 볼륨과 새 볼륨을 나열하고, Docker를 통해 마운트 지점을 확인한 다음 생성 시간과 내용을 비교하세요. 어느 볼륨에 Home Assistant의 기준 상태가 저장되어 있는지 알기 전에는 prune 명령을 실행하지 마세요.

숨겨진 파일 때문에 복사본이 완전해 보일 수 있습니다

Home Assistant는 .storage 같은 숨겨진 경로에 중요한 UI 관리 상태를 저장합니다. *와 같은 글롭 패턴을 사용하는 셸 복사 명령이나 점 파일을 숨기는 파일 관리자를 사용하면 YAML 파일은 옮겨지지만 중요한 레지스트리 및 통합 상태는 누락될 수 있습니다.

2025년 Docker에서 Compose로 이전한 사례에서도 정확히 같은 경계 문제가 재현되었습니다. 복사 작업에서 숨겨진 Home Assistant 상태 파일이 누락되거나 잘못 처리되었으며, 전체 설정 트리와 메타데이터를 올바르게 복사한 뒤에야 마이그레이션이 안정화되었습니다.

점 파일을 포함한 디렉터리 목록을 비교하고, 데이터 자체가 손상되었다고 결론 내리기 전에 소유권, 타임스탬프 및 예상되는 숨김 디렉터리가 있는지 확인하세요.

데이터를 다시 복사하기 전에 권한 확인

다시 만든 컨테이너에 해당 디렉터리를 읽거나 쓸 권한이 없으면 올바른 디렉터리도 사용할 수 없는 것처럼 보일 수 있습니다. 데이터를 새 파일 시스템으로 옮기거나, Docker 모드를 변경하거나, 다른 호스트에서 복원하거나, UID/GID 매핑을 변경한 후에 흔히 발생합니다.

2026년에 검증된 Docker Engine 문제 해결 가이드에서는 이런 오류의 원인을 실제 호스트 경로, 컨테이너 UID/GID, 상위 디렉터리 액세스, 마운트 모드 및 보안 경계로 좁힙니다. 파일이 보이더라도 읽기 전용 설정이나 소유권 불일치 때문에 Home Assistant가 상태를 업데이트하지 못할 수 있습니다.

전체 설정 트리에 모든 사용자 쓰기 권한을 부여하는 대신, 필요한 소유권 또는 마운트 문제만 해결하세요.

영구 저장 경로를 확인한 후에만 스택 다시 만들기

정확히 알려진 정상 Compose 정의, 이미지 태그, 네트워크 모드, 장치 및 /config 소스를 사용하세요. Home Assistant를 시작한 다음 마이그레이션이나 새 설정 변경을 허용하기 전에 예상한 사용자, 대시보드, 통합, 자동화 및 헬퍼가 돌아왔는지 확인하세요.

ZimaSpace의 단일 컨테이너 복구 워크플로에도 같은 원칙이 적용됩니다. 스택의 관련 없는 부분을 복원하거나 교체하기 전에 실제 마운트를 확인하고 정상적인 종속성을 다시 연결하세요.

공인 데이터가 실제로 없다면 백업에서 복원하세요. 데이터가 있지만 새 컨테이너에서 보거나 수정할 수 없다면, 문제는 Home Assistant 설정 자체가 아니라 스토리지 매핑 또는 권한 경계에 있습니다.

지원 및 팁

더 읽어보기

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.