Client uBlockDNS

uBlockDNS Client est un projet indépendant et n'est pas affilié, approuvé ou lié à uBlock Origin ou à son mainteneur.

uBlockDNS Client apporte un 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 qu'EasyList et EasyPrivacy, appliquées au niveau DNS afin que les applications, les navigateurs et les services en arrière-plan soient couverts sans extensions par navigateur.

Site web : ublockdns.com

uBlockDNS Client est destiné aux 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.

Points forts

Filtrage DNS à l'échelle du système pour les navigateurs, les applications et le trafic en arrière-plan
Connexion DNS-over-HTTPS chiffrée en amont vers le service uBlockDNS
Mises à jour en temps réel des listes de filtres et des règles personnalisées depuis votre tableau de bord
Modèle de service local avec vérifications d'état et commandes de gestion du service
Prise en charge multiplateforme pour macOS, Linux, Windows 10+ et FreeBSD

Installation

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 sur le script d'installation hébergé.

Pendant l'installation, il peut vous être demandé votre mot de passe administrateur Mac ou Linux 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 version ultérieure (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 le programme d'installation depuis /install-script, ce qui évite les problèmes de redirection Cloudflare qui peuvent interrompre les téléchargements directs de /install.ps1.

Les programmes d'installation et binaires Windows publiés nécessitent Windows 10 ou version ultérieure. 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 programme d'installation Windows avec interface graphique (.exe) est également disponible sur la page des versions.

Mise à jour

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 consigne 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.

Désinstallation

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 ublockdns status ensuite pour confirmer que le DNS système ne pointe plus vers 127.0.0.1.

Autres plateformes

Le guide de configuration du tableau de bord couvre également Chrome, Firefox, iOS, Android et les routeurs. Ceux-ci utilisent directement DNS-over-HTTPS et ne nécessitent pas ce client.

Architectures prises en charge

linux/amd64, linux/arm64, linux/armv7, darwin/amd64, darwin/arm64, windows/amd64, windows/arm64, freebsd/amd64

Utilisation

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, vos règles personnalisées et votre 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.

Comment cela fonctionne

Le client exécute un proxy DNS local sur 127.0.0.1:53 et, lorsque IPv6 est disponible, sur [::1]:53. Il transmet toutes les requêtes au service uBlockDNS via une connexion DNS-over-HTTPS chiffrée. 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 les listes de filtres ou les 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.

Compiler à partir des sources

Nécessite Go 1.25 ou version ultérieure.

go build -o ublockdns .
sudo ./ublockdns install -profile <profile-id>

Retours et problèmes

Vous avez trouvé un bug ou avez une suggestion ? Ouvrez un problème.

Pour les problèmes de blocage (publicités qui passent ou un site bloqué à tort), vérifiez d'abord quelles listes de filtres sont activées dans votre tableau de bord. uBlockDNS utilise des listes maintenues par la communauté et ne contrôle pas leur contenu.

Sécurité

Signalez les vulnérabilités de sécurité en privé via les Advisories de sécurité GitHub. N'ouvrez pas de problèmes publics 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.

Licence

MIT

Lire plus

ublockdnsclient v0.3.1

Catégories