Installa il client Localtonet
In questa pagina 5 sezioni
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.
| Piattaforma | Cosa puoi installare | Architetture |
|---|---|---|
| Windows | App del Microsoft Store, app desktop portatile, client da console | 64 bit (x64), 32 bit (x86), ARM64 |
| macOS | Client da console, con Homebrew o come archivio ZIP | Intel (x64), Apple Silicon (ARM64) |
| Linux | Client da console, con lo script di installazione o come archivio ZIP | x64, ARM e ARM64, ciascuno per glibc e per musl |
| Pacchetti Linux | Pacchetti DEB e RPM con servizi systemd | x64, ARM64 |
| Android | App Android da Google Play o come file APK | La versione minima di Android richiesta dall'app è la 5.0 |
| Termux | Client da console come pacchetto Termux | ARM64 |
| Docker | Immagine ufficiale localtonet/localtonet | AMD64, ARM64 |
| OpenWrt | Pacchetti per router OpenWrt 24.10 e 25.12+ (sperimentali) | x64, ARM64 |
| NAS e Home Assistant | Template di configurazione per Docker Compose e Home Assistant | AMD64, ARM64 |
| SSH senza installazione | Niente. Usi il client SSH che hai già. | Qualsiasi dispositivo con un client SSH |
Scegli il tipo di installazione #
| Opzione | Cos'è | Scegliila quando |
|---|---|---|
| Client da console | Il 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 desktop | L'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 mobile | L'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. |
| Pacchetto | Pacchetti 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. |
| Container | L'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 installazione | La 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 #
-
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.
-
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 comandilocaltonet --authtoken <YOUR_TOKEN>macOS
Bashbrew tap localtonet/tap brew install localtonet localtonet --authtoken <YOUR_TOKEN>Linux
Bashcurl -fsSL https://localtonet.com/install.sh | sh localtonet --authtoken <YOUR_TOKEN>Docker
Bashdocker 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, chiedePlease Enter AuthToken or PIN. -
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.
-
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:
Piattaforma Come Windows localtonet --install-service --authtoken <YOUR_TOKEN>in un terminale eseguito come amministratoremacOS, Linux sudo localtonet --install-service --authtoken <YOUR_TOKEN>Pacchetti DEB, RPM e OpenWrt Il pacchetto contiene il servizio. Lo abiliti dopo aver impostato il token. Android L'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.