ACLClouds
ACLClouds

Come creare una propria VPN WireGuard su un VPS?

Installare WireGuard su un VPS Debian o Ubuntu: chiavi, wg0.conf, routing e NAT con nftables, firewall, IPv6, poi profilo client e QR code per Android e

Con WireGuard il tuo VPS diventa una VPN personale: il traffico del telefono o del computer passa in un tunnel cifrato fino al server, poi esce su Internet con l’indirizzo IP del VPS. È utile su una rete Wi-Fi pubblica, per raggiungere servizi privati del VPS senza esporli o per mantenere un indirizzo di uscita fisso. Questa guida configura il server su Debian 12 / 13 o Ubuntu 22.04 / 24.04, poi un primo client mobile con un QR code. Calcola un quarto d’ora.

Procedura passo passo

  1. Installare WireGuard

    Installa wireguard, che fornisce gli strumenti wg e wg-quick, insieme a qrencode per il QR code e nftables per il NAT. Il modulo WireGuard fa parte del kernel Linux di Debian 12 / 13 e di Ubuntu 22.04 / 24.04: non c’è nulla da compilare.

  2. Generare le chiavi

    In /etc/wireguard, dopo umask 077, genera una coppia di chiavi per il server e una per il telefono. Ogni chiave privata resta segreta; solo le chiavi pubbliche vengono scambiate tra il server e i client.

  3. Scrivere la configurazione del server

    Crea /etc/wireguard/wg0.conf partendo dal blocco qui sotto. Sostituisci SERVER_PRIVATE_KEY con il contenuto di server.key e PHONE_PUBLIC_KEY con quello di phone.pub. Le righe PostUp e PostDown aggiungono e rimuovono il NAT nftables insieme al tunnel.

  4. Attivare il routing

    Consenti al VPS di inoltrare i pacchetti tra il tunnel e Internet con net.ipv4.ip_forward e net.ipv6.conf.all.forwarding, in un file di /etc/sysctl.d/, poi applica con sysctl --system.

  5. Aprire la porta UDP 51820

    Consenti UDP 51820 in UFW se lo usi, e nel « Firewall » del pannello ACLClouds se è attivato. Con UFW aggiungi anche una regola ufw route: senza di essa, UFW blocca il traffico che attraversa il VPS.

  6. Avviare il tunnel

    Esegui systemctl enable --now wg-quick@wg0. L’interfaccia wg0 partirà così insieme al VPS. wg show mostra la chiave pubblica del server, la porta in ascolto e i client configurati.

  7. Collegare il telefono con un QR code

    Scrivi il profilo phone.conf con il contenuto di phone.key, quello di server.pub e l’IPv4 del VPS, mostralo come QR code con qrencode -t ansiutf8, poi aggiungi un tunnel nell’app WireGuard per Android o iPhone scansionando il codice. Attivalo: wg show deve indicare un latest handshake recente.

Installare WireGuard e generare le chiavi

apt update
apt install -y wireguard qrencode nftables
cd /etc/wireguard
umask 077
wg genkey | tee server.key | wg pubkey > server.pub
wg genkey | tee phone.key | wg pubkey > phone.pub
cat server.key phone.pub

/etc/wireguard/wg0.conf (server)

[Interface]
Address = 10.8.0.1/24, fd42:42:42::1/64
ListenPort = 51820
PrivateKey = SERVER_PRIVATE_KEY
PostUp = nft add table inet wg-nat; nft add chain inet wg-nat postrouting '{ type nat hook postrouting priority 100; }'; nft add rule inet wg-nat postrouting ip saddr 10.8.0.0/24 oifname != "%i" masquerade; nft add rule inet wg-nat postrouting ip6 saddr fd42:42:42::/64 oifname != "%i" masquerade
PostDown = nft delete table inet wg-nat

[Peer]
PublicKey = PHONE_PUBLIC_KEY
AllowedIPs = 10.8.0.2/32, fd42:42:42::2/128

Attivare il routing IPv4 e IPv6

cat > /etc/sysctl.d/99-wireguard.conf <<'EOF'
net.ipv4.ip_forward = 1
net.ipv6.conf.all.forwarding = 1
EOF
sysctl --system

Firewall UFW e avvio

ip route show default
ufw allow 51820/udp
ufw route allow in on wg0 out on eth0
systemctl enable --now wg-quick@wg0
wg show

/etc/wireguard/phone.conf (client)

[Interface]
PrivateKey = PHONE_PRIVATE_KEY
Address = 10.8.0.2/32, fd42:42:42::2/128
DNS = 1.1.1.1, 2606:4700:4700::1111

[Peer]
PublicKey = SERVER_PUBLIC_KEY
Endpoint = VPS_IPV4:51820
AllowedIPs = 0.0.0.0/0, ::/0
PersistentKeepalive = 25

Mostrare il QR code e poi cancellare la chiave del telefono

qrencode -t ansiutf8 < /etc/wireguard/phone.conf
rm /etc/wireguard/phone.key /etc/wireguard/phone.conf

Aggiungere un secondo client

cd /etc/wireguard
umask 077
wg genkey | tee laptop.key | wg pubkey > laptop.pub
printf '\n[Peer]\nPublicKey = %s\nAllowedIPs = 10.8.0.3/32, fd42:42:42::3/128\n' "$(cat laptop.pub)" >> wg0.conf
systemctl reload wg-quick@wg0

Prima di iniziare

Ti serve un VPS Linux KVM con accesso root, con Debian 12 / 13 o Ubuntu 22.04 / 24.04, e l’app WireGuard su ogni dispositivo: Android, iPhone, Windows, macOS o Linux. I comandi vanno eseguiti come root; con un altro account, aggiungi sudo davanti a ciascuno.

  • La rete del tunnel, 10.8.0.0/24, non deve essere già in uso nella tua rete di casa: se il tuo router usa questo intervallo, scegli per esempio 10.66.0.0/24 in tutti i file.
  • Annota il nome dell’interfaccia di rete del VPS: ip route show default lo mostra dopo dev (eth0, ens18…). Serve nella regola ufw route.
  • Nell’output del comando cat, la prima riga è la chiave privata del server e la seconda la chiave pubblica del telefono; cat server.pub fornisce la chiave pubblica del server per il profilo client.

Capire la configurazione

WireGuard associa ogni chiave pubblica a degli indirizzi autorizzati. Sul server, AllowedIPs di un [Peer] elenca gli indirizzi del client nel tunnel: un pacchetto proveniente da 10.8.0.2 viene accettato solo se è firmato con la chiave del telefono. Sul client, AllowedIPs = 0.0.0.0/0, ::/0 invia tutto il traffico nel tunnel.

  • Address: l’indirizzo del server nel tunnel, in IPv4 (10.8.0.1) e in IPv6 privato (fd42:42:42::1).
  • PostUp crea una tabella nftables wg-nat che maschera gli indirizzi del tunnel dietro quello del VPS; PostDown la elimina all’arresto. %i viene sostituito dal nome dell’interfaccia, wg0.
  • Endpoint indica al client l’indirizzo IPv4 pubblico del VPS, visibile in « I miei servizi », e la porta UDP.
  • PersistentKeepalive = 25 invia un pacchetto ogni 25 secondi per tenere aperto il tunnel dietro un router domestico o una rete mobile.
  • DNS imposta i resolver usati dal telefono finché il tunnel è attivo.

IPv6: cosa sapere

La configurazione assegna al tunnel indirizzi IPv6 privati (fd42:42:42::/64) e li maschera dietro l’IPv6 del VPS. Se il VPS ha un indirizzo IPv6 pubblico, verificabile con ip -6 addr show scope global, i client navigano anche in IPv6 attraverso il tunnel. Altrimenti usano semplicemente IPv4 e nessuna richiesta IPv6 esce dal tunnel per un’altra strada.

Attivando net.ipv6.conf.all.forwarding, Linux ignora i router advertisement. Se l’IPv6 del VPS viene ottenuto automaticamente invece di essere configurato in modo statico, aggiungi net.ipv6.conf.eth0.accept_ra = 2 (con il nome della tua interfaccia) nello stesso file, altrimenti il VPS può perdere la sua rotta IPv6.

VPN completa o accesso privato al VPS

Con AllowedIPs = 0.0.0.0/0, ::/0, tutto il traffico del client passa dal VPS. Per raggiungere solo i servizi privati del server, come un database o un’interfaccia di amministrazione legata a 10.8.0.1, imposta AllowedIPs = 10.8.0.0/24 nel profilo client: il resto del traffico segue il suo percorso abituale.

Per aggiungere un computer, genera una nuova coppia di chiavi, aggiungi un blocco [Peer] con l’indirizzo successivo (10.8.0.3), poi ricarica con systemctl reload wg-quick@wg0, senza disconnettere i client collegati.

Quale VPS per una VPN WireGuard?

WireGuard consuma pochissimo: la cifratura avviene nel kernel e bastano pochi MB di RAM. Il VPS Mini di ACLClouds (2 vCPU, 8 GB di RAM, 40 GB di spazio), a 4,99 € al mese senza vincoli al 16 novembre 2026, fa girare la VPN insieme ad altri servizi. Serve un VPS KVM: WireGuard richiede l’accesso al kernel, impossibile su un hosting condiviso.

Verifica rapida

  • wg show mostra per il client un latest handshake di meno di due minuti fa.
  • Dal telefono, l’indirizzo IP visibile su Internet è quello del VPS.
  • nft list table inet wg-nat mostra le due regole masquerade.
  • sysctl net.ipv4.ip_forward risponde net.ipv4.ip_forward = 1.
  • I file *.key di /etc/wireguard hanno i permessi 600 e la chiave privata del telefono non è più sul server.

Domande frequenti

wg show non mostra alcun latest handshake, cosa devo controllare?

I pacchetti del client non arrivano o vengono rifiutati. Verifica che la porta UDP 51820 sia aperta in UFW e nel firewall del pannello, che Endpoint contenga l’IPv4 corretto e che le chiavi corrispondano: il client deve avere server.pub, il server phone.pub. tcpdump -ni any udp port 51820 mostra se i pacchetti raggiungono il VPS.

Il tunnel è attivo ma Internet non risponde più, perché?

Il VPS riceve il traffico ma non lo inoltra. Controlla sysctl net.ipv4.ip_forward, la tabella wg-nat con nft list table inet wg-nat e la regola ufw route. Se Docker è installato, blocca l’inoltro per impostazione predefinita: aggiungi iptables -I DOCKER-USER -i wg0 -j ACCEPT e iptables -I DOCKER-USER -o wg0 -m conntrack --ctstate RELATED,ESTABLISHED -j ACCEPT alla riga PostUp.

Su un client Linux, wg-quick up mostra resolvconf: command not found, cosa fare?

wg-quick ha bisogno di resolvconf per applicare la riga DNS. Installa il pacchetto openresolv oppure, se il computer usa systemd-resolved, crea il collegamento ln -s /usr/bin/resolvectl /usr/local/bin/resolvconf. Togliere la riga DNS elimina anche l’errore, ma le richieste DNS escono allora fuori dal tunnel.

Alcuni siti restano bloccati in caricamento attraverso la VPN, perché?

Spesso dipende dalla dimensione dei pacchetti (MTU) su una rete mobile o una connessione PPPoE. Aggiungi MTU = 1380 nella sezione [Interface] del profilo client, reimportalo e riprova. WireGuard usa 1420 per impostazione predefinita.

Il mio VPS non ha un IPv6 pubblico, devo togliere gli indirizzi fd42?

Non è obbligatorio. Senza IPv6 pubblico, il traffico IPv6 del client si ferma al VPS e i dispositivi usano IPv4. Per una configurazione solo IPv4 puoi anche togliere gli indirizzi IPv6 dalle righe Address e AllowedIPs e la regola ip6 da PostUp.

Una VPN sul mio VPS mi rende anonimo?

No. Cifra il traffico sulla rete a cui sei collegato, per esempio un Wi-Fi pubblico, e i siti vedono l’indirizzo del VPS invece del tuo. Ma quell’indirizzo è legato al tuo account di hosting e sei l’unico a usarlo. Per l’anonimato non è lo strumento giusto.