Guia Completa per Configurar AdGuard Home amb Docker

Darrera actualització: 4 de setembre de 2026
  • Implementació d'un servidor DNS centralitzat per bloquejar publicitat i rastrejadors a tota la xarxa domèstica.
  • Optimització de la privadesa mitjançant l'ús de protocols de DNS xifrats com DoH i DoT.
  • Integració avançada amb Unbound per crear un resolvedor recursiu propi i guanyar autonomia.
  • Gestió detallada de clients i control parental per protegir els menors de contingut inapropiat.

Servidor de xarxa modern amb il·luminació blava, ideal per representar la infraestructura d'un servidor DNS a Docker.

Si estàs fart que els anuncis t'envaeixin la pantalla i que les empreses rastregin cadascun dels teus passos per internet, muntar el teu propi servidor DNS és la solució definitiva. AdGuard Home es presenta com una eina potentíssima que actua com un mur davant de la publicitat i el malware, filtrant el trànsit abans fins i tot que arribi als teus dispositius, fet que suposa un alleujament enorme per a la navegació a casa.

El millor de tot és que, en executar-ho a través de contenidors Docker , ens oblidem de complicacions tècniques tedioses i podem desplegar-lo en gairebé qualsevol maquinari, des d'un NAS Synology o un router ASUS avançat, fins a una Raspberry Pi amb AdGuard Home o una Orange Pi amb Arch Linux. No cal instal·lar extensions a cada navegador; un cop configurat, tota la xarxa queda protegida automàticament, incloent aquestes Smart TVs o dispositius IoT que són impossibles de modificar.

bloquejar publicitat amb Pi-hole
Article relacionat:
Guia Completa per Bloquejar Publicitat amb Pi-hole

Preparant el terreny: Requisits i sistema

Router sense fil modern amb llums neon, representant la configuració de DNS a nivell de xarxa.

Perquè tot rodi com la seda, necessites tenir instal·lat Docker i Docker Compose . Un punt crític que sol donar mals de cap és el port 53, que és el que utilitza el DNS. En distribucions com Ubuntu o Debian, el servei systemd-resolved sol estar ocupant aquest port per defecte, per la qual cosa és imprescindible desactivar-lo perquè AdGuard Home pugui agafar el control total de les consultes.

  Què és un desenvolupador front-end i què fa?

És fonamental que el servidor on allotges el contenidor tingui una IP fixa . Si l'adreça IP del servidor canvia, tots els dispositius es quedaran sense internet perquè no sabran on preguntar per les adreces web. Si utilitzes un NAS Synology, ho pots gestionar tot des del Container Manager , creant carpetes específiques per a la configuració i les dades persistents, assegurant que no perdis res en actualitzar la imatge.

Primer pla duna placa de circuit electrònic, maquinari comú per muntar un servidor Pi-hole.
Article relacionat:
Guia completa per instal·lar Pi-hole amb Docker

Desplegament mitjançant Docker Compose

Portàtil amb una icona de cadenat i la paraula Secured, simbolitzant la privadesa i el bloqueig d'anuncis.

La manera més neta d'aixecar el servei és mitjançant un fitxer docker-compose.yml . En aquest fitxer hem de mapejar els ports essencials: el 53 per a DNS (TCP i UDP), el 80 per a la interfície d'administració, el 3000 per a l'assistent inicial i, si volem funcions avançades, els ports 67 i 68 per al servei DHCP . Per garantir que el servei no es talli, es recomana fer servir la directiva restart: unless-stopped.

Quan el contenidor està en marxa, només cal entrar a la IP del servidor seguida del port 3000. L'assistent és molt intuïtiu i et demanarà definir el usuari i contrasenya de l'administrador. Un truc per als que busquen màxima privadesa és configurar els DNS upstream xifrats, comparant opcions com el DNS de Google vs Digi o Quad9, utilitzant sintaxi com tls://dns.google, evitant així que el vostre proveïdor d'internet espiï les vostres peticions.

hardening homelab vlan
Article relacionat:
Hardening d'homelab amb VLAN: guia completa de seguretat a casa

Portant la privadesa al següent nivell amb Unbound

Línies de codi de programació en una pantalla amb mode fosc, representant la configuració de Docker Compose.

Si vols deixar de dependre de tercers, pots combinar AdGuard Home amb Unbound . Aquest programari funciona com un resolvedor recursiu, cosa que significa que AdGuard ja no preguntarà a Google o Cloudflare, sinó que Unbound anirà directament als servidors arrel de DNS . Això elimina un intermediari i augmenta la sobirania sobre les vostres dades.

  Com canviar els DNS del router per accelerar la teva connexió a Internet

Per optimitzar Unbound a Docker, és recomanable ajustar els búfers de recepció i enviament al host mitjançant sysctl.conf, evitant així advertiments de rendiment. A més, és vital validar que DNSSEC estigui actiu, assegurant que les respostes DNS no hagin estat manipulades al camí, cosa que es pot comprovar fàcilment amb eines com l'ordre dig.

Configuració de la xarxa i control parental

Perquè la màgia passi, has d'anar a la configuració del teu router i canviar el DNS primari per la IP del teu servidor AdGuard. Un detall important és configurar el servidor de noms DHCP de manera manual; si deixes que el router faci el pont, al panell d'AdGuard només veuràs una IP (la del router) i no podràs saber quin dispositiu exacte està fent cada petició.

Quan els clients apareixen individualment, pots jugar amb el control parental. AdGuard permet crear perfils específics per a cada membre de la família, bloquejant serveis d'apostes, contingut adult o fins i tot xarxes socials en horaris concrets. També pots fer servir les reescriptures de DNS per crear dominis locals, permetent accedir a la teva NAS o domòtica escrivint alguna cosa com mi-casa.local en comptes de recordar una IP numèrica.

vpn self-hosted avançat
Article relacionat:
VPN self-hosted avançat: guia completa i opcions reals

Llistes de filtrat i manteniment

El cor del sistema són les llistes de bloqueig. Encara AdGuard porta una base sòlida, afegir filtres com OISD o Steven Black millora dràsticament la cobertura contra l'adware i la telemetria. Si notes que alguna web legítima deixa de carregar, no et preocupis: pots afegir una regla d'excepció a l'apartat de filtratge personalitzat usant la sintaxi de doble arrova.

  Control de Versions GitHub: Desenvolupament Col·laboratiu

Pel que fa al manteniment, és vital realitzar còpies de seguretat de les carpetes config y work. Pots automatitzar això amb un simple script de Bash i una tasca programada a cron que comprimeixi les dades en un fitxer tar.gz diàriament, evitant així haver de configurar-ho tot des de zero si el disc del servidor falla.

Tenir un ecosistema basat en AdGuard Home i Docker permet transformar una xarxa domèstica convencional en un entorn blindat i eficient. Des de la capacitat de filtrar dominis maliciosos a nivell global fins a la possibilitat de gestionar la xarxa de forma granular per dispositiu, el control total recau a l'administrador. En integrar eines com Unbound i protocols de xifrat, s'aconsegueix un equilibri perfecte entre velocitat de navegació i privadesa absoluta, eliminant la dependència dels servidors DNS públics i protegint la integritat de cada consulta realitzada a la llar.

Placa d'ordinador Raspberry Pi en una carcassa transparent per a servidor VPN
Article relacionat:
Com configurar una VPN amb WireGuard a Raspberry Pi