26 października 2026 ukazało się Z-Wave JS UI 11.25.2 z jedną, ale ważną poprawką. Od wersji 11.25.0 część instalacji z włączonym HTTPS w ogóle nie startowała: kontener Dockera restartował się w kółko, a w dzienniku pojawiał się błąd ERR_SSL_EE_KEY_TOO_SMALL („ee key too small”). Nowe wydanie w większości przypadków samo usuwa problem, ale jednocześnie zaostrza obsługę własnych certyfikatów.

Skąd awaria po aktualizacji do 11.25.0

W wersji 11.25.0 obraz Dockera przeszedł na Node 24. Ta wersja domyślnie ustawia OpenSSL na poziom bezpieczeństwa 2 i odrzuca klucze RSA krótsze niż 2048 bitów. Przed wersją 9.29.0 Z-Wave JS UI generował certyfikat z podpisem własnym z kluczem 1024-bitowym, a nowy tworzył tylko wtedy, gdy plików brakowało. Kto włączył HTTPS wcześniej, wciąż miał stary klucz. Node 22 go przyjmował, Node 24 już nie, a ponieważ nic nie przechwytywało błędu, proces kończył się przy starcie. Problem zgłoszono 22 października.

Co robi wersja 11.25.2

Przed uruchomieniem serwera aplikacja sprawdza certyfikat i klucz tym samym testem, którego używa Node. Dalej wszystko zależy od tego, skąd pochodzi para:

  • Para z podpisem własnym zapisana w katalogu danych, której Node nie akceptuje, dostaje nazwy cert.pem.bak i key.pem.bak, aplikacja generuje nową parę z kluczem 2048-bitowym i zapisuje ostrzeżenie w dzienniku. Większości osób to wystarczy: po aktualizacji HTTPS znowu działa. Jeśli przeglądarka miała zapisany wyjątek dla starego certyfikatu, ostrzeżenie pojawi się ponownie, bo certyfikat jest nowy.
  • Własna para wskazana w SSL_CERTIFICATE i SSL_KEY, której Node nie akceptuje, zatrzymuje start z błędem. Komunikat podaje oba pliki, przyczynę zgłoszoną przez OpenSSL i sposób naprawy. Aplikacja nigdy nie podmienia wskazanego certyfikatu na certyfikat z podpisem własnym ani nie przechodzi na zwykłe HTTP.
  • Brakujący, nieczytelny albo pusty plik własnego certyfikatu też zatrzymuje start. Wcześniej aplikacja po cichu używała certyfikatu z podpisem własnym.
  • Ustawienie tylko jednej zmiennej, SSL_CERTIFICATE albo SSL_KEY, również zatrzymuje start. Trzeba ustawić obie albo żadnej.

Ta ostatnia grupa oznacza zmianę zachowania. Konfiguracja, która uruchamiała się tylko dzięki dawnemu obejściu, na przykład z nieaktualną ścieżką do certyfikatu, po aktualizacji przestanie startować, dopóki nie poprawisz ścieżki albo nie usuniesz obu zmiennych.

Przy okazji doszły dwie drobniejsze zmiany. Nowo wygenerowany key.pem dostaje uprawnienia 0600, bo starsze pliki kluczy mogły mieć uprawnienia 0644, czyli być czytelne dla wszystkich. Wpis „Listening on” w dzienniku pokazuje teraz protokół, który faktycznie działa. Wcześniej podawał HTTPS nawet wtedy, gdy aplikacja przeszła na HTTP.

Wydanie podnosi też bibliotekę multer do wersji 2.5.0. Poprzednia poprawka, 11.25.1 z 23 października, przyniosła zwave-js 15.31.2 i Node 24.22.1, ale certyfikatów nie ruszała. Jeśli z powodu pętli restartów wstrzymałeś aktualizację do 11.25.x, teraz możesz od razu przejść na 11.25.2.