初めてインストールする場合は、OSとCPUアーキテクチャに合ったAvaloniaデスクトップ版を選ぶとよいでしょう。WindowsでWPF版を問題なく使えているなら、画面が変わるだけの理由で移行する必要はありません。この記事では、画面フレームワーク、プロキシコア、通信をシステムに適用する方法を切り分け、各版の対応範囲や依存関係の確認方法、既存設定を残して比較テストする手順を解説します。
1. AvaloniaとWPFで変わるのはどの部分？
Avaloniaはクロスプラットフォーム対応の.NET UIフレームワークです。WPFはWindows Presentation Foundationの略で、Windows向けのデスクトップUIフレームワークです。v2rayNでは、どちらもウィンドウやリスト、メニュー、操作方法の実装を指します。プロキシプロトコルやサーバーのプランが異なるわけではありません。
v2rayNはサーバー設定やサブスクリプション、ルーティング、コアのプロセスを管理します。プロトコル接続を処理するのは、選択したコアです。VMessやVLESSなどのプロトコルが使えるかどうかは、ノード設定とコア、そのバージョンの互換性によって決まります。「Avaloniaだからノードが速い」「WPFだから古いプロトコルしか使えない」とは限りません。
| 要素 | 役割 | 確認場所・項目 |
|---|---|---|
| UIフレームワーク | ウィンドウ、フォント、メニュー、リストの操作 | ダウンロードページのデスクトップ版またはクラシックWPF版 |
| プロキシコア | プロトコルのハンドシェイク、通信、ルーティングルールの適用 | クライアントのコア選択、起動ログ、コアのバージョン |
| ノード設定 | サーバーアドレス、ポート、認証、通信パラメーター | サーバー編集画面とサブスクリプションのインポート結果 |
| 通信の振り分け | アプリの通信をローカルプロキシに送る | システムプロキシ、アプリ内プロキシ、TUNの設定 |
たとえば、ブラウザーからローカルHTTPプロキシ経由でWebページを開けるかどうかは、コアが起動しているかだけでなく、ブラウザーに正しいポートが設定されているかにも左右されます。画面のデザインが変わっても、ポートの入力ミスは解消されません。問題を切り分けるときは、画面版を何度も変えるより、まず原因がどの要素にあるかを確認しましょう。
2. OSと使い方に合わせて版を選ぶ
ダウンロードする版は「OS → CPUアーキテクチャ → UI版」の順に選びましょう。Windowsでは2種類のUIから選べます。macOSやLinuxでは各OSに対応したAvaloniaデスクトップ版を使用してください。Windows用のWPF版をコピーしても動作しません。
Avaloniaデスクトップ版
おすすめ初めて使う場合の選択肢としておすすめです。Windows、macOS、Linuxから使用するOSに合ったパッケージを選べます。各デスクトップOSで似た手順で設定を管理できます。利用可能なアーキテクチャはダウンロードページで確認してください。
おすすめのユーザー：初めてインストールする方、複数のOSで使う方、操作方法を統一したい方。
クラシックWPF版
Windows向けです。ノード一覧やタスクトレイのメニュー、設定画面に慣れていて、現在問題なく使えている場合は、そのまま使い続けられます。macOSやLinuxで使うための互換版ではありません。
おすすめのユーザー：Windowsで安定した設定環境があり、これまでの操作方法を維持したい方。
CPUアーキテクチャも忘れずに確認しましょう。Windowsでは「設定」→「システム」→「バージョン情報」の「システムの種類」で確認できます。macOSではAppleメニューの「このMacについて」、Linuxでは以下のコマンドで確認できます。出力がx86_64なら通常はx64、aarch64なら通常はARM64に対応します。アーキテクチャを間違えた場合は、サブスクリプションではなくインストールパッケージを選び直してください。
uname -m結論：まずOSに合った版を選び、その後でUIを比較
macOSとLinuxでは、OSに対応したAvaloniaパッケージを選びます。Windowsで初めて使う場合はデスクトップ版がおすすめです。WPF版を問題なく使えている場合は、元の環境を残し、別のフォルダーで試してから移行を判断しましょう。
3. UIの違いとシステム要件を確認する
メニューの構成やダイアログのレイアウト、フォントの表示、タスクトレイの操作は、2つの版で異なる場合があります。使い慣れたチュートリアルの画面と違っていても、同じ機能がないとは限りません。設定を探すときは、ボタンの色やウィンドウ内の位置ではなく、サブスクリプショングループ、システムプロキシ、ローカルの待ち受けポート、ルーティングなどの機能名を手がかりにしてください。
インストール前の確認：Windowsとクロスプラットフォーム環境
Windows：配布パッケージの依存関係を確認
- インストーラーと展開して使うパッケージを区別し、圧縮ファイルはすべて展開してください。実行ファイルだけをコピーしてはいけません。
- .NETが見つからないというメッセージが出たら、ランタイム名、メジャーバージョン、アーキテクチャを記録します。
- WPFアプリでは、対応する.NET Desktop Runtimeが必要になる場合があります。通常のランタイムや開発ツールで代用できるとは限りません。
- パッケージにランタイムが含まれている場合、別の版で依存関係が必要だからといって、無関係なランタイムを重ねてインストールする必要はありません。
macOS・Linux：システム連携の条件を確認
- パッケージとCPUアーキテクチャが一致していることを確認し、配布パッケージの説明に従って起動してください。
- macOSで初回起動時にブロックされた場合は、まずファイルの入手元を確認し、「システム設定」→「プライバシーとセキュリティ」を確認してください。
- Linuxでは、ディストリビューションのGUI関連ライブラリ、デスクトップ環境、トレイ対応を確認してください。ウィンドウの起動とトレイアイコンの表示は別の機能です。
- システムプロキシとTUNでは必要な権限が異なります。アプリの起動条件と、通信をシステムに適用するための権限を混同しないでください。
結論：必要な依存関係は、使用中のパッケージの説明と具体的なエラーメッセージで判断します。「Avalonia」か「WPF」かだけでは特定できません。
メイン画面は開くのに、コアの起動直後にエラーが出る場合は、ログで実行ファイルのパスやアクセス権、ポートの使用状況を確認しましょう。反対に、ダブルクリックしてもウィンドウが表示されない場合は、パッケージが正しく展開されているか、ランタイムが合っているかを先に確認してください。原因によって確認箇所は異なります。サブスクリプションを再インポートしても、UIが起動しない問題は解決しません。
4. 設定を残して移行する手順
どちらの版もサブスクリプションを管理できますが、すべてのバージョンで設定フォルダーをそのまま上書きできるわけではありません。クライアントの設定には、データベースの構造やコアのパス、OS固有の項目が含まれることがあります。新しい版で保存したデータを、古い版でそのまま読み込めるとは限りません。安全に移行するには、まず設定全体をバックアップし、共通の情報を移してから、通信をシステムに適用する設定を確認してください。
- 現在の環境を記録する。クライアントとコアの名称・バージョンを控え、使用中のサーバー、ルーティングモード、待ち受けアドレス、ポートを記録します。サブスクリプションのURLは機密情報です。バックアップを公開のスクリーンショットや共有ドキュメントに含めないでください。
- 先にバックアップを取り、その後で試す。旧クライアントを終了し、トレイのプロセスも終了したことを確認してから、実際に使用している設定フォルダーをバックアップします。新しいパッケージは別のフォルダーに置き、旧版のファイルを上書きしないでください。
- 共通の設定から取り込む。新しい版の「サブスクリプショングループ」→「サブスクリプショングループの設定」でグループとURLを確認し、サブスクリプションを更新します。メニュー名はバージョンによって異なる場合があります。手動で追加したノードは、クライアントのエクスポート・インポート機能を使うと、認証パラメーターを一つずつ入力し直さずに済みます。
- ポートとルーティングを確認する。「設定」→「パラメーター設定」でローカルの待ち受けに関する項目を確認し、ルーティング、DNS、使用するコアも再確認してください。新規インストールですべての設定が旧版から引き継がれるとは限りません。
- 通信を制御するクライアントは1つだけ起動する。まずアプリ内プロキシでローカルの待ち受けを確認します。次にトレイの「システムプロキシ」メニューから「システムプロキシを自動設定」を選びます。テスト後は使わない版を終了し、2つのプロセスが交互にシステム設定を書き換えないようにしてください。
切り替え後は、同じ宛先でプロキシの経路を確認しましょう。たとえば、https://example.comにテストリクエストを送り、クライアントのログに該当するリクエストが表示されるか、ルーティングが想定どおりかを確認します。ページを1つ開けても、その通信が成功したと分かるだけです。すべてのアプリがシステムプロキシやTUNを経由しているとは限りません。
5. 速度・メモリ・機能を公平に比較する
「AvaloniaとWPFはどちらが速いか」には、少なくとも画面操作の快適さとプロキシ接続の安定性という2つの観点があります。前者は画面の描画やリストの規模、デスクトップ環境に左右されます。後者は主にノードの回線、コアの設定、DNS、ルーティング、ネットワーク状況によって決まります。一度ページを読み込んだ結果だけで、UIフレームワークの優劣は判断できません。
- ネットワーク条件をそろえる：同じPCとネットワークで、同じノード、通信設定、コアのバージョン、ルーティングルールを使います。回線の違いをバージョン差と取り違えないようにしてください。
- UIとネットワークを分けて記録する：UIのテストでは、起動から操作可能になるまでの時間や、ノードの絞り込み中に動作が重くならないかを記録します。ネットワークのテストでは、同じ宛先に接続できるかと関連ログを記録します。
- メモリ使用量はコアも含めて測る：タスク管理ツールでUIのプロセスだけでなく、そこから起動したコアのプロセスも確認してください。メイン画面のプロセスだけを見ると、実際のリソース使用量を見落とすおそれがあります。
- 複数回テストする：各版を同じ条件で3回テストし、最良の結果だけでなく範囲を記録します。これはテスト回数の目安であり、本サイトによる性能測定の結果ではありません。
TUNモードだけ失敗し、アプリ内HTTPプロキシは正常に動作する場合は、UIフレームワークのせいにするのではなく、権限、ルーティング、DNSを優先して確認してください。システムプロキシはその設定に従うアプリに適用されます。一方、TUNは仮想ネットワークインターフェースとルーティングの制御に関わるため、同じスイッチの別名ではありません。
6. バージョン選びでよくある質問
WindowsでWPF版を問題なく使えています。乗り換える必要はありますか？
UIの名前だけを理由に移行する必要はありません。複数のOSで使いたい、またはデスクトップ版の方が作業しやすいなど、実際に必要なことがあるかを確認しましょう。試す場合は、旧版の設定フォルダーをバックアップして旧版を終了し、新版を別のフォルダーから起動してください。直接上書きすると元に戻しにくくなります。
Avalonia版に替えても、これまでのサブスクリプションを使えますか？
サブスクリプションは再登録できる場合が多いものの、インポート結果は形式と使用中のバージョンが対応しているかによって異なります。まず「サブスクリプショングループ」のURLを確認してから更新してください。ノード数や項目が異なる場合は、更新ログとノード編集画面を確認します。インポートの問題を隠すために、古いデータベースをそのまま上書きしないでください。
新版は起動したのに、ブラウザーが接続できないのはなぜですか？
まず、使用するサーバーを選択し、コアが正常に起動していることを確認してから、ローカルの待ち受けポートを確認してください。例として10808を使う場合、アプリ内プロキシのポートとクライアントの待ち受けポートが一致している必要があります。最後に、トレイの「システムプロキシ」が「システムプロキシを自動設定」になっているか確認し、別のプロセスがシステムプロキシを変更していないか確認します。
.NETのエラーが出たら、どれかランタイムをインストールすればよいですか？
エラーメッセージに合わせて、ランタイムの種類、メジャーバージョン、アーキテクチャを選んでください。WPFが必要とするデスクトップランタイムは通常のランタイムとは別のものです。まず現在のパッケージの依存関係に関する説明を確認し、インストール後にクライアントを再起動して、同じエラーが解消したか確かめましょう。
UI版を替えると、VLESSノードの接続エラーは解決しますか？
必ずしも解決するとは限りません。両方の版で、コアのバージョン、サーバーポート、TLS、SNI、通信パラメーターを比較してください。ノードがREALITYを使う場合は、対応する認証パラメーターも確認します。設定が同じで、特定のクライアント実装に原因があると確認できた場合に、版の違いを調査対象に加えましょう。
選び方はシンプルです。OSとアーキテクチャが合い、必要な依存関係がそろっていて、よく使う機能が正常に動作し、既存の設定を安全に残せる版を選びましょう。UI版は操作画面の選択です。接続品質はコア、ノード、PCのネットワーク設定を個別に確認してください。