ugzv/ublockdnsclientКроссплатформенный системный DNS-клиент для uBlockDNS с блокировкой рекламы и трекеров на уровне всего устройства и обновлением фильтров в реальном времени.
Клиент uBlockDNS — это независимый проект и не связан с uBlock Origin или его сопровождающим, не одобрен им и не имеет к нему отношения.
Клиент uBlockDNS обеспечивает блокировку рекламы и трекеров на уровне DNS для всего вашего устройства. Он использует поддерживаемые сообществом списки фильтров, такие как EasyList и EasyPrivacy, применяемые на уровне DNS, поэтому приложения, браузеры и фоновые службы оказываются под защитой без расширений для каждого браузера.
Веб-сайт: ublockdns.com
Клиент uBlockDNS предназначен для настольных систем и серверов, где нужна одна точка установки, защита на уровне всей системы и удалённая настройка через панель управления uBlockDNS.
Создайте бесплатную учётную запись на ublockdns.com, затем следуйте руководству по настройке в своей панели управления. Руководство охватывает все поддерживаемые платформы и содержит команды для копирования и пошаговые инструкции.
Быстрая установка для macOS и Linux:
curl -sSfL https://ublockdns.com/install.sh | sh -s -- <profile-id>
Используйте -L, чтобы curl следовал за редиректами Cloudflare на размещённом скрипте установки.
Во время установки система может запросить пароль администратора Mac или Linux для обновления системных DNS-настроек.
Проверка контрольной суммы скрипта установки (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 или новее (PowerShell от имени администратора):
irm https://ublockdns.com/install?id=<profile-id> | iex
Панель управления использует этот процесс начальной загрузки. Он скачивает установщик с /install-script, что позволяет избежать проблем с редиректами Cloudflare, которые могут нарушить прямое скачивание /install.ps1.
Опубликованные установщики и бинарные файлы для Windows требуют Windows 10 или новее. Windows 7, Windows 8 и Windows 8.1 не поддерживаются.
Проверка контрольной суммы скрипта установки (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>
На странице релизов также доступен установщик Windows с графическим интерфейсом (.exe).
Служба обновляется ежедневно; перед применением релизы проверяются по ключу подписи uBlockDNS. Чтобы отказаться от автоматического обновления, задайте UBLOCKDNS_NO_AUTOUPDATE=1 в окружении службы, либо обновитесь вручную с помощью sudo ublockdns upgrade.
Автоматические обновления работают на macOS, Windows и Linux. На FreeBSD rc.d не перезапускает завершившую работу службу, поэтому клиент там не обновляется самостоятельно; используйте sudo ublockdns upgrade. Клиент записывает в журнал, в каком режиме он запущен.
Для старых версий без команды upgrade: повторно выполните команду установки один раз, и автоматические обновления вступят в силу.
macOS и Linux:
sudo ublockdns uninstall
Windows (PowerShell от имени администратора):
& "$env:ProgramFiles\uBlockDNS\ublockdns.exe" uninstall
Обязателен ведущий символ &. Без него PowerShell рассматривает путь в кавычках как обычную строку и сообщает Unexpected token 'uninstall'.
Удаление останавливает службу и восстанавливает предыдущие DNS-настройки. Бинарный файл остаётся на диске; удалите его вручную, если он больше не нужен. Затем выполните ublockdns status, чтобы убедиться, что системный DNS больше не указывает на 127.0.0.1.
Руководство по настройке в панели управления также охватывает Chrome, Firefox, iOS, Android и роутеры. Они используют DNS-over-HTTPS напрямую и не требуют этого клиента.
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
Управляйте списками фильтров, собственными правилами и журналом запросов через панель управления. CLI намеренно ограничен: установите локальную службу, проверьте её работоспособность, а остальные изменения политик выполняйте через панель управления.
Клиент запускает локальный DNS-прокси на 127.0.0.1:53 и пересылает все запросы в службу uBlockDNS через зашифрованный DNS-over-HTTPS. Служба проверяет каждый запрос по спискам фильтров и собственным правилам, включённым для вашего профиля, и возвращает либо обычный DNS-ответ, либо ответ о блокировке.
Когда вы обновляете списки фильтров или собственные правила в панели управления, клиент получает эти изменения в реальном времени и автоматически сбрасывает локальный DNS-кэш, чтобы новые решения вступали в силу быстро.
Требуется Go 1.25 или новее.
go build -o ublockdns .
sudo ./ublockdns install -profile <profile-id>
Нашли ошибку или есть предложение? Откройте issue.
При проблемах с блокировкой (реклама проходит или сайт ошибочно заблокирован) сначала проверьте, какие списки фильтров включены в вашей панели управления. uBlockDNS использует списки, поддерживаемые сообществом, и не контролирует их содержимое.
Сообщайте об уязвимостях в системе безопасности конфиденциально через GitHub Security Advisories. Не открывайте публичные issue для проблем безопасности.
Подробнее о модели доверия, прозрачности разработки и текущем статусе аудита см. в SECURITY.md.
MIT