Network UPS Tools

Этот адаптер считывает данные с источников бесперебойного питания через сервер NUT (Network UPS Tools). Он никогда не взаимодействует с ИБП напрямую: сервер NUT управляет USB- или сетевым подключением к оборудованию, а адаптер является одним из его клиентов. Именно поэтому каждая настройка начинается на том компьютере, к которому подключен ИБП.

В файле README приведена краткая версия. На этой странице описан полный процесс установки.

1. Убедитесь, что сервер NUT запущен.

Вам нужна машина соupsd Работает и как минимум один ИБП настроен — хост под управлением Linux, сетевое хранилище (NAS) (Synology, QNAP и UGREEN поставляются с NUT) или Raspberry Pi с ИБП, подключенным через USB.

Проверьте это на этом аппарате:

upsc -l                 # lists the UPS names, e.g. "ups0"
upsc ups0               # shows all values of that UPS

Еслиupsc -l Ничего не печатается, проблема на стороне гайки, и адаптер не поможет — сначала исправьте драйвер./etc/nut/ups.conf , затемupsdrvctl start ).

2. Дайте адаптеру достичь сервера.

upsd Он прослушивает только локальный хост, пока вы не укажете иное./etc/nut/upsd.conf :

LISTEN 0.0.0.0 3493

Перезапускupsd впоследствии. Порт3493/TCP Между вашим хостом ioBroker и сервером NUT должно быть открыто соединение.

Многие NAS-системы работают в режиме "UPS-сервера", который имеет собственный список разрешенных адресов в веб-интерфейсе — IP-адрес хоста ioBroker должен быть в этом списке.

3. Создайте пользователя (необязательно, но рекомендуется).

Для чтения значений не требуется регистрация пользователя. Пользователь нужен только для двух вещей: переключения ИБП (мгновенные команды) и записи переменных. Добавьте это в/etc/nut/upsd.users :

[iobroker]
    password = choose-something-long
    upsmon secondary
    actions = SET
    instcmds = ALL

Две линии с разными задачами:

• upsmon secondary Именно эта строка делает возможным вход в систему . Адаптер использует данные для входа один раз при запуске, в рамках короткого дополнительного соединения, исключительно для того, чтобы сообщить вам, работают ли учетные данные. Без этой строки вход в систему будет отклонен — см. раздел часто задаваемых вопросов, это не ошибка.
• actions иinstcmds определить, что пользователь может фактически сделать .upsd Проверяет их по команде, независимо от авторизации.

Перезапускupsd после редактирования файла.

4. Добавьте экземпляр в ioBroker.

Установите адаптер, создайте экземпляр и заполните вкладку «Подключение» :

Нажмите «Проверить соединение» . В ответе будет указано, что именно было проверено: зашифровано ли соединение, сколько ИБП предоставляет сервер и — если вы вводили учетные данные — был ли принят вход в систему.

Затем сохраните. Адаптер подключается, обнаруживает все ИБП на сервере и создает состояния.

С какой скоростью должен осуществляться опрос?

Скорость обновления данных драйвером NUT ничего не даст./etc/nut/ups.conf У драйвера есть две настройки:pollinterval (Как часто обновляется статус, по умолчанию 2 секунды) иpollfreq (полный набор значений, по умолчанию 30 секунд для драйверов USB). Опрос каждые 15 секунд — разумный компромиссный вариант; при интервале менее 2 секунд адаптер просто повторно считывает значения, которые не изменились.

Если вы хотите получать уведомления о сбое электропитания мгновенно, а не при следующем опросе, не уменьшайте интервал — используйте триггер событий, описанный в разделе часто задаваемых вопросов.

5. Шифрование соединения (необязательно)

Без TLS имя пользователя и пароль передаются по сети в открытом виде. Если это имеет значение для вашей конфигурации,upsd может быть собран с поддержкой TLS и предлагает STARTTLS :

1. НастройкаCERTFILE (илиCERTPATH ) вupsd.conf на сервере.
2. Установите флажок «Использовать TLS (STARTTLS)» в настройках адаптера.

По умолчанию адаптер не проверяет сертификат — он шифрует трафик, защищая его от пассивного прослушивания, но не может обнаружить атаку типа «человек посередине», поскольку почти каждый сервер NUT использует самоподписанный сертификат.

Для реальной защиты установите флажок «Требовать действительный сертификат» и укажите в файле сертификата центра сертификации путь к PEM-файлу на хосте ioBroker, по которому можно проверить сертификат — либо к вашему собственному центру сертификации, либо к самоподписанному сертификату сервера. Файл будет прочитан только при включенной строгой проверке; путь, оставшийся от предыдущей попытки, не причинит вреда.

Если сервер NUT был собран без TLS, проверка соединения сообщит об этом, вместо того чтобы незаметно переключаться на обычный текст.

6. Переключение ИБП через ioBroker (необязательно)

Два переключателя на вкладке «Дополнительно» открывают направление записи, и оба намеренно выключены:

• Включение команд создает состояние кнопки для каждой мгновенной команды, предлагаемой ИБП (звуковой сигнал, самодиагностика, отключение нагрузки и т. д.).commands Канал отображается только после включения этой функции и настройки учетных данных.upsd Проверяет права доступа к командам у указанного пользователя.
• Включение параметра SET VAR делает переменные ИБП, которые сервер сообщает как доступные для записи, доступными для записи и в ioBroker.

Обеим сторонам необходимы соответствующие права.upsd.users (шаг 3). Обращайтесь с командами загрузки с осторожностью:load.off Отключает питание всех устройств, подключенных к ИБП.

Куда отправиться дальше?

• Точки данных — что создает адаптер и что означает каждая его часть.
• Часто задаваемые вопросы , включая мгновенные обновления событий черезupsmon .

Changelog

0.15.1 (2026-09-07)

• New: ten more data points explain themselves — the battery date, the UPS's own clock, the three driver versions, the UPS identifier, the UPS type and the USB vendor and product IDs
• Fixed: the battery maintenance date is the date of the NEXT change or service, not of the last one — its name said the opposite in all eleven languages
• Improved: setting up the upsmon trigger is one line in upsmon.conf instead of a shell script, and points at the rest-api adapter; the older simple-api path stays documented

0.15.0 (2026-09-07)

• Fixed: a data point no longer holds a value of the wrong kind — a reading that stops matching the data point's type is discarded with one warning instead of being written into it
• Fixed: a NUT server that is switched off or restarting no longer makes the instance look broken — the adapter names the server it cannot reach and keeps retrying
• Fixed: value limits taken from the UPS disappear again when the UPS stops reporting them, instead of standing forever and causing warnings about every value outside them
• Fixed: credentials containing a space are now refused with an explanation instead of a bare protocol error nobody can act on
• Fixed: enabling instant commands now says why no command buttons appear when the UPS does not answer the command list
• Fixed: a UPS variable without a dot in its name is now writable, and can no longer take over one of the adapter's own channels
• Fixed: over a third of the data points carried an English label in every language — 157 more variable names are now translated into all eleven
• Fixed: the phases of a three-phase UPS, the sensors of a multi-sensor probe and the individual outlets no longer all share one name — each keeps the marker that says which one it is
• Fixed: the outlet buttons of a PDU are now named and explained like every other command instead of showing their raw NUT name
• New: explanations for the battery voltage, battery temperature, battery health and input current, which stood without one next to explained siblings

0.14.0 (2026-09-04)

• Fixed: a certificate file left over in the settings no longer stops the adapter — it is only read while strict certificate checking is actually switched on
• Fixed: value lists of writable data points stay in your language instead of falling back to the raw NUT wording after the first poll
• Fixed: the connection test no longer reports an error when only the credentials are refused — it says so and confirms that reading works, matching what the adapter does
• Fixed: the connection test now answers in your language when something goes wrong, not only when it succeeds
• Fixed: a UPS that disappears from the NUT server and comes back gets its manufacturer and model name again instead of keeping the bare UPS name
• Fixed: renamed data points of the adapter itself now reach existing installations instead of only new ones
• Fixed: enabling instant commands without credentials no longer fails silently — the adapter now explains why no command buttons are created
• New: detailed user documentation in English and German is now part of the repository and shown in the ioBroker documentation portal

0.13.0 (2026-09-02)

• New: every data point now carries a short explanation in your language — what it means, not just what it is called
• New: status text, severity levels and selection lists are shown in your language instead of English
• Changed: wrong credentials no longer stop the monitoring — the adapter warns, keeps reading the UPS values, and only refuses commands and writable variables
• Fixed: during a power failure, machines protected by the same UPS now shut down without waiting for this adapter
• Fixed: a countdown that is not running is now empty instead of showing "-1 seconds", on every UPS brand
• Fixed: model and other text values no longer carry the padding some UPS models send along
• Fixed: channel names from older adapter versions are corrected instead of staying as they were
• Fixed: the connection test answers in your language now, like the rest of the settings page

0.12.1 (2026-09-02)

• Fixed: the "Test connection" button in the settings stayed silent — clicking it produced no result at all. It answers again, on every instance updated from 0.9.0 or later

License

MIT License

Copyright (c) 2026 krobi krobi@power-dreams.com

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

Developed with assistance from Claude.ai