Transparencia y atención al usuario: el papel de GitHub en AdGuard
En AdGuard, trabajamos todos los días para hacer que Internet sea más segura, cómoda y transparente. Este compromiso se refleja no solo en las funciones de nuestros productos y en nuestras estrictas políticas de privacidad, sino también en el hecho de mantener nuestro trabajo lo más abierto posible. Esto incluye interactuar activamente con nuestra comunidad.
Es por eso que todos nuestros productos cuentan con repositorios públicos: espacios en línea donde cualquier persona puede ver en qué estamos trabajando, reportar problemas directamente a los desarrolladores de AdGuard e incluso contribuir a nuestros proyectos de código abierto. Los repositorios abarcan nuestras aplicaciones de bloqueo de anuncios, filtros, extensiones de navegador, soluciones DNS, herramientas de VPN, utilidades para desarrolladores y mucho más. Existen diferentes plataformas que ofrecen esta funcionalidad, pero la más popular con diferencia es GitHub, y todos los proyectos de AdGuard están alojados allí.
Este artículo enumera los repositorios más importantes por categoría, resume el propósito de cada uno y presenta una explicación sencilla de lo que los usuarios pueden hacer en cada espacio.
Qué es GitHub y sus repositorios
De manera muy simple, puedes pensar en GitHub como una especie de Google Docs para código, donde varias personas pueden trabajar en el mismo proyecto, dar seguimiento a los cambios y ver quién hizo cada actualización. Proporciona un lugar central en la nube para almacenar tu código, lo que lo hace accesible desde cualquier lugar. También cuenta con herramientas de colaboración para revisar cambios, corregir problemas e integrar el trabajo de todos de forma organizada.
GitHub es ampliamente utilizado para proyectos de código abierto, permitiendo que cualquier persona visualice el código, sugiera mejoras y contribuya.
Un repositorio (o “repo”, abreviación) es el elemento más básico de GitHub. Es un espacio donde puedes almacenar tu código, archivos y el historial de revisiones de cada archivo. Los repositorios pueden tener múltiples colaboradores y pueden ser públicos o privados.
Por dónde empezar
Puedes encontrar enlaces a los repositorios principales en este artículo o visitar la página general de AdGuardTeam en GitHub para ver la lista completa. En la mayoría de los repositorios, puedes:
-
Ver el archivo README en la página principal: presenta el producto y su repositorio
-
Revisar reportes de errores o solicitudes de funciones existentes, comentar y votar
-
Crear issues para reportar errores o solicitar funciones
-
Consultar releases para ver diferentes versiones y sus changelogs (e instalar una versión anterior si es necesario)
-
Instalar cualquier versión anterior o beta, si es necesario
Nota: si eres nuevo en GitHub, necesitarás crear una cuenta para poder abrir nuevos issues y comentar en los existentes.
En los repositorios de código abierto, los usuarios avanzados también pueden:
- Explorar el código para entender la lógica del producto, las tecnologías usadas y cómo se implementan
- Hacer fork y contribuir mediante pull requests
Ya seas un usuario casual, un especialista técnico o un desarrollador, AdGuard da la bienvenida a la participación de toda la comunidad en sus repositorios de GitHub.
Productos del bloqueador de anuncios AdGuard
En estos repositorios, los usuarios pueden:
- Visualizar y reportar errores o solicitudes de funciones mediante GitHub issues
- Consultar changelogs, seguir el historial de versiones y monitorear actualizaciones
- Descargar builds más recientes, anteriores y beta (excepto para iOS)
AdguardForAndroid
Repositorio de AdGuard para Android — aplicación que proporciona bloqueo de anuncios en todo el sistema.
AdguardForiOS
Repositorio de AdGuard para iOS — bloqueador de contenido para Safari con DNS y filtros personalizados. Los usuarios también pueden revisar el código abierto.
AdguardForWindows
Repositorio de AdGuard para Windows. No es de código abierto; GitHub se usa únicamente como rastreador de errores abierto.
AdguardForMac
Repositorio de AdGuard para Mac — bloqueador de contenido independiente para macOS. Solo funciona como rastreador de errores.
AdguardBrowserExtension
Repositorio de AdGuard Browser Extension — extensión que proporciona bloqueo de anuncios con mayor privacidad para Chrome, Firefox, Opera y Edge.
AdguardForSafari
Repositorio de AdGuard para Safari — extensión de bloqueo de anuncios para Safari en Mac. Los usuarios también pueden revisar el código abierto.
AdGuardCLI
Repositorio de AdGuard para Linux — interfaz de línea de comandos para administrar el bloqueo de anuncios.
Productos AdGuard VPN
En estos repositorios, los usuarios pueden:
- Visualizar y reportar errores o solicitudes de funciones mediante GitHub issues
- Consultar changelogs, seguir el historial de versiones y monitorear actualizaciones
- Descargar builds más recientes, anteriores y beta (excepto para iOS)
AdGuardVPNForiOS
Repositorio de AdGuard VPN para iOS. Funciona como rastreador abierto de errores.
AdGuardVPNForAndroid
Repositorio de AdGuard VPN para Android. Funciona como rastreador abierto de errores.
AdGuardVPNForWindows
Repositorio de AdGuard VPN para Windows. Funciona como rastreador abierto de errores.
AdGuardVPNForMac
Repositorio de AdGuard VPN para Mac — aplicación desarrollada para macOS.
AdGuardVPNExtension
Repositorio de la extensión AdGuard VPN para navegadores.
AdGuardVPNCLI
Repositorio de AdGuard VPN para Linux — interfaz de línea de comandos para gestionar la conexión VPN. El repositorio funciona como rastreador de errores.
Productos de DNS
AdGuardDNS
Repositorio de código abierto usado también para rastrear errores y problemas relacionados con el servicio AdGuard DNS. Los usuarios pueden:
- Visualizar y reportar problemas de DNS
- Sugerir mejoras
AdGuardHome
Repositorio de AdGuard Home — software gratuito para toda la red que bloquea anuncios y rastreadores vía DNS. Los usuarios pueden:
- Revisar y enviar reportes de errores o solicitudes de funciones
- Revisar o contribuir al código
- Descargar e instalar releases
Documentación y bases de conocimiento
Las bases de conocimiento ayudan a los usuarios a entender mejor y utilizar AdGuard. Describen cada producto en detalle: desde una visión general de las funciones y guías de solución de problemas hasta manuales avanzados y documentación de APIs. En los repositorios, los usuarios pueden:
- Sugerir correcciones o ediciones en los artículos de la base de conocimiento
- Proponer nuevos artículos
- Probar o ejecutar la versión local
KnowledgeBase
Documentación central de AdGuard Ad Blocker y tecnologías relacionadas.
KnowledgeBaseDNS
Vista detallada de las funciones, guías de solución de problemas y documentación de AdGuard DNS (público y privado), AdGuard Home y todo lo relacionado.
KnowledgeBaseVPN
Vista detallada de las funciones y guías de solución de problemas de AdGuard VPN.
KnowledgeBaseMail
Vista detallada de las funciones y guías de solución de problemas de AdGuard Mail.
Bibliotecas principales
AdGuardCoreLibs
Motor de filtrado multiplataforma de AdGuard, usado en productos Android, Windows y Mac. Los usuarios pueden:
- Explorar la lógica de filtrado y la gestión de DNS
- Reportar errores y sugerir funciones mediante issues, contribuir con código mediante pull requests
DNSLibs
Biblioteca de DNS usada por CoreLibs y AdGuard Home. Los usuarios pueden:
- Revisar y contribuir a la implementación de bajo nivel de DNS
- Sugerir optimizaciones
VPNLibs
Base de código compartida usada en los productos AdGuard VPN para implementar el protocolo AdGuard VPN. Los usuarios pueden:
- Contribuir al comportamiento de la pila VPN
- Reportar o revisar problemas de rendimiento y errores
Tecnologías principales de bloqueo de anuncios y filtrado
AdguardFilters
Contiene las listas de filtros principales de AdGuard. Los usuarios pueden:
- Visualizar y descargar listas de filtros
- Crear issues para reportar falsos positivos o sugerir nuevas reglas
- Seguir actualizaciones en la lógica de filtrado
AdGuardSDNSFilter
Repositorio del filtro DNS de AdGuard — lista principal de bloqueo a nivel DNS usada en AdGuard DNS y funciones de filtrado DNS. Los usuarios pueden:
- Inspeccionar el conjunto de reglas actual
- Proponer cambios o adiciones
AGLint
Linter para sintaxis de listas de filtros de adblock. Los usuarios pueden:
- Instalar AGLint para verificar problemas en sus listas
- Contribuir con reglas de lint
Scriptlets
Helpers en JavaScript usados en las reglas de filtrado. Los usuarios pueden:
- Explorar los scriptlets disponibles
- Enviar pull requests para nuevos scriptlets
tsurlfilter
Biblioteca en TypeScript para bloqueo de contenido en extensiones de navegador. Los usuarios pueden:
- Explorar cómo se implementa la lógica de filtrado
- Contribuir con correcciones y nuevas funciones
Hay más
Arriba listamos 27 repositorios públicos principales de AdGuard, de un total de 96. Si quieres explorar más, puedes encontrar el resto en la página de AdGuardTeam en GitHub.
¡Esperamos tus comentarios ahí! Mantente seguro en línea y fuera de línea.
