CGNAT umgehen: Reverse-Tunnel mit VPS und frp
CGNAT verhindert Portweiterleitung ohne öffentliche IPv4-Adresse. Mit frp auf einem VPS bauen Sie den Tunnel nach Hause auf und beenden HTTPS mit echtem Zertifikat.
Warum Portweiterleitung hinter CGNAT nichts bewirkt
Hinter CGNAT (Carrier-Grade Network Address Translation) wird die WAN-Adresse Ihres Routers mit anderen Teilnehmern geteilt. Ihnen ist daher keine öffentliche IPv4-Adresse zugewiesen, und es gibt keinen Port, den Sie weiterleiten können. Ein Reverse Tunnel löst dieses Problem: Ein günstiger VPS stellt die öffentliche IP-Adresse bereit. Ihr Rechner zu Hause baut eine ausgehende Verbindung zum VPS auf. Eingehende Anfragen werden über diese bereits geöffnete Verbindung zurück zum Rechner zu Hause geleitet. Ihre vorhandene Hardware bleibt erhalten. Sie mieten nur das, was Ihr ISP Ihnen nicht bereitstellt: eine routbare Adresse.
Jeder folgende Befehl ist mit dem Rechner gekennzeichnet, auf dem er ausgeführt wird. Sie benötigen zwei Rechner: den VPS mit öffentlicher IP-Adresse und den Rechner zu Hause, auf dem der Dienst läuft, den Sie erreichen möchten.
So erkennen Sie, ob Sie tatsächlich hinter CGNAT stehen
Öffnen Sie die Administrationsoberfläche Ihres Routers und lesen Sie die dort angezeigte WAN-Adresse ab. Ermitteln Sie anschließend, welche Adresse das Internet von außen sieht.
# on the home box
curl -4 -s https://ifconfig.me; echoWenn beide Adressen übereinstimmen, haben Sie eine öffentliche IP-Adresse und benötigen nichts davon. Richten Sie die Portweiterleitung ein und lesen Sie nicht weiter. Liegt die WAN-Adresse des Routers innerhalb von 100.64.0.0/10, stehen Sie hinter CGNAT. Dieser Bereich ist der gemeinsam genutzte Adressraum nach RFC 6598 und genau für diesen Zweck reserviert. Einige ISPs verwenden auf der WAN-Seite stattdessen 10.0.0.0/8. Das ist dieselbe Situation unter einer anderen Bezeichnung.
Prüfen Sie dies, bevor Sie etwas mieten. Viele ISPs mit CGNAT stellen ein echtes IPv6-Präfix bereit. Wenn Ihr Gerät zu Hause eine globale IPv6-Adresse hat, können Sie die Firewall für diese Adresse öffnen und vollständig auf den Tunnel verzichten. Das funktioniert nicht mehr, sobald ein Besucher ein reines IPv4-Netzwerk verwendet. Deshalb landen die meisten Nutzer letztlich trotzdem hier.
Funktionsweise eines VPS-Reverse-Tunnels, aufgebaut von innen nach außen
CGNAT und herkömmliche Heim-Router blockieren eingehende Verbindungsanfragen von außen. Unternehmens-Firewalls tun dies ebenfalls. Keine dieser Lösungen blockiert jedoch ausgehende Verbindungen, da ausgehender Datenverkehr das Standardverhalten jedes Browsers und jedes Update-Clients ist. Ein NAT-Gerät, das eine ausgehende TCP-Verbindung registriert, erstellt eine entsprechende Zuordnung und erlaubt daraufhin den Rückverkehr über diese Verbindung. Nichts von außerhalb kann eine Verbindung zu Ihrem Heim-Rechner initiieren. Daher baut der Heim-Rechner die Verbindung auf, und der Tunnel leitet den Datenverkehr über dieselbe Verbindung in die Gegenrichtung.
Das ist der gesamte Mechanismus. Der Heim-Rechner verbindet sich mit einem Port des VPS und hält diese Verbindung offen. Der VPS nimmt öffentliche Anfragen entgegen und leitet sie über die bestehende Verbindung weiter. Niemand versucht, Ihre Heim-IP-Adresse zu erreichen. Das ist daher auch nicht erforderlich.
Daraus ergeben sich zwei nützliche Konsequenzen. Ihr DNS-Eintrag verweist auf den VPS, niemals auf Ihren Anschluss zu Hause. Zudem ist Ihre öffentliche Adresse nun die des VPS; ein Beobachter, der eine IP-Abfrage durchführt, erhält Informationen über einen gemieteten Server anstelle Ihres privaten Internetanschlusses.
Drei Möglichkeiten zum Aufbau
ssh -R: Bereits auf beiden Seiten installiert und geeignet für einen einzelnen Dienst oder eine vorübergehende Demo. Es gibt kein Dashboard und keine nennenswerte Logik für die Wiederherstellung von Verbindungen.- frp: Ein kleiner Go-Server (
frps) und ein passender Client (frpc). Geeignet für einen dauerhaften Aufbau mit mehreren Diensten hinter einem Hostnamen. Der Hauptteil dieser Anleitung behandelt diese Variante. - Ein Mesh-VPN: Tailscale oder ein WireGuard-Server, den Sie selbst betreiben. Geeignet, wenn Ihre eigenen Geräte einander privat erreichen sollen, statt etwas im öffentlichen Internet zu veröffentlichen.
Wählen Sie das Mesh, wenn Sie privaten Zugriff von Geräten wünschen, die Sie kontrollieren. Tailscale Serve und Funnel behandelt die Veröffentlichung aus einem Tailnet heraus. Ein selbst gehostetes WireGuard-VPN auf demselben VPS bietet Ihnen denselben Aufbau, ohne dass ein Koordinierungsserver eines Drittanbieters im Datenpfad liegt. Lesen Sie einen dieser Abschnitte und überspringen Sie den Rest dieser Seite. Alle folgenden Abschnitte setzen voraus, dass Sie einen öffentlichen HTTPS-Hostnamen wünschen, den jeder aufrufen kann.
Die Kurzfassung: ssh -R für einen Dienst
Angenommen, auf dem Heimserver läuft eine Anwendung auf 127.0.0.1:3000 und Sie haben bereits SSH-Zugriff auf den 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 weist den sshd des VPS an, auf dem VPS einen eigenen 127.0.0.1:8080 zu öffnen und alle dort eingehenden Verbindungen an 127.0.0.1:3000 auf dem Heimserver weiterzuleiten. -N bedeutet, dass keine Shell gestartet wird. Die beiden Optionen ServerAlive sorgen dafür, dass SSH eine unterbrochene Verbindung nach etwa 90 Sekunden erkennt, statt an einer nicht mehr bestehenden Verbindung hängen zu bleiben.
Jetzt kommt der Teil, der häufig für Verwirrung sorgt. Der Listener ist an das Loopback-Interface gebunden. Deshalb schlägt curl http://vps.example.com:8080 von jedem anderen System aus fehl. sshd verwendet standardmäßig GatewayPorts no. Das bedeutet, dass ein Remote-Forward nur an das Loopback-Interface gebunden wird. Ändern Sie das nicht durch GatewayPorts yes. Lassen Sie den Forward am Loopback-Interface und setzen Sie nginx davor, wie beim weiter unten beschriebenen frp-Setup. Dann ist der öffentliche Port 443 mit einem Zertifikat erreichbar, während der Tunnel-Port nicht aus dem Internet erreichbar ist. Wenn Sie nicht sicher sind, welcher Prozess aktuell an welchem Interface lauscht, lohnt sich ein kurzer Überblick über Ports und Listener unter Linux.
Wenn der Port auf dem VPS bereits belegt ist, gibt SSH diese Meldung aus. ExitOnForwardFailure=yes sorgt dafür, dass SSH den Verbindungsversuch abbricht, statt eine Verbindung ohne funktionierenden Tunnel aufzubauen:
Warning: remote port forwarding failed for listen port 8080Die häufigste Ursache ist eine vorherige Sitzung, die beendet wurde, ohne dass sshd dies erkannt hat. Setzen Sie ClientAliveInterval 30 und ClientAliveCountMax 3 in der /etc/ssh/sshd_config des VPS. Dadurch werden verwaiste Sitzungen bereinigt und die Ports freigegeben. Fassen Sie den gesamten Befehl mit Restart=always in einer systemd-Unit zusammen und verwenden Sie einen dedizierten Schlüssel. Alternativ können Sie autossh verwenden. Für mehr als einen Dienst sollten Sie an dieser Stelle aufhören und frp verwenden.
frp auf dem VPS installieren und an einen Tag binden
frp wird als statische Go-Binärdatei veröffentlicht und ist nicht in den Ubuntu- oder Debian-Archiven enthalten. Sie laden daher ein Release herunter und überprüfen es selbst. Legen Sie die Version fest. Das Konfigurationsformat wurde mit v0.52.0 geändert. Seitdem wurden außerdem Optionsnamen verschoben. Ein veraltetes Tutorial nennt daher Schlüssel, die Ihre Binärdatei nicht erkennt. Diese Anleitung verwendet v0.71.0, veröffentlicht am 14. August 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.txtsha256sum sollte genau eine Zeile ausgeben:
frp_0.71.0_linux_amd64.tar.gz: OK--ignore-missing ist erforderlich, weil die Prüfsummendatei alle siebzehn Release-Archive umfasst und Sie eines davon heruntergeladen haben. Ohne dieses Flag meldet sha256sum die übrigen sechzehn als fehlend und beendet sich mit einem Status ungleich null. Das sieht wie eine fehlgeschlagene Überprüfung aus, obwohl kein Fehler vorliegt.
# 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 --versionfrps --version gibt 0.71.0 aus. Nur frps wird auf dem VPS installiert. frpc wird auf dem Heimrechner installiert. Wenn beide Binärdateien überall installiert werden, kann versehentlich ein Tunnelserver zu Hause ausgeführt werden.
Die VPS-Konfiguration: Token, erzwungenes TLS, Loopback-Listener
Generieren Sie zuerst ein Token. Es ist das Einzige, was Ihren Tunnel von jedem schützt, der einen Portscan auf dem VPS ausführt.
# on the VPS
openssl rand -base64 32Schreiben Sie diesen Wert in /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"Vier dieser Zeilen übernehmen die Sicherheitsfunktionen. Sehen Sie sie daher einzeln an.
auth.token muss auf dem Client mit auth.token übereinstimmen. Ohne diese Einstellung akzeptiert frps jeden Client, der Port 7000 findet. Dieser Client kann anschließend beliebige Dienste über Ihren VPS und Ihr Zertifikat veröffentlichen.
transport.tls.force = true weist jede Steuerverbindung zurück, die nicht TLS (Transport Layer Security) verwendet. Clients aktivieren TLS seit v0.50.0 standardmäßig. In der Praxis entstehen Ihnen dadurch keine Nachteile. Außerdem wird verhindert, dass sich ein alter oder selbst erstellter Client unverschlüsselt verbindet, ohne dass Sie dies bemerken.
proxyBindAddr = "127.0.0.1" ist die Zeile, die in den meisten Anleitungen fehlt. Sie sorgt dafür, dass diese Konfiguration dauerhaft sicher betrieben werden kann. Die Einstellung verschiebt jeden Listener, den frp im Auftrag eines Proxys öffnet, auf die Loopback-Schnittstelle. Das gilt sowohl für den HTTP-Vhost als auch für jeden remotePort, den ein Client anfordert. Aus dem Internet sind diese Listener überhaupt nicht erreichbar. Zwei Zugänge bleiben öffentlich: nginx auf Port 443, den Sie konfigurieren und kontrollieren, sowie der frp-Steuerport auf Port 7000. proxyBindAddr ändert den Steuerport nicht. Er wird durch das Token und TLS geschützt.
webServer.addr = "127.0.0.1" hält das Dashboard von der öffentlichen Schnittstelle fern. Das Dashboard enthält eine vollständige Übersicht über Ihre privaten Dienste und deren Datenverkehr. Es ist nur durch ein HTTP-Basic-Auth-Passwort geschützt und gehört daher nicht auf 0.0.0.0.
Setzen Sie den Besitzer so, dass das Token nicht für alle Benutzer lesbar ist. Prüfen Sie anschließend die Syntax, bevor Sie etwas starten:
# 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.tomlEine gültige Datei gibt Folgendes aus:
frps: the configuration file /etc/frp/frps.toml syntax is okEin Hinweis zum Format erspart Ihnen eine Stunde Fehlersuche. frp liest Dateien im Format .toml, .yaml, .yml und .json. Eine alte INI-Datei erkennt frp an ihrem Abschnitt [common] und nicht an der Dateierweiterung. Diese INI-Dateien werden weiterhin über einen Legacy-Konvertierungspfad geladen. INI ist jedoch veraltet und wird in einer künftigen Version entfernt. Neue Funktionen sind nur in TOML, YAML oder JSON verfügbar. Wenn eine Anleitung einen Abschnitt [common] und server_addr = x.x.x.x zeigt, stammt sie aus der Zeit vor v0.52.0. Die darin verwendeten Schlüsselbezeichnungen in snake_case gehören zum Legacy-Format. Wenn Sie sie in frps.toml oben einfügen, schlägt die standardmäßig ausgeführte strikte Prüfung frps verify fehl.
frps als Dienst ohne Root-Rechte ausführen
bindPort ist 7000 und vhostHTTPPort ist 8080. Beide Ports liegen über 1024. frps benötigt daher weder root noch CAP_NET_BIND_SERVICE. Deshalb sollte der virtuelle Host nicht auf Port 80 gelegt werden. Nginx übernimmt stattdessen Port 80.
Erstellen Sie /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-pagerDas Log sollte beide Listener anzeigen. Die Adressen sind dabei wichtiger als die Ports:
frps tcp listen on 0.0.0.0:7000
http service listen on 127.0.0.1:8080ProtectSystem=strict stellt das gesamte Dateisystem für diesen Dienst auf schreibgeschützt. frps funktioniert damit, weil das Log standardmäßig in die Standardausgabe geschrieben wird und journald es erfasst. Wenn Sie log.to auf einen Dateipfad setzen, kann der Dienst zunächst nicht in diese Datei schreiben. Erst eine passende Zeile mit ReadWritePaths= ermöglicht das. Belassen Sie daher den Standardwert.
Firewall: einen Port öffnen, nicht einen Bereich
# 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 numberedVier Regeln, von denen eine nur für die Zertifikatserneuerung benötigt wird. 22 ist SSH. 80 leitet auf 443 um und beantwortet die ACME-Challenge (Automatic Certificate Management Environment). 443 stellt alle getunnelten Anwendungen bereit. 7000 ist der frp-Steuerungsport. Er ist der einzige Port, den ein Client erreichen können muss.
Anleitungen, die zum Öffnen eines Bereichs wie sudo ufw allow 20000:30000/tcp auffordern, beschreiben das andere Design. Dabei verwendet jeder Dienst seinen eigenen öffentlichen TCP-Port. Das ist hier nicht erforderlich, weil alle Verbindungen über 443 eingehen und frp sie anhand des Hostnamens weiterleitet. Wenn Sie später einen tatsächlich öffentlichen TCP-Port benötigen, setzen Sie proxyBindAddr wieder auf 0.0.0.0 und fügen Sie Einschränkungen hinzu, damit ein Client nur die von Ihnen angegebenen Ports verwenden kann:
allowPorts = [
{ start = 20000, end = 20010 }
]
maxPortsPerClient = 5Die meisten Provider betreiben zusätzlich eine Netzwerk-Firewall im Control Panel, die von ufw auf dem Server getrennt ist. Eine Regel, die in sudo ufw status korrekt aussieht und bei der dennoch ein Timeout auftritt, wird dort normalerweise blockiert. Die ufw-Regeln, die ein VPS tatsächlich benötigt führt durch die Default-Deny-Konfiguration, von der dieser Abschnitt ausgeht.
HTTPS auf dem VPS mit einem echten Zertifikat terminieren
Legen Sie für home.example.com einen A-Record fest, der auf die öffentliche IP-Adresse des VPS zeigt. Nicht auf Ihr Haus. Ihr Haus hat keine Adresse, auf die Sie zeigen können. Genau das ist das Problem, das Sie lösen.
# on the VPS
sudo apt update
sudo apt install -y nginx certbot python3-certbot-nginxErstellen Sie /etc/nginx/sites-available/home.example.com zunächst mit einem einfachen Block für Port 80. Dadurch hat certbot ein passendes server_name, mit dem es arbeiten kann:
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.comnginx -t gibt nginx: configuration file /etc/nginx/nginx.conf test is successful aus, wenn die Dateien syntaktisch korrekt sind. Führen Sie den Befehl vor jedem Reload aus. Wenn ein Reload fehlschlägt, lässt nginx die alte Konfiguration weiterlaufen. Eine fehlerhafte Änderung sieht dadurch wie eine Änderung aus, die keine Wirkung hatte.
WebSocket-Upgrades benötigen auf der http-Ebene eine Map. Fügen Sie sie in /etc/nginx/conf.d/upgrade.conf ein:
map $http_upgrade $connection_upgrade {
default upgrade;
'' close;
}Ersetzen Sie die Site-Datei nun durch die endgültige Version:
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; ist hier zwingend erforderlich. Der HTTP-vhost von frp routet anhand des Headers Host und gleicht ihn mit der Liste customDomains in der Client-Konfiguration ab. Fehlt dieser Header, sendet nginx Host: 127.0.0.1. frp findet keinen Proxy für diesen Namen, und Ihr Besucher erhält von frp einen einfachen 404-Fehler statt einer Seite der Anwendung. Jede Zeile eines nginx-Reverse-Proxy-Blocks erklärt beschreibt, welche Funktion die anderen Header haben.
# on the VPS
sudo nginx -t && sudo systemctl reload nginx
sudo certbot renew --dry-runDer Testlauf bestätigt, dass die Erneuerung in neunzig Tagen funktionieren wird, wenn Sie sie nicht überwachen. Dafür muss Port 80 erreichbar sein. Deshalb ist diese ufw-Regel erforderlich.
Die Seite im Heimnetz: frpc als unprivilegierter Dienst
Installieren Sie frpc auf dem Rechner im Heimnetz genau wie zuvor frps: mit derselben Version und demselben Prüfsummenschritt. Legen Sie anschließend denselben Benutzer frp und dasselbe Verzeichnis /etc/frp an. Schreiben Sie /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"] }
]Die Reihenfolge der Schlüssel ist in dieser Datei wichtig, und zwar nicht aus Gründen der Formatierung. TOML ordnet jeden Schlüssel nach einer Tabellenüberschrift dieser Tabelle zu. Eine globale Einstellung wie serverAddr, die unterhalb einer Proxy-Tabellenüberschrift steht, wird dadurch unbemerkt zu einer Proxy-Einstellung, die frp ignoriert. Wenn Sie die Proxy-Liste wie oben als Inline-Array schreiben, vermeiden Sie dieses Problem. Jeder globale Schlüssel bleibt dadurch eindeutig auf der obersten Ebene.
type = "http" leitet diesen Proxy über den Vhost-Listener weiter, anstatt einen eigenen öffentlichen TCP-Port zu beanspruchen. Deshalb blieb die Firewall bei vier Regeln. customDomains muss den Hostnamen enthalten, den nginx im Header Host weiterleitet. Daher ist der Wert home.example.com und niemals die IP-Adresse des VPS.
loginFailExit = false ist wichtiger, als es zunächst scheint. Der Standardwert ist true. Dadurch beendet sich frpc, wenn der erste Anmeldeversuch fehlschlägt. Auf einem Rechner im Heimnetz, der den Bootvorgang beendet, bevor die Verbindung zum ISP verfügbar ist, bleibt der Dienst dann beendet, bis Sie das Problem bemerken. Setzen Sie den Wert auf false. Dann versucht frpc die Verbindung weiter, bis der VPS antwortet.
Schreiben Sie /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-pagerEin Client, der eine Verbindung hergestellt hat, protokolliert eine Lauf-ID:
login to server success, get run id [3a1f9c2b7d4e5f60]Öffnen Sie https://home.example.com in einem Browser. Sie sollten die Anwendung erreichen, die zu Hause unter 127.0.0.1:3000 läuft. Restart=always auf dem Client ist beabsichtigt: Verbindungen im Heimnetz können abbrechen, und der Dienst soll ohne Ihr Eingreifen wieder verfügbar werden.
Dashboard nicht an der öffentlichen Schnittstelle bereitstellen
Mit webServer.addr = "127.0.0.1" antwortet das Dashboard nur auf dem VPS selbst. Greifen Sie von Ihrem Laptop über eine lokale Weiterleitung darauf zu, statt einen Port zu öffnen:
# on your laptop
ssh -N -L 7500:127.0.0.1:7500 you@vps.example.comÖffnen Sie http://127.0.0.1:7500 und melden Sie sich mit webServer.user und webServer.password aus frps.toml an. Die Seite listet jeden verbundenen Client und die Traffic-Zähler für jeden Proxy auf. Damit lässt sich am schnellsten feststellen, ob die Systeme zu Hause gerade verbunden sind. Wenn Sie die SSH-Sitzung schließen, ist das Dashboard wieder nicht erreichbar.
Was der Tunnel nicht leistet
Lesen Sie diesen Abschnitt zweimal, denn hier entstehen die größten Risiken. Der Tunnel macht einen privaten Dienst aus dem öffentlichen Internet erreichbar. Er authentifiziert nicht die Personen, die darauf zugreifen. Sobald https://home.example.com aufgelöst wird, finden Scanner den Dienst innerhalb weniger Tage. Das gilt unabhängig davon, ob Sie den Namen jemandem mitgeteilt haben. Certificate-Transparency-Logs veröffentlichen jeden Hostnamen, für den Sie ein Zertifikat ausstellen. Der Name ist daher öffentlich, sobald certbot erfolgreich ausgeführt wurde.
Alles, was Sie veröffentlichen, muss eine eigene Authentifizierung bereitstellen. Verfügt die Anwendung über einen echten Login mit Rate-Limiting, ist das ausreichend. Verwendet der Login dagegen nur ein gemeinsames Passwort oder gibt es überhaupt keinen Login, schalten Sie auf dem VPS einen authentifizierenden Proxy davor. Ein oauth2-proxy vor der Anwendung ist dafür die übliche Lösung. Er wird zwischen nginx und den frp-vhost geschaltet, ohne dass Sie die beiden Tunnelenden ändern müssen.
Das Token in frps.toml schützt den Tunnel, nicht die Anwendungen. Es verhindert, dass ein Fremder einen eigenen Proxy auf Ihrem VPS registriert. Es schützt nicht vor einer Anfrage, die auf Port 443 für einen Hostnamen eintrifft, den Sie absichtlich veröffentlicht haben.
Zwei Gewohnheiten sind sinnvoll. Ändern Sie das Token, indem Sie beide Dateien bearbeiten und beide Dienste neu starten, denn es läuft nicht automatisch ab. Halten Sie außerdem frp aktuell. Dieses Binary ist Ihr öffentlich erreichbarer Zugangspunkt. Die Hinweise zu v0.71.0 nennen einen Server-Panic, die durch einen fehlerhaften Wert ausgelöst wird, den ein Client sendet. Diese Fehlerklasse sollte durch ein Update behoben werden, statt sie im laufenden Betrieb zu analysieren.
Fehlerbilder und die dabei angezeigten Meldungen
Der Client stellt nie eine Verbindung her. journalctl -u frpc wiederholt connect to server error:, danach tritt ein Verbindungs-Timeout auf. Port 7000 erreicht kein Datenverkehr. Prüfen Sie ufw auf dem VPS und anschließend die Netzwerk-Firewall des Providers im Control Panel. Prüfen Sie danach mit getent hosts vps.example.com, ob der Name korrekt aufgelöst wird.
Das Token ist falsch. Der Client meldet dies bei jedem Versuch ausdrücklich:
connect to server error: token in login doesn't match token from configurationKopieren Sie das Token erneut. Ein abschließender Zeilenumbruch oder ein $ in einer nicht quotierten Shell-Zeichenkette, das zu einer leeren Zeichenkette expandiert wurde, verursacht fast alle dieser Fehler. Deshalb muss die Ausgabe von openssl rand -base64 32 in der TOML-Datei in Anführungszeichen stehen.
Der Tunnel ist aktiv, aber der Browser erhält einen leeren 404-Fehler. frpc hat eine erfolgreiche Anmeldung protokolliert und das Dashboard zeigt den Proxy an. Die Seite liefert jedoch 404 ohne das Styling der Anwendung. Das ist die eigene Not-found-Seite von frp. frp liefert sie aus, wenn kein Proxy zum Host-Header passt oder wenn frp die Anfrage nicht an die Anwendung auf dem Heimserver weiterleiten kann. Testen Sie den virtuellen Host direkt auf dem VPS und umgehen Sie dabei sowohl nginx als auch TLS:
# on the VPS
curl -s -o /dev/null -w '%{http_code}\n' -H 'Host: home.example.com' http://127.0.0.1:8080/Ein 404 aus diesem Befehl ist allein kein Beweis, weil die Anwendung selbst einen 404-Fehler zurückgeben kann. Führen Sie den Befehl ohne -o /dev/null erneut aus und lesen Sie den Antworttext. Wenn dort The page you requested was not found. steht, stammt die Antwort von frp: Entweder passt customDomains nicht zu home.example.com, oder frp konnte die Anwendung nicht erreichen. Führen Sie daher curl -I http://127.0.0.1:3000/ auf dem Heimserver aus. Kommt die Antwort direkt von der Anwendung, ist der virtuelle Host korrekt konfiguriert. Die Anfrage hat dann von nginx nicht den richtigen Host erhalten.
502 von nginx. In der Regel antwortet nginx, frp jedoch nicht. Der HTTP-virtuelle Host von frp meldet eigene Fehler als 404 oder 504, nicht als 502. nginx leitet einen 502-Fehler jedoch unverändert weiter, wenn die Anwendung auf dem Heimserver einen solchen Fehler sendet. Ermitteln Sie daher zuerst die Ursache, bevor Sie etwas neu starten. sudo ss -lntp | grep 8080 auf dem VPS sollte zeigen, dass frps auf 127.0.0.1:8080 lauscht. Eine leere Ausgabe bedeutet, dass frps gestoppt ist oder vhostHTTPPort in frps.toml nicht gesetzt ist.
Die Anwendung behandelt jeden Besucher als lokal. In den Anwendungs-Logs erscheint bei jeder Anfrage 127.0.0.1. nginx setzt X-Forwarded-For, und frp ergänzt diesen Header. Die tatsächliche Client-Adresse steht daher in diesem Header. Konfigurieren Sie die Anwendung so, dass sie diesem Header vertraut. Überspringen Sie diesen Schritt nicht, wenn die Anwendung die Rate anhand der IP-Adresse begrenzt. Andernfalls verwenden derzeit alle Besucher aus dem Internet denselben Zähler.
Lange Anfragen werden nach 60 Sekunden beendet. Uploads oder Streaming-Antworten brechen vorzeitig ab. Ursache ist der nginx-Standardwert proxy_read_timeout, nicht der Tunnel. Der oben gezeigte Block erhöht ihn auf 3600s. client_max_body_size ist die entsprechende Begrenzung für die Upload-Größe. Der Standardwert von 1 MB weist größere Request-Bodies mit 413 zurück.
Alles funktioniert, fällt aber nach einem Neustart des Routers aus. Restart=always in der frpc-Unit zusammen mit loginFailExit = false deckt diesen Fall ab. Prüfen Sie dies mit sudo systemctl is-enabled frpc. Der Befehl muss enabled ausgeben.
FAQ
Wie erkenne ich, ob ich hinter CGNAT liege?
Vergleichen Sie die WAN-Adresse auf der Administrationsseite Ihres Routers mit der Adresse, die curl -4 -s https://ifconfig.me aus demselben Netzwerk meldet. Unterscheiden sie sich und liegt die WAN-Adresse des Routers innerhalb von 100.64.0.0/10, verwendet Ihr ISP Carrier-Grade NAT. Dieser Bereich ist ein gemeinsam genutzter Adressbereich nach RFC 6598 und dafür vorgesehen. Einige ISPs verwenden stattdessen 10.0.0.0/8 auf der WAN-Seite. Das bedeutet dasselbe. Stimmen die beiden Adressen überein, haben Sie eine öffentliche IP-Adresse: Leiten Sie den Port weiter, dann sind Sie fertig.
Benötige ich einen Domainnamen für einen Reverse Tunnel?
Für die hier beschriebene HTTPS-Konfiguration: ja. Ein Zertifikat wird für einen Hostnamen ausgestellt. Der HTTP-Vhost von frp leitet Anfragen anhand des Headers Host weiter. Daher benötigen beide Seiten einen gemeinsamen Namen. Ein reiner TCP-Proxy auf einem nummerierten Port funktioniert auch mit der unveränderten IP-Adresse des VPS und ohne Domain. Dann haben Sie jedoch weder ein Zertifikat noch ein hostname-basiertes Routing. Ein öffentlicher Port kann dann genau einen Dienst bedienen.
Ist es sicher, frp auf einem öffentlichen VPS zu betreiben?
Das ist sicher, wenn nur der Control-Port von frp erreichbar und dieser authentifiziert ist. Setzen Sie auth.token auf beiden Seiten auf einen zufälligen Wert und konfigurieren Sie transport.tls.force = true auf dem Server. Setzen Sie anschließend proxyBindAddr = "127.0.0.1" so, dass kein von frp für einen Proxy geöffneter Port aus dem Internet erreichbar ist. Lassen Sie das Dashboard auf webServer.addr = "127.0.0.1" und greifen Sie über einen lokalen SSH-Forward darauf zu. Aktualisieren Sie die Binärdatei, sobald neue Releases verfügbar sind, da dieser Prozess auf Ihrer öffentlichen Adresse lauscht.
Warum kann niemand meinen weitergeleiteten ssh -R-Port erreichen?
sshd wird standardmäßig mit GatewayPorts no ausgeliefert. Daher bindet ein Remote-Forward nur an die Loopback-Schnittstelle des VPS. curl, das direkt auf dem VPS ausgeführt wird, funktioniert. curl von einem anderen Ort läuft dagegen in einen Timeout. Lassen Sie den Forward korrekt auf Loopback gebunden und setzen Sie nginx davor auf Port 443. Mit GatewayPorts yes veröffentlichen Sie einen reinen Port ohne Zertifikat und ohne TLS. Das ist problematischer als die ursprüngliche Einschränkung.
Sollte ich frp oder ein Mesh-VPN wie Tailscale oder WireGuard verwenden?
Verwenden Sie ein Mesh-VPN, wenn nur Ihre eigenen Geräte Zugriff benötigen. Dann wird nichts veröffentlicht und es gibt keinen öffentlichen Hostnamen, den andere scannen können. Verwenden Sie frp, wenn Sie eine öffentliche HTTPS-Adresse benötigen, die jeder Browser aufrufen kann, beispielsweise für einen Webhook-Empfänger oder eine Seite, die Sie mit Personen teilen, die keinen VPN-Client installieren werden. Beide Lösungen können problemlos auf einem VPS zusammen betrieben werden, auf unterschiedlichen Ports und mit unterschiedlichen Aufgaben.