Админ

Конфигурация ioBroker через веб-интерфейс

Текущий релиз
8.0.12
Разработчик
bluefox, hobbyquaker
Лицензия
MIT

Описание

Драйвер используется для обслуживания и настройки системы ioBroker и всех установленных драйверов. Он представляет собой WEB-интерфейс по адресу <IP-Адрес сервера>:8081 и устанавливается вместе с ioBroker.

С помощью WEB-интерфейса, предоставляемого драйвером admin, реализуются следующие функции:

  • Установка дополнительных драйверов
  • Обзор объектов
  • Обзор состояний объектов
  • Управление пользователями и группами
  • Просмотр журнал (лог-файл) работы системы
  • Управление хостами (работа с распределенной системой - более одного хоста)

Установка

Этот драйвер устанавливается вместе с ioBroker, ручная установка не требуется.

Настройка

Параметры конфигурации

iobroker.admin - driver settings

IP

IP-адрес с которого доступен драйвер (поддерживаются IPv4 и IPv6). Значение по-умолчанию 0.0.0.0, то есть возможно соединение на любой IP-адрес.

Изменять не желательно, можно потерять досуп!

Port

Порт, по которому доступен интерфейс драйвера. На сервере может быть запущено несколько WEB-сервисов и порт 8081 (настройка по-умолчанию) может быть занят, необходимо исключить конфликт занятого порта. Значение можно изменять.

Шифрование

Если необходимо использовать протокол HTTPS, необходимо отметить данную опцию.

Аутентификация

Если необходима аутентификация пользователя для работы с драйвером, необходимо отметить данную опцию (автоматически включится опция HTTPS).

Кэш

Необходимо отметить данную опцию, если планируется использовать кэш браузера.

Пользователь по-умолчанию

Если опция аутентификации отключена, то драйвер admin будет работать от имени пользователя по-умолчанию (выбирается из списка), в противном случае, от имени пользователя при аутентификации.

Проверка обновлений

Периодичность автоматической проверки обновлений системы и установленных драйверов. Можно выбрать опцию "ручное" и тогда проверка будет осуществляться только по запросу пользователя.

Использование

В адресной строке WEB-браузера наберите: <IP-Адрес сервера>:8081

Вкладки

Главное окно интерфейса состоит из нескольких вкладок.

ioBroker.admin - general view

Вкладка "Драйвера"

Здесь можно установить или удалить экземпляры драйверов. В списке отображаются доступные для установки драйвера и их версии, а так же версии установленных. Обновить информацию по версиям можно с помощью кнопки в левом верхнем углу. В столбце Версия предусмотрена цветовая маркировка релиза драйвера (красный = в планах, желтый = бета-версия, оранжевый = альфа-версия, зеленый = финальная версия). Если установленная версия драйвера ниже версии на сервере (имеются обновления), то заголовок станет зеленым и появится в строке драйвера кнопка обновления. Если кнопка со знаком вопроса в последнем столбце активная, то нажав по ней, можно перейти на сайт Github для ознакомления с информацией об драйвере.

Вкладка "Настройки драйверов"

Здесь отображаются установленные экземпляры драйверов и осуществляется настройка/конфигурирование. Слева сверху находится кнопка включения режима эксперта - для отображения дополнительных настроек.

Настройки драйверов:

  • Запуск/станов экземпляра драйвера
  • Открытие всплывающего окна с настройками драйвера
  • Кнопка перезапуска экземпляра драйвера
  • Кнопка удаления экземпляра драйвера
  • Если драйвер подразумевает собственный WEB-сервис, будет доступна кнопка перехода в новом окне.

Если щелкнуть на название драйвера в столбце Заголовок, можно изменить название экземпляра. В режиме эксперта появляются еще два столбца справа:

  • Столбец Уровень - выбор из списка уровень подробности ведения журнала работы адаптера (debug, error, warn, info)
  • Столбец Max. RAM - при необходимости можно ограничить выделение памяти ОЗУ для работы драйвера

Вкладка "Объекты"

На этой вкладке отображаются объекты системы (переменные, программы, устройства и пр.). По-умолчанию, системные объекты скрыты, их можно отобразить нажав кнопку Показать системные объекты слева сверху. С помощью кнопок со стрелками вверх/вниз можно загрузить/выгрузить объект(-ы) файлом JSON. В столбце справа можно нажатием кнопки вызвать окно настроек конкретного объекта (отдельной кнопкой настройки хранения истории) и удалить объекты. Если значения отображаются красным цветом, значит они еще не подтверждены - флаг ack = false.

Вкладка "Состояния"

Отображение в табличной форме состояний всех объектов системы. В шапке таблицы поля для ввода - фильтры для поиска объекта или группы объектов.

Вкладка "События"

Отображение в табличной форме изменений состояний объектов в режиме реального времени (можно приостановить, нажав справа сверху соответствующую кнопку).

Вкладки "Группы" и "Пользователи"

Добавление пользователей и групп, редактирование привилегий.

Вкладка "Категории"

Добавление/редактирование/удаление категорий (к примеру комнат для работы с адаптером Scenes).

Вкладка "Сервера"

Список серверов с установленным ioBroker, так же здесь отображается версия js-controller на каждом хосте. Если имеется новая версия, то заголовок вкладки будет отображаться зеленым цветом и появится кнопка обновления версии js-controller до актуальной. Запросить текущую версию (если отключено автоматическое обновление) можно с помощью кнопки Обновить информацию драйвера в левом нижнем углу окна. Так же возле имени хоста имеется кнопка перезагрузки js-controller (не OS).

Вкладка "Лог"

Здесь отображается журнал работы сервера. Сверху слева доступны поля для фильтрации записей. Можно отображать записи только указанного драйвера, либо всех (включая системный js-controller); можно выбрать уровень отображения лога (отладка, инфо, предупреждения, ошибки) и фильтровать по значениям.

Справа сверху находятся кнопки:

  • Кнопка Задержать вывод сообщений - вывод сообщений на странице временно приостанавливается (например, когда сообщения появляются слишком быстро, чтобы не пропустить искомое)
  • Кнопка Обновить протокол - обновить журнал вручную (сообщения должны выводиться в режиме онлайн при активной вкладке)
  • Кнопка Скопировать протокол - сообщения на экране копируются в буфер обмена для дальнейшего использования (например, для вставки на форум, чтобы описать ошибку)
  • Кнопки Очистить протокол на экране и Очистить протокол на сервере - соответственно очищает вывод сообщений на вкладке Лог и полностью удаляет сообщения из журнала на сервере (применять осторожно).

Вкладка "Скрипты"

Эта вкладка активна только если установлен драйвер Javascript/Coffescript Script Engine. Здесь можно создавать/удалять/редактировать скрипты для автоматизации. Более подробно смотри описание данного драйвера.

Вкладка "Node-red" и вкладки других драйверов

Эти вкладки видны только если включен соответствующие драйвер (см. пункт ниже).

Общие настройки

Справа сверху находятся кнопки общих настроек драйвера Admin:

  • Кнопка Видимость вкладок - можно включать и отключать вкладки, а так же, при установке определенных драйверов, для которых существуют свои вкладки - добавлять их на страницу
  • Кнопка Системные настройки - дополнительные настройки работы системы такие как: язык интерфейса, формат даты, единицы измерений, активный репозиторий и пр. (группа основные настройки); редактирование, добавление/удаление ссылок на репозитории (группа репозитории); добавление/удаление собственных сертификатов при использовании HTTPS (группа сертификаты); настройка анонимного сбора статистики (группа статистика)
  • Кнопка Выйти - выход из системы.

ioBroker.admin - system settings

Changelog

8.0.14 (2026-09-15)

  • (@GermanBluefox) Fixed: the old, non-React adapter configuration pages stayed bright in the modernDark theme. Their stylesheet only knows the theme names that existed when it was written, so adapter-settings.js maps every newer name - modernDark, modernLight and the vendor themes - down onto the plain dark/light it descends from. React-based configurations are untouched: they take the theme from the local storage and keep the new designs
  • (@GermanBluefox) Fixed: after saving an enum (e.g., a new icon) or dragging an object into it, the "Enums" tab showed only this one enum until the page was reloaded. The collected changes did not start from a copy of all enums any more, so the list was rebuilt from the changed enum alone; deleted enums did not disappear either
  • (@GermanBluefox) Added: the object list on the right side of the "Enums" tab can be hidden with a new toolbar button, and the choice is remembered. While it is hidden, a hint explains that states, channels and devices are added by dragging them from this list
  • (@GermanBluefox) Added: every enum in the "Enums" tab has an "Add objects" button, which opens the object selection with multi-select - adding members no longer requires drag and drop
  • (@GermanBluefox) Fixed: dropping a folder that is not an object itself (e.g. 0_userdata.0.lights) onto an enum showed only a "TODO" alert. Now it asks whether to add the states, channels and devices found below it
  • (@GermanBluefox) Fixed: enum members whose object was deleted were hidden silently but stayed in the enum. They are shown now with a warning and can be removed
  • (@GermanBluefox) The "Enums" tab reads the members of all enums with a few bulk requests instead of one request per member
  • (@GermanBluefox) The icon selection of enums, users and groups offers the new icon library of @iobroker/gui-components: 448 icons in 15 categories with names in all languages and a search, next to the classic room and device icons
  • (@GermanBluefox) Fixed: rooms created by the setup wizard got the file name of their icon (e.g. "Living Room") instead of the icon itself, so they were shown without an icon
  • (@GermanBluefox) The room and function templates are taken from @iobroker/gui-components now, the admin's own copy of the template icons was removed
  • (@GermanBluefox) New layout of the "Enums" tab: a compact list of the entries of a category on the left (nested entries like floors can be opened and closed), the details of the selected entry in the middle and the object list on the right, which collapses into a narrow bar. The details group the members by device or channel and show their role, their current value and the rooms or functions they belong to - a click on one of them opens it. Objects, members and entries can be dragged onto the list and onto the details. On narrow screens the list and the details are shown one after another

8.0.12 (2026-09-09)

  • (@GermanBluefox) Updated @iobroker/json-config to 10.x, which does not bring react-ace any more: the admin hands its own editor in with the new property AceEditor. Until now every custom component of every adapter carried the whole ace-builds in its bundle, although only three of the sixty controls ever show an editor
  • (@GermanBluefox) Added the "Did you know ...?" dialog. It shows one tip about the admin when it is opened, and one can leaf through the tips. The checkbox in the dialog switches it off for the whole installation, and the system settings switch it on again ("Tips at start")
  • (@GermanBluefox) Fixed: the assistant switched the reasoning of an OpenAI-compatible endpoint off as soon as a base URL was configured. That is right for a small local model and wrong for everything else - in front of a proxy that serves a hosted model it turns off the reasoning one is paying for. The chat settings have a "Reasoning effort" selector now, and its default leaves the parameter out and lets the endpoint decide. A model that refuses function tools while reasoning still gets none automatically, as before, because it says so itself
  • (@GermanBluefox) Fixed: the admin sent the user to the login page and sometimes logged them out for good, when the access token expired while the browser tab was in the background. The refresh timer of a hidden tab fires late, and the server cut the connection the very second the token expired. Together with the new @iobroker/socket-classes and @iobroker/socket-client the connection now refreshes the token when the server asks for it, and a refresh that was already done by another tab is no longer mistaken for an invalid login
  • (@GermanBluefox) Fixed: the login page threw the stored tokens away when its token refresh failed because another tab had renewed them in the meantime, which logged out every tab
  • (@GermanBluefox) Added the setting "Stay logged in for" (days). Until now the login without a password was renewed for one week at most
  • (@GermanBluefox) Fixed: /session always reported an expired session, as it looked up the second character of the access token instead of the token
  • (@GermanBluefox) The help text of "Login timeout" explains that the value is the lifetime of the access token, which is renewed automatically while the admin is open
  • (@GermanBluefox) Fixed with the new @iobroker/gui-components: the object browser lost the column widths as soon as the objects page was left and opened again, the checkboxes of the states view columns had no effect while "Auto" was off, the buttons column could not be resized, and switching "Auto" off left the table with nothing but the ID column after a reload: https://github.com/ioBroker/ioBroker.admin/issues/3616
  • (@GermanBluefox) Fixed: an adapter could be updated, although a dependency was not fulfilled. The update dialog showed the dependency in red, but the check behind the button did not know globalDependencies, where an adapter declares which admin version it needs. Both now come from the same place, which also covers the other hosts of a multihost setup: https://github.com/ioBroker/ioBroker.admin/issues/3614
  • (@GermanBluefox) Intro was redesigned

8.0.11 (2026-09-01)

  • (@GermanBluefox) CI: requests to a host that is not running (e.g. in adapter tests without js-controller) are answered immediately with a timeout error, so the GUI does not wait for its read timeout
  • (@GermanBluefox) Fixed: clearing the adapter name filter showed an empty adapter list instead of all adapters

8.0.9 (2026-08-31)

  • (@GermanBluefox) The discovery dialog opens on the result page when the last scan left proposals that are not ignored
  • (@GermanBluefox) The discovery button carries a badge with the number of proposals that are neither created nor ignored
  • (@GermanBluefox) Added the option to create the first instance directly after the installation from npm/GitHub/URL/file, if the adapter has no instance yet
  • (@GermanBluefox) Updated web socket server
  • (@GermanBluefox) Improvements of the device manager

8.0.8 (2026-08-27)

  • (@GermanBluefox) Added the option to answer ACME HTTP-01 challenges of the acme adapter
  • (@GermanBluefox) Fixed the CORS headers missing on the OAuth2 endpoints. They answer without passing the request on, so retrieving a token from a browser on another origin failed with No Access-Control-Allow-Origin header is present. The CORS middleware is now registered in front of all routes
  • (@GermanBluefox) src-admin/src/version.json is now generated from package.json at build time, so the version logged by the GUI is no longer stale

License

The MIT License (MIT)

Copyright (c) 2014-2026 bluefox dogafox@gmail.com