Gluetun: komunikacja z hostem i innymi kontenerami
Dowiedz się, jak poprawnie skonfigurować porty i dostęp do sieci dla kontenerów korzystających z Gluetun. Rozwiązujemy problem braku własnych interfejsów sieciowych w VPN.
Co się dzieje, gdy kontener dołącza do sieci gluetun
Kontener, w którym ustawiono network_mode: service:gluetun, nie posiada własnych interfejsów sieciowych. Dołącza on do przestrzeni nazw sieciowej (network namespace) usługi gluetun, dlatego publikowanie portów i reguły zapory sieciowej przestają być właściwościami tego kontenera, a stają się właściwościami usługi gluetun. Każda odpowiedź poniżej wynika z tego jednego faktu.
Przestrzeń nazw sieciowa to prywatna kopia stosu sieciowego w jądrze systemu: posiada własne interfejsy, własną tablicę routingu, własne reguły zapory sieciowej oraz własne gniazda nasłuchujące. Docker domyślnie przydziela każdemu kontenerowi taką przestrzeń. Gdy użyjesz network_mode: service:gluetun, Docker pomija ten krok i umieszcza nowy kontener wewnątrz przestrzeni nazw, która już należy do gluetun. Kontener zachowuje własny system plików, ale nie własne /etc/hosts ani /etc/resolv.conf: Docker przekazuje mu te same pliki, których używa gluetun, co ma znaczenie w dalszej części.
Można to sprawdzić bezpośrednio.
docker inspect -f '{{.HostConfig.NetworkMode}}' qbittorrentPolecenie to wyświetla container:, a po nim identyfikator kontenera gluetun, podczas gdy zwykły kontener wyświetliłby bridge. Ten przewodnik kontynuuje temat w miejscu, w którym kończy się kierowanie ruchu Docker przez VPN za pomocą gluetun: tunel działa, a teraz nic nie może połączyć się z kontenerem.
Publikacja portu w gluetun, a nie w aplikacji
Pozostawienie bloku ports: w usłudze, która ustawia network_mode, powoduje, że Docker odmawia utworzenia kontenera:
Error response from daemon: conflicting options: port publishing and the container type network modePrzyczyna jest bezpośrednia. Publikacja portu oznacza dodanie reguły NAT (network address translation), która przekierowuje port hosta do przestrzeni nazw sieciowej kontenera, a ten kontener jej nie posiada. Przenieś mapowanie do usługi gluetun. Numer portu nie ulega zmianie, ponieważ aplikacja nadal nasłuchuje na tym porcie wewnątrz współdzielonej przestrzeni nazw.
services:
gluetun:
ports:
- "8080:8080/tcp" # qBittorrent web UI
qbittorrent:
network_mode: "service:gluetun"
# no ports: block hereBlok expose: w usłudze zależnej kończy się tym samym błędem, z komunikatem conflicting options: port exposing and the container type network mode, a blok networks: w tym miejscu również stanowi twardą blokadę: Compose zgłasza, że usługa deklaruje wzajemnie wykluczające się network_mode oraz networks i całkowicie odmawia wczytania pliku.
Jedna konsekwencja ujawnia się później. Każdy kontener w przestrzeni nazw współdzieli tę samą pulę portów, więc dwie aplikacje, z których obie domyślnie korzystają z 8080, wchodzą w konflikt, a druga z nich kończy działanie z błędem adresu już w użyciu. Zmień jeden z nich w konfiguracji samej aplikacji, na przykład za pomocą zmiennej WEBUI_PORT w obrazie qBittorrent od LinuxServer, a następnie opublikuj nowy numer w gluetun.
W jaki sposób kontenery za gluetun komunikują się ze sobą?
Wewnątrz przestrzeni nazw współdzielą one interfejs loopback. Kontener znajdujący się za gluetun łączy się z kontenerem towarzyszącym pod adresem 127.0.0.1:<port> bez udziału sieci Docker.
Spoza przestrzeni nazw kontener nie posiada nazwy. Wbudowany serwer DNS Dockera rozwiązuje nazwę usługi na adres tej usługi w sieci zdefiniowanej przez użytkownika, a ten kontener nie posiada adresu w żadnej sieci. Dlatego standardowy kontener, taki jak Sonarr, nie łączy się z klientem torrent pod adresem http://qbittorrent:8080. Łączy się z nim pod adresem http://gluetun:8080, ponieważ gniazdo nasłuchuje w przestrzeni nazw gluetun, na adresie gluetun. Jest to zaskakujące dla osób znających zasady działania sieci Docker Compose i nazw usług i oczekujących zastosowania standardowego nazewnictwa. Działa to również bez publikowania czegokolwiek na hoście, ponieważ oba kontenery znajdują się w tej samej sieci Compose.
Przed rozpoczęciem jakiegokolwiek debugowania należy sprawdzić DNS. Gluetun uruchamia własny serwer DNS wewnątrz przestrzeni nazw, a Docker przekazuje każdemu kontenerowi za gluetun ten sam plik /etc/resolv.conf co gluetun, więc zapytania aplikacji przechodzą przez resolver gluetun, a nie hosta. Domyślnie resolver ten odrzuca również odpowiedzi wskazujące na adresy prywatne, dlatego nazwa, która rozwiązuje się na hoście, może nie działać wewnątrz kontenera. Dokumentacja gluetun wskazuje, że takie nazwy hostów muszą zostać umieszczone w DNS_REBINDING_PROTECTION_EXEMPT_HOSTNAMES.
docker exec qbittorrent cat /etc/resolv.confJak uzyskać dostęp do usługi działającej na hoście Docker?
Należy użyć host.docker.internal. Wymaga to dwóch ustawień, obu w usłudze gluetun, ponieważ dwie różne rzeczy nie działają poprawnie.
Najpierw nazwa. Kontener znajdujący się za gluetun odczytuje /etc/hosts usługi gluetun, a Docker odrzuca wpis extra_hosts w usłudze, która ustawia network_mode za pomocą conflicting options: custom host-to-IP mapping and the network mode. Dlatego wpis musi znajdować się w konfiguracji gluetun, dzięki czemu każdy kontener w tej przestrzeni nazw będzie go widział.
gluetun:
extra_hosts:
- "host.docker.internal:host-gateway"host-gateway to specjalna wartość, którą Docker zastępuje wewnętrznym adresem samego hosta. W standardowej instalacji Docker na systemie Linux jest to adres mostka docker0, zazwyczaj 172.17.0.1. Wartość tę można potwierdzić za pomocą ip -4 addr show docker0 na serwerze VPS. Docker Desktop rozwiązuje tę nazwę automatycznie, dlatego poradniki pisane na laptopy pomijają linię extra_hosts, co powoduje, że ten sam plik nie działa na serwerze.
Następnie trasa. Dodanie nazwy informuje kontener jedynie o tym, jakiego adresu użyć. Pakiet nadal opuszcza kontener przez domyślną trasę gluetun, czyli tunel, a zapora sieciowa gluetun go odrzuca. Objawem jest połączenie, które zawiesza się, a następnie przekracza limit czasu, zamiast zostać odrzuconym. Odmowa oznacza, że pakiet dotarł i otrzymał odpowiedź odmowną. Przekroczenie limitu czasu oznacza, że pakiet nigdy nie dotarł do celu.
gluetun:
environment:
- FIREWALL_OUTBOUND_SUBNETS=172.17.0.1/32Następnie należy sprawdzić, czy usługa hosta rzeczywiście nasłuchuje na tym adresie. Serwer PostgreSQL powiązany tylko z 127.0.0.1 jest nieosiągalny z poziomu każdego kontenera posiadającego własną przestrzeń nazw sieciowych, co obejmuje wszystkie kontenery za gluetun (niezależnie od tunelu), ponieważ 127.0.0.1 wewnątrz przestrzeni nazw jest jej własnym interfejsem zwrotnym (loopback). Tylko kontener korzystający z sieci hosta współdzieli jego interfejs zwrotny, a kontener za gluetun już wykorzystał swój network_mode na gluetun. Zamiast tego należy powiązać PostgreSQL z 172.17.0.1: akceptuje on połączenia z kontenerów, pozostając jednocześnie poza publicznym interfejsem. Należy to zweryfikować za pomocą ss -lntp | grep 5432 na hoście.
Co faktycznie zmienia zmienna FIREWALL_OUTBOUND_SUBNETS
Dokumentacja gluetun opisuje tę zmienną jako listę podsieci rozdzielonych przecinkami, do których gluetun oraz kontenery współdzielące jego stos sieciowy mają dostęp. Zaznacza również, że wiąże się to ze zmianami w zaporze sieciowej oraz tablicy routingu. Obie te kwestie są istotne. Gluetun dodaje trasę dla każdej wymienionej podsieci przez bramę mostu Docker, dzięki czemu pakiety dla tych adresów opuszczają system przez eth0, a nie przez tunel. Zmienna ta otwiera również zaporę sieciową dla tych podsieci, ponieważ w przeciwnym razie gluetun odrzuca ruch wychodzący, który nie jest kierowany do serwera VPN.
Wartość należy wpisać bez spacji po przecinkach.
- FIREWALL_OUTBOUND_SUBNETS=172.17.0.1/32,192.168.1.0/24,100.64.7.9/32Dwie właściwości są często pomijane. Jest to ustawienie na poziomie przestrzeni nazw, więc dotyczy każdego kontenera znajdującego się za gluetun, a nie tylko tego, który był zamierzony. Ponadto dotyczy ono wyłącznie ruchu wychodzącego: reguluje połączenia inicjowane przez kontener. Połączenia przychodzące na opublikowany port korzystają z innej ścieżki i nie wymagają wpisu w tym miejscu.
Dostęp do interfejsu WWW z węzła Tailscale
Tailscale nadaje każdej maszynie adres w sieci 100.64.0.0/10, zarezerwowanej dla rozwiązań typu carrier grade NAT. W prywatnej sieci tailnet jest to bezpłatne, choć limit sześciu użytkowników w planie darmowym decyduje o tym, czy pozostanie tak, gdy dostęp do tych samych interfejsów będą musiały uzyskać inne osoby. Liczba urządzeń użytkowników jest nieograniczona w każdym planie. Serwery i inne urządzenia z tagami są liczone oddzielnie: strona cennika Tailscale uwzględnia 50 zasobów z tagami, a każdy kolejny kosztuje 1 USD miesięcznie. Ponieważ rozliczenia opierają się głównie na liczbie użytkowników, a nie maszyn, rzeczywisty koszt płatnego tailnetu zależy głównie od liczby zaproszonych osób, a nie od liczby udostępnionych im kontenerów. Oba kierunki ruchu wymagają odrębnej konfiguracji.
Ruch przychodzący jest prostszy. Publikacja 8080:8080 w gluetun wiąże ten port ze wszystkimi adresami hosta, a interfejs tailscale0 hosta jest jednym z nich, więc węzeł otwiera http://<machine-name>:8080 i uzyskuje dostęp do kontenera. Docker stosuje NAT na hoście, a firewall gluetun zezwala na ruch przychodzący do swojej podsieci Docker.
Aby interfejs był dostępny wyłącznie przez tailnet, należy powiązać opublikowany port z adresem Tailscale hosta, zamiast ze wszystkimi adresami.
ports:
- "100.101.102.103:8080:8080/tcp"Adres ten można znaleźć za pomocą tailscale ip -4 na hoście. Powiązanie jest w tym przypadku silniejszym zabezpieczeniem niż reguła firewalla, ponieważ port w ogóle nie jest otwierany na interfejsie publicznym. Jeśli zamiast adresu hosta i portu preferowany jest dostęp do interfejsu przez nazwę HTTPS, można użyć tailscale serve przed opublikowanym portem, choć serve i funnel różnią się tym, kto może uzyskać dostęp i tylko jedna z tych opcji utrzymuje interfejs wewnątrz tailnetu. Pozwala to również ominąć problem opisany w publikowaniu portów Dockera z pominięciem ufw. Wzorzec sidecar Tailscale dla Compose idzie o krok dalej i całkowicie eliminuje port hosta, ale działa poprzez umieszczenie aplikacji w przestrzeni nazw sieciowej sidecara, a kontener za gluetun wykorzystał już swój jedyny network_mode na gluetun.
Ruch wychodzący to obszar, w którym powraca FIREWALL_OUTBOUND_SUBNETS. Jeśli kontener musi wywołać węzeł, należy dodać adres tego węzła i preferować /32 dla każdego węzła zamiast całego /10. Jeśli wywoływana maszyna znajduje się w sieci prywatnej dostępnej przez VPS ogłaszający tę podsieć w Twoim tailnecie, należy wymienić ogłoszony zakres zamiast własnego adresu 100.x routera i potwierdzić, że host zaakceptował te trasy. Nazwy MagicDNS domyślnie nie są rozwiązywane wewnątrz kontenera, ponieważ kontener używa serwera DNS gluetun zamiast resolvera hosta, dlatego należy użyć numerycznego adresu 100.x lub przypisać nazwę za pomocą linii extra_hosts w usłudze gluetun. Opcja DNS_UPSTREAM_PLAIN_ADDRESSES w gluetun pozwala przekazywać zapytania do innego resolvera, ale wysyła każde zapytanie otwartym tekstem, a dokumentacja gluetun odradza to rozwiązanie, ponieważ zapytania do prywatnych adresów wyciekają poza tunel VPN. To samo dotyczy sytuacji, gdy uruchamiasz własny serwer kontrolny Tailscale za pomocą Headscale.
Kompletny plik compose dla typowego schematu
Klient pobierający za VPN, dwa interfejsy webowe dostępne wyłącznie w sieci tailnet oraz jeden kontener odczytujący bazę danych PostgreSQL działającą na hoście.
services:
gluetun:
image: qmcgaw/gluetun:latest
container_name: gluetun
cap_add:
- NET_ADMIN
devices:
- /dev/net/tun:/dev/net/tun
ports:
- "127.0.0.1:8000:8000/tcp" # gluetun control server, host only
- "100.101.102.103:8080:8080/tcp" # qBittorrent UI, tailnet only
- "100.101.102.103:9696:9696/tcp" # Prowlarr UI, tailnet only
extra_hosts:
- "host.docker.internal:host-gateway"
volumes:
- ./gluetun:/gluetun
environment:
- VPN_SERVICE_PROVIDER=mullvad
- VPN_TYPE=wireguard
- WIREGUARD_PRIVATE_KEY=${WIREGUARD_PRIVATE_KEY}
- WIREGUARD_ADDRESSES=${WIREGUARD_ADDRESSES}
- SERVER_CITIES=Amsterdam
- FIREWALL_OUTBOUND_SUBNETS=172.17.0.1/32,100.64.7.9/32
- TZ=Europe/Amsterdam
restart: unless-stopped
qbittorrent:
image: lscr.io/linuxserver/qbittorrent:latest
network_mode: "service:gluetun"
environment:
- PUID=1000
- PGID=1000
- TZ=Europe/Amsterdam
- WEBUI_PORT=8080
volumes:
- ./qbittorrent:/config
- /srv/downloads:/downloads
depends_on:
gluetun:
condition: service_healthy
restart: unless-stopped
prowlarr:
image: lscr.io/linuxserver/prowlarr:latest
network_mode: "service:gluetun"
environment:
- PUID=1000
- PGID=1000
- TZ=Europe/Amsterdam
- PROWLARR__POSTGRES__HOST=host.docker.internal
- PROWLARR__POSTGRES__PORT=5432
- PROWLARR__POSTGRES__USER=prowlarr
- PROWLARR__POSTGRES__PASSWORD=${PROWLARR_DB_PASSWORD}
- PROWLARR__POSTGRES__MAINDB=prowlarr-main
- PROWLARR__POSTGRES__LOGDB=prowlarr-log
volumes:
- ./prowlarr:/config
depends_on:
gluetun:
condition: service_healthy
restart: unless-stoppedNależy analizować plik pod kątem wzorca, a nie nazw konkretnych produktów. Oba interfejsy są publikowane przez gluetun i powiązane z adresem tailnet hosta, dzięki czemu odpowiadają wyłącznie w sieci Tailscale. Linia extra_hosts również znajduje się w sekcji gluetun, ponieważ Prowlarr odczytuje /etc/hosts z gluetun podczas rozwiązywania host.docker.internal, a Docker odrzuciłby tę linię w definicji samego Prowlarr. FIREWALL_OUTBOUND_SUBNETS wskazuje dwa pojedyncze adresy: adres mostu Docker hosta, aby Prowlarr mógł nawiązać połączenie z bazą danych, oraz adres jednego węzła w sieci tailnet.
Serwer PostgreSQL celowo nie został uwzględniony w pliku. Działa on na VPS jako zwykła usługa systemowa nasłuchująca na 172.17.0.1:5432. Jest to ten sam model warstwowy, co w przypadku stosu arr w Docker Compose, z bazą danych przeniesioną poza środowisko Docker.
Klucz prywatny WireGuard należy przechowywać poza plikiem compose. ${WIREGUARD_PRIVATE_KEY} odczytuje dane z pliku .env znajdującego się obok, co opisano w sekcji pliki env i sekrety dla Docker Compose. Klauzula condition: service_healthy wykorzystuje mechanizm healthcheck dostarczany w obrazie gluetun, dzięki czemu żadna usługa nie uruchomi się, dopóki tunel nie zgłosi gotowości. Healthchecki w Compose wyjaśniają ogólną formę tego rozwiązania.
Publikowanie na wszystkich adresach zamiast tylko w sieci tailnet
Należy usunąć prefiks adresu oraz powiązania portów w 0.0.0.0, co obejmuje publiczny adres IP serwera VPS. Należy to robić wyłącznie za kontrolowanym firewallem i po uprzednim zapoznaniu się z uwagami dotyczącymi ufw.
ports:
- "8080:8080/tcp"Weryfikacja przesyłu ruchu przez tunel
Wykonaj dwukrotnie to samo żądanie: raz z wnętrza przestrzeni nazw (namespace), a raz z hosta, a następnie porównaj wyniki.
docker run --rm --network=container:gluetun curlimages/curl:latest -s https://api.ipify.org
curl -s https://api.ipify.orgPierwsze polecenie powinno zwrócić adres wyjściowy dostawcy VPN. Drugie powinno zwrócić adres VPS. Jeśli adresy są identyczne, ruch kontenera nie przechodzi przez tunel. W takim przypadku wszelkie poprawki opisane w tym przewodniku są bezcelowe, dopóki ten problem nie zostanie rozwiązany.
Reguły routingu oraz tablice wskazują, który ruch jest kierowany poza tunelem, a który nie.
docker run --rm --network=container:gluetun alpine:3.22 sh -c 'ip rule show; ip route show table 51820; ip route show table 199'W konfiguracji WireGuard opisanej w tym przewodniku, gluetun nadaje interfejsowi tunelu nazwę wg0. Nazwa tun0 jest domyślna tylko dla OpenVPN. Gluetun utrzymuje również domyślną trasę tunelu poza główną tablicą routingu. ip rule show powinno zawierać regułę kierującą cały ruch nieoznaczony przez WireGuard do tablicy 51820, która z kolei powinna zawierać domyślną trasę przez wg0. Tablica 199 zawiera po jednej trasie dla każdego wpisu w FIREWALL_OUTBOUND_SUBNETS, z których każda wskazuje na bramę mostu Docker na eth0, a jej reguła jest sprawdzana tuż przed regułą tunelu. Zwykłe polecenie ip route show nadal wyświetla domyślną trasę Dockera na eth0. Jest to zachowanie oczekiwane i nie stanowi wycieku, ponieważ obie reguły gluetun są sprawdzane przed główną tablicą. Każda trasa w tablicy 199, która nie została wymieniona, oznacza ruch pomijający VPN.
Serwer kontrolny gluetun może raportować ten sam publiczny adres IP na porcie 8000, pod adresem /v1/publicip/ip, ale domyślnie jest to możliwe dopiero po skonfigurowaniu uwierzytelniania. Dokumentacja gluetun wskazuje, że wszystkie trasy serwera kontrolnego są obecnie domyślnie prywatne, więc zwykłe żądanie do tej ścieżki kończy się niepowodzeniem. Należy skonfigurować go za pomocą pliku uwierzytelniania zamontowanego w /gluetun/auth/config.toml przy użyciu metody basic lub apikey, a następnie zrestartować gluetun. Powyższy plik Compose montuje już ./gluetun w /gluetun, więc plik należy umieścić w ./gluetun/auth/config.toml na hoście. Zmienna HTTP_CONTROL_SERVER_AUTH_DEFAULT_ROLE stanowi szybszą drogę. Ustawienie jej na {"auth":"none"} całkowicie wyłącza uwierzytelnianie, co w dokumentacji jest stanowczo odradzane. W wersjach starszych niż v3.39.1 serwer nie jest zabezpieczony w ten sposób, a dokumentacja ostrzega, aby ufać każdemu, kto może uzyskać do niego dostęp.
Zagrożenia wynikające z błędnej podsieci
FIREWALL_OUTBOUND_SUBNETS to celowo wykonana dziura w firewallu, więc rozmiar tej dziury odpowiada rozmiarowi ryzyka. Należy unikać czterech błędów:
0.0.0.0/0kończy się niepowodzeniem walidacji konfiguracji zoutbound subnet has an unspecified address: 0.0.0.0/0. Gluetun odrzuca ją zamiast kierować cały ruch poza tunel.- Zakres szerszy niż docelowy. Otwarcie
10.0.0.0/8w celu uzyskania dostępu do jednej maszyny pod10.0.1.7otwiera również każdy adres, który węzeł torrent może ogłosić w tym zakresie. Należy wpisać10.0.1.7/32. - Zakres pokrywający się z adresami tunelu. Dokumentacja gluetun ostrzega, że powoduje to wysyłanie ruchu VPN przez most, co przerywa przekierowanie portów. Przed otwarciem jakiegokolwiek prywatnego zakresu należy sprawdzić wartość
WIREGUARD_ADDRESSES. 100.64.0.0/10dla Tailscale. Oznacza to otwarcie około czterech milionów adresów, aby uzyskać dostęp do jednego węzła. Należy wymienić potrzebne węzły jako wpisy/32.
Należy pamiętać, że ustawienie obejmuje całą przestrzeń nazw. Otwarcie podsieci, aby indeksator mógł uzyskać dostęp do usługi hosta, otwiera tę samą podsieć dla klienta torrent współdzielącego tę przestrzeń nazw. Po każdej zmianie tej zmiennej należy ponownie sprawdzić publiczny adres IP, ponieważ jest to jedyny test potwierdzający, czy zmiana przyniosła zamierzony skutek.
Co ulega awarii podczas restartu gluetun
Kontener gluetun zarządza przestrzenią nazw (namespace), dlatego cykl życia gluetun jest tożsamy z cyklem życia tej przestrzeni. Uruchomienie kontenera zależnego w momencie, gdy gluetun nie działa, kończy się natychmiastowym błędem:
Error response from daemon: cannot join network namespace of a non running container: container <id> is exitedRestartowanie gluetun w miejscu powoduje mniej oczywistą awarię. Kontenery zależne działają nadal, podczas gdy przestrzeń nazw, do której są przypisane, jest przebudowywana pod nimi. W rezultacie docker ps raportuje poprawny stan, mimo że żadna usługa nie odpowiada. Po każdej zmianie w usłudze gluetun należy odtworzyć całą grupę kontenerów, zamiast restartować tylko jej część.
docker compose up -d --force-recreateTa sama zasada dotyczy aktualizacji obrazów. Pobranie nowego obrazu gluetun i odtworzenie tylko tej jednej usługi sprawia, że pozostałe kontenery wskazują na przestrzeń nazw, która już nie istnieje.
FAQ
Dlaczego Docker zgłasza błąd dotyczący publikowania portów i trybu sieciowego kontenera?
Ponieważ blok ports: znajduje się w usłudze, która jednocześnie ustawia network_mode: service:gluetun. Publikowanie portu dodaje regułę NAT przekierowującą port hosta do przestrzeni nazw sieciowej kontenera, a kontener w tym trybie jej nie posiada. Należy usunąć blok ports: z tej usługi i dodać identyczne mapowanie do usługi gluetun. Numer portu pozostaje bez zmian, ponieważ aplikacja nadal nasłuchuje na nim wewnątrz współdzielonej przestrzeni nazw.
Jak inne kontenery mogą połączyć się z usługą działającą za gluetun?
Kontenery wewnątrz tej samej przestrzeni nazw komunikują się ze sobą poprzez 127.0.0.1. Kontenery znajdujące się poza nią używają nazwy usługi gluetun, dlatego http://gluetun:8080 działa, podczas gdy http://qbittorrent:8080 nie. Kontener aplikacji nie posiada adresu w żadnej sieci Docker, więc wbudowany serwer DNS nie ma czego rozwiązać dla jego nazwy. Publikowanie portów nie jest do tego wymagane, o ile oba kontenery współdzielą sieć Compose.
Co należy wpisać w FIREWALL_OUTBOUND_SUBNETS?
Wyłącznie adresy, z którymi kontener działający za gluetun musi zainicjować połączenie, określone w sposób jak najbardziej precyzyjny. Pojedyncza maszyna to /32. Dwa typowe wpisy to host Docker pod adresem 172.17.0.1/32 oraz jeden /32 dla każdego węzła Tailscale, z którym nawiązywane jest połączenie. Nigdy nie należy dodawać 0.0.0.0/0 ani zakresów pokrywających się z adresami tunelu VPN. Połączenia przychodzące na opublikowany port nie wymagają wpisu w tym miejscu.
Dlaczego kontener nie może rozwiązać nazw Tailscale MagicDNS?
MagicDNS działa poprzez wskazanie serwera DNS Tailscale jako resolvera hosta, a kontener nie korzysta z resolvera hosta. Używa on /etc/resolv.conf współdzielonego z gluetun, który wskazuje na własny serwer DNS usługi gluetun. Należy to potwierdzić za pomocą docker exec <container> cat /etc/resolv.conf. Należy użyć numerycznego adresu 100.x węzła lub przypisać nazwę za pomocą wpisu extra_hosts w usłudze gluetun. Gluetun może przekazywać zapytania do innego resolvera za pomocą DNS_UPSTREAM_PLAIN_ADDRESSES, jednak przesyła je wtedy otwartym tekstem, co zgodnie z dokumentacją nie jest zalecane.
Jak potwierdzić, że ruch nadal przechodzi przez VPN?
Należy wykonać jedno zapytanie z wnętrza przestrzeni nazw oraz to samo zapytanie z poziomu hosta, a następnie porównać wyniki. docker run --rm --network=container:gluetun curlimages/curl:latest -s https://api.ipify.org powinno zwrócić adres wyjściowy dostawcy VPN, podczas gdy curl -s https://api.ipify.org na VPS zwróci adres VPS. Dwie identyczne odpowiedzi oznaczają, że tunel nie obsługuje ruchu kontenera. Test należy powtórzyć po każdej zmianie w FIREWALL_OUTBOUND_SUBNETS.