Guida completa alla configurazione di AdGuard Home con Docker

Ultimo aggiornamento: 4 settembre 2026
  • Implementazione di un server DNS centralizzato per bloccare pubblicità e tracker su tutta la rete domestica.
  • Ottimizzazione della privacy tramite l'utilizzo di protocolli DNS crittografati come DoH e DoT.
  • Integrazione avanzata con Unbound per creare il proprio resolver ricorsivo e ottenere maggiore autonomia.
  • Gestione dettagliata dei clienti e controlli parentali per proteggere i minori da contenuti inappropriati.

Server di rete moderno con illuminazione blu, ideale per rappresentare l'infrastruttura di un server DNS in Docker.

Se siete stanchi delle pubblicità che invadono il vostro schermo e delle aziende che tracciano ogni vostra mossa online, configurare un server DNS personale è la soluzione definitiva. AdGuard Home si presenta come un potente strumento che funge da barriera contro pubblicità e malware, filtrando il traffico prima ancora che raggiunga i vostri dispositivi e semplificando notevolmente la navigazione domestica.

Il vantaggio principale è che, eseguendo il tutto tramite container Docker , possiamo dimenticarci di noiose complicazioni tecniche e distribuirlo praticamente su qualsiasi hardware, da un NAS Synology o un router ASUS avanzato a un Raspberry Pi con AdGuard Home o un Orange Pi con Arch Linux. Non è necessario installare estensioni in ogni browser; una volta configurato, l'intera rete è automaticamente protetta, comprese le Smart TV o i dispositivi IoT che non è possibile modificare.

Blocca gli annunci con Pi-hole
Articolo correlato:
Guida completa al blocco degli annunci con Pi-hole

Preparazione del terreno: requisiti e sistema

Router wireless moderno con luci al neon, che rappresentano la configurazione DNS a livello di rete.

Affinché tutto funzioni correttamente, è necessario avere Docker e Docker Compose installati . Un punto critico che spesso causa problemi è la porta 53, utilizzata dal DNS. Nelle distribuzioni come Ubuntu o Debian, il servizio systemd-resolved occupa solitamente questa porta per impostazione predefinita, quindi è essenziale disabilitarlo affinché AdGuard Home possa assumere il pieno controllo delle query.

  Come migliorare la connessione cambiando router e ottimizzando il Wi-Fi domestico

È fondamentale che il server che ospita il container abbia un indirizzo IP statico . Se l'indirizzo IP del server cambia, tutti i dispositivi perderanno l'accesso a Internet perché non sapranno più dove interrogare gli indirizzi web. Se si utilizza un NAS Synology, è possibile gestire tutto tramite Container Manager , creando cartelle specifiche per la configurazione e i dati persistenti, assicurandosi di non perdere nulla durante l'aggiornamento dell'immagine.

Primo piano di un circuito stampato, un componente hardware comune per assemblare un server Pi-hole.
Articolo correlato:
Guida completa all'installazione di Pi-hole con Docker

Distribuzione tramite Docker Compose

Computer portatile con l'icona di un lucchetto e la scritta "Protetto", a simboleggiare la privacy e il blocco degli annunci pubblicitari.

Il modo più pulito per avviare il servizio è utilizzare un file docker-compose.yml . In questo file, è necessario mappare le porte essenziali: la 53 per il DNS (TCP e UDP), la 80 per l'interfaccia di gestione, la 3000 per la procedura guidata di configurazione iniziale e, se si desiderano funzionalità avanzate, le porte 67 e 68 per il servizio DHCP . Per garantire che il servizio non si arresti, si consiglia di utilizzare la direttiva `restart: unless-stopped`.

Una volta avviato il container, è sufficiente inserire l'indirizzo IP del server seguito dalla porta 3000. La procedura guidata è molto intuitiva e ti chiederà di definire il nome utente e password dall'amministratore. Un trucco per chi cerca la massima privacy è configurare il DNS upstream crittografato, confrontando opzioni come la Google DNS vs Digi o Quad9, utilizzando una sintassi come tls://dns.googleCiò impedisce al tuo provider Internet di spiare le tue richieste.

protezione della VLAN dell'homelab
Articolo correlato:
Proteggere un homelab con le VLAN: una guida completa alla sicurezza domestica

Con Unbound, la privacy raggiunge un livello superiore.

Righe di codice di programmazione su uno schermo in modalità scura, che rappresentano la configurazione di Docker Compose.

Se desideri smettere di dipendere da terze parti, puoi combinare AdGuard Home con Unbound . Questo software funziona come un resolver ricorsivo, il che significa che AdGuard non interrogherà più Google o Cloudflare; Unbound si connetterà direttamente ai server DNS radice . Questo elimina un intermediario e aumenta il tuo controllo sui tuoi dati.

  Calcolo del fattore di inflazione della varianza (VIF) in C# e progettazione del software

Per ottimizzare Unbound in Docker, si consiglia di regolare i buffer di ricezione e invio sull'host utilizzando sysctl.confevitando così avvisi sulle prestazioni. Inoltre è fondamentale verificare che DNSSEC è attivo, garantendo che le risposte DNS non siano state manomesse lungo il percorso, cosa che può essere facilmente verificata con strumenti come il comando dig.

Impostazioni di rete e controlli parentali

Affinché ciò funzioni, è necessario accedere alle impostazioni del router e modificare il DNS primario impostandolo sull'indirizzo IP del server AdGuard. Un dettaglio importante è la configurazione manuale del server dei nomi DHCP; se si lascia che il router gestisca la connessione, il pannello di controllo di AdGuard mostrerà un solo indirizzo IP (quello del router) e non sarà possibile identificare il dispositivo esatto che effettua ogni richiesta.

Una volta che i clienti appaiono singolarmente, puoi giocare con il controllo parentaleAdGuard ti consente di creare profili specifici per ogni membro della famiglia, bloccando i servizi di gioco d'azzardo, i contenuti per adulti o persino i social media in determinati momenti. Puoi anche utilizzare il riscrittura DNS per creare domini locali, che ti consentono di accedere al tuo NAS o al sistema di domotica digitando qualcosa come mi-casa.local invece di ricordare un indirizzo IP numerico.

VPN auto-ospitata avanzata
Articolo correlato:
VPN self-hosted avanzata: guida completa e opzioni reali

Liste di filtraggio e manutenzione

Il cuore del sistema risiede nelle sue liste di blocco. Sebbene AdGuard fornisca una solida base, l'aggiunta di filtri come OISD o Steven Black migliora notevolmente la protezione dagli adware e la telemetria. Se noti che un sito web legittimo non si carica, non preoccuparti: puoi aggiungere una regola di eccezione nella sezione di filtro personalizzato utilizzando il doppio simbolo @.

  Guida completa alle reti gestite tramite cloud: trasformazione ed efficienza

Per quanto riguarda la manutenzione, è fondamentale effettuare eseguire il backup delle cartelle config y workÈ possibile automatizzare questo processo con un semplice script Bash e un'attività pianificata in cron che comprime i dati in un file tar.gz ogni giorno, evitando così di dover configurare tutto da zero in caso di guasto del disco del server.

Disporre di un ecosistema basato su AdGuard Home e Docker consente di trasformare una rete domestica convenzionale in un ambiente sicuro ed efficiente. Dalla possibilità di filtrare i domini dannosi a livello globale alla gestione granulare della rete per singolo dispositivo, l'amministratore ha il controllo completo. Integrando strumenti come Unbound e protocolli di crittografia, si raggiunge un equilibrio perfetto tra velocità di navigazione e privacy assoluta, eliminando la dipendenza dai server DNS pubblici e proteggendo l'integrità di ogni query effettuata all'interno della rete domestica.

Scheda computer Raspberry Pi in custodia trasparente per server VPN
Articolo correlato:
Come configurare una VPN con WireGuard su Raspberry Pi