Установка SonoffLAN в Home Assistant (Docker/Synology)

Инструкция по установке кастомной интеграции SonoffLAN для управления устройствами Sonoff с оригинальной прошивкой eWeLink.

HACS (Home Assistant Community Store) — магазин кастомных интеграций для Home Assistant.

1. Перейди на страницу релизов: https://github.com/hacs/integration/releases/latest
2. Скачай файл hacs.zip
3. Распакуй архив — получишь папку hacs

Открой папку конфигурации Home Assistant. Для Synology путь обычно:

\\NAS\docker\homeassistant\

или через File Station:

/volume1/docker/homeassistant/

Создай папку custom_components если её нет.

Скопируй папку hacs внутрь custom_components.

Структура должна выглядеть так:

homeassistant/
├── custom_components/
│   └── hacs/
│       ├── __init__.py
│       ├── manifest.json
│       └── ...
├── configuration.yaml
└── ...

Перезапусти контейнер Home Assistant через Container Manager или командой:

docker restart homeassistant

1. Очисти кэш браузера: Ctrl+Shift+R (Windows/Linux) или Cmd+Shift+R (Mac)
2. Перейди: Settings → Devices & Services → Add Integration
3. В поиске введи: HACS
4. Прими условия использования (все галочки)
5. Пройди авторизацию через GitHub:
   • Перейди по предложенной ссылке
   • Введи код активации
   • Разреши доступ для HACS

После успешной авторизации HACS появится в боковом меню.

1. Открой HACS в боковом меню
2. Перейди в раздел Integrations
3. Нажми кнопку + Explore & Download Repositories (правый нижний угол)
4. В поиске введи: SonoffLAN
5. Выбери интеграцию от AlexxIT
6. Нажми Download
7. Подтверди загрузку

После загрузки интеграции обязательно перезапусти Home Assistant:

Settings → System → Restart

1. Перейди: Settings → Devices & Services → Add Integration
2. В поиске введи: Sonoff
3. Выбери интеграцию Sonoff
4. Введи учётные данные от приложения eWeLink:
   • Email или телефон
   • Пароль
5. Выбери режим работы:
   • auto (рекомендуется) — использует LAN когда возможно, иначе облако
   • local — только локальная сеть
   • cloud — только облако

После настройки все устройства Sonoff из аккаунта eWeLink появятся в Home Assistant.

Перейди: Settings → Devices & Services → Sonoff

Здесь отображаются все подключённые устройства и их статус (online/offline).

Перейди: Settings → System → System Health

В разделе Sonoff будет показано количество устройств online.

При проблемах проверь логи: Settings → System → Logs

Используй фильтр sonoff для поиска связанных записей.

• Очисти кэш браузера: Ctrl+Shift+R
• Попробуй режим инкогнито
• Проверь наличие файлов в папке custom_components

• Docker должен работать с --network host
• Виртуальные машины должны использовать bridge mode (не NAT)
• Проверь работу Multicast/mDNS в сети

Если используешь один аккаунт в нескольких системах (другой HA, Homebridge и т.д.), создай второй аккаунт eWeLink и расшарь на него устройства.

• SonoffLAN на GitHub
• Официальный сайт HACS
• Home Assistant