v2rayNを初めてインストールするなら、OSとプロセッサに合ったAvalonia版がおすすめです。Windowsだけを使い、従来の画面に慣れている場合はWPF版を使い続けても問題ありません。主な違いは画面と対応OSで、ノードの種類ではありません。切り替える前にバックアップを取り、切り替え後はサブスクリプション、ルーティング、ローカルポートを確認しましょう。
対応OSで選ぶAvalonia版とWPF版
AvaloniaとWPFは、ウィンドウやメニュー、ボタンなどの画面を作るためのフレームワークです。プロキシプロトコルでも、接続を処理するコアでもありません。同じVLESSまたはVMessノードを比較する場合は、使用するコアとバージョン、ノード設定、ルーティング設定が一致しているかを先に確認してください。画面の名称だけで互換性や接続速度は判断できません。
Avalonia版
おすすめWindows、macOS、Linuxに対応し、各OS向けのインストールパッケージが用意されています。同じ画面フレームワークにより操作感は共通していますが、ウィンドウやメニュー、トレイ、システムプロキシの動作はOSによって異なります。
おすすめ:初めてインストールする場合や、異なるデスクトップOS間で切り替えて使う場合。
WPF版
Windows向けです。従来の画面に慣れていて、現在の設定にも問題がなければ、画面を変えるためだけに再インストールする必要はありません。ダウンロード時は、対応するプロセッサアーキテクチャと動作要件も確認してください。
おすすめ:Windowsだけを使い、従来の画面と操作方法を維持したい場合。
以前のチュートリアルを見ながら操作するときは、まず画面がどちらの版のものか確認しましょう。ウィンドウの配置が違っても、機能がなくなったとは限りません。ノード一覧、サブスクリプショングループ、ログを探すときは、スクリーンショットと同じ位置にあるかではなく、機能名を目印にしてください。
インストールパッケージのアーキテクチャと.NETの実行要件
パッケージは、OS、プロセッサアーキテクチャ、パッケージ形式の順に選び、最後にランタイムの追加インストールが必要か確認します。v2rayN 7.xシリーズでも、メジャーバージョンだけを見て、すべてのリリースが同じ.NETバージョンに依存する、またはランタイムを同梱しているとは判断できません。起動時にエラーが表示されたら、使用中のパッケージの説明と、エラーに記載されたフレームワーク名・バージョン・アーキテクチャを確認してください。
- Windows:「設定」→「システム」→「バージョン情報」で「システムの種類」を確認し、ダウンロードページで対応するパッケージを選びます。WPFの起動エラーに
Microsoft.WindowsDesktop.Appが不足していると明記されている場合は、対応するバージョンとアーキテクチャの.NET Desktop Runtimeが必要です。通常の.NET Runtimeだけでは、このデスクトップフレームワークは補えません。 - macOS:Appleメニュー→「このMacについて」で「チップ」または「プロセッサ」を確認します。AppleシリコンならARM64、Intelプロセッサならx64を選んでください。どちらのパッケージも拡張子が
.dmgだからといって、適当に選ばないようにしましょう。 - Linux:ターミナルで
uname -mを実行して、アーキテクチャを確認します。アーキテクチャを選んだら、ディストリビューションに合ったパッケージ形式を選びましょう。たとえばDebianやUbuntuでは通常DEB、Fedoraでは通常RPMを選びます。形式が合っていても、すべてのディストリビューションのバージョンで動作するとは限りません。インストールに失敗したら、まずパッケージ管理ツールに表示された依存関係を確認してください。
切り替え前にバックアップし、移行先に合わせて設定を復元
画面の切り替えは、ノードを再インポートするだけでは済みません。サブスクリプショングループ、手動で追加したノード、カスタムルーティング、ローカルの待ち受け設定はそれぞれ別のデータです。サブスクリプションを再取得して復元できるのは、通常そのサブスクリプションから提供されるノードだけです。バックアップの前に旧版の「システムプロキシ」をオフにし、トレイからクライアントを終了してください。ウィンドウを閉じただけでは、バックグラウンドで設定の書き込みが続くことがあります。
同じPCでの版の切り替えと、別OSへの移行
Windowsで版を切り替える
- 旧版が実際に使用しているデータフォルダーをバックアップします。プログラムフォルダー内に使用中の
guiConfigsがある場合は、JSONファイルを一つだけ選ぶのではなく、フォルダー全体をバックアップしてください。 - できるだけ同じリリースバージョンの2つの画面版を選びます。新しい版をまず単独で起動し、実際に読み込んだデータの場所を確認してから終了し、そのデータもバックアップしてください。
- データ形式に互換性があることを確認したうえで、旧データのコピーから復元します。2つの画面版で同じデータを同時に読み書きしないでください。また、旧版のコア実行ファイルを新版に上書きしないようにしましょう。
macOSまたはLinuxに移行する
- 旧版の「サブスクリプショングループ」→「サブスクリプショングループ設定」でサブスクリプションURLを控えます。手動で追加したノードは、別途エクスポートするか内容を記録してください。
- 新しいOSに対応するアーキテクチャのクライアントをインストールしてから、サブスクリプションとノードを復元します。Windowsの絶対パス、自動起動設定、コアの実行ファイルはそのまま引き継がないでください。
- 「設定」→「ルーティング設定」でカスタムルールと参照先のローカルファイルを確認し、新しいOSのディレクトリに合わせてパスを指定し直します。
どちらの方法でも元のバックアップは残してください。サブスクリプションURLやノードの共有リンクにはアクセス情報が含まれる場合があります。公開スクリーンショットやログに載せないようにしましょう。
切り替え後にノード・ポート・ルーティングを確認する
まず新版が元のデータを読み込んでいることを確認してから、システムプロキシを有効にします。問題が起きたときに、設定の移行漏れ、コアの起動失敗、アプリが正しいプロキシ接続先を使っていないことのどれが原因か切り分けやすくなります。
- グループと選択中のノードを確認。サブスクリプショングループ名、手動で追加したノード、現在選択されているノードを確認します。一覧が空の場合は、まず新版が想定したデータフォルダーを読み込んでいるか確認し、サブスクリプションを削除したり旧版に上書きしたりするのは避けてください。
- 接続先とログを確認。「設定」→「設定パラメーター」でローカルの待ち受けポートを確認します。ログに
address already in useと表示されたら、旧版とそのコアプロセスが終了しているか確認してください。ポートを変更する場合は、プロキシアドレスを手動設定したアプリも同じように変更し、HTTPとSOCKSのどちらを使っているか確認しましょう。 - 同じ接続先でルーティングをテスト。必要なシステムプロキシモードを有効にしたら、以前は直接接続していたドメインと、プロキシ経由だったドメインをそれぞれテストします。ページを開けても、リクエストが成功したと分かるだけです。実際の経路は、コアのログと有効なルーティングルールを合わせて確認してください。ターミナルでだけ問題を再現できる場合は、ターミナルのプログラムがシステムプロキシを参照しているか、別のプロキシ環境変数が設定されていないか確認しましょう。
バージョン切り替え時によくある質問
WPF版が問題なく使えている場合も、Avalonia版に切り替える必要がありますか?
画面を変えるためだけに移行する必要はありません。必要なのが新しいコアのサポートなのか、クロスプラットフォームの画面なのかを先に確認してください。コアだけが目的なら、現在のクライアントが対応するコアとバージョンを確認します。別の画面版を試す場合は、旧版とバックアップを残し、旧版を終了してから新版を起動してください。
新版を起動すると.NET不足と表示されます。より新しいバージョンをインストールすれば解決しますか?
必ずしも解決するとは限りません。エラーに記載されたフレームワーク名、必要なバージョン、アーキテクチャを確認してください。PCにインストール済みの新しいメジャーバージョンだけを見て判断することはできません。リリースページにPCに合った自己完結型パッケージがあれば、それを選ぶことで、そのパッケージ用に.NETランタイムを別途インストールする手間を省けます。
サブスクリプションもノードも表示されているのに、ブラウザーがプロキシを経由しないのはなぜですか?
まずログを見て、コアが起動しているか確認します。次に、トレイの「システムプロキシ」が必要なモードになっているか確認してください。ブラウザーでプロキシを個別に設定している場合は、入力したポートとプロキシの種類も確認します。画面を切り替えても、ブラウザーに固定された古い接続先は自動で変更されません。
切り替え後にルーティングがおかしくなりました。旧版に戻すには?
まず新版のシステムプロキシをオフにして終了し、旧版を起動します。試用中に旧版のデータフォルダーを変更した場合は、移行前に別途作成したバックアップから復元してください。新版が書き込んだデータベースを、そのまま旧版に読み込ませないでください。最後に、元のルーティングルールとノードを選び直してからシステムプロキシを有効にします。