Installa Localtonet su Linux
In questa pagina 9 sezioni
- Prima di iniziare
- Installa con lo script
- Esegui lo script di installazione
- Verifica l'installazione
- Installa manualmente
- Scarica ed estrai
- Facoltativo: spostalo nel tuo PATH
- Avvia il client
- Avvialo con il tuo token
- Controlla la sessione
- Esegui come servizio systemd
- Installa il servizio
- Verifica che sia in esecuzione
- Comandi del servizio
- La unit e i suoi log
- Aggiornamento
- Sostituisci il client
- Riavvia il servizio
- Disinstallazione
- Risoluzione dei problemi
- Pagine correlate
Su Linux il client Localtonet è un singolo programma da console. Installalo con lo script di installazione o da un archivio ZIP, avvialo con il tuo AuthToken e installalo come servizio systemd se deve partire a ogni riavvio.
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.
curlowget, eunzip.- Per il servizio systemd: accesso root e una distribuzione che usa systemd.
Altri modi per eseguire Localtonet su Linux. Su Debian, Ubuntu, Fedora e RHEL puoi installare un pacchetto DEB o RPM che include i propri servizi. Esistono guide separate per Docker, per i router OpenWrt e per Termux su Android.
Installa con lo script #
-
Esegui lo script di installazione #
Terminalecurl -fsSL https://localtonet.com/install.sh | shLo script rileva la tua CPU (x64, ARM64 o ARM) e se il sistema usa glibc o musl, scarica la versione corrispondente e la installa in
/usr/local/bin/localtonet. Crea anche il collegamento/usr/bin/localtonet, in modo chesudo localtonetfunzioni sulle distribuzioni in cuisudonon cerca in/usr/local/bin.Lo script usa
sudoquando il tuo utente non può scrivere nella cartella di installazione, per questo può chiederti la password. Se mancaunzip, prova a installarlo con il gestore di pacchetti della tua distribuzione. -
Verifica l'installazione #
Lo script termina stampando la versione installata. Puoi stamparla di nuovo in qualsiasi momento:
Terminalelocaltonet --version
Installa manualmente #
Se preferisci un download diretto, prendi l'archivio per il tuo sistema. Ogni ZIP contiene un solo file, localtonet.
| CPU | glibc (Debian, Ubuntu, Fedora, RHEL e la maggior parte delle altre) | musl (Alpine) |
|---|---|---|
| x64 | localtonet-linux-x64.zip | localtonet-linux-musl-x64.zip |
| ARM64 | localtonet-linux-arm64.zip | localtonet-linux-musl-arm64.zip |
| ARM (32 bit) | localtonet-linux-arm.zip | localtonet-linux-musl-arm.zip |
uname -m stampa il tipo di CPU: x86_64 è x64, aarch64 è ARM64 e armv7l è ARM.
-
Scarica ed estrai #
L'esempio usa la versione x64 glibc. Sostituisci il nome del file con l'archivio per il tuo sistema.
Terminalewget https://localtonet.com/download/localtonet-linux-x64.zip unzip localtonet-linux-x64.zip -d ~/localtonet chmod 755 ~/localtonet/localtonet -
Facoltativo: spostalo nel tuo PATH #
Senza questo passaggio avvii il client con il suo percorso,
~/localtonet/localtonet. Dopo averlo fatto puoi digitarelocaltonetin qualsiasi cartella.Terminalesudo mv ~/localtonet/localtonet /usr/local/bin/localtonet
Avvia il client #
-
Avvialo con il tuo token #
Terminalelocaltonet --authtoken <YOUR_TOKEN>Il client memorizza il token in locale per il tuo utente. La volta successiva puoi avviarlo con il solo
localtonet. Se lo avvii senza un token memorizzato, chiedePlease Enter AuthToken or PIN. -
Controlla la sessione #
Il terminale 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, vedi Avvio rapido.Premi Ctrl + C per fermare il client. Premi F12 per rimuovere il token memorizzato e uscire.
Quando l'output non è un terminale, ad esempio quando lo reindirizzi a un file, il client scrive una semplice riga per ogni modifica al posto della tabella.
La VPN richiede root. Se il dispositivo fa parte di una rete Gestore VPN e il client viene eseguito senza root, la riga VPN della tabella mostra Admin rights required. In tal caso avvia il client con sudo o come servizio.
Esegui come servizio systemd #
Un servizio avvia Localtonet a ogni riavvio, lo mantiene in esecuzione dopo che esci dalla sessione e non richiede un terminale aperto. I comandi del servizio richiedono root.
-
Installa il servizio #
Terminalesudo localtonet --install-service --authtoken <YOUR_TOKEN>Il comando scrive una unit systemd per questo token, la abilita e la avvia subito. Risponde con il nome della unit:
[CLI] Installed service 'Localtonet_<TOKEN_PREFIX>'<TOKEN_PREFIX>sono i primi 9 caratteri del tuo token. Ogni token ha una propria unit, quindi gli altri comandi del servizio richiedono lo stesso--authtokenper trovarla. -
Verifica che sia in esecuzione #
Terminalesudo localtonet --status-service --authtoken <YOUR_TOKEN>Un servizio in esecuzione risponde
[CLI] Service 'Localtonet_<TOKEN_PREFIX>' status: Running. Nella dashboard, il token mostra Online in I miei token.
Comandi del servizio #
Esegui ogni comando con sudo e aggiungi --authtoken <YOUR_TOKEN>.
| Comando | Cosa fa |
|---|---|
--install-service | Scrive il file della unit, abilita la unit e la avvia. |
--start-service | Avvia la unit, ad esempio dopo che l'hai fermata. |
--stop-service | Ferma la unit. Resta abilitata e riparte dopo un riavvio. |
--status-service | Stampa lo stato, ad esempio Running, Stopped o Error quando la unit è in errore. |
--remove-service | Ferma e disabilita la unit ed elimina il file della unit. |
Il servizio viene installato con le opzioni che passi insieme a --install-service. Le opzioni sono elencate nel Riferimento CLI.
La unit e i suoi log #
Il file della unit è /etc/systemd/system/Localtonet_<TOKEN_PREFIX>.service. systemd riavvia il client cinque secondi dopo un errore. Poiché è una normale unit systemd, puoi anche gestirla con systemctl e leggerne l'output con journalctl:
systemctl list-units 'Localtonet_*'
systemctl status Localtonet_<TOKEN_PREFIX>
journalctl -u Localtonet_<TOKEN_PREFIX> -fLa unit avvia il file localtonet dal percorso che aveva quando hai installato il servizio. Con una eccezione: se quel percorso si trova sotto /root/, il comando di installazione copia il file in /usr/local/lib/Localtonet_<TOKEN_PREFIX>/ e il servizio esegue la copia.
Aggiornamento #
-
Sostituisci il client #
Esegui di nuovo lo script di installazione. Si può rieseguire senza rischi e sovrascrive il client installato con la versione attuale. Dopo un'installazione manuale, scarica l'archivio aggiornato e sostituisci il file
localtonet.Terminalecurl -fsSL https://localtonet.com/install.sh | sh -
Riavvia il servizio #
Un servizio in esecuzione continua a usare la vecchia versione finché non viene riavviato.
Terminalesudo systemctl restart Localtonet_<TOKEN_PREFIX>Se il servizio esegue una copia sotto
/usr/local/lib/, rimuovi il servizio e installalo di nuovo con il nuovo client.
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:
sudo localtonet --remove-service --authtoken <YOUR_TOKEN> - Per rimuovere il token memorizzato, avvia il client e premi F12.
- Elimina il client:
sudo rm /usr/local/bin/localtonet /usr/bin/localtonetdopo l'installazione con lo script, oppure la cartella in cui hai estratto l'archivio.
Risoluzione dei problemi #
Install script: Unsupported architecture
Lo script ha versioni per x64 (x86_64), ARM64 (aarch64) e ARM a 32 bit (armv7l). Gli altri tipi di CPU non sono supportati dalle versioni Linux.
Install script: Neither curl nor wget found
Installa curl o wget con il tuo gestore di pacchetti ed esegui di nuovo lo script.
Install script: Failed to install 'unzip'
Lo script non è riuscito a installare unzip da solo. Installalo con il tuo gestore di pacchetti ed esegui di nuovo lo script.
Installed but not found in PATH
Apri una nuova shell, oppure avvia il client con il suo percorso completo, /usr/local/bin/localtonet.
sudo: localtonet: command not found
Dopo un'installazione manuale il client non si trova nel percorso di ricerca di sudo. Usa il percorso completo, ad esempio sudo ~/localtonet/localtonet --install-service --authtoken <YOUR_TOKEN>, oppure sposta prima il file in /usr/local/bin.
Install failed: 'Linux systemd service installation' requires elevated (admin/root) privileges.
Il comando è stato eseguito senza root. Ripetilo con sudo. Lo stesso vale per --start-service, --stop-service e --remove-service.
Install failed: Systemd unit already exists for 'Localtonet_…'
Un servizio per questo token è già installato. Verificalo con --status-service. Per installarlo di nuovo, esegui prima --remove-service.
I comandi del servizio falliscono su un sistema senza systemd
La modalità servizio usa systemd. Sui sistemi che non lo hanno, avvia il client in un altro modo, ad esempio in un container Docker. Il client da console ha una modalità headless per questo scopo: --headless funziona senza prompt e legge il token da un file indicato con --authtoken-file. 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 altro client Localtonet su questa macchina è già in esecuzione con lo stesso token. Chiudilo, oppure avvia questo con un token diverso. Usa un solo client in esecuzione per token.