ugzv/ublockdnsclientClient DNS di sistema cross-platform per uBlockDNS con blocco di annunci e tracker su tutto il dispositivo e aggiornamenti in tempo reale dei filtri.
uBlockDNS Client è un progetto indipendente e non è affiliato, approvato o correlato a uBlock Origin o al suo manutentore.
uBlockDNS Client porta il blocco di annunci e tracker a livello DNS su tutto il dispositivo. Utilizza liste di filtri mantenute dalla comunità come EasyList ed EasyPrivacy, applicate a livello DNS, in modo che app, browser e servizi in background siano coperti senza estensioni per browser.
Sito web: ublockdns.com
uBlockDNS Client è pensato per ambienti desktop e server in cui si desidera un unico punto di installazione, protezione a livello di sistema e configurazione remota tramite il dashboard uBlockDNS.
Crea un account gratuito su ublockdns.com, poi segui la guida alla configurazione nel tuo dashboard. La guida copre tutte le piattaforme supportate con comandi da copiare e incollare e istruzioni passo-passo.
Installazione rapida per macOS e Linux:
curl -sSfL https://ublockdns.com/install.sh | sh -s -- <profile-id>
Usa -L in modo che curl segua i reindirizzamenti Cloudflare sul script di installazione ospitato.
Durante l'installazione, potrebbe essere richiesta la password di amministratore del Mac o Linux per aggiornare le impostazioni DNS di sistema.
Verifica il checksum dello script di installazione (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 o successivo (PowerShell come amministratore):
irm https://ublockdns.com/install?id=<profile-id> | iex
Il dashboard utilizza questo flusso bootstrap. Scarica l'installer da /install-script, che evita i problemi di reindirizzamento di Cloudflare che possono interrompere i download diretti di /install.ps1.
Gli installer e i binari pubblicati per Windows richiedono Windows 10 o successivo. Windows 7, Windows 8 e Windows 8.1 non sono supportati.
Verifica il checksum dello script di installazione (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 installer GUI per Windows (.exe) è disponibile anche nella pagina delle release.
Il servizio si aggiorna automaticamente ogni giorno; le release vengono verificate con la chiave di firma uBlockDNS prima di essere applicate. Imposta UBLOCKDNS_NO_AUTOUPDATE=1 nell'ambiente del servizio per rinunciare, oppure aggiorna manualmente con sudo ublockdns upgrade.
Gli aggiornamenti automatici si applicano su macOS, Windows e Linux. Su FreeBSD, rc.d non riavvia un servizio che termina, quindi il client non si aggiorna automaticamente lì; usa sudo ublockdns upgrade. Il client registra nel log la modalità in cui si trova all'avvio.
Versioni precedenti senza il comando upgrade: esegui di nuovo il comando di installazione una volta e gli aggiornamenti automatici subentreranno.
macOS e Linux:
sudo ublockdns uninstall
Windows (PowerShell come amministratore):
& "$env:ProgramFiles\uBlockDNS\ublockdns.exe" uninstall
Il & iniziale è obbligatorio. Senza di esso PowerShell tratta il percorso tra virgolette come una stringa semplice e segnala Unexpected token 'uninstall'.
La disinstallazione arresta il servizio e ripristina le impostazioni DNS precedenti. Il binario rimane sul disco; eliminalo manualmente se non lo vuoi più. Esegui ublockdns status dopo per confermare che il DNS di sistema non punti più a 127.0.0.1.
La guida alla configurazione del dashboard copre anche Chrome, Firefox, iOS, Android e router. Questi usano DNS-over-HTTPS direttamente e non richiedono questo 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
Gestisci le tue liste di filtri, regole personalizzate e il log delle query dal dashboard. La CLI è volutamente limitata: installa il servizio locale, verifica che sia funzionante e lascia che il dashboard gestisca le modifiche alle policy.
Il client esegue un proxy DNS locale su 127.0.0.1:53 e inoltra tutte le query al servizio uBlockDNS tramite DNS-over-HTTPS cifrato. Il servizio valuta ogni query rispetto alle liste di filtri e alle regole personalizzate abilitate per il tuo profilo, quindi restituisce la risposta DNS normale o una risposta di blocco.
Quando aggiorni le liste di filtri o le regole personalizzate nel dashboard, il client riceve queste modifiche in tempo reale e svuota automaticamente la cache DNS locale in modo che le nuove decisioni vengano applicate rapidamente.
Richiede Go 1.25 o successivo.
go build -o ublockdns .
sudo ./ublockdns install -profile <profile-id>
Trovato un bug o hai un suggerimento? Apri un problema.
Per problemi di blocco (annunci che passano o un sito erroneamente bloccato), controlla prima quali liste di filtri hai abilitato nel tuo dashboard. uBlockDNS utilizza liste mantenute dalla comunità e non controlla i loro contenuti.
Segnala le vulnerabilità di sicurezza privatamente tramite GitHub Security Advisories. Non aprire problemi pubblici per problemi di sicurezza.
Per dettagli sul modello di fiducia, trasparenza dello sviluppo e stato attuale dell'audit, vedi SECURITY.md.
MIT