易微联设备接入教程
易微联（eWeLink / Sonoff）设备接入用于把使用「易微联」App 配网的 Sonoff 等设备接入 Home Assistant。本教程通过 HACS 安装「Sonoff LAN」集成，再用易微联账号完成接入。
| 名称 | OS | Core | Sonoff |
|---|---|---|---|
| 版本 | 17.0 | 2025.2.1 | — |
在开始之前，请确认：
- 已安装 HACS，建议先查看「HACS 使用方法」后再进行本教程。
- 已将设备接入「易微联（eWeLink）」App，并完成配网。
- 拥有一个易微联账号（手机号需带 +86 区号）。
第 1 步：在 HACS 中下载「Sonoff LAN」
Section titled “第 1 步：在 HACS 中下载「Sonoff LAN」”进入 HACS，搜索 Sonoff LAN，进入后点击下载。
第 2 步：重启 Home Assistant
Section titled “第 2 步：重启 Home Assistant”依次点击 设置 > ︙（右上角菜单）> 重启 Home Assistant > 重启 Home Assistant > 重新启动，让刚下载的集成生效。
第 3 步：在 HA 中添加 Sonoff 集成
Section titled “第 3 步：在 HA 中添加 Sonoff 集成”依次点击 设置 > 设备与服务 > 集成 > 添加集成，搜索 sonoff。
第 4 步：输入账号密码完成接入
Section titled “第 4 步：输入账号密码完成接入”输入账号（务必填写 +86）和密码，点击提交，随后点击完成。
| 问题 | 解决办法 |
|---|---|
| 搜不到 Sonoff 集成 | 确认已在 HACS 中下载「Sonoff LAN」并完整重启过 Home Assistant（第 2 步）。 |
| 登录失败 | 账号需填写带 +86 区号的手机号，并确认密码正确，与易微联 App 登录信息一致。 |
| 设备不显示或离线 | 确认设备已在易微联 App 中正常配网，且与 HA 处于同一局域网。 |
易微联设备接入的核心流程是：在 HACS 中下载 Sonoff LAN → 重启 Home Assistant → 添加 Sonoff 集成 → 输入易微联账号（+86）和密码完成接入，完成后即可在 Home Assistant 中管理 Sonoff 设备。