AdGuardHome
v0.107.54
Kostenlose und Open Source, leistungsstarke netzwerkweite Anzeigen und Tracker, die den DNS-Server blockieren.
Adguard.com | Wiki | Reddit | Twitter | Telegramm
Adguard Home ist eine netzwerkweite Software zum Blockieren von Anzeigen und Tracking. Nachdem Sie es eingerichtet haben, werden alle Ihre Heimatgeräte behandelt und Sie benötigen dafür keine clientseitige Software.
Es arbeitet als DNS-Server, der die Verfolgung von Domänen mit einem „Schwarzen Loch“ umleitet und so verhindert, dass Ihre Geräte mit diesen Servern eine Verbindung herstellen. Es basiert auf Software, die wir für unsere öffentlichen Adguard -DNS -Server verwenden, und beide teilen viel Code.
Erste Schritte
Automatisierte Installation (Linux/Unix/macOS/FreeBSD/OpenBSD)
Alternative Methoden
Führer
API
Vergleich von Adguard mit anderen Lösungen
Wie unterscheidet sich das von öffentlichen Adguard -DNS -Servern?
Wie ist Adguard Home im Vergleich zu Pi-Hole?
Wie ist Adguard Home im Vergleich zu traditionellen Anzeigenblockern?
Bekannte Einschränkungen
Wie man aus der Quelle baut
Voraussetzungen
Gebäude
Beitragen
Testen Sie instabile Versionen
Meldungsprobleme
Hilfe bei Übersetzungen
Andere
Projekte, die Adguard Home nutzen
Anerkennung
Privatsphäre
So installieren Sie mit curl den folgenden Befehl:
curl -s -s -l https://raw.githubuSercontent.com/adguardteam/adguardhome/master/scripts/install.sh | sh -s --v
So installieren Sie mit wget den folgenden Befehl:
WGet -No-verbose -o -https://raw.githubuSercontent.com/adguardteam/adguardhome/master/scripts/install.sh | sh -s --v
So installieren Sie mit fetch den folgenden Befehl: Ausführen Sie den folgenden Befehl:
Fetch -o - https://raw.githubuSercontent.com/adguardteam/adguardhome/master/scripts/install.sh | sh -s --v
Das Skript akzeptiert auch einige Optionen:
-c <channel> zur Verwendung des angegebenen Kanals;
-r , um Adguard nach Hause neu zu installieren;
-u , um Adguard nach Hause zu deinstallieren;
-v für die ausführliche Ausgabe.
Beachten Sie, dass Optionen -r und -u sich gegenseitig ausschließen.
Bitte lesen Sie den Artikel "Erste Schritte " in unserem Wiki, um zu erfahren, wie Sie Adguard Home manuell installieren und wie Sie Ihre Geräte für die Verwendung konfigurieren.
Sie können unser offizielles Docker -Image auf Docker Hub verwenden.
Wenn Sie Linux ausführen, gibt es eine sichere und einfache Möglichkeit, Adguard Home zu installieren: Holen Sie es aus dem Snap Store.
Sehen Sie unser Wiki.
Wenn Sie sich in Adguard Home integrieren möchten, können Sie unsere REST -API verwenden. Alternativ können Sie diesen Python-Client verwenden, mit dem das Addguard Home Hass.io Add-On erstellt wird.
Mit Ihrem eigenen Adguard -Home -Server können Sie viel mehr tun, als einen öffentlichen DNS -Server zu verwenden. Es ist ein völlig anderes Niveau. Überzeugen Sie sich selbst:
Wählen Sie genau, was genau die Serverblöcke und Genehmigungen ermöglichen.
Überwachen Sie Ihre Netzwerkaktivität.
Fügen Sie Ihre eigenen benutzerdefinierten Filterregeln hinzu.
Am wichtigsten ist, dass es Ihr eigener Server ist, und Sie sind der einzige, der die Kontrolle hat.
Zu diesem Zeitpunkt hat Adguard Home viel mit Pi-Hole gemeinsam. Beide blockieren Anzeigen und Tracker, die die sogenannte "DNS Sinkholing" -Methode verwenden, und beide ermöglichen das Anpassen, was blockiert ist.
Notiz
Wir werden hier nicht aufhören. DNS Sinkholing ist kein schlechter Ausgangspunkt, aber dies ist nur der Anfang.
Adguard Home bietet viele Funktionen außerhalb des Boxs, ohne zusätzliche Software zu installieren und zu konfigurieren. Wir möchten, dass es so einfach ist, dass selbst Gelegenheitsbenutzer es mit minimaler Anstrengung einrichten können.
Notiz
Einige der aufgelisteten Funktionen können zu PI-LOOL hinzugefügt werden, indem zusätzliche Software installiert oder durch manuelles SSH-Terminal und die Neukonfiguration eines der Versorgungsunternehmen PI-LOLE besteht. Unserer Meinung nach kann dies jedoch nicht als Pi-Hole-Merkmal angesehen werden.
| Besonderheit | Adguard Home | Pi-Loch |
|---|---|---|
| Blockieren von Anzeigen und Trackern | ✅ | ✅ |
| Blocklisten anpassen | ✅ | ✅ |
| Eingebauter DHCP-Server | ✅ | ✅ |
| HTTPS für die Administratorschnittstelle | ✅ | Art, aber Sie müssen lightTPD manuell konfigurieren |
| Verschlüsselte DNS-Upstream-Server (DNS-Over-HTTPS, DNS-OUT-TLS, DNSCRYPT) | ✅ | (Benötigt zusätzliche Software) |
| Plattformübergreifend | ✅ | (Nicht nativ, nur über Docker) |
| Ausführen als DNS-Over-HTTPS- oder DNS-Over-TLS-Server | ✅ | (Benötigt zusätzliche Software) |
| Blockieren von Phishing- und Malware -Domänen | ✅ | (Erfordert Nicht-Default-Blocklisten) |
| Elternkontrolle (Blockierung von Domänen für Erwachsene) | ✅ | (Erfordert Nicht-Default-Blocklisten) |
| Sichere Suche nach Suchmaschinen erzwingen | ✅ | |
| Pro-Client-Konfiguration (Geräte) | ✅ | ✅ |
| Zugriffseinstellungen (wählen Sie, wer AGH DNS verwenden kann) | ✅ | |
| Laufen ohne Root -Privilegien | ✅ |
Es kommt darauf an.
DNS Sinkholing ist in der Lage, einen großen Prozentsatz an Anzeigen zu blockieren, aber es fehlt die Flexibilität und die Leistung herkömmlicher Anzeigenblocker. Sie können einen guten Eindruck über den Unterschied zwischen diesen Methoden erhalten, indem Sie diesen Artikel lesen, in dem AdGuard für Android (einen herkömmlichen Anzeigenblocker) mit Werbeblockern auf Hostsebene vergleicht (die in ihren Fähigkeiten nahezu mit DNS-basierten Blockern identisch sind). Dieser Schutzniveau reicht für einige Benutzer aus.
Darüber hinaus kann die Verwendung eines DNS-basierten Blockers dazu beitragen, Anzeigen, Tracking- und Analyseanforderungen auf anderen Arten von Geräten zu blockieren, z.
Hier sind einige Beispiele dafür, was durch einen Blocker auf DNS-Ebene nicht blockiert werden kann:
YouTube, Twitch Ads;
Facebook, Twitter, instagram gesponserte Beiträge.
Im Wesentlichen kann jede Werbung, die eine Domain mit Inhalten teilt, nicht durch einen Blocker auf DNS-Ebene blockiert werden.
Gibt es eine Chance, dies in Zukunft zu bewältigen? DNS wird niemals ausreichen, um dies zu tun. Unsere einzige Möglichkeit ist die Verwendung eines Inhalts, der Proxy wie das, was wir in den eigenständigen Adguard -Anwendungen tun, blockieren. Wir werden diese Funktionsunterstützung in Zukunft in Adguard Home bringen. Leider gibt es auch in diesem Fall noch Fälle, in denen dies nicht ausreicht oder eine ziemlich komplizierte Konfiguration erfordern würde.
Run make init um die Entwicklungsumgebung vorzubereiten.
Sie benötigen dies, um Adguard zu Hause zu bauen:
Go v1.23 oder höher;
Node.js v18.18 oder höher;
NPM V8 oder höher;
Öffnen Sie Ihr Terminal und führen Sie diese Befehle aus:
Git Clone https://github.com/adguardteam/adguardhomecd adguardhome machen
Warnung
Das nicht -j Flag wird derzeit nicht unterstützt. Bauen Sie daher mit make -j 4 oder festlegen, um Ihre MAKEFLAGS einzuschließen, um beispielsweise -j 4 den Build zu brechen. Wenn Sie Ihre MAKEFLAGS darauf einstellen lassen und Sie sie nicht ändern möchten, können Sie sie überschreiben, indem Sie make -j 1 ausführen.
Überprüfen Sie das Makefile um mehr über andere Befehle zu erfahren.
Sie können Adguard zu Hause für jeden Betriebssystem/Arch bauen, der unterstützt wird. Geben Sie dazu bei der Ausführung GOOS und GOARCH -Umgebungsvariablen als Makros als make an.
Zum Beispiel:
env Goos = 'Linux' goarch = 'Arm64' machen
oder:
Machen Sie GoOS = 'Linux' goarch = 'Arm64'
Sie benötigen snapcraft um einen Release -Build vorzubereiten. Führen Sie nach der Installation den folgenden Befehl aus:
Machen Sie Build-Release-Kanal = '...' Version = '...'
Siehe die Dokumentation build-release Ziele.
Run make build-docker , um das Docker-Bild lokal zu erstellen (das, das wir an DockerHub veröffentlichen). Bitte beachten Sie, dass wir Docker Buildx verwenden, um unser offizielles Image zu erstellen.
Möglicherweise müssen Sie sich vor der Verwendung dieser Builds vorbereiten:
(Nur Linux) QEMU installieren:
Docker Run--RM-Privilegierte Multiarch/Qemu-Benutzer-statische-Reseet -p Ja-Krönt Ja
Bereiten Sie den Baumeister vor:
Docker Buildx erstellen-name buildx-builder-Fahrer Docker-Container --use
Siehe die Dokumentation build-docker -Ziele.
Wenn Sie das Frontend debuggen, ohne die Produktionsversion jedes Mal neu zu kompilieren, beispielsweise zu überprüfen, wie Ihre Etiketten auf einem Formular aussehen, können Sie die Frontend Build eine Entwicklungsumgebung ausführen.
Rennen Sie in einem separaten Terminal:
(CD ./client/ && env node_env = 'Development' NPM Run Watch)
Führen Sie Ihr AdGuardHome Binary mit dem Flag --local-frontend -Flag aus, das Adguard nach Hause anweist, die integrierten Frontend-Dateien zu ignorieren und diese aus dem Verzeichnis ./build/ zu verwenden.
Jetzt sollten alle Änderungen, die Sie im Verzeichnis ./client/ vornehmen, neu kompiliert und in der Web -Benutzeroberfläche verfügbar sein. Stellen Sie sicher, dass Sie den Browser -Cache deaktivieren, um sicherzustellen, dass Sie die neu kompilierte Version tatsächlich erhalten.
Sie sind herzlich eingeladen, dieses Repository zu geben, Ihre Änderungen vorzunehmen und eine Pull -Anfrage einzureichen. Bitte befolgen Sie jedoch unsere Code -Richtlinien.
Bitte beachten Sie, dass wir nicht erwarten, dass Menschen gleichzeitig sowohl zu UI- als auch zu Backend -Teilen des Programms beitragen. Im Idealfall wird der Backend -Teil zuerst implementiert, dh Konfiguration, API und die Funktionalität selbst. Der UI -Teil kann später in einer anderen Pull -Anfrage durch eine andere Person implementiert werden.
Es gibt zwei Update -Kanäle, die Sie verwenden können:
beta : Beta -Versionen von Adguard Home. Mehr oder weniger stabile Versionen, die normalerweise alle zwei Wochen oder öfter freigegeben werden.
edge : Die neueste Version von Adguard Home aus der Entwicklungszweig. Neue Updates werden täglich auf diesen Kanal gedrängt.
Es gibt drei Optionen, wie Sie eine instabile Version installieren können:
Snap Store: Suchen Sie nach den beta und edge .
Docker Hub: Suchen Sie nach den beta und edge -Tags.
Standalone Builds. Verwenden Sie das automatisierte Installationsskript oder suchen Sie nach den verfügbaren Builds auf dem Wiki.
Skript zum Installieren einer Beta -Version:
curl -s -s -l https://raw.githubuSercontent.com/adguardteam/adguardhome/master/scripts/install.sh | sh -s --c Beta
Skript zum Installieren einer Edgeversion:
curl -s -s -l https://raw.githubuSercontent.com/adguardteam/adguardhome/master/scripts/install.sh | sh -s --c Kante
Wenn Sie auf ein Problem stoßen oder einen Vorschlag haben, besuchen Sie diese Seite und klicken Sie auf die Schaltfläche „Neues Problem“. Bitte befolgen Sie die Anweisungen in der Ausgabeform sorgfältig und vergessen Sie nicht, zunächst nach Duplikaten zu beginnen.
Wenn Sie bei Adguard Home -Übersetzungen helfen möchten, erfahren Sie mehr über die Übersetzung von Adguard -Produkten in unserer Wissensbasis. Sie können zum Adguardhome -Projekt auf Crowdin beitragen.
Eine andere Möglichkeit, wie Sie einen Beitrag leisten können, besteht darin, nach Problemen zu suchen, die als help wanted gekennzeichnet sind, ob das Problem zu gewinnen ist, und das Senden eines PR -Reparaturs des Fehlers oder der Implementierung der Funktion.
Bitte beachten Sie, dass diese Projekte nicht mit Adguard verbunden sind, sondern von Entwicklern und Fans von Drittanbietern hergestellt werden.
Adguard Home Remote: iOS App von Joost.
Python Library von @Frenck.
Home Assistant Add-On von @Frenck.
OpenWRT Luci App von @Kongfl888 (ursprünglich von @rufengsuixing).
Adguardhome sync von @bakito.
Terminalbasierte, Echtzeit-Verkehrsüberwachung und Statistiken für Ihre Adguard Home-Instanz von @lissy93
Adguard Home auf Glinet-Routern von GL-Inet.
Cloudron -App von @gramakri.
Asuswrt-Merlin-AdguardHome-Installer von @JumpsMM7 alias @SomeWherovertherainbow.
Node.js bibliothek von @andrea055.
Browser -Erweiterung von @satheshshiva.
ZABBIX -Vorlage für Adguard Home von @DiasDMHUB.
Schokoladenpaket von NIKS255.
Diese Software wäre ohne:
Gehen Sie und seine Bibliotheken:
Gcache
Miekgs DNS
Go-Yaml
Service
DNSPROXY
urlfilter
Node.js und seine Bibliotheken:
React.js
Tabler
Und viele weitere Node.js -Pakete.
whotracks.me Daten
Sie haben vielleicht gesehen, dass Coredns hier bereits erwähnt wurde, aber wir haben es in Adguard Home aufgehört.
Die vollständige Liste aller verwendeten Node.js -Pakete finden Sie in der Datei client/package.json .
Unsere Hauptidee ist, dass Sie derjenige sind, der die Kontrolle über Ihre Daten haben sollte. Daher ist es nur natürlich, dass Adguard Home keine Verwendungsstatistiken sammelt und keine Webdienste verwendet, es sei denn, Sie konfigurieren es dafür. Siehe auch die vollständige Datenschutzrichtlinie mit jedem Bit, das theoretisch von Adguard Home gesendet werden kann, ist verfügbar.
