Naar de inhoud
Localtonet Localtonet Dashboard

Localtonet uitvoeren in Docker

Hulp bij deze pagina
Op deze pagina 12 secties
  1. Voordat je begint
  2. Stappen
  3. Haal de image op
  4. Start de container met je token
  5. Maak een tunnel aan en start hem
  6. Hoe de container draait
  7. Op de achtergrond draaien en automatisch herstarten
  8. Manieren om het token mee te geven
  9. Docker Compose
  10. Je service bereiken vanuit de container
  11. Het logboek lezen
  12. Bijwerken
  13. Image-archieven voor hosts zonder toegang tot een register
  14. Probleemoplossing
  15. Gerelateerde pagina's

De officiële image localtonet/localtonet draait de Localtonet-client in een container. Geef je AuthToken mee en maak en start tunnels daarna zoals gewoonlijk in het dashboard.

Voordat je begint #

  • Docker op een 64-bits host. De image wordt gepubliceerd voor linux/amd64 en linux/arm64, en Docker kiest de image die bij je host past. Gebruik voor een 32-bits ARM-apparaat in plaats daarvan de Linux-build.
  • Een AuthToken uit Mijn tokens. Geef elke container een eigen token: wanneer een tweede client met hetzelfde token verbinding maakt, wordt de eerste losgekoppeld.

Stappen #

  1. Haal de image op #

    Eerst ophalen zorgt ervoor dat je de huidige versie draait en niet een oudere image die nog op de host staat.

    Bash
    docker pull localtonet/localtonet

    De image staat op Docker Hub. Naast latest vermeldt Docker Hub een tag voor elke versie als je een release wilt vastzetten.

  2. Start de container met je token #

    Alles na de imagenaam wordt doorgegeven aan de Localtonet-client. Vervang <YOUR_TOKEN> door je AuthToken.

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

    De container toont zijn verbindingsstatus en blijft op de voorgrond draaien. Druk op Ctrl + C om hem te stoppen.

  3. Maak een tunnel aan en start hem #

    Open het dashboard, maak een tunnel aan met het token dat je de container hebt gegeven en selecteer Starten. De Snelstart toont het formulier. Lees Je service bereiken vanuit de container voordat je Lokaal IP-adres invult, want 127.0.0.1 betekent in een container iets anders.

Hoe de container draait #

De image start de client in headless-modus. Dat verandert drie dingen ten opzichte van de client op een desktop:

  • Hij stelt nooit een vraag. Ontbreekt het token of heeft het een ongeldig formaat, dan toont de container een fout en stopt hij met code 2.
  • Hij schrijft gewone logregels in plaats van de live statustabel, ook als je hem met -it start.
  • Hij slaat het token niet op. De image declareert geen volumes, dus geef het token mee telkens wanneer een container wordt aangemaakt: op de opdrachtregel, in een omgevingsvariabele of als bestand.

Tunnels worden niet in de container geconfigureerd. Je maakt ze aan, start en stopt ze in het dashboard, en de container pikt ze op via zijn verbinding.

Op de achtergrond draaien en automatisch herstarten #

Gebruik -d om los te koppelen en een herstartbeleid zodat Docker de container na een herstart of crash opnieuw start:

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

Beheer hem met de gebruikelijke Docker-opdrachten:

OpdrachtWat het doet
docker psGeeft draaiende containers weer.
docker logs -f localtonetVolgt het logboek van de client.
docker stop localtonetStopt de client. Zijn tunnels gaan offline.
docker start localtonetStart hem opnieuw met hetzelfde token.
docker rm -f localtonetVerwijdert de container.

Manieren om het token mee te geven #

Een token op de opdrachtregel is zichtbaar in docker inspect en in de proceslijst van de host. De image leest het token ook uit de omgeving of uit een bestand:

BronHoe je het gebruiktOpmerkingen
--authtoken <YOUR_TOKEN>Argument na de imagenaam.Het eenvoudigst. Gaat voor op LOCALTONET_AUTH_TOKEN.
LOCALTONET_AUTH_TOKENOmgevingsvariabele die het token bevat.Wordt gebruikt als er geen --authtoken-argument is opgegeven.
LOCALTONET_AUTH_TOKEN_FILEOmgevingsvariabele die het pad bevat, binnen de container, van een bestand dat alleen het token bevat.Een tokenbestand gaat altijd voor op een token dat rechtstreeks wordt meegegeven. Het argument --authtoken-file <PATH> doet hetzelfde.

De image zelf stelt LOCALTONET_HEADLESS=1 in. Dat hoef je niet zelf in te stellen.

Houd het token bij een tokenbestand buiten de containerdefinitie en koppel het alleen-lezen:

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

Maak het tokenbestand aan voordat je de container start. Als het bestand niet bestaat, maakt Docker een map met die naam aan en kan de client er geen token uit lezen.

Om een tokenbron te controleren zonder verbinding te maken, voeg je --check-config toe. De client controleert of het token aanwezig is en een geldig formaat heeft (33 tekens, geen spaties), toont Localtonet headless configuration OK. en stopt. Hij vraagt de server niet of het token geldig is.

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 #

Dezelfde opzet als Compose-bestand. Zet het token in een bestand met de naam auth-token naast 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

Staat de service die je wilt publiceren in hetzelfde Compose-project op een Linux-host, publiceer dan de poort ervan op de host en draai de Localtonet-container met hostnetwerk. Het lokale adres van de tunnel moet een IP-adres zijn, dus een Compose-servicenaam zoals web kan hiervoor niet worden gebruikt:

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

Stel voor dit voorbeeld het lokale adres van de tunnel in op 127.0.0.1 en de lokale poort op 8080.

Voor een NAS of Home Assistant staan kant-en-klare sjablonen op de pagina NAS en Home Assistant.

Je service bereiken vanuit de container #

Het Lokaal IP-adres en de Lokale poort van de tunnel geven de client aan waar je service staat. De client verbindt vanuit de container, waar 127.0.0.1 de container zelf is en niet je computer. Vul een IP-adres in: de client zoekt Docker-namen zoals host.docker.internal, een Compose-servicenaam of een containernaam niet op. Gebruik de waarde die past bij de plek waar de service draait:

Waar de service draaitLokaal adres om in te vullenWat je verder nodig hebt
Op de Docker-host, Linux127.0.0.1Start de container met --network host (Compose: network_mode: host). De container deelt dan het netwerk van de host.
Op de Docker-host, zonder hostnetwerk (ook Docker Desktop op Windows of macOS)Het LAN-IP-adres van de host, bijvoorbeeld 192.168.1.10De service moet luisteren op een adres dat de container kan bereiken, niet alleen op 127.0.0.1, en de firewall van de host moet de verbinding toestaan.
In een andere container127.0.0.1 met --network host op Linux, anders het LAN-IP-adres van de hostPubliceer de poort van die container op de host (-p, Compose: ports) en gebruik de gepubliceerde poort als lokale poort van de tunnel.
Op een ander apparaat in je netwerkHet LAN-IP-adres van dat apparaat, bijvoorbeeld 192.168.1.20Niets.
Linux, service op de host
docker run -d \
  --name localtonet \
  --restart unless-stopped \
  --network host \
  localtonet/localtonet --authtoken <YOUR_TOKEN>

Je kunt het adres van een bestaande tunnel wijzigen in de instellingen ervan onder Lokaal adres. Zie de instellingenreferentie.

Het logboek lezen #

docker logs -f localtonet toont één regel per wijziging. Elke regel na de eerste begint met een tijdstempel:

RegelBetekenis
Localtonet - headless logDe client is gestart.
Connection: …De status van de verbinding met Localtonet. Er verschijnt een nieuwe regel wanneer die verandert.
AuthTokenName: …De naam van het token waarmee de container zich heeft aangemeld, zoals getoond in Mijn tokens.
OPEN …, ADDED …Een tunnel van dit token. OPEN wordt gebruikt voor tunnels die bestaan wanneer de client start, ADDED voor tunnels die later verschijnen.
STATUS …De status van een tunnel is gewijzigd.
CLOSED …Een tunnel is van deze client verwijderd.
Authentication failed: AuthToken was rejected.Localtonet heeft het token niet geaccepteerd.

Het token zelf wordt nooit in het logboek geschreven.

Bijwerken #

Haal de image opnieuw op en maak de container opnieuw aan:

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

Voer bij Compose docker compose pull uit en daarna docker compose up -d. Om altijd met de nieuwste image te beginnen, voeg je --pull always toe aan docker run.

Image-archieven voor hosts zonder toegang tot een register #

Als de host Docker Hub niet kan bereiken, download je de image als TAR-archief op een andere computer, kopieer je hem over en laad je hem:

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

docker load toont wat er is geladen. Toont hij een image-ID in plaats van een naam, geef de image dan een naam voordat je hem uitvoert:

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

Probleemoplossing #

De container stopt meteen met "Invalid Localtonet headless configuration"

Het volledige bericht is Invalid Localtonet headless configuration. Check the token file or environment settings. De client heeft geen bruikbaar token gevonden: er is niets meegegeven, de waarde is niet 33 tekens lang, bevat midden in een spatie of regeleinde, of het pad van het tokenbestand bestaat niet in de container. Als je een tokenbestand koppelt, controleer dan op de host dat het een bestand is en geen map. Met een herstartbeleid blijft de container herstarten totdat je het token herstelt, dus lees docker logs localtonet.

Het logboek toont "Authentication failed: AuthToken was rejected."

Het token heeft een geldig formaat, maar Localtonet accepteert het niet. Kopieer het opnieuw uit Mijn tokens en maak de container opnieuw aan.

De tunnel is gestart, maar het openbare adres bereikt mijn service niet

Controleer het lokale adres van de tunnel. 127.0.0.1 werkt alleen met --network host op Linux. Gebruik anders het LAN-IP-adres van de host. Een naam zoals host.docker.internal of de naam van een andere container werkt niet in dit veld, zoals beschreven in Je service bereiken vanuit de container.

De container verliest steeds zijn verbinding

Zorg dat geen andere client hetzelfde token gebruikt. Een tweede client die met het token verbinding maakt, koppelt de eerste los. Maak per container of apparaat één token aan in Mijn tokens.

Support