Client uBlockDNS

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.

Caratteristiche principali

Filtraggio DNS a livello di sistema per browser, app e traffico in background
Connessione crittografata DNS-over-HTTPS verso il servizio uBlockDNS
Aggiornamenti in tempo reale di liste di filtri e regole personalizzate dalla tua dashboard
Modello di servizio locale con controlli di stato e comandi di gestione del servizio
Supporto multipiattaforma per macOS, Linux, Windows 10+ e FreeBSD

Installazione

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.

Aggiornamento

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.

Disinstallazione

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.

Altre piattaforme

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.

Architetture supportate

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

Utilizzo

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.

Come funziona

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.

Compilazione dal sorgente

Richiede Go 1.25 o successivo.

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

Feedback e problemi

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.

Sicurezza

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.

Licenza

MIT

ublockdnsclient v0.3.1

Categorie