まずWindowsのシステムアーキテクチャに合ったパッケージを選び、次にWPF版かDesktop版かを決めます。初期設定では、サブスクリプションの取得、コアの起動、ブラウザーのシステムプロキシ利用を個別に確認しましょう。問題が起きたら、その段階で切り分けます。画面やノード、ルーティングを同時に変更しないでください。
WPF版とDesktop版:アーキテクチャを確認してから選ぶ
Windowsの「設定」→「システム」→「バージョン情報」を開き、「デバイスの仕様」で「システムの種類」を確認します。x64ベースのシステムにはWindows x64版、ARMベースのシステムには対応するWindows ARM64版(提供されている場合)を選びます。どちらも「64ビット」と表示される場合があるため、ビット数だけで判断しないでください。WPFとDesktopは画面の種類であり、プロキシプロトコルではありません。同じサブスクリプションを使えるかどうかは、ノード設定と実際に動作するコアによって決まります。
Windows版の2つの画面タイプ
WPF版
- WindowsのWPF UIフレームワークを使用。使い慣れたWindows版の画面を使いたい場合に向いています。
- 選んだパッケージが外部ランタイムに依存している場合、起動時に表示される
Microsoft.WindowsDesktop.Appは .NET Desktop Runtime を示します。
Desktop版
- Avalonia UIフレームワークを使用します。他のプラットフォームで同じ画面を見たことがあっても、Windows版のパッケージを選んでください。
- メニューの配置はWPF版と異なる場合があります。ランタイムやコアが同梱されているかはリリースパッケージの説明で確認してください。「Desktop」の表記だけでは判断できません。
正常に使えているバージョンがあるなら、サブスクリプションの取り込みだけを目的に画面タイプを変える必要はありません。初めてインストールする場合は、アーキテクチャに合い、依存関係が明記されたパッケージを選びましょう。
展開・初回起動・サブスクリプションの取り込み
ここでは、v2rayN 7.xでよく見られるWindows版の画面を例に説明します。マイナーバージョンによってメニューの配置が変わる場合があります。ツールバーにボタンが見つからないときは、同じ名前のメニューを探してください。Windowsのネットワーク設定にサブスクリプションURLを追加する必要はありません。
ZIPを完全に展開する
ZIP形式でダウンロードした場合は、エクスプローラーで右クリックし、「すべて展開」を選びます。ユーザーアカウントから書き込み可能な専用フォルダー(ユーザーフォルダー内の
Tools\v2rayNなど)に展開してください。圧縮ファイル内から直接実行したり、メインプログラムだけを取り出したりしないでください。コアなどの同梱ファイルは、元のフォルダー構成を保つ必要があります。メインプログラムを起動する
展開したフォルダーから
v2rayN.exeを実行します。メイン画面が表示されない場合は、通知領域の隠れているインジケーターを確認してください。初回の取り込みや通常のシステムプロキシの確認に、TUNを先に有効にする必要はありません。また、管理者権限での実行を、起動失敗全般の解決策と考えないでください。サブスクリプションを追加する
メイン画面で「サブスクリプショングループ」→「サブスクリプショングループの設定」を開き、「追加」をクリックします。識別しやすい名前とサブスクリプションURL全体を入力して保存してください。URLには認証情報が含まれることがあるため、コピー時にクエリパラメーターを省略しないでください。画面を共有して問い合わせる際は、URL全体を隠してください。
ノードを取得する
「サブスクリプショングループ」メニューから「すべてのサブスクリプションを更新(プロキシを使用しない)」を実行し、作成したグループに切り替えてノードを確認します。URLを保存しただけではグループが作成されるだけで、更新は行われません。直接接続がタイムアウトし、すでに動作確認済みのプロキシがある場合は、「プロキシを使用して更新」の該当項目を試してください。
ノードを選択する
ノード一覧で使うノードを右クリックし、「アクティブサーバーに設定」を選びます。メイン画面に選択したノードが表示されていることを確認し、ログにコアの起動失敗や待ち受け失敗がないか調べてください。一覧にノードが表示されているだけでは、有効化済みとも利用可能とも限りません。
ローカルポートとシステムプロキシを確認する
まずコアがローカルで待ち受けていることを確認し、その後ブラウザーにシステムプロキシを使わせます。以下のポート番号はトラブルシューティングでよく見られる参考値であり、すべての7.x版で固定されているわけではありません。「設定」→「パラメーター設定」のローカル待ち受け設定と起動ログを基準にしてください。
ローカル待ち受けの確認
- ローカルアドレス
127.0.0.1- 待ち受けポート
- クライアントの設定と起動ログを確認
- テストの前提
- コアが起動し、このポートでHTTPプロキシ要求を受け付けていること
混合ポートはHTTPとSOCKSの両方を受け付けます。SOCKS専用ポートをHTTPプロキシとして設定しないでください。
システムプロキシの確認
- クライアント側の操作
- 通知領域のアイコン →「システムプロキシ」→「システムプロキシを自動設定」
- Windows側の確認場所
- 「設定」→「ネットワークとインターネット」→「プロキシ」
- 動作を確認するアプリ
- システムプロキシを使用するブラウザー
システムプロキシは、それに従うアプリからクライアントへリクエストを送るかどうかを決めます。ルーティングルールは、コアが受け取ったリクエストの接続先を決めます。
ブラウザー設定とローカルプロキシを切り分けるには、PowerShellでプロキシを明示してテストできます。以下の例は 10808 がHTTPプロキシ要求を受け付けることを確認済みの場合に限ります。待ち受けポートが異なる場合は、数字を置き換えてください。
curl.exe --noproxy "" --proxy http://127.0.0.1:10808 --connect-timeout 5 --max-time 15 -I https://example.com/
- ローカルポートに接続できない:待ち受けアドレス、ポート番号、コアのログを確認します。ログにアドレスの競合が表示されたら、
Get-NetTCPConnection -LocalPort 10808 -State Listenを実行してOwningProcessを確認し、タスクマネージャーの「詳細」タブでPIDに対応するプロセスを調べてください。見覚えのないプロセスをすぐに終了しないでください。 - コマンドは応答するのにブラウザーでは失敗する:ブラウザーが独自のプロキシ設定を使っていないか、Windowsに設定されたプロキシのアドレスとポートが一致しているか確認します。待ち受けポートを変更した場合は、システムプロキシを再適用し、アプリに手入力した古いポートも更新してください。
- ページは開くが、どの接続先を経由したか分からない:応答が返ったことから分かるのは、リクエストがローカルプロキシを通って処理されたことだけです。必ずリモートノードを経由したとは限りません。テスト先のドメインが直接接続ルールに該当する場合があります。確認するには、使用中のルーティングルールの順序と、利用可能なコアのアクセスログを照合してください。
起動・サブスクリプション・ブラウザーの接続トラブルを解決する
起動時に.NETのインストールを求められたら、どれを入れる?
ダイアログに表示されたフレームワーク名、バージョン、アーキテクチャに合うランタイムを選びます。たとえば Microsoft.WindowsDesktop.App、バージョン 8.0 系、x64 と表示された場合は、対応する .NET 8 Desktop Runtime x64をインストールしてください。通常の .NET Runtimeだけでは不十分です。dotnet --list-runtimes で確認できます。異なるアーキテクチャのランタイムが複数インストールされている場合は、表示された一覧にプログラムが必要とするアーキテクチャが含まれているか確認してください。
メインプログラムがあるのに、ログにコアが見つからないと表示されるのはなぜ?
まず、リリースパッケージに必要なコアが含まれているか、すべてのファイルが完全に展開されているか確認します。次に「Windows セキュリティ」→「ウイルスと脅威の防止」→「保護の履歴」を開き、起動時刻とファイルパスに一致する記録がないか調べてください。起動のために保護機能を無効にしたり、フォルダー全体を除外したりしないでください。入手元や警告の原因が分からない場合は実行をやめ、信頼できる配布元からパッケージを入手し直してください。組織の管理端末は管理者に相談してください。
フォルダー名に日本語が含まれ、ファイルが見つからないと表示される場合は?
まず通知領域からクライアントを終了し、同じパッケージをユーザーが書き込み可能な、短く日本語を含まない専用フォルダーにすべて展開し直します。最後のフォルダー名だけでなく、フルパスを確認してください。新しいフォルダーから起動して比較し、2つのフォルダーの内容を上書きして混在させないでください。日本語を含むパス自体が必ず問題になるわけではありません。移動後に同じ操作が成功した場合に、パスの解釈、パス長、アクセス権を調べましょう。
サブスクリプションの更新がタイムアウトする。コアを変更すべき?
まずサブスクリプション更新ログを確認してください。サブスクリプションの取得失敗とノードへの接続失敗は別の問題です。タイムアウトする場合は、現在のネットワークからサブスクリプションサービスに接続できるか、選択した更新方法がまだ使えないプロキシに依存していないか確認します。401 または 403 が返る場合は、サブスクリプションの有効期限やアクセス権限の変更を確認してください。証明書エラーが記録されている場合は、Windowsの日付、時刻、タイムゾーンを確認します。証明書検証を無効にして解決しようとしないでください。
クライアントを終了すると、ブラウザーもネットにつながらなくなるのはなぜ?
Windowsのプロキシ設定が、すでに停止したローカルプロキシを参照していると、ブラウザーは接続先のないプロキシに接続し続けます。クライアントを再起動し、通知領域の「システムプロキシ」メニューから「システムプロキシを解除」を選んでから、通常の手順で終了してください。Windowsの「プロキシ」画面で設定が解除されたことを確認します。組織のプロキシを使っていた場合は、すべてのプロキシ設定を無効にするのではなく、元の設定に戻してください。