AdGuard Home

Datenschutzzentrum für Sie und Ihre Geräte

Kostenlos und quelloffen – ein leistungsstarker DNS-Server, der netzweit Werbung und Tracker blockiert.

AdGuard.com | Wiki | Reddit | Twitter | Telegram

AdGuard Home ist eine netzwerkweite Software zum Blockieren von Werbung und Tracking. Nach der Einrichtung deckt es ALLE Ihre Heimgeräte ab, und Sie benötigen dafür keine Client-Software.

Es funktioniert als DNS-Server, der Tracking-Domains zu einem „Schwarzen Loch“ umleitet und so verhindert, dass Ihre Geräte eine Verbindung zu diesen Servern herstellen. Es basiert auf Software, die wir für unsere öffentlichen AdGuard DNS-Server verwenden, und beide teilen sich viel Code.

Erste Schritte
AdGuard Home im Vergleich zu anderen Lösungen
So bauen Sie aus dem Quellcode
- Voraussetzungen
- Bauen
Mitwirken
Projekte, die AdGuard Home verwenden
Danksagungen
Datenschutz

Erste Schritte

Automatische Installation (Linux/Unix/MacOS/FreeBSD/OpenBSD)

Führen Sie den folgenden Befehl aus, um mit curl zu installieren:```sh curl -s -S -L https://raw.githubusercontent.com/AdguardTeam/AdGuardHome/master/scripts/install.sh | sh -s -- -v

Um mit `wget` zu installieren, führen Sie den folgenden Befehl aus:```sh
wget --no-verbose -O - https://raw.githubusercontent.com/AdguardTeam/AdGuardHome/master/scripts/install.sh | sh -s -- -v

Um mit fetch zu installieren, führen Sie den folgenden Befehl aus:```sh fetch -o - https://raw.githubusercontent.com/AdguardTeam/AdGuardHome/master/scripts/install.sh | sh -s -- -v

Das Skript akzeptiert außerdem einige Optionen:

- `-c <channel>` um den angegebenen Kanal zu verwenden;
- `-r` um AdGuard Home neu zu installieren;
- `-u` um AdGuard Home zu deinstallieren;
- `-v` für ausführliche Ausgabe.

Beachte, dass die Optionen `-r` und `-u` sich gegenseitig ausschließen.

### <a href="#alternative-methods" id="alternative-methods" name="alternative-methods">Alternative Methoden</a>

#### <a href="#manual-installation" id="manual-installation" name="manual-installation">Manuelle Installation</a>

Bitte lies den Artikel **[Erste Schritte][wiki-start]** in unserem Wiki, um zu erfahren, wie du AdGuard Home manuell installierst und wie du deine Geräte konfigurierst, um es zu verwenden.

#### <a href="#docker" id="docker" name="docker">Docker</a>

Du kannst unser offizielles Docker-Image auf [Docker Hub] verwenden.

#### <a href="#snap-store" id="snap-store" name="snap-store">Snap Store</a>

Wenn du **Linux,** verwendest, gibt es einen sicheren und einfachen Weg, AdGuard Home zu installieren: Hol es dir aus dem [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">Anleitungen</a>

Siehe unser [Wiki][wiki].

[wiki]: https://github.com/AdguardTeam/AdGuardHome/wiki

### <a href="#api" id="api" name="api">API</a>

Wenn du dich in AdGuard Home integrieren möchtest, kannst du unsere [REST-API][openapi] verwenden. Alternativ kannst du diesen [Python-Client][pyclient] verwenden, der zum Erstellen der [AdGuard Home Assistant-Integration][assistant-integration] genutzt werden kann.

[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">AdGuard Home im Vergleich zu anderen Lösungen</a>

### <a href="#comparison-adguard-dns" id="comparison-adguard-dns" name="comparison-adguard-dns">Wie unterscheidet sich dies von öffentlichen AdGuard-DNS-Servern?</a>

Wenn du deinen eigenen AdGuard-Home-Server betreibst, kannst du viel mehr tun, als nur einen öffentlichen DNS-Server zu verwenden. Das ist eine völlig andere Stufe. Überzeuge dich selbst:

- Wähle genau, was der Server blockiert und zulässt.

- Überwache deine Netzwerkaktivität.

- Füge deine eigenen benutzerdefinierten Filterregeln hinzu.

- **Am wichtigsten: Es ist dein eigener Server, und du bist der Einzige, der die Kontrolle hat.**

### <a href="#comparison-pi-hole" id="comparison-pi-hole" name="comparison-pi-hole">Wie schneidet AdGuard Home im Vergleich zu Pi-Hole ab?</a>

Derzeit hat AdGuard Home viel mit Pi-Hole gemeinsam. Beide blockieren Werbung und Tracker mithilfe der sogenannten „DNS-Sinkholing“-Methode, und beide erlauben, anzupassen, was blockiert wird.

> [!NOTE]
> Wir werden hier nicht aufhören. DNS-Sinkholing ist kein schlechter Ausgangspunkt, aber das ist erst der Anfang.

AdGuard Home bietet viele Funktionen sofort einsatzbereit, ohne dass zusätzliche Software installiert und konfiguriert werden muss. Wir möchten, dass es so einfach ist, dass selbst Gelegenheitsnutzer es mit minimalem Aufwand einrichten können.

> [!NOTE]
> Einige der aufgeführten Funktionen können zu Pi-Hole hinzugefügt werden, indem man zusätzliche Software installiert oder manuell das SSH-Terminal verwendet und eines der Hilfsprogramme, aus denen Pi-Hole besteht, neu konfiguriert. Unserer Meinung nach kann dies jedoch nicht als Funktion von Pi-Hole angesehen werden.

| Feature                                                                 | AdGuard&nbsp;Home | Pi-Hole                                                   |
|-------------------------------------------------------------------------|-------------------|-----------------------------------------------------------|
| Werbung und Tracker blockieren                                          | ✅                | ✅                                                        |
| Blocklisten anpassen                                                    | ✅                | ✅                                                        |
| Integrierter DHCP-Server                                                | ✅                | ✅                                                        |
| HTTPS für die Admin-Oberfläche                                          | ✅                | Gewissermaßen, aber du musst lighttpd manuell konfigurieren |
| Verschlüsselte DNS-Upstream-Server (DNS-over-HTTPS, DNS-over-TLS, DNSCrypt) | ✅                | ❌ (erfordert zusätzliche Software)                         |
| Plattformübergreifend                                                   | ✅                | ❌ (nicht nativ, nur über Docker)                        |
| Als DNS-over-HTTPS- oder DNS-over-TLS-Server laufen                     | ✅                | ❌ (erfordert zusätzliche Software)                         |
| Blockieren von Phishing- und Malware-Domains                            | ✅                | ❌ (erfordert nicht standardmäßige Blocklisten)            |
| Kindersicherung (Blockieren von Erwachsenendomains)                     | ✅                | ❌ (erfordert nicht standardmäßige Blocklisten)            |
| Sichere Suche in Suchmaschinen erzwingen                                | ✅                | ❌                                                        |
| Konfiguration pro Client (Gerät)                                        | ✅                | ✅                                                        |
| Zugriffseinstellungen (festlegen, wer AGH DNS verwenden darf)           | ✅                | ❌                                                        |
| Ausführung [ohne Root-Rechte][wiki-noroot]                              | ✅                | ❌                                                        |

[wiki-noroot]: https://adguard-dns.io/kb/adguard-home/getting-started/

### <a href="#comparison-adblock" id="comparison-adblock" name="comparison-adblock">Wie schneidet AdGuard Home im Vergleich zu herkömmlichen Werbeblockern ab?</a>

Das kommt darauf an.

DNS-Sinkholing kann einen großen Prozentsatz der Werbung blockieren, aber es fehlt ihm die Flexibilität und die Leistungsfähigkeit herkömmlicher Werbeblocker. Du kannst dir einen guten Eindruck vom Unterschied zwischen diesen Methoden verschaffen, indem du [diesen Artikel][blog-adaway] liest, der AdGuard für Android (einen herkömmlichen Werbeblocker) mit Hosts-basierten Werbeblockern vergleicht (die in ihren Fähigkeiten fast identisch mit DNS-basierten Blockern sind). Dieses Schutzniveau reicht für manche Nutzer aus.

Darüber hinaus kann ein DNS-basierter Blocker dabei helfen, Werbung, Tracking- und Analyseanfragen auf anderen Arten von Geräten zu blockieren, wie Smart-TVs, Smart Speakern oder anderen Arten von IoT-Geräten (auf denen du keine herkömmlichen Werbeblocker installieren kannst).

### <a href="#comparison-limitations" id="comparison-limitations" name="comparison-limitations">Bekannte Einschränkungen</a>

Hier sind einige Beispiele dafür, was von einem Blocker auf DNS-Ebene nicht blockiert werden kann:

- Werbung auf YouTube, Twitch;
- Gesponserte Beiträge auf Facebook, Twitter, Instagram.

Im Wesentlichen kann jegliche Werbung, die sich eine Domain mit Inhalten teilt, nicht von einem Blocker auf DNS-Ebene blockiert werden.

Gibt es eine Chance, das in Zukunft zu lösen?  DNS wird dafür nie ausreichen. Unsere einzige Option ist ein Content-Blocking-Proxy, ähnlich wie wir es in den eigenständigen AdGuard-Anwendungen machen. Wir werden die Unterstützung dieser Funktion [in Zukunft][issue-1228] zu AdGuard Home bringen. Leider wird es selbst dann noch Fälle geben, in denen das nicht ausreicht oder eine ziemlich komplizierte Konfiguration erfordert.

[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">So baust du aus dem Quellcode</a>

### <a href="#prerequisites" id="prerequisites" name="prerequisites">Voraussetzungen</a>

Führe `make init` aus, um die Entwicklungsumgebung vorzubereiten.

Für die Erstellung von AdGuard Home benötigst du Folgendes:

- [Go](https://golang.org/dl/) v1.25 oder neuer;
- [Node.js](https://nodejs.org/en/download/) v24.10.0 oder neuer;
- [npm](https://www.npmjs.com/) v10.8 oder neuer;

### <a href="#building" id="building" name="building">Erstellung</a>

Öffne dein Terminal und führe diese Befehle aus:```sh
git clone https://github.com/AdguardTeam/AdGuardHome
cd AdGuardHome
make

[!WARNING] Das nicht standardkonforme Flag -j wird derzeit nicht unterstützt. Daher wird das Erstellen mit make -j 4 oder das Setzen deiner MAKEFLAGS auf z. B. -j 4 den Build wahrscheinlich beschädigen. Falls deine MAKEFLAGS entsprechend gesetzt sind und du sie nicht ändern möchtest, kannst du sie durch Ausführen von make -j 1 überschreiben.

Sieh dir das Makefile an, um weitere Befehle zu erfahren.

Erstellen für eine andere Plattform

Du kannst AdGuard Home für jede beliebige OS/ARCH-Kombination erstellen, die Go unterstützt. Gib dazu die Umgebungsvariablen GOOS und GOARCH als Makros an, wenn du make ausführst.

Zum Beispiel:```sh env GOOS='linux' GOARCH='arm64' make

oder:```sh
make GOOS='linux' GOARCH='arm64'

Vorbereitung von Releases

Du benötigst snapcraft, um einen Release-Build vorzubereiten. Sobald es installiert ist, führe den folgenden Befehl aus:```sh make build-release CHANNEL='...' VERSION='...'

Siehe die [`build-release`-Zieldokumentation][targ-release].

#### <a href="#docker-image" id="docker-image" name="docker-image">Docker-Image</a>

Führe `make build-docker` aus, um das Docker-Image lokal zu erstellen (dasjenige, das wir auf DockerHub veröffentlichen). Bitte beachte, dass wir [Docker Buildx][buildx] verwenden, um unser offizielles Image zu erstellen.

Möglicherweise musst du dich vor der Verwendung dieser Builds vorbereiten:

- (nur Linux) Qemu installieren:  ```sh
  docker run --rm --privileged multiarch/qemu-user-static --reset -p yes --credential yes

Den Builder vorbereiten: ```sh docker buildx create --name buildx-builder --driver docker-container --use

Siehe die build-docker-Zieldokumentation.

Debuggen des Frontends

Wenn Sie das Frontend debuggen müssen, ohne jedes Mal die Produktionsversion neu zu kompilieren, um beispielsweise zu prüfen, wie Ihre Beschriftungen auf einem Formular aussehen würden, können Sie den Frontend-Build in einer Entwicklungsumgebung ausführen.

Führen Sie in einem separaten Terminal aus: ```sh ( cd ./client/ && env NODE_ENV='development' npm run watch )
Führen Sie Ihre AdGuardHome-Binärdatei mit dem Flag --local-frontend aus, das AdGuard Home anweist, die integrierten Frontend-Dateien zu ignorieren und die aus dem Verzeichnis ./build/ zu verwenden.
Jetzt sollten alle Änderungen, die Sie im Verzeichnis ./client/ vornehmen, neu kompiliert und in der Web-UI verfügbar sein. Stellen Sie sicher, dass Sie den Browser-Cache deaktivieren, um sicherzustellen, dass Sie tatsächlich die neu kompilierte Version erhalten.

End-to-End (E2E) Frontend-Tests

AdGuard Home verwendet Playwright für E2E-Tests. Die Tests befinden sich in tests/e2e.

Tests ausführen:

npm run test:e2e – Alle Tests ausführen (headless).
npm run test:e2e:interactive – Tests interaktiv ausführen.
npm run test:e2e:debug – Tests im Debug-Modus ausführen.
npm run test:e2e:codegen – Neuen Testcode generieren.

Einrichtung:

Führen Sie npm install aus, um Abhängigkeiten zu installieren.
Führen Sie npx playwright install aus, um die erforderlichen Browser einzurichten.

Warnung: Playwright wird für Tests eigene Browser-Binärdateien herunterladen und installieren, die von den auf Ihrem System installierten Browsern abweichen können.

Mitwirken

Sie sind herzlich eingeladen, dieses Repository zu forken, Ihre Änderungen vorzunehmen und einen Pull Request einzureichen. Bitte stellen Sie sicher, dass Sie unsere Code-Richtlinien befolgen.

Bitte beachten Sie, dass wir nicht erwarten, dass Personen gleichzeitig an den UI- und Backend-Teilen des Programms mitwirken. Idealerweise wird zuerst der Backend-Teil implementiert, d. h. Konfiguration, API und die Funktionalität selbst. Der UI-Teil kann später in einem anderen Pull Request von einer anderen Person implementiert werden.

Instabile Versionen testen

Es gibt zwei Update-Kanäle, die Sie nutzen können:

beta: Beta-Versionen von AdGuard Home. Mehr oder weniger stabile Versionen, die normalerweise alle zwei Wochen oder öfter veröffentlicht werden.
edge: die neueste Version von AdGuard Home aus dem Entwicklungszweig. Neue Updates werden täglich in diesen Kanal gepusht.

Es gibt drei Möglichkeiten, wie Sie eine instabile Version installieren können:

[Snap Store]: Suchen Sie nach den Kanälen beta und edge.
[Docker Hub]: Suchen Sie nach den Tags beta und edge.
Standalone-Builds. Verwenden Sie das automatisierte Installationsskript oder suchen Sie nach den verfügbaren Builds [im Wiki][wiki-platf].

Skript zum Installieren einer Beta-Version: ```sh curl -s -S -L https://raw.githubusercontent.com/AdguardTeam/AdGuardHome/master/scripts/install.sh | sh -s -- -c beta

Skript zum Installieren einer Edge-Version: ```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">Probleme melden</a>

Wenn Sie auf ein Problem stoßen oder einen Vorschlag haben, gehen Sie zu [dieser Seite][iss] und klicken Sie auf die Schaltfläche “New issue”. Bitte befolgen Sie die Anweisungen im Issue-Formular sorgfältig und vergessen Sie nicht, zuerst nach Duplikaten zu suchen.

[iss]: https://github.com/AdguardTeam/AdGuardHome/issues

### <a href="#translate" id="translate" name="translate">Hilfe bei Übersetzungen</a>

Wenn Sie bei den Übersetzungen von AdGuard Home helfen möchten, erfahren Sie bitte mehr über das Übersetzen von AdGuard-Produkten [in unserer Wissensdatenbank][kb-trans]. Sie können zum [AdGuardHome-Projekt auf CrowdIn][crowdin] beitragen.

[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">Sonstiges</a>

Eine weitere Möglichkeit, einen Beitrag zu leisten, besteht darin, [nach Issues][iss-help] zu suchen, die mit `help wanted` markiert sind, zu fragen, ob das Issue verfügbar ist, und einen PR zu senden, der den Fehler behebt oder das Feature implementiert.

[iss-help]: https://github.com/AdguardTeam/AdGuardHome/issues?q=is:issue+is:open+label:%22help+wanted%22

## <a href="#uses" id="uses" name="uses">Projekte, die AdGuard Home verwenden</a>

Bitte beachten Sie, dass diese Projekte nicht mit AdGuard verbunden sind, sondern von Drittentwicklern und Fans erstellt wurden.

- [AdGuard Home Remote](https://apps.apple.com/app/apple-store/id1543143740): iOS-App von [Joost](https://rocketscience-it.nl/).

- [Python-Bibliothek](https://github.com/frenck/python-adguardhome) von [@frenck](https://github.com/frenck).

- [Home Assistant-Add-on](https://github.com/hassio-addons/addon-adguard-home) von [@frenck](https://github.com/frenck).

- [OpenWrt-LUCI-App](https://github.com/kongfl888/luci-app-adguardhome) von [@kongfl888](https://github.com/kongfl888) (ursprünglich von [@rufengsuixing](https://github.com/rufengsuixing)).

- [AdGuardHome sync](https://github.com/bakito/adguardhome-sync) von [@bakito](https://github.com/bakito).

- [Terminalbasiertes Echtzeit-Traffic-Monitoring und Statistiken für Ihre AdGuard-Home-Instanz](https://github.com/Lissy93/AdGuardian-Term) von [@Lissy93](https://github.com/Lissy93)

- [AdGuard Home auf GLInet-Routern](https://forum.gl-inet.com/t/adguardhome-on-gl-routers/10664) von [Gl-Inet](https://gl-inet.com/).

- [Cloudron-App](https://git.cloudron.io/cloudron/adguard-home-app) von [@gramakri](https://github.com/gramakri).

- [Asuswrt-Merlin-AdGuardHome-Installer](https://github.com/jumpsmm7/Asuswrt-Merlin-AdGuardHome-Installer) von [@jumpsmm7](https://github.com/jumpsmm7) aka [@SomeWhereOverTheRainBow](https://www.snbforums.com/members/somewhereovertherainbow.64179/).

- [Node.js-Bibliothek](https://github.com/Andrea055/AdguardHomeAPI) von [@Andrea055](https://github.com/Andrea055/).

- [Browser-Erweiterung](https://github.com/satheshshiva/Adguard-Home-Browser-Ext) von [@satheshshiva](https://github.com/satheshshiva/).

- [Zabbix-Vorlage für AdGuard Home](https://github.com/diasdmhub/AdGuard_Home_Zabbix_Template) von [@diasdmhub](https://github.com/diasdmhub).

- [Chocolatey-Paket](https://community.chocolatey.org/packages/adguardhome/) von [niks255](https://community.chocolatey.org/profiles/niks255).

- [ZimaOS-App-Store-Eintrag](https://www.zimaspace.com/zimaos/app-store/app/org.icewhale.adguardhome) vom [CasaOS Team](https://casaos.zimaspace.com/).

## <a href="#acknowledgments" id="acknowledgments" name="acknowledgments">Danksagungen</a>

Diese Software wäre ohne Folgendes nicht möglich gewesen:

- [Go](https://golang.org/dl/) und seine Bibliotheken:
 - [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/) und seine Bibliotheken:
 - [React.js](https://reactjs.org)
 - [Tabler](https://github.com/tabler/tabler)
 - Und viele weitere Node.js-Pakete.
- [whotracks.me-Daten](https://github.com/cliqz-oss/whotracks.me)

Sie haben vielleicht gesehen, dass [CoreDNS] hier zuvor erwähnt wurde, aber wir verwenden es in AdGuard Home nicht mehr.

Die vollständige Liste aller verwendeten Node.js-Pakete finden Sie in der Datei [`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">Datenschutz</a>

Unsere Hauptidee ist, dass Sie diejenigen sind, die die Kontrolle über Ihre Daten haben sollten. Daher ist es nur natürlich, dass AdGuard Home keinerlei Nutzungsstatistiken erfasst und keine Webdienste verwendet, es sei denn, Sie konfigurieren es entsprechend. Siehe auch die [vollständige Datenschutzrichtlinie][privacy], in der alle Daten aufgeführt sind, die von AdGuard Home *theoretisch gesendet werden könnten*.

[privacy]: https://adguard.com/en/privacy/home.html

AdGuardHome

Beliebteste

Datenschutzzentrum für Sie und Ihre Geräte