Как подключить Portainer к Home Assistant и управлять Docker-контейнерами не выходя из умного дома
Интеграция Portainer для Home Assistant — это мост между вашим умным домом и инфраструктурой Docker. Она использует API Portainer в качестве интерфейса, позволяя управлять контейнерами, образами, сетями и томами прямо из интерфейса Home Assistant.
Portainer — это легковесный и удобный веб-интерфейс для управления Docker. Он работает на любом хосте с Docker или в кластере Swarm, предоставляя графическую панель для контроля за всеми аспектами работы контейнеров: от запуска и остановки до мониторинга логов и использования ресурсов.
API Portainer, в свою очередь, открывает программный доступ к тем же функциям. Благодаря этому интеграция для Home Assistant может:
- выводить список всех контейнеров с их статусами;
- запускать, останавливать, перезапускать и удалять контейнеры;
- просматривать и управлять Docker-образами, сетями и томами;
- получать информацию о потреблении ресурсов (CPU, RAM) каждым контейнером.
В результате вы получаете возможность управлять Docker-средой своего умного дома (например, сервисами вроде Zigbee2MQTT, Mosquitto, Node-RED, Frigate, ESPHome и др.) прямо из интерфейса Home Assistant — без необходимости заходить в отдельную веб-панель Portainer или использовать командную строку.
В этой статье мы пошагово разберем, как настроить подключение, получить Access Token и добавить интеграцию в Home Assistant.
Содержание статьи
1. Интеграция Portainer через HACS
Установите через HACS интеграцию *
- Откройте Home Assistant по адресу:
https://localhost:8123(или ваш внешний адрес) - Перейдите в Настройки → Устройства и службы → Добавить интеграцию
- Найдите и выберите "Portainer"
* Если вы еще не установили HACS, нажмите на кнопку выше
2. Соединение докеров через API
Шаг 1. Создаем Access Token в Portainer
- Откройте Portainer по адресу:
https://localhost:9000(или ваш внешний адрес) - Нажмите на иконку шестеренки Settings (Настройки) в левом меню
- В правом верхнем углу нажмите на свой аккаунт (обычно admin) и выберите My account (Мой профиль)
- Прокрутите страницу в самый низ до раздела Access tokens
- Нажмите Add access token (Добавить токен)
- Введите действующий пароль от административной панели Portainer
- Добавьте примечание (например, "для Home Assistant"), чтобы не забыть, для чего токен
- Скопируйте сгенерированный токен
Шаг 2. Подключаем интеграцию в Home Assistant
- Вернитесь в Home Assistant
- В поле URL укажите адрес вашего Portainer-контейнера (например,
http://192.168.1.100:9000илиhttps://localhost:9000) - В поле Access Token вставьте скопированный ранее токен
- Нажмите Подтвердить (или Submit)
Шаг 3. Создаем пространство для управления контейнерами
- После подтверждения интеграция попросит указать пространство (entity/area), куда будут добавлены элементы управления контейнерами
- Удобнее всего создать новое пространство с одноименным названием — например, "Portainer" или "Docker контейнеры"
- Это позволит сгруппировать все кнопки управления (запуск/остановка/перезапуск) и датчики (статус, CPU, RAM) в одном месте
3. Создание графической панели и возможности редактирования
После установки интеграции на главной странице «Обзор» появится пространство с названием Portainer (или как вы его назвали). Откройте его.
💡 Для удобства: пространство можно вынести в боковую панель — так вы будете иметь быстрый доступ к управлению контейнерами из любого места Home Assistant.
📋 Вариант 1 — через сенсоры и настройки
Этот способ подходит, если вам нужно управление контейнерами (запуск/остановка) и мониторинг состояния.
- Откройте Настройки в боковой панели → «Панели» → нажмите «Добавить панель»
- Выберите вариант «Создать новую панель» и задайте произвольное название (например, Portainer)
- Вернитесь в пространство Portainer на главной странице и нажмите на название любого контейнера
- Прокрутите страницу вниз — там будут блоки:
🎨 Настройка визуального отображения (для красивого вида)
Чтобы панель выглядела аккуратно и была удобной, можно настроить внешний вид разделов и плиток:
- Откройте вашу панель Portainer в боковой панели
- Нажмите на троеточие (⋯) в правом верхнем углу → «Редактирование панели»
- Нажмите «Изменить» у раздела, который хотите настроить
Для удобства поставьте ширину 2 — раздел будет занимать оптимальное место на экране
ширина раздела → 2
Настройки → Содержимое:
- Макет содержимого → «Вертикальный»
- Цвет → на ваше усмотрение
Компоновка:
- Автоматическая высота → Включить
- Во всю ширину → Включить
Вертикальная плитка с управлением и статусом
✅ Готово! Теперь у вас есть удобная панель для управления Docker-контейнерами прямо из Home Assistant.