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.
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:
sudo -i
apt update
apt install -y wireguard iptables qrencodeSalvo 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:
cat > /etc/sysctl.d/99-wireguard.conf <<EOF
net.ipv4.ip_forward = 1
EOF
sysctl -p /etc/sysctl.d/99-wireguard.confIl comando deve mostrare net.ipv4.ip_forward = 1.
Passo 3: generare le chiavi del server
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
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.confLe 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:
ufw allow 51820/udp
ufw statusPasso 6: avviare la VPN
systemctl enable --now wg-quick@wg0
systemctl status wg-quick@wg0 --no-pager
wg show
ss -lun | grep 51820wg 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:
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@wg0Il 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:
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
EOFPersistentKeepalive = 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:
qrencode -t ansiutf8 < clients/$CLIENT.confWindows e macOS
Mostra il file:
cat clients/$CLIENT.confCopia 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:
sudo apt install -y wireguard
sudo nano /etc/wireguard/wg0.conf
sudo chmod 600 /etc/wireguard/wg0.conf
sudo wg-quick up wg0Per 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:
shred -u clients/$CLIENT.key clients/$CLIENT.psk clients/$CLIENT.confVerificare il funzionamento
Sul server, latest handshake deve comparire per il client, con contatori transfer che aumentano:
wg showSu un client Linux o macOS, testa il tunnel e poi l'indirizzo di uscita:
ping -c 3 10.8.0.1
curl -4 https://ifconfig.meIl 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:
PostUp = iptables -I FORWARD -i %i -o %i -j ACCEPT
PreDown = iptables -D FORWARD -i %i -o %i -j ACCEPTPer vietarli:
PostUp = iptables -I FORWARD -i %i -o %i -j DROP
PreDown = iptables -D FORWARD -i %i -o %i -j DROPLe modifiche alla sezione [Interface] richiedono un riavvio, che interrompe brevemente la VPN:
systemctl restart wg-quick@wg0Riservare 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:
ufw allow in on wg0 to any port 22 proto tcpDa un client connesso alla VPN, apri una nuova sessione:
ssh TUO_USER@10.8.0.1Se la connessione funziona, rimuovi la regola pubblica, poi controlla il risultato:
ufw status numbered
ufw delete allow 22/tcp
ufw status verboseSe 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:
nano /etc/wireguard/wg0.conf
systemctl reload wg-quick@wg0
wg showIl 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:
apt update
apt upgrade -y
wg --versionRiavvia 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:
tar -czf /root/wireguard-$(date +%F).tar.gz -C /etc wireguard sysctl.d/99-wireguard.conf
chmod 600 /root/wireguard-$(date +%F).tar.gzQuesto 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:
tar -xzf /root/wireguard-AAAA-MM-GG.tar.gz -C /etc
sysctl -p /etc/sysctl.d/99-wireguard.conf
systemctl enable --now wg-quick@wg0Se 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:
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
PublicKeylato client conserver.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:
sysctl net.ipv4.ip_forward
ip -4 route show default
iptables -t nat -S POSTROUTING
iptables -S FORWARDL'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:
apt install -y iptables
systemctl restart wg-quick@wg0RTNETLINK answers: Operation not supported
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:
wg-quick down wg0
systemctl restart wg-quick@wg0Alcuni 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.
RTNETLINK answers: Permission denied con ::/0
L'IPv6 è disattivato sul client Linux. Rimuovi ::/0 da AllowedIPs.