Sonoff 接入 Home Assistant用 SonoffLAN 5 分钟装好断网也能本地控制【免费下载链接】SonoffLANControl Sonoff Devices with eWeLink (original) firmware over LAN and/or Cloud from Home Assistant项目地址: https://gitcode.com/gh_mirrors/so/SonoffLAN5 分钟后你的 Sonoff 开关就能直接在 Home Assistant 面板里开关不用再翻原厂 eWeLink App断网时也一样。SonoffLAN 是一个 Home Assistant 自定义组件通过局域网LAN和/或云连接控制刷原厂 eWeLink 固件的 Sonoff 设备全程无需刷机。照做完你的设备会以 switch、light、sensor 实体出现在设备列表里LAN 可达时状态即时刷新。 它帮你解决什么问题两个最常见的卡点家里想开灯操作却要等 eWeLink 云端一圈原厂固件本身支持本地协议但没有直接连进 Home Assistant 的通道断网时设备直接失联。刷 Tasmota 等第三方固件很折腾还可能丢掉官方固件自带的功率统计和能量记录。SonoffLAN 的定位一句话同时管理 LAN 和云两条连接通道本地负责速度云端负责兜底原厂固件原样保留。✅ 动手前确认这几件事Home Assistant 已正常运行走 HACS 安装则已装好 HACS有 eWeLink 账户设备已在官方 App 里配好并登录过设备与 Home Assistant 在同一局域网网络能传组播流量mDNS/zeroconf打开项目里的 DEVICES.md按型号查 Local Type 一栏是---的设备只支持云端其余都可以走本地 安装两条路选你的那条HACS 一键已装 HACS 就选这条打开 HACS → 集成 → 浏览存储库搜到 SonoffLAN 点下载重启 Home Assistant。适合大多数人之后升级也在 HACS 里点一下不用碰目录。手动安装没有 HACS、离线环境或想锁定版本只需两条命令cd /config git clone https://gitcode.com/gh_mirrors/so/SonoffLAN cp -r SonoffLAN/custom_components/sonoff custom_components/执行完sonoff 文件夹会出现在 /config/custom_components 下重启 Home Assistant 后组件即可加载。⚙️ 第一次运行跟着提示走打开 设置 → 设备与服务 → 集成点添加集成搜到 Sonoff 点添加。输入 eWeLink 账户的用户名和密码如果账户注册区域不是默认区域再选国家/地区代码如 86。提交后组件会登录云端把设备列表和加密 key 拉下来存到本地——断网时就是靠这份本地缓存继续工作。进集成选项齿轮图标连接模式选auto因为 LAN 可达时走本地、状态即时刷新LAN 掉线自动切云兜底纯 local 模式对组播要求高设备偶尔会失联不建议新手用。账户只有一个家庭的homes 勾选直接跳过多个家庭则勾选要加载哪些。刷新设备页Sonoff 设备已按开关、灯光、传感器分类就位点一下就能控制。注意即使是 local 模式也需要 eWeLink 凭据来取加密 key只有 DIY 模式设备可以免凭据。 装完之后能玩什么本地秒控LAN 内的开关操作不再绕云端自动化触发即时生效。断网续命外网断了auto 模式靠本地通道和已保存的设备列表继续工作。功率与能耗Sonoff Pow 系列提供功率、电流、电压、能量传感器2026 年起云端不再更新这几类传感器必须走本地连接才有实时数据。温湿度与空调TH 系列提供温湿度传感器和 thermostat支持 heat/cool/dry 三种模式空调控制走云端。433 射频桥RF Bridge 433 把门磁、人体传感器变成 Home Assistant 的二进制传感器和按钮最多学习 64 个信号。最高频的进阶需求是把开关实体改成灯光。在 configuration.yaml 里加sonoff: devices: 1000xxxxxx: device_class: light name: 客厅主灯保存并重启后这个 10 位 DeviceID 对应的开关实体就变成灯光实体可进灯组参与调光多通道设备写device_class: [light, fan]能拆成多个实体分别控制。 出问题了按这张表查症状常见原因动作设备列表里找不到设备纯 local 模式且组播不通或设备本身不支持本地协议切 auto 模式查 DEVICES.md 的 Local Type 栏Docker 部署改用--network host重启后所有设备离线local 模式靠组播自动发现有时要等几分钟先等几分钟长期不出现是路由器组播问题改用 auto 模式功率/电流/电压不更新2026 起云端已停推这类传感器确认设备走的是本地连接用连接类型传感器默认禁用核对状态刷新慢当前实际走的是云端通道检查 mDNS 是否生效、防火墙是否放行组播登录失败国家/地区代码没选对回第一步重填选账户注册区域对应的代码下一步在线设备数在系统健康页可见提 issue 前先确认它大于 0设置 → 设备 → 选设备 → 下载诊断把诊断文件附在 issue 里能省掉来回排查。从一条简单的定时开关自动化开始试起再逐步加传感器联动。【免费下载链接】SonoffLANControl Sonoff Devices with eWeLink (original) firmware over LAN and/or Cloud from Home Assistant项目地址: https://gitcode.com/gh_mirrors/so/SonoffLAN创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考