TUNモード：AIツールにシームレスなネットワーク支援を提供する技術進化 | TongBao VPN

一、背景：AI開発ツールのネットワーク課題

AIコーディングアシスタント（Claude Code、GitHub Copilot、Cursorなど）、AI対話ツール（ChatGPT、Claude）、そしてパッケージマネージャー（npm、pip、cargo）が開発者のコアワークフローに不可欠となる中、長年見過ごされてきた問題が顕在化しています：システムプロキシモードではすべてのアプリケーションのネットワークトラフィックをカバーできないという課題です。

従来のシステムプロキシ（System Proxy）モードでは：

シナリオ	自動的にプロキシ経由？
ブラウザでChatGPTにアクセス	はい
VS Code内蔵ブラウザ	はい
ターミナルで npm install を実行	いいえ、手動で HTTP_PROXY の設定が必要
Claude Code CLI	いいえ、手動で環境変数の設定が必要
IDE内蔵AI補完	不明、アプリの実装に依存
pip install / cargo build	いいえ

開発者は HTTP_PROXY、HTTPS_PROXY、ALL_PROXY などの環境変数を繰り返し設定し、ツールごとに個別のプロキシパラメータを設定しなければなりません。これは煩雑なだけでなく、ミスも起きやすく——ある1つのターミナルウィンドウで設定を忘れるだけで、接続タイムアウトや依存パッケージのインストール失敗につながります。

二、TUNモードのコアメリット

TUN（Tunnel）モードはシステム層に仮想ネットワークアダプタを作成し、ネットワークスタックの最下層ですべてのトラフィックを傍受することで、上記の問題を根本的に解決します。

┌─────────────────────────────────────────────┐
│ アプリケーション層（ブラウザ/ターミナル/IDE/AIツール） │
│ ChatGPT Claude Code npm pip Cursor │
└──────────────────┬──────────────────────────┘
│ 全トラフィック
▼
┌──────────────────────────────────────────────┐
│ TUN仮想NIC (198.18.0.1) │
│ tun2socks → SOCKS5プロキシ │
└──────────────────┬───────────────────────────┘
│
▼
┌──────────────────────────────────────────────┐
│ Xrayプロキシコア（スマート/グローバルルーティング） │
└──────────────────────────────────────────────┘

TUNモードを有効にすると、ターミナル、IDE、AIツールは追加設定なしで自動的にプロキシ経由でネットワークにアクセスできます。

「全ネットワークトラフィックを傍受 — ターミナル/IDE/AIツールの追加設定は不要」

三、AI開発ワークフローへの具体的な利便性向上

1. Claude Code / Cursorなど AI CLIツール：ゼロ設定で即利用

以前Claude Codeを使用する際、ユーザーは以下の操作が必要でした：

# 以前：ターミナルを開くたびに設定が必要
export HTTP_PROXY=http://127.0.0.1:7890
export HTTPS_PROXY=http://127.0.0.1:7890
claude  # これでようやく接続可能
​

TUNモードでは：

# 現在：そのまま使用、追加操作は不要
claude  # 自動的にプロキシ経由、即座に接続
​

2. AIモデルAPI呼び出し：開発テストのシームレスな連携

OpenAI、AnthropicなどのAPIを使用してアプリケーションを開発する際、コード内にプロキシ設定をハードコードしたり、実行環境にプロキシ変数を注入したりする必要がなくなります。TUNモードにより、 fetch、axios、httpx などのHTTPクライアントのリクエストはOS層で自動的にルーティングされます。

3. パッケージマネージャーと依存パッケージのダウンロード：タイムアウトとの決別

npm install、pip install、cargo build、go get などのコマンドはTUNモードですべて自動的にプロキシ経由となり、ネットワーク接続不良による依存パッケージのインストール失敗や長時間の待機が解消されます。

4. Git操作：プッシュ＆プルも自在に

git clone、git push、git pull などSSH/HTTPSプロトコルのGit操作もTUNで完全にカバーされ、Git用に個別のプロキシ設定を行う必要はありません。

四、安定性保証メカニズム

TUNモードはシステムネットワークスタックに深く介入するため、適切に処理しないと「ネットワーク切断」を引き起こす可能性があります。以下のメカニズムにより安定性を確保しています：

1. ルーティングループ防止（Anti-Routing Loop）

プロキシサーバーIP → 元のゲートウェイ経由（TUNをバイパス）
直接接続IPリスト  → 元のゲートウェイ経由（TUNをバイパス）
0.0.0.0/1         → TUN経由（その他の全トラフィックをプロキシ）
128.0.0.0/1       → TUN経由
​

プロキシサーバー自体のトラフィックはTUNから除外され、「プロキシが自分自身をプロキシする」無限ループを防止します。

2. Watchdogプロセスガーディアン

特権ヘルパープロセスにはWatchdogメカニズムが内蔵されており、5秒ごとにElectronメインプロセスの生存を確認します。メインプロセスがクラッシュまたは予期せず終了した場合、Watchdogが自動的にクリーンアップを実行します：

• TUNルーティングルールの削除
• 元のDNS設定の復元
• tun2socksプロセスの終了
• システムネットワークの正常状態への復元

アプリケーションがクラッシュしても、ユーザーのインターネット接続が中断されることはありません。

3. DNS漏洩防止

TUNモードはDNSクエリを強制的に 8.8.8.8 と 1.1.1.1 にルーティングし、ローカルISP経由によるDNS解決の汚染や漏洩を防止します。これにより、AIツールが api.openai.com、api.anthropic.com などのドメインを正しく解決できることを保証します。

4. クロスプラットフォーム特権ヘルパーサービス

プラットフォーム	実装方式	IPCチャネル
macOS	特権ヘルパープロセス（launchd）	Unix Socket (/var/run/sulian-helper.sock)
Windows	Windowsサービス（SulianHelper）	Named Pipe (\\.\pipe\sulian-helper)
Linux	pkexec権限昇格	直接プロセス管理

各プラットフォームは独立した特権サービスによりネットワーク操作を実行し、メインプロセス自体は権限昇格を必要としません。最小権限の原則に準拠しています。

5. 優雅なエラーリカバリー

TUNの起動に失敗した場合（Helperが未インストールなど）、システムは以下の処理を行います：

• エラータイプの自動検出（"helper service"、"Access is denied" など）
• Helperインストールガイダンスダイアログの表示
• ワンクリックでの特権サービスインストールへの誘導
• インストール完了後の自動接続リトライ

五、スマートルーティングとグローバルルーティング

TUNモードは2つのルーティング戦略をサポートしています：

• グローバルプロキシ：すべてのトラフィックをプロキシ経由で送信。AIサービスの安定性が最も重要なシナリオに最適
• スマート分流：国内ドメイン/IPは直接接続、海外トラフィックのみプロキシ経由——AIツールのアクセシビリティを確保しつつ、国内サービスの速度に影響を与えません

六、技術実装の詳細

起動フロー

1. Xray設定からプロキシサーバーIPを取得
   ↓
2. ドメインをIPに解決（ルーティングループ防止）
   ↓
3. システムデフォルトゲートウェイとローカルNICを検出
   ↓
4. プラットフォーム特権サービスの初期化
   - macOS: 特権ヘルパープロセス / osascriptフォールバック
   - Windows: Windowsサービス
   - Linux: tun2socks直接プロセス管理
   ↓
5. TUN仮想NICの作成（198.18.0.1）
   ↓
6. 分流ルーティングルールの設定
   - プロキシサーバーIP → 元のゲートウェイ
   - 直接接続IP → 元のゲートウェイ
   - 0.0.0.0/1 + 128.0.0.0/1 → TUN
   ↓
7. DNS設定（8.8.8.8, 1.1.1.1）
   ↓
8. Watchdogプロセスガーディアンの起動
​

主要コンポーネント

コンポーネント	役割
tun2socks	TUN NICのトラフィックをSOCKS5プロキシに転送
wintun.dll	WindowsプラットフォームTUNドライバ（WireGuard由来）
sulian-helper	クロスプラットフォーム特権ヘルパーサービス（Go言語で開発）
Xray	マルチプロトコルおよびスマートルーティング対応のプロキシコア

七、まとめ

比較項目	システムプロキシモード	TUNモード
ブラウザ	自動	自動
ターミナル / CLI	手動設定が必要	自動
AIツール（Claude Codeなど）	手動設定が必要	自動
IDE AI補完	不明	自動
パッケージマネージャー	手動設定が必要	自動
Git SSH/HTTPS	手動設定が必要	自動
クラッシュ後のネットワーク復旧	該当なし	Watchdog自動復旧
DNS漏洩防止	なし	あり

TUNモードの導入は、本質的に「プロキシ設定」という開発者を長年悩ませてきた負担を、アプリケーション層からOS層へと引き下げるものです。AIツールへの依存度が高まる現代の開発ワークフローにおいて、TUNモードは付加価値ではなく、真のインフラストラクチャレベルの改善——開発者がコーディングと創造に集中し、「なぜ接続できないのか」の問題調査に時間を費やさずに済むようにするものです。