AdGuard sur Github : transparence et orientation vers l'utilisateur
Chez AdGuard, nous luttons chaque jour pour rendre Internet plus sûr, plus pratique et plus transparent. Cette ambition se reflète non seulement dans les fonctionnalités de nos produits et notre politique de confidentialité stricte, mais aussi dans notre volonté de communiquer de manière aussi transparente que possible sur notre travail. Cela implique notamment une interaction active avec notre communauté.
C'est pourquoi tous nos produits ont des référentiels ouverts — des espaces en ligne où tout le monde peut voir sur quoi nous travaillons, signaler des problèmes directement aux développeurs d'AdGuard et même contribuer à nos projets open source. Les référentiels couvrent nos applications de blocage de publicités, nos filtres, nos extensions de navigateur, nos solutions DNS, nos outils VPN, nos utilitaires pour développeurs et bien plus encore. Il existe différentes plateformes qui offrent cette fonctionnalité, mais la plus populaire est GutHub, et tous les projets AdGuard y sont stockés.
Dans cet article, nous avons répertorié les dépôts les plus importants par catégorie, décrit brièvement la fonction de chacun d'entre eux et expliqué en quoi ils peuvent être utiles aux utilisateurs.
Qu'est-ce que GitHub et ses référentiels ?
Pour simplifier, GitHub est en quelque sorte l'équivalent de Google Docs pour le code, où de nombreuses personnes peuvent travailler sur le même projet, suivre les modifications et voir qui a effectué quelles mises à jour. Il fournit un emplacement centralisé dans le cloud pour stocker votre code pour qu'il soit accessible depuis n'importe où. Il dispose également d'outils de travail en équipe pour examiner les modifications, corriger les problèmes et fusionner le travail de chacun en toute simplicité.
GitHub est largement utilisé pour les projets à source ouverte, permettant à tout le monde de consulter le code, de suggérer des améliorations et d'y contribuer.
Un référentiel (en anglais souvent appelé « repo » en abrégé) est l'élément le plus basique de GitHub. C'est un endroit où vous pouvez stocker votre code, vos fichiers et l'historique des révisions de chaque fichier. Les référentiels peuvent avoir plusieurs collaborateurs et peuvent être publics ou privés.
Où commencer ?
Vous trouverez ci-dessous des liens vers les principaux référentiels. Vous pouvez également consulter la page GitHub générale de l'équipe AdGuard pour y voir la liste complète. Dans la plupart des référentiels, vous pouvez :
-
Consulter le fichier README sur la page principale : il vous donne une introduction au produit et à son référentiel
-
Consulter les rapports de bogues ou les demandes de fonctionnalités existants, commenter et voter
-
Créer des tickets pour signaler des bugs ou demander des fonctionnalités
-
Consulter les versions disponibles et leurs journaux de modifications (et installez une version plus ancienne si nécessaire)
-
Installer une version plus ancienne ou bêta si nécessaire
Note : si vous êtes nouveau sur GitHub, vous devrez créer un compte GitHub afin de pouvoir créer de nouveaux tickets et commenter ceux qui existent déjà.
Dans les référentiels open source, les utilisateurs avancés peuvent également :
- Explorer le code pour comprendre la logique du produit, les technologies utilisées et leur mise en œuvre
- Créer des fourches et contribuer via des pull requests
Que vous soyez un utilisateur occasionnel, un expert technique ou un développeur, AdGuard accueille toutes les participations de la communauté sur ses référentiels GitHub.
Les logiciels Bloqueurs de la gamme AdGuard
Dans ces référentiels, les utilisateurs peuvent :
- Afficher et signaler des bogues ou des demandes de fonctionnalités via GitHub issues
- Consulter les journaux des modifications, suivre l'historique des versions et surveiller les mises à jour
- Télécharger les versions les plus récentes, précédentes et bêta (à l'exception d'iOS)
AdguardForAndroid
Référentiel d'AdGuard pour Android — une application qui bloque les publicités à l'échelle du système.
AdguardForiOS
Référentiel d'AdGuard pour iOS — bloqueur de contenu Safari avec DNS et filtres personnalisés. Les utilisateurs peuvent également consulter le code open source.
AdguardForWindows Référentiel d'AdGuard pour Windows. Le code n'est pas open source ; GitHub est utilisé comme un outil de suivi des bogues ouvert au public.
AdguardForMac
Référentiel d'AdGuard pour Mac — bloqueur de contenu autonome pour macOS. C'est un outil de suivi des bogues uniquement.
AdguardBrowserExtension
Référentiel de l'extension de navigateur AdGuard — l'extension qui permet de bloquer les publicités et d'améliorer la confidentialité pour Chrome, Firefox, Opera et Edge.
AdguardForSafari
Référentiel d'AdGuard pour Safari — l'extension de blocage des publicités Safari pour Mac. Les utilisateurs peuvent également consulter le code open source.
AdGuardCLI
Référentiel d'AdGuard pour Linux — interface en ligne de commande pour gérer le blocage des publicités.
La gamme AdGuard VPN
Dans ces référentiels, les utilisateurs peuvent :
- Afficher et signaler des bogues ou des demandes de fonctionnalités via GitHub issues
- Consulter les journaux des modifications, suivre l'historique des versions et surveiller les mises à jour
- Télécharger les versions les plus récentes, précédentes et bêta (à l'exception d'iOS)
AdGuardVPNForiOS
Référentiel d'AdGuard VPN pour iOS. Sert de traqueur de bogues ouvert.
AdGuardVPNForAndroid
Référentiel d'AdGuard VPN pour Android. Sert de traqueur de bogues ouvert.
AdGuardVPNForWindows
Référentiel d'AdGuard VPN pour Windows. Sert de traqueur de bogues ouvert.
AdGuardVPNForMac
Référentiel d'AdGuard VPN pour Mac — application conçue pour macOS.
AdGuardVPNExtension
Référentiel de l'extension de navigateur AdGuard VPN.
AdGuardVPNCLI
Référentiel d'AdGuard VPN pour Linux — une interface en ligne de commande pour gérer la connexion VPN. Le référentiel sert de traqueur de bogues.
Les logigiels basés sur DNS
AdGuardDNS
Référentiel open source également utilisé pour suivre les bogues et les problèmes liés au service DNS AdGuard. Les utilisateurs peuvent :
- Afficher et signaler les problèmes DNS
- Suggérer des améliorations
AdGuardHome
Référentiel d'AdGuard Home — logiciel gratuit à l'échelle du réseau permettant de bloquer les publicités et les traqueurs via DNS. Les utilisateurs peuvent :
- Vérifier et signaler des bogues ou demander des fonctionnalités
- Examiner ou contribuer au code
- Télécharger et installer des versions
Les bases de connaissances et documentation
Les bases de connaissances ont pour objectif d'aider les utilisateurs à mieux comprendre et utiliser AdGuard. Elles décrivent chaque produit AdGuard en détail : des aperçus des fonctionnalités et des guides de résolution de problèmes aux manuels de configuration avancée et aux documentations API. Dans les référentiels, les utilisateurs peuvent :
- Suggérer des corrections ou des modifications aux articles de la base de connaissances
- Proposer de nouveaux articles
- Tester ou exécuter la version locale
Base de connaissances
Documentation centrale pour le Bloqueur AdGuard et les technologies qui y sont liées.
Base de connaissances DNS
Présentation détaillée des fonctionnalités, guides de dépannage et documentation pour AdGuard DNS (public et privé), AdGuard Home et tout ce qui s'y rapporte.
Base de connaissances VPN
Présentation détaillée des fonctionnalités et guides de dépannage pour AdGuard VPN.
Base de connaissances Mail
Présentation détaillée des fonctionnalités et guides de dépannage pour AdGuard Mail.
Bibliothèques essentielles
AdGuardCoreLibs
Moteur de filtrage multiplateforme d'AdGuard. Utilisé dans les produits Android, Windows et Mac. Les utilisateurs peuvent :
- Explorer la logique de filtrage et la gestion DNS
- Signaler des bogues et suggérer des fonctionnalités via Issues, contribuer au code via Pull requests
DNSLibs
Bibliothèque DNS utilisée par CoreLibs et AdGuardHome. Les utilisateurs peuvent :
- Examiner et contribuer à la mise en œuvre DNS de bas niveau
- Suggérer des optimisations
VPNLibs
Base de code partagée utilisée dans les produits AdGuard VPN sur toutes les plateformes pour la mise en œuvre du protocole AdGuard VPN. Les utilisateurs peuvent :
- Contribuer au comportement du stack VPN
- Signaler ou consulter les problèmes de performance et les bogues
Technologies de base pour le blocage et le filtrage des annonces
AdguardFilters
Contient les listes de filtres principales d'AdGuard. Les utilisateurs peuvent :
- Afficher et télécharger les listes de filtres
- Créer des tickets pour signaler des faux positifs ou suggérer de nouvelles règles
- Surveiller les mises à jour de la logique de filtrage
AdGuardSDNSFilter
Référentiel du filtre DNS AdGuard — la principale liste de blocage au niveau DNS utilisée dans les fonctionnalités de filtrage DNS et AdGuard DNS. Les utilisateurs peuvent :
- Inspecter l'ensemble des règles actuelles
- Proposer des modifications ou des ajouts
AGLint
Un linter pour la syntaxe de la liste de filtrage adblock. Les utilisateurs peuvent :
- Installer AGLint pour vérifier les règles de leurs projets
- Contribuer aux règles de lint
Scriptlets
Aides JavaScript utilisées dans les règles de filtrage. Les utilisateurs peuvent :
- Explorer les scriptlets disponibles
- Soumettre des demandes d'extraction pour de nouveaux scriptlets
tsurlfilter
Bibliothèque de blocage de contenu TypeScript pour les extensions de navigateur. Les utilisateurs peuvent :
- Explorer la manière dont la logique de filtrage est mise en œuvre
- Contribuer à des corrections et à des fonctionnalités
Il y en a davantage
Ci-dessus, nous avons répertorié 27 des principaux référentiels publics AdGuard sur un total de 96. Si vous souhaitez approfondir le sujet, vous pouvez trouver le reste sur la page GitHub de l'équipe AdGuard.
Nous attendons vos commentaires ! Restez en sécurité en ligne et hors ligne.
