Come installare Headscale su Saplo: rete privata con client Tailscale

Un laptop a casa, un server in ufficio e un computer di prova da un collaboratore devono funzionare in un'unica rete privata, anche se ogni dispositivo utilizza una connessione diversa. Headscale ti consente di gestire una rete di questo tipo dal tuo server di coordinamento. In questo tutorial, ti mostreremo come configurare Headscale su Saplo, collegare i primi dispositivi e verificare la comunicazione tra di essi.

Cos'è Headscale

Headscale è un'implementazione open source di un server di coordinamento per i client Tailscale. Sui tuoi dispositivi, installi il client Tailscale, ma lo configuri per puntare al tuo server Headscale. Il progetto è destinato principalmente a reti personali e piccole organizzazioni. L'ambito del progetto è descritto nella documentazione ufficiale di Headscale.

Questa soluzione è ideale per un amministratore di laboratorio domestico, uno sviluppatore che lavora su più macchine o un piccolo team. Ti consigliamo di iniziare con due dei tuoi dispositivi prima di aggiungere l'hardware dei collaboratori e stabilire le regole di accesso.

L'installazione di Headscale non fornisce automaticamente l'accesso alla rete privata di Box Saplo. Il server coordina i dispositivi che tu stesso vi registri. Il semplice fatto di eseguire l'applicazione su un Box non rende il Box un partecipante a quella rete.

Requisiti e hosting Headscale su Saplo

Il piano più economico che soddisfa i requisiti di installazione è il Box S a 27 € all'anno. La ricetta Headscale richiede un minimo di 256 MB di RAM e 2 GB di spazio su disco. Se sul Box sono in esecuzione altre applicazioni, controlla anche le risorse libere rimanenti. La descrizione del servizio è disponibile sulla pagina di hosting Headscale su Saplo.

Prepara un Box attivo, il nome dell'applicazione, il suo indirizzo di destinazione e due dispositivi per tentare la connessione. Box S fornisce il pannello e SFTP, senza SSH. L'installazione può essere eseguita dal pannello e il file con le istruzioni di avvio può essere scaricato dalla directory dell'applicazione tramite SFTP. I comandi del client Tailscale di questo tutorial vengono eseguiti sul tuo computer, non sul Box.

Installazione passo dopo passo

1. Accedi al Pannello Saplo e vai al Catalogo delle applicazioni.
2. Seleziona Headscale e avvia la creazione dell'applicazione.
3. Assegnale un nome, ad esempio my-network, e indica un Box con risorse libere.
4. Scegli un Dominio o un sottodominio disponibile *.saploapp.pl. Mantieni l'indirizzo esatto visualizzato nel pannello.
5. Conferma l'installazione e attendi il completamento della distribuzione. Controlla lo Stato e i messaggi dell'applicazione, invece di presumere un tempo di attesa specifico.
6. Connettiti tramite SFTP, utilizzando i dati di accesso del tuo Box, e cerca il file HEADSCALE-SETUP.txt nella directory di questa applicazione. Scaricalo sul tuo computer e aprilo come testo.

L'installatore prepara il servizio Headscale, un database SQLite locale, la configurazione e l'utente iniziale admin. Non è necessario creare un database separato. L'indirizzo HTTPS è l'indirizzo del server di coordinamento, non un pannello di gestione nel browser. Questa installazione non include un pannello grafico Headscale separato.

Chiave iniziale e primo dispositivo

Il file HEADSCALE-SETUP.txt contiene l'indirizzo del server e il comando di connessione con la chiave generata. La chiave iniziale è valida per 24 ore dalla generazione e può essere utilizzata più volte in questo periodo. Tratta l'intero file come dati di accesso: non pubblicarlo in un repository o in screenshot.

Sul primo computer Linux, installa il client dal sito ufficiale di Tailscale. Quindi, esegui il comando dal file iniziale nel terminale, con i permessi richiesti dal sistema. Lo schema è il seguente:

sudo tailscale up --login-server=https://YOUR-HEADSCALE-ADDRESS --authkey=KEY-FROM-FILE

Sostituisci entrambi i campi di esempio con i tuoi valori. Non inserire qui la password del Pannello Saplo. Il metodo di registrazione con una chiave è descritto nella documentazione di avvio del client Headscale.

Se il computer è già connesso a un'altra rete Tailscale, pianifica il cambiamento con consapevolezza. Non cambiare in questo modo l'unica connessione remota alla macchina. Per il primo tentativo, scegli un hardware a cui hai anche accesso locale.

Se il file indica che la chiave non è stata generata o che la chiave è scaduta, è necessaria una nuova chiave creata sul lato Headscale. Box S non fornisce SSH per eseguire comandi amministrativi dal file. In tal caso, contatta il Supporto Saplo per ulteriore configurazione, fornendo il nome dell'applicazione e il messaggio, senza inviare la chiave. Non rimuovere un'installazione funzionante solo per ripetere la registrazione del dispositivo.

Secondo dispositivo e verifica della connessione

Sul secondo computer Linux, installa il client e specifica lo stesso indirizzo server. Entro il periodo di validità della chiave di avvio, puoi usarla di nuovo per questa prova. Per Windows, Android e i dispositivi Apple, fai riferimento alle istruzioni specifiche della piattaforma nella Documentazione client di Headscale; il modo per specificare il tuo server dipende dal sistema.

Su entrambi i computer, controlla lo stato del client e l'indirizzo assegnato:

tailscale status
tailscale ip -4

Successivamente, sul primo computer, esegui, sostituendo l'indirizzo del secondo:

tailscale ping SECOND-DEVICE-ADDRESS

Questi comandi sono descritti nella Documentazione CLI di Tailscale. Controlla anche il servizio specifico che intendi utilizzare, ad esempio la connessione SSH al tuo server tramite il suo indirizzo nella rete VPN. Il servizio deve essere in esecuzione e il suo accesso consentito dal firewall e dalle regole di rete. La sola comparsa del dispositivo nell'elenco non conferma il funzionamento dell'applicazione.

È consigliabile ripetere il test con diverse connessioni internet, ad esempio con il secondo computer collegato tramite l'hotspot del telefono. Salva il risultato e controlla la riconnessione dopo il riavvio del client.

Cosa succede al traffico e all'accesso

La ricetta di Saplo utilizza la mappa dei relay pubblici DERP di Tailscale e non esegue il proprio DERP. Un proprio server di coordinamento non significa quindi che l'intera installazione sia indipendente dall'infrastruttura di Tailscale. Non considerare i parametri di Box come garanzia della larghezza di banda della connessione tra i dispositivi.

Prima di aggiungere un team, pianifica utenti separati, regole di accesso e come rimuovere i dispositivi non utilizzati. L'utente iniziale comune serve per iniziare a lavorare, ma non sostituisce la divisione finale dei permessi. Conserva una copia sicura della configurazione e dei dati di Headscale. Il solo file con la chiave di avvio non è un backup del servizio.

Domande frequenti

Quanto costa l'hosting Headscale?

Per iniziare, un Box S è sufficiente a 27 € all'anno. Se condividi il Box con altre applicazioni, tieni conto del loro consumo di memoria e disco.

Perché non vedo il pannello di accesso sotto il Dominio?

Questa installazione fornisce un server di coordinamento senza un pannello di amministrazione grafico. Inizia con lo stato dell'applicazione e il file HEADSCALE-SETUP.txt, e controlla il funzionamento della rete dal client Tailscale.

Perché il dispositivo non si unisce?

Confronta l'indirizzo del server con il file di avvio, controlla la disponibilità HTTPS e la validità della chiave. Assicurati che il client non stia tentando di accedere al servizio Tailscale predefinito. Conserva il contenuto dell'errore, rimuovendo le chiavi prima di inoltrarlo al Supporto.

Headscale sostituisce il client Tailscale?

No. Sui dispositivi continui a usare il client Tailscale. Headscale funge da tuo server di coordinamento.

È necessario aprire SSH sul Box per iniziare?

Non per l'installazione dal catalogo e il primo collegamento usando una chiave correttamente generata. La successiva gestione di utenti, chiavi e politiche di accesso richiede attività amministrative sul lato Headscale. Consideralo quando pianifichi l'uso permanente del servizio su Box S senza SSH.

Apri l'offerta Headscale su Saplo, avvia l'applicazione e inizia collegando due dei tuoi dispositivi. Solo dopo aver verificato la comunicazione e le regole di accesso, collega altre macchine.