Cliente uBlockDNS

El Cliente uBlockDNS es un proyecto independiente y no está afiliado, respaldado ni relacionado con uBlock Origin o su mantenedor.

El Cliente uBlockDNS ofrece bloqueo de anuncios y rastreadores a nivel de DNS en todo tu dispositivo. Utiliza listas de filtros mantenidas por la comunidad, como EasyList y EasyPrivacy, aplicadas en la capa de DNS, por lo que las aplicaciones, navegadores y servicios en segundo plano quedan cubiertos sin necesidad de extensiones por navegador.

Sitio web: ublockdns.com

El Cliente uBlockDNS está diseñado para entornos de escritorio y servidor donde deseas un único punto de instalación, protección a nivel de sistema y configuración remota a través del panel de uBlockDNS.

Aspectos destacados

Filtrado de DNS a nivel de sistema para navegadores, aplicaciones y tráfico en segundo plano
Conexión cifrada DNS-over-HTTPS ascendente al servicio uBlockDNS
Actualizaciones en tiempo real de filtros y reglas personalizadas desde tu panel
Modelo de servicio local con comprobaciones de estado y comandos de gestión del servicio
Soporte multiplataforma para macOS, Linux, Windows 10+ y FreeBSD

Instalación

Crea una cuenta gratuita en ublockdns.com y luego sigue la guía de configuración en tu panel. La guía cubre todas las plataformas compatibles con comandos para copiar y pegar e instrucciones paso a paso.

Instalación rápida para macOS y Linux:

curl -sSfL https://ublockdns.com/install.sh | sh -s -- <profile-id>

Usa -L para que curl siga las redirecciones de Cloudflare en el script de instalación alojado.

Durante la instalación, es posible que se te solicite la contraseña de administrador de Mac o Linux para actualizar la configuración de DNS del sistema.

Verificar suma de comprobación del script de instalación (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 posterior (PowerShell como Administrador):

irm https://ublockdns.com/install?id=<profile-id> | iex

El panel utiliza este flujo de arranque. Descarga el instalador desde /install-script, lo que evita problemas de redirección de Cloudflare que pueden romper las descargas directas de /install.ps1.

Los instaladores y binarios de Windows publicados requieren Windows 10 o posterior. Windows 7, Windows 8 y Windows 8.1 no son compatibles.

Verificar suma de comprobación del script de instalación (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>

También hay un instalador GUI de Windows (.exe) disponible en la página de versiones.

Actualización

El servicio se actualiza diariamente; las versiones se verifican con la clave de firma de uBlockDNS antes de aplicarse. Establece UBLOCKDNS_NO_AUTOUPDATE=1 en el entorno del servicio para optar por no participar, o actualiza manualmente con sudo ublockdns upgrade.

Las actualizaciones automáticas se aplican en macOS, Windows y Linux. En FreeBSD, rc.d no reinicia un servicio que termina, por lo que el cliente no se actualiza allí; usa sudo ublockdns upgrade. El cliente registra en qué modo se encuentra al inicio.

Versiones antiguas sin el comando upgrade: vuelve a ejecutar el comando de instalación una vez y las actualizaciones automáticas tomarán el control.

Desinstalación

macOS y Linux:

sudo ublockdns uninstall

Windows (PowerShell como Administrador):

& "$env:ProgramFiles\uBlockDNS\ublockdns.exe" uninstall

Se requiere el & inicial. Sin él, PowerShell trata la ruta entre comillas como una cadena simple e informa Unexpected token 'uninstall'.

La desinstalación detiene el servicio y restaura tu configuración DNS anterior. El binario permanece en el disco; elimínalo manualmente si ya no lo deseas. Ejecuta ublockdns status después para confirmar que el DNS del sistema ya no apunta a 127.0.0.1.

Otras plataformas

La guía de configuración del panel también cubre Chrome, Firefox, iOS, Android y enrutadores. Estos usan DNS-over-HTTPS directamente y no requieren este cliente.

Arquitecturas compatibles

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

Uso

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

Gestiona tus listas de filtros, reglas personalizadas y registro de consultas desde el panel. La CLI es intencionalmente limitada: instalar el servicio local, verificar que esté saludable y dejar que el panel maneje los cambios de políticas.

Cómo funciona

El cliente ejecuta un proxy DNS local en 127.0.0.1:53 y reenvía todas las consultas al servicio uBlockDNS a través de DNS-over-HTTPS cifrado. El servicio evalúa cada consulta contra las listas de filtros y reglas personalizadas habilitadas para tu perfil, y luego devuelve la respuesta DNS normal o una respuesta de bloqueo.

Cuando actualizas las listas de filtros o las reglas personalizadas en el panel, el cliente recibe esos cambios en tiempo real y vacía automáticamente la caché DNS local para que las nuevas decisiones surtan efecto rápidamente.

Compilar desde el código fuente

Requiere Go 1.25 o posterior.

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

Comentarios y problemas

¿Encontraste un error o tienes una sugerencia? Abre un issue.

Para problemas de bloqueo (anuncios que pasan o un sitio bloqueado incorrectamente), verifica primero qué listas de filtros tienes habilitadas en tu panel. uBlockDNS utiliza listas mantenidas por la comunidad y no controla su contenido.

Seguridad

Reporta vulnerabilidades de seguridad de forma privada a través de GitHub Security Advisories. No abras issues públicos para problemas de seguridad.

Para obtener detalles sobre el modelo de confianza, transparencia del desarrollo y estado actual de auditoría, consulta SECURITY.md.

Licencia

MIT

ublockdnsclient v0.3.0

Categorías