ugzv/ublockdnsclientClient DNS système multiplateforme pour uBlockDNS avec blocage des publicités et des traqueurs à l'échelle de l'appareil et mises à jour des filtres en temps réel.
uBlockDNS Client est un projet indépendant et n'est pas affilié à, approuvé par, ou lié à uBlock Origin ou à son mainteneur.
uBlockDNS Client apporte le blocage des publicités et des traqueurs au niveau DNS sur l'ensemble de votre appareil. Il utilise des listes de filtres maintenues par la communauté, telles que EasyList et EasyPrivacy, appliquées au niveau DNS afin que les applications, navigateurs et services en arrière-plan soient couverts sans extensions par navigateur.
Site web : ublockdns.com
uBlockDNS Client est conçu pour les environnements de bureau et serveur où vous souhaitez un point d'installation unique, une protection à l'échelle du système et une configuration à distance via le tableau de bord uBlockDNS.
Créez un compte gratuit sur ublockdns.com, puis suivez le guide de configuration dans votre tableau de bord. Le guide couvre toutes les plateformes prises en charge avec des commandes à copier-coller et des instructions étape par étape.
Installation rapide pour macOS et Linux :
curl -sSfL https://ublockdns.com/install.sh | sh -s -- <profile-id>
Utilisez -L pour que curl suive les redirections Cloudflare du script d'installation hébergé.
Pendant l'installation, votre mot de passe administrateur Mac ou Linux peut vous être demandé pour mettre à jour les paramètres DNS du système.
Vérifier la somme de contrôle du script d'installation (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 ou ultérieur (PowerShell en tant qu'administrateur) :
irm https://ublockdns.com/install?id=<profile-id> | iex
Le tableau de bord utilise ce flux d'amorçage. Il télécharge l'installateur depuis /install-script, ce qui évite les problèmes de redirection Cloudflare pouvant interrompre les téléchargements directs de /install.ps1.
Les installateurs et binaires Windows publiés nécessitent Windows 10 ou ultérieur. Windows 7, Windows 8 et Windows 8.1 ne sont pas pris en charge.
Vérifier la somme de contrôle du script d'installation (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>
Un installateur Windows avec interface graphique (.exe) est également disponible sur la page des versions.
Le service se met à jour automatiquement chaque jour ; les versions sont vérifiées par rapport à la clé de signature uBlockDNS avant d'être appliquées. Définissez UBLOCKDNS_NO_AUTOUPDATE=1 dans l'environnement du service pour vous désinscrire, ou mettez à jour manuellement avec sudo ublockdns upgrade.
Les mises à jour automatiques s'appliquent sur macOS, Windows et Linux. Sur FreeBSD, rc.d ne redémarre pas un service qui se termine, donc le client ne se met pas à jour automatiquement sur cette plateforme ; utilisez sudo ublockdns upgrade. Le client enregistre dans les journaux le mode dans lequel il se trouve au démarrage.
Versions plus anciennes sans la commande upgrade : réexécutez la commande d'installation une fois et les mises à jour automatiques prendront le relais.
macOS et Linux :
sudo ublockdns uninstall
Windows (PowerShell en tant qu'administrateur) :
& "$env:ProgramFiles\uBlockDNS\ublockdns.exe" uninstall
Le & initial est requis. Sans lui, PowerShell traite le chemin entre guillemets comme une simple chaîne et signale Unexpected token 'uninstall'.
La désinstallation arrête le service et restaure vos paramètres DNS précédents. Le binaire reste sur le disque ; supprimez-le manuellement si vous n'en voulez plus. Exécutez ensuite ublockdns status pour confirmer que le DNS du système ne pointe plus vers 127.0.0.1.
Le guide de configuration du tableau de bord couvre également Chrome, Firefox, iOS, Android et les routeurs. Ceux-ci utilisent DNS-over-HTTPS directement et ne nécessitent pas ce client.
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
Gérez vos listes de filtres, règles personnalisées et journal des requêtes depuis le tableau de bord. L'interface en ligne de commande est volontairement limitée : installez le service local, vérifiez qu'il est sain, et laissez le tableau de bord gérer les changements de politique.
Le client exécute un proxy DNS local sur 127.0.0.1:53 et transmet toutes les requêtes au service uBlockDNS via DNS-over-HTTPS chiffré. Le service évalue chaque requête par rapport aux listes de filtres et aux règles personnalisées activées pour votre profil, puis renvoie soit la réponse DNS normale, soit une réponse de blocage.
Lorsque vous mettez à jour des listes de filtres ou des règles personnalisées dans le tableau de bord, le client reçoit ces changements en temps réel et vide automatiquement le cache DNS local afin que les nouvelles décisions prennent effet rapidement.
Nécessite Go 1.25 ou ultérieur.
go build -o ublockdns .
sudo ./ublockdns install -profile <profile-id>
Vous avez trouvé un bug ou avez une suggestion ? Ouvrez une issue.
Pour les problèmes de blocage (publicités qui passent ou site bloqué à tort), vérifiez d'abord les listes de filtres que vous avez activées dans votre tableau de bord. uBlockDNS utilise des listes maintenues par la communauté et n'en contrôle pas le contenu.
Signalez les vulnérabilités de sécurité en privé via les GitHub Security Advisories. N'ouvrez pas d'issues publiques pour les problèmes de sécurité.
Pour les détails du modèle de confiance, la transparence du développement et l'état actuel de l'audit, consultez SECURITY.md.
MIT