Collegare i propri server con Tailscale
Installare Tailscale su Debian o Ubuntu, collegare più server in una rete privata, scrivere regole di accesso e riservare SSH a questa rete con UFW.
In questa pagina
I tuoi valori
Inseriscili una volta: i comandi della guida si aggiornano.
Questa guida spiega come collegare i tuoi server e la tua postazione di lavoro con Tailscale. Ogni macchina riceve un indirizzo privato in 100.x.y.z e comunica con le altre in un tunnel WireGuard cifrato, senza che tu debba gestire le chiavi né aprire una porta per ogni collegamento.
Al termine della guida, i tuoi server dialogano su questa rete privata, chiamata tailnet, sono autorizzati solo gli accessi che hai definito e SSH non è più raggiungibile dall'indirizzo pubblico.
Ordina un Server
Questa guida si applica ai server che amministri tu stesso:
Prerequisiti
- Uno o più server con Debian 12 o 13, oppure Ubuntu 22.04 o 24.04
- Un accesso SSH con un utente che dispone di
sudo - Un account Tailscale
- Tailscale installato sulla tua postazione di lavoro, dalla pagina di download
- Un accesso di emergenza al server, come la console VNC del tuo VPS o la modalità rescue
La guida chiama i server web-1 e db-1.
Porte utilizzate
In genere Tailscale non richiede nessuna porta in entrata: le macchine aprono connessioni in uscita.
| Porta | Direzione | Ruolo |
|---|---|---|
| 443/tcp | In uscita | Servizio di coordinamento e relay DERP |
| 41641/udp (sorgente) | In uscita | Tunnel WireGuard diretti |
| 3478/udp | In uscita | STUN, per scoprire l'indirizzo pubblico |
| 41641/udp | In entrata, facoltativa | Favorisce le connessioni dirette |
Passo 1: installare Tailscale
Su ogni server, aggiungi il repository ufficiale corrispondente al tuo sistema, poi installa il pacchetto:
. /etc/os-release
sudo mkdir -p --mode=0755 /usr/share/keyrings
curl -fsSL "https://pkgs.tailscale.com/stable/${ID}/${VERSION_CODENAME}.noarmor.gpg" | sudo tee /usr/share/keyrings/tailscale-archive-keyring.gpg >/dev/null
curl -fsSL "https://pkgs.tailscale.com/stable/${ID}/${VERSION_CODENAME}.tailscale-keyring.list" | sudo tee /etc/apt/sources.list.d/tailscale.list
sudo apt-get update
sudo apt-get install -y tailscale
tailscale versionPasso 2: connettere i server
Avvia la connessione, poi apri nel browser l'URL mostrato per autorizzare la macchina:
sudo tailscale upAssegna poi un nome chiaro a ogni server, qui web-1 al primo e db-1 al secondo:
sudo tailscale set --hostname=web-1Annota il suo indirizzo Tailscale e mostra le macchine della tailnet:
tailscale ip -4
tailscale statusPasso 3: verificare il collegamento
Da web-1, testa db-1:
tailscale ping db-1
ping -c 3 db-1La risposta di tailscale ping indica il percorso usato. via DERP(...) segnala un passaggio da un relay, mentre un indirizzo IP:port indica una connessione diretta. I nomi brevi si basano su MagicDNS, attivo per impostazione predefinita sulle tailnet recenti. Se db-1 non viene risolto, usa il suo indirizzo 100.x.y.z.
Passo 4: evitare la scadenza dei server
La chiave di una macchina scade per impostazione predefinita dopo 180 giorni. Un server la cui chiave scade esce dalla tailnet, il che è un problema se SSH non è più accessibile in altro modo.
Nella pagina Machines, apri il menu a destra di ogni server, poi scegli Disable Key Expiry.
Passo 5: etichettare i server
I tag danno ai server un'identità indipendente dal tuo account. Permettono di scrivere regole leggibili.
Apri la pagina Access controls. Aggiungi queste due sezioni al file esistente, oppure completale se sono già presenti, senza rimuovere il resto. Sostituisci TAILSCALE_EMAIL con l'indirizzo esatto del tuo account, poi salva:
"groups": {
"group:admins": ["TAILSCALE_EMAIL"]
},
"tagOwners": {
"tag:server": ["group:admins"]
},Torna in Machines. Nel menu di ogni server, scegli Edit tags, aggiungi tag:server, poi salva.
Passo 6: limitare gli accessi
Per impostazione predefinita, tutte le macchine della tailnet possono raggiungersi. Sostituisci il contenuto del file delle policy con questo per autorizzare solo il necessario:
{
"groups": {
"group:admins": ["TAILSCALE_EMAIL"]
},
"tagOwners": {
"tag:server": ["group:admins"]
},
"acls": [],
"grants": [
{
"src": ["group:admins"],
"dst": ["tag:server"],
"ip": ["tcp:22", "icmp:*"]
},
{
"src": ["tag:server"],
"dst": ["tag:server"],
"ip": ["tcp:5432", "icmp:*"]
}
],
"tests": [
{
"src": "group:admins",
"proto": "tcp",
"accept": ["tag:server:22"]
},
{
"src": "tag:server",
"proto": "tcp",
"accept": ["tag:server:5432"],
"deny": ["tag:server:22"]
}
]
}| Sezione | Ruolo |
|---|---|
groups |
Raggruppa gli account autorizzati |
tagOwners |
Indica chi può assegnare ogni tag |
acls |
Forma storica delle regole. Qui è vuota: evita di ricadere nella policy predefinita che autorizza tutto |
grants |
Forma consigliata delle regole di accesso. Tutto ciò che non vi compare è negato |
tests |
Controlli eseguiti a ogni salvataggio. Il file viene rifiutato se uno di essi fallisce |
Con questo esempio, i tuoi dispositivi raggiungono i server in SSH e i server comunicano tra loro sulla porta 5432, quella di PostgreSQL. Sostituisci questa porta con quelle dei tuoi servizi. Per più porte, scrivi ad esempio "ip": ["tcp:5432", "tcp:6379"].
Controlla poi il risultato da web-1. Il comando sulla porta 22 deve fallire:
sudo apt-get install -y netcat-openbsd
nc -vz -w 3 db-1 5432
nc -vz -w 3 db-1 22Il test della porta 5432 riesce solo se un servizio vi è in ascolto su un indirizzo raggiungibile da Tailscale. Dal tuo computer, ssh TUO_USER@web-1 deve funzionare.
Passo 7: riservare SSH alla rete privata
Dal tuo computer, apri prima una sessione tramite Tailscale:
ssh TUO_USER@web-1In questa sessione, autorizza l'interfaccia Tailscale e applica le policy predefinite:
sudo ufw allow in on tailscale0
sudo ufw default deny incoming
sudo ufw default allow outgoing
sudo ufw enable
sudo ufw status numberedConferma l'attivazione di UFW rispondendo y. Il filtraggio tra le macchine della tailnet è garantito dalle regole del passo 6. Se il server pubblica un sito, mantieni o aggiungi le regole 80/tcp e 443/tcp.
Rimuovi poi la regola SSH pubblica, se esiste:
sudo ufw delete allow 22/tcp
sudo ufw status verboseSe la tua regola ha un altro nome, come OpenSSH, usa sudo ufw delete allow OpenSSH.
Verificare il risultato
Apri una nuova sessione tramite Tailscale. Deve andare a buon fine:
ssh TUO_USER@web-1Da una macchina fuori dalla tailnet, oppure dopo aver arrestato Tailscale sul tuo computer, la connessione all'indirizzo pubblico deve andare in timeout:
ssh -o ConnectTimeout=5 TUO_USER@IP_DEL_TUO_SERVEROpzione: usare Tailscale SSH
Con Tailscale SSH, l'autenticazione si basa sulla tua identità Tailscale anziché sulle chiavi SSH. OpenSSH e i suoi file non vengono modificati, ma Tailscale prende in carico la porta 22 sull'indirizzo Tailscale.
Aggiungi questa sezione al file delle policy, indicando l'account Linux autorizzato:
"ssh": [
{
"action": "accept",
"src": ["group:admins"],
"dst": ["tag:server"],
"users": ["TUO_USER"]
}
],La regola tcp:22 del passo 6 resta necessaria. Attiva poi la funzione sul server. Le sessioni SSH già aperte sull'indirizzo Tailscale si bloccheranno: riconnettiti in seguito.
sudo tailscale set --sshPer tornare indietro, usa sudo tailscale set --ssh=false.
Aggiungere un server senza browser
Una chiave di autenticazione evita di aprire l'URL. Creala nella pagina Keys della console, preferibilmente monouso e con il tag tag:server, poi usala sul nuovo server:
sudo tailscale up --auth-key=TAILSCALE_AUTH_KEYTratta questa chiave come una password e non lasciarla né in uno script né nella cronologia della shell. La sua validità è di 90 giorni al massimo.
Aggiornare
Aggiorna il pacchetto con APT:
sudo apt-get update
sudo apt-get install --only-upgrade -y tailscale
tailscale versionPuoi anche attivare gli aggiornamenti automatici:
sudo tailscale set --auto-updateIl riavvio di Tailscale interrompe le sessioni Tailscale SSH e può disturbare le sessioni che passano dalla tailnet. Esegui l'aggiornamento in tmux o screen se Tailscale è il tuo unico accesso.
Backup
Il server conserva la propria identità in /var/lib/tailscale/tailscaled.state. Questo file contiene chiavi: non è necessario farne il backup, perché basta riconnettere la macchina con sudo tailscale up dopo una reinstallazione. Non copiarlo su un'altra macchina.
L'elemento da conservare è il tuo file delle policy. Tienine una copia aggiornata in un repository privato o in un archivio sicuro di documenti.
In caso di problemi
Failed to connect to local Tailscale daemon
Il servizio non è avviato:
sudo systemctl enable --now tailscaled
sudo journalctl -u tailscaled --no-pager -n 50Se i log menzionano /dev/net/tun, il sistema non ha accesso al dispositivo TUN. Questo caso riguarda soprattutto i sistemi eseguiti in un container.
Logged out. o Tailscale is stopped.
La macchina è disconnessa oppure la sua chiave è scaduta. Riavvia sudo tailscale up, poi disattiva la scadenza come indicato al passo 4.
changing settings via 'tailscale up' requires mentioning all non-default flags
tailscale up si aspetta tutti i parametri già personalizzati. Per modificare una sola impostazione, usa tailscale set, ad esempio sudo tailscale set --hostname=web-1.
La connessione passa da un relay
In tailscale status, la dicitura relay indica che il traffico non passa direttamente. Il servizio resta utilizzabile, con prestazioni a volte inferiori. Analizza la rete, poi apri la porta facoltativa se necessario:
tailscale netcheck
sudo ufw allow 41641/udpIl ping funziona, ma il servizio no
- Verifica che una regola
grantsautorizzi questa porta tra queste macchine. - Verifica che il servizio non ascolti solo su
127.0.0.1:sudo ss -ltnp. - Verifica il tag della macchina nella console.
Il file delle policy viene rifiutato
Leggi il messaggio mostrato dalla console. Segnala un errore di sintassi, oppure un test della sezione tests che non corrisponde alle regole. Un tag deve inoltre essere dichiarato in tagOwners prima di essere usato.
I nomi DNS del server non vengono più risolti
Tailscale può gestire il DNS della macchina. Se questo ostacola la tua configurazione, disattiva questa gestione. I nomi brevi non funzioneranno più su questo server: usa allora gli indirizzi 100.x.y.z.
sudo tailscale set --accept-dns=falseNon hai più accesso in SSH
Connettiti tramite il tuo accesso di emergenza, poi ripristina temporaneamente la regola pubblica. Correggi Tailscale, poi rimuovi questa regola:
sudo ufw allow 22/tcp
sudo tailscale status
sudo tailscale up