애플리케이션 개요
Home Assistant는 로컬 스마트 홈 기기를 연결하고 자동화된 제어를 가능하게 하는 오픈 소스 홈 자동화 플랫폼입니다.
기본 로그인 정보
● 기본 액세스 포트: 8123
● 로컬 네트워크 접속: 브라우저주소창에 http://NAS_IP:8123을 입력하세요. 예를 들어 NAS IP가 172.17.70.86인 경우, 브라우저에 http ://172.17.70.69:8123을 입력하여 접속합니다.
참고:
● [네트워크 설정]은 "제어판"에서 찾을 수 있으며, [네트워크 연결]을 클릭하여 NAS 장치의 IP 주소를 확인하세요.
● UGOS Pro 앱 센터 아이콘을 통한 관리자 접근 기능이 작동하지 않게 될 수 있으므로 웹 UI 포트 번호를 수정하지 마십시오.
구성 경로
● 이 경로는 애플리케이션이 설정을 저장하는 위치입니다. 예를 들어 HACS, Homekit, Xiaomi 공식 플러그인 등을 이 경로에 배치할 수 있습니다.
● 구성 폴더 설정 후에는 해당 폴더를 삭제, 이동 또는 이름 변경하지 마십시오. 기능 이상을 유발할 수 있습니다.
● 구성 경로 폴더는 반드시 "공유 폴더"여야 하며 "개인 폴더"일 수 없습니다.
경로 마운트 규칙:
앱 설치 후, 앱 상세 페이지의 설정 섹션에서 해당 경로를 확인할 수 있습니다.
설치 가이드
Home Assistant 앱을 설치하려면 다음 단계를 따르세요:
1. 앱 센터를 열고 Home Assistant 앱을 찾아 "앱 설치"를 클릭하세요.
2. 볼륨을 선택하고 "다음"을 클릭하여 계속합니다.
3. 구성 경로를 선택합니다. 앱은 해당 경로에서 플러그인 정보를 읽습니다. "설치"를 클릭하여 계속합니다.
Home Assistant 접근
다음 방법들로 Home Assistant 애플리케이션에 접근할 수 있습니다:
방법 1: 애플리케이션 센터를 통한 접근 (관리자 전용)
● 홈 어시스턴트 애플리케이션 아이콘을 클릭하면 시스템이 로그인 페이지로 자동 이동합니다.
방법 2: 로컬 영역 네트워크(LAN)를 통한 접근 (관리자 및 일반 사용자)
로컬 네트워크 내에서 http://NAS_IP:8123로 접속합니다. 예를 들어 NAS IP가 172.17.70.69인 경우, 브라우저에 http://172.17.70.69:8123을 입력하여 접속합니다.
방법 3: 비로컬 네트워크를 통한 접속 (관리자 전용)
관리자는 NAS 시스템에 설치된 Firefox 앱을 통해 비로컬 네트워크 환경에서 Home Assistant에 접근할 수 있습니다:
1. UGREEN Link로 NAS에 로그인한 후 Firefox 브라우저를 실행합니다.
2. Firefox 로그인 후 http://NAS_IP:8123을 사용하여 Home Assistant에 접속합니다. 예를 들어 NAS IP가 172.17.70.69인 경우 브라우저에 http ://172.17.70.69:8123을 입력하여 웹 인터페이스에 접속합니다.
초기 설정
Home Assistant를 처음 사용할 때는 초기 설정을 완료해야 합니다:
1. 'Create My Smart Home'을 클릭하여 설정 가이드를 시작합니다.
2. 안내에 따라 이름, 사용자 이름, 비밀번호를 입력하여 사용자 계정을 생성합니다.
3. 거주 지역을 설정합니다. 설정을 완료한 후 '다음'을 클릭하여 진행합니다.
4. 필요한 기능의 활성화 여부를 선택한 후 "다음"을 클릭하여 진행합니다.
5. 이 단계에 도달하면 초기 설정이 완료됩니다. '마침'을 클릭하여 Home Assistant 대시보드로 진입하세요.
언어 변경
언어를 변경해야 하는 경우 사용자 설정에서 시스템 언어를 원하는 언어로 설정할 수 있습니다. 사용자 이름을 클릭하고 사용자 설정 메뉴에서 언어를 전환하세요.
플러그인(통합) 설치
Home Assistant에서 플러그인(통합)은 스마트 홈 기능을 확장하는 핵심 도구입니다. 다양한 브랜드의 기기와 서비스를 시스템에 원활하게 연결하여 통합 관리할 수 있게 합니다. HACS 플러그인 스토어, 샤오미 공식 플러그인, 타사 샤오미 플러그인, Apple HomeKit 구성 등 자주 사용되는 플러그인의 설치 방법은 다음과 같습니다:
HACS 플러그인 스토어 설치 (필수)
HACS(Home Assistant Community Store)는 Home Assistant용 커뮤니티 주도형 플러그인 스토어로, 다양한 타사 플러그인과 테마를 간편하게 설치, 업데이트, 관리할 수 있습니다. HACS 설치 방법은 다음과 같습니다:
1. GitHub에서 최신 HACS 릴리스 패키지를 다운로드합니다. GitHub 계정이 없다면 HACS 패키지 다운로드 전에 계정을 등록해야 합니다.
2. 작성 시점 기준 HACS 최신 버전은 2.0.5입니다. 필요에 따라 최신 버전을 다운로드하여 설치하세요: https://github.com/hacs/integration/releases
3. 파일 관리자를 열고 애플리케이션 구성 디렉터리 아래에 다음 두 폴더를 생성하세요:
● www: 정적 리소스를 저장하는 폴더입니다.
● custom_components: 이 폴더는 플러그인 디렉터리 역할을 합니다.
4. 구성 디렉터리는 애플리케이션 설치 시 설정한 경로입니다. 애플리케이션 상세 페이지의 '구성' 섹션에서 이 경로를 확인할 수 있습니다.
5. HACS ZIP 파일을 다운로드한 후 hacs.zip 파일을 압축 해제하고, 압축 해제된 폴더를 애플리케이션 구성 디렉토리 내 custom_components 디렉토리에 업로드하세요.
6. 플러그인 업로드 후 Home Assistant 페이지로 돌아가 개발자 도구(Developer Tools)로 이동하여 Home Assistant를 재시작합니다.
7. 재시작이 완료되면 홈 어시스턴트 페이지로 이동하여 설정 > 장치 및 서비스(Settings > Devices & Services)를 클릭하고 통합 추가(Add Integration)를 선택합니다. 그런 다음 HACS를 검색하여 추가합니다.
8. 모든 옵션을 선택한 후 "제출"을 클릭하세요.
9. 제출 후 "could_not_register" 메시지가 표시되면 NAS 장치를 재시작한 후 다시 제출해 주세요.
10. 팝업 창에서 코드를 복사하고, 팝업 내 GitHub URL을 클릭하여 계정 연동을 진행합니다. GitHub 계정이 없는 경우 계정을 생성하고 안내에 따라 GitHub 계정 연동을 완료하세요.
11. 안내에 따라 GitHub 계정 연동을 완료하세요.
12. 코드를 입력한 후 계속을 클릭하여 진행합니다.
13. "hacs 승인"을 클릭합니다.
14. 이 화면이 표시되면 인증이 성공한 것입니다.
15. 연결 및 인증이 성공하면 Home Assistant 사이드바에 HACS 옵션이 표시됩니다.
샤오미 공식 플러그인 (xiaomi_home)
샤오미에서 Home Assistant용 xiaomi_home 플러그인을 공식 출시했으며, GitHub에서 확인할 수 있습니다. 이 플러그인은 샤오미 공식 API를 통해 샤오미 기기(예: 에어컨, 소켓, 센서 등)를 Home Assistant에 연결하여 안정적인 공식 지원을 필요로 하는 사용자에게 제공합니다.
설치 방법은 HACS 플러그인과 동일합니다. 파일을 custom_components 디렉터리에배치하기만 하면 됩니다.
설치 단계:
1. GitHub의 Releases · XiaoMi/ha_xiaomi_home 페이지에서 xiaomi_home 플러그인의 최신 릴리스를 다운로드합니다 . GitHub 계정이 없다면 먼저 계정을 생성한 후 압축 패키지를 다운로드하세요.
2. 작성 시점 기준 xiaomi_home 최신 버전은 v0.1.5b2입니다. 필요에 따라 최신 버전을 다운로드하여 설치하는 것이 좋습니다.
3. xiaomi_home zip 파일을 다운로드한 후, xiaomi_home.zip 파일의 내용을 추출하고 추출된 폴더를 애플리케이션 구성 폴더 내 custom_components 디렉터리에 업로드하세요.
4. 플러그인 업로드 후 Home Assistant 페이지로 돌아가 개발자 도구(Developer Tools)로 이동하여 Home Assistant를 재시작하세요.
5. 재시작 후 Home Assistant 페이지로 이동하여 설정 > 장치 및 서비스(Settings > Devices & Services)를 클릭하고 "통합 추가(Add Integration)"를 선택한 후 Xiaomi를 검색하여 추가합니다.
6. 위험 공지 확인란을 선택하고 "다음"을 클릭하여 진행합니다.
7. "다음"을 클릭하여 진행합니다.
8. 클릭하여 로그인합니다.
9. 샤오미 계정으로 로그인합니다.
10. "로그인"을 클릭하면 다음 페이지로 이동합니다. 주소 표시줄의 homeassistant.local 주소를 NAS IP 주소로 변경한 후 다시 접속하세요. 이후 페이지가 자동으로 닫히고 Home Assistant로 돌아갑니다.
참고: [네트워크 설정]은 "제어판"에서 찾을 수 있습니다. [네트워크 연결]을 클릭하고 NAS 장치의 IP 주소를 확인하세요.
11. Home Assistant 페이지로 돌아가서, 기기를 가져올 홈을 선택하고 "다음"을 클릭하여 계속하세요.
12. 이 시점에서 홈 기기가 표시되면 배포가 성공한 것입니다. "마침"을 클릭하여 페이지를 닫으세요.
xiaomi-miot 플러그인 설치
공식 Xiaomi 플러그인 외에도 커뮤니티에서 제공하는 xiaomi-miot이라는 제3자 플러그인이 있습니다. 이 플러그인은 MIoT 프로토콜을 통해 더 많은 Xiaomi 기기를 지원하며, 공식 플러그인에서 지원하지 않는 일부 기기도 포함됩니다.
HACS를 통해 xiaomi-miot를 설치하려면 다음 단계를 따르세요:
1. HACS 스토어에서 "Xiaomi Miot Auto"를 검색한 후 플러그인을 다운로드합니다.
2. "다운로드"를 클릭하여 다운로드를 시작합니다. 다운로드가 완료되면 Home Assistant 컨테이너를 재시작하세요. [Docker] 앱에서 Home Assistant 컨테이너를 재시작하거나 Home Assistant 페이지의 [개발자 도구] 섹션에서 "재시작"을 클릭할 수 있습니다.
3. 컨테이너 재시작 후 Home Assistant의 [설정 > 장치 및 서비스]로 이동하여 "통합 추가"를 클릭합니다. "xiaomi miot auto"를 검색하여 찾은 후 아이콘을 클릭해 추가합니다.
4. "Mi 계정을 사용하여 기기 추가"를 선택하고 "다음"을 클릭하세요.
5. Xiaomi ID와 비밀번호를 입력하고 "자동" 모드를 선택한 후 "제출"을 클릭합니다.
6. 필요에 따라 포함 또는 제외할 기기를 선택하고 통합 설정을 완료합니다. 포함 규칙은 바인딩할 기기를 수동으로 선택하는 것이고, 제외 규칙은 바인딩하지 않을 기기를 수동으로 선택하는 것입니다.
7. 제출 후 [개요] 페이지에서 추가한 기기를 확인할 수 있습니다. 여기서 Home Assistant에 통합된 모든 Mi Home 기기를 제어할 수 있습니다.
Apple HomeKit 구성
Apple HomeKit은 Apple의 스마트 홈 플랫폼입니다. Home Assistant는 HomeKit과의 통합을 제공하여 사용자가 Apple의 Home 앱을 통해 Home Assistant 기기를 제어하거나 HomeKit 기기를 Home Assistant에 추가하여 통합 관리할 수 있게 합니다.
Home Assistant의 기기를 Apple Home 앱에 추가하려면 다음 단계를 따라 설정하세요:
1. Home Assistant에서 설정 > 기기 및 서비스로 이동한 후 통합 추가를 클릭합니다. "apple"을 검색하고 Apple 아이콘을 클릭하여 다음 메뉴로 진입합니다.
2.
2. 진입 후 HomeKit Bridge를 클릭합니다. 필요에 따라 포함할 도메인을 선택할 수 있습니다. 도메인은 서로 다른 유형의 기기로 이해할 수 있습니다. 선택 후 "제출"을 클릭합니다.
3. "HomeKit과 페어링" 단계에서 안내에 따라 진행한 후 제출 > 완료를 클릭합니다.
4. 사이드바에서 "알림"을 클릭한 후, Apple Home 앱으로 생성된 QR 코드를 스캔하여 페어링을 완료하세요.
Home Assistant 원격 액세스 활성화
UGREEN NAS는 원격 접근을 위해 컨테이너 애플리케이션을 노출하는 기능을 지원합니다. Home Assistant를 예로 들면, 사용자는 웹 브라우저, PC 또는 모바일 기기를 통해 원격으로 관리 인터페이스에 접근할 수 있어 기기 간 원활한 스마트 홈 제어 경험을 제공합니다.
UGOS Pro 시스템 펌웨어와 컨테이너 애플리케이션이 모두 최신 버전으로 업데이트되었는지 확인하십시오. 이전 버전에서는 원격 액세스가 지원되지 않습니다.
원격 접속 기능은 UGREENlink ID로 시스템에 로그인할 때만 사용 가능합니다. 컨테이너 애플리케이션 아이콘을 클릭하면 시스템이 자동으로 원격 접속 인터페이스로 이동합니다. DDNS 또는 기타 방법으로 로그인하는 사용자에게는 이 기능이 제공되지 않습니다.
원격 접속 설정 전 준비 사항
1. [앱 센터]를 열고 Home Assistant 애플리케이션 상세 페이지에서 [구성] 버튼을 클릭하여 애플리케이션의 구성 파일 경로를 확인합니다.
2. [파일]에서 이전 단계에서 확인한 설정 경로로 이동하여 configuration.yaml 파일을 찾습니다. 파일을 직접 편집할 수 없는 경우 App Center에서 [TextEdit] 앱을 설치하십시오.
configuration.yaml 파일 편집
[TextEdit] 앱으로 configuration.yaml 파일을 엽니다. 다음 내용을 파일에 추가한 후 변경 사항을 저장하고 편집기를 닫습니다.
http:
use_x_forwarded_for: true
trusted_proxies:
- 0.0.0.0/0
Home Assistant 애플리케이션 재시작
구성 완료 후 다음 방법 중 하나로 애플리케이션을 재시작할 수 있습니다:
● Home Assistant 애플리케이션 인터페이스 내에서 "재시작"을 클릭합니다;
● [앱 센터]에서 Home Assistant 애플리케이션을 비활성화한 후 다시 활성화합니다.
재시작이 성공적으로 완료되면 UGOS Pro 시스템에서 Home Assistant 아이콘을 클릭하면 시스템이 자동으로 원격 접속 인터페이스로 이동합니다.
원격 접속 기능은 UGREENlink ID 계정으로 로그인한 상태에서만 정상 작동하므로, 반드시 해당 계정으로 로그인했는지 확인하십시오.
사용 팁
NAS 기기 및 관련 애플리케이션 사용 시 최상의 경험과 데이터 보호를 위해 다음 사항을 유의하십시오:
1. 로컬 네트워크 내에서 NAS에 접근할 때는 보다 안정적이고 원활한 경험을 위해 Chrome 브라우저 사용을 권장합니다.
2. 신뢰할 수 없는 기기나 공용 네트워크에서 NAS에 로그인한 경우, 데이터 유출을 방지하기 위해 이후 브라우저 캐시, 쿠키 및 검색 기록을 반드시 삭제하십시오.
3. 보안 강화를 위해 정기적으로 비밀번호를 강력하고 복잡한 것으로 변경하여 무단 접근 위험을 줄이십시오.
4. 여러 사람이 기기를 공유하는 경우(예: Firefox 앱으로 NAS 접근 시), 계정 보호를 위해 "비밀번호 저장" 기능을 비활성화하고 정기적으로 검색 기록을 삭제하는 것이 좋습니다.
5. 컨테이너 애플리케이션에 의해 마운트된 NAS 폴더 경로를 이동, 이름 변경 또는 삭제하지 마십시오. 이는 오작동이나 데이터 손실을 유발할 수 있습니다.
6. 브라우저를 통해 컨테이너 애플리케이션에 접근할 때는 "제어판" 앱을 열고 [네트워크 관리] 하위의 멀티 게이트웨이 옵션을 비활성화하여 네트워크 충돌을 방지하십시오.
7. 컨테이너 애플리케이션은 초보자에게 적합합니다. 그러나 더 유연한 구성 옵션이 필요한 경우, 설정 파일 제어 및 고급 기능 접근성을 위해 Docker를 직접 사용하는 것이 권장됩니다.