SSD Nodes Learn Hosting plans →
Przewodniki Matt ConnorAutor: Matt Connor · Zaktualizowano 2026-10-20

Jak ominąć CGNAT przy użyciu VPS i tunelu zwrotnego

Brak publicznego adresu IPv4 uniemożliwia przekierowanie portów. Zastosuj frp na VPS, aby zestawić tunel zwrotny i uzyskać dostęp do usług domowych przez HTTPS z certyfikatem.

Dlaczego przekierowanie portów nie działa w sieciach CGNAT

W sieciach CGNAT (carrier-grade network address translation) adres WAN routera jest współdzielony z innymi abonentami. Użytkownik nie posiada publicznego adresu IPv4, więc nie ma możliwości przekierowania portów. Rozwiązaniem jest tunel zwrotny: tani VPS z publicznym adresem IP. Serwer domowy nawiązuje połączenie wychodzące do VPS, a żądania przychodzące są przesyłane zwrotnie przez to już otwarte połączenie. Sprzęt pozostaje ten sam. Wynajmuje się jedynie to, czego dostawca nie oferuje: adres routowalny.

Każde poniższe polecenie jest oznaczone nazwą maszyny, na której należy je wykonać. Wymagane są dwie maszyny: VPS z publicznym adresem IP oraz serwer domowy, na którym działa udostępniana usługa.

Jak sprawdzić, czy korzystasz z CGNAT

Otwórz stronę administracyjną routera i odczytaj adres WAN, który raportuje urządzenie. Następnie sprawdź w zewnętrznym serwisie, jaki adres IP widzi Internet.

# on the home box
curl -4 -s https://ifconfig.me; echo

Jeśli oba adresy są identyczne, posiadasz publiczny adres IP i nie potrzebujesz żadnego z tych rozwiązań. Przekieruj port i zakończ lekturę. Jeśli adres WAN routera znajduje się wewnątrz 100.64.0.0/10, oznacza to, że korzystasz z CGNAT. Ten zakres to przestrzeń adresowa współdzielona zgodnie z RFC 6598, zarezerwowana dokładnie do tego celu. Niektórzy dostawcy usług internetowych przypisują 10.0.0.0/8 po stronie WAN, co w praktyce oznacza tę samą sytuację pod inną nazwą.

Przed wynajęciem jakiejkolwiek usługi sprawdź jedną rzecz. Wielu dostawców stosujących CGNAT przydziela rzeczywisty prefiks IPv6. Jeśli Twoje urządzenie domowe posiada globalny adres IPv6, możesz otworzyć zaporę sieciową dla tego adresu i całkowicie pominąć tunel. Rozwiązanie to przestaje działać w momencie, gdy użytkownik odwiedzający korzysta wyłącznie z sieci IPv4, dlatego większość osób ostatecznie decyduje się na opisywane tutaj metody.

Jak działa odwrotny tunel VPS, inicjowany od wewnątrz

CGNAT oraz standardowe routery domowe blokują niechciane połączenia przychodzące. Podobnie działają zapory korporacyjne. Żadne z nich nie blokuje połączeń wychodzących, ponieważ są one niezbędne do działania przeglądarek oraz klientów aktualizacji. Urządzenie NAT, wykrywając wychodzące połączenie TCP, tworzy dla niego mapowanie i zezwala na ruch zwrotny w ramach tego samego połączenia. Żaden podmiot z zewnątrz nie może zainicjować połączenia z serwerem domowym. Dlatego to serwer domowy inicjuje połączenie, a tunel przesyła ruch z powrotem w przeciwnym kierunku.

To cały mechanizm. Serwer domowy łączy się z VPS na wybranym porcie i utrzymuje to połączenie. VPS przyjmuje żądania publiczne i przekazuje je przez istniejące połączenie. Nikt nie próbuje łączyć się bezpośrednio z domowym adresem IP, więc nie jest to wymagane.

Wynikają z tego dwie użyteczne konsekwencje. Rekord DNS wskazuje na VPS, a nie na domową sieć. Publicznym adresem staje się adres VPS, więc obserwator wykonujący sprawdzenie IP uzyskuje informacje o wynajętym serwerze, a nie o domowym łączu.

Trzy sposoby na budowę rozwiązania

  1. ssh -R: narzędzie zainstalowane domyślnie po obu stronach, odpowiednie dla pojedynczej usługi lub tymczasowej demonstracji. Nie oferuje panelu sterowania ani zaawansowanej logiki wznawiania połączeń.
  2. frp: niewielki serwer w języku Go (frps) oraz pasujący do niego klient (frpc). Rozwiązanie właściwe dla stałej konfiguracji z wieloma usługami pod jedną nazwą hosta. Ta metoda stanowi główną część niniejszego przewodnika.
  3. Mesh VPN: Tailscale lub samodzielnie utrzymywany serwer WireGuard. Rozwiązanie właściwe, gdy celem jest prywatna komunikacja między własnymi urządzeniami, a nie publikowanie usług w publicznym Internecie.

Wybierz mesh VPN, jeśli celem jest prywatny dostęp z urządzeń, którymi zarządzasz. Tailscale Serve and Funnel opisuje publikowanie usług z sieci tailnet, a samodzielny serwer WireGuard VPN na tym samym VPS pozwala uzyskać ten sam efekt bez udziału zewnętrznego serwera koordynującego. Zapoznaj się z jednym z tych materiałów i pomiń resztę strony. Dalsza część poradnika zakłada, że celem jest uzyskanie publicznej nazwy hosta HTTPS dostępnej dla każdego użytkownika.

Wersja skrócona: ssh -R dla jednej usługi

Załóżmy, że serwer domowy uruchamia aplikację na 127.0.0.1:3000, a użytkownik posiada już dostęp SSH do VPS.

# on the home box
ssh -N \
  -o ExitOnForwardFailure=yes \
  -o ServerAliveInterval=30 \
  -o ServerAliveCountMax=3 \
  -R 127.0.0.1:8080:127.0.0.1:3000 \
  tunnel@vps.example.com

-R 127.0.0.1:8080:127.0.0.1:3000 instruuje proces sshd na VPS, aby nasłuchiwał na własnym 127.0.0.1:8080 i przesyłał wszystko, co tam dotrze, do 127.0.0.1:3000 na serwerze domowym. -N oznacza brak uruchamiania powłoki. Dwie opcje ServerAlive sprawiają, że SSH wykrywa zerwane połączenie w ciągu około dziewięćdziesięciu sekund, zamiast zawieszać się na nieistniejącym połączeniu.

Teraz część, która sprawia najwięcej trudności. Ten punkt nasłuchu znajduje się na interfejsie loopback, więc curl http://vps.example.com:8080 z dowolnego innego miejsca zakończy się niepowodzeniem. Oprogramowanie sshd jest dostarczane z GatewayPorts no, co oznacza, że zdalne przekierowanie wiąże się wyłącznie z interfejsem loopback. Nie należy tego naprawiać poprzez ustawienie GatewayPorts yes. Należy pozostawić przekierowanie na loopback i umieścić przed nim nginx, w ten sam sposób, jak w poniższej konfiguracji frp, tak aby port publiczny 443 posiadał certyfikat, a port tunelu nigdy nie był wystawiony na działanie Internetu. Jeśli nie ma pewności, co aktualnie nasłuchuje i na jakim interfejsie, krótki przegląd portów i procesów nasłuchujących w systemie Linux jest wart dziesięciu minut lektury.

Jeśli port jest już zajęty na VPS, ssh wyświetli poniższy komunikat, a ExitOnForwardFailure=yes spowoduje przerwanie działania zamiast nawiązania połączenia bez działającego tunelu:

Warning: remote port forwarding failed for listen port 8080

Typową przyczyną jest poprzednia sesja, która została przerwana bez wykrycia tego przez sshd. Należy ustawić ClientAliveInterval 30 oraz ClientAliveCountMax 3 w pliku /etc/ssh/sshd_config na VPS, aby martwe sesje były usuwane i zwalniały port. Całe polecenie warto umieścić w jednostce systemd z Restart=always i dedykowanym kluczem lub użyć autossh. W przypadku obsługi więcej niż jednej usługi należy przerwać w tym miejscu i użyć frp.

Instalacja frp na VPS z przypięciem wersji

Oprogramowanie frp jest dostarczane jako statyczny plik binarny Go i nie znajduje się w repozytoriach Ubuntu ani Debian, dlatego należy pobrać wydanie i samodzielnie zweryfikować jego sumę kontrolną. Należy przypiąć wersję. Format konfiguracji zmienił się w wersji v0.52.0, a nazwy opcji uległy zmianie, więc przestarzałe poradniki mogą zawierać klucze, których dany plik binarny nie rozpoznaje. Niniejszy przewodnik wykorzystuje v0.71.0, opublikowaną 14 sierpnia 2026.

# on the VPS
FRP_VERSION=0.71.0
ARCH=amd64   # use arm64 if `uname -m` prints aarch64
cd /tmp
curl -fsSLO "https://github.com/fatedier/frp/releases/download/v${FRP_VERSION}/frp_${FRP_VERSION}_linux_${ARCH}.tar.gz"
curl -fsSLO "https://github.com/fatedier/frp/releases/download/v${FRP_VERSION}/frp_sha256_checksums.txt"
sha256sum --check --ignore-missing frp_sha256_checksums.txt

sha256sum powinno wyświetlić dokładnie jedną linię:

frp_0.71.0_linux_amd64.tar.gz: OK

--ignore-missing jest wymagane, ponieważ plik sum kontrolnych obejmuje wszystkie siedemnaście archiwów wydania, a pobrano tylko jedno z nich. Bez tej flagi sha256sum zgłasza brak pozostałych szesnastu plików i kończy działanie z kodem błędem, co jest interpretowane jako nieudana weryfikacja, mimo że proces przebiegł poprawnie.

# on the VPS
tar xzf "frp_${FRP_VERSION}_linux_${ARCH}.tar.gz"
sudo install -m 755 "frp_${FRP_VERSION}_linux_${ARCH}/frps" /usr/local/bin/frps
sudo useradd --system --no-create-home --shell /usr/sbin/nologin frp
sudo install -d -m 750 -o root -g frp /etc/frp
frps --version

frps --version wyświetla 0.71.0. Tylko frps trafia na VPS. frpc trafia na komputer domowy. Instalowanie obu plików binarnych wszędzie prowadzi do sytuacji, w których użytkownicy przypadkowo uruchamiają serwer tunelu w domu.

Konfiguracja VPS: token, wymuszone TLS, nasłuchiwanie na loopback

Najpierw wygeneruj token. Jest to jedyne zabezpieczenie tunelu przed każdym, kto skanuje porty serwera VPS.

# on the VPS
openssl rand -base64 32

Zapisz tę wartość w /etc/frp/frps.toml:

bindAddr = "0.0.0.0"
bindPort = 7000

# Every listener frp creates for a proxy, including the HTTP vhost, stays on loopback.
proxyBindAddr = "127.0.0.1"
vhostHTTPPort = 8080

auth.method = "token"
auth.token = "PASTE_THE_OPENSSL_OUTPUT_HERE"

transport.tls.force = true

webServer.addr = "127.0.0.1"
webServer.port = 7500
webServer.user = "admin"
webServer.password = "PASTE_A_SECOND_SECRET_HERE"

log.level = "info"

Cztery z tych linii odpowiadają za bezpieczeństwo, dlatego należy przeanalizować je pojedynczo.

Wartość auth.token musi być zgodna z auth.token po stronie klienta. Bez tego frps zaakceptuje każdego klienta, który odnajdzie port 7000, a taki klient może następnie opublikować dowolną usługę przez Twój VPS i Twój certyfikat.

Opcja transport.tls.force = true odrzuca każde połączenie sterujące, które nie korzysta z TLS (transport layer security). Klienci mają włączone TLS domyślnie od wersji v0.50.0, więc w praktyce nie wiąże się to z żadnym kosztem, a eliminuje ryzyko połączenia starego lub niestandardowego klienta w formie jawnej bez Twojej wiedzy.

Linia proxyBindAddr = "127.0.0.1" jest pomijana w większości poradników, a to właśnie ona sprawia, że tę konfigurację można bezpiecznie pozostawić uruchomioną. Przenosi ona każdy punkt nasłuchiwania otwierany przez frp w imieniu proxy, zarówno vhost HTTP, jak i każdy remotePort żądany przez klienta, na interfejs loopback. Internet nie ma żadnego dostępu do tych punktów nasłuchiwania. Otwarte pozostają tylko dwa porty: nginx na 443, który konfigurujesz i kontrolujesz, oraz port sterujący frp na 7000, którego proxyBindAddr nie dotyczy i który jest chroniony przez token oraz wymuszone TLS.

Opcja webServer.addr = "127.0.0.1" utrzymuje panel sterowania poza publicznym interfejsem. Panel ten stanowi pełną mapę Twoich prywatnych usług oraz ich ruchu, a ponieważ jest chroniony jedynie hasłem HTTP basic auth, nie powinien być dostępny na 0.0.0.0.

Ustaw uprawnienia tak, aby token nie był dostępny do odczytu dla wszystkich, a następnie sprawdź składnię przed uruchomieniem czegokolwiek:

# on the VPS
sudo chown root:frp /etc/frp/frps.toml
sudo chmod 640 /etc/frp/frps.toml
sudo -u frp frps verify -c /etc/frp/frps.toml

Poprawny plik zwróci komunikat:

frps: the configuration file /etc/frp/frps.toml syntax is ok

Uwaga dotycząca formatu, która zaoszczędzi czas. frp odczytuje pliki .toml, .yaml, .yml oraz .json i rozpoznaje stary format INI po sekcji [common], a nie po rozszerzeniu. Pliki INI są nadal ładowane przez ścieżkę kompatybilności wstecznej, jednak format ten jest przestarzały i zostanie usunięty w przyszłych wydaniach, a nowe funkcje działają wyłącznie w TOML, YAML lub JSON. Jeśli poradnik zawiera sekcję [common] oraz server_addr = x.x.x.x, pochodzi on sprzed wersji v0.52.0. Nazwy kluczy w formacie snake_case należą do tego starszego formatu: wklejone do pliku frps.toml powyżej, nie przejdą rygorystycznej weryfikacji, którą frps verify wykonuje domyślnie.

Uruchamianie frps jako usługa bez uprawnień roota

bindPort to 7000, a vhostHTTPPort to 8080. Obie wartości przekraczają 1024, więc frps nie wymaga uprawnień roota ani użycia CAP_NET_BIND_SERVICE. Z tego powodu nie należy przypisywać vhost do portu 80, lecz przekazać to zadanie do nginx.

Utwórz /etc/systemd/system/frps.service:

[Unit]
Description=frp reverse tunnel server
After=network-online.target
Wants=network-online.target

[Service]
Type=simple
User=frp
Group=frp
ExecStart=/usr/local/bin/frps -c /etc/frp/frps.toml
Restart=on-failure
RestartSec=5s
LimitNOFILE=65535
NoNewPrivileges=true
PrivateTmp=true
ProtectSystem=strict
ProtectHome=true
ProtectKernelTunables=true

[Install]
WantedBy=multi-user.target
# on the VPS
sudo systemctl daemon-reload
sudo systemctl enable --now frps
sudo journalctl -u frps -n 20 --no-pager

Dziennik powinien wykazać oba nasłuchujące porty; adresy są istotniejsze niż same numery portów:

frps tcp listen on 0.0.0.0:7000
http service listen on 127.0.0.1:8080

ProtectSystem=strict ustawia cały system plików w tryb tylko do odczytu dla tej usługi. frps obsługuje to poprawnie, ponieważ domyślnie wysyła logi na standardowe wyjście, skąd przechwytuje je journald. Jeśli ustawisz log.to na ścieżkę do pliku, usługa nie będzie mogła w nim zapisywać, dopóki nie dodasz odpowiedniej linii ReadWritePaths=, dlatego należy pozostawić ustawienie domyślne.

Firewall: otwórz jeden port, nie zakres

# on the VPS
sudo ufw allow 22/tcp
sudo ufw allow 80/tcp
sudo ufw allow 443/tcp
sudo ufw allow 7000/tcp
sudo ufw enable
sudo ufw status numbered

Cztery reguły, z których jedna istnieje wyłącznie na potrzeby odnawiania certyfikatów. 22 to SSH. 80 przekierowuje na 443 i odpowiada na wyzwanie ACME (automatic certificate management environment). 443 obsługuje każdą tunelowaną aplikację. 7000 to port sterujący frp i jest to jedyny port, z którym klient musi się połączyć.

Poradniki zalecające otwarcie zakresu, takiego jak sudo ufw allow 20000:30000/tcp, opisują inny model projektowy, w którym każda usługa zajmuje własny publiczny port TCP. Tutaj nie jest to potrzebne, ponieważ cały ruch trafia na 443, a frp kieruje go na podstawie nazwy hosta. Jeśli w przyszłości zaistnieje potrzeba udostępnienia jednego, faktycznie publicznego portu TCP, przywróć proxyBindAddr do 0.0.0.0 i dodaj ograniczenia, aby klient mógł korzystać wyłącznie z nazwanych portów:

allowPorts = [
  { start = 20000, end = 20010 }
]
maxPortsPerClient = 5

Większość dostawców oferuje również sieciowy firewall w panelu sterowania, niezależny od ufw na serwerze. Reguła, która wygląda poprawnie w sudo ufw status, a mimo to powoduje przekroczenie czasu oczekiwania, jest zazwyczaj blokowana właśnie tam. Reguły ufw faktycznie wymagane przez VPS omawiają konfigurację typu default-deny, którą zakłada ta sekcja.

Terminacja HTTPS na VPS przy użyciu rzeczywistego certyfikatu

Skieruj rekord A dla home.example.com na publiczny adres IP serwera VPS. Nie na adres domowy. Dom nie posiada adresu, na który można wskazać, co stanowi problem, który właśnie rozwiązujesz.

# on the VPS
sudo apt update
sudo apt install -y nginx certbot python3-certbot-nginx

Utwórz /etc/nginx/sites-available/home.example.com, zaczynając od bloku dla portu 80, aby certbot miał odpowiedni server_name do pracy:

server {
    listen 80;
    listen [::]:80;
    server_name home.example.com;
    location / { return 404; }
}
# on the VPS
sudo ln -s /etc/nginx/sites-available/home.example.com /etc/nginx/sites-enabled/
sudo nginx -t
sudo systemctl reload nginx
sudo certbot certonly --nginx -d home.example.com

nginx -t wyświetla nginx: configuration file /etc/nginx/nginx.conf test is successful, jeśli pliki zostały poprawnie przeanalizowane. Uruchamiaj to polecenie przed każdym przeładowaniem. nginx utrzymuje działanie starej konfiguracji w przypadku niepowodzenia przeładowania, więc błędna edycja wygląda jak zmiana, która nie przyniosła żadnego efektu.

Obsługa WebSocket wymaga mapowania na poziomie http. Umieść je w /etc/nginx/conf.d/upgrade.conf:

map $http_upgrade $connection_upgrade {
    default upgrade;
    ''      close;
}

Teraz zastąp plik witryny właściwą konfiguracją:

server {
    listen 80;
    listen [::]:80;
    server_name home.example.com;
    return 301 https://$host$request_uri;
}

server {
    listen 443 ssl;
    listen [::]:443 ssl;
    server_name home.example.com;

    ssl_certificate     /etc/letsencrypt/live/home.example.com/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/home.example.com/privkey.pem;

    client_max_body_size 512m;

    location / {
        proxy_pass http://127.0.0.1:8080;
        proxy_http_version 1.1;
        proxy_set_header Host              $host;
        proxy_set_header X-Real-IP         $remote_addr;
        proxy_set_header X-Forwarded-For   $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
        proxy_set_header Upgrade           $http_upgrade;
        proxy_set_header Connection        $connection_upgrade;
        proxy_read_timeout 3600s;
    }
}

proxy_set_header Host $host; nie jest tutaj opcjonalny. HTTP vhost w frp kieruje ruch na podstawie nagłówka Host, dopasowując go do listy customDomains w konfiguracji klienta. Pominięcie tego nagłówka spowoduje, że nginx wyśle Host: 127.0.0.1, frp nie znajdzie proxy dla tej nazwy, a użytkownik otrzyma błąd 404 z frp zamiast strony z aplikacji. Wyjaśnienie każdej linii bloku reverse proxy w nginx opisuje funkcje pozostałych nagłówków.

# on the VPS
sudo nginx -t && sudo systemctl reload nginx
sudo certbot renew --dry-run

Testowe uruchomienie (dry run) potwierdza, że odnawianie zadziała za dziewięćdziesiąt dni, kiedy nie będziesz już monitorować procesu. Wymaga to dostępności portu 80, dlatego konieczna jest odpowiednia reguła ufw.

Strona domowa: frpc jako usługa bez uprawnień roota

Zainstaluj frpc na domowym serwerze dokładnie w taki sam sposób, jak zainstalowano frps, zachowując tę samą wersję oraz krok weryfikacji sumy kontrolnej. Następnie utwórz użytkownika frp oraz katalog /etc/frp. Utwórz plik /etc/frp/frpc.toml:

serverAddr = "vps.example.com"
serverPort = 7000

auth.method = "token"
auth.token = "PASTE_THE_SAME_TOKEN_HERE"

transport.tls.enable = true
loginFailExit = false

proxies = [
  { name = "home-app", type = "http", localIP = "127.0.0.1", localPort = 3000, customDomains = ["home.example.com"] }
]

Kolejność kluczy w tym pliku ma znaczenie, nie tylko estetyczne. Format TOML przypisuje każdy klucz znajdujący się po nagłówku sekcji do tej sekcji, więc ustawienie globalne, takie jak serverAddr, umieszczone pod nagłówkiem proxy, zostanie potraktowane jako ustawienie proxy i zignorowane przez frp. Zapisanie listy proxy jako tablicy w jednej linii, tak jak pokazano powyżej, pozwala uniknąć tego błędu: każdy klucz najwyższego poziomu pozostaje jednoznacznie przypisany do konfiguracji globalnej.

type = "http" kieruje ten ruch przez vhost listener zamiast zajmować osobny publiczny port TCP, dlatego zapora sieciowa wymagała tylko czterech reguł. customDomains musi zawierać nazwę hosta, którą nginx przekazuje w nagłówku Host, zatem jest to home.example.com, a nigdy adres IP serwera VPS.

loginFailExit = false ma większe znaczenie, niż się wydaje. Wartością domyślną jest true, co powoduje wyjście frpc, jeśli pierwsza próba logowania zakończy się niepowodzeniem. Na domowym serwerze, który kończy proces uruchamiania przed nawiązaniem połączenia z dostawcą internetu, usługa ta pozostanie wyłączona do czasu ręcznej interwencji. Ustawienie wartości na false sprawia, że frpc ponawia próby do momentu, aż VPS odpowie.

Utwórz plik /etc/systemd/system/frpc.service:

[Unit]
Description=frp reverse tunnel client
After=network-online.target
Wants=network-online.target

[Service]
Type=simple
User=frp
Group=frp
ExecStart=/usr/local/bin/frpc -c /etc/frp/frpc.toml
Restart=always
RestartSec=10s
NoNewPrivileges=true
PrivateTmp=true
ProtectSystem=strict
ProtectHome=true

[Install]
WantedBy=multi-user.target
# on the home box
sudo chown root:frp /etc/frp/frpc.toml
sudo chmod 640 /etc/frp/frpc.toml
sudo -u frp frpc verify -c /etc/frp/frpc.toml
sudo systemctl daemon-reload
sudo systemctl enable --now frpc
sudo journalctl -u frpc -n 20 --no-pager

Klient, który nawiązał połączenie, loguje identyfikator uruchomienia:

login to server success, get run id [3a1f9c2b7d4e5f60]

Otwórz https://home.example.com w przeglądarce, aby uzyskać dostęp do aplikacji działającej na 127.0.0.1:3000 w sieci domowej. Użycie Restart=always na kliencie jest celowe: połączenia domowe bywają zrywane, a usługa powinna powrócić do działania automatycznie.

Ograniczenie dostępu do panelu sterowania

Dzięki webServer.addr = "127.0.0.1" panel sterowania odpowiada wyłącznie na poziomie serwera VPS. Dostęp do niego z poziomu laptopa uzyskuje się poprzez lokalne przekierowanie portu, zamiast otwierania portu publicznego:

# on your laptop
ssh -N -L 7500:127.0.0.1:7500 you@vps.example.com

Otwórz http://127.0.0.1:7500 i zaloguj się przy użyciu webServer.user oraz webServer.password z frps.toml. Strona wyświetla listę wszystkich połączonych klientów oraz liczniki ruchu dla każdego proxy, co stanowi najszybszy sposób na sprawdzenie, czy serwer domowy jest aktualnie połączony. Po zamknięciu sesji ssh panel sterowania ponownie staje się niedostępny.

Czego tunel nie robi

Przeczytaj tę część dwukrotnie, ponieważ to tutaj użytkownicy narażają się na ryzyko. Tunel sprawia, że prywatna usługa staje się osiągalna z publicznego internetu. Nie uwierzytelnia on osób, które uzyskują do niej dostęp. Gdy https://home.example.com zostanie rozwiązane, skanery znajdą je w ciągu kilku dni, niezależnie od tego, czy nazwa została komukolwiek udostępniona. Dzienniki przejrzystości certyfikatów (Certificate Transparency logs) publikują każdą nazwę hosta, dla której wydano certyfikat, więc nazwa staje się publiczna w momencie, gdy certbot zakończy działanie sukcesem.

Wszystko, co wystawiasz, musi posiadać własne uwierzytelnianie. Jeśli aplikacja posiada rzeczywisty system logowania z ograniczaniem liczby żądań (rate limiting), to dobrze. Jeśli logowanie opiera się na jednym wspólnym haśle lub jeśli w ogóle go nie ma, umieść przed nią na VPS proxy uwierzytelniające. Umieszczenie oauth2-proxy przed aplikacją jest typowym rozwiązaniem i wpasowuje się ono między nginx a vhost frp bez wprowadzania zmian po obu stronach tunelu.

Token w frps.toml chroni tunel, a nie aplikacje. Powstrzymuje on niepowołane osoby przed zarejestrowaniem własnego proxy na Twoim VPS. Nie robi nic w przypadku żądania, które dociera na port 443 dla nazwy hosta opublikowanej celowo.

Warto zachować dwa nawyki. Zmieniaj token poprzez edycję obu plików i restart obu usług, ponieważ token nie wygasa automatycznie. Utrzymuj również aktualną wersję frp: ten plik binarny jest Twoimi publicznymi drzwiami wejściowymi, a informacje o wydaniu v0.71.0 wymieniają błąd typu server panic wywołany przez nieprawidłową wartość wysłaną z klienta, czyli klasę błędu, którą należy załatać, zamiast analizować.

Tryby awarii i towarzyszące im komunikaty

Klient nie może nawiązać połączenia. journalctl -u frpc powtarza connect to server error:, po czym następuje przekroczenie czasu oczekiwania na połączenie (dial timeout). Ruch nie dociera do portu 7000. Należy sprawdzić ufw na VPS, następnie sieciowy firewall dostawcy w panelu sterowania, a na końcu potwierdzić poprawność rozpoznawania nazwy za pomocą getent hosts vps.example.com.

Token jest nieprawidłowy. Klient informuje o tym wprost przy każdej próbie ponownego połączenia:

connect to server error: token in login doesn't match token from configuration

Należy ponownie skopiować token. Znaki nowej linii na końcu lub $ w niecytowanym ciągu znaków powłoki, który został rozwinięty do wartości pustej, są przyczyną niemal wszystkich takich przypadków. Dlatego dane wyjściowe openssl rand -base64 32 powinny być umieszczone w cudzysłowie w pliku TOML.

Tunel działa, ale przeglądarka zwraca błąd 404. frpc zarejestrował poprawne logowanie, a panel sterowania wyświetla proxy, mimo to strona zwraca błąd 404 bez stylów aplikacji. Jest to domyślna strona błędu frp. frp wyświetla ją, gdy żaden proxy nie pasuje do nagłówka Host, a także gdy nie może przekazać żądania do aplikacji w sieci lokalnej. Należy przetestować vhost bezpośrednio na VPS, z pominięciem nginx i TLS:

# on the VPS
curl -s -o /dev/null -w '%{http_code}\n' -H 'Host: home.example.com' http://127.0.0.1:8080/

Błąd 404 z tego polecenia nie jest ostatecznym dowodem, ponieważ aplikacja może zwracać własne błędy 404. Należy uruchomić polecenie ponownie bez -o /dev/null i odczytać treść odpowiedzi. Jeśli zawiera ona The page you requested was not found., oznacza to błąd frp: albo customDomains nie pasuje do home.example.com, albo frp nie może połączyć się z aplikacją. W takim przypadku należy uruchomić curl -I http://127.0.0.1:3000/ na komputerze lokalnym. Jeśli odpowiedź pochodzi bezpośrednio z aplikacji, vhost jest poprawny, a żądanie nie otrzymało właściwego nagłówka Host od nginx.

Błąd 502 z nginx. Zazwyczaj oznacza to, że nginx odpowiada, a frp nie. HTTP vhost w frp zgłasza własne błędy jako 404 lub 504, a nie 502. Jednak nginx przekazuje błąd 502 bez zmian, jeśli aplikacja lokalna go wyśle, dlatego przed restartem czegokolwiek należy sprawdzić źródło błędu. sudo ss -lntp | grep 8080 na VPS powinno wykazać, że frps nasłuchuje na 127.0.0.1:8080. Puste wyjście oznacza, że frps jest zatrzymany lub vhostHTTPPort nie jest ustawione w frps.toml.

Aplikacja rozpoznaje każdego użytkownika jako lokalnego. Aplikacja rejestruje 127.0.0.1 dla każdego żądania. nginx ustawia X-Forwarded-For, a frp dopisuje do niego dane, więc rzeczywisty adres klienta znajduje się w tym nagłówku. Należy skonfigurować aplikację tak, aby go honorowała. Nie należy pomijać tego kroku, jeśli aplikacja stosuje limity (rate limiting) na podstawie adresu IP, ponieważ w przeciwnym razie wszyscy użytkownicy z Internetu będą traktowani jako jeden podmiot.

Długie żądania są przerywane po 60 sekundach. Przesyłanie plików lub strumieniowanie odpowiedzi zostaje przerwane w trakcie. Jest to domyślny limit proxy_read_timeout w nginx, a nie w tunelu. Blok konfiguracyjny powyżej zwiększa go do 3600s. client_max_body_size to odpowiadający mu limit rozmiaru przesyłanych danych; domyślna wartość 1 MB powoduje odrzucenie większych żądań z błędem 413.

Wszystko działa, ale przestaje po restarcie routera. Restart=always w jednostce frpc wraz z loginFailExit = false rozwiązuje ten problem. Należy potwierdzić to za pomocą sudo systemctl is-enabled frpc, które musi zwrócić enabled.

FAQ

Skąd mam wiedzieć, czy jestem za CGNAT?

Porównaj adres WAN na stronie administracyjnej routera z tym, co zgłasza curl -4 -s https://ifconfig.me z wnętrza tej samej sieci. Jeśli się różnią, a adres WAN routera znajduje się wewnątrz 100.64.0.0/10, Twój dostawca internetu stosuje carrier-grade NAT. Ten zakres to współdzielona przestrzeń adresowa RFC 6598, która istnieje właśnie w tym celu. Niektórzy dostawcy używają zamiast tego 10.0.0.0/8 po stronie WAN, co oznacza to samo. Jeśli oba adresy są zgodne, posiadasz publiczny adres IP: przekieruj port i gotowe.

Czy potrzebuję nazwy domeny dla tunelu zwrotnego?

Dla opisanej tutaj konfiguracji HTTPS, tak. Certyfikat jest wydawany dla nazwy hosta, a vhost HTTP w frp kieruje żądania na podstawie nagłówka Host, więc obie strony muszą uzgodnić nazwę. Surowe proxy TCP na numerowanym porcie działa z samym adresem IP VPS bez żadnej domeny, ale wtedy nie masz certyfikatu ani routingu po nazwie hosta, więc jeden publiczny port obsługuje dokładnie jedną usługę.

Czy bezpiecznie jest uruchamiać frp na publicznym VPS?

Jest to bezpieczne, gdy port sterujący jest jedynym wystawionym punktem nasłuchu frp i jest uwierzytelniony. Ustaw auth.token na losową wartość po obu stronach oraz transport.tls.force = true na serwerze. Następnie ustaw proxyBindAddr = "127.0.0.1", aby nic, co frp otwiera dla proxy, nie było wystawione na internet, a panel sterowania (dashboard) pozostaw na webServer.addr = "127.0.0.1", dostępny przez lokalne przekierowanie SSH. Aktualizuj plik binarny, gdy pojawiają się nowe wersje, ponieważ jest to proces nasłuchujący na Twoim publicznym adresie.

Dlaczego nikt nie może połączyć się z moim przekierowanym portem ssh -R?

sshd jest dostarczany z GatewayPorts no, więc przekierowanie zdalne wiąże się tylko z interfejsem loopback VPS. curl uruchomione na samym VPS działa, a curl z dowolnego innego miejsca kończy się przekroczeniem czasu oczekiwania. Poprawnym rozwiązaniem jest pozostawienie przekierowania na loopback i umieszczenie nginx na porcie 443 przed nim. Ustawienie GatewayPorts yes publikuje surowy port bez certyfikatu i bez TLS, co jest gorsze niż problem, który rozwiązuje.

Czy powinienem użyć frp czy sieci VPN typu mesh, takiej jak Tailscale lub WireGuard?

Użyj sieci VPN typu mesh, gdy dostęp potrzebny jest tylko Twoim własnym urządzeniom, ponieważ wtedy nic nie jest publikowane i nie ma publicznej nazwy hosta, którą ktokolwiek mógłby skanować. Użyj frp, gdy potrzebujesz publicznego adresu HTTPS, który może załadować dowolna przeglądarka, na przykład odbiornik webhook lub strona udostępniana osobom, które nie zainstalują klienta VPN. Oba rozwiązania współistnieją bez problemu na jednym VPS, na różnych portach, wykonując różne zadania.

Czy ten artykuł był przydatny?