// TROUBLESHOOTING INDEX
V2Ray よくある質問とトラブルシューティング
基礎知識、インストールと設定、使い方、トラブルシューティングの順に整理しています。問題がクライアント画面、カーネルの起動、端末のネットワーク、リモートノードのどこで起きているかを判断し、設定を1つずつ変更してください。
// 01 · BASICS
基礎知識
まずクライアント、カーネル、サブスクリプション、プロキシモードを区別しましょう。概念を整理すると、インストールやログの確認をスムーズに進められます。
v2rayN、v2rayNG、v2flyNGはどう選ぶ？
Windows、macOS、Linuxのデスクトップ環境では、サーバー一覧、サブスクリプショングループ、システムプロキシ、ルーティング、TUNなどをまとめて操作できるv2rayNが適しています。Androidでは通常、Xrayカーネルを採用したv2rayNGを選びます。V2Flyカーネルのエコシステムを使う場合はv2flyNGを選択します。3つは設定画面が異なり、サブスクリプションを読み込めるかどうかは、サーバー側が提供するプロトコルとフィールドに左右されます。
V2Ray、V2Fly、Xrayとグラフィカルクライアントの関係は？
V2Rayは一般に、Project Vから発展したプロトコルとツールのエコシステムを指します。V2FlyとXrayは代表的なカーネル系統で、接続、転送、ルーティング、DNSなどの基盤処理を担います。v2rayN、v2rayNG、v2flyNGはグラフィカルクライアントに分類され、設定の保存、カーネルの呼び出し、システムプロキシなどの操作画面を提供します。トラブルの切り分けでは、画面設定、カーネルの起動、リモートノードの3層を区別してください。
サブスクリプションURLと個別の共有リンクの違いは？
サブスクリプションURLは通常、複数のサーバー設定を返し、クライアントでグループごとに保存して定期的に更新できます。個別の共有リンクは1つのノードだけを記述し、アドレス、ポート、識別子、転送方式、セキュリティ設定などが含まれます。サブスクリプションの追加にはサブスクリプション管理画面を、個別リンクの追加にはクリップボードからの読み込みやスキャン機能を使います。入口を間違えると、一覧が空になったり、形式を認識できないというエラーが表示されたりします。
システムプロキシモードとTUNモードの違いは？
システムプロキシは、OSのプロキシ設定を通じて、プロキシに対応したアプリの通信をクライアントへ渡します。設定が簡単で、ブラウザーやシステムプロキシに従うデスクトップアプリに適しています。TUNモードは仮想ネットワークインターフェースを作成し、OSのプロキシ設定を参照しないアプリも幅広く処理できますが、追加の権限が必要で、端末のファイアウォール、仮想NIC、DNS設定の影響も受けやすくなります。初回はまずシステムプロキシを確認し、必要に応じてTUNを有効にしてください。
// 02 · INSTALLATION
インストールと設定
インストール時はOS、プロセッサアーキテクチャ、アプリの権限、初回の読み込み手順を重点的に確認します。アプリの起動問題をノードの切り替えで解決しようとしないでください。
Windows版v2rayNのデスクトップ版と従来のWPF版はどう選ぶ？
デスクトップ版は新世代のクロスプラットフォームUIを採用しており、複数のデスクトップOSで似た操作感を求めるユーザーに適しています。従来のWPF版はWindows向けで、既存の解説に登場するメニュー構成に近い設計です。どちらでもサブスクリプション、サーバー選択、システムプロキシを設定できます。安定している既存設定を、画面が変わっただけで移行する必要はありません。新規インストールではまずデスクトップ版を試し、互換性の問題があればWPF版を検討してください。
macOSのインストーラーでApple SiliconとIntelはどう選ぶ？
システムの「このMacについて」を開き、チップまたはプロセッサの項目を確認します。Apple Mシリーズと表示される場合はApple Silicon、つまりarm64版を選択します。Intelプロセッサと表示される場合はx64版を選択してください。アーキテクチャを間違えると、アプリが起動しなかったり、追加の変換処理が必要になったりします。外観や購入年で判断するより、インストール前にチップの種類を確認するほうが確実です。
Android版のarm64とuniversalはどう選ぶ？
2015年以降に発売された主流のAndroidスマートフォンの多くはarm64を優先して選べます。インストーラーのサイズも通常は小さめです。プロセッサのアーキテクチャが不明、端末が古い、またはarm64のインストール時に互換性エラーが出る場合は、universal版を試してください。universal版はより多くのアーキテクチャに対応するためファイルサイズは大きくなりますが、クライアントの機能が増えるわけではありません。システムに表示される「64ビット」という名称だけで判断せず、実際のインストール結果を基準にしてください。
クライアントの初回起動をシステムにブロックされた場合は？
まずインストーラーが現在のOSとプロセッサアーキテクチャに合っているか確認し、システムのセキュリティ警告でブロック理由を確認します。Windowsではアプリ保護の警告を確認し、macOSでは「プライバシーとセキュリティ」で今回の起動を許可します。Linuxではパッケージ形式、ファイル権限、不足している依存関係を確認してください。起動がブロックされている段階ではカーネルはまだ動作していないため、ノードを次々に変更しても解決しません。
初めてサブスクリプションを追加する正しい順番は？
まず完全なサブスクリプションURLをコピーし、クライアントで新しいサブスクリプショングループを作成してURLを貼り付け、「サブスクリプションを更新」を実行します。サーバー一覧が表示されたら、使用するサーバーを選び、カーネルを起動してシステムプロキシを有効にします。最後にブラウザーで普段使うサイトを開き、接続を確認します。サブスクリプション名はローカル上のラベルにすぎず、更新には影響しません。欠落させてはいけないのはURL本体なので、コピー時に先頭、パラメーター、末尾の文字を欠かさないようにしてください。
インストール後にV2RayやXrayのカーネルを別途ダウンロードする必要はある？
通常は、クライアントのインストーラーに含まれる、またはクライアントが管理するカーネルを使えばよく、初回インストール時に別のカーネルファイルを追加する必要はありません。ログにカーネルが見つからない、起動できない、バージョンが対応していないと明記されている場合は、クライアントのカーネル設定と更新画面を確認してください。手動で配置する場合はOSとプロセッサアーキテクチャを合わせ、クライアント設定のカーネルパスと実際のファイル位置を一致させます。
// 03 · OPERATION
使い方
日常の操作は、サブスクリプションの更新、使用中のサーバー、プロキシモード、ルーティングルールが中心です。変更は毎回1つに絞ると、ログを比較しやすくなります。
サブスクリプションはどのくらいの頻度で更新する？
更新頻度はサブスクリプション提供元の変更ペースによって異なります。ノード情報が長期間安定しているなら、頻繁に更新する必要はありません。設定変更の通知を受けた、現在のノードが一斉に使えなくなった、または内容に変更があった場合は手動で更新してください。自動更新の間隔を短くしすぎると、リクエスト制限にかかる可能性があります。更新前に現在使えるサーバーを控え、更新後にグループや選択中のサーバーが置き換わっていないか確認しましょう。
使用するサーバーを選び、設定が使えるか確認するには？
まずサブスクリプションを更新し、サーバー一覧から1つを選んで使用中のサーバーにします。クライアントのテスト結果は選別の参考にすぎず、最終的にはカーネルを起動して実際に目的のサイトへアクセスしてください。テストに失敗したら、ログにある名前解決エラー、接続拒否、ハンドシェイク失敗、タイムアウトを確認します。名前や並び順だけで判断したり、プロトコル、ルーティング、DNS、プロキシモードを同時に変更したりすると、原因を特定しにくくなります。
グローバル、ルール、ダイレクトモードはどう使い分ける？
グローバルモードは、処理可能な通信を現在のサーバーへ送るため、ノードが動作するか一時的に確認するのに適しています。ルールモードはdomain、ip、geositeなどの条件に応じてプロキシまたは直接接続を選び、日常利用に向いています。ダイレクトモードはプロキシ経路を停止し、比較検証する際に使います。新しいサブスクリプションを設定したら、まずグローバルモードで接続を確認し、その後ルールモードに戻すとよいでしょう。切り替え後に違いが出た場合は、ルールの順序と最後のフォールバックルールを確認してください。
カスタムルーティングルールが適用されないのはなぜ？
まずルールの種類と内容が一致しているか確認します。たとえばドメインはdomain条件、アドレス範囲はip条件に入れ、組み込みカテゴリには正しいgeosite名を使います。多くのルーターは上から順に照合するため、前方の広いルールが先に通信を取得することがあります。変更後はクライアントに設定を再読み込みさせ、ログで実際の対象ドメイン、名前解決結果、適用されたアウトバウンドを確認してください。ルールだけ変更してカーネルを再起動しないと、古い設定が使われ続けることがあります。
OS起動時の自動起動と自動接続を設定するには？
OS起動時の自動起動、カーネルの起動、システムプロキシの有効化は別々の操作です。まずクライアント設定でOS起動時の自動起動を有効にし、起動時に前回のサーバーを読み込む設定を確認します。そのうえで必要に応じて、起動後にシステムプロキシを設定する項目を有効にしてください。初回設定後は一度再起動し、クライアントとカーネルが動作しているか、システムプロキシが設定されているか確認します。トレイアイコンが表示されただけでは、プロキシ経路が有効とは限りません。
// 04 · DIAGNOSIS
トラブルシューティング
再現できる最初のエラーから確認します。サブスクリプションのリクエスト、設定の解析、カーネルの起動、ノード接続、DNS、ルーティング、アプリへの適用を順番に調べてください。
サブスクリプションURLを追加したのにサーバーが表示されないのはなぜ？
まずサブスクリプション管理画面を使っていることを確認し、手動更新を1回実行します。それでも一覧が空なら、URLが完全か、余分な空白がないか、期限切れでないか、クライアントログにHTTPステータスや解析エラーがないかを確認してください。ブラウザーでURLを開けても、クライアントが解析できるとは限りません。内容が対応するサブスクリプション形式に準拠している必要があります。別のグループに読み込まれていないか、フィルターで非表示になっていないかも確認しましょう。
サブスクリプションの更新失敗やネットワークエラーを調べるには？
まず現在のネットワークからサブスクリプションURLへアクセスできるか確認し、次にクライアントで更新時のプロキシ方式が設定されているか調べます。現在のサーバーが使えない状態でプロキシ経由の更新を行うと、依存関係の循環が起きることがあります。その場合は一時的にダイレクト接続で更新してください。ダイレクト接続でもアクセスできないときは、利用可能なサーバーを選んで再試行します。システム時刻、URLパラメーター、リクエスト制限、ログにある証明書やDNSのエラーも確認してください。
ノードテストが何度もタイムアウトするときに確認することは？
まず同じサブスクリプション内の別のノードへ切り替え、1つのノードだけの障害か、設定全体の問題かを判断します。すべてがタイムアウトする場合は、端末のネットワーク、システム時刻、ファイアウォール、DNS、カーネルの起動ログを確認します。一部のノードだけなら、リモート側の状態、ポート、転送パラメーター、回線が原因であることが多いです。テストツール自体が特定の宛先を使う場合もあるため、実際のウェブアクセスと接続ログを併せて判断してください。
クライアントは接続済みなのにブラウザーでインターネットに接続できない場合は？
使用中のサーバー、カーネルの稼働状態、システムプロキシのスイッチ、ブラウザーが参照するプロキシ設定を順に確認します。まずグローバルモードで比較テストを行い、ログにDNS失敗、ダイレクト接続へのルーティング、接続拒否、ハンドシェイクエラーがないか確認してください。ブラウザーに個別のプロキシ拡張機能を入れていると、システム設定を迂回することがあります。一時的に無効にして再試行し、変更後はブラウザーをいったん終了して再起動し、古いセッションの再利用を避けます。
システムプロキシを有効にしても一部のアプリで機能しない場合は？
アプリによってはOSのプロキシ設定を参照しなかったり、特定のプロキシ方式にしか対応していなかったりするため、システムプロキシを有効にしても直接接続されることがあります。まずブラウザーなど標準アプリが正常に使えるか確認し、次に対象アプリに個別のプロキシ設定がないか調べてください。より多くのアプリを処理する必要がある場合はTUNモードを検討できますが、先に現在のネットワーク設定を記録しておきます。企業ネットワーク、セキュリティソフト、別のプロキシツールがシステムプロキシを上書きすることもあるため、切り分け時は制御元を1つに絞ってください。
TUNモードで権限不足や起動失敗が表示された場合は？
TUNは仮想ネットワークインターフェースの作成または管理を必要とします。デスクトップOSではクライアントの案内に従って管理者権限やネットワーク拡張の権限を付与し、AndroidではシステムのVPN接続許可を確認してください。それでも失敗する場合は、別の仮想NIC、プロキシツール、セキュリティソフトが関連機能を使用していないか調べ、ログにあるドライバー、インターフェース名、ルート追加エラーを確認します。他のネットワークツールを終了してからクライアントを再起動するほうが、ノードを何度も切り替えるより効果的です。
// RELATED DOCUMENTS
設定手順を続けて確認する
サブスクリプションの追加から始める場合は利用ガイドを、プロキシモード、ルーティング、TUN、日常のメンテナンスを理解したい場合は総合ガイドをご覧ください。