2026-03-18 — Стабильный 2.40.5
2.40.5 — стабильная точка, в которой мартовские изменения Home Assistant add-on и release engineering наконец совпали с фактическим runtime и документацией.
Что вошло в релиз
Заголовок раздела «Что вошло в релиз»Ручные port overrides без поломки HA ingress
Заголовок раздела «Ручные port overrides без поломки HA ingress»Теперь можно задавать верхнеуровневые WEB_PORT и BASE_LISTEN_PORT через веб-интерфейс, raw config и Home Assistant add-on options.
В режиме add-on установленный трек сохраняет свой фиксированный ingress-порт (8080 stable, 8081 RC, 8082 beta). Параметр WEB_PORT открывает дополнительный прямой host-network listener только если он отличается от дефолта этого трека.
Более безопасные side-by-side HA add-on треки
Заголовок раздела «Более безопасные side-by-side HA add-on треки»Упаковка add-on теперь рассматривает stable, rc и beta как отдельные install-треки с разными дефолтами:
| Трек | Каталог | Ingress по умолчанию | Базовый порт плееров | Startup |
|---|---|---|---|---|
| Stable | ha-addon/ | 8080 | 8928 | auto |
| RC | ha-addon-rc/ | 8081 | 9028 | manual |
| Beta | ha-addon-beta/ | 8082 | 9128 | manual |
Это позволяет держать stable на основном HAOS-узле и параллельно тестировать RC/Beta. Но caveat остаётся эксплуатационным: не направляйте несколько вариантов на одну и ту же Bluetooth-колонку, один и тот же адаптер или конфликтующие ручные порты.
Changelog-driven GitHub Releases
Заголовок раздела «Changelog-driven GitHub Releases»Workflow Create GitHub Release теперь использует CHANGELOG.md как канонический источник релиза:
- определяет целевой тег и канал
- синхронизирует
ha-addon/,ha-addon-rc/иha-addon-beta/наmainпо последним известным channel tags - собирает тело релиза из соответствующей секции changelog
- добавляет GitHub-generated notes только если они действительно дают полезный контекст
Это снова сделало release notes предсказуемыми и держит синхронизацию HA packaging в рамках одного release-движения.
Installed track vs update_channel
Заголовок раздела «Installed track vs update_channel»18 марта также был устранён давний источник путаницы:
- installed track — это add-on вариант, который реально установлен из HA Store
update_channel— только предпочитаемая lane для update-check и warning-текста внутри самого bridge
Сохранение rc или beta в UI больше не означает, что Home Assistant уже переключил установленный add-on.
HA-фиксы, найденные на живых системах
Заголовок раздела «HA-фиксы, найденные на живых системах»Живое HAOS-тестирование также дало фиксы, завершившие стабильный релиз:
- artwork остаётся на origin активного add-on при работе через ingress
- queue-команды solo-плееров продолжают работать даже при пустом discovery syncgroup-ов
- опциональные ручные add-on ports больше не ломают Supervisor validation, если оставить их пустыми
Почему этот релиз важен
Заголовок раздела «Почему этот релиз важен»2.40.5 важен не одной функцией, а тем, что делает всю историю поставки согласованной:
- runtime, add-on manifests и docs теперь описывают одну и ту же модель треков
- changelog-записи теперь реально ведут релизный нарратив, а не восстанавливаются постфактум
- stable / RC / beta тестирование на одном HAOS-хосте стало безопаснее и проще объясняется
- операторы получили явную семантику портов и треков вместо скрытого поведения Supervisor
Что дальше
Заголовок раздела «Что дальше»Эта запись — базовая точка для следующих заметок про обновление Starlight-документации, дальнейшую эволюцию add-on channels и архитектурную работу после стабилизационной волны 2.40.5.