Sponsor on GitHub
Buy me a coffee
Build status
Docker image downloads
Tuya Local Key
QR 코드를 이용한 로그인으로 Smart Life / Tuya 장치의 로컬 키를 검색합니다. Tuya IoT 개발자 계정이나 클라우드 프로젝트가 필요하지 않습니다. 웹 UI와 Docker 또는 Home Assistant를 사용하거나, 로컬에서 CLI를 실행할 수 있습니다.
<picture>
<source media="(prefers-color-scheme: dark)" srcset="docs/screenshots/header-devices-dark.png">
<source media="(prefers-color-scheme: light)" srcset="docs/screenshots/header-devices-light.png">
<img alt="Tuya Local Key device list preview with 60 demo devices" src="https://raw.githubusercontent.com/vineetchoudhary/tuya-local-key/HEAD/docs/screenshots/header-devices-light.png">
</picture>
기능 (Features)
- 로컬 키, 장치 상세 정보, Node ID 및 데이터 포인트를 확인하고 복사합니다.
- VLAN을 넘나들며 로컬 IP 주소와 프로토콜 버전을 찾습니다.
- 변경된 키, IP 주소, 프로토콜 버전 및 장치를 감지합니다.
- 홈별로 필터링하거나, 검색 또는 제외할 장치로 CSV를 내보내고 재시작 시에도 암호화된 캐시를 유지합니다.
- tuya-local, localtuya, tinytuya에 대한 설정 값을 얻습니다.
빠른 시작 (Quick Start)
Home Assistant
Home Assistant OS에서 이 저장소를 추가한 다음, 앱 스토어에서 Tuya Local Key를 설치하고 시작합니다. 사이드바에서 열고 로그인합니다.
Add repository to Home Assistant
Docker Compose
이 저장소에서 docker-compose.yml을 사용하여 실행합니다:
http://localhost:8000에 접속하여 로그인합니다.
Docker
게시된 Docker 이미지를 실행합니다:
Open http://localhost:8000에서 접속한 후, Smart Life 사용자 코드를 입력하고 앱에서 QR 코드를 스캔하여 확인하세요.
웹 UI는 기본적으로 인증 기능이 없습니다. localhost 외부에서 접근하려면 AUTH_USERNAME과 AUTH_PASSWORD를 모두 설정하고 보안 가이드를 참고하세요.
CLI
이 저장소에서 실행하세요:
./setup.sh
.venv/bin/python tuya_devices.py
QR 로그인 프롬프트를 따르세요. 옵션은 CLI 가이드를 참고하세요.
문서 (Documentation)
- 설치(Installation) — Home Assistant, Docker, Docker Compose 및 소스 설정 방법.
- 앱 사용법(Using the app) — QR 로그인, 기기 상세 정보, 로컬 통합 및 블루투스 기기.
- 네트워크 스캔(Network scanning) — 로컬 IP, 프로토콜 버전, VLAN, 게이트웨이 및 스캔 상태.
- 캐싱 및 변경 사항(Caching and changes) — 저장된 기기, 오프라인 스냅샷 및 변경 감지.
- 설정(Configuration) — 환경 변수 및 보안.
- CLI — 터미널 설정, 명령어 및 플래그.
- 문제 해결(Troubleshooting) — 일반적인 로그인, 키 및 연결 문제.
- 스크린샷(Screenshots) — 라이트 및 다크 미리보기.
- 프론트엔드 구조(Frontend structure): 템플릿, 스타일시트, JavaScript 모듈 및 개발 검사 사항.
라이선스 (License)
Tuya Local Key는 Apache License, Version 2.0에 따라 라이선스가 부여됩니다. 귀속 정보(attribution information)는 NOTICE를 참고하세요.
지원 (Support)
이 프로젝트가 유용했다면 지속적인 개발을 위해 후원하는 것을 고려해 주세요.
<a href="https://github.com/sponsors/vineetchoudhary">
<img src="https://img.shields.io/badge/Sponsor%20on%20GitHub-EA4AAA?style=for-the-badge&logo=github&logoColor=white" alt="Sponsor on GitHub" height="50">
</a>
<a href="https://buymeacoffee.com/vineetchoudhary">
<img src="https://img.shields.io/badge/Buy%20me%20a%20coffee-FFDD00?style=for-the-badge&logo=buy-me-a-coffee&logoColor=black" alt="Buy Me a Coffee" height="50">
</a>
오픈 소스를 지원해 주셔서 감사합니다! 🙏
