AdGuard Home con Docker - Parte 3: Instalación y Configuración

21 de enero de 2026 · 10 min. · networking ,privacy ,docker ,tutorial ,adguard ,raspberry-pi

En esta parte, desplegaremos AdGuard Home usando Docker, completaremos el asistente de configuración inicial y configuraremos tu red para usarlo como DNS.

Tabla de Contenidos

  1. Instalando AdGuard Home
  2. Configuración Inicial
  3. Configuraciones Recomendadas por Defecto
  4. Configurando Tus Dispositivos

Instalando AdGuard Home

Entendiendo los Puertos de AdGuard Home

AdGuard Home requiere varios puertos para funcionar. Esto es lo que necesitas saber:

Puertos Requeridos:

Por Qué el Puerto 53 No Puede Cambiarse: DNS opera en el puerto 53 por estándares de internet. Los dispositivos esperan que DNS esté en el puerto 53, así que cambiarlo rompería la resolución DNS para todos tus dispositivos.

Conflictos de Puertos Comunes:

Método 1: Usando Docker Run (Más Simple)

Esta es la forma más rápida de comenzar:

docker run --name adguardhome \
  --restart unless-stopped \
  -v /opt/adguardhome/work:/opt/adguardhome/work \
  -v /opt/adguardhome/conf:/opt/adguardhome/conf \
  -p 53:53/tcp -p 53:53/udp \
  -p 80:80/tcp \
  -p 443:443/tcp \
  -p 443:443/udp \
  -p 3000:3000/tcp \
  -d adguard/adguardhome

Qué hace este comando:

Método 2: Usando Docker Compose (Recomendado)

Docker Compose hace más fácil gestionar y actualizar tu container usando un archivo de configuración.

Paso 1: Instalar Docker Compose

Copia y pega este comando:

sudo apt install docker-compose -y

Paso 2: Crear una Carpeta para AdGuard Home

Estos comandos crean una nueva carpeta con los permisos apropiados:

mkdir -p ~/adguardhome
cd ~/adguardhome
mkdir -p -m 700 work
mkdir -p -m 700 conf

Qué hace esto:

Paso 3: Crear un Archivo de Configuración

Ahora crearemos un archivo llamado docker-compose.yml. Este archivo le dice a Docker cómo ejecutar AdGuard Home.

Escribe este comando:

vim docker-compose.yml

Se abrirá vim. Presiona i para entrar en modo insertar, luego copia y pega este bloque completo:

services:
  adguardhome:
    image: adguard/adguardhome
    container_name: adguardhome
    restart: unless-stopped
    ports:
      - '53:53/tcp'
      - '53:53/udp'
      - '80:80/tcp'
      - '443:443/tcp'
      - '443:443/udp'
      - '3000:3000/tcp'
    volumes:
      - ./work:/opt/adguardhome/work
      - ./conf:/opt/adguardhome/conf

Ahora guarda el archivo:

  1. Presiona Esc para salir del modo insertar
  2. Escribe :wq y presiona Enter

¡Éxito! Has creado tu archivo de configuración.

Alternativa: Puertos Personalizados (Opcional - Solo si tienes conflictos de puertos)

Omite esta sección si: Los puertos 80 y 3000 están libres en tu sistema.

Usa esta sección si: Obtienes errores como “port already in use” o estás ejecutando otros servicios (servidores web, otros containers, etc.).

¿Cuándo Necesitas Puertos Personalizados?

Necesitas puertos personalizados si:

Cómo Usar Puertos Personalizados

En lugar del docker-compose.yml anterior, usa esta versión con puertos personalizados:

Abre tu archivo docker-compose.yml de nuevo:

vim docker-compose.yml

Reemplaza el contenido con esto:

Presiona i para entrar en modo insertar, borra el contenido existente, y pega esto:

services:
  adguardhome:
    image: adguard/adguardhome
    container_name: adguardhome
    restart: unless-stopped
    ports:
      - '53:53/tcp' # DNS - Debe permanecer en puerto 53
      - '53:53/udp' # DNS - Debe permanecer en puerto 53
      - '8080:80/tcp' # Web UI - Cambiado de 80 a 8080
      - '3001:3000/tcp' # Setup wizard - Cambiado de 3000 a 3001
      - '8443:443/tcp' # HTTPS (opcional)
      - '8443:443/udp' # DNS-over-HTTPS (opcional)
    volumes:
      - ./work:/opt/adguardhome/work
      - ./conf:/opt/adguardhome/conf

Luego presiona Esc y escribe :wq para guardar.

Entendiendo el Mapeo de Puertos:

El formato es: "PUERTO_HOST:PUERTO_CONTAINER"

Ejemplos:

Notas Importantes:

⚠️ El puerto 53 NO puede cambiarse - DNS debe usar el puerto 53, o los dispositivos no podrán usarlo

Accediendo a AdGuard Home con Puertos Personalizados

Con puertos predeterminados:

Con puertos personalizados (como el ejemplo anterior):

Ejemplo con IP real:

Configuración: http://192.168.1.100:3001
Panel: http://192.168.1.100:8080
Alternativas de Puertos Comunes

Si los puertos están ocupados, aquí hay buenas alternativas:

ServicioPuerto PredeterminadoAlternativaUso
Web UI808080, 8888, 8081Panel
Setup Wizard30003001, 3002, 8000Configuración inicial
HTTPS4438443, 4443Web segura
Verificando si un Puerto Ya Está en Uso

Antes de comenzar, verifica si los puertos están libres:

# Verificar si el puerto 80 está en uso
sudo lsof -i :80

# Verificar si el puerto 3000 está en uso
sudo lsof -i :3000

O verifica todos los puertos a la vez:

sudo netstat -tulpn | grep -E ':(80|3000|53) '
Guardando Tu Configuración Personalizada

Después de editar:

  1. Presiona Ctrl+X
  2. Presiona Y para guardar
  3. Presiona Enter para confirmar

Paso 4: Iniciar AdGuard Home

¡Ahora iniciemos AdGuard Home! Ejecuta este comando:

docker-compose up -d

Qué hace esto: Inicia AdGuard Home en segundo plano. El -d significa “modo desacoplado” (se ejecuta en segundo plano).

Verás a Docker descargando e iniciando todo. Esto toma 1-2 minutos.

Verificando la Instalación

Verifiquemos si AdGuard Home está ejecutándose. Escribe:

docker ps

Qué buscar: Deberías ver una línea con adguardhome en ella. Si es así, ¡felicitaciones! ¡Está ejecutándose!

Configuración Inicial

Paso 1: Acceder a la Interfaz Web

¡Ahora configuraremos AdGuard Home usando un navegador web!

  1. Encuentra la dirección IP de tu dispositivo:

    En la terminal, escribe:

    hostname -I

    Verás algo como: 192.168.1.100

    ¡Anota este número! Esta es la dirección de tu dispositivo en tu red.

  2. Abre un navegador web

    • Puedes usar cualquier dispositivo en el mismo WiFi/red (teléfono, tablet, computadora)
    • Abre Chrome, Firefox, Safari o cualquier navegador

  3. Escribe en la barra de direcciones:

    Escribe: http://IP_DE_TU_DISPOSITIVO:3000

    Ejemplo: Si tu IP era 192.168.1.100, escribe: http://192.168.1.100:3000

    Presiona Enter.

Consejo: Si no carga, asegúrate de que:

Paso 2: Asistente de Configuración

Verás el asistente de configuración de AdGuard Home:

  1. Pantalla de Bienvenida: Clic en “Get Started”

  2. Configuración de Interfaz Web Admin:

    • Elige puerto 80 (o mantén 3000 si prefieres)
    • Clic en “Next”

  3. Configuración de Servidor DNS:

    • Mantén puerto 53 (predeterminado)
    • Clic en “Next”

  4. Crear Cuenta Admin:

    • Nombre de usuario: Elige tu nombre de usuario admin
    • Contraseña: Crea una contraseña fuerte
    • Clic en “Next”

  5. Configuración Completa: Clic en “Open Dashboard”

Paso 3: Iniciar Sesión

Usa las credenciales que acabas de crear para iniciar sesión.

Configuraciones Recomendadas por Defecto

Después de completar el asistente de configuración inicial, aquí están las configuraciones recomendadas para la mayoría de usuarios:

Servidores DNS Upstream

Qué usar: Elige una opción enfocada en privacidad

Dónde: Settings → DNS settings → Upstream DNS servers

¿Por qué estos? Ambos están enfocados en privacidad, son rápidos y confiables. Cloudflare es ligeramente más rápido, Quad9 incluye bloqueo de malware.

Blocklists

Comienza con estas dos (no te sobresuscribas):

  1. AdGuard DNS filter (preinstalado) - Bloqueo general de anuncios

    • Ya habilitado por defecto

  2. OISD Big List - Lista comprensiva y bien mantenida

    • Agregar vía: Filters → DNS blocklists → Add blocklist
    • URL: https://big.oisd.nl/

¿Por qué solo 2? Más listas = búsquedas DNS más lentas. Estas dos cubren el 95% de anuncios y rastreadores. Siempre puedes agregar más después si es necesario.

Query Logging

Configuración recomendada: Retención de 24 horas

Dónde: Settings → DNS settings → Query log retention

¿Por qué 24 horas?

Nota de privacidad: Los logs permanecen en tu dispositivo, nunca salen de tu red.

Configuraciones de Interfaz

¡Eso es todo! Estas configuraciones predeterminadas funcionan bien para la mayoría de redes domésticas. Siempre puedes ajustar después conforme aprendas más sobre qué funciona para tu configuración.

Configurando Tus Dispositivos

Ahora que AdGuard Home está ejecutándose con las configuraciones recomendadas, necesitas configurar tus dispositivos para usarlo.

Opción 1: Configurar Tu Router (Recomendado)

Esto aplica AdGuard Home a TODOS los dispositivos en tu red automáticamente.

Nota: ¡Cada router es diferente! Los pasos exactos varían por fabricante y modelo.

Pasos Generales:

  1. Accede al panel de administración de tu router

    • Usualmente: 192.168.1.1, 192.168.0.1, o 192.168.1.254
    • O verifica la etiqueta en tu router
    • Ingresa nombre de usuario/contraseña (a menudo en la etiqueta del router)

  2. Encuentra las configuraciones DNS

    • Busca en estas secciones (varía por router):
      • “DHCP Settings” o “DHCP Server”
      • “LAN Settings”
      • “Internet Settings”
      • “Network Settings”
      • “Advanced” → “DNS”

  3. Cambiar DNS Primario

    • Ingresa la dirección IP de tu AdGuard Home (la que encontraste antes)
    • Ejemplo: 192.168.1.100

  4. DNS Secundario (opcional)

    • Mejor práctica: Dejar en blanco
    • Alternativa: Usa un DNS de respaldo como 1.1.1.1 (Cloudflare) o 8.8.8.8 (Google)
    • Advertencia: Si estableces un secundario, los dispositivos pueden eludir AdGuard Home cuando el primario esté lento

  5. Guardar y Reiniciar

    • Guardar configuraciones
    • Reiniciar tu router (algunos routers hacen esto automáticamente)

Encontrando Instrucciones Específicas del Router:

¿No encuentras configuraciones DNS? Busca en Google:

Ejemplos:

Sistemas Mesh:

Opción 2: Configurar Dispositivos Individuales

Si no puedes configurar tu router o quieres probar en dispositivos específicos primero:

En Windows:

  1. Settings → Network & Internet → Change adapter options
  2. Clic derecho en tu conexión → Properties
  3. Selecciona “Internet Protocol Version 4 (TCP/IPv4)” → Properties
  4. Selecciona “Use the following DNS server addresses”
  5. DNS Preferido: Tu IP de AdGuard Home (ej., 192.168.1.100)
  6. Clic en OK

En macOS:

  1. System Preferences → Network
  2. Selecciona tu conexión → Advanced → DNS
  3. Clic en “+” y agrega tu IP de AdGuard Home
  4. Clic en OK y Apply

En iOS/Android:

  1. Settings → WiFi
  2. Toca tu red
  3. Configure DNS → Manual
  4. Agrega tu IP de AdGuard Home
  5. Guardar

Probando Tu Configuración

Después de configurar tu router o dispositivos, verifiquemos que todo esté funcionando:

Prueba 1: Verificar Query Log

  1. Abre el panel de AdGuard Home: http://TU_IP
  2. Ve a “Query Log”
  3. Navega un sitio web en tu teléfono o computadora
  4. Deberías ver consultas DNS apareciendo en tiempo real

Si no ves consultas: Tus dispositivos no están usando AdGuard Home. Verifica de nuevo las configuraciones DNS de tu router/dispositivo.

Prueba 2: Visitar un Sitio Web con Muchos Anuncios

  1. Visita un sitio conocido por anuncios (sitios de noticias, blogs, etc.)
  2. Los anuncios deberían estar bloqueados
  3. Verifica el panel de AdGuard Home - deberías ver consultas bloqueadas

Prueba 3: Probar Bloqueo de Anuncios

Visita: https://canyoublockit.com/

Este sitio prueba si tu bloqueador de anuncios está funcionando. Deberías ver mayormente marcas de verificación verdes.

Próximos Pasos

¡Tu AdGuard Home ahora está protegiendo toda tu red! En la Parte 4, exploraremos funciones avanzadas, aprenderemos sobre mantenimiento y solucionaremos problemas comunes.

Continuar a la Parte 4: Funciones Avanzadas y Mantenimiento →