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

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

===== Часть 1: Установка HACS =====

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

==== 1.1. Скачивание HACS ====

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

==== 1.2. Копирование файлов ====

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

<code>
\\NAS\docker\homeassistant\
</code>

или через File Station:

<code>
/volume1/docker/homeassistant/
</code>

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

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

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

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

==== 1.3. Перезапуск Home Assistant ====

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

<code bash>
docker restart homeassistant
</code>

==== 1.4. Добавление интеграции HACS ====

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

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

===== Часть 2: Установка SonoffLAN =====

==== 2.1. Загрузка интеграции через HACS ====

  - Открой **HACS** в боковом меню
  - Перейди в раздел **Integrations**
  - Нажми кнопку **+ Explore & Download Repositories** (правый нижний угол)
  - В поиске введи: ''SonoffLAN''
  - Выбери интеграцию от **AlexxIT**
  - Нажми **Download**
  - Подтверди загрузку

==== 2.2. Перезапуск Home Assistant ====

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

**Settings → System → Restart**

==== 2.3. Настройка интеграции Sonoff ====

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

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

===== Часть 3: Проверка работы =====

==== 3.1. Проверка устройств ====

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

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

==== 3.2. Проверка состояния системы ====

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

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

==== 3.3. Просмотр логов ====

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

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

===== Возможные проблемы =====

==== Интеграция не появляется в списке ====

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

==== Устройства недоступны в LAN-режиме ====

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

==== Постоянный разлогин из eWeLink ====

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

===== Полезные ссылки =====

  * [[https://github.com/AlexxIT/SonoffLAN|SonoffLAN на GitHub]]
  * [[https://hacs.xyz/|Официальный сайт HACS]]
  * [[https://www.home-assistant.io/|Home Assistant]]