Zum Inhalt springen
Localtonet Localtonet Dashboard

Localtonet in Docker ausführen

Hilfe zu dieser Seite
Auf dieser Seite 12 Abschnitte
  1. Bevor Sie beginnen
  2. Schritte
  3. Das Image herunterladen
  4. Den Container mit Ihrem Token starten
  5. Einen Tunnel erstellen und starten
  6. Wie der Container läuft
  7. Im Hintergrund ausführen und automatisch neu starten
  8. Möglichkeiten, das Token zu übergeben
  9. Docker Compose
  10. Ihren Dienst aus dem Container erreichen
  11. Das Protokoll lesen
  12. Aktualisieren
  13. Image-Archive für Hosts ohne Registry-Zugriff
  14. Fehlerbehebung
  15. Verwandte Seiten

Das offizielle Image localtonet/localtonet führt den Localtonet-Client in einem Container aus. Übergeben Sie Ihren AuthToken und erstellen und starten Sie die Tunnel dann wie gewohnt im Dashboard.

Bevor Sie beginnen #

  • Docker auf einem 64-Bit-Host. Das Image wird für linux/amd64 und linux/arm64 veröffentlicht, und Docker wählt das passende für Ihren Host. Verwenden Sie für ein 32-Bit-ARM-Gerät stattdessen den Linux-Build.
  • Ein AuthToken aus Meine Tokens. Geben Sie jedem Container ein eigenes Token: Wenn sich ein zweiter Client mit demselben Token verbindet, wird der erste getrennt.

Schritte #

  1. Das Image herunterladen #

    Wenn Sie zuerst herunterladen (pull), stellen Sie sicher, dass Sie die aktuelle Version ausführen und kein älteres Image, das noch auf dem Host liegt.

    Bash
    docker pull localtonet/localtonet

    Das Image liegt auf Docker Hub. Neben latest listet Docker Hub für jede Version einen Tag auf, falls Sie ein bestimmtes Release festlegen möchten.

  2. Den Container mit Ihrem Token starten #

    Alles nach dem Image-Namen wird an den Localtonet-Client übergeben. Ersetzen Sie <YOUR_TOKEN> durch Ihren AuthToken.

    Bash
    docker run localtonet/localtonet --authtoken <YOUR_TOKEN>

    Der Container gibt seinen Verbindungsstatus aus und bleibt im Vordergrund. Drücken Sie Ctrl + C, um ihn zu stoppen.

  3. Einen Tunnel erstellen und starten #

    Öffnen Sie das Dashboard, erstellen Sie einen Tunnel mit dem Token, das Sie dem Container gegeben haben, und wählen Sie Starten. Die Schnellstart-Seite zeigt das Formular. Lesen Sie Ihren Dienst aus dem Container erreichen, bevor Sie Lokale IP-Adresse ausfüllen, denn 127.0.0.1 bedeutet in einem Container etwas anderes.

Wie der Container läuft #

Das Image startet den Client im Headless-Modus. Gegenüber dem Client auf einem Desktop ändert das drei Dinge:

  • Er stellt nie eine Frage. Fehlt das Token oder ist es fehlerhaft, gibt der Container einen Fehler aus und beendet sich mit dem Code 2.
  • Er schreibt einfache Protokollzeilen statt der Live-Statustabelle, auch wenn Sie ihn mit -it starten.
  • Er speichert das Token nicht. Das Image deklariert keine Volumes, übergeben Sie das Token daher bei jeder Erstellung eines Containers: in der Befehlszeile, in einer Umgebungsvariablen oder als Datei.

Tunnel werden nicht im Container konfiguriert. Sie erstellen, starten und stoppen sie im Dashboard, und der Container übernimmt sie über seine Verbindung.

Im Hintergrund ausführen und automatisch neu starten #

Verwenden Sie -d, um den Container abzukoppeln, und eine Neustartrichtlinie, damit Docker ihn nach einem Neustart oder Absturz erneut startet:

Bash
docker run -d \
  --name localtonet \
  --restart unless-stopped \
  localtonet/localtonet --authtoken <YOUR_TOKEN>

Verwalten Sie ihn mit den üblichen Docker-Befehlen:

BefehlFunktion
docker psListet laufende Container auf.
docker logs -f localtonetVerfolgt das Protokoll des Clients.
docker stop localtonetStoppt den Client. Seine Tunnel gehen offline.
docker start localtonetStartet ihn mit demselben Token erneut.
docker rm -f localtonetEntfernt den Container.

Möglichkeiten, das Token zu übergeben #

Ein Token in der Befehlszeile ist in docker inspect und in der Prozessliste des Hosts sichtbar. Das Image liest das Token auch aus der Umgebung oder aus einer Datei:

QuelleVerwendungHinweise
--authtoken <YOUR_TOKEN>Argument nach dem Image-Namen.Am einfachsten. Hat Vorrang vor LOCALTONET_AUTH_TOKEN.
LOCALTONET_AUTH_TOKENUmgebungsvariable, die das Token enthält.Wird verwendet, wenn kein Argument --authtoken angegeben ist.
LOCALTONET_AUTH_TOKEN_FILEUmgebungsvariable, die den Pfad einer Datei innerhalb des Containers enthält, in der nur das Token steht.Eine Token-Datei hat immer Vorrang vor einem direkt übergebenen Token. Das Argument --authtoken-file <PATH> bewirkt dasselbe.

Das Image selbst setzt LOCALTONET_HEADLESS=1. Sie müssen es nicht setzen.

Halten Sie das Token mit einer Token-Datei aus der Container-Definition heraus und binden Sie es schreibgeschützt ein:

Bash
printf '%s' '<YOUR_TOKEN>' > auth-token
chmod 600 auth-token

docker run -d \
  --name localtonet \
  --restart unless-stopped \
  -e LOCALTONET_AUTH_TOKEN_FILE=/run/secrets/localtonet_auth_token \
  -v "$(pwd)/auth-token:/run/secrets/localtonet_auth_token:ro" \
  localtonet/localtonet

Erstellen Sie die Token-Datei, bevor Sie den Container starten. Existiert die Datei nicht, legt Docker ein Verzeichnis mit diesem Namen an, und der Client kann daraus kein Token lesen.

Um eine Token-Quelle zu prüfen, ohne eine Verbindung aufzubauen, fügen Sie --check-config hinzu. Der Client prüft, ob das Token vorhanden und wohlgeformt ist (33 Zeichen, keine Leerzeichen), gibt Localtonet headless configuration OK. aus und beendet sich. Er fragt den Server nicht, ob das Token gültig ist.

Bash
docker run --rm \
  -e LOCALTONET_AUTH_TOKEN_FILE=/run/secrets/localtonet_auth_token \
  -v "$(pwd)/auth-token:/run/secrets/localtonet_auth_token:ro" \
  localtonet/localtonet --check-config

Docker Compose #

Dasselbe Setup als Compose-Datei. Legen Sie das Token in eine Datei namens auth-token neben compose.yaml:

compose.yaml
services:
  localtonet:
    image: localtonet/localtonet
    restart: unless-stopped
    environment:
      LOCALTONET_AUTH_TOKEN_FILE: /run/secrets/localtonet_auth_token
    volumes:
      - ./auth-token:/run/secrets/localtonet_auth_token:ro
Bash
docker compose up -d
docker compose logs -f localtonet

Wenn sich der Dienst, den Sie veröffentlichen möchten, im selben Compose-Projekt auf einem Linux-Host befindet, veröffentlichen Sie seinen Port auf dem Host und führen Sie den Localtonet-Container mit Host-Netzwerk aus. Die lokale Adresse des Tunnels muss eine IP-Adresse sein, daher kann ein Compose-Dienstname wie web dafür nicht verwendet werden:

compose.yaml
services:
  web:
    image: nginx
    ports:
      - "8080:80"

  localtonet:
    image: localtonet/localtonet
    restart: unless-stopped
    network_mode: host
    environment:
      LOCALTONET_AUTH_TOKEN_FILE: /run/secrets/localtonet_auth_token
    volumes:
      - ./auth-token:/run/secrets/localtonet_auth_token:ro

Setzen Sie für dieses Beispiel die lokale Adresse des Tunnels auf 127.0.0.1 und seinen lokalen Port auf 8080.

Für ein NAS oder Home Assistant finden Sie fertige Vorlagen auf der Seite NAS und Home Assistant.

Ihren Dienst aus dem Container erreichen #

Lokale IP-Adresse und Lokaler Port des Tunnels teilen dem Client mit, wo Ihr Dienst liegt. Der Client verbindet sich aus dem Container heraus, wo 127.0.0.1 der Container selbst ist und nicht Ihr Rechner. Geben Sie eine IP-Adresse ein: Der Client löst keine Docker-Namen wie host.docker.internal, keinen Compose-Dienstnamen und keinen Container-Namen auf. Verwenden Sie den Wert, der dazu passt, wo der Dienst läuft:

Wo der Dienst läuftEinzugebende lokale AdresseWas sonst noch nötig ist
Auf dem Docker-Host, Linux127.0.0.1Starten Sie den Container mit --network host (Compose: network_mode: host). Der Container teilt sich dann das Netzwerk des Hosts.
Auf dem Docker-Host, ohne Host-Netzwerk (einschließlich Docker Desktop unter Windows oder macOS)Die LAN-IP-Adresse des Hosts, zum Beispiel 192.168.1.10Der Dienst muss auf einer Adresse lauschen, die der Container erreichen kann, nicht nur auf 127.0.0.1, und die Firewall des Hosts muss die Verbindung zulassen.
In einem anderen Container127.0.0.1 mit --network host unter Linux, sonst die LAN-IP-Adresse des HostsVeröffentlichen Sie den Port dieses Containers auf dem Host (-p, Compose: ports) und verwenden Sie den veröffentlichten Port als lokalen Port des Tunnels.
Auf einem anderen Gerät in Ihrem NetzwerkDie LAN-IP-Adresse dieses Geräts, zum Beispiel 192.168.1.20Nichts.
Linux, Dienst auf dem Host
docker run -d \
  --name localtonet \
  --restart unless-stopped \
  --network host \
  localtonet/localtonet --authtoken <YOUR_TOKEN>

Die Adresse eines vorhandenen Tunnels können Sie in seinen Einstellungen unter Lokale Adresse ändern. Siehe die Einstellungsreferenz.

Das Protokoll lesen #

docker logs -f localtonet zeigt pro Änderung eine Zeile. Jede Zeile nach der ersten beginnt mit einem Zeitstempel:

ZeileBedeutung
Localtonet - headless logDer Client wurde gestartet.
Connection: …Der Zustand der Verbindung zu Localtonet. Bei einer Änderung erscheint eine neue Zeile.
AuthTokenName: …Der Name des Tokens, mit dem sich der Container angemeldet hat, wie er unter „Meine Tokens“ angezeigt wird.
OPEN …, ADDED …Ein Tunnel dieses Tokens. OPEN wird für Tunnel verwendet, die beim Start des Clients bereits existieren, ADDED für Tunnel, die später hinzukommen.
STATUS …Der Status eines Tunnels hat sich geändert.
CLOSED …Ein Tunnel wurde von diesem Client entfernt.
Authentication failed: AuthToken was rejected.Localtonet hat das Token nicht akzeptiert.

Das Token selbst wird nie in das Protokoll geschrieben.

Aktualisieren #

Laden Sie das Image erneut herunter und erstellen Sie den Container neu:

Bash
docker pull localtonet/localtonet
docker rm -f localtonet
docker run -d --name localtonet --restart unless-stopped localtonet/localtonet --authtoken <YOUR_TOKEN>

Führen Sie mit Compose docker compose pull und danach docker compose up -d aus. Um immer vom neuesten Image zu starten, fügen Sie docker run die Option --pull always hinzu.

Image-Archive für Hosts ohne Registry-Zugriff #

Wenn der Host Docker Hub nicht erreichen kann, laden Sie das Image auf einem anderen Rechner als TAR-Archiv herunter, kopieren Sie es hinüber und laden Sie es:

Bash
docker load --input localtonet-docker-amd64.tar

docker load gibt aus, was geladen wurde. Gibt es eine Image-ID statt eines Namens aus, geben Sie dem Image einen Namen, bevor Sie es ausführen:

Bash
docker tag <IMAGE_ID> localtonet/localtonet
docker run -d --name localtonet --restart unless-stopped localtonet/localtonet --authtoken <YOUR_TOKEN>

Fehlerbehebung #

Der Container beendet sich sofort mit „Invalid Localtonet headless configuration“

Die vollständige Meldung lautet Invalid Localtonet headless configuration. Check the token file or environment settings. Der Client hat kein verwendbares Token gefunden: Es wurde nichts übergeben, der Wert ist nicht 33 Zeichen lang, er enthält mitten drin ein Leerzeichen oder einen Zeilenumbruch, oder der Pfad der Token-Datei existiert im Container nicht. Wenn Sie eine Token-Datei einbinden, prüfen Sie auf dem Host, dass es sich um eine Datei und nicht um ein Verzeichnis handelt. Mit einer Neustartrichtlinie startet der Container immer wieder neu, bis Sie das Token korrigieren; lesen Sie daher docker logs localtonet.

Das Protokoll zeigt „Authentication failed: AuthToken was rejected.“

Das Token ist wohlgeformt, aber Localtonet akzeptiert es nicht. Kopieren Sie es erneut aus Meine Tokens und erstellen Sie den Container neu.

Der Tunnel ist gestartet, aber die öffentliche Adresse erreicht meinen Dienst nicht

Prüfen Sie die lokale Adresse des Tunnels. 127.0.0.1 funktioniert nur mit --network host unter Linux. Verwenden Sie sonst die LAN-IP-Adresse des Hosts. Ein Name wie host.docker.internal oder der Name eines anderen Containers funktioniert in diesem Feld nicht, wie unter Ihren Dienst aus dem Container erreichen beschrieben.

Der Container verliert ständig seine Verbindung

Stellen Sie sicher, dass kein anderer Client dasselbe Token verwendet. Ein zweiter Client, der sich mit dem Token verbindet, trennt den ersten. Erstellen Sie unter Meine Tokens ein Token pro Container oder Gerät.

Brauchen Sie Hilfe zu dieser Seite? Fragen Sie die Community oder eröffnen Sie ein Support-Ticket.

Support