TROUBLESHOOTING / トラブル対処
v2rayN トラブル対処ガイド
初回インストールやサブスクリプションの追加、ルーティング設定を行う場合は、まずv2rayNの設定ガイドに沿って初期設定を進めてください。設定済みなのに問題が起きる場合は、このページの目次から該当する症状を選べば、最初から再インストールする必要はありません。設定ガイドでは動作する環境を整え、このガイドでは設定のどこで問題が起きているかを特定します。
トラブル対処中は、一度に変更する項目を一つに絞ってください。発生時刻、使用中のノード、接続ネットワーク、プロキシモードを記録し、同じアプリと接続先で再テストします。ログを共有する場合は、発生時刻の前後にあるエラーだけを抜き出し、サブスクリプションURL、ユーザー識別情報、サーバーアドレスを削除してください。
ネットに接続できない:ローカルの入口から実際の通信経路を確認
端末全体のネット接続不良とプロキシ経路の問題を切り分ける
まずクライアントによるネットワーク制御を一時停止します。仮想NICモードを有効にしている場合は、クライアント内でオフにしてください。システムプロキシを設定している場合は、クライアントの解除機能で元に戻し、システム設定も確認します。企業や学校の端末では指定プロキシが必要なことがあります。その場合は、元のアドレスまたは自動構成スクリプトに戻し、すべてのプロキシを無効にすることを標準設定にしないでください。本来アクセスできるWebページをブラウザーで開き、システムのネット接続状態も確認します。ホテルや学校などのログイン画面が必要なネットワークでは、先に認証を完了してください。ネットワーク制御を停止しても本来開けるページにアクセスできない場合は、まず基本的なネット接続を修復します。
ネット接続が戻ったら、ネットワーク制御方式を一つだけ有効にし、現在のノードを選んで、先ほどと同じブラウザーで同じアドレスにアクセスします。仮想NIC、システムプロキシ、ブラウザーのプロキシ拡張機能を同時に有効にすると、リクエストの受け口を特定できません。通常のWebページは開けるのに特定のアプリだけ失敗する場合は、そのアプリが使うWebサイトをブラウザーで開いて比較します。ブラウザーで成功しても、アプリがシステムプロキシを使うとは限りません。アプリで失敗しても、通信経路全体の障害とは限りません。ネットワーク制御を再開した後にすべてのリクエストが失敗する場合は、まずコアが正常に起動しているか確認し、その後でノードを調べます。最初からプロトコル変更やネットワークのリセットを行う必要はありません。
ローカルの待ち受けとアプリの接続先を確認
v2rayNの設定で、実際に有効な待ち受けがHTTP、SOCKS、混合のどれかを確認し、ログにバインド失敗がないか確認します。アプリによっては対応するプロキシ方式が限られており、ポート番号が正しくても方式が違えば接続できません。アドレスには設定画面に表示されたローカル待ち受けアドレスを使い、ポートは現在のインスタンスに合わせてください。古いガイドの値をそのまま使わないでください。以下はローカルポートの確認例です。現在のポートが10808の場合に限り、そのまま実行できます。それ以外の場合はポート番号を置き換えてください。まずクライアントを起動した状態で確認します。必要に応じてクライアントを通常終了してからもう一度確認し、プロセス終了に伴って待ち受けが停止するか比較してください。
| プラットフォーム | 確認コマンド | 結果の見方 |
|---|---|---|
| Windows | Test-NetConnection 127.0.0.1 -Port 10808 | PowerShellでTcpTestSucceededの値を確認します。 |
| macOS | nc -vz 127.0.0.1 10808 | 成功しても、本機がTCP接続を受け付けたことを示すだけです。 |
| Linux | ss -ltnp 'sport = :10808' | 該当するTCP待ち受けを確認します。プロセス情報の表示には権限が必要な場合があります。 |
ログにポート使用中と表示された場合は、別のクライアントや終了していないコアが使っていないか確認します。重複していると確認できたインスタンスは、まず通常の方法で終了してください。用途のわからないシステムプロセスを強制終了しないでください。ポートを変更する場合は、古いポートを手入力したアプリも更新し、v2rayNでシステムプロキシを再適用します。コマンド上は正常に待ち受けているのにリクエストがコアのログに現れない場合は、アプリの接続先設定を優先して確認します。ログレベルによってはアクセスが記録されないため、この結果だけで判断しないでください。手動プロキシに明確に対応したアプリで一時的にこの待ち受けを指定し、テスト後に元の設定へ戻す方法もあります。
1つのリクエストでルーティングと復旧を確認
リクエストがコアに届いたことを確認したら、失敗したリクエストが実際にどのアウトバウンドを選んだかを確認します。見るべきなのは画面上のポリシー名ではなく、実際のマッチ結果です。想定外に直接接続へ振り分けられている場合は、ルールの順序、ドメイン名とIPアドレスのどちらで判定されているか、編集中の設定が実行時に読み込まれているかを確認します。ルーティングを変更する場合は、テスト用ルールを1つだけ調整し、検証後に元の設定へ戻してください。本来直接アクセスするLAN内のサービスをプロキシ経由にしないよう注意します。想定どおりプロキシ側のアウトバウンドが選ばれているのに、サーバー接続やハンドシェイクで止まる場合はノードのタイムアウトを確認してください。
ノードのタイムアウト:名前解決・接続・ハンドシェイクを切り分ける
どの種類のテストでタイムアウトしたか確認
まず、クライアントで実行したテストの種類を確認します。TCP接続の確立だけを試す機能もあれば、そのノード経由で実際にリクエストを送り、テスト先から応答が返るまで待つ機能もあります。前者が成功しても、コアのプロトコルハンドシェイクが完了したとは限りません。後者の失敗も、単にテスト先へアクセスできないことが原因の場合があります。システムのpingに応答があるかどうかでプロキシの動作を判断しないでください。接続先がこの種の探査に応答しなくても、対象ポートへの接続は正常に受け付けている可能性があります。まず安定したネットワークでノードを1つずつテストし、その後、動作確認済みのノードでも同じテストを行います。トラブル対処中は一括速度測定を止め、ローカルの同時接続とサーバー側のレート制限が結果に混在しないようにしてください。
最初に失敗した時刻を記録し、全ノードが同時にタイムアウトするのか、同じグループ全体なのか、特定のノードだけなのかを区別します。全ノードで同時に失敗する場合は、現在のネットワーク、ノードのドメイン名解決、本機の時刻、コアの起動状態を確認します。同じグループで失敗し別のグループは正常な場合は、両グループでサーバーアドレス、トランスポート方式、サブスクリプション元を共有していないか確認します。1つのノードだけ失敗する場合は、全体設定に触れず、そのノードのアドレス、ポート、トランスポート設定を重点的に比較します。ノードが1つ復旧してもほかのノードを再テストし、複数の問題が同時に起きたことを単一の障害と誤認しないようにしてください。
ログの段階に沿って対処し、待ち時間の延長で問題を置き換えない
最初のエラーがホスト名の解決失敗や名前解決のタイムアウトなら、まだ接続先のアドレスを取得できていません。現在のネットワークで使われるシステムのDNSリゾルバーでノードのドメイン名を確認し、その後、コア独自の名前解決経路を調べます。アドレスを取得できているのに接続がタイムアウトする場合は、現在のネットワークからサブスクリプションに記載されたアドレスとポートへ到達できるか確認します。接続拒否と接続待ちのタイムアウトは異なります。前者は今回の接続が明示的に拒否されたこと、後者は待機中に期待した応答が得られなかったことを示します。どちらの結果だけでも、原因となった機器がどちら側にあるかは特定できません。利用権限のある別のネットワークでも同じノードをテストし、サーバー設定は同時に変更しないでください。
下位の接続が確立した後にハンドシェイクでエラーが発生する場合は、ノード提供元の設定に従ってプロトコル、暗号化やセキュリティ設定、トランスポート方式、必要に応じてサーバー名とパスを確認します。表示名はメモにすぎず、これらの設定項目の代わりにはなりません。同じテンプレート由来の設定でも、アドレスだけを別のノードにコピーして流用しないでください。証明書や時刻に関するログがある場合は、まずシステム時刻の自動調整を有効にし、該当ノードのハンドシェイク中にエラーが発生したことを確認します。エラー表示を消すために証明書検証を無効にしないでください。設定が提供元の現行情報と一致している場合は、機密情報を削除した最初のハンドシェイクエラーを提供元に送り、確認を依頼します。
テスト先と実際のアクセスを分けて確認
テストではタイムアウトするのに、そのノード経由で実際の作業に必要なページを開ける場合は、テスト先が現在のネットワークでも有効か確認します。クライアントでテスト先を変更できる場合は、安定して応答し、利用目的が明確なHTTPSアドレスを選び、比較テストでは同じ接続先を使ってください。リダイレクトを返したり認証を要求したりするアドレスでは、ブラウザーにページが表示されてもクライアントの疎通テストが成功したとは限りません。逆に、速度測定のリクエストが成功しても、その接続先への経路が使えたことを示すだけです。実際の接続先が開けない場合は、その接続先のルーティング、名前解決、アクセス条件を確認してください。実際のリクエストが成功しているノードを何度も入れ替える必要はありません。
タイムアウト表示を成功に変えるためだけに、テストの待ち時間を何度も延ばさないでください。通常のリクエストが繰り返し成功し、最初の接続だけが時折遅く、名前解決とハンドシェイクの失敗も除外できている場合に限り、待ち時間の調整が有効なことがあります。復旧後は2段階で確認します。まず元のノードで同じ接続先にアクセスし、次に普段のルーティングに戻して直接接続すべきアドレスへアクセスします。ネットワーク切り替え後や端末のスリープ解除後だけ失敗する場合は、ネットワーク切り替えから最初のリクエストまでの時間を記録し、ネットワークの再接続後に自然に復旧するか確認してから、システムプロキシやモバイル端末のバックグラウンド制限を調べてください。
サブスクリプション更新に失敗する:URLからグループまで順に確認
更新対象と更新経路を確認
v2rayNのサブスクリプショングループ設定を開き、操作対象が問題のグループであることを確認します。名前の似た別の項目を選んでいないか注意してください。URLの先頭、ドメイン名、末尾のパラメーターを順に比較します。チャット履歴や複数行のテキストからコピーすると、説明文、空白、末尾の句読点まで含まれることがあります。提供元から渡されたURLを省略せず使い、アカウント管理ページのURLをサブスクリプションURLとして入力しないでください。自動更新と手動更新は別の処理です。自動更新に失敗した場合は、該当グループが更新対象かを確認し、手動更新を1回実行して該当時刻のログを確認します。手動更新が成功した場合に限り、更新間隔、スリープ解除後の更新、アプリのバックグラウンド動作を調べます。
更新リクエストが直接接続とプロキシ接続のどちらを使うか確認します。ブラウザーでWebページを開けても、クライアントのサブスクリプション更新リクエストが同じネットワーク設定を使うとは限りません。ログを確認し、現在のクライアントの更新設定を基準に判断します。プロキシ経由で更新する設定なのに、そのグループの古いノードがすべて使えないと、更新に古いノードが必要になる循環状態になります。まず現在のネットワークからサブスクリプションURLへ直接接続できるか確認します。プロキシが必要な場合は、実際にアクセスできる別のノードを使い、問題のグループだけを1回更新してください。テスト前に元の更新方式を記録し、失敗したら元に戻します。未検証の経路へすべてのグループを一括で切り替えないでください。
リクエスト失敗・応答エラー・形式不一致を切り分ける
ログにHTTPステータスが記録されていない場合は、まずサブスクリプションのドメイン名解決、接続、証明書の問題を確認します。ステータスコードを受け取っている場合は、その内容に応じて対処します。未認証やアクセス拒否の場合は、サブスクリプションの期限切れや専用URLの有無を提供元に確認してください。URLが見つからない場合は、提供元がサブスクリプションのパスを変更していないか確認します。レート制限が発生した場合は連続再試行を止め、サーバーの案内または提供元の指示に従って待ちます。サーバー側のエラーについては、問い合わせ用に発生時刻とステータスを記録してください。短時間にグループを削除して作り直しても、サーバー障害は解消しません。ログを共有する場合は障害が起きた段階とステータスだけにし、パラメーター付きの完全なURLは認証情報として扱ってください。
リクエストが成功しても、インポートまで成功したとは限りません。URLからアカウントのログイン画面、エラー説明、空の本文、またはクライアント非対応の形式が返る場合があります。解析エラーが表示された場合は、提供元が現在のクライアント向けに別のサブスクリプションURLを用意しているか確認してください。形式用のパラメーターを自己判断で付け足さないでください。ログイン済みブラウザーでURLに内容が表示されても、クライアントが同じログイン状態を持つとは限りません。内容を不明なオンライン変換サービスに送信しないでください。提供元に確認する場合は、返された内容の種類、エラー発生時刻、クライアント名だけを伝えます。応答を比較するときはクライアントの要約を優先し、本文全体を公開ログに保存しないでください。
更新後にリストの変化を確認
ログに更新完了と表示されてもリストが変わらない場合は、現在のグループフィルター、検索欄、更新対象を確認し、既知のノードを1つ選んで設定を比較します。別名や件数だけで判断しないでください。プロトコルに対応していない項目や無効な内容が読み飛ばされることがあります。その場合は、グループ全体の失敗と決めつけず、対象項目とインポート時のメッセージを確認します。逆に件数が増えても、新しい設定が使えるとは限りません。更新したグループから新しいノードを選び、実際にアクセスできるかテストしてください。手動で管理している項目がある場合は、サブスクリプションから生成された項目と分けて確認し、サーバー側からの更新をローカル保存の失敗と取り違えないようにします。
速度が遅い:比較テストでボトルネックを特定
どの段階で遅いかを整理
現象を、初回表示まで時間がかかる、表示後の転送がずっと遅い、転送中に断続的に止まる、の3つに分けます。初回の応答が遅く、その後の転送が安定している場合は、名前解決、接続確立、ハンドシェイクを優先して調べます。開始は速いのにダウンロード中に何度も止まる場合は、継続的なスループット、パケットロス、接続先の制限、ネットワーク切り替えを確認します。ノードの単発の遅延値はファイルのダウンロード速度を示すものではありません。接続先によって経路、サーバー負荷、応答時間は異なります。Webページは複数のドメインから読み込むこともあるため、メインページの応答だけで全リクエストが正常とは判断できません。まず再現性のある操作を一つ決めてください。
同じアプリ、同じアドレス、近い時間帯で比較します。ネットワークは変えず、まず元のルーティングでテストし、次に動作確認済みのノードへ一つだけ切り替えて再テストします。その後で初めて、ノードを固定して接続ネットワークを変更します。安全に直接接続できる公開リソースは、ローカルネットワークの基準として直接接続でも測定できます。通常は直接アクセスできない接続先の失敗を速度比較に含めないでください。帯域を使うバックグラウンド処理を止め、テストごとに異なるキャッシュ経路を通らないようにします。同じサイズの公開リソースを使い、応答開始までの待ち時間と転送時間を記録します。結果が安定するまで数回測定し、偶然の最高値だけを基準にしないでください。
影響範囲からルーティング・通信経路・接続先を特定
特定のWebサイトやファイル形式だけ遅い場合は、接続先が想定どおりのアウトバウンドを通っているか確認します。ページの静的リソースは別ドメインから読み込まれることがあります。メイン文書はプロキシ経由なのにリソースが直接接続されていると、ページの枠だけ先に表示され、内容の読み込みが遅れることがあります。ブラウザーの開発者ツールのネットワークパネルで遅いリクエストを特定し、コアのログと照合します。テスト対象のルールは小さな範囲に限定し、問題が確認できた通信だけを変更してください。特定のサービスだけが遅く、ほかのよく使う接続先は安定している場合は、サービス側のセッション、アカウント、接続速度の制限を確認し、1つのサイトのためにルーティング全体を入れ替えないでください。
すべてのノードが遅く、直接接続の基準も遅い場合は、まずWi-Fiの電波状況、接続ネットワークの混雑、ほかの端末の通信を確認します。特定の時間帯だけ遅い場合は、同じ時間帯に比較テストを行い、接続ネットワークか同じサービスのどちらに追随するかを確認します。複数のネットワークで特定のノードだけ継続して遅く、ほかのノードは問題ない場合は、検証済みのノードへ切り替え、比較結果を提供元に共有できます。アップロードとダウンロードは分けて確認してください。Webページが正常でもアップロードだけ遅いことはあります。バックグラウンド同期がアップロード帯域を使い切ると、対話的なリクエストにも影響します。同期を停止して改善する場合は、プロキシプロトコルではなくタスクの同時実行数や実行時間を調整してください。
根拠がある場合に限り詳細設定を変更
最初からシステム全体のネットワークアダプター設定を変えたり、接続数をむやみに増やしたりしないでください。同じネットワーク、同じノード、同じ接続先で、仮想NICモードの継続的な転送だけが繰り返し失敗し、アプリがローカルプロキシを使う場合は正常なときに限り、仮想NICの経路、アダプターの競合、パケットサイズの制限を確認します。まず通信を同時に制御する可能性のあるアプリを終了し、接続を確立し直してからテストしてください。関連項目を変更できる場合は元の値を記録し、一度に一つだけ変更します。変更後に一度の速度測定しか改善しない場合や、ほかのアプリに異常が出た場合は元に戻してください。安定して再現できない設定を、すべてのネットワークに適用しないでください。
対処後は、通りやすい速度測定に置き換えず、元の状況を再現して確認します。長時間のダウンロードで問題が起きていた場合は、停止していた位置まで同種のダウンロードを続けます。Webページを開くときに発生していた場合は、同じドメインへの新しいリクエストで初回の待ち時間が短くなったか確認します。改善につながった変更は一つだけ記録し、適用されるネットワーク条件も残してください。元のネットワークでは失敗し、ネットワーク変更後は安定する場合は、それぞれの結果を分けて記録します。ネットワーク条件の異なる結果をまとめて、クライアントが修復されたと結論づけないでください。
DNSの問題:ノードのドメイン名と接続先のドメイン名を切り分ける
実際に名前解決を行っているコンポーネントを特定
まず障害記録に、名前解決に失敗したのがノードのサーバードメインか、アクセス先のドメインかを明記します。前者はプロキシ接続の確立前に解決が必要なことがあります。後者はプロキシの入口や設定によって、システム、ブラウザー、ローカルのコア、リモートのいずれが処理するか異なります。システムコマンドで名前解決に成功しても、そのコマンドが使う経路が動作したことを示すだけです。ブラウザーのセキュアDNSやコアが同じリゾルバーを使っているとは限りません。コアのログに接続先アドレスがあっても、ローカルで名前解決した証拠とは限りません。アプリからアドレスが渡された可能性もあります。結果に食い違いがある場合は、まず名前解決を行った側を確認し、該当する層の設定を変更してください。
同じ問題のドメイン名を複数のアプリで比較し、実際に得られたアドレスの種類、エラー、発生時刻を記録します。複数のアプリでそのドメインが見つからない場合は、現在のネットワークのDNS設定とドメイン名の入力ミスを確認します。特定のブラウザーだけで発生する場合は、独自のセキュアDNSが有効か、そのドメインが現在のネットワーク内でのみ解決される名前かを確認してください。アプリがドメイン名をプロキシに渡して解決する場合、ローカルコマンドの結果は実際のアクセスと直接対応しません。DNSの正常性を確認するためにHTTPSのURLをIPアドレスへ置き換えないでください。証明書検証、仮想ホスト、ルーティング判定が変わります。
名前解決の結果と新しいリクエストを照合
以下のコマンドは、一般的なデスクトップ環境でデフォルトのリゾルバーが公開サンプルドメインに応答するか確認できます。実際の障害を調べる場合は、テストする権限のある問題のドメイン名にexample.orgを置き換え、IPv4とIPv6のレコードを分けて確認してください。対象にどちらか一方のレコードしか設定されていなくても、名前解決の異常とは限りません。両方のアドレスが返るのにアプリが接続できない場合は、実際にどちらのアドレスを選んだか、そのアドレスに到達できるかを確認します。クエリのタイムアウト、ドメイン名が存在しないこと、要求した種類のレコードがないことは異なる結果です。すべてをDNSサーバーの障害と判断しないでください。社内ドメインの名前解決には、許可された内部リゾルバーだけを使用してください。
nslookup -type=A example.org
nslookup -type=AAAA example.org
接続ネットワークを切り替える前後で結果を比較する際、既存のタブを更新できるかだけを判断材料にしないでください。確立済みの接続が古いアドレスを使い続けることがあります。アプリ、システム、リゾルバーも以前の成功や失敗をキャッシュしている可能性があります。設定を変更したら、対象のページやアプリを閉じて新しいリクエストを開始し、ログを確認します。どのキャッシュが影響したか判断できなくなるため、すべての層のキャッシュを一度に消去しないでください。名前解決が復旧しても接続先が開けない場合は、選択されたアドレスとルーティングを確認します。ドメイン名に依存するルールが機能しない場合は、判定に必要な情報が実際に入口から取得できているかを確認してください。
リゾルバーの起動依存関係とルールの役割を整理
コアに独立した名前解決サービスを設定している場合は、そのサービスへの接続に先行する名前解決が必要か、まだ接続できないプロキシのアウトバウンドに依存していないか確認します。プロキシノードのドメイン名を解決する必要があるのに、リゾルバーへはそのノード経由でしかアクセスできない場合、依存関係が循環します。確立していない接続へすべてのクエリを移さないでください。まず動作する初期の名前解決経路を残し、個別に解決する必要がある接続先を範囲を絞って処理します。管理対象ネットワークでは、内部ドメイン、検索サフィックス、プライベートアドレスの名前解決ルールを先に確認してください。変更後はノードのドメイン名、一般公開ドメイン、必要な内部名をそれぞれ確認し、1種類だけが直った状態にならないようにします。
コア設定を変更する前に、その項目が現在実行中のコアに対応しているか確認してください。別のコアの設定構造をそのまま貼り付けないでください。ルーティングのドメイン判定、リゾルバーのドメイン判定、返されたアドレスへの制限は、それぞれ異なる段階に作用します。ルールが機能しない場合は、クライアント生成設定と手動設定のどちらを読み込んでいるか確認し、未知の項目やデータファイルの読み込み失敗がログにないか調べます。項目の役割を順に確認したい場合はV2Ray DNS設定の解説を参照できます。トラブル発生時の判断は、実際のリクエストと使用中のリゾルバーの応答を基準にしてください。
システムプロキシが効かない:適用範囲と残った設定を確認
アプリがシステム設定を使うか確認
システムプロキシはアプリが参照できる接続設定であり、端末のすべての通信を捕捉する仕組みではありません。問題のアプリがシステムの既定プロキシ、独自のプロキシ設定、実行環境のプロキシ環境変数のどれを使うか確認します。システム設定を使うことが明確なブラウザーで比較し、問題のアプリは完全に終了してから再起動してください。起動時にだけ設定を読み込むアプリや、ウィンドウを閉じてもトレイで動作し続けるアプリがあります。デスクトップとは別のアカウント環境で動作している場合もあります。ブラウザーでは正常で問題のアプリからコアへの接続がない場合は、ルーティングルールを変更する前に、そのアプリがプロキシ設定を読み取る場所を特定し、手動設定が必要か判断してください。
クライアントで自動設定を選んだ場合は、トレイメニューだけでなく、システムに実際に設定されたアドレス、ポート、例外を確認します。システムプロキシを変更しない設定を選んでも、既存の値が残ることがあり、自動的に直接接続へ戻るとは限りません。手動設定したことがある端末では、元の例外と自動構成URLも記録してください。ローカルの待ち受けをプロキシ入口として設定する場合は、アプリが対応するプロトコルに合わせてHTTPまたはSOCKSを選びます。ポートが待ち受けているだけで適合すると判断しないでください。最初の確認では例外リストに含まれない公開ドメインを使い、次に除外される想定の内部サイトを開いて、適用と除外の両方が意図どおりか確認します。
プラットフォーム別に実際の適用箇所を確認
| プラットフォーム | まず確認する項目 | よくある違い |
|---|---|---|
| Windows | 設定 → ネットワークとインターネット → プロキシ | デスクトップユーザーの設定と、サービスプロセスのWinHTTP設定は別です。 |
| macOS | 現在のネットワークサービスの詳細 → プロキシ | Wi-Fiと有線接続で別々の設定が保存される場合があります。 |
| Linux | デスクトップセッションのネットワークプロキシとアプリ独自のプロキシ設定 | デスクトップ、ターミナル、システムサービスでは起動環境が異なります。 |
Windowsでは、現在ログインしているユーザーのシステムプロキシと、一部のサービスが使うWinHTTPを区別します。デスクトップのブラウザーは正常なのにバックグラウンドサービスが失敗する場合は、サービスが使うネットワークインターフェースとアカウントを確認してください。デスクトップのプロキシ設定をシステム全体へそのままコピーしないでください。macOSでは使用中のネットワークサービスを確認し、有線とWi-Fiを切り替えた後に設定を見直します。以前設定したサービスだけを確認して終わらないでください。Linuxでは起動方法にも注意が必要です。ターミナルから起動したプロセスとデスクトップから起動したプロセスで、環境変数が異なる場合があります。まずアプリのドキュメントで設定の参照順序を確認し、そのアプリに実際に適用される項目を変更してください。
システム画面のプロキシ値がすぐに書き戻される場合は、管理ポリシー、別のプロキシアプリ、ブラウザー拡張機能が同時に設定を管理していないか確認します。重複して通信を制御していると確認できたアプリだけを終了し、端末管理者の指示に従って管理対象の設定を維持したうえで、自動設定を1回実行してください。問題がシステムプロキシの適用範囲にあるか確認するために、すぐに仮想NICモードを同時に有効にしないでください。方式を切り替えるときは、先に現在の方式を無効にし、システム設定が基準状態に戻ったことを確認します。仮想NICが対象アプリの通信を制御できるかどうかは、ルーティング、除外設定、権限にも左右されます。アプリ設定の誤りを手早く回避する方法として使わないでください。
終了後に残った設定を整理して再確認
クライアントを終了した後にWebページが開けなくなった場合は、システムやアプリが終了済みのローカル待ち受けを参照したままになっていないか確認します。クライアントを再起動できる場合は、まずクライアントの解除機能を使い、システム設定も確認します。起動できない場合は、トラブル対処前に記録したプロキシ設定をシステム上で復元してください。アプリ独自にアドレスを保存している場合もあります。システム設定を戻した後、それぞれの手動設定も元に戻します。普段プロキシを使わない端末では、システムが古いローカルポートを参照していないことを確認してください。組織のプロキシを普段から使う場合は、すべてのプロキシ欄を消去せず、組織から指定された設定へ戻してください。変更後は影響を受けるアプリを再起動し、古い接続を使い続けないようにします。
最後に2段階で確認します。クライアントを起動した状態で、対象のリクエストが想定どおりの入口を通ることを確認します。次にクライアントを通常終了し、直接接続できるはずのリソースへ引き続きアクセスできるか確認します。スリープ解除やネットワーク切り替えのたびに再発する場合は、それぞれの前後で現在のネットワークサービス、システムプロキシの値、ローカル待ち受けの状態を記録し、最初に変化する項目を特定します。アイコン表示と実際の接続が一致しない場合は、システム設定とリクエスト記録を基準にしてください。特定のアプリだけで再発する場合はそのアプリの設定を確認し、例外的な1件のためにシステムネットワーク全体をリセットしないでください。
クライアントがクラッシュする:画面とコアの終了を切り分ける
終了が発生する段階を特定
まず、アイコンをクリックしても画面が一度も表示されない、画面が表示された直後に終了する、画面は正常だがコア起動後に終了する、の3つに分けます。最初の2つはシステムのアプリイベントとクライアントの起動ログを優先して調べ、最後のケースはコアのログを確認します。起動エラーが出たら発生時刻を記録し、その起動時に最初に現れたエラーを保存してください。後続するエラーの多くは最初の失敗に続いて発生しています。特定の画面を開いたとき、特定のグループを読み込んだとき、特定のノードに切り替えたときに必ずクラッシュする場合は、操作内容と再現頻度を記録します。連続して再起動する前に記録してください。最初に役立つログを見つけにくくなることがあります。
画面が表示されない場合でも、必ずしもクラッシュとは限りません。トレイに最小化されていないか、プロセスが動作中か、すでに起動している別のインスタンスを起動していないか確認します。クリック後すぐにプロセスが終了する場合は、システムが実行を拒否していないか、エラーがランタイム依存関係、プロセッサーアーキテクチャ、作業ディレクトリ、読み書き権限のどれを示しているか確認します。アプリランチャーやデスクトップのショートカットから起動している場合は、参照先が現在のインストール場所か確認してください。システムのセキュリティポリシーや端末管理上の制限が疑われる場合は、端末のルールに従って管理者に確認し、セキュリティ機能を無効にしてテストしないでください。クライアントを起動できずプロキシ設定が残っている場合は、トラブル対処を続ける前にシステムのプロキシ設定を元に戻します。
最初のエラーに沿ってインストール・ポート・設定を確認
エラーがアーキテクチャや起動時の依存関係を示している場合は、インストーラーとシステムの組み合わせを確認します。デスクトップ版ではまずv2rayNを選んでください。ダウンロードセンターでは、プラットフォーム、デスクトップ版、旧式インターフェース、プロセッサーアーキテクチャ、パッケージ形式を分けて案内しています。Windowsでは異なるインターフェースのプログラムファイルを混在させないでください。macOSではApple SiliconとIntelのどちらかを確認します。Linuxではディストリビューションのパッケージ形式とプロセッサーアーキテクチャの両方を確認してください。クライアントが複数ある場合は、意図した場所から起動し、新しいプログラムが別の古いディレクトリのファイルを読み込まないようにします。データディレクトリへの書き込みエラーがある場合は、現在のアカウントとファイルの所有者を確認します。権限設定の問題を隠すために、常時管理者権限で実行しないでください。
クライアントの画面は動作していてコアが終了する場合は、終了前にファイル読み込み、設定検証、ポートのバインド、ネットワーク初期化のどの段階で失敗したかを特定します。バインドに失敗した場合はローカル待ち受けの手順で確認してください。読み込みに失敗した場合はパス、ファイルの有無、現在のアカウントのアクセス権を調べます。手動設定の読み込みで項目エラーが出た場合は、選択中のコアを確認してから、エラー行付近の括弧、引用符、項目名の大文字・小文字、重複項目を調べます。以下はXray設定のトップレベルのログ項目の一部で、既存ファイルとの照合用です。単独では接続可能な設定ではありません。統合時に同名のトップレベル項目を重複して追加しないでください。
{
"log": {
"loglevel": "warning"
}
}
まず最小構成で再現し、その後に設定を段階的に戻す
設定の破損が疑われる場合は、まずクライアントを完全に終了し、本機の設定データをバックアップして、元のファイル位置を記録します。クライアントが対応している一時設定または独立インスタンスでのテストを優先してください。その方法がない場合は、データディレクトリが現在のクライアント専用であることを確認してから、古いディレクトリを一時的に別の場所へ移動し、プログラムを初期化します。バックアップしていないデータを削除したり、別のアプリのファイルも同時に移動したりしないでください。最小構成で起動できた場合は、一度に一種類ずつ設定を戻します。まずノードを1つテストし、その後でサブスクリプション、ルーティング、起動時の設定を復元します。ある設定を戻した後に再び終了する場合は、その設定を元に戻して範囲を絞ります。動作するほかの設定まで消去する必要はありません。
空の設定でも終了する場合は、システム環境、インストーラーの種類、再現手順、最初のエラーを記録し、プラットフォームに合ったインストーラーへの変更や、端末管理者による権限確認が必要か判断します。修復後は通常のユーザーアカウントで起動し、通常終了と再起動を確認してから、問題を起こした操作をもう一度試します。インバウンド、アウトバウンド、ルーティング項目の相互参照を確認したい場合はV2Ray設定ファイルの構造を参照できます。ただし、解説記事のサンプルを既存の動作中の設定にそのまま上書きしないでください。
Androidのトラブル:権限・アプリの対象範囲・バックグラウンド接続
まずVPN接続をシステムが許可しているか確認
Androidではまずv2rayNGを使用します。V2Flyコアの設定との互換性が必要な場合は、用途に応じてv2flyNGを選択してください。初回接続時にシステムのVPN許可ダイアログが表示されるか確認します。許可しなかった場合やダイアログを閉じた場合、クライアントではノードが選択されたままでもシステム側で接続が確立していないことがあります。クライアントで接続を開始し直し、システムのVPN設定に現在のアプリが表示されるか確認してください。同じユーザー環境やプロファイルで別のアプリがVPNを使用している場合は、一時的に停止できるか確認します。管理対象端末では強制接続ポリシーを無効にせず、管理者に許可範囲を確認してください。クライアントに実行中と表示されていても、システムの状態確認の代わりにはなりません。
同じサブスクリプションがデスクトップで使えるのにスマートフォンで接続できない場合は、スマートフォンとデスクトップを同じWi-Fiに接続し、同じノードと同じ公開テスト先を使います。スマートフォンで選択した項目が更新後のものか、ノードのプロトコルとトランスポート設定に対応しているか確認してください。デスクトップで動作するのは、異なるコア、ルーティング、更新方式を使っているためかもしれません。必ずしもスマートフォンのインストールパッケージに問題があるとは限りません。アプリの画面も起動できない場合はAndroidのダウンロードガイドでプロセッサーアーキテクチャを確認してください。起動はできてもリクエストが失敗する場合は接続ログを優先して確認し、診断のために再インストールを繰り返さないでください。
一部のアプリだけ失敗する場合は通信制御の範囲を確認
ブラウザーではアクセスできるのに特定のアプリだけ失敗する場合は、アプリごとのプロキシ設定が有効か確認します。現在のモードが選択したアプリだけを制御するのか、選択したアプリを除外するのかを確認してください。同じリストでもモードによって適用範囲が異なります。端末によっては個人用プロファイルと仕事用プロファイルに同じアプリが別々に存在し、片方を選んでももう片方は自動的に選択されません。リストを変更する場合は元の例外を記録し、端末のポリシーに従ってテストするアプリだけを変更します。保存後、クライアントの指示に従って接続を確立し直し、そのアプリを開いて確認してください。同期や認証の通信先を変えてしまわないよう、関係のないアプリをすべてテスト対象に追加しないでください。
プロキシを有効にするとすべてのアプリがオフラインになる場合は、現在のネットワークからテスト先へアクセスできるか確認し、ノードの名前解決、接続、ハンドシェイクのエラーがクライアントのログにないか確認します。AndroidのプライベートDNS設定はクライアントの名前解決方針と同時に適用されることがあります。また、通信経路の違いによって一部のアプリだけに影響する場合もあります。まず現在の設定を記録し、端末管理ポリシーの対象か確認してください。プライベートDNSを無効にすることを一般的な解決策にしないでください。Wi-Fiとモバイルデータの切り替え時だけ失敗する場合は、切り替え先のネットワークが実際に利用可能になってから再接続します。切り替え前後のログを残し、ネットワーク制御が再確立されなかったのか、新しいネットワークでノード接続に失敗したのかを見分けてください。
画面ロック後の切断とネットワーク切り替えの異常を再テスト
画面が点灯している間は安定し、ロックしてしばらくすると切断する場合は、切断時もシステムにVPNが表示されているか、クライアントの通知が残っているか、画面を点灯させると手動操作なしで復旧するかを確認します。通知が表示されない原因は通知権限の場合もあるため、システムの接続状態と併せて判断してください。システム上のVPN接続が維持されているのにリクエストが失敗する場合は、ネットワークのスリープ、接続先の切り替え、ノードの障害を優先して調べます。システム上の接続も切れている場合は、そのアプリのバックグラウンド実行制限を確認します。システムが許可している場合に限り、このアプリのバッテリー設定やバックグラウンド権限だけを変更し、問題が起きたときと同じロック時間で再テストしてください。端末全体の省電力機能を無効にする必要はありません。
常時接続VPNとVPN以外の接続をブロックする設定を有効にしている場合、接続の再確立中に端末全体がオフラインになることがあります。まずシステムに登録されたアプリが、現在使用しているクライアントか確認します。別のクライアントへ切り替える前に、このポリシーを変更してよいか確認してください。再テストでは画面ロックとネットワーク切り替えを別々に行い、同じテストに混在させないでください。問題が解消した後は必要なバックグラウンド権限を残し、一時的なテスト設定を元に戻します。クライアント選びに迷う場合はクライアント比較ガイドを、インストールや日常設定に関する短い質問はよくある質問を参照してください。