Home Assistant 백업에 일관되지 않은 데이터베이스 상태가 포함되지 않도록 하는 방법

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

애플리케이션이 실행 중인 데이터베이스 상태를 조정하도록 하거나 원시 파일시스템을 복사하기 전에 쓰기 작업을 중지해 일관되지 않은 Home Assistant 백업을 방지하세요.

위험한 상황은 단순히 “Home Assistant가 켜져 있을 때 백업하는 것”이 아닙니다. 관련 데이터베이스와 애플리케이션 파일의 트랜잭션 상태를 파악하지 않은 채 서로 다른 시점에 캡처하는 복사 방식이 문제입니다. 내장 백업은 Home Assistant 구성 요소를 조정할 수 있지만, 일반 rsync나 스냅샷 도구는 그렇지 않을 수 있습니다. 일관성을 보장할 방식을 정하고, 데이터베이스에 큰 부하를 주는 작업이 겹치지 않도록 하며, 이전의 정상 백업을 보관하고, 격리된 환경에서 복구를 수행해 각 정책이 제대로 작동하는지 확인하세요.

실행 중인 SQLite 데이터베이스를 일반 정적 파일처럼 다루지 마세요

일반 백업 프로세스가 구성 디렉터리를 복사하는 동안 Home Assistant Recorder가 데이터를 기록할 수 있습니다. SQLite에서는 커밋된 상태가 기본 데이터베이스와 저널 또는 WAL 파일에 나뉘어 있을 수 있습니다. 따라서 서로 다른 시점의 파일을 캡처하면 아카이브에 모든 파일명이 있어도 복사본이 불완전하거나 복구 불가능해질 수 있습니다.

실행 중인 SQLite 데이터베이스의 백업 테스트에서 기본 데이터베이스 파일만 복사하면 커밋된 행이 WAL에 남아 있는데도 조용히 누락될 수 있음을 확인했습니다. 복사한 데이터베이스가 무결성 검사에 통과했는데도 이런 일이 발생했습니다. 이 WAL 기반 복사 실패 사례는 원시 파일 복사 시 데이터베이스 인식 스냅샷을 사용하거나 데이터베이스를 완전히 정지시킨 뒤 복사해야 하는 이유를 보여 줍니다.

그렇다고 백업할 때마다 Home Assistant를 반드시 종료해야 한다는 뜻은 아닙니다. 백업 방식이 일관된 복구 지점을 만드는 방법을 알아야 한다는 뜻입니다. 실행 중인 설치 환경에는 내장 Home Assistant 백업을 사용하세요. 종료 후 파일시스템 복사는 마이그레이션, 오프라인 보관 또는 애플리케이션을 고려하는 통합 기능이 없는 외부 도구를 사용할 때로 한정하세요.

같은 시간대에 백업 또는 유지보수 작업이 겹치지 않게 하세요

애플리케이션을 고려하는 백업도 다른 프로세스가 잠금을 유지하거나 저장 경로에 이례적인 유지보수 부하가 걸리면 데이터베이스 준비에 실패할 수 있습니다. 집이 조용하다는 이유만으로 두 번째 애드온 백업, 데이터베이스 유지보수, NAS 스냅샷, Home Assistant 백업을 같은 시각에 시작하도록 예약하지 마세요.

실제 Home Assistant 백업 실패 사례에서는 데이터베이스 잠금 준비 오류가 보고되었으며, 한 사용자는 다른 백업 애드온과의 충돌이 원인임을 밝혔습니다. 이는 예방이 필요하다는 신호입니다. 중복되는 도구는 사용 시간을 분리하고, 애플리케이션 로그에서 백업 전 단계가 완료되는지 확인해야 합니다.

유지보수 시간을 분산해 예약하고 예상 소요 시간을 기록하세요. 백업이 반복적으로 Recorder를 기다린다면 먼저 잠금 소유자나 데이터베이스 상태 문제를 파악하세요. 시간 초과 값을 무작정 늘리거나 사본을 병렬로 더 실행하지 마세요. 백업 작업이 늘어나면 해결하려는 바로 그 경합이 더 심해질 수 있습니다.

원시 파일 시스템을 복사할 때는 Home Assistant의 작업을 중지하고 전체 상태 세트를 보존하세요

정책상 설정 디렉터리를 직접 복사해야 한다면, 복사하기 전에 Home Assistant를 정상적으로 중지하고 프로세스가 더 이상 쓰기 작업을 하지 않는지 확인한 뒤, 기본 데이터베이스 파일만 골라 복사하지 말고 필요한 상태 전체를 복사하세요. 외부 데이터베이스 백업은 별도의 일관성 유지 방법을 사용하세요.

기존 ZimaSpace의 Home Assistant를 실행한 상태와 중지한 상태에서의 백업 비교도 같은 경계를 제시합니다. 애플리케이션을 고려한 실시간 백업과 원시 파일 시스템 복사는 서로 다른 절차이므로 하나의 규칙으로 묶어서는 안 됩니다.

사본을 만든 뒤 서비스를 재시작하고 Recorder가 정상 작동하는지 확인하세요. 백업 대상이 네트워크 저장소라면 네트워크 마운트를 해제하기 전에 파일 세트가 모두 생성되었는지도 확인하세요. 중간에 끊긴 서비스 중지 상태의 사본은 원본이 변경되지 않았다는 좁은 의미에서만 일관성이 있을 뿐, 완전한 복구 지점은 아닙니다.

격리된 환경에서 복원에 성공한 뒤에만 백업을 신뢰하세요

임시 Home Assistant 인스턴스 또는 복구 대상을 만들고, 운영 환경의 변경 가능한 파일을 빌려오지 않은 상태에서 후보 백업을 복원하세요. 기존 사용자, 기록 데이터, 대시보드, 통합 구성, 자동화 정의를 확인하고 한 번 이상 재시작하세요. 복원에 걸린 시간과 인스턴스를 사용할 수 있도록 적용해야 했던 수동 수정 사항을 기록하세요.

Home Assistant Core 2026.7.2에서 특정 버전에 국한된 회귀 문제가 발생해 사전 백업 단계에서 Recorder의 WAL 체크포인트가 실패했고, 이후 백업 관리자는 데이터베이스 잠금을 기다리다 시간 초과되었습니다. 이 사전 백업 실패 신호는 해당 경로에서 발생한 문제의 증거이자 복구 지점의 실패로만 취급해야 합니다. 모든 잠금 시간 초과의 원인이 같다는 증거로 간주해서는 안 됩니다.

한 번에 하나의 백업 메커니즘만 일관성을 담당하고, 데이터베이스 준비 단계가 완료되며, 이전의 정상 사본을 보존하고, 복원 후 사용자, 기록, 설정 및 정상적인 재시작 동작이 재현되면 정책을 통과한 것으로 봅니다. 복원 테스트에 실패하면 증거를 보존하고, 이전 복구 지점을 삭제하기 전에 지원되는 새 백업을 만들거나 서비스를 중지한 상태에서 제어된 사본을 만드세요.

지원 및 팁

더 읽어보기

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.