GPTWOL może działać w ZimaOS jako niestandardowa aplikacja Docker, ale najważniejszą częścią społecznościowego pliku YAML nie są stare przykładowe dane logowania. Aplikacja potrzebuje sieci hosta, aby wysyłać pakiety Wake-on-LAN w sieci lokalnej, trwałego magazynu na bazę danych i dane cron oraz portu sieciowego, który nie jest już używany przez inną usługę.
Wątek ze stycznia 2026 roku jest przydatny jako działający przykład konfiguracji, ale zarówno GPTWOL, jak i ZimaOS przeszły od tego czasu zmiany. Aktualna dokumentacja GPTWOL nadal wymaga sieci hosta do obsługi Wake-on-LAN, a obecne wydania ZimaOS oferują bardziej rozbudowany proces pracy z plikami YAML. Potraktuj plik źródłowy jako punkt wyjścia i przed zaimportowaniem sprawdź aktualne opcje w projekcie nadrzędnym.
Co konfigurował społecznościowy plik YAML
Udostępniona definicja aplikacji korzystała z obrazu misterbabou/gptwol:latest, ustawienia network_mode: host oraz restart: unless-stopped. Stan GPTWOL był również przechowywany w dwóch folderach hosta mapowanych do /app/db i /etc/cron.d.
Konfiguracja źródłowa udostępniała interfejs GPTWOL na porcie 99 i ustalała strefę czasową dla zaplanowanych zadań wybudzania. Te wartości nie są uniwersalne. Wybierz wolny port hosta i użyj strefy czasowej odpowiadającej komputerowi, na którym działa kontener.
Dlaczego GPTWOL korzysta z sieci hosta
Aktualna dokumentacja projektu nadrzędnego GPTWOL informuje, że kontener potrzebuje trybu sieci hosta, aby wysyłać polecenia Wake-on-LAN w sieci LAN. Różni się to od zwykłej aplikacji internetowej, która często może działać w izolacji za pośrednictwem mostu Docker i pojedynczego opublikowanego portu.
Sieć hosta zmienia również sposób myślenia o portach. Aplikacja nasłuchuje bezpośrednio w sieci hosta ZimaOS, dlatego wybrany port GPTWOL musi być wolny. Jeśli strona się nie otwiera, sprawdź skonfigurowany port i upewnij się, czy nie nasłuchuje na nim inna usługa, zanim zmienisz niezwiązane z tym ustawienia routera.
Aktualna konfiguracja Docker GPTWOL opisuje wymagany tryb sieci, ścieżki magazynu, opcje uwierzytelniania oraz funkcje planowania zadań.
Nie używaj ponownie przykładowych danych logowania
Społecznościowy plik YAML włączał lokalne uwierzytelnianie i korzystał z prostych przykładowych danych logowania. Pokazują one, jak użytkownik źródłowy skonfigurował aplikację, ale nie są bezpiecznymi ustawieniami domyślnymi, które należy kopiować do nowej instalacji.
Jeśli włączysz lokalne uwierzytelnianie, przed pierwszym rzeczywistym wdrożeniem zastąp publicznie dostępne przykładowe nazwy użytkownika i hasła. Aktualne wydania GPTWOL obsługują również OIDC. W obu przypadkach projekt nadrzędny ostrzega przed bezpośrednim wystawianiem usługi do publicznego internetu bez odpowiedniego uwierzytelniania.
Wake-on-LAN jest zazwyczaj funkcją sterowania w sieci LAN. Jeśli chcesz wybudzać urządzenia poza domem, wybierz bezpieczną warstwę zdalnego dostępu zamiast wystawiać interfejs internetowy GPTWOL bezpośrednio na publicznym porcie.
Importowanie lub edytowanie pliku YAML w aktualnym ZimaOS
Wątek ze stycznia 2026 roku powstał przed wprowadzeniem obecnego środowiska pracy z plikami YAML w App Store 2.0. ZimaOS 1.7 wprowadził natywną edycję plików YAML dla aplikacji, a ZimaOS 1.7.1 dodatkowo poprawił zgodność zapisywania plików YAML. Oznacza to, że zrzuty ekranu lub rozmieszczenie przycisków z oryginalnego wpisu mogą już nie odpowiadać bieżącemu interfejsowi.
Zachowaj prostą definicję usługi Compose: obraz, sieć hosta, zasady ponownego uruchamiania, wymagane wartości środowiskowe i trwałe wolumeny. Nie przenoś przestarzałych metadanych x-casaos tylko dlatego, że pojawiły się w wyeksportowanym pliku, chyba że aktualny proces pracy z aplikacjami w ZimaOS rzeczywiście ich wymaga.
Informacje o wydaniu ZimaOS 1.7.1 opisują obecne ulepszenia zgodności plików YAML.
GPTWOL nie włączy funkcji WOL na urządzeniu docelowym, które jej nie obsługuje
GPTWOL wysyła pakiet wybudzający, ale nie sprawia, że niekompatybilny komputer staje się zdolny do wybudzania. Na komputerze docelowym funkcja Wake-on-LAN musi być włączona w oprogramowaniu układowym i systemie operacyjnym, a karta sieciowa musi nadal być w stanie odbierać magiczny pakiet w wybranym stanie zasilania.
Zanim zaczniesz diagnozować kontener, sprawdź, czy urządzenie docelowe można wybudzić za pomocą innego sprawdzonego narzędzia WOL w tej samej sieci LAN. Jeśli to działa, przetestuj GPTWOL. Jeśli żadne narzędzie nie może wybudzić urządzenia, najpierw sprawdź ustawienia BIOS-u, kartę sieciową, stan wyłączenia oraz ścieżkę sieciową urządzenia docelowego.
