企业官网建设流程全解析

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 件事

1. 密钥是否因重新配对而失效。Local Key 在每次重新配对后都会改变——如果你拿旧密钥配好后又用厂商 App 重连过一次，密钥已经换了，重新获取即可。
2. 是否有多个应用在抢占连接。涂鸦设备通常只允许一个本地连接：关掉局域网里厂商 App 的后台，确认没有其他集成（含 localtuya 之类）也在连同一台设备。
3. 协议版本是否误判。个别 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