CloudPub для Home Assistant: внешний доступ без белого IP

CloudPub Client — неофициальное дополнение для Home Assistant, которое открывает внешний доступ к вашей системе и другим локальным сервисам без белого IP-адреса. Клиент поднимает туннель до серверов CloudPub, а вы получаете HTTPS-ссылку вида https://….cloudpub.ru.

Это удобная альтернатива KeenDNS, Dataplicity, Ngrok, Cloudflared и похожим сервисам — особенно если провайдер выдаёт серый IP за NAT и проброс портов недоступен.

Что даёт дополнение

• доступ к Home Assistant из интернета без публичного IP;
• HTTPS «из коробки» на стороне CloudPub;
• для веб-интерфейса HA обычно хватает бесплатного тарифа;
• при необходимости можно опубликовать и другие локальные сервисы (MQTT, RTSP и т.д. — уже на PRO).

Дополнение неофициальное и не связано с командой CloudPub — это add-on от сообщества: репозиторий black-roland/hassio-addon-cloudpub.

Как добавить репозиторий в Home Assistant

Нужен Home Assistant OS / Supervised с магазином дополнений.

1. Откройте Настройки → Дополнения → Магазин дополнений.
2. В правом верхнем углу нажмите меню (три точки) → Репозитории.
3. Добавьте URL:
   https://github.com/black-roland/hassio-addon-cloudpub
4. Обновите список и установите CloudPub Client (стабильная версия; Canary — только для тестов).

Можно сразу открыть установку через кнопку на странице репозитория или ссылку My Home Assistant:
Установить CloudPub Client.

Разрешите обратный прокси в Home Assistant

Без этого при открытии внешней ссылки часто будет 400: Bad Request — HA по умолчанию не доверяет заголовкам от прокси.

1. Перейдите в Настройки → Система → Сеть.
2. В блоке HTTP-сервер → Обратный прокси включите Доверять X-Forwarded-For.
3. Добавьте доверенный прокси: 172.30.33.0/24.
4. Сохраните настройки.

Для типичной установки HA OS менять подсеть не нужно. Если HA стоит нестандартно (например, Proxmox), смотрите IP в логах после попытки входа и подставьте свой диапазон.

API-ключ и публикация Home Assistant

1. Зарегистрируйтесь в личном кабинете CloudPub и скопируйте ключ API (раздел «Привяжите приложение к аккаунту»). Можно вставить и сам токен, и команду вида ./clo set token ….

2. В дополнении откройте вкладку Конфигурация: вставьте ключ и добавьте публикацию для Home Assistant.

В большинстве случаев укажите порт 8123 — стандартный порт веб-интерфейса HA. Если у вас другой порт, подставьте его:

name: homeassistant
type: http
local_addr: homeassistant:8123

Можно указать только homeassistant без порта — клиент попробует определить порт сам. Явно прописать :8123 (или ваш порт) обычно надёжнее.

3. Сохраните конфигурацию и запустите дополнение (лучше сразу включить автозапуск).

Где взять ссылку для входа извне

Ссылку для подключения к Home Assistant из интернета нужно искать в логах дополнения: откройте CloudPub Client → вкладка Журнал. После успешного старта там появится публичный URL вида https://….cloudpub.ru — по нему и заходите во внешний интерфейс HA.

Ту же ссылку можно позже посмотреть в личном кабинете CloudPub, но сразу после запуска удобнее взять её именно из журнала add-on.

Минимальный пример конфигурации

token: ВАШ_API_КЛЮЧ
clo_log_level: info
services:
  - name: homeassistant
    type: http
    local_addr: homeassistant:8123

Подробности параметров — в официальной документации дополнения: cloudpub/DOCS.md.

Если что-то не открывается

• 400 Bad Request — проверьте доверенный прокси 172.30.33.0/24 и опцию X-Forwarded-For.
• Таймаут при старте / нет связи с CloudPub — убедитесь, что DNS не блокирует cloudpub.ru (часто виноваты фильтрующие резолверы вроде Quad9).
• Для разбора проблем временно поставьте уровень логирования debug и смотрите вкладку «Журнал».

Вопросы по самому add-on удобнее задавать в GitHub Discussions; по работе сервиса CloudPub — в их поддержку.

Итог

Добавили репозиторий → установили CloudPub Client → разрешили прокси в сети HA → вставили API-ключ → опубликовали homeassistant:8123 (или ваш порт) → взяли внешнюю ссылку из логов дополнения (вкладка «Журнал»). Внешний доступ к Home Assistant без белого IP готов.