adguardteam/adguardhomeServidor DNS de bloqueo de anuncios y rastreadores en toda la red
Servidor DNS libre y de código abierto que bloquea anuncios y rastreadores en toda tu red.
AdGuard.com |
Wiki |
Reddit |
Twitter |
Telegram
AdGuard Home es un software para toda la red que bloquea anuncios y rastreo. Una vez que lo configuras, cubrirá TODOS tus dispositivos domésticos y no necesitas ningún software en el cliente para ello.
Funciona como un servidor DNS que redirige los dominios de rastreo a un “agujero negro”, impidiendo que tus dispositivos se conecten a esos servidores. Está basado en el software que usamos para nuestros servidores públicos AdGuard DNS, y ambos comparten gran parte del código.
Para instalar con curl, ejecuta el siguiente comando:```sh
curl -s -S -L https://raw.githubusercontent.com/AdguardTeam/AdGuardHome/master/scripts/install.sh | sh -s -- -v
Para instalar con `wget` ejecuta el siguiente comando:```sh
wget --no-verbose -O - https://raw.githubusercontent.com/AdguardTeam/AdGuardHome/master/scripts/install.sh | sh -s -- -v
Para instalar con fetch ejecuta el siguiente comando:```sh
fetch -o - https://raw.githubusercontent.com/AdguardTeam/AdGuardHome/master/scripts/install.sh | sh -s -- -v
El script también acepta algunas opciones:
- `-c <channel>` para usar el canal especificado;
- `-r` para reinstalar AdGuard Home;
- `-u` para desinstalar AdGuard Home;
- `-v` para salida detallada.
Ten en cuenta que las opciones `-r` y `-u` son mutuamente excluyentes.
### <a href="#alternative-methods" id="alternative-methods" name="alternative-methods">Métodos alternativos</a>
#### <a href="#manual-installation" id="manual-installation" name="manual-installation">Instalación manual</a>
Por favor, lee el artículo **[Cómo empezar][wiki-start]** de nuestra Wiki para aprender a instalar AdGuard Home manualmente y a configurar tus dispositivos para usarlo.
#### <a href="#docker" id="docker" name="docker">Docker</a>
Puedes usar nuestra imagen oficial de Docker en [Docker Hub].
#### <a href="#snap-store" id="snap-store" name="snap-store">Snap Store</a>
Si usas **Linux,** existe una forma segura y sencilla de instalar AdGuard Home: descárgalo desde [Snap Store].
[Docker Hub]: https://hub.docker.com/r/adguard/adguardhome
[Snap Store]: https://snapcraft.io/adguard-home
[wiki-start]: https://adguard-dns.io/kb/adguard-home/getting-started/
### <a href="#guides" id="guides" name="guides">Guías</a>
Consulta nuestra [Wiki][wiki].
[wiki]: https://github.com/AdguardTeam/AdGuardHome/wiki
### <a href="#api" id="api" name="api">API</a>
Si quieres integrarte con AdGuard Home, puedes usar nuestra [API REST][openapi]. Alternativamente, puedes usar este [cliente de Python][pyclient], que puede utilizarse para crear la [integración de AdGuard Home Assistant][assistant-integration].
[assistant-integration]: https://www.home-assistant.io/integrations/adguard/
[openapi]: https://github.com/AdguardTeam/AdGuardHome/tree/master/openapi
[pyclient]: https://pypi.org/project/adguardhome/
## <a href="#comparison" id="comparison" name="comparison">Comparación de AdGuard Home con otras soluciones</a>
### <a href="#comparison-adguard-dns" id="comparison-adguard-dns" name="comparison-adguard-dns">¿En qué se diferencia esto de los servidores públicos de AdGuard DNS?</a>
Ejecutar tu propio servidor AdGuard Home te permite hacer mucho más que usar un servidor DNS público. Es un nivel completamente diferente. Compruébalo tú mismo:
- Elige exactamente qué bloquea y qué permite el servidor.
- Supervisa la actividad de tu red.
- Añade tus propias reglas de filtrado personalizadas.
- **Lo más importante es que es tu propio servidor y eres el único que tiene el control.**
### <a href="#comparison-pi-hole" id="comparison-pi-hole" name="comparison-pi-hole">¿Cómo se compara AdGuard Home con Pi-Hole?</a>
En este punto, AdGuard Home tiene mucho en común con Pi-Hole. Ambos bloquean anuncios y rastreadores mediante el llamado método de «DNS sinkholing», y ambos permiten personalizar qué se bloquea.
> [!NOTE]
> No vamos a detenernos aquí. El DNS sinkholing no es un mal punto de partida, pero esto es solo el comienzo.
AdGuard Home ofrece muchas funciones listas para usar, sin necesidad de instalar y configurar software adicional. Queremos que sea tan sencillo que incluso los usuarios ocasionales puedan configurarlo con un esfuerzo mínimo.
> [!NOTE]
> Algunas de las funciones enumeradas se pueden añadir a Pi-Hole instalando software adicional o usando manualmente la terminal SSH y reconfigurando una de las utilidades que componen Pi-Hole. Sin embargo, en nuestra opinión, esto no puede considerarse legítimamente una función de Pi-Hole.
| Función | AdGuard Home | Pi-Hole |
|-------------------------------------------------------------------------|-------------------|-----------------------------------------------------------|
| Bloqueo de anuncios y rastreadores | ✅ | ✅ |
| Personalización de listas de bloqueo | ✅ | ✅ |
| Servidor DHCP integrado | ✅ | ✅ |
| HTTPS para la interfaz de administración | ✅ | Más o menos, pero tendrás que configurar lighttpd manualmente |
| Servidores DNS upstream cifrados (DNS-over-HTTPS, DNS-over-TLS, DNSCrypt) | ✅ | ❌ (requiere software adicional) |
| Multiplataforma | ✅ | ❌ (no de forma nativa, solo mediante Docker) |
| Funcionamiento como servidor DNS-over-HTTPS o DNS-over-TLS | ✅ | ❌ (requiere software adicional) |
| Bloqueo de dominios de phishing y malware | ✅ | ❌ (requiere listas de bloqueo no predeterminadas) |
| Control parental (bloqueo de dominios para adultos) | ✅ | ❌ (requiere listas de bloqueo no predeterminadas) |
| Forzar la búsqueda segura en los motores de búsqueda | ✅ | ❌ |
| Configuración por cliente (dispositivo) | ✅ | ✅ |
| Ajustes de acceso (elegir quién puede usar AGH DNS) | ✅ | ❌ |
| Ejecución [sin privilegios de root][wiki-noroot] | ✅ | ❌ |
[wiki-noroot]: https://adguard-dns.io/kb/adguard-home/getting-started/
### <a href="#comparison-adblock" id="comparison-adblock" name="comparison-adblock">¿Cómo se compara AdGuard Home con los bloqueadores de anuncios tradicionales?</a>
Depende.
El DNS sinkholing es capaz de bloquear un gran porcentaje de anuncios, pero carece de la flexibilidad y la potencia de los bloqueadores de anuncios tradicionales. Puedes hacerte una buena idea de la diferencia entre estos métodos leyendo [este artículo][blog-adaway], que compara AdGuard para Android (un bloqueador de anuncios tradicional) con los bloqueadores a nivel de hosts (cuyas capacidades son casi idénticas a las de los bloqueadores basados en DNS). Este nivel de protección es suficiente para algunos usuarios.
Además, usar un bloqueador basado en DNS puede ayudar a bloquear anuncios y solicitudes de rastreo y análisis en otros tipos de dispositivos, como SmartTVs, altavoces inteligentes u otros tipos de dispositivos IoT (en los que no se pueden instalar bloqueadores de anuncios tradicionales).
### <a href="#comparison-limitations" id="comparison-limitations" name="comparison-limitations">Limitaciones conocidas</a>
Aquí tienes algunos ejemplos de lo que un bloqueador a nivel de DNS no puede bloquear:
- Los anuncios de YouTube y Twitch;
- Publicaciones patrocinadas de Facebook, Twitter e Instagram.
Básicamente, cualquier publicidad que comparta dominio con el contenido no puede ser bloqueada por un bloqueador a nivel de DNS.
¿Hay alguna posibilidad de solucionar esto en el futuro? El DNS nunca será suficiente para lograr esto. Nuestra única opción es usar un proxy de bloqueo de contenido, como hacemos en las aplicaciones independientes de AdGuard. Vamos a [añadir][issue-1228] soporte para esta función en AdGuard Home en el futuro. Desafortunadamente, incluso en ese caso, todavía habrá casos en los que esto no sea suficiente o requiera una configuración bastante complicada.
[blog-adaway]: https://adguard.com/blog/adguard-vs-adaway-dns66.html
[issue-1228]: https://github.com/AdguardTeam/AdGuardHome/issues/1228
## <a href="#how-to-build" id="how-to-build" name="how-to-build">Cómo compilar desde el código fuente</a>
### <a href="#prerequisites" id="prerequisites" name="prerequisites">Requisitos previos</a>
Ejecuta `make init` para preparar el entorno de desarrollo.
Necesitarás lo siguiente para compilar AdGuard Home:
- [Go](https://golang.org/dl/) v1.25 o posterior;
- [Node.js](https://nodejs.org/en/download/) v24.10.0 o posterior;
- [npm](https://www.npmjs.com/) v10.8 o posterior;
### <a href="#building" id="building" name="building">Compilación</a>
Abre tu terminal y ejecuta estos comandos:```sh
git clone https://github.com/AdguardTeam/AdGuardHome
cd AdGuardHome
make
[!WARNING] La opción no estándar
-jno está soportada actualmente, por lo que compilar conmake -j 4o configurar tusMAKEFLAGSpara incluir, por ejemplo,-j 4, probablemente romperá la compilación. Si tienes tusMAKEFLAGSconfiguradas de esa manera y no quieres cambiarlas, puedes sobrescribirlas ejecutandomake -j 1.
Consulta el Makefile para conocer otros comandos.
Puedes compilar AdGuard Home para cualquier OS/ARCH que Go soporte. Para ello, especifica las variables de entorno GOOS y GOARCH como macros al ejecutar make.
Por ejemplo:```sh env GOOS='linux' GOARCH='arm64' make
o:```sh
make GOOS='linux' GOARCH='arm64'
Necesitarás snapcraft para preparar una compilación de lanzamiento. Una vez instalado, ejecuta el siguiente comando:```sh
make build-release CHANNEL='...' VERSION='...'
Vea la [documentación del objetivo `build-release`][targ-release].
#### <a href="#docker-image" id="docker-image" name="docker-image">Imagen de Docker</a>
Ejecuta `make build-docker` para construir la imagen de Docker localmente (la que publicamos en DockerHub). Ten en cuenta que usamos [Docker Buildx][buildx] para construir nuestra imagen oficial.
Es posible que necesites preparar algo antes de usar estas compilaciones:
- (Solo Linux) Instala Qemu: ```sh
docker run --rm --privileged multiarch/qemu-user-static --reset -p yes --credential yes
Consulta la documentación del objetivo build-docker.
Cuando necesites depurar el frontend sin recompilar la versión de producción cada vez, por ejemplo para comprobar cómo se verían tus etiquetas en un formulario, puedes ejecutar la compilación del frontend en un entorno de desarrollo.
En una terminal separada, ejecuta: ```sh ( cd ./client/ && env NODE_ENV='development' npm run watch )
Ejecuta tu binario AdGuardHome con la bandera --local-frontend, que indica a AdGuard Home que ignore los archivos de frontend integrados y use los del directorio ./build/.
Ahora, cualquier cambio que hagas en el directorio ./client/ debería recompilarse y estar disponible en la interfaz web. Asegúrate de deshabilitar la caché del navegador para ver realmente la versión recompilada.
AdGuard Home utiliza Playwright para las pruebas E2E. Las pruebas se encuentran en tests/e2e.
Ejecución de las pruebas:
npm run test:e2e – ejecuta todas las pruebas (headless).npm run test:e2e:interactive – ejecuta las pruebas de forma interactiva.npm run test:e2e:debug – ejecuta las pruebas en modo de depuración.npm run test:e2e:codegen – genera nuevo código de prueba.Configuración:
npm install para instalar las dependencias.npx playwright install para configurar los navegadores necesarios.Advertencia: Playwright descargará e instalará sus propios binarios de navegador para las pruebas, que pueden diferir de los navegadores instalados en tu sistema.
Eres bienvenido a hacer fork de este repositorio, realizar tus cambios y enviar un pull request. Sin embargo, asegúrate de seguir nuestras guías de código.
Ten en cuenta que no esperamos que las personas contribuyan simultáneamente a las partes de interfaz de usuario y backend del programa. Idealmente, la parte de backend se implementa primero, es decir, la configuración, la API y la funcionalidad en sí. La parte de la interfaz de usuario puede implementarse más tarde en un pull request diferente y por otra persona.
Hay dos canales de actualización que puedes usar:
beta: versiones beta de AdGuard Home. Versiones más o menos estables, generalmente publicadas cada dos semanas o con más frecuencia.
edge: la versión más reciente de AdGuard Home de la rama de desarrollo. Las nuevas actualizaciones se publican en este canal a diario.
Hay tres opciones para instalar una versión inestable:
[Snap Store]: busca los canales beta y edge.
[Docker Hub]: busca las etiquetas beta y edge.
Compilaciones independientes. Usa el script de instalación automatizada o busca las compilaciones disponibles [en la Wiki][wiki-platf].
Script para instalar una versión beta: ```sh curl -s -S -L https://raw.githubusercontent.com/AdguardTeam/AdGuardHome/master/scripts/install.sh | sh -s -- -c beta
Script para instalar una versión edge: ```sh curl -s -S -L https://raw.githubusercontent.com/AdguardTeam/AdGuardHome/master/scripts/install.sh | sh -s -- -c edge
[wiki-platf]: https://github.com/AdguardTeam/AdGuardHome/wiki/Platforms
### <a href="#reporting-issues" id="reporting-issues" name="reporting-issues">Informar de problemas</a>
Si tienes algún problema o una sugerencia, dirígete a [esta página][iss] y haz clic en el botón “Nueva incidencia”. Sigue atentamente las instrucciones del formulario de incidencia y no olvides empezar buscando duplicados.
[iss]: https://github.com/AdguardTeam/AdGuardHome/issues
### <a href="#translate" id="translate" name="translate">Ayuda con las traducciones</a>
Si quieres ayudar con las traducciones de AdGuard Home, aprende más sobre cómo traducir los productos de AdGuard [en nuestra base de conocimiento][kb-trans]. Puedes contribuir al [proyecto AdGuardHome en CrowdIn][crowdin].
[crowdin]: https://crowdin.com/project/adguard-applications/en#/adguard-home
[kb-trans]: https://kb.adguard.com/en/general/adguard-translations
### <a href="#help-other" id="help-other" name="help-other">Otros</a>
Otra forma de contribuir es [buscando incidencias][iss-help] marcadas como `help wanted`, preguntando si la incidencia está disponible para ser tomada y enviando un PR que corrija el error o implemente la funcionalidad.
[iss-help]: https://github.com/AdguardTeam/AdGuardHome/issues?q=is:issue+is:open+label:%22help+wanted%22
## <a href="#uses" id="uses" name="uses">Proyectos que usan AdGuard Home</a>
Ten en cuenta que estos proyectos no están afiliados a AdGuard, sino que son creados por desarrolladores y seguidores externos.
- [AdGuard Home Remote](https://apps.apple.com/app/apple-store/id1543143740): aplicación de iOS por [Joost](https://rocketscience-it.nl/).
- [Biblioteca de Python](https://github.com/frenck/python-adguardhome) por [@frenck](https://github.com/frenck).
- [Complemento para Home Assistant](https://github.com/hassio-addons/addon-adguard-home) por [@frenck](https://github.com/frenck).
- [Aplicación LUCI para OpenWrt](https://github.com/kongfl888/luci-app-adguardhome) por [@kongfl888](https://github.com/kongfl888) (originalmente por [@rufengsuixing](https://github.com/rufengsuixing)).
- [AdGuardHome sync](https://github.com/bakito/adguardhome-sync) por [@bakito](https://github.com/bakito).
- [Monitoreo de tráfico en tiempo real y estadísticas para tu instancia de AdGuard Home desde la terminal](https://github.com/Lissy93/AdGuardian-Term) por [@Lissy93](https://github.com/Lissy93)
- [AdGuard Home en routers GLInet](https://forum.gl-inet.com/t/adguardhome-on-gl-routers/10664) por [Gl-Inet](https://gl-inet.com/).
- [Aplicación de Cloudron](https://git.cloudron.io/cloudron/adguard-home-app) por [@gramakri](https://github.com/gramakri).
- [Asuswrt-Merlin-AdGuardHome-Installer](https://github.com/jumpsmm7/Asuswrt-Merlin-AdGuardHome-Installer) por [@jumpsmm7](https://github.com/jumpsmm7), también conocido como [@SomeWhereOverTheRainBow](https://www.snbforums.com/members/somewhereovertherainbow.64179/).
- [Biblioteca de Node.js](https://github.com/Andrea055/AdguardHomeAPI) por [@Andrea055](https://github.com/Andrea055/).
- [Extensión de navegador](https://github.com/satheshshiva/Adguard-Home-Browser-Ext) por [@satheshshiva](https://github.com/satheshshiva/).
- [Plantilla de Zabbix para AdGuard Home](https://github.com/diasdmhub/AdGuard_Home_Zabbix_Template) por [@diasdmhub](https://github.com/diasdmhub).
- [Paquete de Chocolatey](https://community.chocolatey.org/packages/adguardhome/) por [niks255](https://community.chocolatey.org/profiles/niks255).
- [Listado en la tienda de aplicaciones de ZimaOS](https://www.zimaspace.com/zimaos/app-store/app/org.icewhale.adguardhome) por [CasaOS Team](https://casaos.zimaspace.com/).
## <a href="#acknowledgments" id="acknowledgments" name="acknowledgments">Agradecimientos</a>
Este software no habría sido posible sin:
- [Go](https://golang.org/dl/) y sus bibliotecas:
- [gcache](https://github.com/bluele/gcache)
- [miekg's dns](https://github.com/miekg/dns)
- [go-yaml](https://github.com/go-yaml/yaml)
- [service](https://godoc.org/github.com/kardianos/service)
- [dnsproxy](https://github.com/AdguardTeam/dnsproxy)
- [urlfilter](https://github.com/AdguardTeam/urlfilter)
- [Node.js](https://nodejs.org/) y sus bibliotecas:
- [React.js](https://reactjs.org)
- [Tabler](https://github.com/tabler/tabler)
- Y muchos más paquetes de Node.js.
- [Datos de whotracks.me](https://github.com/cliqz-oss/whotracks.me)
Puede que hayas visto que [CoreDNS] se mencionaba antes aquí, pero hemos dejado de usarlo en AdGuard Home.
Para ver la lista completa de todos los paquetes de Node.js en uso, echa un vistazo al archivo [`client/package.json`][src-packagejson].
[CoreDNS]: https://coredns.io
[src-packagejson]: https://raw.githubusercontent.com/AdguardTeam/AdGuardHome/master/client/package.json
## <a href="#privacy" id="privacy" name="privacy">Privacidad</a>
Nuestra idea principal es que tú eres quien debe tener el control de tus datos. Así que es totalmente natural que AdGuard Home no recopile estadísticas de uso ni utilice ningún servicio web salvo que lo configures para ello. Consulta también la [política de privacidad completa][privacy], donde está disponible cada dato que *en teoría podría enviarse* desde AdGuard Home.
[privacy]: https://adguard.com/en/privacy/home.html