AdGuard Home con Docker - Parte 2: Configuración del Sistema

20 de enero de 2026 · 9 min. · networking ,privacy ,docker ,tutorial ,adguard ,raspberry-pi

En esta parte, prepararemos tu Raspberry Pi o dispositivo para ejecutar AdGuard Home configurando acceso SSH, instalando Docker y configurando una dirección IP estática.

Tabla de Contenidos

  1. Configurando SSH (Operación Sin Pantalla)
  2. Instalando Docker
  3. Configurando una Dirección IP Estática

Configurando SSH (Operación Sin Pantalla)

Omite esta sección si: Estás sentado frente a tu dispositivo con monitor y teclado conectados.

Sigue esta sección si: Quieres controlar tu dispositivo remotamente desde otra computadora (¡recomendado!)

¿Qué es SSH?

SSH (Secure Shell) te permite controlar tu Raspberry Pi o dispositivo Linux desde otra computadora. Es como escritorio remoto, pero basado en texto y mucho más rápido.

Beneficios:

Habilitando SSH en Raspberry Pi

Método 1: Habilitar Antes del Primer Arranque (Más Fácil para Configuración Sin Pantalla)

Si aún no has iniciado tu Raspberry Pi:

  1. Graba Raspberry Pi OS en la tarjeta SD (usando Raspberry Pi Imager)
  2. Abre la tarjeta SD en tu computadora
  3. Crea un archivo vacío llamado ssh (sin extensión) en la partición boot
    • Windows: Clic derecho → Nuevo → Documento de texto → Nómbralo ssh (remueve .txt)
    • Mac/Linux: Abre terminal y ejecuta: touch /Volumes/boot/ssh
  4. Expulsa la tarjeta SD y ponla en tu Raspberry Pi
  5. SSH está ahora habilitado cuando el Pi arranca

Método 2: Habilitar Después del Arranque (Si Tienes Monitor/Teclado)

Si tu Raspberry Pi ya está ejecutándose:

  1. Abre terminal en el Raspberry Pi
  2. Ejecuta este comando:
    sudo raspi-config
  3. Navega a: Interface Options → SSH
  4. Selecciona: Yes (para habilitar SSH)
  5. Reinicia: sudo reboot

Método 3: Habilitar desde Escritorio (Raspberry Pi OS con GUI)

  1. Clic en Raspberry Pi Menu (arriba a la izquierda)
  2. Preferences → Raspberry Pi Configuration
  3. Pestaña Interfaces
  4. Habilita SSH
  5. Clic en OK

Habilitando SSH en Ubuntu/Debian (Laptop/Escritorio)

# Instalar servidor SSH
sudo apt update
sudo apt install openssh-server -y

# Iniciar servicio SSH
sudo systemctl enable ssh
sudo systemctl start ssh

# Verificar estado
sudo systemctl status ssh

Deberías ver “active (running)” en verde.

Encontrando la Dirección IP de Tu Dispositivo

Necesitas la dirección IP para conectarte vía SSH.

En el dispositivo mismo:

hostname -I

Salida de ejemplo: 192.168.1.100

O desde otra computadora:

¡Anota esta dirección IP! La necesitarás para conectarte.

Conectándose vía SSH

Ahora conéctate desde tu computadora principal (laptop/escritorio):

En Windows:

Opción 1: Usando PowerShell o Command Prompt (Windows 10/11)

  1. Abre PowerShell (busca “PowerShell” en el menú Inicio)

  2. Escribe:

    ssh pi@192.168.1.100

    (Reemplaza 192.168.1.100 con la dirección IP de tu dispositivo) (Reemplaza pi con tu nombre de usuario si es diferente)

  3. Primera vez: Verás “Are you sure you want to continue?” → Escribe yes

  4. Ingresa tu contraseña (predeterminada para Pi: raspberry)

Opción 2: Usando PuTTY (Método Clásico)

  1. Descarga PuTTY desde https://www.putty.org/
  2. Ejecuta PuTTY
  3. Ingresa la dirección IP de tu dispositivo en “Host Name”
  4. Puerto: 22
  5. Clic en “Open”
  6. Inicia sesión con tu nombre de usuario y contraseña

En Mac/Linux:

  1. Abre Terminal

  2. Escribe:

    ssh pi@192.168.1.100

    (Reemplaza 192.168.1.100 con la dirección IP de tu dispositivo) (Reemplaza pi con tu nombre de usuario si es diferente)

  3. Primera vez: Escribe yes cuando se te pregunte

  4. Ingresa tu contraseña

¡Ahora Estás Conectado! 🎉

Verás un prompt como:

pi@raspberrypi:~ $

¡Esto significa que estás controlando tu dispositivo remotamente! Cualquier comando que escribas aquí se ejecuta en tu Raspberry Pi/dispositivo, no en tu computadora local.

Consejos Rápidos de SSH

Copiando y Pegando en SSH:

Salir de SSH:

exit

O presiona Ctrl+D

Reconectar: ¡Solo ejecuta el comando SSH de nuevo - tu dispositivo sigue ejecutándose!

Consejo Pro: Mantén tu ventana SSH abierta mientras sigues este tutorial. ¡Todos los comandos funcionan exactamente igual vía SSH!

Consejos de Seguridad SSH

Opcional - Endurecimiento de seguridad avanzado (puede omitirse)

Cambiar Contraseña Predeterminada:

passwd

Sigue las indicaciones para establecer una nueva contraseña. ¡Haz esto inmediatamente si usas la contraseña predeterminada!

Opcional: Usar Llaves SSH (Más Seguro)

Las llaves SSH te permiten conectarte sin escribir una contraseña. Esto es más seguro y conveniente.

En tu computadora local (no el Pi):

# Generar llave SSH (si no tienes una)
ssh-keygen -t ed25519

# Copiar llave a tu dispositivo
ssh-copy-id pi@192.168.1.100

¡Ahora puedes conectarte sin contraseña!

Solucionando Problemas de SSH

“Connection refused”

“Connection timed out”

“Permission denied”

Instalando Docker

Nota Sobre Esta Sección

Si estás usando SSH: ¡Todos los comandos a continuación funcionan exactamente igual! Solo escríbelos en tu ventana SSH en lugar de una terminal local.

Si tienes monitor/teclado: Puedes seguir directamente en tu dispositivo.

Paso 1: Abrir la Terminal

¿Qué es una terminal? Es una ventana basada en texto donde escribes comandos para controlar tu dispositivo.

Paso 2: Actualizar Tu Sistema

Copia y pega este comando en la terminal, luego presiona Enter:

sudo apt update && sudo apt upgrade -y

Qué hace esto: Actualiza todo el software en tu dispositivo a las últimas versiones.

Nota: Puede que se te pida tu contraseña. Escríbela (no la verás en pantalla) y presiona Enter.

Paso 3: Instalar Docker

¿Qué es Docker? Es una herramienta que ejecuta programas en containers aislados, haciendo la instalación mucho más fácil.

Copia y pega estos comandos uno a la vez:

curl -fsSL https://get.docker.com -o get-docker.sh
sudo sh get-docker.sh

Qué hace esto: Descarga y ejecuta el instalador automático de Docker. Esto tomará unos minutos.

Paso 4: Agregar Tu Usuario al Grupo Docker

Esto te permite usar Docker sin escribir sudo cada vez:

sudo usermod -aG docker $USER

Importante: Después de ejecutar este comando, debes cerrar sesión e iniciar sesión de nuevo para que funcione.

Paso 5: Habilitar Docker para Iniciar Automáticamente

Estos comandos hacen que Docker se inicie cada vez que enciendas tu dispositivo:

sudo systemctl enable docker
sudo systemctl start docker

Paso 6: Probar Instalación de Docker

Asegurémonos de que Docker esté funcionando:

docker --version

Deberías ver algo como “Docker version 24.0.7”

Ahora pruébalo con un comando simple:

docker run hello-world

¡Éxito! Si ves “Hello from Docker!” todo está funcionando correctamente.

Configurando una Dirección IP Estática (¡CRÍTICO!)

Por Qué Necesitas una IP Estática

IMPORTANTE: Por defecto, tu router asigna direcciones IP dinámicamente (DHCP). Esto significa que la dirección IP de tu Raspberry Pi puede cambiar después de un reinicio o corte de energía.

Qué sucede si la IP cambia:

Solución: Establece una dirección IP estática para que NUNCA cambie.

Opción 1: Establecer IP Estática en Tu Router (Recomendado)

Este es el método más fácil y confiable. La mayoría de routers te permiten “reservar” una dirección IP para un dispositivo específico.

Para Sistemas Mesh

Ejemplo TP-Link Deco 6:

  1. Abre la app Deco
  2. Toca en la pestaña “Network” en la parte inferior
  3. Encuentra tu Raspberry Pi/dispositivo en la lista de dispositivos
  4. Toca en él para abrir detalles del dispositivo
  5. Desplázate hacia abajo y toca “Reserve IP” o “Address Reservation”
  6. Actívalo (toggle ON)
  7. La IP actual se reservará permanentemente

Otros Sistemas Mesh: Si usas un sistema mesh diferente (Google WiFi, Eero, Netgear Orbi, etc.), el proceso es similar. Busca “Address Reservation,” “IP Reservation,” o “Static IP” en la configuración de la app de tu sistema mesh. Busca en Google: “TU_MODELO_MESH reserve IP address” o consulta el manual de tu dispositivo.

Para Routers Regulares

Pasos Generales (varía según marca de router):

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

    ip link show

    Busca tu interfaz de red (eth0 para ethernet, wlan0 para WiFi) La dirección MAC se ve así: b8:27:eb:xx:xx:xx

    O más simple:

    ifconfig | grep ether

  2. Accede al panel de administración de tu router:

    • Usualmente: 192.168.1.1, 192.168.0.1, o 192.168.1.254
    • Ingresa credenciales de administrador

  3. Encuentra Reserva DHCP / IP Estática / Reserva de Dirección:

    • Ubicaciones comunes:
      • “Advanced” → “LAN Setup” → “Address Reservation”
      • “DHCP Server” → “Address Reservation”
      • “Network” → “DHCP” → “Static Lease”
      • “LAN” → “DHCP Reservation”

  4. Agrega una reserva:

    • Dirección MAC: Ingresa la dirección MAC que encontraste
    • Dirección IP: Ingresa la IP que quieres usar (ej., 192.168.1.100)
    • Guarda configuraciones

  5. Reinicia tu router y dispositivo

Ejemplos Específicos de Router:

Busca en Google:

Opción 2: Establecer IP Estática en el Dispositivo

Usa esto si: Tu router no soporta reservas DHCP O prefieres configurarlo en el dispositivo mismo.

En Raspberry Pi (Raspberry Pi OS):

  1. Encuentra los detalles de tu red:

    ip route | grep default

    Esto muestra tu gateway (IP del router), usualmente 192.168.1.1

    cat /etc/resolv.conf

    Esto muestra tu servidor DNS actual

  2. Edita la configuración de red:

    sudo vim /etc/dhcpcd.conf

  3. Desplázate hasta el final y agrega (reemplaza con tus valores):

    interface eth0
static ip_address=192.168.1.100/24
static routers=192.168.1.1
static domain_name_servers=1.1.1.1 8.8.8.8

    Qué significa cada línea:

    • interface eth0 - Conexión Ethernet (usa wlan0 para WiFi)
    • static ip_address=192.168.1.100/24 - La IP estática que quieres
    • static routers=192.168.1.1 - La IP de tu router (gateway)
    • static domain_name_servers=1.1.1.1 8.8.8.8 - DNS temporal (Cloudflare y Google)

  4. Guardar y salir:

    • Presiona Esc, luego escribe :wq y presiona Enter

  5. Reiniciar:

    sudo reboot

  6. Verificar que la IP esté establecida:

    hostname -I

En Ubuntu/Debian (usando Netplan):

  1. Encuentra tu interfaz de red:

    ip a

    Busca tu interfaz (usualmente eth0, enp0s3, etc.)

  2. Edita la configuración Netplan:

    sudo vim /etc/netplan/01-netcfg.yaml

  3. Reemplaza el contenido con:

    network:
  version: 2
  ethernets:
    eth0:
      dhcp4: no
      addresses:
        - 192.168.1.100/24
      gateway4: 192.168.1.1
      nameservers:
        addresses: [1.1.1.1, 8.8.8.8]

    Nota: Reemplaza eth0 con el nombre de tu interfaz, y ajusta las IPs para tu red.

  4. Guardar y aplicar:

    sudo netplan apply

  5. Verificar:

    ip a

¿Qué Dirección IP Deberías Usar?

Elige una IP fuera del rango DHCP de tu router:

La mayoría de routers usan:

Verifica el rango DHCP de tu router:

  1. Accede al panel de administración del router
  2. Busca configuraciones DHCP
  3. Nota la “IP Inicial” y la “IP Final”
  4. Elige una IP fuera de este rango

Opciones seguras comunes:

¡Anota tu IP estática! La necesitarás para el resto de esta guía.

Próximos Pasos

¡Tu sistema está ahora listo! Tienes acceso SSH, Docker instalado y una IP estática configurada. En la Parte 3, instalaremos AdGuard Home y configuraremos tu red para usarlo.

Continuar a la Parte 3: Instalando AdGuard Home →