5分钟完成SonoffLAN设置：轻松集成eWeLink设备到Home Assistant
【免费下载链接】SonoffLANControl Sonoff Devices with eWeLink (original) firmware over LAN and/or Cloud from Home Assistant项目地址: https://gitcode.com/gh_mirrors/so/SonoffLAN
SonoffLAN是一个功能强大的Home Assistant自定义组件，专为控制使用eWeLink原厂固件的Sonoff设备而设计。无论您是智能家居新手还是经验丰富的用户，这个组件都能让您在5分钟内完成eWeLink设备与Home Assistant的完美集成，无需刷机或修改固件！
📋 准备工作：确保环境就绪
在开始之前，请确保您的系统满足以下要求：
必备条件清单：
- ✅ 已安装并运行Home Assistant（建议最新版本）
- ✅ 拥有eWeLink账户和已配对的Sonoff设备
- ✅ 设备与Home Assistant在同一局域网内（用于LAN模式）
- ✅ 网络支持mDNS/zeroconf多播（用于自动发现设备）
专业提示：如果您使用Docker运行Home Assistant，请确保使用
--network host模式以获得最佳局域网连接效果。
🔧 安装SonoffLAN组件：两种简单方法
方法一：通过HACS安装（推荐）
这是最简单快捷的安装方式：
- 打开Home Assistant，进入HACS集成商店
- 点击"集成"→ "浏览并下载存储库"
- **搜索"SonoffLAN"**并选择该组件
- **点击"下载此存储库"**完成安装
- 重启Home Assistant使组件生效
方法二：手动安装（适合高级用户）
如果您更喜欢手动控制，可以按照以下步骤操作：
cd /config/custom_components git clone https://gitcode.com/gh_mirrors/so/SonoffLAN.git sonoff或者从最新发布版本下载并解压sonoff文件夹到custom_components目录。
⚙️ 配置集成：三步完成设置
第一步：添加集成到Home Assistant
- 进入Home Assistant设置 → 设备与服务 → 集成
- 点击"添加集成"按钮
- 搜索并选择"Sonoff"
- 按照提示输入您的eWeLink账户信息
第二步：选择最佳连接模式
SonoffLAN提供三种连接模式，满足不同需求：
| 模式 | 特点 | 适用场景 |
|---|---|---|
| 自动模式 | 同时使用LAN和云连接，智能切换 | 大多数用户（推荐） |
| 仅LAN模式 | 仅通过局域网连接 | 网络环境稳定，注重隐私 |
| 仅云模式 | 仅通过eWeLink云服务器连接 | 设备不在同一局域网 |
专家建议：使用auto模式，这样即使局域网连接不稳定，设备仍可通过云连接保持可用，实现双重保障。
第三步：选择家庭和设备
如果您的eWeLink账户中有多个家庭，可以在这里选择要加载哪些家庭的设备。默认情况下，组件只加载当前活跃家庭的设备。
🎯 核心功能与优势
双重连接保障系统
SonoffLAN的最大特色是同时管理本地和云控制！这意味着：
- 本地优先：设备在局域网内时，使用本地连接，响应更快（毫秒级）
- 云端备份：当本地连接不可用时，自动切换到云连接
- 无需刷机：直接使用原厂eWeLink固件
- 全面兼容：支持DIY模式和非DIY模式设备
广泛设备支持
组件支持几乎所有主流Sonoff设备类型：
- ✅开关类：单通道和多通道开关（Sonoff Basic, Mini等）
- ✅监测类：功率监测设备（Sonoff Pow, POWR2）
- ✅传感器类：温湿度传感器（Sonoff TH系列）
- ✅桥接类：RF Bridge 433射频桥接器
- ✅摄像头类：Sonoff GK-200MP2-B等
- ✅智能家居：风扇、灯光、窗帘控制器等
完整的设备支持列表可以在custom_components/sonoff/core/devices.py中找到。
🔧 高级配置选项
自定义设备类型转换
您可以将开关转换为其他设备类型，实现更智能的控制：
sonoff: devices: 1000xxxxxx: device_class: light name: 客厅主灯 1000yyyyyy: device_class: [light, fan] name: 卧室多功能控制器传感器扩展配置
如果需要显示更多设备属性作为传感器：
sonoff: sensors: [staMac, bssid, host, rssi]RF Bridge高级配置
对于RF Bridge设备，可以精细配置传感器类型和超时设置：
sonoff: rfbridge: "门磁传感器": device_class: door timeout: 5 "人体传感器": device_class: motion timeout: 60🚨 常见问题快速解决
问题一：设备不显示？
排查步骤：
- 检查设备是否支持本地协议（参考DEVICES.md）
- 确认网络支持mDNS多播
- 检查防火墙设置是否允许局域网通信
- 如果是Docker环境，确保使用
--network host模式
问题二：连接不稳定？
解决方案：
- 切换到
auto模式（推荐） - 启用集成配置中的调试页面
- 检查系统健康页面上的在线设备数量
- 查看日志中的警告和错误信息
问题三：功率传感器不更新？
重要提醒：从2026年开始，功率、电流和电压传感器将不再通过云连接更新。这些设备需要本地连接才能获取实时数据。
📊 监控与管理功能
系统健康检查
进入Home Assistant的"系统健康"页面，查看SonoffLAN集成的状态：
- 📈在线设备数量：实时显示连接状态
- 🔗连接模式：查看当前使用的连接方式
- ⏰最后更新时间：监控数据同步状态
调试页面功能
在集成配置中启用调试页面后，您可以访问：
- 📋详细集成日志：查看所有操作记录
- 🔍过滤和搜索：快速定位问题
- 🔄自动刷新选项：实时监控状态变化
诊断信息收集
如果需要技术支持，可以下载完整的诊断信息：
- 所有设备诊断：集成 → Sonoff → 三点菜单 → 下载诊断
- 单个设备诊断：设备 → 选择设备 → 下载诊断
💡 最佳实践建议
1.始终使用自动模式
这是最稳定可靠的配置方式，结合了本地响应的速度和云端连接的可靠性。
2.定期更新组件
关注custom_components/sonoff/的更新，获取新功能和修复。
3.备份配置
定期备份您的YAML配置文件，避免意外丢失配置。
4.测试自动化规则
在部署到生产环境前，充分测试自动化规则，确保逻辑正确。
5.加入社区交流
遇到问题时，参考已有的社区讨论，很多问题都有现成解决方案。
🎉 开始享受智能家居的便利！
现在您已经成功设置了SonoffLAN，可以开始：
- ⏰创建自动化场景：定时开关、感应触发、联动控制
- 🔗与其他集成联动：与Home Assistant其他组件无缝集成
- 🗣️语音助手控制：通过Google Assistant或Alexa语音控制
- 📊能源监控：实时监控设备能耗，优化用电
- 🔔状态通知：接收设备状态变化通知
SonoffLAN让您的eWeLink设备真正融入Home Assistant生态系统，享受本地控制的快速响应和云服务的可靠性。无论您是想简单控制几个开关，还是构建复杂的全屋自动化系统，这个组件都能满足您的需求。
记住：智能家居的乐趣在于不断探索和优化。从简单的自动化开始，逐步构建属于您的智能生活！从今天开始，让SonoffLAN为您开启智能家居的新篇章。
【免费下载链接】SonoffLANControl Sonoff Devices with eWeLink (original) firmware over LAN and/or Cloud from Home Assistant项目地址: https://gitcode.com/gh_mirrors/so/SonoffLAN
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
