IT

Applicazioni

Configurare una VPN WireGuard sul proprio server

Installare WireGuard su Debian o Ubuntu, aggiungere client Windows, macOS, Linux e mobile, configurare il routing e il firewall, poi riservare SSH alla VPN.

10 min di lettura, aggiornato il 18 novembre 2026

In questa pagina

I tuoi valori

Inseriscili una volta: i comandi della guida si aggiornano.

Questa guida spiega come trasformare il tuo server in un gateway WireGuard. I tuoi dispositivi vi si collegano tramite un tunnel cifrato. Possono poi raggiungere i servizi privati del server e, se vuoi, uscire su Internet con il suo indirizzo IP.

Al termine della guida hai una VPN che si avvia insieme al server, un primo client operativo e un metodo per aggiungere o revocare dispositivi.

Ordina un Server

Questa guida si applica ai server che amministri tu stesso:

Prerequisiti

  • Un server con Debian 12 o 13, oppure Ubuntu 22.04 o 24.04
  • Un accesso SSH con un utente che dispone di sudo
  • L'indirizzo IPv4 pubblico del server, indicato qui IP_DEL_TUO_SERVER
  • Un dispositivo client: Windows, macOS, Linux, Android o iOS

Piano di indirizzamento e porte

La guida usa i valori seguenti. Scegli un altro intervallo se 10.8.0.0/24 è già usato in una delle tue reti.

Elemento Valore
Interfaccia VPN wg0
Rete VPN 10.8.0.0/24
Indirizzo del server nella VPN 10.8.0.1
Primo client 10.8.0.2
Porta da aprire in entrata 51820/udp

Questa guida instrada l'IPv4 nel tunnel. La configurazione del client blocca anche l'IPv6 per evitare che aggiri la VPN.

Passo 1: installare WireGuard

WireGuard è integrato nel kernel Linux dei sistemi interessati. I pacchetti ufficiali della distribuzione forniscono gli strumenti wg e wg-quick. Apri una shell root, poi installali:

Terminale
sudo -i
apt update
apt install -y wireguard iptables qrencode

Salvo diversa indicazione, i comandi da eseguire sul server si lanciano in questa shell root.

Passo 2: attivare il routing IPv4

Il server deve poter inoltrare i pacchetti dei client verso Internet:

Terminale
cat > /etc/sysctl.d/99-wireguard.conf <<EOF
net.ipv4.ip_forward = 1
EOF
sysctl -p /etc/sysctl.d/99-wireguard.conf

Il comando deve mostrare net.ipv4.ip_forward = 1.

Passo 3: generare le chiavi del server

Terminale
cd /etc/wireguard
umask 077
wg genkey | tee server.key | wg pubkey > server.pub
IFACE=$(ip -4 route show default | awk '{print $5; exit}')
echo "$IFACE"

L'ultimo comando mostra l'interfaccia di rete pubblica, ad esempio eth0 o ens18. Se non mostra nulla, il server non ha una route IPv4 predefinita: correggi questo punto prima di continuare. Tieni aperta questa shell, perché la variabile IFACE serve al passo successivo.

Passo 4: creare la configurazione del server

Terminale
cat > /etc/wireguard/wg0.conf <<EOF
[Interface]
Address = 10.8.0.1/24
ListenPort = 51820
PrivateKey = $(cat /etc/wireguard/server.key)

PostUp = iptables -t nat -A POSTROUTING -s 10.8.0.0/24 -o $IFACE -j MASQUERADE
PostUp = iptables -I FORWARD -i %i -o $IFACE -j ACCEPT
PostUp = iptables -I FORWARD -i $IFACE -o %i -m conntrack --ctstate RELATED,ESTABLISHED -j ACCEPT
PreDown = iptables -t nat -D POSTROUTING -s 10.8.0.0/24 -o $IFACE -j MASQUERADE
PreDown = iptables -D FORWARD -i %i -o $IFACE -j ACCEPT
PreDown = iptables -D FORWARD -i $IFACE -o %i -m conntrack --ctstate RELATED,ESTABLISHED -j ACCEPT
EOF
chmod 600 /etc/wireguard/wg0.conf

Le righe PostUp vengono eseguite all'avvio del tunnel e le righe PreDown al suo arresto. Mascherano l'indirizzo dei client dietro quello del server e autorizzano il loro traffico ad attraversare la macchina. %i viene sostituito dal nome dell'interfaccia, qui wg0. Queste regole sono poste in testa alla catena FORWARD: si applicano anche quando UFW o Docker bloccano il transito per impostazione predefinita.

Passo 5: aprire il firewall

Se UFW è attivo, autorizza la porta di WireGuard:

Terminale
ufw allow 51820/udp
ufw status

Passo 6: avviare la VPN

Terminale
systemctl enable --now wg-quick@wg0
systemctl status wg-quick@wg0 --no-pager
wg show
ss -lun | grep 51820

wg show deve mostrare l'interfaccia wg0, la sua chiave pubblica e la porta 51820. Il servizio si riavvierà automaticamente insieme al server.

Passo 7: aggiungere un client

Scegli un nome e un indirizzo libero nella VPN. Per ogni nuovo client, cambia questi due valori:

Terminale
cd /etc/wireguard
umask 077
mkdir -p clients
CLIENT=laptop
CLIENT_IP=10.8.0.2
wg genkey | tee clients/$CLIENT.key | wg pubkey > clients/$CLIENT.pub
wg genpsk > clients/$CLIENT.psk

cat >> wg0.conf <<EOF

[Peer]
# $CLIENT
PublicKey = $(cat clients/$CLIENT.pub)
PresharedKey = $(cat clients/$CLIENT.psk)
AllowedIPs = $CLIENT_IP/32
EOF

systemctl reload wg-quick@wg0

Il ricaricamento applica l'elenco dei client senza interrompere quelli connessi. La chiave pre-condivisa è facoltativa in WireGuard: aggiunge un livello di cifratura simmetrica.

Crea poi il file destinato al dispositivo:

Terminale
cat > clients/$CLIENT.conf <<EOF
[Interface]
PrivateKey = $(cat clients/$CLIENT.key)
Address = $CLIENT_IP/32
DNS = 1.1.1.1, 9.9.9.9

[Peer]
PublicKey = $(cat server.pub)
PresharedKey = $(cat clients/$CLIENT.psk)
Endpoint = IP_DEL_TUO_SERVER:51820
AllowedIPs = 0.0.0.0/0, ::/0
PersistentKeepalive = 25
EOF

PersistentKeepalive = 25 mantiene aperto il tunnel quando il dispositivo si trova dietro un router domestico o una rete NAT.

Passo 8: collegare il dispositivo

Installa l'applicazione dalla pagina ufficiale di WireGuard, poi importa la configurazione.

Android e iOS

Mostra un QR code nel terminale, poi scansionalo dall'applicazione aggiungendo un tunnel:

Terminale
qrencode -t ansiutf8 < clients/$CLIENT.conf

Windows e macOS

Mostra il file:

Terminale
cat clients/$CLIENT.conf

Copia il suo contenuto in un file laptop.conf sul tuo computer, poi importalo nell'applicazione con Import tunnel(s) from file. Attiva quindi il tunnel.

Linux

Installa wireguard sul computer, poi copia la configurazione in /etc/wireguard/wg0.conf:

Terminale
sudo apt install -y wireguard
sudo nano /etc/wireguard/wg0.conf
sudo chmod 600 /etc/wireguard/wg0.conf
sudo wg-quick up wg0

Per arrestare il tunnel, usa sudo wg-quick down wg0.

Eliminare i segreti dal server

Una volta configurato il dispositivo, il server non ha più bisogno della sua chiave privata. Sul server:

Terminale
shred -u clients/$CLIENT.key clients/$CLIENT.psk clients/$CLIENT.conf

Verificare il funzionamento

Sul server, latest handshake deve comparire per il client, con contatori transfer che aumentano:

Terminale
wg show

Su un client Linux o macOS, testa il tunnel e poi l'indirizzo di uscita:

Terminale
ping -c 3 10.8.0.1
curl -4 https://ifconfig.me

Il ping deve rispondere e curl deve mostrare IP_DEL_TUO_SERVER. Su Windows, usa ping 10.8.0.1, poi consulta il tuo indirizzo IP pubblico in un browser.

Scegliere cosa passa nel tunnel

Il parametro AllowedIPs del client determina il traffico inviato nella VPN:

Esigenza AllowedIPs lato client
Tutto il traffico passa dal server 0.0.0.0/0, ::/0
Solo la rete VPN 10.8.0.0/24
La VPN e una rete privata del server 10.8.0.0/24, 192.168.50.0/24

Con ::/0, il traffico IPv6 entra nel tunnel ma non ne esce, perché questa guida instrada solo l'IPv4. Le applicazioni ripiegano quindi sull'IPv4, senza perdite fuori dalla VPN.

Per raggiungere una rete privata collegata al server, aggiungi anche righe PostUp e PreDown per questa interfaccia, sul modello del passo 4, poi riavvia il tunnel.

Lato server, AllowedIPs indica gli indirizzi che ogni client può usare. Mantieni un indirizzo /32 per client. Per raggiungere una rete situata dietro un client, aggiungila a questa riga, ad esempio AllowedIPs = 10.8.0.3/32, 192.168.1.0/24. Questo client deve a sua volta consentire il routing verso la sua rete.

Far comunicare i client tra loro

A seconda della policy della catena FORWARD, i client possono o meno raggiungersi. Per fissare questo comportamento, aggiungi una di queste coppie di righe nella sezione [Interface] di /etc/wireguard/wg0.conf.

Per autorizzare gli scambi:

Configurazione
PostUp = iptables -I FORWARD -i %i -o %i -j ACCEPT
PreDown = iptables -D FORWARD -i %i -o %i -j ACCEPT

Per vietarli:

Configurazione
PostUp = iptables -I FORWARD -i %i -o %i -j DROP
PreDown = iptables -D FORWARD -i %i -o %i -j DROP

Le modifiche alla sezione [Interface] richiedono un riavvio, che interrompe brevemente la VPN:

Terminale
systemctl restart wg-quick@wg0

Riservare SSH alla VPN

Una volta convalidata la VPN, puoi chiudere SSH sull'indirizzo pubblico. Questa sezione presuppone che UFW sia attivo e rifiuti le connessioni in entrata per impostazione predefinita, cosa che ufw status verbose permette di confermare. Adatta la porta 22 se ne usi un'altra.

Autorizza SSH dalla VPN:

Terminale
ufw allow in on wg0 to any port 22 proto tcp

Da un client connesso alla VPN, apri una nuova sessione:

Terminale
ssh TUO_USER@10.8.0.1

Se la connessione funziona, rimuovi la regola pubblica, poi controlla il risultato:

Terminale
ufw status numbered
ufw delete allow 22/tcp
ufw status verbose

Se la tua regola ha un altro nome, come OpenSSH, usa ufw delete allow OpenSSH. Puoi anche eliminarla in base al suo numero con ufw delete NUMERO.

Revocare un client

Elimina il blocco [Peer] del dispositivo in /etc/wireguard/wg0.conf, poi ricarica la configurazione:

Terminale
nano /etc/wireguard/wg0.conf
systemctl reload wg-quick@wg0
wg show

Il client non deve più comparire. Elimina anche /etc/wireguard/clients/laptop.pub. Se la chiave privata del server è stata esposta, generane una nuova e ridistribuisci la configurazione a tutti i client.

Aggiornare

Gli strumenti vengono aggiornati da APT e il modulo WireGuard dal kernel:

Terminale
apt update
apt upgrade -y
wg --version

Riavvia il server dopo un aggiornamento del kernel. La VPN riparte automaticamente, ma prevedi un altro accesso se SSH è riservato ad essa.

Backup e ripristino

La cartella /etc/wireguard contiene le chiavi e l'elenco dei client:

Terminale
tar -czf /root/wireguard-$(date +%F).tar.gz -C /etc wireguard sysctl.d/99-wireguard.conf
chmod 600 /root/wireguard-$(date +%F).tar.gz

Questo archivio contiene chiavi private: conservalo cifrato, fuori dal server.

Per ripristinare su un server in cui i pacchetti sono installati, sostituendo AAAA-MM-GG con la sua data:

Terminale
tar -xzf /root/wireguard-AAAA-MM-GG.tar.gz -C /etc
sysctl -p /etc/sysctl.d/99-wireguard.conf
systemctl enable --now wg-quick@wg0

Se il nome dell'interfaccia pubblica è cambiato, correggilo nelle righe PostUp e PreDown prima dell'avvio.

In caso di problemi

Nessun latest handshake in wg show

Il client non riesce a stabilire il tunnel. WireGuard non risponde mai ai pacchetti non autenticati: uno scanner di porte quindi non dimostra nulla. Osserva piuttosto l'arrivo del traffico sul server mentre il client tenta di connettersi:

Terminale
apt install -y tcpdump
tcpdump -ni any udp port 51820
  • Non arriva nessun pacchetto: controlla Endpoint, la regola UFW e la rete del client. Se è tutto corretto, contatta il supporto dalla tua area clienti per sapere se è applicato un filtraggio a monte.
  • Arrivano pacchetti senza risposta: le chiavi non corrispondono. Confronta PublicKey lato client con server.pub, e la chiave del blocco [Peer] con quella del client.

Il tunnel si avvia, ma Internet non funziona

Controlla in ordine routing, NAT e transito:

Terminale
sysctl net.ipv4.ip_forward
ip -4 route show default
iptables -t nat -S POSTROUTING
iptables -S FORWARD

L'interfaccia delle regole deve essere quella della route predefinita. Se è diversa, correggi wg0.conf, poi esegui systemctl restart wg-quick@wg0.

La VPN funziona, ma i nomi di dominio non vengono risolti

Testa ping 1.1.1.1 dal client. Se questo test riesce, il problema riguarda il DNS: controlla la riga DNS del client oppure indica un altro resolver.

resolvconf: command not found su un client Linux

wg-quick ha bisogno di questo strumento per applicare la riga DNS. Installa openresolv, oppure rimuovi questa riga se instradi solo la rete VPN.

iptables: command not found

Il pacchetto manca, spesso su un'installazione Debian minimale. Installalo, poi riavvia il servizio:

Terminale
apt install -y iptables
systemctl restart wg-quick@wg0

Il kernel non può creare l'interfaccia. È il caso di un sistema eseguito in un container senza supporto di WireGuard da parte dell'host. Verifica il modulo con modprobe wireguard.

modprobe: FATAL: Module wireguard not found

Spesso il kernel è stato aggiornato senza riavvio. Confronta uname -r con il contenuto di /lib/modules, poi riavvia il server.

Key is not the correct length or format

Una chiave è incompleta o contiene un carattere in più. Copiala per intero, senza spazi né ritorni a capo.

L'interfaccia wg0 esiste già

Il messaggio contiene already exists: l'interfaccia è stata avviata al di fuori di systemd. Arrestala, poi riavvia il servizio:

Terminale
wg-quick down wg0
systemctl restart wg-quick@wg0

Alcuni siti restano bloccati o i trasferimenti si bloccano

La dimensione dei pacchetti è probabilmente troppo elevata per la rete attraversata. Aggiungi MTU = 1380 nella sezione [Interface] del client, poi riattiva il tunnel. Se il problema persiste, prova 1280.

L'IPv6 è disattivato sul client Linux. Rimuovi ::/0 da AllowedIPs.

Riferimenti