GitHub-Repositorys von AdGuard
AdGuard verfolgt das Ziel, das Internet sicherer, komfortabler und transparenter zu gestalten. Dieses Engagement zeigt sich nicht nur in unseren Produktfunktionen und strengen Datenschutzrichtlinien, sondern auch darin, dass wir unsere Arbeit so transparent wie möglich gestalten. Dazu gehört auch, aktiv mit unserer Community zu interagieren.
Aus diesem Grund verfügen alle unsere Produkte über öffentliche Repositorys – Online-Plattformen, auf denen jeder sehen kann, woran wir gerade arbeiten, Probleme direkt an die AdGuard-Entwickler melden und sogar zu unseren Open-Source-Projekten beitragen kann. Die Repositorys umfassen unsere Werbeblocker-Apps, Filter, Browser-Erweiterungen, DNS-Lösungen, VPN-Tools, Entwickler-Dienstprogramme und vieles mehr. Es gibt verschiedene Plattformen, die solche Funktionen bieten, doch die mit Abstand beliebteste ist GitHub, und alle AdGuard-Projekte werden dort bereitgestellt.
Dieser Artikel listet die wichtigsten Repositories nach Kategorien auf, fasst den Zweck jedes einzelnen zusammen und gibt einen kurzen Überblick darüber, was Nutzer dort tun können.
Profi-Tipp: Ein Issue (Fehlerbericht) auf GitHub zu erstellen ist der effektivste Weg, um die AdGuard-Entwickler auf ein Problem aufmerksam zu machen. Vergewissern Sie sich zunächst, dass nicht bereits ein ähnlicher Issue existiert, und beschreiben Sie das Problem ausführlich, aber prägnant. Falls bereits ein ähnlicher Issue existiert, können Sie dafür stimmen.
Was ist GitHub und was sind Repositorys
Vereinfacht gesagt können Sie sich GitHub wie Google Docs für Code vorstellen: Mehrere Personen können am selben Projekt arbeiten, Änderungen nachverfolgen und sehen, wer welche Anpassungen vorgenommen hat. Es bietet einen zentralen, cloudbasierten Ort zur Speicherung Ihres Codes, sodass dieser von überall aus zugänglich ist. Außerdem bietet es Werkzeuge für die Teamarbeit, mit denen Änderungen überprüft, Probleme behoben und die Beiträge aller Beteiligten reibungslos zusammengeführt werden können.
GitHub wird häufig für Open-Source-Projekte genutzt und ermöglicht es jedem, den Code einzusehen, Verbesserungsvorschläge einzureichen und mitzuwirken.
Ein Repository (oft kurz „Repo“ genannt) ist das grundlegendste Element von GitHub. Hier können Sie Ihren Code, Ihre Dateien und den Versionsverlauf jeder Datei speichern. Repositorys können mehrere Mitwirkende umfassen und entweder öffentlich oder privat zugänglich sein.
Was können Sie in den Repositorys von AdGuard tun
Weiter unten in diesem Artikel finden Sie Links zu den wichtigsten Repositorys. Eine vollständige Liste ist auf der allgemeinen GitHub-Seite des AdGuard-Teams verfügbar. In den meisten Repositories können Sie:
-
README-Datei anzeigen auf der Hauptseite: Dort finden Sie eine Einführung in das Produkt und sein Repository
-
Überprüfen Sie vorhandene Fehlerberichte oder Funktionsanfragen, kommentieren Sie diese und stimmen Sie dafür
-
Erstellen Sie Issues, um Fehler zu melden oder neue Funktionen vorzuschlagen
-
Überprüfen Sie Veröffentlichungen für verschiedene Versionen und deren Änderungsprotokolle (und installieren Sie bei Bedarf eine ältere Version)
-
Installieren Sie bei Bedarf eine ältere oder Beta-Version
Wenn Sie GitHub noch nicht kennen, müssen Sie ein GitHub-Konto erstellen, um neue Tickets zu erstellen und bestehende zu kommentieren.
In Open-Source-Repositorys können erfahrenere Benutzer außerdem:
- Den Code durchsuchen, um die Produktlogik zu verstehen, welche Technologien zum Einsatz kommen und wie diese implementiert sind
- Erstellen Sie Forks und beteiligen Sie sich mit Pull Requests
Ganz gleich, ob Sie Gelegenheitsnutzer, technischer Experte oder Entwickler sind – AdGuard freut sich über jede Art von Beteiligung an seinen GitHub-Repos.
Rechtliche Dokumente
LegalDocs
Im Rahmen unseres Bekenntnisses zur Transparenz veröffentlichen wir alle rechtlichen Dokumente – wie Endbenutzer-Lizenzvereinbarungen, Datenschutzerklärungen und Allgemeine Geschäftsbedingungen – auf GitHub. In unserem LegalDocs-Repository kann jeder den vollständigen Änderungsverlauf dieser Dokumente einsehen.
AdGuard-Werbeblocker-Produkte
In diesen Repositorys können Benutzer:
- Anzeigen und Melden von Fehlern oder Funktionsanfragen über GitHub-Issues
- Änderungsprotokolle prüfen, Versionshistorie verfolgen, Updates überwachen
- Herunterladen der neuesten, vorherigen und Beta-Versionen (außer für iOS)
AdguardForAndroid
Repository von AdGuard für Android – eine App, die systemweite Werbeblockierung bietet.
AdguardForiOS
Repository von AdGuard für iOS – Safari-Inhaltsblocker mit DNS- und benutzerdefinierten Filtern. Benutzer können zudem den Open-Source-Code einsehen.
AdguardForWindows
Repository von AdGuard für Windows. Nicht quelloffen; GitHub wird als offener Bug-Tracker genutzt.
AdguardForMac
Repository von AdGuard für Mac – eigenständiger Inhaltsblocker für macOS. Nur Bug-Tracker.
AdguardBrowserExtension
Repository der AdGuard-Browsererweiterung – eine Erweiterung, die Werbeblocker-Funktionen mit verbessertem Datenschutz für Chrome, Firefox, Opera und Edge bietet.
AdguardForSafari
Repository von AdGuard für Safari – Erweiterung zur Werbeblockierung für Safari auf dem Mac. Benutzer können zudem den Open-Source-Code einsehen.
AdGuardCLI
Repository von AdGuard für Linux – eine Befehlszeilenschnittstelle zur Verwaltung der Werbeblockierung.
AdGuard VPN-Produkte
In diesen Repositorys können Benutzer:
- Anzeigen und Melden von Fehlern oder Funktionsanfragen über GitHub-Issues
- Änderungsprotokolle prüfen, Versionshistorie verfolgen, Updates überwachen
- Herunterladen der neuesten, vorherigen und Beta-Versionen (außer für iOS)
AdGuardVPNForiOS
Repository von AdGuard VPN für iOS. Dient als offener Bug-Tracker.
AdGuardVPNForAndroid
Repository von AdGuard VPN für Android. Dient als offener Bug-Tracker.
AdGuardVPNForWindows
Repository von AdGuard VPN für Windows. Dient als offener Bug-Tracker.
AdGuardVPNForMac
Repository von AdGuard VPN für Mac – eine für macOS entwickelte App.
AdGuardVPNExtension
Repository der AdGuard VPN-Browsererweiterung.
AdGuardVPNCLI
Repository von AdGuard VPN für Linux – eine Befehlszeilenschnittstelle zur Verwaltung von VPN-Verbindungen. Dieses Repo dient als Bug-Tracker.
DNS-basierte Produkte
AdGuardDNS
Ein Open-Source-Repository, das auch zur Erfassung von Fehlern und Problemen im Zusammenhang mit dem AdGuard DNS-Dienst genutzt wird. Nutzer können:
- DNS-Probleme anzeigen und melden
- Verbesserungen vorschlagen
AdGuardHome
Repository von AdGuard Home – kostenlose, netzwerkweite Software zum Sperren von Werbung und Trackern über DNS. Nutzer können:
- Fehlerberichte oder Funktionswünsche prüfen und einreichen
- Code prüfen oder an seiner Entwicklung mitwirken
- Versionen herunterladen und installieren
Dokumentation und Wissensdatenbanken
Wissensdatenbanken sollen den Benutzern helfen, AdGuard besser zu verstehen und zu nutzen. Sie beschreiben jedes AdGuard-Produkt ausführlich: von Funktionsübersichten und Anleitungen zur Problemlösung bis hin zu Handbüchern für erweiterte Einstellungen und API-Dokumentationen. In den Repositories können Benutzer:
- Korrekturen oder Änderungen an Artikeln in der Wissensdatenbank vorschlagen
- Neue Artikel vorschlagen
- Lokale Version testen oder ausführen
KnowledgeBase
Zentrale Dokumentation für den AdGuard Werbeblocker und die damit verbundenen Technologien.
KnowledgeBaseDNS
Ausführliche Funktionsübersicht, Anleitungen zur Fehlerbehebung und Dokumentation zu AdGuard DNS (öffentlich und privat), AdGuard Home und allen damit verbundenen Themen.
KnowledgeBaseVPN
Ausführliche Funktionsübersicht und Anleitungen zur Fehlerbehebung für AdGuard VPN.
KnowledgeBaseMail
Ausführliche Funktionsübersicht und Anleitungen zur Fehlerbehebung für AdGuard Mail.
Core-Bibliotheken
CoreLibs
Die plattformübergreifende Core-Filter-Engine von AdGuard. Wird in Android-, Windows- und Mac-Produkten verwendet. Nutzer können:
- Filterlogik und DNS-Verarbeitung erkunden
- Über Issues Fehler melden und neue Funktionen vorschlagen
DNSLibs
Eine DNS-Bibliothek, die von CoreLibs und AdGuard Home verwendet wird. Nutzer können:
- Die Implementierung der DNS-Funktionen auf niedriger Ebene prüfen und an ihrer Entwicklung mitwirken
- Optimierungen vorschlagen
VPNLibs
Gemeinsame Codebasis, die in AdGuard-VPN-Produkten plattformübergreifend für die Implementierung des AdGuard-VPN-Protokolls verwendet wird. Nutzer können:
- Zum Verhalten des VPN-Stacks beitragen
- Leistungsprobleme und Fehler melden oder anzeigen
Kerntechnologien für Werbeblocker und Filter
AdguardFilters
Enthält die Kernfilterlisten von AdGuard. Nutzer können:
- Filterlisten anzeigen und herunterladen
- Tickets erstellen, um Fehlalarme zu melden oder neue Filterregeln vorzuschlagen
- Änderungen an der Filterlogik überwachen
AdGuardSDNSFilter
Repository des AdGuard DNS-Filters — die wichtigste Sperrliste auf DNS-Ebene, die in AdGuard DNS und den DNS-Filterfunktionen verwendet wird. Nutzer können:
- Den aktuellen Regelsatz untersuchen
- Änderungen oder Ergänzungen vorschlagen
AGLint
Ein Linter für die Syntax von Adblock-Filterlisten. Nutzer können:
- AGLint installieren, um Projekte auf Probleme mit Filterregeln zu prüfen
- Zu den Regeln für die Syntaxprüfung beitragen
Scriptlets
In Filterregeln verwendete JavaScript-Hilfsfunktionen. Nutzer können:
- Verfügbare Scriptlets erkunden
- Pull Requests für neue Scriptlets einreichen
tsurlfilter
TypeScript-Bibliothek zur Inhaltsblockierung in Browsererweiterungen. Nutzer können:
- Erkunden, wie die Filterlogik umgesetzt wird
- Korrekturen und Funktionen einbringen
Das ist noch nicht alles
Oben haben wir 27 der insgesamt 96 öffentlichen AdGuard-Repositorys aufgelistet. Wenn Sie tiefer einsteigen möchten, finden Sie die übrigen Repositorys auf der GitHub-Seite des AdGuard-Teams.
Wir freuen uns dort auf Ihr Feedback! Achten Sie auf Ihre Sicherheit – online und offline.