Vai al contenuto
Localtonet Localtonet Dashboard

Installa il client Localtonet

Aiuto su questa pagina
In questa pagina 5 sezioni
  1. Piattaforme supportate
  2. Scegli il tipo di installazione
  3. Cosa hanno in comune tutte le installazioni
  4. Il client accede con un AuthToken
  5. Avvii il client con quel token
  6. Crei e avvii i tunnel nella dashboard
  7. Il client deve restare in esecuzione
  8. Mantieni il client aggiornato
  9. Guide all'installazione

Il client Localtonet gira sul dispositivo che ospita il tuo servizio e mantiene aperto il tunnel verso Localtonet. Questa pagina elenca le piattaforme supportate, ti aiuta a scegliere il tipo di installazione giusto e rimanda alla guida per ciascuna.

Piattaforme supportate #

Tutti i download sono nella pagina Download.

PiattaformaCosa puoi installareArchitetture
WindowsApp del Microsoft Store, app desktop portatile, client da console64 bit (x64), 32 bit (x86), ARM64
macOSClient da console, con Homebrew o come archivio ZIPIntel (x64), Apple Silicon (ARM64)
LinuxClient da console, con lo script di installazione o come archivio ZIPx64, ARM e ARM64, ciascuno per glibc e per musl
Pacchetti LinuxPacchetti DEB e RPM con servizi systemdx64, ARM64
AndroidApp Android da Google Play o come file APKLa versione minima di Android richiesta dall'app è la 5.0
TermuxClient da console come pacchetto TermuxARM64
DockerImmagine ufficiale localtonet/localtonetAMD64, ARM64
OpenWrtPacchetti per router OpenWrt 24.10 e 25.12+ (sperimentali)x64, ARM64
NAS e Home AssistantTemplate di configurazione per Docker Compose e Home AssistantAMD64, ARM64
SSH senza installazioneNiente. Usi il client SSH che hai già.Qualsiasi dispositivo con un client SSH

Scegli il tipo di installazione #

OpzioneCos'èScegliila quando
Client da consoleIl programma localtonet per Windows, macOS e Linux. Lo avvii in un terminale con il tuo AuthToken. Mostra i tuoi tunnel in una tabella in tempo reale e può installarsi da solo come servizio.Lavori in un terminale, oppure il dispositivo è un server senza desktop.
App desktopL'app Localtonet per Windows con una finestra di accesso, dal Microsoft Store o come ZIP portatile.Su Windows preferisci la finestra di un'app a un terminale.
App mobileL'app Localtonet per Android. Accedi con un codice QR, un PIN o il token.Il dispositivo è uno smartphone o un tablet Android, per esempio per un proxy mobile.
PacchettoPacchetti DEB e RPM per Linux, un pacchetto Termux per Android e pacchetti sperimentali per OpenWrt. I pacchetti Linux e OpenWrt includono un servizio che legge il token da un file.Vuoi che il gestore di pacchetti del sistema installi e rimuova il client, e un servizio che parte all'avvio.
ContainerL'immagine Docker ufficiale e i template di configurazione per dispositivi NAS e Home Assistant che la usano.I tuoi servizi girano già in container, oppure il dispositivo è un NAS.
SSH senza installazioneLa dashboard genera un comando ssh che apre il tunnel. Non serve alcun download. È disponibile per i tunnel HTTP e TCP.Non puoi o non vuoi installare nulla sul dispositivo.

Cosa hanno in comune tutte le installazioni #

  1. Il client accede con un AuthToken #

    Un AuthToken collega un dispositivo al tuo account. Copialo con Copia nella scheda AuthToken della Dashboard, oppure crea un token con nome per ogni dispositivo in I miei token. I token sono spiegati in AuthToken.

    Tieni privato il tuo token. Chiunque abbia il token può usarlo per accedere all'app.

  2. Avvii il client con quel token #

    Sostituisci <YOUR_TOKEN> con il tuo token.

    Windows

    Apri l'app Localtonet e incolla il tuo AuthToken, oppure esegui il client da console nel Prompt dei comandi dalla cartella che contiene localtonet.exe:

    Prompt dei comandi
    localtonet --authtoken <YOUR_TOKEN>

    macOS

    Bash
    brew tap localtonet/tap
    brew install localtonet
    localtonet --authtoken <YOUR_TOKEN>

    Linux

    Bash
    curl -fsSL https://localtonet.com/install.sh | sh
    localtonet --authtoken <YOUR_TOKEN>

    Docker

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

    Android

    Apri l'app Localtonet, poi scansiona il codice QR del token, inserisci il suo PIN o incolla il token, e seleziona Connect. Il codice QR e il PIN si trovano in I miei token.

    Il client da console memorizza il token in locale, quindi la volta successiva puoi avviarlo con il solo localtonet. Quando lo avvii senza un token memorizzato, chiede Please Enter AuthToken or PIN.

  3. Crei e avvii i tunnel nella dashboard #

    Il client non ha bisogno di conoscere i tuoi tunnel in anticipo. Crei un tunnel sotto I miei tunnel, scegli il token del dispositivo e il client che ha effettuato l'accesso con quel token lo serve. La Guida rapida ti accompagna nel primo tunnel.

  4. Il client deve restare in esecuzione #

    Un tunnel va online quando il client è in esecuzione con il tuo AuthToken e il tunnel è avviato. I miei token mostra ogni dispositivo come Online oppure Offline. Offline significa che il dispositivo è disconnesso, anche se i suoi tunnel sono ancora configurati.

    Per mantenere il client in esecuzione dopo che chiudi il terminale, esci dalla sessione o riavvii il dispositivo, installalo come servizio:

    PiattaformaCome
    Windowslocaltonet --install-service --authtoken <YOUR_TOKEN> in un terminale eseguito come amministratore
    macOS, Linuxsudo localtonet --install-service --authtoken <YOUR_TOKEN>
    Pacchetti DEB, RPM e OpenWrtIl pacchetto contiene il servizio. Lo abiliti dopo aver impostato il token.
    AndroidL'app continua a funzionare in background e si riapre dopo il riavvio del telefono.

    I dettagli sono in Esegui come servizio e nella pagina di ogni piattaforma.

Mantieni il client aggiornato #

La colonna Client in I miei token mostra l'ultima versione riportata da ogni dispositivo. Un badge Aggiornamento necessario rimanda alla pagina dei Download quando è disponibile una versione più recente. Il client da console mostra anche New Version available sotto la sua tabella dei tunnel, e localtonet --version stampa la versione installata.

Guide all'installazione #

Supporto