Tuya-Local 完整指南让 1000 涂鸦设备在 Home Assistant 中实现本地控制【免费下载链接】tuya-localLocal support for Tuya devices in Home Assistant项目地址: https://gitcode.com/GitHub_Trending/tu/tuya-local家里断网的那一刻墙上的智能开关、房间里的电暖器全部变成砖是不是让你对云端控制四个字印象很差Tuya-Local 就是一个专为 Home Assistant 制作的集成目标是让运行涂鸦固件的设备绕过 Tuya 云直接在局域网里被本地控制。 本地控制到底意味着什么接入本地通道后控制命令从 Home Assistant 出发经局域网直接到达设备不再绕道云端再回来响应明显变快也基本不再受外网质量影响——断网时家里该开的灯、该关的阀照样能操作。需要说清楚的一点本地控制并不阻止设备继续向涂鸦云上报状态所以别把它当成安全措施它的价值是更快、更稳的控制体验部分设备上还能解锁云端 API 没有提供的功能。 支持哪些设备官方维护的设备清单超过 1000 种覆盖日常智能家居的主要场景暖通类电暖器、空调、热泵、热水器、温控器、风扇厨房类电水壶、空气炸锅、洗碗机、烤箱环境类空气净化器、除湿机、加湿器、香薰机能源类智能电表、断路器、EV 充电桩安防类警号、摄像头、门铃、门锁、报警面板照明与控制类灯泡、灯带、开关、排插、窗帘电机、扫地机、宠物喂食器等完整列表见仓库根目录的 DEVICES.md每个设备对应的 YAML 配置都放在 custom_components/tuya_local/devices/ 目录下按品类组织方便按型号定位。️ 安装推荐走 HACS手动为备选推荐路径是 HACS先装好 HACS添加自定义仓库地址https://gitcode.com/GitHub_Trending/tu/tuya-local添加仓库时才需要用到它然后在集成页面搜索并安装 Tuya-Local重启 Home Assistant 即可。备选路径是手动安装把仓库克隆到custom_components目录仓库地址同上重启后集成同样会出现。两条路径殊途同归HACS 的好处是后续更新方便。首次配置4 个字段填对三步走完安装后进入 设置 → 设备与服务 → 添加集成整个流程分三个阶段核心就是第一阶段填对连接信息Host设备的 IP 地址或主机名Device ID设备 ID可在涂鸦开发者平台查到Local Key本地密钥与 Device ID 同源设备配对时生成是本地通道的钥匙Protocol Version协议版本不确定就选auto。阶段一结束时集成会尝试连接设备并读取数据阶段二从设备实际上报的数据点中筛选出匹配的候选类型从 1000 配置中挑一个选错类型需要删掉重建因为不同类型生成的实体不同阶段三给设备起一个唯一名称作为实体名基础。⚠️ 连不上或行为异常先查这 3 件事密钥是否因重新配对而失效。Local Key 在每次重新配对后都会改变——如果你拿旧密钥配好后又用厂商 App 重连过一次密钥已经换了重新获取即可。是否有多个应用在抢占连接。涂鸦设备通常只允许一个本地连接关掉局域网里厂商 App 的后台确认没有其他集成含 localtuya 之类也在连同一台设备。协议版本是否误判。个别 3.2 / 3.22 / 3.4 设备可能被识别成 3.3反之亦然若设备响应不规律可手动指定 3.1、3.2、3.3 等版本逐一尝试。另外两条硬限制要提前知道门窗传感器、烟雾报警这类电池供电设备因省电策略限制基本无法本地连接通过集线器接入的子设备支持有限每个子设备占用一条独立连接而集线器一般只能承受 1~3 条。若怀疑设备本身不被支持查一下 Home Assistant 日志里打印的数据点dps信息对照 devices/README.md 确认。如果你的设备不在清单里把日志中的 dps 数据点和型号信息提交为 issue或直接按 devices 目录的说明提交 PR——这份 1000 的名单就是社区一个设备一个设备攒出来的。【免费下载链接】tuya-localLocal support for Tuya devices in Home Assistant项目地址: https://gitcode.com/GitHub_Trending/tu/tuya-local创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考