Home Assistant에서 Tuya 전구를 로컬로 제어하는 ​​방법

마지막 업데이트 : 10 8월 2026
  • Tuya 개발자 포털을 통해 암호화 키에 접근할 수 있습니다.
  • tuya-cli와 같은 외부 도구를 사용하여 장치 식별자를 추출합니다.
  • 로컬 연결 끊김을 방지하려면 고정 IP 주소를 구성하십시오.
  • 색상 및 밝기 제어를 가능하게 하기 위해 특정 데이터 포인트를 매핑합니다.

투야 스마트 전구

분명 여러분도 이런 경험 있으실 겁니다. 저렴하고 스마트 라이프와도 잘 연동되는 스마트 전구를 잔뜩 샀는데, 클라우드에 전적으로 의존하는 방식 이 생각보다 훨씬 골칫거리라는 걸 깨닫게 되죠. 모든 걸 홈 어시스턴트에 통합해서 집안을 완벽하게 제어하고 싶은데 , 플러그인을 찾아보면 대부분 개발자 포털에 등록해야 한다는 걸 알게 됩니다. 마치 "로컬 제어" 라는 아이디어를 내세우 면서 실제로는 서버를 통해야만 시작할 수 있게 만드는 것 같은 느낌이 들죠.

사실, 모순처럼 보일지 모르지만, 이 첫 단계는 각 전구의 암호화 키를 얻는 데 필수적입니다 . 일단 키를 얻으면 데이터 트래픽이 더 이상 네트워크를 벗어날 필요가 없으므로, 중국에 있는 서버가 사용자가 주방 조명을 켜는 시점을 알지 못하도록 조명을 관리할 수 있습니다. 인내심을 갖고 올바른 단계를 따르면 Calex 기기 또는 Tuya 기반의 다른 브랜드 기기를 완전히 자율적이고 안전하게 작동시킬 수 있습니다.

n8n을 이용한 로컬 홈 자동화
관련 기사 :
n8n을 활용한 홈 자동화 및 홈 로컬 자동화 완벽 가이드

토대와 도구를 준비합니다

투야 스마트 전구

시작하기 전에 HACS(Home Assistant Community Store)를 설치 해야 합니다 . HACS를 사용하면 LocalTuya 플러그인을 가장 쉽게 추가할 수 있습니다. HACS가 실행되면 GitHub 저장소에서 LocalTuya를 찾아 설치하세요 . 이 단계는 하드웨어와의 직접 통신을 가능하게 하는 핵심 요소이므로 반드시 완료해야 합니다.

  바이브 코딩: 바이브 코딩이란 무엇이고, 어떻게 작동하며, 한계는 무엇인가

보안 키를 복구하려면 컴퓨터에 [소프트웨어 이름]을 설치해야 합니다. 파이썬과 NPM그 후 터미널을 열고 명령어를 실행하세요. npm i @tuyapi/cli -g 유틸리티를 설치하려면 투야-클리이 도구는 Home Assistant에 필요한 기술 정보를 추출하는 번거로운 작업을 대신 처리해 줍니다. 전구에게 말을 걸다 중개자 없이.

매칭 및 조직화 과정

투야 스마트 전구

전구를 추가하기 시작할 때는 테이프를 사용하여 각 전구에 라벨을 붙이는 것을 강력히 추천합니다 . 똑같은 전구가 열 개나 있으면 거실용인지 침실용인지 헷갈리기 쉽거든요. 앱에서 지정한 이름, IP 주소, 그리고 암호화 키를 입력할 공간을 꼭 적어 두세요.

홈 어시스턴트 플러그인
관련 기사 :
Home Assistant 플러그인: 주요 추가 기능 및 통합 기능에 대한 완벽 가이드

설정이 제대로 작동하지 않는 문제를 방지하는 중요한 방법은 라우터에 접속하여 각 장치에 고정 IP 주소를 할당하는 것 입니다 . DHCP를 통해 IP 주소가 자동으로 변경되도록 두면 Home Assistant가 전구를 찾지 못하게 되고, 클라우드 제어는 계속 작동하더라도 로컬 접속이 불가능해져 모든 설정을 처음부터 다시 구성해야 합니다.

암호화 키 추출

투야 스마트 전구

조명을 Tuya 계정에 연결했으면 이제 터미널을 사용할 차례입니다. 다음 명령어를 실행하세요. tuya-cli wizard처음 이 작업을 수행할 때 시스템에서 사용자 정보를 요청할 것입니다. API 자격 증명 개발자 포털에서 설정할 수 있습니다. 설정이 완료되면 기기 ID 하나만 입력하면 도구가 JSON 파일을 생성합니다. 이름, ID 및 암호화 키 계정에 연결된 모든 기기.

  NFC 15에 대한 모든 것: 비접촉식 결제, 디지털 ID 등을 위한 새로운 시대

Home Assistant의 상세 설정

투야 스마트 전구

LocalTuya에 조명을 추가할 때는 시스템 안정성을 유지하기 위해 하나씩 추가하는 것이 가장 좋습니다 . 추가 과정은 다음과 같은 몇 단계로 구성됩니다. 먼저 IP 주소를 사용하여 목록에서 조명을 선택합니다. 그런 다음 이전에 얻은 사용자 이름과 암호화 키를 입력합니다. 데이터 입력란에 조명에 "20" 이라는 값이 표시되어 있는지 확인하십시오.

홈 어시스턴트 자동화
관련 기사 :
Home Assistant를 활용한 자동화 완벽 가이드

다음 단계에서는 장치를 "조명 "으로 정의합니다. 가장 복잡한 부분은 마지막 데이터 포인트(DP) 설정입니다. 색상 및 밝기 제어가 제대로 작동하려면 밝기 22 , 색온도 22, 색상 모드 21, 색상 24 로 설정해야 합니다. 이 값들은 모델에 따라 다를 수 있지만, 일반적으로 색상환을 완벽하게 제어 하기 위한 표준 값입니다.

이 워크플로를 따르면 클라우드에 의존하던 전구를 로컬에서 관리되는 장치로 전환할 수 있습니다. tuya-cli를 사용하고, 고정 IP를 할당하고, LocalTuya에서 데이터 포인트를 올바르게 매핑하면 조명이 즉각적으로 반응 하고 인터넷 연결이 끊어지더라도 홈 자동화 시스템이 계속 작동한다는 안심감을 얻을 수 있습니다.

홈 어시스턴트의 숨겨진 기능
관련 기사 :
홈 어시스턴트: 숨겨진 기능과 고급 활용법