새 홈 서버를 위한 안전한 Home Assistant 이전 체크리스트

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

새 서버에 로그인 화면이 표시된다고 해서 안전한 Home Assistant 마이그레이션이 완료된 것은 아닙니다. 기존 서버를 폐기하기 전에 새 호스트가 동일한 구성, 라디오, 통합 항목, 스토리지 경로, 네트워크 ID와 로컬 제어 동작을 복원해야 합니다.

롤백용 사본을 계속 사용할 수 있는 복구 테스트로 이전을 진행하세요. 새 백업을 만들고, 기존 서버의 종속 항목을 기록하고, 대상 장치에 복원한 뒤 라디오와 네트워크 스토리지를 다시 연결하고, 중요한 자동화를 테스트하세요. 새 설치가 정상적으로 사용되고 재부팅까지 견딜 때까지 기존 서버는 전원을 끄되 손대지 않은 상태로 보관하세요.

새 전체 백업을 만들고 복구 키는 기존 호스트 외부에 보관하기

현재 Home Assistant 백업 워크플로는 장치 유형이 서로 다른 경우를 포함해 초기 설정 중 마이그레이션을 지원합니다. 시작하기 전에 대상 장치에 충분한 저장 공간이 있는지 확인하고, 백업을 다운로드하거나 다른 방법으로 보존하세요. 또한 백업을 복호화하는 데 필요한 비상 복구 키트를 교체 대상 장치와 분리해 보관하세요.

현재 Home Assistant 마이그레이션 절차에서는 새 장치의 초기 설정 중 기존 장치의 백업을 사용하며, 네트워크 스토리지 및 라디오 이전에는 후속 작업이 필요할 수 있다고 명시합니다.

이전 중 유일한 백업을 덮어쓰지 마세요. 두 서버와 모두 별개인 사본을 최소 하나 보관하여, 대상 디스크 오류나 실수로 인한 초기화가 복구 원본과 기존 설치를 동시에 없애지 않도록 하세요.

백업만으로 물리적으로 이전되지 않는 종속 항목 기록하기

백업으로 Home Assistant 상태를 보존할 수는 있지만, USB Zigbee 또는 Z-Wave 스틱, 네트워크 케이블, UPS 연결, 외부 데이터베이스 호스트, MQTT 브로커, 리버스 프록시, NAS 공유 폴더 또는 라우터 예약을 물리적으로 옮길 수는 없습니다. 기존 호스트의 전원을 끄기 전에 이러한 종속 항목을 기록해 두세요.

기존 Home Assistant의 IP 주소 또는 호스트 이름, 외부 URL, 네트워크 스토리지 마운트, Recorder가 외부에 있을 경우 데이터베이스 URL, 브로커 주소, USB 장치, 라디오 유형, 호스트 수준의 Compose 또는 VM 설정을 기록하세요. 이 목록이 있어야 복원 실패와 외부 종속 항목 누락을 구별할 수 있습니다.

더 포괄적인 ZimaSpace 마이그레이션 체크리스트에도 같은 원칙이 적용됩니다. 원본을 보호하고, 실제로 이전 범위에 포함되는 항목을 정하고, 대상 장치를 확인하며, 정상 사용이 입증될 때까지 기존 사본을 보관하세요.

Zigbee 및 Z-Wave 네트워크를 별도의 마이그레이션 단계로 이전하기

같은 USB 무선 장치를 새 호스트로 옮기는 경우 다시 연결하고 장치 경로를 확인하세요. 새 서버에서 다른 내장 무선 장치나 교체용 무선 장치를 사용한다면 Home Assistant 백업만으로 코디네이터 식별 정보가 바뀐다고 가정하지 말고 무선 네트워크를 마이그레이션하세요.

ZHA는 네트워크를 자동으로 백업하며, 전체 메시 네트워크를 다시 페어링하지 않고도 지원되는 다른 코디네이터로 Zigbee 네트워크를 옮길 수 있습니다. 필요한 경우 마이그레이션 과정에서 무선 IEEE 식별 정보도 이전할 수 있습니다.

Z-Wave에는 별도의 컨트롤러 상태가 있습니다. 최근 Z-Wave JS UI 마이그레이션 논의에 따르면, Z-Wave 서비스를 새 하드웨어로 옮길 때 서비스 스토어와 NVM 백업이 핵심 복구 자산입니다. 두 무선 네트워크 모두 각자의 복구 절차가 필요한 자산으로 취급하세요.

먼저 복원한 다음 외부 스토리지와 네트워크 서비스를 다시 연결하세요

라우터, DNS, NAS 권한 또는 여러 서비스 주소를 한꺼번에 변경하기 전에 백업으로 대상 Home Assistant 인스턴스를 먼저 실행하세요. 한 번에 하나의 주요 변수만 기존 호스트와 다르게 하면 새 호스트의 문제를 더 쉽게 진단할 수 있습니다.

기존 설치에서 네트워크 스토리지를 사용했다면 복원 후 다시 연결하고 예상한 공유 이름과 인증 정보가 맞는지 확인하세요. 외부 데이터베이스나 MQTT 브로커를 사용했다면, 이미 정상 작동이 확인된 Home Assistant 설정을 변경하기 전에 새 호스트에서 DNS 및 TCP 연결을 테스트하세요.

애플리케이션 상태는 옮길 수 있지만, 호스트별 의존 항목은 올바르게 다시 구성해야 합니다. Home Assistant 백업으로 물리적으로 옮길 수 없는 무선 장치, 호스트 네트워크, 외부 스토리지, 데이터베이스 서비스, 브로커 엔드포인트 및 기존 서버가 관리하던 배포 설정에 초점을 맞춰 마이그레이션 기록을 작성하세요.

기존 서버를 폐기하기 전에 인수 테스트를 실행하세요

  • 예상한 사용자, 대시보드, 통합 구성요소, 헬퍼, 자동화 및 영역이 있는지 확인하세요.
  • 중요한 로컬 자동화 하나를 실행하고 실제 기기에서 반응이 오는지 확인하세요.
  • Zigbee, Z-Wave, Bluetooth 또는 기타 무선 장치를 사용할 수 있는지 확인하세요.
  • Recorder 기록과 통계가 정상적으로 저장되는지 확인하세요.
  • 네트워크 스토리지 경로 하나와, 사용 중이라면 MQTT 같은 외부 의존 항목 하나를 테스트하세요.
  • 로컬 접속과 원격 접속을 각각 테스트하세요.
  • 새 Home Assistant 호스트를 한 번 재시작한 뒤 중요한 로컬 제어 테스트를 반복하세요.

두 번째 부팅 테스트를 통과한 뒤에만 기존 서버를 초기화하거나 다른 용도로 사용할지 고려하세요. 그때까지 기존 설치는 전원을 끄고, 충돌을 일으킬 수 있는 무선 장치나 IP 주소와 분리한 상태로 두어 롤백 참조용으로 사용할 수 있게 하세요.

지원 및 팁

더 읽어보기

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.