AdGuard Home con Docker - Parte 1: Introducción y Prerequisitos

19 de enero de 2026 · 12 min. · networking ,privacy ,docker ,tutorial ,adguard ,raspberry-pi

Hace unos meses me cansé de ver anuncios en cada dispositivo de mi red doméstica. No solo los banners obvios, sino rastreadores, scripts de analítica y toda la recolección invisible de datos que ocurre en segundo plano.

Conocía Pi-hole y AdGuard Home - bloqueadores de anuncios a nivel de red que funcionan en la capa DNS. Pero cada guía que encontraba asumía que ya sabías lo que estabas haciendo. Te lanzaban comandos sin explicar qué significaban, se saltaban detalles cruciales, o asumían que tenías todo configurado correctamente.

Así que decidí escribir la guía que hubiera deseado tener cuando comencé. Esta es una serie completa - todo lo que necesitas en un solo lugar.

TL;DR / Inicio Rápido

Si tienes experiencia con Linux y Docker, aquí está la versión de 5 minutos:

  1. Hardware: Raspberry Pi 4 (2GB+) o cualquier máquina Linux
  2. SO: Raspberry Pi OS Lite (64-bit) recomendado
  3. Instalar Docker: curl -fsSL https://get.docker.com | sh
  4. Configurar IP Estática: Configura reserva DHCP en tu router
  5. Desplegar AdGuard Home:
    mkdir -p ~/adguardhome && cd ~/adguardhome
# Crea docker-compose.yml (ver Parte 3)
docker-compose up -d
  6. Configurar: Accede a http://TU_IP:3000 y completa el asistente de configuración
  7. Actualizar DNS del Router: Apunta el DNS primario de tu router a tu IP de AdGuard Home

¿Nuevo en esto? Sigue la guía detallada a continuación - explicamos todo paso a paso.

Tabla de Contenidos

  1. ¿Por Qué Bloqueo de Anuncios a Nivel de Red?
  2. AdGuard Home vs Pi-hole
  3. ¿Por Qué Docker?
  4. Prerequisitos - Lo Que Necesitarás
  5. Referencia Rápida: Atajos de Teclado
  6. Referencia Rápida de Editores de Texto

¿Por Qué Bloqueo de Anuncios a Nivel de Red?

El punto es este: las extensiones de navegador son geniales, pero solo funcionan en ese navegador específico en ese dispositivo específico. ¿Qué pasa con:

AdGuard Home soluciona todo esto bloqueando anuncios y rastreadores a nivel de red - antes de que siquiera lleguen a tus dispositivos.

AdGuard Home vs Pi-hole

Usé Pi-hole durante meses antes de cambiar a AdGuard Home. Esto es lo que descubrí:

Por Qué AdGuard Home Me Convenció

  1. Configuración Más Simple

    • Pi-hole: Instalador web complejo, gestión de dependencias, configuración manual de DNS
    • AdGuard Home: Un solo container Docker, asistente de configuración web, listo en 5 minutos

  2. Interfaz Moderna

    • Pi-hole: UI funcional pero anticuada, tiempos de respuesta más lentos
    • AdGuard Home: Panel limpio y responsivo con estadísticas en tiempo real

  3. HTTPS/DNS-over-HTTPS Integrado

    • Pi-hole: Requiere configuración adicional, gestión manual de certificados
    • AdGuard Home: Soporte nativo, integración fácil con Let’s Encrypt

  4. Mejores Opciones de Filtrado

    • Pi-hole: Blocklists básicas, soporte regex requiere aprender su sintaxis
    • AdGuard Home: Reglas de filtrado avanzadas, soporta sintaxis estilo AdBlock, controles parentales integrados

  5. Actualizaciones Más Fáciles

    • Pi-hole: Proceso de actualización de múltiples pasos, a veces falla
    • AdGuard Home: Descargar nueva imagen Docker, reiniciar - toma 30 segundos

  6. Búsqueda en Query Log

    • Pi-hole: Funcionalidad de búsqueda limitada
    • AdGuard Home: Filtrado potente, opciones de exportación, mejores analíticas

En Qué Pi-hole Es Mejor

Conclusión

Para este tutorial, me enfoco en AdGuard Home porque ofrece una interfaz moderna y configuración más simple basada en Docker. Pi-hole es una opción sólida y bien establecida con una comunidad más grande—ambas son excelentes opciones para bloqueo de anuncios a nivel de red.

Elige AdGuard Home si: Quieres la configuración más fácil, UI moderna y soporte HTTPS/DoH integrado.

Elige Pi-hole si: Prefieres un ecosistema maduro con extensas integraciones de terceros.

¿Por Qué Docker?

Podrías preguntarte: “¿Por qué no simplemente instalar AdGuard Home directamente?”

Docker hace todo más fácil:

Piensa en Docker como una app en tu teléfono - la instalas, funciona, puedes eliminarla limpiamente. La instalación directa es desordenada y complicada.

Ejemplo del Mundo Real:

Prerequisitos (Lo Que Necesitarás)

¿Por Qué Necesito un Dispositivo Dedicado?

Importante: AdGuard Home necesita funcionar 24/7 para proteger tu red. Por esto:

Piénsalo como tu router WiFi - necesita estar encendido todo el tiempo para que tu internet funcione.

Requisitos de Hardware (Tu Dispositivo)

Opciones Recomendadas (De Mejor a Peor)

  1. Raspberry Pi ⭐ MEJOR OPCIÓN

    • Modelos: Pi 4 (4GB u 8GB), Pi 5, o Pi 3B+
    • Costo: $35-75
    • Energía: Usa solo 2-8 watts
    • Tamaño: Del tamaño de una tarjeta de crédito
    • Perfecto para: Operación 24/7, bajo uso de energía

  2. Mini PC / Thin Client

    • Ejemplos: Intel NUC, HP/Dell Thin Clients, Lenovo ThinkCentre Tiny
    • Costo: $50-150 (usado), $200+ (nuevo)
    • Energía: 10-25 watts
    • Perfecto para: Más poder, mejor rendimiento, puede ejecutar otros servicios también

  3. Laptop Antigua

    • Mínimo: 2GB RAM, cualquier CPU de los últimos 10 años
    • Costo: Gratis (si tienes una)
    • Energía: 15-45 watts
    • Considera: Remover batería si siempre está conectada (previene hinchazón de batería)
    • Perfecto para: Reutilizar hardware antiguo, pantalla integrada para solucionar problemas

  4. PC de Escritorio Antigua

    • Mínimo: 2GB RAM, cualquier CPU
    • Costo: Gratis (si tienes una)
    • Energía: 50-150 watts (⚠️ costos de electricidad más altos)
    • Solo si: No tienes otras opciones
    • Considera: Puede costar $50-100/año en electricidad

  5. Orange Pi / Otras SBCs (Single Board Computers)

    • Similar a Raspberry Pi
    • A menudo más barata pero menos soporte de la comunidad
    • Buena alternativa si Raspberry Pi no está disponible

Lo Que También Necesitarás

Esencial:

Altamente Recomendado (Opcional - Puede ser omitido por usuarios experimentados):

Opcional (Pero Conveniente):

Operación Sin Pantalla (Sin Monitor) 💡 RECOMENDADO

Opcional - Usuarios experimentados pueden omitir esta sección

¿Qué es “sin pantalla”? Ejecutar tu dispositivo sin monitor, teclado o mouse.

¿Por qué sin pantalla?

  1. Ahorro de Costos

    • No necesitas comprar monitor, teclado o mouse
    • Raspberry Pi puede funcionar “sin pantalla” desde el inicio

  2. Ahorro de Espacio

    • El dispositivo puede estar junto a tu router
    • No se necesita espacio en escritorio

  3. Ahorro de Energía

    • Los monitores usan 20-40 watts
    • Sin monitor = menor factura de electricidad

  4. Configuración Profesional

    • Los servidores funcionan sin pantalla - así es como lo hacen los profesionales
    • Más confiable (menos componentes que puedan fallar)

Cómo gestionar dispositivo sin pantalla:

Opción 1: SSH (Secure Shell) - MEJOR MÉTODO ⭐

Opción 2: Conectar Cuando Sea Necesario

Recomendación:

Para este tutorial:

Requisitos de Software

Para Raspberry Pi

Descargar Raspberry Pi OS:

¿Qué Versión Deberías Descargar?

Tienes tres opciones principales:

  1. Raspberry Pi OS Lite (64-bit) ⭐ RECOMENDADO PARA ESTE PROYECTO

    • Mejor para: Operación sin pantalla (sin monitor)
    • Tamaño: Más pequeño (~400MB)
    • Sin entorno de escritorio - Perfecto para servidores ejecutándose 24/7
    • Recomendado para: Pi 3B+, Pi 4, Pi 5 con 2GB+ RAM
    • Por qué elegir esto: Menor uso de RAM, rendimiento más rápido, perfecto para AdGuard Home

  2. Raspberry Pi OS with Desktop (64-bit)

    • Mejor para: Si quieres una interfaz gráfica
    • Tamaño: Mediano (~1GB)
    • Incluye: Entorno de escritorio, apps básicas
    • Recomendado para: Pi 4, Pi 5 con 4GB+ RAM
    • Por qué elegir esto: Más fácil de solucionar problemas con interfaz visual, bueno para principiantes

  3. Raspberry Pi OS Full (64-bit)

    • Mejor para: Usar Pi como computadora de escritorio
    • Tamaño: Grande (~2.5GB)
    • Incluye: Escritorio + software recomendado
    • No recomendado: Demasiada sobrecarga para un servidor

32-bit vs 64-bit:

Cómo Instalar:

  1. Descarga Raspberry Pi Imager desde https://www.raspberrypi.com/software/

  2. Inserta tu tarjeta microSD en tu computadora

  3. Abre Raspberry Pi Imager

  4. Elige Dispositivo: Selecciona tu modelo de Raspberry Pi

    Seleccionar dispositivo Raspberry Pi

  5. Elige SO: Raspberry Pi OS Lite (64-bit)

    Seleccionar sistema operativo

  6. Elige Almacenamiento: Selecciona tu tarjeta microSD

    Seleccionar almacenamiento

  7. Configuración de Personalización: Después de seleccionar el dispositivo, SO y almacenamiento, se abrirá automáticamente el menú de personalización. Aquí es donde configurarás:

    Hostname: Establece un nombre para tu Pi (ej., pilab)

    Configurar hostname

    Localización: Configura tu zona horaria y distribución de teclado

    Configurar localización

    Usuario: Crea tu nombre de usuario y contraseña

    Configurar usuario

    WiFi: Configura tu red WiFi (si no usas ethernet)

    Configurar WiFi

    SSH: Habilita SSH (¡muy importante para sin pantalla!)

    Habilitar SSH

    Raspberry Pi Connect: Opcionalmente habilita Pi Connect (puede omitirse)

    Raspberry Pi Connect

  8. Revisa y Escribe: Revisa tu configuración

    Revisar configuración

  9. Confirma: Confirma que quieres sobrescribir la tarjeta SD (¡esto borrará todos los datos!)

    Confirmar escritura

  10. Proceso de Escritura: Espera a que el proceso de escritura termine

    Progreso de escritura

  11. ¡Completado!: Una vez que veas “Write complete”, puedes expulsar la tarjeta SD de forma segura

    Escritura completada

Consejo Pro: ¡El Raspberry Pi Imager puede configurar SSH y WiFi durante el proceso de instalación - esto te ahorra tiempo!

Para Laptop/Escritorio Antigua

Conexión a Internet

Configuración de Red: Dónde Conectar Tu Dispositivo

AdGuard Home puede funcionar con cualquier configuración de red:

Opción 1: Conexión Directa al Router (Recomendado)

Opción 2: Conexión a Red Mesh

Opción 3: Conexión a Switch de Red

Opción 4: Conexión WiFi

Notas Importantes de Red:

⚠️ La Configuración del Router Varía por Marca

⚠️ Configuración DNS de Sistema Mesh

⚠️ Combos Router/Módem del ISP

Conclusión: ¡Mientras tu dispositivo AdGuard Home pueda conectarse a tu red y puedas acceder a las configuraciones de tu router para cambiar DNS, estás listo!

Referencia Rápida: Atajos de Teclado Esenciales

Atajos de Terminal

¿Nuevo en línea de comandos? ¡No te preocupes! Cada comando se explica en términos simples.

Referencia Rápida de Editores de Texto

Este tutorial usa vim como editor de texto de línea de comandos para editar archivos de configuración. Aquí están los esenciales:

Instalando Vim

Primero, instala vim si no lo tienes:

sudo apt update && sudo apt install vim -y

Usando Vim

Abrir un archivo:

vim filename.txt

Vim tiene dos modos:

Comandos esenciales:

Para Hacer EstoPresiona
Empezar a escribiri (entra en modo Insertar)
Dejar de escribirEsc (volver a modo Normal)
Guardar y salirEsc, luego escribe :wq y presiona Enter
Salir sin guardarEsc, luego escribe :q! y presiona Enter
Deshaceru (en modo Normal)

Si te quedas atascado en Vim:

  1. Presiona Esc varias veces
  2. Escribe :q! y presiona Enter

Pegar texto: Presiona i para entrar en modo Insertar, luego clic derecho o Ctrl+Shift+V

Copiar y Pegar en Terminal

Nota: ¡Ctrl+C y Ctrl+V regulares no funcionan en terminal!

Próximos Pasos

Ahora que comprendes los prerequisitos y tienes tu hardware listo, continúa a la Parte 2 donde configuraremos SSH, instalaremos Docker y configuraremos una dirección IP estática.

Continuar a la Parte 2: Configuración del Sistema →