DNSnitch

免責事項 これは自分用に作ったもので、必要とする人がいればここに置いてあるだけです。バグを見つけたら遠慮なくIssueを開いてください！

対話型ターミナルDNSファイアウォール

DNSnitchは、ネットワークトラフィックを完全に制御できる、ローカルで動作するプライバシー最優先のDNSサーバーです。パッシブなブロックリストとは異なり、DNSnitchは**「デフォルト拒否」**の哲学で動作します。つまり、未知のドメインはすべてデフォルトでブロックされ、リアルタイムのターミナルダッシュボードで承認するまでアクセスできません。

主な特徴

• リアルタイム傍受: ローカル（ポート5353、設定可能）で実行され、マシンから送信されるすべてのDNSリクエストを捕捉します。
• デフォルト拒否ポリシー: 未知のドメインは即座にNXDOMAINを返し、「保留キュー」に表示されます。
• 4段階の権限システム:
  • PERMANENT: 永久にホワイトリストに登録します。
  • TEMPORARY: 5分間だけ許可します（自動期限切れ、設定可能）。
  • ONCE: 正確に1回のDNSリクエストだけ許可します（キャプティブポータルや一度きりのログインに最適）。
  • BLOCK: ドメインを明示的にブラックリストに登録し、以後問い合わせしないようにします。
• ステージング方式のワークフロー: 変更はワークスペースに「ステージング」され、Apply したときだけ有効になります。
• トラフィック記録: トラフィックを許可しながらモードを切り替え、一意のドメインを履歴リストに記録できます。
• DNSリダイレクト: ドメインを特定のIP（ローカル開発用）や別のドメイン（CNAME）に即座にマッピングできます。
• ライブTUIダッシュボード: Ncursesで構築された、マルチタブ・マウス不要のインターフェースです。
  • Console: コマンド履歴と色付きフィードバック。
  • Monitor: アクティブなルールの4カラムライブビュー。
  • Queue: ブロックされたリクエストの対話型リスト。
  • Logs: 生のDNSクエリのライブスクロール表示。
  • Redirections: 現在適用中のリダイレクトのプレビュー。
  • Records: 記録されたドメイン名リクエストの表示。

---

インターフェース

ダッシュボードはファンクションキーで操作します。

• [F1] CONSOLE: メインのコマンドセンター。ここでコマンドを入力します。履歴はPgUp/PgDnでスクロールできます。
• [F2] MONITOR: ルールのライブ概要。
  • 操作: Left/Right 矢印キーで列（Temp、Once、Perm、Blocked）をハイライトし、Up/Down でその列をスクロールします。
• [F3] QUEUE: ブロックされたドメインの「受信箱」。
  • 表示: > は選択中を示し、* はステージングされた変更を示します。
• [F4] LOGS: エンジンが処理したすべてのリクエストの生のストリーム。
• [F5] REDIRECTS: カスタムA/CNAMEレコードの管理。
• [F6] RECORDS: 「レコードモード」中に捕捉されたドメインを表示します。

---

コマンドリファレンス

DNSnitchはキーボード操作が基本です。以下はConsole [F1] で利用可能なコマンドの完全なリストです。

選択とキューの管理

アクションを適用する前に、対象を選択する必要があります。保留中のリクエストはIDで、手動ドメインは名前で選択できます。

コマンド	使用例	説明
s	s	現在の選択をクリアします。
s <id>	s 1 3 5	キューID（F3で確認可能）で保留中のドメインを選択します。
s <domain>	s google.com	名前で特定のドメインを選択します（キューになくても可）。既存ルールの編集に便利です。複数選択に対応しています。
q, ls	q	キュータブ [F3] に切り替えます。
clear	clear	保留キューをフラッシュします（表示からすべての保留リクエストを削除します）。

アクション（ステージング）

ドメインを選択したら、以下のショートカットでステータスを設定します。

コマンド	使用例	説明
p	p	選択項目を**恒久許可（Permanent Allow）**に設定します。
t	t	選択項目を一時許可（Temporary）（5分間）に設定します。
o	o	選択項目を一度だけ許可（Allow Once）（次のリクエストのみ）に設定します。
b	b	選択項目をブロック（Blocked）（ブラックリスト）に設定します。
rm, del	rm	選択したドメインのルールを削除します（忘れて、最初からやり直します）。

ワークフロー（変更の適用）

変更は適用するまで有効になりません。

コマンド	使用例	説明
cc	cc	設定確認（Check Config）: ステージングされた変更のテキスト要約を表示します。
d, ditch	d	破棄（Discard）: ワークスペースをリセットし、ステージングされた変更をすべて元に戻します。
a	a	適用（Apply）: ワークスペースをライブのファイアウォールデータベースにコミットします。

モードと記録

ファイアウォールのグローバルな動作を変更します。

コマンド	使用例	説明
m dft	m dft	デフォルトモード（Default Mode）: 未知のものをすべてブロックします（標準的なセキュリティ）。
m rec	m rec	レコードモード（Record Mode）: すべてを許可し、一意のドメインを [F6] に記録します。
m rbl	m rbl	レコード＋ブロックリスト（Record + Blocklist）: 既知のブロックを除くすべてを許可し、一意のドメインを記録します。
crec	crec	記録クリア（Clear Records）: [F6] の記録済みドメインのリストを消去します。

リダイレクション

ドメインをカスタムターゲットにマッピングします（ローカルDNSスプーフィング）。

コマンド	使用例	説明
r	r dev.loc 127.0.0.1	dev.loc をローカルIPにリダイレクトします（Aレコード）。
r	r my.net google.com	my.net を google.com にリダイレクトします（CNAME）。
ur	ur dev.loc	リダイレクト解除（Unredirect）: dev.loc のカスタムルールを削除します。

システム

コマンド	使用例	説明
logs	logs	ログタブ [F4] に切り替えます。
help	help	利用可能なすべてのコマンドを一覧表示します。
exit	exit	DNSサーバーをシャットダウンします。

---

使用シナリオ

1. 標準的なワークフロー（サイトのブロック解除）

1. example.com にアクセスしてみます。失敗します。
2. F3（Queue）を押します。1. example.com が表示されます。
3. s 1 と入力します。（行がハイライトされます）。
4. p と入力します。（行に [PERM] と表示されます）。
5. a と入力します。（適用）。
6. ブラウザを更新します。アクセスできます。

2. ルールの変更（誤操作のブロック解除）

1. google.com を誤ってブロックしてしまいました。
2. s google.com と入力します。
3. rm（削除）または p（恒久許可）と入力して、ブロックを上書きします。
4. a と入力します。

3. ローカル開発

1. サイトを構築していて、mysite.local でアクセスしたいとします。
2. F5 を押します。
3. r mysite.local 127.0.0.1 と入力します。
4. システムはそのドメインをlocalhostに解決するようになります。

4. アプリの監査（レコードモード）

1. 新しいアプリをインストールして、動作を壊さずに何に接続するのか確認したいとします。
2. m rec（モード: レコード）と入力します。
3. 5分間アプリを使用します。
4. F6 を押します。
5. リストを確認します。
6. m dft と入力して、セキュアなモードに戻します。