Cómo instalar AdGuardian-Term en Docker - Dashboard TUI monitoreo real-time AdGuard Home autohospedado

AdGuardian-Term | TUI Monitoring | Docker

AdGuardian-Term en Docker: Dashboard TUI terminal para monitoreo real-time de AdGuard Home autohospedado (Rust, ttyd compatible)

TUI terminal monitoreo real-time AdGuard Home DNS blocker. Dashboard interactivo Rust. Estadísticas live (queries, bloqueados, tasa bloqueo). Query log con upstream DNS. Charts ASCII. Integrable ttyd (web browser). Multi-threaded async. MIT open source.

¿Qué es AdGuardian-Term?

AdGuardian-Term es un dashboard de monitoreo terminal (TUI) construido en Rust para visualizar en tiempo real el tráfico DNS, estadísticas de bloqueo y consultas de una instancia AdGuard Home autohospedada, permitiendo monitoreo eficiente sin interfaz web (incluso embebible en navegadores web vía ttyd). Es la herramienta perfecta para homelabs sin IU web accesible.

Propuesta clave: Dashboard TUI terminal (Rust, ultra-rápido). Monitoreo real-time AdGuard Home. Estadísticas live: total queries, bloqueados, tasa bloqueo %, upstream DNS usado. Query log interactivo (scrolleable, filtrable). Charts ASCII (queries over time). Integración ttyd (embeber en navegador web o iframe). Integración gotty alternativa. Responsive terminal. Multi-threaded async (zero lag). Soporte Docker (imagen multi-stage). Compilable source (Rust). MIT open source. Comunidad activa (1.5K+ GitHub stars).

Características principales: Monitor real-time estadísticas AdGuard Home (queries totales, bloqueadas, % tasa bloqueo, tiempo promedio). Query log con filtros (cliente, dominio, estado). Mostrar upstream DNS usado por cada query. Charts ASCII historiales queries. Tablas formatadas coloridas. Actualización automática 1-2 seg. Interfaz keyboard-friendly (navegación con arrow keys). Soporte dark/light terminal. Integración ttyd (expose en browser con seguridad). Integración gotty alternativa. Responsivo terminal redimensionable. Multi-threaded async (API polling non-blocking). Auth env vars (user, pass, ApiKey). Docker image lissy93/adguardian. Compilable Rust desde source. Health checks. CI/CD pipeline. MIT open source. Documentación completa. Comunidad GitHub activa.

Para AdGuard Home: Monitoreo terminal sin web UI. Real-time stats. Query log. Embebible navegador (ttyd). TUI eficiente.

Características principales

Dashboard TUI real-time

Estadísticas live. Queries, bloqueados, %. Updates 1-2 seg.

Query log interactivo

Listado queries. Cliente, dominio, status. Scrolleable.

Upstream DNS tracking

Ve qué upstream DNS manejó cada query. Per-query visibility.

Charts ASCII históricos

Gráficos queries over time. Visualización tendencias.

Integración ttyd (web UI)

Embeber TUI en navegador. Acceso remoto terminal.

Integración gotty alternativa

Otra opción exponer terminal web. Similar ttyd.

Rust ultra-rápido

Multi-threaded async. Zero lag. Performance excelente.

Keyboard-friendly navigation

Arrow keys, Page Up/Down, Ctrl+C. Workflow rápido.

Dark/Light terminal modes

Respeta terminal theme. Eye-friendly. Auto-adapt.

Docker image multi-stage

Imagen optimizada. lissy93/adguardian. Multiarch.

Auth via env vars

AdGuard user, pass, API key via -e flags. Secure.

MIT open source

Código abierto. Comunidad 1.5K+ stars. Activamente mantenido.

Requisitos del sistema

  • Docker (o Rust + cargo si compilas)
  • 50 MB - 200 MB RAM mínimo (muy ligero, Rust)
  • Instancia AdGuard Home corriendo (local red o remota)
  • Credenciales AdGuard (usuario, contraseña o API key)
  • Terminal emulator moderno (para TUI)
  • Opcional: ttyd (para exponer en navegador)
  • Opcional: docker-compose si quieres Compose file
Setup ultra-simple: Un comando Docker + env vars. 5 segundos running.

Instalación con Docker

Opción 1: Docker run simple (recomendado)

docker run -it \ -e ADGUARD_HOST=http://192.168.1.10:3000 \ -e ADGUARD_USER=admin \ -e ADGUARD_PASS=tu_contraseña \ lissy93/adguardian # Si usas API key en lugar de pass: docker run -it \ -e ADGUARD_HOST=http://192.168.1.10:3000 \ -e ADGUARD_KEY=tu_api_key \ lissy93/adguardian

Opción 2: Docker Compose

cat > docker-compose.yml << 'EOF' version: '3.8' services: adguardian: image: lissy93/adguardian:latest container_name: adguardian stdin_open: true tty: true environment: # URL AdGuard Home (reemplaza IP/puerto) - ADGUARD_HOST=http://192.168.1.10:3000 # Credenciales (usa USER+PASS o KEY, no ambas) - ADGUARD_USER=admin - ADGUARD_PASS=tu_contraseña_fuerte # O si usas API key: # - ADGUARD_KEY=tu_api_key_aqui EOF docker compose up -it

Opción 3: Con ttyd (embeber en navegador web)

docker run -d \ -p 7681:7681 \ -e ADGUARD_HOST=http://192.168.1.10:3000 \ -e ADGUARD_USER=admin \ -e ADGUARD_PASS=tu_contraseña \ lissy93/adguardian:ttyd # Acceso: http://localhost:7681 (navegador)

Primeras pruebas

Una vez corriendo, verás el TUI terminal en directo mostrando:

  • Total queries desde inicio AdGuard
  • Queries bloqueadas (malware, tracking, ads)
  • Tasa bloqueo %
  • Query log live (scrolleable)
  • Charts ASCII históricos

Primeros pasos

1. Encontrar URL y credenciales AdGuard Home

  1. Localiza IP AdGuard: 192.168.1.10:3000 (típico)
  2. Abre web UI: http://192.168.1.10:3000
  3. Si tiene contraseña, anótala (o crea API key en Settings)

2. Ejecutar AdGuardian-Term

docker run -it \ -e ADGUARD_HOST=http://192.168.1.10:3000 \ -e ADGUARD_USER=admin \ -e ADGUARD_PASS=tu_contraseña \ lissy93/adguardian

3. Ver dashboard TUI en vivo

  1. Terminal abre con interfaz colorida
  2. Arriba: estadísticas principales (queries, bloqueados, %)
  3. Abajo: query log tabla viva (updates 1-2 seg)
  4. Derecha: charts ASCII históricos queries

4. Navegar con teclado

Arrow Keys: navegación tablas ↑↓←→ Scroll arriba/abajo, izq/der Page Up/Page Down Scroll rápido tabla Ctrl+C Salir AdGuardian-Term Tab Cambiar panels (si multiselect)

5. Ver query log detallado

  1. Tabla central muestra: Time, Domain, Client IP, Status
  2. Status: ✅ (permitido), ❌ (bloqueado), ⚠ (otros)
  3. Scroll con arrow keys para ver más queries

6. Upstream DNS column (si v1.5+)

  1. Query log tabla incluye upstream DNS resolver usado
  2. Útil ver qué resolver maneja cada query
  3. En pantallas pequeñas, upstream puede esconderse (responsive)

7. Charts históricos (parte derecha)

  1. Gráfico ASCII muestra queries over time (últimas horas/mins)
  2. Escala automática
  3. Visualiza tendencias uso DNS

8. Integrar ttyd (acceso navegador)

  1. Usa imagen tag: lissy93/adguardian:ttyd
  2. Expone puerto 7681
  3. Accede: http://localhost:7681 en navegador
  4. TUI terminal renderizado en web

9. Usar API key en lugar de password

  1. AdGuard Home: Settings → API
  2. Genera API key (si disponible)
  3. Usa: -e ADGUARD_KEY=tu_api_key en lugar de PASS
  4. Más seguro que hardcoding password

10. Logs en segundo plano (sin terminal interactiva)

docker logs -f adguardian # Ve conexión logs, errors, debug info

Casos de uso

  • Monitoreo homelab CLI: Dashboard terminal sin web UI. Real-time stats DNS.
  • Dashboards embebidos: Ttyd embeber en otras apps/dashboards (Dashy, etc).
  • Troubleshooting DNS: Ver query log live. Identificar bloqueos específicos.
  • Servidores headless: SSH access. Terminal-only monitoring. Zero web overhead.
  • Monitoreo remoto seguro: ttyd + HTTPS Caddy. TUI acceso navegador seguro.
  • Raspberry Pi / bajo recursos: Rust super-ligero. Minimal CPU/RAM.

HTTPS con Caddy (si usas ttyd remoto)

Caddyfile (exponer ttyd remoto seguro)

adguardian.tudominio.com { reverse_proxy localhost:7681 # Opcional: autenticación basicauth / { usuario contraseña_hash } }

Acceso remoto seguro

https://adguardian.tudominio.com con HTTPS automático + login

Gestión y mantenimiento

Ver logs

docker logs -f adguardian # Conexión, errores, debug info

Reiniciar container

docker restart adguardian

Actualizar a versión más reciente

docker pull lissy93/adguardian:latest docker run -it \ -e ADGUARD_HOST=... \ lissy93/adguardian:latest

Compilar desde source (Rust)

git clone https://github.com/Lissy93/AdGuardian-Term.git cd AdGuardian-Term cargo build --release ./target/release/adguardian

Monitorear consumo (ultra-ligero)

docker stats adguardian # Típicamente: <50MB RAM, <1% CPU (muy eficiente Rust)

Cambiar env vars dinámicamente

docker stop adguardian docker run -it \ -e ADGUARD_HOST=http://nueva_ip:3000 \ -e ADGUARD_USER=admin \ -e ADGUARD_PASS=nueva_pass \ lissy93/adguardian

Comparativa con alternativas

vs AdGuard Home web UI

AdGuardian gana: Terminal real-time, ligero, CLI-friendly, embed-able. Web UI gana: Interfaz visual, más opciones config, settings management.

vs Unbound + DNSviz

AdGuardian gana: Específico AdGuard, real-time queries. DNSviz gana: Análisis profundo DNS, general-purpose.

vs Grafana + Prometheus (AdGuard exporter)

AdGuardian gana: Simple, ligero, cero setup. Grafana gana: Historiales long-term, alertas, dashboards flexibles.

Mejor para: Monitoreo AdGuard terminal. TUI eficiente. Real-time queries. Homelabs headless.

Referencias oficiales

Apoya el canal GENBYTE

Suscríbete al canal de YouTube Suscríbete a la newsletter semanal Invítame a un Ko-fi genbyte@proton.me

Sígueme en mis redes sociales

Telegram Discord YouTube GitHub Blog Twitter

Comentarios

Publicar un comentario

Entradas populares de este blog

Cómo Instalar y configurar SERVIDOR VPN WIREGUARD en MIKROTIK 🔐 #VPN #Wireguard #Mikrotik #RouterOS

Imagen
Wireguard en Mikrotik Breve Explicación de Wireguard ¿Qué es WireGuard VPN? WireGuard es un nuevo protocolo de VPN. No se trata de un software, sino de un conjunto de instrucciones que permite crear VPNs de forma muy sencilla. Ha sido desarrollada como una alternativa a IPsec, OpenVPN y similares VPNs, pero más rápida y sencilla de usar. En esencia, WireGuard está basado en ideas del protocolo IPsec. WireGuard es una VPN extremadamente simple, pero rápida y moderna que utiliza criptografía de última generación. Su objetivo es ser más rápido, más simple, y más versátil que IPSec, evitando al mismo tiempo el enorme dolor de cabeza (sobre todo en redes con NAT). Pretende ser considerablemente más eficaz que OpenVPN. WireGuard está diseñado como una VPN de propósito general para ejecutarse en interfaces embebidas, apto para muchas circunstancias diferentes. Se ejecuta sobre el protocolo UDP, por lo tanto es considerado un túnel de capa 3. ¿Cómo funciona Wireguard VPN? WireGuard es un proto...
Read more »

Cómo instalar y configurar DSM SYNOLOGY 7.2.2 en PC | Guía completa, instalación, RAID 1, SMB

Imagen
Instalación y puesta en marcha de Synology DSM 7.2.2 en PC Vídeo ACTUALIZADO, NUEVA VERSIÓN DEL ARC LOADER:  https://youtu.be/LgghogL-UCA https://genbyte.blogspot.com/2025/08/como-convertir-pc-en-synlogy-con-6-tb.html ----- Proceso de instalación y puesta en marcha de sistema operativo DSM Synology versión 7.2.2 en un PC, concretamente un HP 800 G1 EliteDesk. El PC tendrá 3 discos SSD, uno de 120 GB para el S.O. DSM, y otros dos de 240GB cada en RAID 1 para los Datos. Los 3 dicos duros conectados al PC mediante cables SATA. Lo primero que necesitamos es descargar la imagen bootloader ARC, desde el siguiente repositorio de Gothub, también necesitamos Rufus, en este momento, es la versión 4.6. Imagen ARC:  https://github.com/AuxXxilium/arc Imagen usado en el vídeo 1.1.29:  https://github.com/AuxXxilium/arc/releases/tag/1.1.29 Rufus:  https://rufus.ie/es/ Después de descargar la imagen ARC.img, conectamos nuestro primer disco SSD de 120GB por cable o conector SATA-USB y...
Read more »

Cómo INSTALAR y CONFIGURAR OpenVPN en MIKROTIK. Guía completa paso a paso.

Imagen
Cómo INSTALAR y CONFIGURAR OpenVPN en MIKROTIK. Guía completa paso a paso. Vídeo tutorial paso a paso en Youtube Desarrollo Ilustración: Diagrama RED Creación de Redes (Address) ----------------------------------------------- WAN 192.168.1.0/24 LAN 192.168.88.0/24 VPN 192.168.100.0/24 Creación del Rango VPN ------------------------ 192.168.100.1 - 192.168.100.100 Creación de los Certificados ------------------------------- Los certificados que vamos a crear a continuación tendrán una validez de 10 años; days-valid=3650 Crear certificado CA ---------------------- /certificate add name=CA-tpl country="" state="" locality="" organization="" unit="" common-name="CA" key-size=4096 days-valid=3650 key-usage=crl-sign,key-cert-sign /certificate sign CA-tpl ca-crl-host=127.0.0.1 name="CA" Crear certificado Server -------------------------- /certificate add name=SERVER-tpl country="" state="" locality=...
Read more »