Vai al contenuto
Localtonet Localtonet Dashboard

Esegui Localtonet in Docker

Aiuto su questa pagina
In questa pagina 12 sezioni
  1. Prima di iniziare
  2. Passaggi
  3. Scarica l'immagine
  4. Avvia il container con il tuo token
  5. Crea e avvia un tunnel
  6. Come funziona il container
  7. Esegui in background e riavvia automaticamente
  8. Modi per passare il token
  9. Docker Compose
  10. Raggiungere il tuo servizio dal container
  11. Leggi il log
  12. Aggiornamento
  13. Archivi dell'immagine per host senza accesso al registry
  14. Risoluzione dei problemi
  15. Pagine correlate

L'immagine ufficiale localtonet/localtonet esegue il client Localtonet in un container. Passa il tuo AuthToken, poi crea e avvia i tunnel nella dashboard come al solito.

Prima di iniziare #

  • Docker su un host a 64 bit. L'immagine è pubblicata per linux/amd64 e linux/arm64 e Docker sceglie quella adatta al tuo host. Per un dispositivo ARM a 32 bit, usa invece la build per Linux.
  • Un AuthToken da I miei token. Dai a ogni container il suo token: quando un secondo client si connette con lo stesso token, il primo viene disconnesso.

Passaggi #

  1. Scarica l'immagine #

    Scaricare prima l'immagine ti assicura di eseguire la versione corrente e non un'immagine più vecchia ancora presente sull'host.

    Bash
    docker pull localtonet/localtonet

    L'immagine si trova su Docker Hub. Oltre a latest, Docker Hub elenca un tag per ogni versione, se vuoi fissare una release.

  2. Avvia il container con il tuo token #

    Tutto ciò che segue il nome dell'immagine viene passato al client Localtonet. Sostituisci <YOUR_TOKEN> con il tuo AuthToken.

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

    Il container stampa lo stato della connessione e resta in primo piano. Premi Ctrl + C per arrestarlo.

  3. Crea e avvia un tunnel #

    Apri la dashboard, crea un tunnel con il token che hai dato al container e seleziona Avvia. L'Avvio rapido mostra il modulo. Leggi Raggiungere il tuo servizio dal container prima di compilare Indirizzo IP locale, perché 127.0.0.1 ha un significato diverso all'interno di un container.

Come funziona il container #

L'immagine avvia il client in modalità headless. Questo cambia tre cose rispetto al client su un desktop:

  • Non pone mai domande. Se il token manca o non è valido nel formato, il container stampa un errore ed esce con codice 2.
  • Scrive righe di log semplici invece della tabella di stato dal vivo, anche quando lo avvii con -it.
  • Non salva il token. L'immagine non dichiara alcun volume, quindi passa il token ogni volta che viene creato un container: sulla riga di comando, in una variabile d'ambiente o come file.

I tunnel non si configurano nel container. Li crei, li avvii e li arresti nella dashboard, e il container li riceve tramite la sua connessione.

Esegui in background e riavvia automaticamente #

Usa -d per staccarlo dal terminale e una policy di riavvio, così Docker riavvia il container dopo un riavvio del sistema o un arresto anomalo:

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

Gestiscilo con i comandi Docker consueti:

ComandoCosa fa
docker psElenca i container in esecuzione.
docker logs -f localtonetSegue il log del client.
docker stop localtonetArresta il client. I suoi tunnel vanno offline.
docker start localtonetLo riavvia con lo stesso token.
docker rm -f localtonetRimuove il container.

Modi per passare il token #

Un token sulla riga di comando è visibile in docker inspect e nell'elenco dei processi dell'host. L'immagine legge il token anche dall'ambiente o da un file:

OrigineCome usarlaNote
--authtoken <YOUR_TOKEN>Argomento dopo il nome dell'immagine.La più semplice. Ha la precedenza su LOCALTONET_AUTH_TOKEN.
LOCALTONET_AUTH_TOKENVariabile d'ambiente che contiene il token.Usata quando non viene fornito alcun argomento --authtoken.
LOCALTONET_AUTH_TOKEN_FILEVariabile d'ambiente che contiene il percorso, all'interno del container, di un file che contiene solo il token.Un file del token ha sempre la precedenza su un token passato direttamente. L'argomento --authtoken-file <PATH> fa lo stesso.

L'immagine stessa imposta LOCALTONET_HEADLESS=1. Non devi impostarla tu.

Con un file del token, tieni il token fuori dalla definizione del container e montalo in sola lettura:

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

Crea il file del token prima di avviare il container. Se il file non esiste, Docker crea una directory con quel nome e il client non può leggere un token da essa.

Per verificare una fonte del token senza connetterti, aggiungi --check-config. Il client controlla che il token sia presente e ben formato (33 caratteri, senza spazi), stampa Localtonet headless configuration OK. ed esce. Non chiede al server se il token è valido.

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 #

La stessa configurazione come file Compose. Metti il token in un file chiamato auth-token accanto a 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

Quando il servizio che vuoi pubblicare si trova nello stesso progetto Compose su un host Linux, pubblica la sua porta sull'host ed esegui il container Localtonet con la rete host. L'indirizzo locale del tunnel deve essere un indirizzo IP, quindi non puoi usare il nome di un servizio Compose come web:

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

Per questo esempio, imposta l'indirizzo locale del tunnel su 127.0.0.1 e la sua porta locale su 8080.

Per un NAS o Home Assistant, trovi modelli già pronti nella pagina NAS e Home Assistant.

Raggiungere il tuo servizio dal container #

L'Indirizzo IP locale e la Porta locale del tunnel indicano al client dove si trova il tuo servizio. Il client si connette dall'interno del container, dove 127.0.0.1 è il container stesso e non la tua macchina. Inserisci un indirizzo IP: il client non risolve nomi Docker come host.docker.internal, il nome di un servizio Compose o il nome di un container. Usa il valore che corrisponde al punto in cui viene eseguito il servizio:

Dove viene eseguito il servizioIndirizzo locale da inserireCos'altro serve
Sull'host Docker, Linux127.0.0.1Avvia il container con --network host (Compose: network_mode: host). Il container condivide così la rete dell'host.
Sull'host Docker, senza rete host (incluso Docker Desktop su Windows o macOS)L'indirizzo IP LAN dell'host, per esempio 192.168.1.10Il servizio deve restare in ascolto su un indirizzo raggiungibile dal container, non solo su 127.0.0.1, e il firewall dell'host deve consentire la connessione.
In un altro container127.0.0.1 con --network host su Linux, altrimenti l'indirizzo IP LAN dell'hostPubblica la porta di quel container sull'host (-p, Compose: ports) e usa la porta pubblicata come porta locale del tunnel.
Su un altro dispositivo della tua reteL'indirizzo IP LAN di quel dispositivo, per esempio 192.168.1.20Nient'altro.
Linux, servizio sull'host
docker run -d \
  --name localtonet \
  --restart unless-stopped \
  --network host \
  localtonet/localtonet --authtoken <YOUR_TOKEN>

Puoi cambiare l'indirizzo di un tunnel esistente nelle sue impostazioni, sotto Indirizzo locale. Consulta il riferimento delle impostazioni.

Leggi il log #

docker logs -f localtonet mostra una riga per ogni cambiamento. Ogni riga dopo la prima inizia con un timestamp:

RigaSignificato
Localtonet - headless logIl client è stato avviato.
Connection: …Lo stato della connessione a Localtonet. Compare una nuova riga quando cambia.
AuthTokenName: …Il nome del token con cui il container ha effettuato l'accesso, come mostrato in I miei token.
OPEN …, ADDED …Un tunnel di questo token. OPEN è usato per i tunnel che esistono quando il client si avvia, ADDED per i tunnel che compaiono dopo.
STATUS …Lo stato di un tunnel è cambiato.
CLOSED …Un tunnel è stato rimosso da questo client.
Authentication failed: AuthToken was rejected.Localtonet non ha accettato il token.

Il token stesso non viene mai scritto nel log.

Aggiornamento #

Scarica di nuovo l'immagine e ricrea il container:

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

Con Compose, esegui docker compose pull e poi docker compose up -d. Per partire sempre dall'immagine più recente, aggiungi --pull always a docker run.

Archivi dell'immagine per host senza accesso al registry #

Se l'host non riesce a raggiungere Docker Hub, scarica l'immagine come archivio TAR su un'altra macchina, copiala e caricala:

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

docker load stampa ciò che ha caricato. Se stampa un ID immagine invece di un nome, assegna un nome all'immagine prima di eseguirla:

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

Risoluzione dei problemi #

Il container esce subito con "Invalid Localtonet headless configuration"

Il messaggio completo è Invalid Localtonet headless configuration. Check the token file or environment settings. Il client non ha trovato alcun token utilizzabile: non è stato passato nulla, il valore non è lungo 33 caratteri, contiene uno spazio o un'interruzione di riga nel mezzo, oppure il percorso del file del token non esiste nel container. Se monti un file del token, verifica sull'host che sia un file e non una directory. Con una policy di riavvio il container continua a riavviarsi finché non correggi il token, quindi leggi docker logs localtonet.

Il log mostra "Authentication failed: AuthToken was rejected."

Il token ha un formato valido ma Localtonet non lo accetta. Copialo di nuovo da I miei token e ricrea il container.

Il tunnel è avviato ma l'indirizzo pubblico non raggiunge il mio servizio

Controlla l'indirizzo locale del tunnel. 127.0.0.1 funziona solo con --network host su Linux. Altrimenti usa l'indirizzo IP LAN dell'host. Un nome come host.docker.internal o il nome di un altro container non funziona in questo campo, come descritto in Raggiungere il tuo servizio dal container.

Il container continua a perdere la connessione

Assicurati che nessun altro client usi lo stesso token. Un secondo client che si connette con il token disconnette il primo. Crea un token per ogni container o dispositivo in I miei token.

Supporto