ugzv/ublockdnsclientPlattformübergreifender System-DNS-Client für uBlockDNS mit geräteweiter Werbe- und Tracker-Blockierung sowie Filter-Updates in Echtzeit.
uBlockDNS Client ist ein unabhängiges Projekt und ist nicht mit uBlock Origin oder dessen Betreuer verbunden, wird von diesen nicht unterstützt und steht in keiner Beziehung dazu.
uBlockDNS Client bringt Werbe- und Tracker-Blockierung auf DNS-Ebene auf Ihr gesamtes Gerät. Er verwendet von der Community gepflegte Filterlisten wie EasyList und EasyPrivacy, die auf der DNS-Ebene angewendet werden, sodass Apps, Browser und Hintergrunddienste ohne browser-spezifische Erweiterungen abgedeckt sind.
Website: ublockdns.com
uBlockDNS Client ist für Desktop- und Serverumgebungen gedacht, in denen Sie einen einzigen Installationspunkt, systemweiten Schutz und die Fernkonfiguration über das uBlockDNS-Dashboard wünschen.
Erstellen Sie ein kostenloses Konto auf ublockdns.com und folgen Sie dann der Einrichtungsanleitung in Ihrem Dashboard. Die Anleitung deckt alle unterstützten Plattformen mit Copy-and-Paste-Befehlen und Schritt-für-Schritt-Anweisungen ab.
Schnellinstallation für macOS und Linux:
curl -sSfL https://ublockdns.com/install.sh | sh -s -- <profile-id>
Verwenden Sie -L, damit curl Cloudflare-Weiterleitungen beim gehosteten Installationsskript folgt.
Während der Installation werden Sie möglicherweise nach Ihrem Mac- oder Linux-Administratorkennwort gefragt, um die System-DNS-Einstellungen zu aktualisieren.
Prüfsumme des Installationsskripts verifizieren (Linux):
curl -sSfLO https://ublockdns.com/install.sh
curl -sSfLO https://github.com/ugzv/ublockdnsclient/releases/latest/download/SCRIPT_SHA256SUMS
grep " install.sh$" SCRIPT_SHA256SUMS | sha256sum -c -
sh install.sh <profile-id>
Windows 10 oder neuer (PowerShell als Administrator):
irm https://ublockdns.com/install?id=<profile-id> | iex
Das Dashboard verwendet diesen Bootstrap-Ablauf. Es lädt das Installationsprogramm von /install-script herunter, wodurch Cloudflare-Weiterleitungsprobleme vermieden werden, die direkte /install.ps1-Downloads stören können.
Veröffentlichte Windows-Installationsprogramme und -Binärdateien erfordern Windows 10 oder neuer. Windows 7, Windows 8 und Windows 8.1 werden nicht unterstützt.
Prüfsumme des Installationsskripts verifizieren (PowerShell):
iwr https://ublockdns.com/install-script -OutFile install.ps1
iwr https://github.com/ugzv/ublockdnsclient/releases/latest/download/SCRIPT_SHA256SUMS -OutFile SCRIPT_SHA256SUMS
$expected = (Select-String -Path .\SCRIPT_SHA256SUMS -Pattern " install.ps1$").Line.Split()[0].ToLower()
$actual = (Get-FileHash .\install.ps1 -Algorithm SHA256).Hash.ToLower()
if ($actual -ne $expected) { throw "install.ps1 checksum mismatch" }
powershell -ExecutionPolicy Bypass -File .\install.ps1 -ProfileId <profile-id>
Ein Windows-GUI-Installationsprogramm (.exe) ist ebenfalls auf der Releases-Seite verfügbar.
Der Dienst aktualisiert sich täglich selbst; Releases werden vor der Anwendung gegen den uBlockDNS-Signaturschlüssel verifiziert. Setzen Sie UBLOCKDNS_NO_AUTOUPDATE=1 in der Dienstumgebung, um dies zu deaktivieren, oder aktualisieren Sie manuell mit sudo ublockdns upgrade.
Automatische Updates gelten für macOS, Windows und Linux. Unter FreeBSD startet rc.d einen Dienst, der beendet wurde, nicht neu, daher aktualisiert sich der Client dort nicht selbst; verwenden Sie sudo ublockdns upgrade. Der Client protokolliert beim Start, in welchem Modus er sich befindet.
Ältere Versionen ohne den Befehl upgrade: Führen Sie den Installationsbefehl einmal erneut aus, und die automatischen Updates übernehmen.
macOS und Linux:
sudo ublockdns uninstall
Windows (PowerShell als Administrator):
& "$env:ProgramFiles\uBlockDNS\ublockdns.exe" uninstall
Das führende & ist erforderlich. Ohne es behandelt PowerShell den in Anführungszeichen gesetzten Pfad als einfache Zeichenfolge und meldet Unexpected token 'uninstall'.
Die Deinstallation stoppt den Dienst und stellt Ihre vorherigen DNS-Einstellungen wieder her. Die Binärdatei bleibt auf der Festplatte; löschen Sie sie manuell, wenn Sie sie nicht mehr benötigen. Führen Sie anschließend ublockdns status aus, um zu bestätigen, dass das System-DNS nicht mehr auf 127.0.0.1 zeigt.
Die Einrichtungsanleitung im Dashboard behandelt auch Chrome, Firefox, iOS, Android und Router. Diese verwenden DNS-over-HTTPS direkt und benötigen diesen Client nicht.
linux/amd64, linux/arm64, linux/armv7, darwin/amd64, darwin/arm64, windows/amd64, windows/arm64, freebsd/amd64
ublockdns install -profile <profile-id> Install as system service
ublockdns uninstall Remove service and restore DNS
ublockdns start Start the service
ublockdns stop Stop the service
ublockdns status Show service state and readiness details
ublockdns status -json Show machine-readable status with ready_code and probe_error
ublockdns wait-ready -timeout 45s Wait until service and DNS are active
ublockdns wait-ready -timeout 45s -json Emit machine-readable readiness state for automation
ublockdns upgrade Update to the latest release and restart the service
ublockdns version Print version
Verwalten Sie Ihre Filterlisten, benutzerdefinierten Regeln und das Abfrageprotokoll über das Dashboard. Die CLI ist bewusst schlank gehalten: Installieren Sie den lokalen Dienst, vergewissern Sie sich, dass er fehlerfrei läuft, und lassen Sie das Dashboard Richtlinienänderungen übernehmen.
Der Client führt einen lokalen DNS-Proxy unter 127.0.0.1:53 aus und leitet alle Abfragen über verschlüsseltes DNS-over-HTTPS an den uBlockDNS-Dienst weiter. Der Dienst wertet jede Abfrage anhand der für Ihr Profil aktivierten Filterlisten und benutzerdefinierten Regeln aus und gibt dann entweder die normale DNS-Antwort oder eine Blockier-Antwort zurück.
Wenn Sie Filterlisten oder benutzerdefinierte Regeln im Dashboard aktualisieren, empfängt der Client diese Änderungen in Echtzeit und leert den lokalen DNS-Cache automatisch, sodass neue Entscheidungen schnell wirksam werden.
Erfordert Go 1.25 oder neuer.
go build -o ublockdns .
sudo ./ublockdns install -profile <profile-id>
Einen Fehler gefunden oder einen Vorschlag? Erstellen Sie ein Issue.
Bei Blockierproblemen (Werbung wird durchgelassen oder eine Website wird fälschlich blockiert) prüfen Sie zuerst, welche Filterlisten Sie in Ihrem Dashboard aktiviert haben. uBlockDNS verwendet von der Community gepflegte Listen und hat keine Kontrolle über deren Inhalte.
Melden Sie Sicherheitslücken vertraulich über GitHub Security Advisories. Öffnen Sie keine öffentlichen Issues für Sicherheitsprobleme.
Einzelheiten zum Vertrauensmodell, zur Entwicklungstransparenz und zum aktuellen Prüfstatus finden Sie in SECURITY.md.
MIT