まずOSに合わせて選び、次に操作性を比べましょう。macOSとLinuxではAvalonia版、WindowsではAvalonia版とWPF版を比較できます。主な違いはUIフレームワーク、デスクトップとの連携、実行環境です。画面の違いをプロトコルや通信速度の差と混同しないようにしましょう。比較表、インストール前の確認事項、移行手順を紹介します。初めてダウンロードする方にも、別バージョンへの移行を検討している方にも役立つ内容です。
UIフレームワークとプロキシコアの役割を分けて考える
AvaloniaとWPFはいずれも、グラフィカルな画面を構築するための技術です。ウィンドウやリスト、メニュー、入力欄などの表示を担います。v2rayNでは、これらのUIを使ってサーバー、サブスクリプションのグループ、ルーティングルール、プロキシ設定を管理します。実際にプロキシ接続を確立するのは、選択したコアです。Avalonia版を選んでも特定のプロトコルに切り替わるわけではなく、WPF版だから特定のコアしか使えないということもありません。
VLESSやVMessのノードに接続できない場合は、ノードの設定値、コアの対応状況、ログを確認してください。画面の見た目だけで判断するのは避けましょう。同じサブスクリプション名が表示されていても、コアのバージョンや選択中のノード、ルーティング設定が異なれば、動作結果も変わります。UIのバージョンを比較する前に、こうした条件をそろえてください。
| レイヤー | 担当する内容 | 確認する場所 |
|---|---|---|
| Avalonia / WPF | ウィンドウ表示、メニュー操作、デスクトップ連携 | UI設定、システムのディスプレイ設定 |
| プロキシコア | プロトコル処理、接続確立、ルール適用 | コアの選択、実行ログ |
| ノードとサブスクリプション | サーバーアドレス、ポート、認証、通信パラメーター | サーバー編集、サブスクリプショングループの設定 |
OSに合わせてAvalonia版とWPF版を選ぶ
Avalonia版はWindows、macOS、Linuxに対応し、WPF版はWindows向けのUIです。ここでいう「クロスプラットフォーム対応」とは、各OS向けのビルドが用意されているという意味で、同じインストーラーが3つのOSでそのまま使えるわけではありません。ダウンロード前に、x64やARM64などのプロセッサーアーキテクチャも確認してください。バージョン名だけで判断しないようにしましょう。
Avalonia版
おすすめ初めて選ぶ際の候補としておすすめです。特に、複数のデスクトップOSで似た操作感を保ちたい方に適しています。OSのバージョン、アーキテクチャ、デスクトップ環境の要件は個別に確認してください。
向いている方：macOSやLinuxのユーザー、複数のOSで操作方法をそろえたいWindowsユーザー。
WPF版
WindowsのUIに慣れた操作方法を維持できます。設定が安定していて、従来のメニューやトレイ操作に慣れている場合は、そのまま使い続けながら新しいUIを個別に試す方法もあります。
向いている方：Windowsのみを使い、これまでのUI操作に慣れている方。
ここでのおすすめは、記事内での選び方の目安です。WPF版のサポートが終了したという意味ではありません。Windowsユーザーも「クロスプラットフォーム対応」という理由だけで急いで移行する必要はありません。現在の環境が安定しているなら、UIの名称にこだわるより、機能と互換性を確認することが大切です。
画面、トレイ、ウィンドウの動作を比較する
どちらのUIも、サーバーリスト、サブスクリプショングループ、ログ、設定を中心に操作します。ただし、メニューの位置、列幅の保存、ショートカット、右クリックメニューなどは、バージョンによって異なる場合があります。初回起動時は、接続中のサーバーの表示、システムプロキシの状態、ログの場所を確認してから、テーマやフォント、リストの列幅を調整しましょう。別バージョンのスクリーンショットを見て、座標だけを頼りにクリックするのは避けてください。
| 確認項目 | Avalonia版 | WPF版 |
|---|---|---|
| ウィンドウと表示倍率 | 使用中のOSで表示倍率、フォント、コントロールのレイアウトを確認 | Windowsの表示倍率とマルチモニター切り替えを確認 |
| トレイアイコン | OSおよびLinuxのデスクトップ環境の対応状況による | Windowsの通知領域と隠れているインジケーターを確認 |
| 閉じるボタン | ウィンドウを閉じてもバックグラウンドで動作し続けるか確認 | ウィンドウを閉じる操作と、トレイメニューから終了する操作を確認 |
| システムプロキシ | 現在のデスクトップセッションに設定が実際に反映されているか確認 | Windowsのプロキシ設定とクライアントの状態を確認 |
ウィンドウを閉じても、アプリが終了するとは限りません。トレイの動作を試すときは、メインウィンドウを閉じた後、トレイから再表示できるか確認してください。アプリを停止する場合は、トレイメニューから終了し、プロキシ設定が元に戻ったことも確認しましょう。ウィンドウが消えても接続が続いている場合は、すぐに別のインスタンスを起動せず、まずバックグラウンドプロセスを確認してください。
- Windows：タスクバーの隠れているインジケーターを開き、トレイアイコンが格納されていないか確認します。別のモニターに移動した後は、表示倍率とウィンドウの位置も確認してください。
- macOS：ウィンドウを閉じる操作とアプリを終了する操作を区別し、メニューバーの項目を確認します。スリープから復帰した後の接続状態もテストしてください。
- Linux：使用中のデスクトップ環境がトレイやステータスインジケーターに対応しているか確認します。トレイアイコンが表示されないだけでは、プロキシコアが起動していないとは限りません。
インストール前に実行環境を確認する
「ダブルクリックしても起動しない」場合は、まずパッケージの種類、アーキテクチャ、実行環境を確認しましょう。ノードを変更するのはその後です。WPF版では、対応するバージョンの.NET Desktop Runtimeが必要になることがあります。Avalonia版の依存関係は、配布パッケージが自己完結型かどうかや、OSに必要なネイティブライブラリによって異なります。自己完結型のパッケージには対応するマネージドランタイムが含まれますが、OSの要件まで不要になるわけではありません。
- OSとアーキテクチャを確認する。Windowsでは「設定」→「システム」→「バージョン情報」でシステムの種類を確認します。macOSでは「このMacについて」でチップを確認し、Linuxではシステム設定の「情報」ページでOSとプロセッサーを確認してください。
- インストーラーの説明を読む。デスクトップ版とWPF版を区別し、自己完結型かどうか、最小システム要件、アーキテクチャを確認してください。他のOS向けのパッケージを展開して、何度も起動を試すのは避けましょう。
- エラーに応じて依存環境を追加する。起動時のダイアログに不足しているフレームワークの名称、バージョン、アーキテクチャが表示された場合は、その情報に合わせてインストールしてください。WPFに必要なデスクトップランタイムと通常の.NET Runtimeは別物です。
- プログラムのフォルダー全体を保持する。ポータブル版は、書き込み可能なフォルダーにすべて展開してください。実行ファイルだけをコピーしてはいけません。コア、リソース、設定ファイルの場所は、使用するバージョンのフォルダー構成の説明を確認してください。
バージョンを切り替える：先にバックアップし、別環境で検証する
WPF版からAvalonia版へ、またはAvalonia版からWPF版へ切り替えるときは、使用中のプログラムフォルダーに上書きしないでください。バージョンによって設定形式やデータの保存先が異なる場合があります。元の環境を残したまま、新しいプログラムを別の場所に配置し、クライアントのバックアップ、復元、インポート機能を使って移行するのが安全です。具体的な操作場所は、使用中のバージョンで確認してください。
移行手順：旧環境を残して新しいUIを個別にテスト
旧環境：切り戻し用に保持
- クライアントのバージョン、コア、接続中のノードを記録する。
- サブスクリプショングループ、ルーティング、自分で変更した設定をバックアップする。
- アプリを終了してから、実際のデータフォルダーをバックアップする。
新環境：項目ごとに検証
- まずサブスクリプションを1つインポートし、ノード数を確認する。
- まずシステムプロキシでテストし、TUNは有効にしない。
- 接続を確認してから、カスタムルーティングを戻す。
2つのプログラムで同時にシステムプロキシを制御したり、同じ待ち受けポートを使ったりしないでください。検証後に、どちらを残すか決めましょう。
たとえば旧環境が127.0.0.1:10808で待ち受けている場合、新環境も同じアドレスとポートを使用すると、起動に失敗することがあります。旧環境を完全に終了してから新環境を起動してください。同時にテストする必要がある場合は、新環境に別のポートを設定し、テストするアプリのプロキシ接続先も変更します。ここでの10808は例であり、すべてのバージョンに共通する固定のデフォルト値ではありません。
- 「設定」→「パラメーター設定」で、ローカルの待ち受けに関する項目を確認してください。項目名や分類はバージョンによって異なる場合があるため、実際の画面を確認しましょう。
- 旧環境と同じノードとコアを選び、システムプロキシが新環境の実際の待ち受けポートを参照していることを確認してください。
- 同じテスト用ウェブページにアクセスし、ポートのバインド、ハンドシェイク、名前解決に関するエラーがログにないか確認します。設定は一度に1項目だけ変更してください。
- サブスクリプションの更新、トレイからの再表示、終了後のプロキシ設定の復元、再起動後の起動動作をテストしてから、残りのグループを移行します。
サブスクリプションで復元できるのは、そこに含まれるノード情報だけです。ローカル設定がすべて自動で元に戻るわけではありません。手動で追加したサーバー、ルーティングルール、DNS設定、ショートカットは個別に確認してください。バックアップにはサブスクリプションURLや認証情報が含まれることがあります。安全な場所に保管し、問い合わせの添付ファイルとして公開しないでください。
よくある質問と最終的な選び方
同じサブスクリプションなのに、バージョンを変えると接続できないのはなぜ？
まず接続中のノードが同じか確認し、コアの種類とバージョン、ルーティング、システムプロキシを照合してください。ログでローカルポートの使用状況も確認します。旧プログラムがバックグラウンドで動作している場合は、先に終了してください。サブスクリプションが同じでも、実行時の設定がすべて同じとは限りません。
Windowsでは、まずどちらをインストールすればよい？
初めて使う場合は、Avalonia版を試す方法があります。慣れたWindowsの操作方法を維持したい場合や、特定のウィンドウ動作が現在の環境でより安定している場合は、WPF版を選べます。インストール後はウィンドウが開くかどうかだけでなく、トレイ、プロキシ、再起動の3点を確認してください。
WPF版に変えれば、VLESSノードの速度は上がる？
そうとは限りません。まずノード、コア、ルーティングをそろえて、近い時間帯に速度を比較してください。リストのスクロールだけが遅い場合は、表示倍率、リストの件数、UI設定を確認します。ウェブページの読み込みが遅い場合は、ネットワークとログを調べましょう。
新しいUIにトレイアイコンが表示されなくても使い続けられる？
まずメインウィンドウを操作できることを確認し、OSがアイコンを隠していないか調べてください。Linuxでは、デスクトップ環境がトレイに対応しているかも確認します。ウィンドウを閉じた後に再表示できるかテストしてください。再表示の方法が確認できるまではウィンドウを開いたままにし、未検証のバックグラウンド動作に頼らないでください。
新旧のバージョンを同じフォルダーに置いてもよい？
移行テストでは別々のフォルダーを使い、両方が同じデータ保存先を参照していないか確認してください。2つのプログラムから同じ設定データに同時に書き込ませないようにしましょう。復元可能な旧環境を残し、新環境が安定してから整理してください。
最終的には、OSで動作するか、必要な機能がそろっているか、デスクトップでの操作が使い方に合うかの3点で選びましょう。macOSとLinuxではAvalonia版から試し、Windowsでは2つのUIを実機で検証して選んでください。接続エラーが起きたら、UI、コア、ノードの問題を切り分けてから、バージョンを変える必要があるか判断しましょう。