Einen Tunnel über ein bestimmtes Netzwerk leiten
Auf dieser Seite 10 Abschnitte
- Bevor Sie beginnen
- Schritte
- Die Netzwerke des Geräts auflisten
- Die Einstellung „Argumente“ des Tunnels öffnen
- Das Netzwerk eintragen
- Speichern
- Die Argumente in Textform
- Wofür das gewählte Netzwerk verwendet wird
- Wenn das Netzwerk nicht verfügbar ist
- Ein Netzwerk für den gesamten Client wählen
- Beispiel: zwei Proxys an zwei Modems
- Dieselbe Einstellung über die API
- Fehlerbehebung
- Verwandte Seiten
Wenn ein Gerät mehr als eine Internetverbindung hat, etwa eine zweite Leitung oder ein USB-Modem, können Sie einen Tunnel über ein bestimmtes Netzwerk leiten. Andere Tunnel nutzen weiter die Standardverbindung. Das Netzwerk legen Sie mit zwei Werten fest: seinem Namen und der IP-Adresse des Geräts in diesem Netzwerk.
Bevor Sie beginnen #
- Ein Gerät mit mindestens zwei aktiven Netzwerken, auf dem der Localtonet-Client installiert ist. Siehe Installation.
- Ein Tunnel eines Typs mit der Einstellung Argumente: HTTP, TCP - UDP, TLS oder Proxy-Server.
- Führen Sie den Client unter Linux als root oder mit passwortlosem
sudoaus. Der Client fügt mit dem BefehlipRouting-Regeln für das gewählte Netzwerk hinzu; ohne diese Berechtigung kann der Datenverkehr über die Standardroute das Gerät verlassen.
Schritte #
-
Die Netzwerke des Geräts auflisten #
Führen Sie auf dem Gerät Folgendes aus:
Terminallocaltonet --networkDer Befehl benötigt keinen AuthToken. Er listet jedes aktive Netzwerk mit seinen IP-Adressen auf, prüft jede IPv4-Adresse auf Internetzugang und beendet sich dann:
AusgabeNetworkName: Ethernet 2 --net Ethernet 2 --ip 192.168.8.100 --> Internet available (public IP 203.0.113.25) -------------------------------------------------- NetworkName: Wi-Fi --net Wi-Fi --ip 192.168.1.20 --> Internet available (public IP 198.51.100.7) --net Wi-Fi --ip 2001:db8::20 --> IPv6, internet check not available --------------------------------------------------Jede Zeile, die mit
--netbeginnt, ist ein fertiges Paar aus Netzwerkname und IP-Adresse. Notieren Sie sich das Paar des gewünschten Netzwerks. Eine Zeile, die mitNo internet accessendet, gehört zu einer Adresse, bei der die Internetprüfung fehlgeschlagen ist. Nach der Liste gibt der Befehl eine kurze Erklärung zu--netund--ipaus. -
Die Einstellung „Argumente“ des Tunnels öffnen #
Öffnen Sie im Dashboard die Seite des Tunneltyps, wählen Sie in der Zeile des Tunnels Einstellungen und dann Argumente › Verwalten. Der Dialog Netzwerkauswahl öffnet sich.
-
Das Netzwerk eintragen #
Aktivieren Sie Bestimmtes Netzwerk verwenden und füllen Sie beide Felder aus:
Feld Was Sie eingeben Beispiel Netzwerkname Der Name genau so, wie localtonet --networkihn nachNetworkName:ausgibt.Ethernet 2Geräte-IP in diesem Netzwerk Die IPv4- oder IPv6-Adresse des Geräts in diesem Netzwerk, aus einer --net-Zeile dieses Netzwerks.192.168.8.100An die App gesendet zeigt die resultierenden Argumente, zum Beispiel
--net Ethernet 2 --ip 192.168.8.100. -
Speichern #
Wählen Sie Speichern. Ein laufender Tunnel wird neu gestartet und verwendet von da an das gewählte Netzwerk.
Die Argumente in Textform #
Als Text bearbeiten schaltet den Dialog auf ein einziges Feld Argumente um, und Formular verwenden schaltet zurück. Der Text hat diese Form:
--net <NETWORK_NAME> --ip <IP_ADDRESS>--netund--ipmüssen zusammen angegeben werden. Wird nur eines von beiden angegeben, hat der Tunnel kein eigenes Netzwerk: Er verwendet das Standardnetzwerk oder das für den gesamten Client gewählte Netzwerk.- Ein Netzwerkname mit Leerzeichen kann so geschrieben werden, wie er ist, oder in Anführungszeichen:
--net Wi-Fi 2 --ip 192.168.1.5und--net "Wi-Fi 2" --ip 192.168.1.5bedeuten dasselbe. - Der Name wird zuerst exakt verglichen. Ein Name, der sich nur in der Groß- und Kleinschreibung unterscheidet, wird akzeptiert, wenn er genau zu einem Netzwerk passt.
- Die IP-Adresse muss eine sein, die das Gerät derzeit in diesem Netzwerk hat.
Wofür das gewählte Netzwerk verwendet wird #
- Die Verbindung des Tunnels vom Gerät zum Localtonet-Server.
- Bei einem Proxy-Tunnel der Datenverkehr, der das Gerät direkt ins Internet verlässt, und die dazugehörigen DNS-Abfragen. Hat der Proxy-Tunnel eine Upstream-Einstellung, ist die Verbindung zum Upstream-Proxy nicht an das gewählte Netzwerk gebunden.
- Die Verbindung zu Ihrem lokalen Dienst, wenn dieser Dienst über das gewählte Netzwerk erreicht wird. Ein Dienst auf dem Gerät selbst (
127.0.0.1) oder in einem anderen lokalen Netzwerk wird auf dem normalen Weg erreicht.
Wenn das Netzwerk nicht verfügbar ist #
Fehlt das gewählte Netzwerk, fällt der Tunnel nicht auf die Standardverbindung zurück: Seine Verbindungen bleiben geschlossen. Das ist bei Proxys wichtig: Der Datenverkehr darf nicht über eine andere Leitung als die von Ihnen gewählte laufen.
- Fehlt das Netzwerk beim Start des Tunnels, wartet der Tunnel darauf.
- Verschwindet das Netzwerk später, bleiben die Verbindungen des Tunnels geschlossen, bis das Paar aus Netzwerkname und IP-Adresse wieder verfügbar ist. Der Client prüft alle paar Sekunden und bei jeder Änderung der Netzwerke des Geräts erneut, und der Tunnel setzt sich selbstständig fort.
- Erhält das Gerät in diesem Netzwerk eine andere IP-Adresse, passt das Paar nicht mehr und der Tunnel bleibt geschlossen. Weisen Sie dem Gerät in diesem Netzwerk eine feste Adresse zu oder aktualisieren Sie die Einstellung.
Starten Sie den Client mit Ihrem Token und --debug (localtonet --authtoken <YOUR_TOKEN> --debug), um den Grund in seiner Fehlerausgabe zu sehen. Die Zeile beginnt mit einem Zeitstempel und [debug][proxy], nennt dann den Tunnel anhand seiner internen Kennung, das Problem und das Paar, auf das er wartet:
[2026-11-14 10:15:30.123 UTC][debug][proxy] Tunnel <TUNNEL_IDENTIFIER>: Network interface 'Ethernet 2' was not found. Run 'localtonet --network' to list the interfaces. Its connections stay closed until --net Ethernet 2 --ip 192.168.8.100 is available.Weitere Probleme, die genannt werden können, sind unter anderem "'192.168.8.100' is not an address of network interface 'Ethernet 2'.", "Network interface 'Ethernet 2' is Down." und "The --ip value is not an IP address."
Ein Netzwerk für den gesamten Client wählen #
Um ein Netzwerk für die eigene Verbindung des Clients und für jeden Tunnel ohne eigenes Netzwerk zu wählen, übergeben Sie beim Start dieselben zwei Optionen:
localtonet --authtoken <YOUR_TOKEN> --net <NETWORK_NAME> --ip <IP_ADDRESS>- Beide Optionen sind erforderlich. Bei nur einer gibt der Client "--net and --ip must be given together; the default network is used." aus und läuft im Standardnetzwerk weiter.
- Ist das Netzwerk beim Start nicht verfügbar, wartet der Client bis zu 30 Sekunden darauf und beendet sich dann mit der Begründung, anstatt in einem anderen Netzwerk zu laufen.
- Ein Tunnel, der unter Argumente ein eigenes Netzwerk hat, verwendet dieses. Die Optionen des Clients gelten für die Tunnel ohne eigenes Netzwerk.
Alle Kommandozeilenoptionen sind in der CLI-Referenz aufgeführt.
Beispiel: zwei Proxys an zwei Modems #
Ein Computer hat zwei USB-Modems. localtonet --network gibt --net Modem A --ip 192.168.8.100 und --net Modem B --ip 192.168.9.100 aus. Erstellen Sie zwei Proxy-Server-Tunnel mit dem AuthToken des Geräts. Öffnen Sie beim ersten Argumente › Verwalten und geben Sie Modem A und 192.168.8.100 ein; geben Sie beim zweiten Modem B und 192.168.9.100 ein. Jeder Proxy verlässt das Gerät nun über sein eigenes Modem, und ein Proxy leitet keinen Datenverkehr mehr weiter, wenn sein Modem abgesteckt wird.
Dieselbe Einstellung über die API #
Die Argumente eines Tunnels können unter /api/v2/tunnels/<TUNNEL_ID>/arguments gelesen (GET) und gesetzt (PATCH) werden. Senden Sie einen leeren Wert, um sie zu entfernen. Ein über die API gesetzter Wert wird beim nächsten Start des Tunnels verwendet. Siehe API.
{ "arguments": "--net Ethernet 2 --ip 192.168.8.100" }Fehlerbehebung #
„Geben Sie den Netzwerknamen ein.“ oder „Geben Sie die IP-Adresse des Geräts in diesem Netzwerk ein.“
Beide Felder sind erforderlich, solange Bestimmtes Netzwerk verwenden aktiviert ist. Um kein bestimmtes Netzwerk mehr zu verwenden, schalten Sie den Schalter aus und speichern Sie.
„Geben Sie eine IP-Adresse wie 192.168.8.100 ein.“
Das zweite Feld erwartet die IP-Adresse des Geräts in diesem Netzwerk, nicht den Namen des Netzwerks und nicht die öffentliche IP-Adresse.
„Prüfen Sie die Verbindung des Geräts.“
Das Speichern startet einen laufenden Tunnel neu, und die Localtonet-App seines Geräts ist nicht verbunden. Starten Sie die App oder stoppen Sie den Tunnel und speichern Sie erneut.
Der Tunnel ist gestartet, leitet aber keinen Datenverkehr weiter
Das gewählte Netzwerk ist wahrscheinlich nicht verfügbar. Führen Sie localtonet --network auf dem Gerät aus und vergleichen Sie Namen und IP-Adresse mit der Einstellung. Korrigieren Sie die Einstellung oder aktivieren Sie das Netzwerk wieder.
Unter Linux verlässt der Datenverkehr das Gerät weiterhin über die Standardroute
Der Client konnte die Routing-Regeln wahrscheinlich nicht hinzufügen. Führen Sie ihn als root aus oder erlauben Sie passwortloses sudo für den Befehl ip und starten Sie den Client dann neu. Für ein Netzwerk ohne gemeldetes Gateway fügt der Client keine Regeln hinzu.
localtonet --network gibt "No active network interface with an IP address was found." aus
Das Gerät hat kein Netzwerk, das aktiv ist und eine Adresse hat. Verbinden Sie ein Netzwerk und führen Sie den Befehl erneut aus.