OpenSpeedTest CLI для Home Assistant

Кастомная интеграция для Home Assistant, которая запускает OpenSpeedTest CLI и публикует результаты замеров в виде сущностей.

Репозиторий: https://github.com/thebestbaduser/openspeedtest-homeassistant

Возможности

• Сенсоры: Download, Upload, Ping, Jitter
• Кнопка Запустить тест для ручного замера
• Автоматические тесты по расписанию (по умолчанию каждые 6 часов)
• Настройка сервера, потоков и длительности теста через UI
• Автозагрузка CLI в директорию config при первой настройке
• Опциональная отправка результатов на OpenSpeedTest.ru

Требования

Компонент	Версия
Home Assistant	2023.8+
Python	3 (уже есть в HA)
OpenSpeedTest CLI	openspeedtest.ru/cli

CLI — один Python-скрипт без внешних зависимостей.

---

Установка через HACS

1. Установите HACS
2. HACS → Integrations → ⋮ → Custom repositories
3. Добавьте репозиторий:
   • URL: https://github.com/thebestbaduser/openspeedtest-homeassistant
   • Category: Integration
4. Найдите OpenSpeedTest CLI → Download
5. Перезагрузите Home Assistant
6. Settings → Devices & Services → Add Integration → OpenSpeedTest CLI

Первая настройка

Поле	Рекомендация
Path to CLI	/config/openspeedtest-cli (по умолчанию)
Download CLI	Включить, если файла ещё нет
Scan interval	21600 (6 ч), минимум 900 (15 мин)
Submit results	Выключено, если не нужна отправка на сайт

---

Ручная установка интеграции

Скопируйте папку custom_components/openspeedtest_cli в:

/config/custom_components/openspeedtest_cli/

Перезагрузите Home Assistant.

---

Где хранить CLI

Что такое /config

/config — постоянная директория конфигурации Home Assistant. В ней лежат configuration.yaml, .storage/, custom_components/ и другие данные.

Тип установки	Путь внутри HA	Где на диске хоста
Container / HA OS	/config	Volume, который вы смонтировали при установке
Core (venv)	~/.homeassistant или своя папка	Указана при установке

HACS обновляет интеграцию именно в /config/custom_components/, а не по номеру коммита GitHub.

Почему CLI должен быть в /config

При обновлении Home Assistant контейнер пересоздаётся. Всё внутри образа (/usr/local/bin, apt install и т.д.) пропадает. Директория /config — единственная постоянная.

Рекомендуемый путь:

/config/openspeedtest-cli

Интеграция может скачать CLI туда автоматически (галочка при настройке) или вручную:

curl -sLo /config/openspeedtest-cli https://openspeedtest.ru/cli/openspeedtest-cli
sed -i 's/\r$//' /config/openspeedtest-cli   # исправить CRLF, если нужно
chmod +x /config/openspeedtest-cli
/config/openspeedtest-cli --help

---

Настройки после установки

Settings → Devices & Services → OpenSpeedTest CLI → Configure

Параметр	Описание	По умолчанию
Path to CLI	Путь к исполняемому файлу	/config/openspeedtest-cli
Scan interval	Интервал автотестов (сек)	21600 (6 ч)
Server ID	ID сервера (пусто = автовыбор)	—
Threads	Потоки теста	8
Duration	Длительность download/upload (сек)	10
Submit results	Отправка на openspeedtest.ru	false
API key	Ключ из личного кабинета	—

Минимальный интервал — 900 секунд (15 минут). Тесты нагружают канал.

При перезапуске HA сразу показываются последние сохранённые результаты — новый тест запускается только если истёк интервал обновления. Первый тест (если истории ещё нет) стартует через 30 секунд после загрузки.

---

Сущности

Entity ID	Описание
sensor.<имя>_download	Скорость скачивания (Mbit/s)
sensor.<имя>_upload	Скорость отдачи (Mbit/s)
sensor.<имя>_ping	Ping (ms)
sensor.<имя>_jitter	Jitter (ms)
button.<имя>_run_test	Запуск теста вручную

Атрибуты сенсоров: server, last_run, error.

---

Автоматизация

Уведомление при падении скорости ниже 50 Mbit/s:

automation:
  - alias: "Низкая скорость скачивания"
    trigger:
      - platform: numeric_state
        entity_id: sensor.openspeedtest_cli_download
        below: 50
    action:
      - service: notify.mobile_app
        data:
          message: >
            Скорость скачивания: {{ states('sensor.openspeedtest_cli_download') }} Mbit/s
            (сервер: {{ state_attr('sensor.openspeedtest_cli_download', 'server') }})

---

Обновление через HACS

HACS смотрит версию в manifest.json на ветке main, а не номер коммита.

1. HACS → Integrations → OpenSpeedTest CLI
2. Update или ⋮ → Redownload
3. При проблемах: HACS → ⋮ → Clear cache
4. Перезагрузить Home Assistant

Проверка установленной версии:

grep '"version"' /config/custom_components/openspeedtest_cli/manifest.json

---

Устранение неполадок

HACS не обновляет версию

Убедитесь, что файлы обновились на диске HA, а не только скачались на компьютер:

grep version /config/custom_components/openspeedtest_cli/manifest.json

Если версия старая — Redownload + Clear cache + перезагрузка HA.

Принудительное обновление одного файла:

wget -O /config/custom_components/openspeedtest_cli/config_flow.py \
  https://raw.githubusercontent.com/thebestbaduser/openspeedtest-homeassistant/main/custom_components/openspeedtest_cli/config_flow.py

/usr/bin/env: 'python3\r': No such file or directory

Скрипт с Windows-переводами строк (CRLF):

sed -i 's/\r$//' /config/openspeedtest-cli
chmod +x /config/openspeedtest-cli

Интеграция при автозагрузке исправляет CRLF автоматически.

Скачивание/отдача = 0,00 Mbit/s, пинг нормальный

1. Запустите тест вручную кнопкой Запустить тест и подождите ~60 сек
2. Проверьте CLI напрямую:

/config/openspeedtest-cli --no-submit --threads 8 --duration 10

Если и в CLI нули — проблема в сетевом доступе из контейнера HA до серверов OpenSpeedTest.

Ошибка invalid int value: '8.0'

Обновите интеграцию до 1.0.3+ (исправлено приведение типов NumberSelector).

Настройки не открываются (500 Internal Server Error)

Обновите интеграцию до 1.0.7+ (исправлен options flow).

---

Иконка

• HACS — icon.png в корне репозитория
• Home Assistant 2026.3+ — custom_components/openspeedtest_cli/brand/icon.png и logo.png (страница интеграций и устройств)

Лицензия

MIT — см. LICENSE.