Rol de Ansible: AdguardHome

Descripción

Despliega y gestiona el servicio AdGuardHome usando ansible.

Para obtener información completa sobre la configuración, visita Configuración de AdGuardHome.

Restablecer contraseña web

AdGuard Home almacena la contraseña como un hash codificado en BCrypt.

La contraseña predeterminada del rol es "admin".

Aquí tienes lo que necesitas hacer para cambiar la contraseña:

• Deten AdGuard Home
• Edita el archivo AdGuardHome.yaml
• Busca el campo de la contraseña allí
• Sustitúyelo con el nuevo valor. Puedes usar la herramienta htpasswd o cualquier herramienta generadora de BCrypt en línea (hay muchas disponibles).
• Inicia AdGuard Home
• Ahora podrás iniciar sesión en la interfaz web con tu nueva contraseña.

Ejemplo usando htpasswd:

htpasswd -bnBC 10 "" MI_NUEVA_CONTRASEÑA | tr -d ':'

Configuración en WebUI

:bangbang:	Cuando termines tu configuración en WebUI, guarda tu configuración en variables de hosts.

Requisitos

• Ansible >= 2.9 (Podría funcionar en versiones anteriores, pero no podemos garantizarlo)

Variables de rol

Todas las variables que se pueden sobrescribir están almacenadas en el archivo defaults/main.yml así como en la tabla a continuación.

Nombre	Valor Predeterminado	Descripción
proxy_env	{}	Variables de entorno del proxy para el cliente
adguard_version	0.107.0	Versión del paquete AdGuardHome. También acepta latest como parámetro.
adguard_web_listen_address	0.0.0.0	Dirección en la que AdGuard Home escuchará
adguard_web_listen_port	3200	Puerto en el que AdGuard Home escuchará
adguard_config_dir	/etc/adguard	Ruta al directorio con la configuración de AdGuard Home
adguard_db_dir	/var/lib/adguard	Ruta al directorio con la base de datos de AdGuard Home
adguard_binary_install_dir	/usr/local/bin	Directorio de instalación del binario
adguard_system_user	"{{ prometheus_user	default('adguard') }}"
adguard_system_group	"{{ prometheus_group	default('adguard') }}"
adguard_limit_nofile	8192	Límite de NoFile
#adguard_http_proxy	http://proxy:3128	Establecer Proxy en el sistema como entorno
#adguard_https_proxy	http://proxy:3128	Establecer Proxy en el sistema como entorno
adguard_config	{}	Configuración de AdGuardHome

Ejemplo

---
adguard_config:
  bind_host: "{{ adguard_web_listen_address }}"
  bind_port: "{{ adguard_web_listen_port }}"
  beta_bind_port: 0
  users:
  - name: admin
    # la contraseña es: admin
    # puedes generar una en https://bcrypt-generator.com/
    # o con "htpasswd -bnBC 10 "" MI_NUEVA_CONTRASEÑA | tr -d ':'"
    password: $2y$12$SMsrAS0r0FPvpBPDPJygD.GO7V7jeUd2GI2KN.l.rubeV6aKVauEy
  auth_attempts: 5
  block_auth_min: 15
  http_proxy: ""
  language: ""
  debug_pprof: false
  web_session_ttl: 720
  dns:
    bind_hosts:
    - "{{ adguard_web_listen_address }}"
    port: 53
    statistics_interval: 1
    querylog_enabled: true
    querylog_file_enabled: true
    querylog_interval: 2160h
    querylog_size_memory: 1000
    anonymize_client_ip: false
    protection_enabled: true
    blocking_mode: default
    blocking_ipv4: ""
    blocking_ipv6: ""
    blocked_response_ttl: 10
    parental_block_host: family-block.dns.adguard.com
    safebrowsing_block_host: standard-block.dns.adguard.com
    ratelimit: 20
    ratelimit_whitelist: []
    refuse_any: true
    upstream_dns:
    - https://dns10.quad9.net/dns-query
    upstream_dns_file: ""
    bootstrap_dns:
    - 9.9.9.10
    - 149.112.112.10
    - 2620:fe::10
    - 2620:fe::fe:10
    all_servers: false
    fastest_addr: false
    allowed_clients: []
    disallowed_clients: []
    blocked_hosts:
    - version.bind
    - id.server
    - hostname.bind
    cache_size: 4194304
    cache_ttl_min: 0
    cache_ttl_max: 0
    bogus_nxdomain: []
    aaaa_disabled: false
    enable_dnssec: false
    edns_client_subnet: false
    max_goroutines: 300
    ipset: []
    filtering_enabled: true
    filters_update_interval: 24
    parental_enabled: false
    safesearch_enabled: false
    safesearch_cache_size: 1048576
    parental_cache_size: 1048576
    cache_time: 30
    rewrites: []
    blocked_services: []
    upstream_timeout: 10s
    local_domain_name: lan
    resolve_clients: true
    use_private_ptr_resolvers: true
    local_ptr_upstreams: []
  tls:
    enabled: false
    server_name: ""
    force_https: false
    port_https: 443
    port_dns_over_tls: 853
    port_dns_over_quic: 784
    port_dnscrypt: 0
    dnscrypt_config_file: ""
    allow_unencrypted_doh: false
    strict_sni_check: false
    certificate_chain: ""
    private_key: ""
    certificate_path: ""
    private_key_path: ""
  filters:
  - enabled: true
    url: https://adguardteam.github.io/AdGuardSDNSFilter/Filters/filter.txt
    name: Filtro DNS de AdGuard
    id: 1
  - enabled: true
    url: https://adaway.org/hosts.txt
    name: Lista de Bloqueo Predeterminada AdAway
    id: 2
  whitelist_filters: []
  user_rules: []
  dhcp:
    enabled: false
    interface_name: ""
    dhcpv4:
      gateway_ip: ""
      subnet_mask: ""
      range_start: ""
      range_end: ""
      lease_duration: 86400
      icmp_timeout_msec: 1000
      options: []
    dhcpv6:
      range_start: ""
      lease_duration: 86400
      ra_slaac_only: false
      ra_allow_slaac: false
  clients: []
  log_compress: false
  log_localtime: false
  log_max_backups: 0
  log_max_size: 100
  log_max_age: 3
  log_file: ""
  verbose: false
  os:
    group: "{{ adguard_system_user }}"
    user: "{{ adguard_system_user }}"
    rlimit_nofile: "{{ adguard_limit_nofile }}"
  schema_version: 12

Playbook

- hosts: all
  roles:
    - onkeldom.adguard_home

Contribuciones

Consulta la guía para contribuidores.

Licencia

Este proyecto está bajo la Licencia MIT. Consulta LICENSE para más detalles.