Cliente uBlockDNS

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

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

Sitio web: ublockdns.com

El Cliente uBlockDNS está pensado para entornos de escritorio y servidores donde quieras un único punto de instalación, protección en todo el sistema y configuración remota a través del panel de uBlockDNS.

Características destacadas

Filtrado DNS en todo el 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 listas de filtros y reglas personalizadas desde tu panel
Modelo de servicio local con comprobaciones de estado y comandos de gestión del servicio
Compatibilidad multiplataforma con 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 de 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 DNS del sistema.

Verifica la 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 los problemas de redirección de Cloudflare que pueden romper las descargas directas de /install.ps1.

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

Verifica la 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 disponible un instalador gráfico para Windows (.exe) en la página de versiones.

Actualización

El servicio se actualiza a sí mismo diariamente; las versiones se verifican contra 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 finaliza, por lo que el cliente no se actualiza allí; usa sudo ublockdns upgrade. El cliente registra en qué modo se encuentra al iniciarse.

Versiones anteriores sin el comando upgrade: vuelve a ejecutar el comando de instalación una vez y las actualizaciones automáticas se harán cargo.

Desinstalación

macOS y Linux:

sudo ublockdns uninstall

Windows (PowerShell como Administrador):

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

El & inicial es obligatorio. Sin él, PowerShell trata la ruta entre comillas como una cadena simple y muestra 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 quieres. 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 routers. Estas 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>   Instalar como servicio del sistema
ublockdns uninstall                          Eliminar el servicio y restaurar el DNS
ublockdns start                              Iniciar el servicio
ublockdns stop                               Detener el servicio
ublockdns status                             Mostrar el estado del servicio y los detalles de preparación
ublockdns status -json                       Mostrar estado legible por máquina con ready_code y probe_error
ublockdns wait-ready -timeout 45s            Esperar hasta que el servicio y el DNS estén activos
ublockdns wait-ready -timeout 45s -json      Emitir estado de preparación legible por máquina para automatización
ublockdns upgrade                            Actualizar a la última versión y reiniciar el servicio
ublockdns version                            Imprimir la versión

Gestiona tus listas de filtros, reglas personalizadas y registro de consultas desde el panel. La CLI es intencionalmente limitada: instala el servicio local, verifica que esté en buen estado y deja 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, cuando IPv6 está disponible, en [::1]:53. 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 listas de filtros o 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 problema.

Para problemas de bloqueo (anuncios que se cuelan 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 problemas públicos para problemas de seguridad.

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

Licencia

MIT

ublockdnsclient v0.3.1

Categorías