Vai al contenuto
Localtonet Localtonet Dashboard

Installa Localtonet su Linux

Aiuto su questa pagina
In questa pagina 9 sezioni
  1. Prima di iniziare
  2. Installa con lo script
  3. Esegui lo script di installazione
  4. Verifica l'installazione
  5. Installa manualmente
  6. Scarica ed estrai
  7. Facoltativo: spostalo nel tuo PATH
  8. Avvia il client
  9. Avvialo con il tuo token
  10. Controlla la sessione
  11. Esegui come servizio systemd
  12. Installa il servizio
  13. Verifica che sia in esecuzione
  14. Comandi del servizio
  15. La unit e i suoi log
  16. Aggiornamento
  17. Sostituisci il client
  18. Riavvia il servizio
  19. Disinstallazione
  20. Risoluzione dei problemi
  21. 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.
  • curl o wget, e unzip.
  • 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 #

  1. Esegui lo script di installazione #

    Terminale
    curl -fsSL https://localtonet.com/install.sh | sh

    Lo 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 che sudo localtonet funzioni sulle distribuzioni in cui sudo non cerca in /usr/local/bin.

    Lo script usa sudo quando il tuo utente non può scrivere nella cartella di installazione, per questo può chiederti la password. Se manca unzip, prova a installarlo con il gestore di pacchetti della tua distribuzione.

  2. Verifica l'installazione #

    Lo script termina stampando la versione installata. Puoi stamparla di nuovo in qualsiasi momento:

    Terminale
    localtonet --version

Installa manualmente #

Se preferisci un download diretto, prendi l'archivio per il tuo sistema. Ogni ZIP contiene un solo file, localtonet.

uname -m stampa il tipo di CPU: x86_64 è x64, aarch64 è ARM64 e armv7l è ARM.

  1. Scarica ed estrai #

    L'esempio usa la versione x64 glibc. Sostituisci il nome del file con l'archivio per il tuo sistema.

    Terminale
    wget https://localtonet.com/download/localtonet-linux-x64.zip
    unzip localtonet-linux-x64.zip -d ~/localtonet
    chmod 755 ~/localtonet/localtonet
  2. Facoltativo: spostalo nel tuo PATH #

    Senza questo passaggio avvii il client con il suo percorso, ~/localtonet/localtonet. Dopo averlo fatto puoi digitare localtonet in qualsiasi cartella.

    Terminale
    sudo mv ~/localtonet/localtonet /usr/local/bin/localtonet

Avvia il client #

  1. Avvialo con il tuo token #

    Terminale
    localtonet --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, chiede Please Enter AuthToken or PIN.

  2. Controlla la sessione #

    Il terminale mostra Session Status: Connected sopra una tabella con una riga per ogni tunnel in esecuzione: IP/Url, Protocol, Client IP, Client Port, Ping e Status. 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.

  1. Installa il servizio #

    Terminale
    sudo 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 --authtoken per trovarla.

  2. Verifica che sia in esecuzione #

    Terminale
    sudo 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>.

ComandoCosa fa
--install-serviceScrive il file della unit, abilita la unit e la avvia.
--start-serviceAvvia la unit, ad esempio dopo che l'hai fermata.
--stop-serviceFerma la unit. Resta abilitata e riparte dopo un riavvio.
--status-serviceStampa lo stato, ad esempio Running, Stopped o Error quando la unit è in errore.
--remove-serviceFerma 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:

Terminale
systemctl list-units 'Localtonet_*'
systemctl status Localtonet_<TOKEN_PREFIX>
journalctl -u Localtonet_<TOKEN_PREFIX> -f

La 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 #

  1. 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.

    Terminale
    curl -fsSL https://localtonet.com/install.sh | sh
  2. Riavvia il servizio #

    Un servizio in esecuzione continua a usare la vecchia versione finché non viene riavviato.

    Terminale
    sudo 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 #

  1. Se hai installato il servizio, rimuovilo: sudo localtonet --remove-service --authtoken <YOUR_TOKEN>
  2. Per rimuovere il token memorizzato, avvia il client e premi F12.
  3. Elimina il client: sudo rm /usr/local/bin/localtonet /usr/bin/localtonet dopo 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.

Supporto