v2rayN デスクトップ版と WPF 版の違い：インストールパッケージの選び方

結論から：プロトコル機能はほぼ同じ、UI技術が異なる

v2rayNのデスクトップ版は通常、Avaloniaで構築されたクロスプラットフォームのGUIを指し、WPF版はWindows Presentation Foundationを採用しています。どちらもv2rayNであり、サブスクリプション、ノード、システムプロキシ、ルーティングルール、コアプロセスを管理します。インストールパッケージ名にあるDesktop、Avalonia、WPFはUIの実装を示すもので、VMess、VLESS、Trojanなどのノード形式が別のルールに変わるわけではありません。

プロキシ接続を実際に処理するのは選択したコアです。両方が同じコア、同じノードパラメータ、同じルーティング設定を使っていれば、接続結果は通常一致します。一方だけ接続できない場合は、UIのバージョンだけで互換性を判断せず、まずコアのバージョン、設定内容、待受ポート、システムプロキシの状態を比較してください。

対応OSとUIの違い：2択になるのはWindowsだけ

macOSとLinuxにはWPFという選択肢がないため、対応するシステムアーキテクチャのAvaloniaデスクトップ版を直接ダウンロードします。デスクトップ版とWPF版を同時に比較するのはWindowsユーザーだけです。Windows 10またはWindows 11では通常どちらも候補になります。次にx64やarm64などのCPUアーキテクチャを確認し、パッケージにランタイムが含まれているかを判断してください。

Avalonia版はクロスプラットフォームでの一貫性を重視しており、異なるデスクトップOSでも同じ機能のメニュー位置が近くなっています。WPF版は従来のWindowsウィンドウ動作に近く、リストコントロール、右クリックメニュー、トレイメニュー、テーマの描画などがデスクトップ版と少し異なる場合があります。違いは主に操作手順と視覚的なフィードバックに関するもので、同じサブスクリプションが別形式に変換されるわけではありません。

UI上の位置が違うときに機能を探す方法

別バージョンのボタン位置をそのまま当てはめないでください。サブスクリプション管理、サーバー一覧、システムプロキシ、ルーティング設定、コアログなど、機能名を手がかりに探します。よく使う項目は通常「設定」→「パラメータ設定」から開けます。バージョンによって表示名が少し異なる場合は、設定画面でローカル待受ポート、起動動作、更新オプションを検索してください。

• サブスクリプションのインポート：サブスクリプションURLを保存したら、手動で一度更新し、ノード数とグループ名を確認します。
• プロキシの有効化：ノードを選択してコアを起動した後、システムプロキシを有効にします。コアを起動しただけでは、すべてのアプリがプロキシ経由になるわけではありません。
• ルーティングの振り分け：まずデフォルトルールで接続を確認し、その後にドメイン、IP、プロセスのルールを少しずつ追加すると、誤マッチを特定しやすくなります。
• ログの確認：接続に失敗したら、まずコアの起動情報を確認し、ポートの使用状況、設定項目、ノードパラメータを重点的にチェックします。

ランタイムとインストールパッケージ：SelfContainedと依存版の選び方

同じUIラインでも、実行方式が異なるパッケージが用意されている場合があります。SelfContainedと記載されたパッケージには通常、必要な.NETランタイムコンポーネントが含まれているため、ファイルサイズは大きくなりますが、対応する実行環境がインストールされていない端末に適しています。ランタイム依存版はサイズが小さい一方、起動時に一致する.NETランタイムがシステムに必要です。特にWPF版ではWindows Desktop Runtimeに注意し、Avaloniaの依存版でも対象の.NET環境との適合を確認してください。

ダブルクリックしてもウィンドウが表示されない、またはプロセスが一時的に現れて終了する場合は、ノードを何度も変更しないでください。ランタイム不足はGUIの起動段階で発生するため、この時点ではサブスクリプションやプロキシコアはまだ動作していません。まずインストール済みアプリの一覧を確認し、使用中のパッケージの説明に従って実行環境を補完します。判断できない場合は、同じアーキテクチャのSelfContainedパッケージを選ぶのが最も簡単です。

アーキテクチャの選択ミスとランタイム不足では症状が異なる

• アーキテクチャの不一致：プログラムが起動しない、またはシステムから「このアプリは現在のデバイスでは実行できません」と直接表示される場合があります。
• ランタイム不足：起動直後に終了する、.NETのインストールを求められる、イベント記録に実行環境の読み込み失敗が記録される、といった症状がよく見られます。
• ディレクトリ権限不足：UIは開くものの、設定の保存、コアの更新、ログの書き込みに失敗します。フォルダー全体を、現在のアカウントで読み書きできる場所に置いてください。
• ポート競合：UIは正常に開く一方、コアの起動に失敗し、ログに待受アドレスの使用中と明確に表示されます。この問題はAvaloniaとWPFの選択とは直接関係ありません。

更新方法と設定移行：2つのプログラムのディレクトリを直接混在させない

Avalonia版とWPF版は、近い形式のサブスクリプションやノード情報を読み込めますが、UI設定、ウィンドウ状態、一部バージョンで生成されるローカル設定の構造は異なる場合があります。バージョンを切り替えるときは、2つの解凍先を直接上書きしないでください。古いコンポーネントや設定が残り、新版の問題なのか残存ファイルの問題なのか判断しづらくなります。

より安全な手順は、旧ディレクトリを残したまま新しいディレクトリから対象バージョンを起動し、サブスクリプションを再追加するか、クライアントのエクスポート・インポート機能で必要なデータを移行することです。移行後はノード、ルーティング、システムプロキシを項目ごとに確認し、初回起動時にコア、ポート、DNS、振り分けルールを同時に変更しないでください。

1. v2rayNを終了し、トレイアイコンとコアプロセスが終了していることを確認します。
2. 現在の「設定」→「パラメータ設定」にあるローカルポート、システムプロキシモード、起動オプション、更新方法を記録します。
3. サブスクリプションURL、ノードの備考、ルーティングルール、保持したいカスタム設定をバックアップします。
4. 新バージョンを独立したディレクトリに解凍し、現在使えているディレクトリを上書きしません。
5. 初回起動後はサブスクリプションだけをインポートし、動作確認済みのノードを1つ選んで接続テストを行います。
6. コアログが正常であることを確認してからシステムプロキシを有効にし、その後でルーティングの振り分けとカスタムDNS設定を戻します。
7. しばらく継続して使い、更新機能が正常に動作することを確認してから旧ディレクトリを削除します。

自動更新と手動置換の使い分け

現在のバージョンに内蔵の更新機能がある場合は、重要な設定をバックアップしてから使用できます。権限、ディレクトリの場所、ランタイムの変更が影響する場合は、独立したディレクトリに解凍しておくと簡単に元へ戻せます。更新後はシステムプロキシが想定どおりのモードか再確認してください。プログラムが正常に起動しても、システムプロキシが有効になっているとは限りません。

• 更新前に実行中のコアを終了し、ファイルが使用中にならないようにします。
• AvaloniaのファイルをWPFのディレクトリにコピーしたり、その逆に混在させたりしないでください。
• 更新後はサブスクリプショングループの数を確認し、テスト設定を本番設定と取り違えていないことを確認します。
• コアログを開き、待受アドレスが「パラメータ設定」に表示されるポートと一致していることを確認します。
• ターミナルツールでプロキシ環境変数を使用している場合は、ポートが古い値のままになっていないかも確認します。

用途別に選ぶ：よくある4つのケースへの回答

まだ決められない場合は、次の一文に絞れます。初回インストールならAvaloniaデスクトップ版を優先し、Windowsだけを長期的に使い、従来のレイアウトを明確に好むならWPF版を継続します。既存環境が安定しているなら、UIの名称だけを理由に急いで移行する必要はありません。更新前に、解決したい問題を確認してください。

最終確認リスト

• macOSまたはLinux：Avaloniaデスクトップ版を選び、CPUアーキテクチャを確認します。
• Windowsでの初回インストール：Avaloniaデスクトップ版を優先し、依存関係が不明な場合はSelfContainedタイプを選びます。
• Windowsの従来型UIに慣れている：WPF版を選び、Windows Desktop Runtimeの条件を確認します。
• 既存のWPF環境が安定している：そのまま使い続け、クロスプラットフォーム対応やUI移行が必要になった時点で切り替えます。
• 接続問題の調査：まずコアログと実際の待受ポートを確認し、インストールパッケージ名だけで判断しないでください。