Zainstalowanie aplikacji Tailscale i ukończenie procesu uwierzytelniania urządzenia nie gwarantuje, że kontener ZimaOS pozostanie połączony. W rozwiązanym wątku z października 2025 roku urządzenie można było dodać do Tailscale, ale nigdy nie pojawiało się jako połączone na liście urządzeń w panelu administracyjnym Tailscale.
Rozwiązanie zaproponowali inni użytkownicy społeczności, a nie pracownik IceWhale. Jeden z użytkowników wskazał działający w jego środowisku wpis Tailscale w sklepie z aplikacjami ZimaOS, zmienił konfigurację interfejsu internetowego i dostarczył nowy klucz uwierzytelniania Tailscale. W późniejszej odpowiedzi dodano ważny krok odzyskiwania w przypadku trwałego problemu: przed ponowną instalacją aplikacji należy usunąć stary folder AppData Tailscale.
Wątek dotyczył konkretnego wpisu Tailscale w sklepie z aplikacjami
Sklep z aplikacjami ZimaOS wyświetlał dwa wpisy związane z Tailscale. Pomagający użytkownik poinformował, że w jego przypadku podczas ówczesnej migracji do ZimaOS 1.5 działał tylko wpis zaznaczony po lewej stronie.
Była to obserwacja z 2025 roku, a nie stały ranking obecnych pakietów w sklepie z aplikacjami. Definicje aplikacji mogą się zmieniać, dlatego przed założeniem, że nadal wymagany jest ten sam wpis, porównaj aktualne szczegóły pakietów.
Ustaw ścieżkę interfejsu internetowego używaną w konfiguracji społeczności
Pomagający użytkownik zmienił miejsce docelowe interfejsu internetowego aplikacji Tailscale tak, aby wskazywało ścieżkę administracji logowaniem Tailscale:
login.tailscale.com ze ścieżką /admin jako skrótu interfejsu internetowego.To ustawienie steruje skrótem otwieranym z poziomu ZimaOS. Nie należy go mylić ze stanem sieciowym samego demona Tailscale.
Użyj własnego, aktualnego klucza uwierzytelniania Tailscale
Następnie w ramach instrukcji społeczności uzyskano klucz autoryzacyjny z Tailscale i umieszczono go w zmiennej środowiskowej aplikacji TS_AUTHKEY. Nie kopiuj klucza uwierzytelniania ze zrzutu ekranu, wpisu na forum, kopii zapasowej ani innego urządzenia. Klucze uwierzytelniania są danymi uwierzytelniającymi i należy je generować oraz zarządzać nimi we własnej sieci tailnet.
Aktualna dokumentacja Tailscale opisuje wdrożenia kontenerowe i parametry uwierzytelniania dla platformy Docker:
Dokumentacja Tailscale dotycząca Dockera
Jeśli ponowna instalacja nie pomaga, stary folder AppData może być nadal używany
Drugi użytkownik społeczności miał instalację Tailscale, która wcześniej działała, a następnie przestała. Aktualizacja, ponowne uruchomienie, usunięcie aplikacji i ponowna instalacja początkowo nie przyniosły rezultatu.
Krokiem, który ostatecznie zadziałał w jego przypadku, było:
- usunięcie aplikacji Tailscale z ZimaOS;
- przejście do lokalizacji AppData w ZimaOS;
- usunięcie starego folderu danych aplikacji
tailscale; - ponowne zainstalowanie Tailscale ze sklepu z aplikacjami;
- powtórzenie działających kroków konfiguracji i uwierzytelniania.
Ostrzeżenie: usunięcie folderu AppData usuwa trwały stan aplikacji. Przed jego usunięciem wykonaj kopię zapasową wszystkiego, czego możesz potrzebować, i upewnij się, że usuwasz folder Tailscale, a nie dane innej aplikacji.
Dlaczego samo usunięcie aplikacji może nie zresetować Tailscale
Aplikacje kontenerowe często przechowują stan poza systemem plików tymczasowego kontenera. Dzięki temu ustawienia mogą przetrwać aktualizację lub ponowne utworzenie kontenera, ale oznacza to również, że błędny lub nieaktualny stan może przetrwać zwykły cykl odinstalowania i ponownej instalacji, jeśli trwały katalog AppData pozostanie na miejscu.
Wynik opisany w dalszej części tego wątku pomaga więc rozróżnić dwa poziomy odzyskiwania: najpierw ponownie zainstaluj kontener, a wyczyszczenie trwałego stanu rozważ dopiero wtedy, gdy zwykła ponowna instalacja nadal wykorzystuje tę samą uszkodzoną konfigurację.
Rozwiązany wątek dotyczył połączenia węzła, a nie routingu podsieci
Problem polegał na tym, że węzeł Tailscale nigdy nie uzyskał stanu połączenia. Różni się to od późniejszej dyskusji dotyczącej ZimaOS, w której Tailscale łączył się pomyślnie, ale nie rozgłaszał tras podsieci. Jeśli urządzenie jest już online w Tailscale, a dostępne są jedynie zdalne usługi w sieci LAN, rozwiązuj problem routingu podsieci zamiast ponownie wykonywać tę procedurę skupioną na uwierzytelnianiu.
Często zadawane pytania dotyczące połączenia ZimaOS z Tailscale
Dlaczego moje urządzenie Tailscale jest zarejestrowane, ale nigdy nie uzyskuje połączenia?
W rozwiązanym przypadku z 2025 roku działająca konfiguracja społeczności obejmowała właściwy wpis w sklepie z aplikacjami, konfigurację jego interfejsu internetowego oraz prawidłowy klucz uwierzytelniania Tailscale.
Czy należy od razu usuwać AppData Tailscale?
Nie. Usunięcie AppData było późniejszym krokiem odzyskiwania, zastosowanym po nieudanych próbach aktualizacji, ponownego uruchomienia, odinstalowania i ponownej instalacji. Usuwa ono trwały stan, dlatego najpierw wykonaj kopię zapasową.
Czy można bezpiecznie ponownie użyć klucza uwierzytelniania widocznego na starym zrzucie ekranu?
Nie. Wygeneruj własny klucz dla swojej sieci tailnet i zarządzaj nim samodzielnie. Traktuj klucze uwierzytelniania jak dane uwierzytelniające.
Czy było to oficjalne rozwiązanie IceWhale?
Nie. Wątek uznano za rozwiązany dzięki diagnozie społeczności. Stanowi on użyteczne praktyczne źródło informacji, ale opisane kroki nie zostały przedstawione jako oficjalna procedura pomocy technicznej IceWhale.
