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 collegato a uBlock Origin o al suo manutentore.
uBlockDNS Client porta il blocco di pubblicità e tracker a livello DNS sull'intero dispositivo. Utilizza liste di filtri mantenute dalla community come EasyList ed EasyPrivacy, applicate a livello DNS, così app, browser e servizi in background sono coperti senza estensioni per browser.
Sito web: ublockdns.com
uBlockDNS Client è pensato per ambienti desktop e server dove desideri un unico punto di installazione, protezione a livello di sistema e configurazione remota tramite la dashboard di uBlockDNS.
Crea un account gratuito su ublockdns.com, poi segui la guida di configurazione nella tua dashboard. La guida copre tutte le piattaforme supportate con comandi copia-e-incolla e istruzioni passo passo.
Installazione rapida per macOS e Linux:
curl -sSfL https://ublockdns.com/install.sh | sh -s -- <profile-id>
Usa -L così curl segue i reindirizzamenti Cloudflare sullo script di installazione ospitato.
Durante l'installazione, potrebbe esserti richiesta la password di amministratore di 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
La dashboard utilizza questo flusso di bootstrap. Scarica il programma di installazione da /install-script, evitando così i problemi di reindirizzamento Cloudflare che possono interrompere i download diretti di /install.ps1.
Gli installer e i binari Windows pubblicati 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>
È disponibile anche un installer GUI Windows (.exe) nella pagina delle release.
Il servizio si aggiorna automaticamente ogni giorno; le release vengono verificate rispetto alla chiave di firma uBlockDNS prima di essere applicate. Imposta UBLOCKDNS_NO_AUTOUPDATE=1 nell'ambiente del servizio per disattivare l'aggiornamento automatico, 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 da solo lì; usa sudo ublockdns upgrade. Il client registra nel log in quale modalità si trova all'avvio.
Versioni precedenti senza il comando upgrade: esegui nuovamente il comando di installazione una volta e gli aggiornamenti automatici prenderanno il sopravvento.
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 semplice stringa 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 desideri più. Esegui ublockdns status successivamente per confermare che il DNS di sistema non punti più a 127.0.0.1.
La guida di configurazione della 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> Installa come servizio di sistema
ublockdns uninstall Rimuovi il servizio e ripristina il DNS
ublockdns start Avvia il servizio
ublockdns stop Arresta il servizio
ublockdns status Mostra lo stato del servizio e i dettagli di prontezza
ublockdns status -json Mostra stato leggibile dalla macchina con ready_code e probe_error
ublockdns wait-ready -timeout 45s Attendi finché servizio e DNS non sono attivi
ublockdns wait-ready -timeout 45s -json Emetti stato di prontezza leggibile dalla macchina per l'automazione
ublockdns upgrade Aggiorna all'ultima release e riavvia il servizio
ublockdns version Stampa la versione
Gestisci le tue liste di filtri, regole personalizzate e registro query dalla dashboard. La CLI è volutamente limitata: installa il servizio locale, verifica che sia sano e lascia che la dashboard gestisca le modifiche alle policy.
Il client esegue un proxy DNS locale su 127.0.0.1:53 e, quando IPv6 è disponibile, su [::1]:53. Inoltra tutte le query al servizio uBlockDNS tramite DNS-over-HTTPS crittografato. 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 nella dashboard, il client riceve queste modifiche in tempo reale e svuota automaticamente la cache DNS locale, così le nuove decisioni prendono effetto rapidamente.
Richiede Go 1.25 o successivo.
go build -o ublockdns .
sudo ./ublockdns install -profile <profile-id>
Hai trovato un bug o hai un suggerimento? Apri un problema.
Per problemi di blocco (pubblicità che passano o un sito bloccato erroneamente), controlla prima quali liste di filtri hai abilitato nella tua dashboard. uBlockDNS utilizza liste mantenute dalla community e non controlla i loro contenuti.
Segnala vulnerabilità di sicurezza privatamente tramite GitHub Security Advisories. Non aprire problemi pubblici per questioni di sicurezza.
Per dettagli sul modello di fiducia, trasparenza dello sviluppo e stato attuale dell'audit, consulta SECURITY.md.
MIT