SSD Nodes Learn Hosting plans →
Przewodniki Matt ConnorAutor: Matt Connor

Błędy instalacji Tailscale na Ubuntu: jak naprawić apt

Większość problemów z instalacją Tailscale na Ubuntu wynika z błędów apt. Sprawdź kod statusu, poprawność nazwy kodowej wydania oraz stan klucza podpisu w repozytorium.

Dlaczego błędy instalacji Tailscale na Ubuntu są błędami apt

Błędy instalacji Tailscale na systemie Ubuntu niemal zawsze występują, zanim uruchomi się jakikolwiek kod Tailscale. Są to błędy narzędzia apt. Podczas weryfikacji w archiwum pakietów Ubuntu w październiku 2026 roku, pakiet tailscale nie istniał: jedynymi dopasowaniami były biblioteki pomocnicze Go oraz python3-tailscale. Dlatego demon zazwyczaj pochodzi z własnego repozytorium apt firmy Tailscale pod adresem pkgs.tailscale.com. Canonical utrzymuje również pakiet typu snap dla Tailscale, który został omówiony wraz z innymi rozwiązaniami awaryjnymi pod koniec dokumentacji.

Dodanie tego repozytorium powoduje zapisanie dwóch plików. Jeden plik informuje apt, gdzie znajdują się pakiety. Drugi zawiera klucz publiczny, którego apt używa do sprawdzenia podpisu indeksu repozytorium. Prawie każda awaria opisana poniżej wynika z błędnej zawartości jednego z tych dwóch plików lub z faktu, że urządzenie znajdujące się między apt a repozytorium odrzuca żądanie.

Oto polecenia publikowane przez Tailscale dla systemu Ubuntu 24.04:

sudo mkdir -p --mode=0755 /usr/share/keyrings
curl -fsSL https://pkgs.tailscale.com/stable/ubuntu/noble.noarmor.gpg | sudo tee /usr/share/keyrings/tailscale-archive-keyring.gpg >/dev/null
curl -fsSL https://pkgs.tailscale.com/stable/ubuntu/noble.tailscale-keyring.list | sudo tee /etc/apt/sources.list.d/tailscale.list
sudo apt-get update && sudo apt-get install tailscale

noble to nazwa kodowa systemu Ubuntu 24.04, która pojawia się w obu adresach URL. Drugie polecenie zapisuje linię komentarza oraz jedną linię deb do pliku /etc/apt/sources.list.d/tailscale.list, a polecenie cat pokazuje dokładnie, co zostało tam zapisane.

cat /etc/apt/sources.list.d/tailscale.list

Należy odczytać tę linię deb jako adres składający się z czterech pól: opcji w nawiasach [signed-by=/usr/share/keyrings/tailscale-archive-keyring.gpg], następnie bazy repozytorium, którą jest pkgs.tailscale.com/stable/ubuntu dostępna przez https, dalej pakietu noble oraz komponentu main. Narzędzie apt łączy bazę i pakiet w jeden adres URL i pobiera go: https://pkgs.tailscale.com/stable/ubuntu/dists/noble/InRelease. Ręczne pobranie tego adresu URL testuje poprawność żądania; nie stanowi to jednak dowodu, że żądanie wysłane przez apt zakończy się powodzeniem.

Przeanalizuj błąd apt przed wprowadzeniem zmian

Uruchom aktualizację samodzielnie, aby uniknąć przewinięcia komunikatu o błędzie.

sudo apt update

Nieudane połączenie z zewnętrznym repozytorium wygląda w następujący sposób. Nazwa kodowa oraz adres IP będą się różnić w zależności od maszyny.

E: Failed to fetch https://pkgs.tailscale.com/stable/ubuntu/dists/wilma/InRelease  404  Not Found [IP: 203.0.113.9 443]
E: Some index files failed to download. They have been ignored, or old ones used instead.

Dwa elementy w tym wyjściu decydują o dalszych krokach: kod statusu oraz pełny adres URL w linii E: Failed to fetch. Nie należy wyciągać wniosków na podstawie podsumowania na dole. Skopiuj adres URL i odpytaj serwer samodzielnie.

curl -sS -o /dev/null -w '%{http_code}\n' https://pkgs.tailscale.com/stable/ubuntu/dists/noble/InRelease

Polecenie to zwraca 200 dla nazwy kodowej publikowanej przez Tailscale. Sprawdzono w październiku 2026, noble zwraca podpisany indeks zawierający Origin: Tailscale oraz Codename: noble. Podstaw noble w miejsce nazwy kodowej z własnego błędu i uruchom ponownie. Jeśli curl otrzyma 200 w sytuacji, gdy apt zgłosił błąd pobierania, oznacza to, że repozytorium odpowiedziało na żądanie curl, jednak nie dowodzi to błędnej konfiguracji apt: filtrowanie na poziomie usługi lub na trasie połączenia może różnicować żądania na podstawie nagłówków, takich jak user agent. Kod 200 potwierdza jedynie, że pobieranie zakończyło się powodzeniem: apt nadal weryfikuje podpis indeksu po jego pobraniu, a problem z kluczem powoduje błąd na tym etapie, co opisano w sekcji dotyczącej bazy kluczy poniżej.

Co oznacza kod statusu

  • 404 Not Found oznacza, że serwer nie odnalazł pliku pod wskazaną ścieżką lub nie chce ujawnić jego istnienia. W przypadku pkgs.tailscale.com, który udostępnia pliki bez uwierzytelniania, niemal zawsze przyczyną jest błędna nazwa kodowa w adresie URL.
  • 403 Forbidden oznacza, że serwer odpowiedział odmową. Sam kod 403 nie wskazuje, czy odmowa pochodzi od proxy, urządzenia filtrującego, firewalla między serwerem a Tailscale, czy od samej usługi. AWS dokumentuje, że dystrybucja CloudFront również może zwrócić 403 z własnej strony, na przykład w wyniku działania reguły firewalla lub konfiguracji serwera źródłowego.
  • 407 Proxy Authentication Required oznacza, że proxy wymaga uwierzytelnienia dla tego żądania: albo apt nie wysłało danych logowania do proxy, albo wysłało dane, które proxy odrzuciło jako nieprawidłowe lub niekompletne. 401 Unauthorized to inna sytuacja: jest to żądanie poświadczeń dla samego zasobu, wysyłane wraz z nagłówkiem WWW-Authenticate, co samo w sobie nie wskazuje na obecność proxy. To repozytorium udostępnia pliki bez uwierzytelniania, więc kod 401 zazwyczaj oznacza, że pod tym adresem URL odpowiedział inny komponent, na przykład brama przechwytująca ruch. Polecenie debugowania w sekcji proxy wskazuje, z jakim hostem faktycznie połączyło się apt.
  • Błąd połączenia lub błąd rozpoznawania nazw oznacza, że do wymiany danych HTTP w ogóle nie doszło. Należy przejść do sekcji dotyczącej IPv6.

Nazwa kodowa w adresie URL nie jest publikowana przez Tailscale

Tailscale tworzy osobny katalog dla każdej nazwy kodowej Ubuntu. Żądanie nazwy kodowej, której nie ma w repozytorium, kończy się błędem 404, ponieważ na serwerze brakuje dists/<codename>. Oficjalna lista dostępna pod adresem pkgs.tailscale.com/stable wskazuje istniejące katalogi. W październiku 2026 roku lista ta obejmuje wersje od 16.04 do stonking, czyli Ubuntu 26.10, z resolute, czyli Ubuntu 26.04, bezpośrednio poniżej.

Najczęstszą przyczyną użycia błędnej nazwy kodowej jest wykonanie lsb_release -cs w dystrybucji bazującej na Ubuntu, która nie jest samym Ubuntu. W systemie Linux Mint 22 polecenie to zwraca wilma, czyli własną nazwę kodową Mint, dla której Tailscale nie udostępnia pakietów. Należy odczytać nazwę bazowego wydania Ubuntu.

. /etc/os-release
echo "$VERSION_CODENAME $UBUNTU_CODENAME"

W systemie Ubuntu obie wartości są identyczne. W systemach pochodnych VERSION_CODENAME to nazwa dystrybucji, a UBUNTU_CODENAME to wydanie Ubuntu, na którym bazuje. W obu adresach URL należy użyć UBUNTU_CODENAME.

Drugą przyczyną jest aktualizacja wydania systemu. Narzędzie do aktualizacji Ubuntu wyłącza zewnętrzne źródła oprogramowania, więc po aktualizacji Ubuntu 24.04 do 26.04 plik /etc/apt/sources.list.d/tailscale.list może być zakomentowany lub nadal wskazywać na noble na maszynie, która pracuje już pod kontrolą resolute. Problem rozwiązuje ponowne wykonanie dwóch poleceń curl z nową nazwą kodową, co nadpisze oba pliki. Jeśli proces aktualizacji został przerwany i narzędzie dpkg zgłasza błędy dotyczące niepełnej konfiguracji pakietów, należy najpierw naprawić nieudaną aktualizację wydania, ponieważ żadna zmiana w tailscale.list nie zadziała w systemie, którego apt nie jest w stanie poprawnie skonfigurować.

Trzecią przyczyną jest czas. Instalacja na nowym wydaniu Ubuntu przed dodaniem przez Tailscale odpowiedniej nazwy kodowej również skutkuje błędem 404. Okno to jest zazwyczaj krótkie lub nie występuje: zgłoszenie dotyczące wsparcia instalacji na Ubuntu 24.04 zostało zamknięte jako zrealizowane w styczniu 2024 roku, na wiele miesięcy przed premierą tego wydania. W przypadku Ubuntu 26.10, sprawdzonego 24 października 2026 roku, dists/stonking/InRelease zwróciło podpisany indeks zawierający Origin: Tailscale oraz Codename: stonking. Jeśli wcześniej wystąpił błąd 404 dla stonking, należy ponowić próbę pobrania przed szukaniem obejść. Jeśli instalacja przypada na okres oczekiwania, wskazanie w pliku poprzedniej nazwy kodowej LTS zazwyczaj pozwala na instalację, ponieważ pakiety te mają niewiele zależności. Wybór tego repozytorium nie oznacza jednak wyboru kompilacji specyficznej dla danego wydania Ubuntu: pakiety deb Tailscale są kierowane na architektury Linux, takie jak amd64 oraz arm64. Należy zweryfikować zainstalowaną wersję za pomocą apt policy tailscale i przywrócić plik do pierwotnego stanu, gdy pojawi się właściwa nazwa kodowa.

Brelok kluczy jest pusty, a polecenie, które go utworzyło, nie zwróciło żadnego komunikatu

Ten błąd jest cichy i stanowi przyczynę większości problemów tego typu. Należy ponownie przyjrzeć się poleceniu obsługującemu brelok kluczy:

curl -fsSL https://pkgs.tailscale.com/stable/ubuntu/noble.noarmor.gpg | sudo tee /usr/share/keyrings/tailscale-archive-keyring.gpg >/dev/null

Powłoka buduje cały potok przed uruchomieniem któregokolwiek z programów, więc sudo tee otwiera ścieżkę breloka i natychmiast skraca ją do zera bajtów. Jeśli curl następnie zawiedzie, a -f wymusi błąd przy każdym niepowodzeniu HTTP, curl nie zapisze niczego i zakończy działanie z kodem wyjścia innym niż zero. Plik pozostaje pusty. Kod wyjścia potoku jest kodem ostatniego polecenia, czyli tee, które zakończyło się powodzeniem. Nic nie zostaje wyświetlone, a użytkownik przechodzi do następnego polecenia, zakładając, że klucz został zainstalowany.

Należy sprawdzić plik, a nie polecenie, które go utworzyło.

ls -l /usr/share/keyrings/tailscale-archive-keyring.gpg
gpg --show-keys /usr/share/keyrings/tailscale-archive-keyring.gpg

Poprawny brelok kluczy wyświetla linię pub oraz linię uid wskazującą na Tailscale. Pusty plik wyświetla gpg: no valid OpenPGP data found. i nic więcej. Plik, który przechwycił stronę błędu HTML, wyświetla to samo, a head -c 80 na nim pokazuje początek strony internetowej zamiast binarnych danych klucza.

W przypadku breloka, który nie zawiera użytecznego klucza, sudo apt update pobiera indeks, a następnie go odrzuca. Wyświetlona zostaje linia W: GPG error wskazująca na repozytorium Tailscale i jego pakiet, tekst The following signatures couldn't be verified because the public key is not available: NO_PUBKEY, po którym następuje 16-znakowy identyfikator klucza, a poniżej błąd informujący, że repozytorium nie jest podpisane. Należy zwrócić uwagę na komunikat apt: indeks został pobrany poprawnie, ale nie można było zweryfikować podpisu. Jest to problem z kluczem, a nie z siecią. Jeśli plik breloka w ogóle nie istnieje, komunikat jest inny i wskazuje bezpośrednio ścieżkę za pomocą Could not open file /usr/share/keyrings/tailscale-archive-keyring.gpg.

Zapis klucza należy wykonać w dwóch krokach, aby nieudane pobieranie nie zniszczyło działającego breloka kluczy.

curl -fsSL https://pkgs.tailscale.com/stable/ubuntu/noble.noarmor.gpg -o /tmp/tailscale.gpg
gpg --show-keys /tmp/tailscale.gpg
sudo install -m 0644 -o root -g root /tmp/tailscale.gpg /usr/share/keyrings/tailscale-archive-keyring.gpg

Środkowa linia stanowi zabezpieczenie: jeśli nie wyświetla ona uid Tailscale, należy przerwać operację i nie kopiować pliku. Tryb 0644 ma znaczenie, ponieważ apt obniża uprawnienia do użytkownika _apt w celu pobrania i weryfikacji, więc brelok, który może odczytać tylko root, jest brelokiem, którego apt nie może użyć.

Zarówno plik .list, jak i .sources opisują to samo repozytorium

System Ubuntu przeniósł własne źródła do formatu deb822 w Ubuntu 24.04 LTS, gdzie /etc/apt/sources.list stało się /etc/apt/sources.list.d/ubuntu.sources. Tailscale nadal publikuje format jednowierszowy. Podczas weryfikacji w październiku 2026 roku, odpowiedni adres URL .sources w serwisie pkgs.tailscale.com zwracał błąd 404. Jeśli na maszynie znajdują się zarówno plik tailscale.sources, jak i tailscale.list opisujące to samo repozytorium, apt traktuje je jako dwa oddzielne opisy tego samego źródła.

Łagodna wersja problemu objawia się ostrzeżeniem przy każdej aktualizacji:

W: Target Packages (main/binary-amd64/Packages) is configured multiple times in /etc/apt/sources.list.d/tailscale.list:1 and /etc/apt/sources.list.d/tailscale.sources:1

Wersja krytyczna występuje, gdy oba pliki wskazują na różne ścieżki do bazy kluczy, ponieważ apt nie jest w stanie rozstrzygnąć, który klucz zarządza repozytorium. System wyświetla E: Conflicting values set for option Signed-By regarding source, następnie nazwę repozytorium oraz jego suite, potem obie ścieżki do bazy kluczy rozdzielone przez !=, a następnie odmawia dalszego działania:

E: The list of sources could not be read.

Taki stan blokuje każde polecenie apt, nie tylko aktualizację, dopóki jeden z plików nie zostanie usunięty. Ten sam błąd pojawia się w przypadku własnych repozytoriów Ubuntu, a błąd zduplikowanego źródła apt po migracji do deb822 zawiera opis ogólnego przypadku.

Przed usunięciem jakiegokolwiek pliku należy odnaleźć wszystkie pliki zawierające wzmiankę o Tailscale.

grep -RIn tailscale /etc/apt/sources.list /etc/apt/sources.list.d/

Należy zachować jeden plik. Aby wyłączyć drugi bez jego usuwania, należy zmienić jego nazwę: apt odczytuje wyłącznie pliki kończące się na .list lub .sources, więc plik z rozszerzeniem tailscale.list.bak jest pomijany i pozostaje na dysku w celach referencyjnych.

Poprawne tworzenie pliku źródłowego deb822

Jeśli preferowany jest nowszy format, należy przekonwertować istniejący plik zamiast przepisywać adres repozytorium, ponieważ literówka w tym miejscu jest bezpośrednią przyczyną powyższych błędów. Nowsze wydania apt zawierają konwerter, który przepisuje pliki .list na sekcje deb822 i przenosi opcję signed-by jako Signed-By.

apt modernize-sources --help
sudo apt modernize-sources

Ubuntu 24.04 dostarcza apt w wersji starszej niż ten podpolecenie, więc wiersz pomocy wskaże, czy dana wersja je posiada. Jeśli nie, należy zbudować sekcję na podstawie wiersza znajdującego się już na dysku, aby baza pochodziła z pliku dostawcy, a nie z klawiatury użytkownika.

. /etc/os-release
{
  echo 'Types: deb'
  echo "URIs: $(awk '/^deb /{print $3}' /etc/apt/sources.list.d/tailscale.list)"
  echo "Suites: $UBUNTU_CODENAME"
  echo 'Components: main'
  echo 'Signed-By: /usr/share/keyrings/tailscale-archive-keyring.gpg'
} | sudo tee /etc/apt/sources.list.d/tailscale.sources
sudo rm /etc/apt/sources.list.d/tailscale.list

Polecenie to wyświetla zapisaną sekcję, co pozwala na weryfikację pól przed kolejnym apt update. Cztery z nich wymagają szczegółowego omówienia, ponieważ każde z nich powoduje inny rodzaj błędu:

  • URIs kończy się na bazie repozytorium. Wklejenie części dists/noble powoduje błąd 404, ponieważ apt samodzielnie dodaje dists/<suite> i żąda dists/noble/dists/noble.
  • Suites to nazwa kodowa, dokładnie ta wartość, która znajdowała się w środku formatu jednowierszowego.
  • Signed-By przyjmuje ścieżkę bezwzględną do pliku z kluczem. Akceptuje również klucz w formacie armored wklejony bezpośrednio poniżej, gdzie każdy wiersz klucza jest poprzedzony spacją, a każda pusta linia wewnątrz klucza jest zapisana jako pojedyncza kropka.
  • Enabled: no wyłącza źródło bez jego usuwania, co jest łatwiejsze do cofnięcia niż zmiana nazwy i łatwiejsze do wyjaśnienia kolejnej osobie.

Dla repozytoriów zewnętrznych należy zachować jedną sekcję na plik, a w przypadku przechowywania kilku sekcji razem, należy oddzielić je pustą linią. Indeks repozytorium wymienia amd64 oraz arm64 wśród obsługiwanych architektur, więc VPS z architekturą ARM nie wymaga dodatkowego pola Architectures.

Proxy pośredniczący zwraca błąd 403

Kod 403 oznacza odmowę wykonania żądania, jednak nie wskazuje miejsca wystąpienia blokady: może ona wynikać z działania urządzenia między serwerem a Tailscale lub filtrowania po stronie usługi. Należy rozpocząć od konfiguracji apt, ponieważ ustawienia proxy zdefiniowane w tym miejscu dotyczą apt, a nie interaktywnego polecenia curl.

grep -RIn -i proxy /etc/apt/apt.conf.d/ /etc/apt/apt.conf
sudo apt-config dump | grep -i 'acquire::http'

Następnie należy monitorować ruch wysyłany przez apt.

sudo apt -o Debug::Acquire::http=1 update

Polecenie to wyświetla linię żądania, nagłówki wysłane przez apt oraz użyty serwer proxy. Należy porównać te dane z wynikami zwykłego polecenia curl skierowanego do tego samego adresu URL. Jeśli curl zwraca 200, a apt zwraca 403, należy porównać nagłówki żądania oraz ustawienia proxy; filtrowanie po stronie usługi lub na ścieżce sieciowej może opierać się na identyfikatorze user agent:

curl -sS -o /dev/null -w '%{http_code}\n' -A 'Debian APT-HTTP/1.3' https://pkgs.tailscale.com/stable/ubuntu/dists/noble/InRelease

Jeśli powyższe polecenie zwraca 403, podczas gdy domyślny curl zwraca 200, odpowiedź zależy od user agent, jednak test ten nie wskazuje miejsca filtrowania. Należy sprawdzić reguły filtrowania w sieci i zgłosić różnice w odpowiedziach do Tailscale, jeśli reguły te nie wyjaśniają zaistniałej sytuacji. Jeśli każde żądanie z serwera otrzymuje kod 403, należy wykonać to samo polecenie curl z maszyny w innej sieci: wynik 200 w takiej lokalizacji oznacza, że odmowa zależy od klienta lub sieci, choć różnicę tę mogą powodować również reguły po stronie usługi, takie jak ograniczenia geograficzne. Należy również sprawdzić stronę statusu Tailscale; kod 403 z obu sieci nie wskazuje jednoznacznie źródła blokady. Korporacyjny serwer proxy z inspekcją TLS zachowuje się inaczej: apt zgłasza błąd weryfikacji certyfikatu, jeśli urząd certyfikacji wystawiający certyfikat proxy nie jest zaufany na serwerze. Innym częstym źródłem problemów jest chmurowy firewall wyjściowy, który zezwala jedynie na dostęp do mirrorów Ubuntu; rozwiązaniem jest zezwolenie na pkgs.tailscale.com w konfiguracji firewalla.

Ruch wychodzący tylko przez IPv6 oraz błędy niebędące kodami statusu

Jeśli apt nie otrzymał żadnej odpowiedzi HTTP, należy przetestować każdy protokół z osobna.

curl -4 -sS -o /dev/null -w 'v4 %{http_code}\n' https://pkgs.tailscale.com/stable/ubuntu/dists/noble/InRelease
curl -6 -sS -o /dev/null -w 'v6 %{http_code}\n' https://pkgs.tailscale.com/stable/ubuntu/dists/noble/InRelease

Gdy IPv4 odpowiada, a IPv6 zawiesza się lub zgłasza Network is unreachable, test IPv6 zakończył się niepowodzeniem, jednak sam ten fakt nie wyjaśnia błędu apt. Wersja APT 2.8 automatycznie przełącza się między rodzinami adresów i rozpoczyna kolejną próbę połączenia po domyślnych 250 milisekundach. Należy wymusić uruchomienie przez IPv4, aby sprawdzić, czy zmieni to wynik działania apt:

sudo apt -o Acquire::ForceIPv4=true update

Jeśli aktualizacja zakończy się powodzeniem, należy wprowadzić to ustawienie na stałe.

echo 'Acquire::ForceIPv4 "true";' | sudo tee /etc/apt/apt.conf.d/99force-ipv4

W przypadku przeciwnym należy zachować realizm. Na serwerze VPS, który nie posiada adresu IPv4, wymuszanie IPv4 nic nie zmieni, ponieważ nie istnieje trasa IPv4, przez którą można by skierować ruch. Jeśli repozytorium jest nieosiągalne przez natywne IPv6, wymagane jest użycie NAT64 wraz z DNS64 od dostawcy lub serwera proxy posiadającego adres IPv4. Błąd połączenia wskazujący adres IPv6 oznacza, że próba połączenia przez IPv6 nie powiodła się; należy użyć linii curl -6, aby przetestować tę ścieżkę oddzielnie.

Mechanizmy awaryjne i związane z nimi koszty

Skrypt instalacyjny dostawcy. curl -fsSL https://tailscale.com/install.sh | sh to polecenie promowane przez Tailscale. Po przeanalizowaniu skryptu widać, że wykrywa on dystrybucję za pomocą /etc/os-release, a następnie zapisuje te same dwa pliki, które naprawiano w tym przewodniku, /usr/share/keyrings/tailscale-archive-keyring.gpg oraz /etc/apt/sources.list.d/tailscale.list, pobierając je z tych samych adresów URL. Jest to istotne dla oczekiwań użytkownika: metoda ta nie omija repozytorium blokowanego przez proxy. Kończy się niepowodzeniem w ten sam sposób, dostarczając przy tym mniej informacji diagnostycznych. Przekazywanie pobranego skryptu bezpośrednio do powłoki z uprawnieniami root to kompromis, a nie rozwiązanie, ponieważ użytkownik ufa zawartości serwera w danym momencie i nie zachowuje kopii uruchomionego kodu. Jeśli decydujesz się na ten kompromis, rób to świadomie:

curl -fsSL https://tailscale.com/install.sh -o install.sh
less install.sh
sh install.sh

Binaria statyczne. Ten sam serwer udostępnia zwykłe archiwa tar w sekcji binariów statycznych pod adresem pkgs.tailscale.com/stable. Na dzień 3 listopada 2026 r. wersja stabilna to 1.104.5, wydana 2 listopada, a plik dla architektury 64-bitowej x86 to tailscale_1.104.5_amd64.tgz. Strona zawiera również odnośnik do starszych wersji. Klient tailscale oraz demon tailscaled muszą zostać umieszczone ręcznie, a nadzór nad demonem również spoczywa na użytkowniku, dlatego ścieżka apt upgrade nie istnieje; wersja 1.104.5 wspiera aktualizację instalacji statycznej za pomocą sudo tailscale update poprzez pobranie nowego archiwum. Rozwiązanie to sprawdza się na hostach odizolowanych od sieci (air-gapped) lub w sytuacjach wymagających utrzymania konkretnej wersji oprogramowania.

Pakiet systemowy Ubuntu. Podczas weryfikacji w październiku 2026 r. archiwum nie zawierało pliku deb tailscale, więc polecenie sudo apt install tailscale bez repozytorium dostawcy kończyło się błędem E: Unable to locate package tailscale. Canonical publikuje pakiet snap, instalowany za pomocą sudo snap install tailscale, który dzięki pochodzeniu ze Snap Store pozwala uniknąć wszystkich powyższych błędów apt. Sprawdzony 3 listopada 2026 r. kanał 1/stable zawierał wersję 1.102.3, starszą niż aktualna wersja 1.104.5 od Tailscale. W opisie zaznaczono, że pakiet jest utrzymywany przez Canonical i niekoniecznie jest wspierany przez głównych twórców oprogramowania. Aktualizacje odbywają się zgodnie z harmonogramem snapd, co wyjaśniono w artykule zarządzanie aktualizacjami snap na Ubuntu Server. Jeśli celem jest posiadanie własnego serwera koordynującego zamiast korzystania z hostowanej usługi Tailscale, jest to odrębna decyzja: uruchamianie Headscale jako własnego serwera kontrolnego omawia ten proces, a porównanie Tailscale i standardowego WireGuard pomaga ustalić, czy cały ten mechanizm jest niezbędny.

Pakiet został zainstalowany, ale tailscaled nie uruchamia się

Gdy apt zakończy pracę, błędy mogą dotyczyć demona.

systemctl status tailscaled
sudo journalctl -u tailscaled -n 50

Na serwerze VPS korzystającym z wirtualizacji kontenerowej współdzielącej jądro hosta, takiej jak LXC lub OpenVZ, brak /dev/net/tun w dzienniku oznacza, że kontener nie ma dostępu do urządzenia TUN. Demon wymaga urządzenia TUN do utworzenia interfejsu tailscale0, a kontener go nie otrzymał. Należy poprosić dostawcę o włączenie TUN dla kontenera lub przejść na plan KVM, gdzie dostępny jest własny kernel. W przypadku KVM system gościa nadal wymaga modułu jądra tun; dokumentacja Tailscale dla systemu Linux zaleca załadowanie go za pomocą sudo modprobe tun, jeśli jest nieobecny.

Następnie sudo tailscale up wyświetli adres URL logowania, a tailscale status powinno wyświetlić maszynę z adresem z zakresu 100.64.0.0/10. Maszyna, która się tam pojawi, jest gotowa do dalszej konfiguracji, niezależnie od tego, czy oznacza to ogłaszanie prywatnej podsieci z VPS czy używanie VPS jako węzła wyjściowego.

FAQ

Dlaczego apt zgłasza, że repozytorium Tailscale nie jest podpisane?

Ponieważ apt pobrało indeks repozytorium i nie mogło zweryfikować jego podpisu względem /usr/share/keyrings/tailscale-archive-keyring.gpg. Zazwyczaj przyczyną jest zerowy rozmiar pliku kluczy: sudo tee obcięło plik, zanim curl zdołał cokolwiek pobrać, a potok zgłosił sukces, ponieważ tee zakończyło się powodzeniem. Uruchom gpg --show-keys /usr/share/keyrings/tailscale-archive-keyring.gpg. Poprawny plik kluczy wyświetla linię pub oraz linię uid wskazującą na Tailscale, podczas gdy pusty lub uszkodzony plik wyświetla gpg: no valid OpenPGP data found.. Pobierz klucz do pliku tymczasowego, sprawdź go, a następnie skopiuj w docelowe miejsce z uprawnieniami 0644, aby użytkownik _apt mógł go odczytać.

Jaką nazwę kodową Ubuntu należy umieścić w adresach URL Tailscale?

Użyj wartości UBUNTU_CODENAME z pliku /etc/os-release, która wynosi noble dla Ubuntu 24.04, resolute dla Ubuntu 26.04 oraz stonking dla Ubuntu 26.10. Nie używaj lsb_release -cs w dystrybucjach pochodnych Ubuntu: w Linux Mint 22 polecenie to zwraca wilma, Tailscale nie publikuje nic pod tą nazwą, a apt zgłasza błąd 404 dla dists/wilma/InRelease. Przed edycją jakichkolwiek plików potwierdź swój wybór, pobierając indeks ręcznie za pomocą curl -sS -o /dev/null -w '%{http_code}\n' z adresu https://pkgs.tailscale.com/stable/ubuntu/dists/<codename>/InRelease.

Czy bezpieczne jest uruchamianie skryptu instalacyjnego Tailscale bezpośrednio przez potok do powłoki?

Jest to decyzja, którą należy podjąć świadomie. Skrypt pochodzi od Tailscale i wykonuje te same czynności, co kroki ręczne: odczytuje /etc/os-release, zapisuje ten sam plik kluczy oraz ten sam /etc/apt/sources.list.d/tailscale.list, a następnie instaluje pakiet. Kosztem jest uruchomienie wszystkiego, co serwer zwróci w danym momencie, z uprawnieniami root, bez zachowania kopii skryptu. Pobierz go za pomocą -o install.sh, przeczytaj, a następnie uruchom, jeśli chcesz wygody bez ryzyka związanego z brakiem wglądu w kod. Skrypt nie pomoże również w przypadku zablokowanego repozytorium, ponieważ korzysta z tych samych adresów URL, które wcześniej zawiodły.

Jak zainstalować Tailscale na Ubuntu bez użycia repozytorium apt?

Istnieją dwie drogi. Pierwszą jest pakiet snap utrzymywany przez Canonical, sudo snap install tailscale, który na dzień 3 listopada 2026 zawierał wersję 1.102.3 w kanale 1/stable i niekoniecznie jest wspierany przez Tailscale. Drugą są statyczne archiwa tarball publikowane pod adresem pkgs.tailscale.com, które na dzień 3 listopada 2026 są w wersji 1.104.5, a plik dla architektury amd64 nosi nazwę tailscale_1.104.5_amd64.tgz. W przypadku archiwów tarball należy samodzielnie zainstalować programy tailscale oraz tailscaled i samodzielnie uruchomić demona w systemd. Nie ma pakietu apt, który pobrałby nową wersję, ale wersja 1.104.5 wspiera sudo tailscale update dla instalacji statycznych. Podczas weryfikacji w październiku 2026 archiwum Ubuntu nie zawierało własnego pakietu deb tailscale, więc sudo apt install tailscale na maszynie bez repozytorium producenta kończyło się na E: Unable to locate package tailscale.

Czy ten artykuł był przydatny?