ugzv/ublockdnsclientuBlockDNS向けのクロスプラットフォームなシステムDNSクライアントで、デバイス全体での広告とトラッカーブロック、およびリアルタイムフィルター更新を提供します。
uBlockDNS クライアントは独立したプロジェクトであり、uBlock Origin またはそのメンテナーと提携、承認、関連していません。
uBlockDNS クライアントは、デバイス全体に DNS レベルの広告およびトラッカーブロッキングを提供します。EasyList や EasyPrivacy などのコミュニティ管理フィルターリストを DNS レイヤーで適用するため、ブラウザごとの拡張機能なしでアプリ、ブラウザ、バックグラウンドサービスをカバーします。
ウェブサイト: ublockdns.com
uBlockDNS クライアントは、1 つのインストールポイントでシステム全体の保護と uBlockDNS ダッシュボードによるリモート設定を希望するデスクトップおよびサーバー環境を対象としています。
ublockdns.com で無料アカウントを作成し、ダッシュボードのセットアップガイドに従ってください。ガイドでは、すべてのサポートプラットフォームについてコピペ可能なコマンドと手順が提供されます。
macOS および Linux のクイックインストール:
curl -sSfL https://ublockdns.com/install.sh | sh -s -- <profile-id>
ホストされているインストールスクリプトで curl が Cloudflare のリダイレクトを追従するように -L を使用します。
インストール中に、システム DNS 設定を更新するために Mac または Linux の管理者パスワードを求められる場合があります。
インストーラースクリプトのチェックサムを確認 (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 からインストーラーをダウンロードすることで、直接の /install.ps1 ダウンロードを中断させる可能性がある Cloudflare リダイレクト問題を回避します。
公開されている 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 GUI インストーラー (.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 は意図的に狭く設計されています。ローカルサービスをインストールし、正常であることを確認し、ポリシーの変更はダッシュボードに任せます。
クライアントは 127.0.0.1:53 でローカル DNS プロキシを実行し、すべてのクエリを暗号化された DNS-over-HTTPS を介して uBlockDNS サービスに転送します。サービスは各クエリをプロファイルで有効になっているフィルターリストとカスタムルールに対して評価し、通常の DNS 応答またはブロック応答を返します。
ダッシュボードでフィルターリストやカスタムルールを更新すると、クライアントはそれらの変更をリアルタイムで受信し、ローカル DNS キャッシュを自動的にフラッシュするため、新しい決定が迅速に反映されます。
Go 1.25 以降が必要です。
go build -o ublockdns .
sudo ./ublockdns install -profile <profile-id>
バグを見つけた場合や提案がある場合は、Issue を開いて ください。
ブロッキングの問題（広告が通過する、またはサイトが誤ってブロックされる）については、まず ダッシュボード で有効にしているフィルターリストを確認してください。uBlockDNS はコミュニティ管理のリストを使用しており、その内容を制御することはできません。
セキュリティの脆弱性は、GitHub Security Advisories を通じて非公開で報告してください。セキュリティ問題について公開 Issue を開かないでください。
信頼モデルの詳細、開発の透明性、現在の監査状況については、SECURITY.md を参照してください。
MIT