初めてインストールする場合は、まずAvalonia版を選ぶとよいでしょう。WindowsでWPF版を問題なく使えているなら、そのまま使い続けられます。乗り換える際は、ノードを移行してからコア、ルーティング、システムプロキシを確認しましょう。画面をそろえるために、以前の設定をそのまま引き継ぐ必要はありません。
対応OS:Windowsはどちらも選択可能、macOS・Linuxはデスクトップ版
AvaloniaとWPFは、まずUIフレームワークの違いです。ウィンドウやコントロールの表示方法、動作するデスクトップOSが異なります。一方、VMessやVLESSで接続できるかどうかは、使用するコア、ノードのパラメーター、サーバー側の設定によって決まります。インストーラーに記載されたUIフレームワーク名を、コアの名前と混同しないようにしましょう。
初めてのインストールと既存設定
Avaloniaデスクトップ版
おすすめWindows・macOS・Linuxに対応しています。OSをまたいで使う場合も、サブスクリプションやノードの管理方法は活用できますが、トレイメニュー、システムプロキシ、アクセス権限はOSごとに確認が必要です。
おすすめ:初めてインストールする場合、または複数のデスクトップOSでv2rayNを使う場合
WPF版
Windows専用です。現在のバージョンで必要なプロトコルが使え、ルーティングルールも確認済みなら、UIフレームワークを変えるためだけに再設定する必要はありません。
おすすめ:設定済みのWindows環境をそのまま使い続ける場合
インストーラーと動作環境:OS・アーキテクチャ・ランタイムを確認
ダウンロード前に確認するのは、ノードのサーバーではなく、クライアントを実行するPCです。Windowsでは「設定」→「システム」→「バージョン情報」でシステムの種類を確認できます。macOSでは「このMacについて」を開き、AppleシリコンかIntelプロセッサかを確認します。Linuxでは uname -m を実行します。一般に、出力が x86_64 ならx64、aarch64 ならARM64です。
- Windows:このサイトに掲載しているWindows版は、どちらもx64です。アーキテクチャを確認したうえで、デスクトップ版か従来のWPF版を選んでください。
- macOS:Appleシリコン搭載MacにはARM64 DMG、Intelプロセッサ搭載Macにはx64 DMGを選びます。どちらもAvaloniaデスクトップ版で、違いはプロセッサのアーキテクチャです。
- Linux:アーキテクチャに合ったものを選んだうえで、DebianやUbuntuなどでは通常DEB、FedoraなどRPMを使うディストリビューションではRPMを選びます。パッケージ形式が合っていても、ディストリビューションがパッケージに記載された依存関係をすべて満たすとは限りません。
.NETを別途インストールする必要があるかどうかは、Avalonia版かWPF版かではなく、配布パッケージにランタイムが含まれているかで決まります。Windowsの起動時に Microsoft.WindowsDesktop.App が見つからないと表示された場合は、必要なバージョンとアーキテクチャを確認し、該当する.NET Desktop Runtimeをインストールしてください。同じ世代の基本ランタイムだけでは不十分です。メイン画面は開くのにノードの起動時だけエラーが出る場合は、コアのログを確認しましょう。コアの起動失敗を、UIのランタイム不足と取り違えないようにしてください。
機能の違い:コア・ルーティング・通信の入口を個別に確認
乗り換え後に同じノードが表示されても、確認できたのはノードデータが読み込まれたことだけです。実際の動作を比べるには、同じノードを使い、コアの種類を確認してからルーティングと通信の入口を比較します。UI、コア、テスト用ノードを同時に変えると、遅延が変わっても原因を特定できません。
- コアとプロトコル:以前使えていたノードを選び、プロトコル、トランスポート方式、安全性の設定を確認したうえで、ログから実際に起動したコアを確認します。VLESSノードのトランスポートやセキュリティのパラメーターは、サーバー側と一致させる必要があります。Avalonia版に切り替えても、これらの項目が自動で補完されるわけではありません。
- ルーティング:「設定」→「ルーティング設定」で、現在選択されているルールセットを確認します。カスタムルールをインポートした場合は、照合順序と参照先のルールリソースも確認してください。直結する想定の接続先と、プロキシ経由の想定の接続先にそれぞれアクセスし、ページが1つ開いただけで正常と判断しないようにしましょう。
- 通信の入口:メイン画面またはトレイメニューで「システムプロキシ」の状態を確認します。まず、システムプロキシを利用するアプリで接続をテストし、その後、必要に応じてTUNを個別に確認してください。システムプロキシですべてのアプリの通信が自動的に切り替わるわけではありません。TUNにはOSの権限やネットワーク設定が関わるため、最初の切り分けでシステムプロキシと同時に試すのは避けましょう。
複数バージョンを同時に試す場合のポート例
この2つのポートは競合の例であり、各バージョンの固定値ではありません。「設定」→「パラメーター設定」でローカル待ち受けポートを確認してください。旧版が同じアドレスとポートを使用していると、新版の画面は正常に開いても、待ち受けに失敗する場合があります。移行時は、まずトレイから旧版を終了するのが簡単です。並行して試す場合は、メインの待ち受けポートだけでなく、有効になっているほかの待ち受け設定も確認し、システムプロキシを変更するのは一方のインスタンスだけにしてください。
設定の移行:サブスクリプションは再登録、手動設定は個別に確認
まず、ノードの取得元を確認しましょう。サブスクリプショングループは、新版にサブスクリプションURLを追加し、「サブスクリプショングループ」メニューから更新できます。手動で追加したノードはサブスクリプションに含まれないため、共有リンクを保存するか、ローカルにバックアップしてください。サブスクリプションURLやノードの共有リンクには認証情報が含まれる場合があります。自分で管理できる場所に保管し、公開用のスクリーンショットやトラブル相談の投稿に載せないでください。
移行先に合わせた手順
同じWindows PCでバージョンを切り替える場合、または別のデスクトップOSへ移行する場合
WindowsでWPF版からAvalonia版へ移行
- 旧版でシステムプロキシを解除し、有効にしているTUNをオフにしてから、トレイメニューで終了します。その後、旧版が実際に使用しているデータフォルダーをバックアップしてください。
- 新版は旧版とは別の場所に置いて試してください。データファイルを戻す場合は、両バージョンのデータ形式とフォルダー構成に互換性があることを確認し、新版の初期データも別途保存しておきましょう。
- 旧版の記録を参照しながら、ルーティングとローカルポートを復元します。読み込みエラーが出た場合は、まず新版のデータを元に戻し、サブスクリプションと共有リンクからノードを再登録してください。
WindowsからmacOSまたはLinuxへ移行
- 移行先のOSとアーキテクチャに合ったAvalonia版をインストールし、サブスクリプションを再登録して、必要な手動ノードをインポートします。
- ルールファイルの保存場所、アプリに設定する手動プロキシのアドレス、ログイン時の自動起動を移行先のOSで設定し直してください。Windows専用のパスはコピーしないでください。
- まず通常のプロキシ接続とルーティング結果を確認します。すべてのデバイスの通信を経由させる必要がある場合に限り、移行先のOSでTUNを個別に設定して検証してください。
新版が単独で起動し、ノードに接続でき、ルーティング結果も想定どおりであることを移行完了の基準にします。これらを確認してから、旧版を削除するか判断してください。
よくある質問:乗り換え後に接続できない・ノードが減る・アプリがプロキシを使わない
症状別の確認方法
ウィンドウを閉じたのに、新版でポート使用中と表示されるのはなぜ?
ウィンドウを閉じても、旧版がトレイに残って動作していることがあります。旧版のトレイアイコンを見つけて「終了」を選び、新版でコアを再起動してください。それでもポート使用中と表示される場合は、「設定」→「パラメーター設定」で競合しているポートを確認します。ポートを変更した場合は、プロキシアドレスを手動設定しているアプリも変更してください。
サブスクリプションの更新は成功したのに、旧版よりノードが少ないのはなぜ?
同じサブスクリプショングループを選んでいるか、URLが一致しているかを確認し、グループ設定のフィルター条件も確認してください。次に、旧版で表示されていたノードのうち、手動で追加したものがないか確認します。サブスクリプションを更新しても手動ノードは新版に同期されないため、別途インポートする必要があります。
ブラウザーは使えるのに、別のアプリが接続できないのはなぜ?
まず、そのアプリがシステムプロキシを参照するか確認してください。手動プロキシに対応している場合は、クライアントが実際に提供しているローカル待ち受けのプロキシ種別、アドレス、ポートを設定します。これらの入口をアプリで使えず、通信を経由させる必要がある場合に限り、TUNを個別に確認してください。
新版が合わない場合、WPF版に戻すには?
新版でシステムプロキシを解除し、TUNをオフにしてから、トレイメニューで終了します。保存しておいた旧版のフォルダーからWPF版を起動し、現在のノードとルーティングを確認してから、元のシステムプロキシ設定に戻してください。2つのバージョンでデータフォルダーを共有していた場合は、移行前のバックアップから旧版のデータを復元してください。