Installa Localtonet su Windows
In questa pagina 9 sezioni
- Prima di iniziare
- Scegli una versione
- Usa l'app
- Installa e apri l'app
- Accedi con il tuo token
- Avvia un tunnel
- Usa il client da console
- Scarica ed estrai
- Avvialo con il tuo token
- Controlla la sessione
- Esegui come servizio di Windows
- Installa il servizio
- Verifica che sia in esecuzione
- Comandi del servizio
- Aggiornamento
- Disinstallazione
- Risoluzione dei problemi
- Pagine correlate
Su Windows puoi usare l'app Localtonet dal Microsoft Store, una versione portatile della stessa app oppure il client da console. Il client da console può anche installarsi come servizio di Windows che parte a ogni avvio.
Prima di iniziare #
- Un account Localtonet. Creane uno gratis se non ce l'hai.
- Il tuo AuthToken. Seleziona Copia nella scheda AuthToken della Dashboard, oppure copia un token da I miei token.
- Per il servizio di Windows: una finestra del Prompt dei comandi o di PowerShell eseguita come amministratore.
Scegli una versione #
| Versione | Download | Note |
|---|---|---|
| App del Microsoft Store | Localtonet nel Microsoft Store | Una finestra dell'app con una schermata di accesso. Richiede Windows 10 versione 1809 (build 17763) o successiva. |
| App desktop, ZIP portatile | x64, x86, ARM64 | La stessa app senza lo Store. Estrai lo ZIP e avvia l'app dalla cartella estratta. |
| Client da console | 64 bit, 32 bit, ARM64 | Uno ZIP che contiene un solo file, localtonet.exe. È la versione che offre i comandi del servizio. |
La pagina Download offre l'app del Microsoft Store e le tre versioni da console sotto Binari.
Usa l'app #
-
Installa e apri l'app #
Installa Localtonet dal Microsoft Store, oppure estrai lo ZIP portatile e avvia l'app. L'app si apre sulla schermata Sign in to Localtonet.
-
Accedi con il tuo token #
Incolla il tuo AuthToken nel campo Authtoken or PIN e seleziona Connect. Se il token è negli appunti quando si apre la schermata, l'app lo inserisce al posto tuo. Al posto del token puoi digitare il PIN di 6 cifre che I miei token mostra per un token. Un PIN è valido per un minuto.
Se l'app risponde
Pin or authtoken is not valid., copia di nuovo il token e verifica che ci siano tutti i 33 caratteri. -
Avvia un tunnel #
Dopo l'accesso, l'app elenca i tunnel in esecuzione su questo dispositivo. Finché l'elenco indica No active tunnels, crea e avvia un tunnel nella dashboard, vedi Avvio rapido. Sign Out rimuove il token dall'app, Quit Localtonet la chiude.
Usa il client da console #
-
Scarica ed estrai #
Scarica lo ZIP per la tua CPU ed estrailo in una cartella che resti dove si trova, ad esempio
C:\Localtonet. Un servizio che installi in seguito avvialocaltonet.exeda questa cartella. -
Avvialo con il tuo token #
Apri il Prompt dei comandi o PowerShell in quella cartella ed esegui:
Prompt dei comandilocaltonet --authtoken <YOUR_TOKEN>PowerShell esegue un programma dalla cartella corrente solo se scrivi il percorso, quindi lì il comando è:
PowerShell.\localtonet --authtoken <YOUR_TOKEN>Il client memorizza il token in locale. La volta successiva puoi avviarlo con il solo
localtonet. Se lo avvii senza un token memorizzato, chiedePlease Enter AuthToken or PIN. -
Controlla la sessione #
La finestra mostra
Session Status: Connectedsopra una tabella con una riga per ogni tunnel in esecuzione:IP/Url,Protocol,Client IP,Client Port,PingeStatus. La tabella resta vuota finché non avvii un tunnel nella dashboard. Il nome del tuo token compare sotto la tabella.Premi Ctrl + C per fermare il client. Premi F12 per rimuovere il token memorizzato e uscire.
Esegui come servizio di Windows #
Un servizio avvia Localtonet a ogni avvio del computer, lo mantiene in esecuzione dopo che esci dall'account e non richiede un terminale aperto. Esegui questi comandi con il client da console, nel Prompt dei comandi o in PowerShell eseguito come amministratore.
-
Installa il servizio #
Prompt dei comandi (amministratore)localtonet --install-service --authtoken <YOUR_TOKEN>Il comando registra un servizio di Windows per questo token, imposta il tipo di avvio su automatico e lo avvia subito. Risponde con il nome del servizio:
[CLI] Installed service 'Localtonet_<TOKEN_PREFIX>'<TOKEN_PREFIX>sono i primi 9 caratteri del tuo token. Ogni token ha un proprio servizio, quindi gli altri comandi del servizio richiedono lo stesso--authtokenper trovarlo. -
Verifica che sia in esecuzione #
Prompt dei comandi (amministratore)localtonet --status-service --authtoken <YOUR_TOKEN>Un servizio in esecuzione risponde
[CLI] Service 'Localtonet_<TOKEN_PREFIX>' status: Running. Il servizio è visibile anche inservices.msccon lo stesso nome, con la descrizioneLocaltonet Service. Nella dashboard, il token mostra Online in I miei token.
Comandi del servizio #
Aggiungi --authtoken <YOUR_TOKEN> a ogni comando.
| Comando | Cosa fa | Richiede i privilegi di amministratore |
|---|---|---|
--install-service | Crea il servizio con avvio automatico e lo avvia. Windows riavvia il servizio un minuto dopo un errore. | Sì |
--start-service | Avvia il servizio installato, ad esempio dopo che lo hai fermato. | Sì |
--stop-service | Ferma il servizio. Riparte al successivo avvio del computer. | Sì |
--status-service | Stampa lo stato: Running, Stopped, Installing mentre il servizio si avvia, Paused, NotFound quando non esiste alcun servizio per questo token, Error o Unknown. | No |
--remove-service | Ferma il servizio e lo elimina. | Sì |
Il servizio viene installato con le opzioni che passi insieme a --install-service, quindi aggiungi a quel comando le opzioni del client come --net e --ip. Le opzioni sono elencate nel Riferimento CLI.
Il servizio esegue localtonet.exe dalla cartella in cui si trovava quando hai installato il servizio, con il token come parte del comando di avvio. Non spostare né eliminare il file finché il servizio è installato.
Aggiornamento #
- App del Microsoft Store: è il Microsoft Store ad aggiornare l'app.
- Client da console e app portatile: scarica lo ZIP aggiornato dalla pagina Download e sostituisci i vecchi file. Windows non permette di sostituire
localtonet.exementre è in esecuzione, quindi chiudi prima il client. Se è in esecuzione come servizio, esegui--stop-service, sostituisci il file, poi esegui--start-service.
localtonet --version stampa la versione installata. In I miei token, la colonna Client mostra la versione che il dispositivo ha riportato per ultima e un badge Aggiornamento necessario quando ne è disponibile una più recente.
Disinstallazione #
- Se hai installato il servizio, rimuovilo:
localtonet --remove-service --authtoken <YOUR_TOKEN>come amministratore. - Per rimuovere il token memorizzato, avvia il client da console e premi F12.
- Elimina la cartella con
localtonet.exe, oppure disinstalla l'app dello Store da Impostazioni di Windows.
Risoluzione dei problemi #
'localtonet' is not recognized
Il terminale non si trova nella cartella che contiene localtonet.exe, oppure sei in PowerShell. Spostati prima nella cartella. In PowerShell, avvia il client come .\localtonet.
Install failed: 'Windows service installation' requires elevated (admin/root) privileges.
Il terminale non è eseguito come amministratore. Apri il Prompt dei comandi o PowerShell con Esegui come amministratore e ripeti il comando. --start-service, --stop-service e --remove-service rispondono con lo stesso tipo di messaggio.
Install failed: Service 'Localtonet_…' already exists.
Un servizio per questo token è già installato. Verificalo con --status-service. Per installarlo di nuovo, ad esempio con altre opzioni o da un'altra cartella, esegui prima --remove-service.
Start failed: Service could not be started
Il messaggio include la risposta dello strumento sc di Windows. L'errore 1056 significa che il servizio è già in esecuzione. È previsto quando esegui --start-service subito dopo --install-service, perché il comando di installazione avvia già il servizio. L'errore 1060 significa che non esiste alcun servizio per questo token.
Lo stato è NotFound, ma ho installato il servizio
Il nome del servizio deriva dal token. Se passi un token diverso da quello con cui hai installato il servizio, il client cerca un servizio diverso. Usa lo stesso token, oppure cerca in services.msc un servizio che inizia con Localtonet_.
Service installation cannot persist proxy passwords.
Hai combinato --install-service con --proxy-user o con un URL proxy che contiene una password. Un servizio non viene installato con password proxy. Usa --proxy env e fornisci le credenziali nell'ambiente del servizio. Vedi il Riferimento CLI.
Wrong Token!
Il client si aspetta l'AuthToken di 33 caratteri da I miei token, oppure un PIN di 6 cifre non scaduto. Copia di nuovo il token e inseriscilo al prompt.
This token is used in another localtonet application!
Un'altra finestra di Localtonet su questo computer è già in esecuzione con lo stesso token. Chiudila, oppure avvia questa con un token diverso. Usa un solo client in esecuzione per token.
Il token resta Offline nella dashboard
Offline significa che il dispositivo è disconnesso. Verifica che la finestra del client sia ancora aperta o che lo stato del servizio sia Running, e che il client sia stato avviato con il token che stai guardando.