v2rayNのAvalonia版とWPF版の違い｜クロスプラットフォーム版とWindows版の選び方

UIフレームワーク・クライアント・プロキシコアの違い

AvaloniaとWPFは、どちらもGUIの構築に使われる技術です。サーバー一覧、サブスクリプショングループ、設定画面、トレイメニューはクライアントのUIにあたります。接続の確立、プロトコル処理、通信の転送は、クライアントが呼び出すプロキシコアが行います。「画面を変えること」と「プロトコルを変えること」を混同すると、トラブル時の確認箇所を誤る原因になります。

WPFはWindows向けのデスクトップUI技術で、v2rayNのWPF版もWindowsで使用します。AvaloniaはクロスプラットフォームのUI技術で、v2rayNはこれを使って複数のOS向けにデスクトップ版を提供しています。クロスプラットフォームとは、同じUI技術で複数のOS向けにビルドできるという意味であり、Windowsの実行ファイルがそのまま全OSで動くということではありません。

• v2rayN：サーバー情報の保存、サブスクリプションの管理、実行用設定の生成を行い、対応するコアを呼び出します。
• Xray、V2Ray：プロキシコアです。利用できるコアや機能は、インストールしたバージョンとパッケージの内容によって異なります。
• VMess、VLESS：プロトコルです。ノードが使えるかどうかは、通信方式、セキュリティ設定、サーバー側のパラメーターにも左右されます。
• Avalonia、WPF：UI技術です。プロトコル名やコア名の代わりにはなりません。

Avalonia版とWPF版の比較

バージョン選びで特に重要なのは、対象OS、機能の場所、実行環境です。次の表は選択時の目安です。どのリリースでも両バージョンの機能が完全に一致するとは限りません。新機能の対応時期や項目名、画面構成はバージョンによって変わる場合があります。

条件をそろえた比較テストがない限り、「特定のUI版は必ずメモリ消費が少ない」「必ず速い」とは言えません。メモリ使用量は、ノード数、ログ表示、コアの動作状況、ウィンドウの表示状態にも左右されます。ダウンロード速度は通常、回線、サーバー負荷、ルーティングルールの適用状況に大きく依存します。

OSと現在の設定に合わせてバージョンを選ぶ

まず動作するパッケージを選び、その後で使いやすいUIを選びましょう。Windowsに新規インストールする場合、ダウンロードページに対応アーキテクチャのAvalonia版があれば、まずそれで設定を始められます。WPF版を安定して使えている場合は、UIフレームワークだけを理由に作業ディレクトリを変更する必要はありません。

1. OSを確認：Windowsでは「設定」→「システム」→「バージョン情報」でシステムの種類を確認できます。macOSでは「このMacについて」でチップ情報を確認してください。
2. アーキテクチャを確認：x64とARM64を区別してください。PCのメーカーだけで判断したり、OSのビット数とプロセッサーのアーキテクチャを混同したりしないようにしましょう。
3. パッケージの説明を確認：対象OS、アーキテクチャ、ランタイムの同梱有無、最低システム要件を確認してください。
4. 必要な機能を確認：TUN、特殊なルーティング、特定のコアが必要な場合は、選んだバージョンに対応する設定項目と実行コンポーネントがあることを確認してください。

実行時の依存関係と初回起動時の確認

「.NETがインストール済み」でも、アプリに必要な実行環境がそろっているとは限りません。ランタイムにはバージョン、アーキテクチャ、種類の違いがあります。WPFアプリにはデスクトップ向けのコンポーネントが必要なため、通常の.NET Runtimeだけでは動作しない場合があります。SDKは開発用であり、初回起動時のトラブルを解決するためにまず導入するものではありません。

Windowsでは、ターミナルで次のコマンドを実行すると、インストール済みの.NETランタイムを確認できます。コマンドを認識できない場合は、パッケージの説明を確認し、システムランタイムが必要か判断してください。このコマンドの結果だけでは、ランタイム同梱パッケージが起動できるかどうかは分かりません。

dotnet --list-runtimes

結果を確認するときは、Microsoft.WindowsDesktop.AppとMicrosoft.NETCore.Appの違いに注意し、エラーメッセージに記載されたバージョン要件と照らし合わせてください。macOSやLinux向けのAvalonia版では、システムのグラフィックライブラリや実行権限が必要な場合もあります。Windowsと同じ方法でランタイムを追加できるとは限りません。ウィンドウが開かない問題と、コアの接続失敗は分けて記録しましょう。後者は通常、クライアントのログを確認する必要があります。

サブスクリプション、システムプロキシ、待ち受けポートの確認手順

どちらのUIでもサーバー一覧を表示できますが、接続環境まで同じとは限りません。「サブスクリプショングループ」→「サブスクリプショングループの設定」、使用中のサーバー、「設定」→「パラメーター設定」、最後に「ルーティング設定」の順に確認してください。ボタンの位置や項目名はバージョンによって異なる場合があるため、実際の画面に合わせて操作します。

ポートは移行時に見落としやすい設定項目です。ここではローカルプロキシの例として127.0.0.1:10808を使い、ポートが競合した場合の候補として10818を示します。これらの値は確認方法を説明するための例であり、すべてのバージョンで同じポートが初期設定されているわけではありません。

• サブスクリプション：「サブスクリプショングループ」→「サブスクリプショングループの設定」を開いてURLを確認し、「すべてのサブスクリプションを更新」を実行します。URLにはアクセス情報が含まれるため、公開するスクリーンショットに写さないでください。
• 待ち受け：「設定」→「パラメーター設定」でローカルの待ち受けに関する項目を探します。バージョンによっては「Core基本設定」にあります。項目が混合ポートか、SOCKSとHTTPの個別ポートかを確認してから、アプリ側のプロキシを設定してください。
• システムプロキシ：Windowsのメイン画面またはトレイにある「システムプロキシ」メニューで状態を確認します。ノードを選択しただけでは、システムプロキシは有効になりません。
• ルーティング：「ルーティング設定」でルールと適用順を確認します。「中国本土をバイパス（Whitelist）」を使っている場合、一部の通信が直接接続されるのはルールの動作によるもので、すぐにプロキシの障害と判断しないでください。
• DNSとTUN：DNSポリシーとTUNの状態は個別に記録してください。TUNには対応するコア、OSのサポート、権限が必要です。UIを切り替えても自動的に引き継がれる共通のスイッチではありません。

WPF版からAvalonia版への移行手順：別ディレクトリで準備

UIを切り替えるとき、旧ディレクトリをそのまま上書きするのは避けましょう。バージョンによってデータ形式、設定項目、移行処理が異なる可能性があります。ディレクトリ全体をコピーすると、旧コアと新しいファイルが混在することもあります。問題が起きてから旧設定を探すより、戻せるバックアップを残して新しい環境を検証するほうが安全です。

1. 旧環境を記録：クライアントのバージョン、使用中のコア、アクティブなサブスクリプショングループ、待ち受けポート、ルーティング名、システムプロキシの状態を書き留めます。独自のDNSやTUN設定があれば、あわせて記録してください。
2. データを保存：現在のバージョンにエクスポートやバックアップ機能があれば利用します。明確な項目がない場合は、プログラムを終了してから設定データのディレクトリをバックアップしてください。バックアップにはノードの認証情報が含まれるため、安全な場所に保管します。
3. 新しいディレクトリを用意：新しいパッケージを専用ディレクトリに完全に展開します。旧ディレクトリを上書きせず、2つのプログラムから同じ設定ファイルを書き換えないようにしてください。
4. まずサブスクリプションを再設定：新しいUIでサブスクリプショングループを追加して更新します。サブスクリプションから取得できるのは通常ノード情報で、ローカルのルーティング、待ち受けポート、DNS、システムプロキシの設定までは自動的に復元されません。
5. 設定を1つずつ復元：まず1つのノードで接続を確認し、次にルーティングとDNSを設定して、最後に必要に応じてTUNを有効にします。設定の種類を変えるたびに確認すれば、失敗箇所を特定しやすくなります。
6. 元に戻す手順を確認：新しいバージョンに問題があれば、まずそのシステムプロキシを無効にしてプログラムを終了し、旧バージョンに戻します。すでに待ち受けを停止したポートをシステムプロキシが参照したままにならないようにしてください。

OSをまたいで移行する場合は、ローカル設定を特に見直してください。Windowsのディレクトリパス、スタートアップ方法、証明書ファイルの場所、権限設定は、そのままmacOSやLinuxには適用できません。サブスクリプションを正常にインポートできても、ノード情報を取得できただけであり、ローカルのプロキシ経路まで設定できたとは限りません。

バージョン選びと切り替えに関するよくある質問