openHAB на Ubuntu 24.04: пошаговая установка

MAATRIX

Если Home Assistant у вас уже стоял и упирался в закрытость экосистемы или в нестабильность после очередного обновления интеграций, логично посмотреть в сторону openHAB — платформы на Java, которая с 2010-х делает ставку не на красивые карточки, а на протокольную независимость и предсказуемое поведение. Ниже — рабочая установка openHAB 4.x на чистый Ubuntu 24.04, без магии и с честным разбором того, что на облачном сервере работает из коробки, а что требует моста до локальной сети.

Что такое openHAB и когда его стоит ставить на сервер, а не на Raspberry Pi

openHAB (open Home Automation Bus) — это связующий слой между разнородными устройствами и протоколами умного дома: Zigbee, Z-Wave, KNX, MQTT, HTTP/REST API, Modbus и ещё полторы сотни биндингов. В отличие от Home Assistant, где основной язык конфигурации — YAML и Python-интеграции, openHAB исторически про декларативные .things/.items-файлы, правила на Java-подобном DSL или JavaScript (Jython тоже жив, но менее актуален), и про архитектуру на OSGi-контейнере поверх JVM. Это тяжелее по памяти, зато обновления реже ломают уже настроенные автоматизации — платформа старше и консервативнее в изменениях API.

Ставить openHAB на VPS, а не на Raspberry Pi у себя дома, имеет смысл в нескольких случаях:

• нужен стабильный аптайм без скачков напряжения, перегрева SD-карты и «не запустился после отключения света»;
• дом или квартира не единственная точка — есть дача, офис, несколько объектов, и хочется один центр с внешним доступом;
• вы делаете демо-стенд, тестовый инстанс для отладки правил перед раскаткой на боевой хаб, или преподаёте/показываете платформу другим;
• физические устройства (Zigbee-координатор, Z-Wave-палка) остаются дома на маленьком хосте, а «мозг» с логикой, историей и веб-интерфейсом выносится в облако для отказоустойчивости и удалённого доступа без пробрасывания портов домашнего роутера.

Важная оговорка сразу: у облачного VPS нет физического USB-порта рядом с вашим Zigbee-роутером. Если вся ваша периферия — это Zigbee-датчики на USB-палке, ей нужен либо локальный хост, либо сетевой мост. Разберём это отдельно в разделе про биндинги — это не блокер, но и не то, о чём стоит молчать.

Требования к серверу и выбор конфигурации

openHAB — Java-приложение, и JVM ест память заметно охотнее, чем Node.js-стек Home Assistant. Ориентиры по железу (это именно ориентиры, а не измеренные бенчмарки — у вас может отличаться в зависимости от числа биндингов и правил):

Меньше 2 ГБ RAM брать не стоит: сама JVM с настройками по умолчанию резервирует под кучу заметный кусок памяти, и на 1 ГБ сервер уходит в своп при первом же добавлении пары биндингов. Диск — SSD/NVMe обязательно, потому что openHAB активно пишет логи и, если включена persistence, событийную историю.

Инструкция ниже написана и проверена на актуальной на конец августа 2026 года ветке Ubuntu 24.04 LTS (Noble Numbat) с systemd и APT — команды одинаковые что на дешёвом VPS, что на выделенном сервере.

Установка Java 21 и openHAB на Ubuntu 24.04

openHAB 4.x требует Java 21. Ubuntu 24.04 несёт OpenJDK 21 в стандартных репозиториях, отдельный PPA не нужен.

Сначала базовое обновление системы и Java:

sudo apt update && sudo apt upgrade -y
sudo apt install -y openjdk-21-jre-headless
java -version

Вывод должен показать openjdk version "21...". Если у вас уже стоит другая версия Java (например, для другого сервиса на этом же сервере), переключите её через update-alternatives --config java — openHAB запускается тем java-бинарником, который первый в PATH.

Дальше подключаем официальный репозиторий openHAB и устанавливаем сам пакет:

sudo mkdir -p /etc/apt/keyrings
wget -qO - 'https://openhab.jfrog.io/artifactory/api/gpg/key/public' | \
  gpg --dearmor | sudo tee /etc/apt/keyrings/openhab.gpg > /dev/null

echo 'deb [signed-by=/etc/apt/keyrings/openhab.gpg] https://openhab.jfrog.io/artifactory/openhab-linuxpkg stable main' | \
  sudo tee /etc/apt/sources.list.d/openhab.list

sudo apt update
sudo apt install -y openhab

Пакет openhab тянет за собой openhab-addons (репозиторий надстроек, не обязательно все установленные — они подключаются позже через консоль) и юнит systemd. Дальше — автозапуск:

sudo systemctl daemon-reload
sudo systemctl enable --now openhab.service
sudo systemctl status openhab.service

Первый старт занимает 1-3 минуты — JVM разворачивает OSGi-контейнер и кэш пакетов. Следите за логом:

sudo tail -f /var/log/openhab/openhab.log

Строка вида Started org.openhab.core... — сигнал, что можно идти в веб-интерфейс.

Первый запуск: консоль, веб-интерфейс и мастер настройки

Веб-интерфейс по умолчанию слушает на порту 8080 (HTTP) и 8443 (HTTPS с самоподписанным сертификатом). Откройте http://IP-вашего-сервера:8080 — при первом заходе openHAB предложит выбрать профиль пакетов:

• Standard — стандартный набор с большинством базовых биндингов и UI-компонентов;
• Expert — минимум предустановленного, ставите руками только то, что нужно (рекомендую для VPS — экономит память).

После выбора профиля откроется Main UI. Учётную запись администратора создаёте отдельно в разделе Settings → Users — сразу после установки стоит это сделать и закрыть анонимный доступ, особенно если сервер смотрит в интернет напрямую.

Отдельно полезна консоль openHAB — это OSGi-shell с автодополнением, через неё удобно ставить биндинги без веб-интерфейса и смотреть диагностику:

sudo openhab-cli status
sudo openhab-cli console

Внутри консоли, например, список установленных биндингов:

openhab> bundle:list | grep binding

Для управления сервисом из shell есть обёртка openhab-cli: start, stop, restart, status, showlogs, backup.

Zigbee, Z-Wave и MQTT: протокольная независимость на удалённом сервере

Здесь стоит сказать прямо, а не обходить стороной: сильная сторона openHAB — работа с десятками протоколов одновременно, но физические радиоустройства (Zigbee-координатор, Z-Wave-контроллер) требуют USB-порта на той же машине, где крутится соответствующий биндинг. Облачный VPS этот порт вам не даст.

Рабочие варианты для схемы «периферия дома, мозг в облаке»:

1. MQTT как универсальный мост. На VPS ставите брокер (Mosquitto), дома — Zigbee2MQTT или deCONZ на недорогом мини-ПК/Raspberry Pi, который публикует состояния устройств в MQTT. openHAB забирает их через MQTT-биндинг. Связь между домом и сервером — через WireGuard-туннель, чтобы брокер не торчал в открытый интернет без аутентификации; разворачивание такого туннеля разобрано в статье WireGuard на Ubuntu 24.04.
2. Сетевые Z-Wave/Zigbee-шлюзы. Для Z-Wave это, например, связка с ZWave JS UI, поднятым локально и общающимся с openHAB по WebSocket — координатор физически остаётся дома, а openHAB на VPS обращается к нему по сети через тот же VPN-канал.
3. Протоколы без физического диспетчера. KNX/IP, Modbus TCP, HTTP/REST-устройства, облачные API производителей (если они у устройства есть) — эти биндинги прекрасно работают напрямую с VPS без всякого моста, потому что общаются по IP, а не через USB.

Честно: если вся ваша инсталляция — это одна Zigbee-палка в USB порту компьютера и больше ничего сетевого, вынос openHAB в облако усложняет схему на один лишний узел (локальный мост) и добавляет точку отказа — VPN-туннель. Смысл появляется, когда вы либо уже используете MQTT, либо управляете несколькими объектами, либо цените отдельный от домашней сети «мозг» из соображений безопасности и аптайма.

Установка MQTT-биндинга — через консоль:

openhab> feature:install openhab-binding-mqtt
openhab> feature:install openhab-transform-jsonpath

HTTPS, firewall и резервное копирование

Сервер смотрит в интернет — значит порт 8080 без TLS и без ограничения доступа открывать наружу не стоит. Практичная схема: закрыть 8080/8443 firewall'ом снаружи, повесить перед openHAB реверс-прокси с автоматическим сертификатом Let's Encrypt. Подробный разбор установки такого прокси — в статье Caddy с авто-SSL на Ubuntu 24.04; минимальный конфиг для openHAB:

smarthome.example.com {
    reverse_proxy 127.0.0.1:8080
}

Firewall — ufw, разрешаем только SSH и то, что реально проксируется наружу:

sudo ufw allow OpenSSH
sudo ufw allow 80,443/tcp
sudo ufw deny 8080
sudo ufw deny 8443
sudo ufw enable

Если порт 8080 нужен снаружи (например, для мобильного приложения без прокси) — ограничьте доступ по IP или, лучше, заведите тот же WireGuard и ходите в панель только через туннель. Дополнительный слой — fail2ban на SSH и на access-логи прокси, ставится за пять минут по инструкции fail2ban на Ubuntu 24.04.

Бэкапы делаются встроенной командой:

sudo openhab-cli backup /var/backups/openhab-$(date +%F).zip

Заархивирует конфиги (/etc/openhab), данные (/var/lib/openhab) и логи — без установленных биндингов, их список сохраняется отдельно и переустанавливается при восстановлении. Повесьте это на cron раз в сутки и синхронизируйте архив за пределы сервера (rclone, restic, обычный rsync на другой хост) — локальный бэкап на том же диске не спасёт при потере сервера целиком.

Для долгой истории показаний (графики температуры за месяцы, а не in-memory-буфер на несколько часов) добавьте persistence-биндинг InfluxDB — сам InfluxDB разворачивается по отдельной инструкции: установка InfluxDB на VPS, после чего в openHAB остаётся установить openhab-persistence-influxdb и прописать стратегию сохранения в persistence/influxdb.persist.

Обновления самого openHAB — стандартный APT-путь, ничего специфичного:

sudo apt update && sudo apt upgrade openhab
sudo systemctl restart openhab.service

Перед мажорным обновлением (например, с 4.x на будущую 5.x) всегда снимайте openhab-cli backup — миграция схемы вещей и правил иногда требует ручной правки, и откат должен быть под рукой.

Частые вопросы