Windowsで初めて使うならAvalonia版、従来の操作に慣れているならWPF版が選択肢です。macOSとLinuxではAvalonia版を選びます。主な違いはUIフレームワーク、OSへの対応、配布パッケージに必要なランタイムです。プロキシプロトコルの性能差を意味するものではありません。パッケージやランタイム、設定の移行、トラブルの切り分けを順に確認し、画面を変えるためだけにネットワーク設定を一からやり直さないようにしましょう。
1. まずUIとコアの役割を区別する
v2rayNは、サーバー設定やサブスクリプション、ルールを管理し、プロキシコアの起動と制御を行うデスクトップクライアントです。AvaloniaとWPFは、ウィンドウやリスト、ボタン、メニューを描画するUIフレームワークです。VMessやVLESSなどの通信方式を直接定義するものでも、異なるノードの種類でもありません。
ここでいう「デスクトップ版」は、ダウンロードページでWPF版と区別するためのAvalonia版を指します。WPF版もデスクトップアプリです。Avalonia版はクロスプラットフォーム対応が特徴で、WPF版はWindows専用です。「デスクトップ版はフル機能、WPF版は簡易版」という意味ではありません。
- UI：設定項目の場所、リストの配置、フォント表示、ショートカットなど、画面上の操作方法を決めます。
- クライアント設定：選択したサーバーやルーティング、ローカルの待ち受け設定を、コアが使える設定にまとめます。
- プロキシコア：Xrayなどがプロトコル接続とトラフィック処理を担います。実際に利用できる機能は、同梱されるコアのバージョンと設定によって異なります。
同じVLESS設定がどちらのUIでも動作するかを確認するには、画面の見た目ではなく、コア、トランスポート方式、TLS、ルーティングを確認してください。機能の提供時期はリリースごとに異なる場合があります。比較するときはクライアントのバージョンもそろえ、古いWPF版と新しいAvalonia版をそのまま比べないようにしましょう。
2. OSと使い方で選ぶ
Avalonia版（デスクトップ版）
おすすめ新規インストール時の基本の選択肢です。Windows、macOS、Linux向けのパッケージがあり、OSを切り替えても似た操作感で使えます。パッケージはOSとプロセッサに合ったものを選んでください。
おすすめ：初めてインストールする方、複数のデスクトップOSを使う方、操作方法を統一したい方。
WPF版
Windows向けの従来型デスクトップUIです。メニューやリスト、タスクトレイの操作に慣れていて、現在のバージョンが問題なく動作しているなら、そのまま使い続けてもかまいません。UIフレームワークを変えることだけを目的に、バージョンを切り替える必要はありません。
おすすめ：Windowsを長く使っている方、従来の操作方法を重視する方、現在の設定が安定している方。
| 比較項目 | Avalonia版（デスクトップ版） | WPF版 |
|---|---|---|
| 対応OS | 配布パッケージに応じてWindows、macOS、Linuxに対応 | Windows |
| UIの特徴 | OSをまたいで共通性の高いレイアウトと操作性 | 従来型のWindowsデスクトップ操作 |
| 実行時の依存関係 | ランタイムが同梱されているか、OS固有の依存ライブラリがあるかによって異なります | ランタイム同梱の有無によって異なります。フレームワーク依存型パッケージには、対応するWindows Desktop Runtimeが必要です |
| プロトコルと接続 | コアのバージョンと実際の設定によって決まります | コアのバージョンと実際の設定によって決まります |
| 切り替え時の注意点 | データの移行とOSへの適合性を確認 | データの移行とWindows環境を確認 |
選び方：まず対応OSで絞り込む
macOSとLinuxではAvalonia版を選び、Windowsでは操作の好みに応じて比較しましょう。原因が分からない接続トラブルを解決しようとしてUIを何度も切り替えるのは避け、動作している設定を比較用に残してください。
3. パッケージとランタイム：.NETを入れるだけでは解決しない
インストール前にOSとプロセッサのアーキテクチャを確認します。Windowsでは「設定」→「システム」→「バージョン情報」の「システムの種類」を確認します。macOSではAppleメニューの「このMacについて」でチップを確認してください。Linuxではターミナルで uname -m を実行します。出力が x86_64 ならx64、aarch64 ならARM64です。
- まずOSを選ぶ：Windows用パッケージはmacOSやLinuxではそのまま実行できません。通常の.NETランタイムを追加しても、WPF版がクロスプラットフォーム対応になるわけではありません。
- 次にアーキテクチャを選ぶ：Appleシリコン搭載MacではARM64版、Intel Macではx64版を選びます。Linuxではディストリビューションに合ったパッケージ形式も確認してください。DEBとRPMはファイル名だけの違いではありません。
- 最後に依存関係を確認する：自己完結型パッケージには通常、必要な.NETランタイムが同梱されています。フレームワーク依存型パッケージは、対応するランタイムをあらかじめインストールする必要があります。自己完結型かどうかはパッケージの説明で確認し、EXEや圧縮ファイルという拡張子だけで判断しないでください。
- 表示された案内に従って追加する：フレームワーク依存型のWPFアプリには通常、メジャーバージョンとアーキテクチャが合った.NET Desktop Runtimeが必要です。通常の.NET Runtimeだけでは足りない場合があります。Avaloniaでは、OSに応じてグラフィックやフォントなどのネイティブライブラリが必要になることもあります。
Windowsでは、通常は既定のインストール先を使えます。ポータブル版の圧縮ファイルを使う場合は、書き込み可能な専用フォルダーにすべて展開してから、メインプログラムを起動してください。圧縮ソフトのプレビュー画面から起動したり、実行ファイルだけをコピーしたりしないでください。コアなどの依存ファイルが同じフォルダーにある場合があります。
4. 画面・タスクトレイ・TUNの違いを個別に確認
AvaloniaはOSをまたいだ一貫したコントロールの動作を目指し、WPFは従来型のWindows操作に近い設計です。同じ画面倍率でも、行の高さやポップアップメニュー、フォントの見え方が異なることがあります。これはUIの使い心地の違いであり、コアの性能差ではありません。高解像度ディスプレイで文字がぼやける場合は、まずOSの拡大率とアプリのバージョンを確認しましょう。サブスクリプションをすぐに再インポートする必要はありません。
確認方法：UIの動作とネットワークの制御を分けて調べる
画面と日常操作
- サーバー一覧を開き、列幅、検索、右クリックメニューを確認します。
- メインウィンドウを閉じた後、タスクトレイやバックグラウンドでプロセスが動作しているか確認します。
- システムのスリープと復帰後に、ウィンドウやタスクトレイから正常に操作できるか試します。
プロキシとシステム権限
- まずシステムプロキシを使ってブラウザーの接続を確認し、その後TUNを個別にテストします。
- TUNに必要な権限があるか、仮想ネットワークインターフェースとシステムルートが設定されているか確認します。
- システムプロキシとTUNを制御するクライアントは、同時に1つだけ起動してください。
ウィンドウが開いても、確認できるのは起動に成功したことだけです。システムプロキシとTUNが有効かどうかは、それぞれ個別に確認してください。
システムプロキシは、その設定を参照するアプリに主に影響します。TUNは仮想ネットワークインターフェースを通じて、設定に合致するトラフィックを処理します。どちらもAvaloniaやWPFに標準で備わったネットワーク機能ではありません。Windowsの権限確認、macOSのシステム許可、Linuxのルーティングや権限設定はそれぞれ異なるため、別のOSの手順をそのまま流用しないでください。
Linuxでは、デスクトップ環境によってタスクトレイの対応状況が異なります。ウィンドウが消えてトレイアイコンも見当たらない場合は、まずデスクトップ環境のトレイ対応を確認し、次にバックグラウンドプロセスを調べてください。ウィンドウを探すために何度も起動すると、ポートの競合につながることがあります。
5. WPF版からAvalonia版へ移行する際の設定
共有リンクやサブスクリプションURLは、別のUIに再インポートする用途には便利です。ただし、クライアントのデータベース全体をそのまま上書きできるとは限りません。バージョンによってデータ構造や保存先、設定項目が変わる場合があります。旧環境をバックアップし、新環境で必要最小限の設定から作り直すのが安全です。
- バージョンとデータの保存先を記録：旧クライアントのバージョン、使用中のコア、ローカルポート、設定フォルダーを控えます。バックアップやエクスポート機能がある場合は優先して利用してください。作業前にクライアントを終了します。
- 個別設定を別に保存：カスタムルーティング、DNS、サブスクリプショングループ、自動更新、ショートカットを記録します。サーバーのエクスポートに、これらの全体設定が含まれるとは限りません。
- 別の場所にインストール：新しいバージョンは独立した場所に置き、旧プログラムとファイルを混在させないでください。ユーザーデータがシステムフォルダーに保存されるかどうかは、バージョンごとの説明で確認します。
- インポートして更新：「サブスクリプショングループの設定」で既存のサブスクリプションURLを入力し、保存してから更新します。メニューの場所はバージョンによって変わる場合があるため、現在の画面にある同名の項目を使ってください。
- 確認してからルールを戻す：まず動作確認済みの設定を1つ選んで接続テストを行います。その後、カスタムルーティング、DNS、TUNを一つずつ戻してください。複数の変更を重ねると原因を特定しにくくなります。
新しいバージョンでデータ形式が変更されている場合、旧バージョンに戻す前に、その旧バージョンで作成したバックアップを復元してください。旧プログラムから新しいデータを直接読み書きさせないでください。OSをまたいで移行する場合は、ローカルファイルのパスにも注意が必要です。WindowsのパスはLinuxのルールファイルの場所としてそのまま使えないため、外部リソースを選び直してください。
6. 通信速度とポート：環境の変化をUIの差と混同しない
どちらのUIが速いかに、環境を問わない一律の答えはありません。ウィンドウの起動時間やサーバー一覧のスクロールの滑らかさと、プロキシ接続のスループットは別の指標です。同じサブスクリプションでも、選択中のサーバー、コアのバージョン、ルーティング、DNS、TUNの状態が一つでも異なれば、UIフレームワークが通信速度に影響したとは判断できません。
たとえば、旧インスタンスが 127.0.0.1:10808 で待ち受けている状態で、新しいインスタンスも同じアドレスとポートを使おうとすると、アドレス使用中のエラーが発生することがあります。旧インスタンスを終了するか、新しいインスタンスの待ち受け設定を変更し、クライアント側の設定にも反映してください。リモート側の 443 を変更する問題ではありません。ローカルポートとリモートポートの役割は異なります。
- ウィンドウが開かない：ランタイム、OSのアーキテクチャ、起動エラーを確認します。
- ウィンドウは開くがコアが起動しない：コアのファイル、設定の解析結果、ポート競合に関するログを確認します。
- コアは動作するがWebページを開けない：システムプロキシ、対象アプリのプロキシ設定、DNS、ルーティングを確認します。
- TUNだけが動作しない：権限、仮想インターフェース、システムルートを確認します。サブスクリプションを最初から作り直す必要はありません。
切り分けの基本：一度に変更するのは1項目だけ
比較する前にもう一方のインスタンスを終了し、サーバー、コアのバージョン、プロキシモードをそろえます。ウィンドウの使い心地だけが異なるなら、好みに合わせてUIを選びましょう。接続結果が異なる場合は、ログと実際に適用されている設定を比較してください。
7. バージョン選びでよくある質問
WindowsではWPF版からAvalonia版に切り替える必要がありますか？
必ずしも必要ありません。現在のバージョンが安定して動作し、必要な機能を満たしているなら、そのまま使い続けられます。別のUIを試す場合は、データをバックアップして別の場所にインストールし、動作確認済みの同じ設定で試してください。旧フォルダーへの上書きは避けましょう。
同じサブスクリプションを両方のバージョンで使えますか？
通常は同じサブスクリプションURLをそれぞれに追加できます。ただし、読み込める項目はクライアントとコアのバージョンによって異なります。「サブスクリプショングループの設定」でURLを追加して更新してください。項目が見つからない場合は、まず更新ログを確認し、サブスクリプション形式の違いをUIの制限と決めつけないようにしましょう。
macOSやLinuxでWPF版を選べないのはなぜですか？
WPFはWindows向けのデスクトップUI技術です。ダウンロードページでOSに合ったAvalonia版を選び、ARM64またはx64を指定してください。LinuxではDEBやRPMなど、パッケージ形式も合わせる必要があります。Windows用プログラムの拡張子を変えても利用できません。
バージョンを切り替えた後、システムプロキシは有効なのにブラウザーが接続できません。
新しいクライアントのコアが動作していることを確認し、システムプロキシが参照するローカルアドレスとポートを調べてください。旧インスタンスを終了した後もシステムプロキシが旧ポートを指している場合は、現在のクライアントからシステムプロキシを設定し直します。ほかのカスタムルールは、テストが終わってから戻してください。
ウィンドウを閉じた後、旧バージョンが終了したことを確認するには？
まずタスクトレイのメニューから終了し、その後システムのプロセス一覧を確認してください。ウィンドウを閉じても、タスクトレイに最小化されただけの場合があります。旧プロセスが終了したことを確かめてから別のバージョンを起動すると、ポートやシステムプロキシ、TUNの競合を防ぎやすくなります。
選び方はシンプルです。macOSとLinuxではAvalonia版を使い、Windowsに新規インストールするならまずAvalonia版を試します。従来の操作方法を重視する方はWPF版を選びましょう。ダウンロード前にOSとアーキテクチャを確認し、切り替える前にバックアップを取ってください。接続に問題がある場合は、UI、コア、プロキシによる通信制御の順に切り分けます。