V2Rayのヘルプセンター

V2Rayのよくある質問

サブスクリプションを追加できない、ノードがタイムアウトする、システムプロキシが機能しない。まず問題がどの段階で起きているかを確認し、変更する設定を見極めましょう。

確認の流れ · 設定から通信の出力先まで
  1. 設定のインポート
  2. アプリの接続
  3. ルーティングと出力先

基礎知識

クライアント、コア、ノード、通信の接続方式の違いを整理します。

V2Ray、v2rayN、v2rayNGの違いは?

V2Rayは、Project Vから発展したプロキシ技術のエコシステムを指す場合と、関連するコアを指す場合があります。v2rayNはデスクトップ向けのGUIクライアント、v2rayNGはAndroid向けのGUIクライアントです。クライアントは設定の追加・管理、ノードの選択、接続方式の切り替えを担当し、コアはプロトコルに従った接続とルーティングを担います。チュートリアルを読むときは、クライアント名と対象プラットフォームを確認しましょう。ログを調べる際は、画面上の操作に失敗したのか、コアの起動に失敗したのか、接続後にリモート側から応答がないのかを切り分けます。コアのパラメーターエラーは、クライアント名だけでは互換性を判断できません。実際に選択されているコアも確認してください。

サブスクリプションURLとノード単体の共有リンクは、同じ方法で追加できますか?

同じ方法で入力しないでください。サブスクリプションURLは通常HTTPSで始まり、クライアントがURLにアクセスして、返された内容をノード一覧として解析します。一方、ノード単体の共有リンクはvmess://、vless://、trojan://などで始まり、接続に必要なパラメーターが含まれています。前者はサブスクリプショングループに追加して更新し、後者はクリップボードからノードをインポートする機能を使います。管理ページのURLはブラウザーで開けても、クライアントが解析できる形式でデータを返すとは限りません。サブスクリプションURLや共有リンクには認証情報が含まれる場合があるため、問い合わせの際にそのまま貼り付けないでください。

システムプロキシ、TUN、グローバルルーティングは同じものですか?

それぞれ役割が異なります。システムプロキシは、システム設定を参照するアプリにローカルプロキシのアドレスを知らせます。TUNは仮想ネットワークインターフェースを使い、ルーティング対象の範囲にある通信を取り込みます。グローバルルーティングは、すでにコアに届いた通信の出力先を選択します。ルーティングをグローバルに切り替えただけでは、システムプロキシを使わないアプリは接続されません。ブラウザーでは使えるのにターミナルでは使えない場合、ノードを変更する前に、ターミナルがシステム設定または独自のプロキシ設定を参照しているか確認しましょう。反対に、LAN内の端末が接続できない場合は、通信がどのようにクライアントへ届き、どのルールに一致したかを確認します。

VMess、VLESS、Trojanはクライアント上で簡単に切り替えられますか?

クライアントのプロトコル選択欄を変更するだけでは切り替えられません。ノードのアドレス、ポート、認証パラメーター、トランスポート方式、安全性の設定は、サーバー側の設定と一致している必要があります。インポート後に認証エラーやハンドシェイクエラーがログに出たら、提供元の設定と照らし合わせ、プロトコル名、サーバー名、トランスポートの選択肢が変更されていないか確認してください。そのうえで、選択中のコアが該当パラメーターに対応しているかを確認します。複数のノードで同じドメインを使っていても、ポートやほかの設定は異なる場合があります。アドレスだけで判断しないでください。変更前の項目は残し、複製した設定で一つずつ比較すると、どこに問題があるか特定しやすくなります。

インストールと設定

インストールパッケージの選択から、初回インポート、TUNの許可設定までを案内します。

ダウンロードセンターを見る
Androidのインストールパッケージはarm64とuniversalのどちらを選ぶ?

まず、端末のOSが実際に対応しているアプリのアーキテクチャを確認します。メーカーの情報や端末情報にarm64-v8aと明記されている場合は、arm64を選ぶのがおすすめです。対応アーキテクチャが分からない場合は、universal版に含まれるアーキテクチャを確認し、端末が対応しているものが含まれていることを確かめてからインストールしてください。CPUが64ビット対応でも、OSが64ビットアプリのインストールを許可しているとは限りません。universal版は複数のアーキテクチャ向けのコンポーネントを含むため、ファイルサイズが大きくなることがあります。それでもインストールできない場合は、OSのバージョン要件、空き容量、同名で署名の異なるアプリがすでにインストールされていないかを確認します。上書きインストールで競合した場合は、設定をバックアップしてから対処し、すぐに既存のクライアントをアンインストールしないでください。

Windows版v2rayNはデスクトップ版とWPF版のどちらを選ぶ?

初めてインストールする場合は、まずデスクトップ版を検討してください。ほかのデスクトッププラットフォームに近い画面構成です。従来のWindowsらしい画面に慣れている場合や、WPF版向けのチュートリアルを見ながら設定する場合は、WPF版を選べます。ダウンロード前に、システムのアーキテクチャと各バージョンの実行環境要件を確認してください。両方を試す場合は、起動中のバージョンを終了してからもう一方を起動し、ローカルの待ち受けポートの競合やシステムプロキシ設定の重複を防ぎます。設定を移行する前にサブスクリプションとカスタムルーティングをバックアップし、再起動後に選択中のノード、コア、ローカルの待ち受けポートが想定どおりか確認してください。

サブスクリプションURLを追加したのに、ノード一覧に表示されないのはなぜ?

URLを保存しただけではサブスクリプションの登録が作成されるだけです。続けて、そのグループを更新してください。まずURLが完全で、説明文や改行、余分な空白が混ざっていないことを確認し、更新ログを見ます。リクエストは成功しても解析エラーになる場合、ログインページやエラーメッセージ、クライアント非対応のサブスクリプション形式が返されている可能性があります。提供元に対応形式を確認してください。ログ上はインポート済みなのに表示されない場合は、一覧の検索語を消し、更新したグループに切り替えて、フィルターで非表示になっていないか確認します。試行錯誤のために同じ名前のグループを何度も作成すると、次回の更新先を間違えやすくなるため避けてください。

TUNを有効にすると権限不足と表示される場合、どこを確認すればよい?

デスクトップではまずコアのログを確認し、仮想インターフェースの作成が拒否されたのか、インターフェースは作成されたもののルートの設定に失敗したのかを切り分けます。使用中のクライアントとプラットフォームの説明に従い、サポートされている方法で必要な権限を付与してください。システム全体のディレクトリの権限は変更しないでください。Androidでは、システムのVPN接続許可を付与し、ほかのアプリがすでにVPN接続を使用していないか確認します。組織管理の端末で仮想インターフェースの作成が禁止されている場合は、管理者にポリシーを確認してください。ログにインターフェース用コンポーネントの不足が示されているなら、実行権限を何度も引き上げても解決しません。該当プラットフォームのインストール手順に戻り、必要なコンポーネントがそろっているか確認してください。

使い方のヒント

ルーティングの検証、サブスクリプションの整理、再現可能な不具合の記録方法を紹介します。

サブスクリプショングループとサーバーのフィルタリング
ルーティングルールは、どのルールが適用されたかどう確認すればよい?

同じドメインを固定してテストするなど、明確な対象を決めて比較します。まず編集中のルールセットがクライアントで有効か確認し、次にルールを上から順に見ていきます。通常は最初に一致したルールで出力先が決まり、範囲の広すぎるルールを前に置くと、後ろの例外ルールが適用されません。ログに出力タグが表示される場合は、今回のリクエストで実際に選ばれたタグが想定どおりか確認します。ドメインルールに一致しないときは、クライアントが受け取ったのがドメイン名か、すでに解決済みのIPアドレスかを確認し、現在のドメイン解決方式も見直してください。ルールは一度に一つだけ変更し、接続を再試行してから結果を確認します。

ノードを切り替えたら、システムプロキシも一度オフにして再度オンにする必要がありますか?

通常は不要です。システムプロキシはクライアントがローカルで待ち受けるアドレスとポートを参照し、ノードの切り替えで変わるのはコアが以降に使用する出力先です。まず新しいノードが選択中になっていることを確認し、新しいリクエストを送信してください。古い接続を使い続けているアプリでは変化が見えないことがあるため、該当するページやアプリを閉じてから試します。切り替え時にローカルの待ち受けポートも変わった場合は、システムプロキシやアプリ独自のプロキシ設定が古いポートを参照していないか確認してください。切り替え後にコアが起動しない場合は、システムプロキシを何度も切り替えるのではなく、まず起動ログを確認します。

複数のサブスクリプションを管理し、更新するグループを間違えない方法は?

提供元ごとに、短く見分けやすいグループ名を付けてください。サブスクリプションURLや認証情報をメモ欄に記載するのは避けましょう。初回更新はグループごとに実行し、ノードがどのグループに追加されるか確認してから、定期更新するグループを決めます。提供元が管理するサブスクリプションでは、手動変更したパラメーターをそのまま長期保存しないことをおすすめします。更新時に内容が置き換わる可能性があるためです。テスト用の設定を残す場合は、手動グループに別途保存してください。ノード名が同じでも設定が同じとは限りません。重複項目を削除する前に、プロトコル、アドレス、トランスポート方式を比較し、現在使用中の項目を削除しないよう確認してください。

不具合を報告する際、ログのスクリーンショットにはどの情報を残すべき?

まず、クライアントとコアのバージョン、OS、現在の接続方式、不具合発生直前に行った操作を記録します。次に、エラーのキーワードと前後数行が読める範囲だけをスクリーンショットに収めてください。解析失敗、接続拒否、接続タイムアウト、ハンドシェイク失敗など、エラーの種類は残し、サブスクリプションURL、共有リンク、ユーザー識別情報、公開したくないサーバーアドレスは隠します。再現できる場合は、影響範囲も明記してください。特定のノードだけかグループ全体か、ブラウザーだけか特定のアプリだけかを伝えると、画面全体のスクリーンショットを何度も貼るより、確認手順を絞り込みやすくなります。

トラブル対処

実際の症状から原因の範囲を絞り、接続ログを確認します。

ブラウザーとターミナルを分けて確認
ノードのテストがタイムアウトしたとき、ノード単体とローカルネットワークのどちらが原因か見分けるには?

同じ方法で、現在のノードと、正常に使えることが分かっている別のノードを比較します。一つのノードだけタイムアウトする場合は、まずアドレス、ポート、トランスポートのパラメーターを確認し、提供元にサービスの状態を問い合わせる方法もあります。すべてのノードが同時にタイムアウトする場合は、まずプロキシ接続を終了し、現在のネットワークが正常に使えることを確認してから、別の利用可能なネットワークでノードを再テストします。ログにドメイン解決失敗、接続タイムアウト、ハンドシェイクタイムアウトとある場合は、それぞれ名前解決、ネットワーク接続、接続パラメーターから調べてください。遅延テストはテスト先にも左右されるため、一度のタイムアウトだけでノードの無効を断定できません。実際のリクエストも送って比較しましょう。

クライアントは接続済みなのに、Webページが開かないのはなぜ?

クライアントが実行中と表示されても、コアが起動したことしか示していない場合があります。同じブラウザーで、通常どおり直接接続できるページと問題のあるページをそれぞれ開き、新しいリクエストがログに記録されるか確認します。リクエストがまったく記録されない場合は、ブラウザーがシステムプロキシまたはTUNを使っているか確認してください。記録がある場合は、出力タグとエラーの種類から、ルーティングの誤り、ドメイン解決の失敗、リモート接続の失敗を切り分けます。プロキシ接続を解除した状態で、直接接続できるはずのページも開けない場合は、まず基本のネットワーク接続を復旧します。調査中は接続方式を一つだけ有効にし、設定同士の干渉を避けてください。

v2rayNのシステムプロキシが効かない?ブラウザーとターミナルで挙動が異なる理由

ブラウザーはシステムプロキシを参照する場合もあれば、拡張機能や独自設定が優先される場合もあります。ターミナルのプログラムは独自の設定やプロキシ環境変数を参照することが多いため、ブラウザーでページを開けても、ターミナルが接続されているとは限りません。まずシステム設定で、現在設定されているローカルアドレスとポートを確認し、v2rayNでコアがそのポートを待ち受けているかを確認します。次に、ターミナルのプログラムが対応するプロキシの種類と適用範囲を確認してください。現在のセッションだけに適用される設定もあるため、起動済みのターミナルでは設定を再読み込みする必要があります。アプリをテストするたびにリクエストログを確認し、その通信がコアに届いているかを見ます。

これまで更新できていたサブスクリプションが失敗するようになりました。既存のノードは削除すべき?

まず既存の項目は残してください。サブスクリプションの更新失敗は、すでにインポートしたノードがすべて使えなくなったことを意味しません。更新結果を確認します。リクエストがタイムアウトした場合は、現在のネットワークからサブスクリプションサービスにアクセスできるかを確かめ、今回の更新でクライアントが直接接続したのか、既存のプロキシを使ったのかも確認してください。アクセス拒否が返された場合は、URLが変更されていないか、認証情報の期限が切れていないかを提供元に問い合わせます。内容はダウンロードできても解析できない場合は、サブスクリプション形式が変更されていないか確認します。新しいURLを入手したら、まず別のグループで検証してください。更新が成功し、新しい項目で接続できることを確認してから古いグループを整理すれば、比較に使えるノードを調査中に失わずに済みます。