uBlockDNS クライアント

uBlockDNS クライアントは独立したプロジェクトであり、uBlock Origin またはそのメンテナーとは提携、承認、関連していません。

uBlockDNS クライアントは、デバイス全体に DNS レベルの広告・トラッカーブロッキングをもたらします。EasyList や EasyPrivacy などのコミュニティ管理フィルタリストを使用し、DNS レイヤーで適用されるため、ブラウザごとの拡張機能なしでアプリ、ブラウザ、バックグラウンドサービスをカバーします。

ウェブサイト: ublockdns.com

uBlockDNS クライアントは、1つのインストールポイント、システム全体の保護、uBlockDNS ダッシュボードによるリモート設定を実現したいデスクトップおよびサーバー環境を対象としています。

主な特長

ブラウザ、アプリ、バックグラウンドトラフィックに対するシステム全体の DNS フィルタリング
uBlockDNS サービスへの暗号化されたアップストリーム DNS-over-HTTPS 接続
ダッシュボードからのリアルタイムのフィルタリストおよびカスタムルール更新
ステータスチェックとサービス管理コマンドを備えたローカルサービスモデル
macOS、Linux、Windows 10+、FreeBSD のクロスプラットフォーム対応

インストール

ublockdns.com で無料アカウントを作成し、ダッシュボードのセットアップガイドに従ってください。このガイドでは、コピー＆ペースト可能なコマンドとステップバイステップの手順で、サポートされているすべてのプラットフォームを説明しています。

macOS および Linux のクイックインストール:

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

ホスト型インストールスクリプトで 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>   システムサービスとしてインストール
ublockdns uninstall                          サービスを削除し DNS を復元
ublockdns start                              サービスを開始
ublockdns stop                               サービスを停止
ublockdns status                             サービスの状態と準備状況の詳細を表示
ublockdns status -json                       ready_code と probe_error を含む機械可読なステータスを表示
ublockdns wait-ready -timeout 45s            サービスと DNS がアクティブになるまで待機
ublockdns wait-ready -timeout 45s -json      自動化用の機械可読な準備状態を出力
ublockdns upgrade                            最新リリースに更新しサービスを再起動
ublockdns version                            バージョンを表示

フィルタリスト、カスタムルール、クエリログはダッシュボードから管理してください。CLI は意図的に範囲を絞っています: ローカルサービスのインストール、正常性の確認、ポリシー変更はダッシュボードに任せます。

仕組み

クライアントは 127.0.0.1:53 でローカル DNS プロキシを実行し、IPv6 が利用可能な場合は [::1]:53 でも実行します。すべてのクエリを暗号化された DNS-over-HTTPS 経由で uBlockDNS サービスに転送します。サービスは各クエリをプロファイルで有効化されたフィルタリストとカスタムルールに対して評価し、通常の DNS 応答またはブロック応答を返します。

ダッシュボードでフィルタリストやカスタムルールを更新すると、クライアントはそれらの変更をリアルタイムで受け取り、ローカル DNS キャッシュを自動的にフラッシュして、新しい決定がすぐに反映されるようにします。

ソースからのビルド

Go 1.25 以降が必要です。

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

フィードバックと問題

バグを発見した場合や提案がある場合は、問題を開いてください。

ブロッキングの問題（広告が通過する、サイトが誤ってブロックされる）については、まずダッシュボードで有効にしているフィルタリストを確認してください。uBlockDNS はコミュニティ管理リストを使用しており、その内容を管理することはできません。

セキュリティ

セキュリティの脆弱性は、GitHub Security Advisories を通じて非公開で報告してください。セキュリティ問題について公開の issue を開かないでください。

信頼モデルの詳細、開発の透明性、現在の監査状況については、SECURITY.md を参照してください。

ライセンス

MIT

ublockdnsclient v0.3.1

カテゴリ