三星洗衣机、空调已经连上家里 Wi-Fi,接入 Home Assistant 却还要经过云端。LocalThings 做的事很直接:让 Home Assistant 在局域网里和这些家电通信,不需要给这个集成登录三星账号。
它适合已经在折腾 Home Assistant、又想少依赖一层云服务的人。不过,“本地控制”有几个边界,安装前最好先弄清楚。
能接哪些设备
LocalThings 是一个 Home Assistant 自定义集成,支持洗衣机、烘干机、冰箱、空调、洗碗机、烤箱等三星家电,扫地机器人目前属于早期支持。主要面向约 2022 年及之后的设备,也兼容部分采用旧接口的早期型号,不能简单理解成所有三星家电都能接。
接入后能用什么,取决于设备实际暴露的能力。常见项目包括开关、程序或模式、温度、剩余时间、门锁状态、能耗和滤网状态。支持推送的设备可以主动上报变化,其余设备默认每 30 秒检查一次。
这就给日常自动化留了空间:比如根据洗衣机状态做完成提醒,或把空调状态放进已有的家庭面板。具体能否远程启动,仍要看型号和家电上的远程控制开关,集成不会替设备解除这些限制。
怎么装
已经装了 HACS 的话,到 Integrations 搜索 LocalThings,下载后重启 Home Assistant。它已在 HACS 默认列表里,不用额外添加自定义仓库。
不使用 HACS,也可以把仓库里的 custom_components/localthings/ 复制到 Home Assistant 配置目录下的 custom_components/ 中,再重启。
随后打开:
设置 → 设备与服务 → 添加集成 → LocalThings
输入家电的 IP 地址。大多数受支持的设备会自动识别类型和型号,创建对应的设备与实体。部分旧设备还需要设备 token,另有一些型号不接受自动证书,需要额外提供预共享密钥,并非输完 IP 就一定能用。
本地控制,不等于从此完全脱离 SmartThings
首次添加家电时,集成会访问三星服务器一次,获取一个公开标识,不需要账号登录。后续添加设备会复用这个标识,正常的控制通信走本地网络。
但家电自己仍可能连接三星服务器,LocalThings 不会阻断这条连接。也别为了“去云端”直接把设备从 SmartThings 中删除:设备下次连接三星服务器时可能重置网络设置,导致 Wi-Fi 掉线,需要重新配网。部分洗衣机和烘干机在无法连接 SmartThings 时,还会停止累计能耗。
所以更准确的理解是:它让 Home Assistant 的控制链路少依赖云端,而不是把家电改造成彻底离线的产品。
还有一个容易忽略的限制:设备一次只接受一个连接。如果持续频繁重连,除了检查 Wi-Fi,也要排查网络里有没有其他程序同时占用设备连接。
适合谁
家里已经有三星联网家电,也在用 Home Assistant,值得先拿一台设备验证兼容性。它解决的是很具体的接入问题,没必要为了试这个项目专门买设备。
碰到型号不识别或少了某个控制项,集成会通过 Home Assistant 的 Repairs 提示导出诊断信息。导出过程会移除账号、token、设备标识和网络信息,可以用来向项目反馈设备支持问题。
项目信息
- 主要语言:Python
- License:MIT
- Star:截至 2026-11-07 约 969
- GitHub:GitHub - mbillow/localthings: Control your Samsung appliances from Home Assistant over your home network, with no cloud account. · GitHub