ヘルプセンター

V2Ray よくある質問とクライアントのトラブルシューティング

サブスクリプションのインポート、システムプロキシ、TUN 権限、接続ログの確認を取り上げます。まず問題が発生している段階を特定し、その後クライアントまたはコアの設定を調整してください。

基本知識

クライアント、コア、プロトコルの関係

各コンポーネントの役割を明確にしてから、問題が画面上の管理、コアの動作、サーバー側のパラメータのどこで発生しているかを判断します。

V2Ray、Xray コア、GUI クライアントの違いとは?

V2Ray は一般に、Project V から発展したプロトコルとツールのエコシステムを指し、V2Fly と Xray はその代表的なコアファミリーです。コアはプロトコル接続、ルーティング、トラフィック転送を担当し、v2rayN、v2rayNG、v2flyNG などの GUI クライアントはサブスクリプション管理、パラメータ入力、システムプロキシの切り替えを担います。問題を切り分ける際は画面操作とコアの動作を分けて考えます。リスト表示の異常はまずクライアントを確認し、接続確立に失敗する場合はコアのログとノードパラメータを確認してください。

v2rayN、v2rayNG、v2flyNG はどう選ぶ?

Windows、macOS、Linux のデスクトップ環境では、サブスクリプションのグループ管理、システムプロキシ、ルーティングルール、複数のコアを選べる v2rayN を優先できます。Android 端末では v2rayNG が利用でき、V2Fly 系のコアを使う場合は v2flyNG も候補になります。クライアントを選ぶときは、まず OS を確認し、サブスクリプションに含まれるプロトコルが現在のコアでサポートされているか確認してください。画面上の名称だけで互換性を判断しないことが大切です。

サブスクリプション、ノード、設定ファイルの関係とは?

サブスクリプション URL は、サービス提供者が管理する設定一式への入口です。クライアントがサブスクリプションを更新すると、含まれるサーバー設定が指定したグループに書き込まれ、選択可能な各サーバー設定は通常ノードと呼ばれます。設定ファイルはクライアントやコアが読み込める完全なパラメータ一式で、サーバー情報のほか、ルーティング、DNS、ローカル受け入れ設定などを含む場合があります。サブスクリプショングループを削除すると、そのグループ内のノードも削除される可能性があるため、操作前に対象範囲を確認してください。

VMess、VLESS、Trojan、REALITY は何を基準に選ぶ?

プロトコルは、サーバー側で提供されるパラメータ、クライアントのコアが対応する範囲、設定の完全性を基準に選びます。VMess は比較的早期に成立した Project V のプロトコルで、VLESS は認証とトランスポート設定を分けて扱います。Trojan は別の接続・認証構造を使用し、REALITY は通常、VLESS などと組み合わせるセキュリティレイヤーとして使われます。クライアントのプロトコル種別はサーバー側と一致させ、アドレス、ポート、ユーザー識別子、トランスポート方式、セキュリティ設定も一つずつ対応させてください。

インストールと設定

インストールパッケージ、サブスクリプション、初期設定

インストール時は、システムアーキテクチャ、クライアントのバージョン、サブスクリプション URL の完全性、更新時に使うネットワーク経路を重点的に確認します。

Windows の v2rayN Desktop 版と従来の WPF 版はどう選ぶ?

Desktop 版は新世代のクロスプラットフォーム UI を採用し、統一されたデスクトップ操作を使いたいユーザーに適しています。従来の WPF 版は、昔ながらの Windows UI と既存の操作手順を維持しています。初めてインストールする場合は Desktop 版から試せます。WPF の操作に慣れている場合や旧版の手順を引き継ぎたい場合は従来版を選んでください。バージョンを切り替える前に重要な設定をエクスポートし、2 つのバージョンが同時にシステムプロキシを制御したり、同じローカル待受ポートを使用したりしないようにしてください。

Android のインストールパッケージは arm64 と universal のどちらを選ぶ?

2015 年以降に発売された主要な Android スマートフォンは、通常 64 ビット ARM プロセッサを搭載しています。そのため、対象アーキテクチャ向けに容量を抑えやすい arm64 パッケージを優先できます。プロセッサのアーキテクチャを確認できない場合、端末が古い場合、または arm64 パッケージが非対応と表示される場合は、universal 版を選んでください。universal 版はより広いアーキテクチャに対応しますが、クライアントの機能、サブスクリプション形式、プロトコル対応が変わるわけではありません。最終的な互換性は端末のシステムとパッケージの要件によって決まります。

サブスクリプション URL をコピーしてもクライアントにインポートできない場合は?

まず、コピーしたものが完全なサブスクリプション URL であり、Web ページの URL、単一ノードの説明、余分な空白を含むテキストではないことを確認します。次にクライアントでサブスクリプショングループを作成し、URL 欄に貼り付けて保存してから、サブスクリプションを更新します。形式エラーが表示される場合は、ブラウザーで URL がサービス提供者から正常に応答されるか確認し、ログインや URL の再発行が必要でないか調べてください。URL の大文字・小文字、パス、クエリパラメータは手動で書き換えないでください。

サブスクリプションの更新に失敗する、またはタイムアウトが続く場合は?

まず端末の現在のネットワークからサブスクリプションサービスに正常にアクセスできるか確認し、次に URL の期限切れ、途中での欠落、二重エスケープがないか調べます。v2rayN の更新では、プロキシ経由とプロキシなしの両方を試せますが、前者は既存のプロキシ接続が利用できる場合に限り適しています。複数のネットワーク環境で失敗する場合は、サブスクリプション提供者にサービス状態を確認してください。更新前にシステム時刻が正確か確認し、ローカルのファイアウォールがクライアントの通信を遮断しないようにします。

使い方のコツ

プロキシ制御、TUN、ルーティングモード

ノードは接続を確立し、システムプロキシまたは TUN は通信を取り込み、ルーティングルールは各リクエストの出口を決定します。

v2rayN のシステムプロキシにはどんな役割がある?

システムプロキシを有効にすると、プロキシアドレスが OS のネットワーク設定に書き込まれ、システムプロキシに従うブラウザーやデスクトップアプリが v2rayN のローカル待受ポートへリクエストを送るようになります。ただし、すべてのプログラムの通信が制御されるわけではありません。システムプロキシを無視したり、独自のネットワークスタックを使用したりするアプリもあります。有効にする前に利用可能なノードを選択してコアを起動し、クライアントを終了する前にシステムプロキシを元に戻してください。停止した待受先が OS に残るのを防げます。

TUN モードに追加の権限が必要なのはなぜ?

TUN モードでは仮想ネットワークインターフェースを作成し、システムルーティングを変更するため、通常は管理者権限、VPN の許可、またはシステムネットワーク拡張の許可が必要です。権限が拒否されると、クライアント画面ではノードが選択済みでも、仮想インターフェースが正常に作成されないことがあります。まず同種のインターフェースを使用している他のネットワークツールを終了し、システムの指示に従って権限を付与してください。ファイアウォールがコアの通信を許可していることも確認します。デスクトップ環境では、仮想インターフェースのドライバーやネットワーク拡張が正しく読み込まれているかも確認してください。

中国本土バイパス、ブラックリスト、ホワイトリストのルーティングモードの違いは?

中国本土バイパスは、通常、あらかじめ定義されたドメインと IP ルールに従い、中国本土でよく使われるネットワークリソースへ直接接続し、それ以外の一致する通信をプロキシ経由にします。ブラックリスト方式は原則として直接接続し、ルールに一致した宛先だけをプロキシ経由にします。ホワイトリスト方式は原則としてプロキシを使用し、明示的に列挙した宛先だけを直接接続します。モード名だけでは実際のルール内容を判断できません。選択後はルールの順序、デフォルトの出口、DNS 設定を確認し、いくつかの明確な宛先で振り分け結果を検証してください。

現在の接続が想定どおり動作しているか確認するには?

まずクライアントのステータスバーにコアの起動済み表示があるか確認し、ログを開いて接続拒否、認証失敗、DNS エラーが継続していないか調べます。次に、直接接続する予定の宛先とプロキシを使う予定の宛先へそれぞれアクセスし、両方のリクエストが完了するか確認します。システムプロキシを使う場合は、OS のプロキシアドレスとクライアントのローカルポートが一致しているか確認します。TUN を使う場合は仮想インターフェースの存在を確認してください。検証は実際に使用するアプリを対象に行い、単一のブラウザページだけで判断しないでください。

トラブルシューティング

タイムアウト、アクセス不能、コアの終了

ログに記録された最初の明確なエラーから始め、ノードパラメータ、ローカルポート、プロキシ制御、ネットワーク環境を順に切り分けます。

ノードの接続タイムアウトはどの順番で切り分ける?

まず同じサブスクリプショングループ内の別のノードに切り替え、問題が単一ノードに限られるのか、ネットワーク環境全体に及ぶのかを確認します。すべてがタイムアウトする場合は、ローカルネットワーク、システム時刻、ファイアウォール、コアの起動状態を確認します。1 つのノードだけがタイムアウトする場合は、アドレス、ポート、プロトコル、トランスポート方式、セキュリティパラメータを再確認してください。Wi-Fi とモバイルネットワークを切り替えて比較する方法もあります。ログの timeout は通常、規定時間内に接続が完了しなかったことを示すだけなので、前後の記録と合わせて DNS、トランスポート層、サーバー応答のどこで止まったかを特定します。

クライアントは接続済みなのに Web ページを開けない場合は?

接続済みという表示は、クライアントが動作状態に入ったことを示すだけで、すべてのリクエストの転送に成功したことを意味しません。まずログで DNS 解決失敗、ルーティング先の欠如、リモートハンドシェイクエラーがないか確認し、現在のノードが実際にアクティブな設定として指定されているか調べます。システムプロキシを使う場合はプロキシの有効化状態とローカル待受ポートを、TUN を使う場合は権限とデフォルトルートを確認してください。一部の Web サイトだけ開けない場合は、クライアントを何度も再インストールするのではなく、ルーティングルール、DNS の振り分け、ドメイン一致の順序を重点的に確認します。

システムプロキシを有効にしてもアプリが直接接続する場合は?

まず OS のネットワーク設定でプロキシアドレスが書き込まれていることを確認し、v2rayN の現在のローカル待受アドレスとポートが一致しているか調べます。起動時に一度だけプロキシ設定を読み込むアプリもあり、切り替え後に完全終了して再起動する必要があります。独自のプロキシ設定を持つアプリは、アプリ内で個別に設定してください。システムプロキシを読み取らないプログラムも制御したい場合は TUN モードを検討できますが、有効化前に権限、ルーティングの競合、DNS 設定を確認します。

コアを起動できない、または起動直後に終了する場合は?

まずクライアントのログを開き、最後の終了メッセージだけでなく、最初に現れる明確なエラーを特定します。よくある原因は、ローカルポートの競合、現在のコアと互換性のない設定項目、実行できないコアファイル、ディレクトリ権限の不足、セキュリティソフトによるプロセス起動の阻止です。空いているローカルポートに変更し、クライアントが生成した基本設定でテストしてください。Xray と V2Fly のコアを切り替えた場合は、選択したプロトコルと設定項目が対応するコアのサポート範囲に含まれることも確認します。