読み始める / CONFIG
クライアントで設定を管理し、コアで接続を実行。システムプロキシが入口を決め、ルーティングルールが接続先を選びます。
V2Ray 公式ダウンロードでは、この流れに沿ってダウンロード先と使い方を案内しています。まず使用する端末に合ったクライアントを選び、サービス提供元から受け取ったサブスクリプションまたはサーバー設定を追加します。最後に、アプリの通信が実際にプロキシを経由しているか確認してください。ソフトをインストールしただけでは接続に必要なパラメーターは揃いません。画面上で起動中と表示されても、すべてのアプリがプロキシを使っているとは限りません。
上のエディターには、Xray設定構造の一部を表示しています。出站プロトコル、通信のセキュリティ、ルーティングルールの違いを確認するための例です。ドメイン名と識別子はフィールドを説明するためのもので、REALITYに必要なその他のパラメーターは省略しています。通常、GUIクライアントでは画面の設定からコア用の設定が生成されるため、この内容を設定ファイルにコピーする必要はありません。
よく使う6つの設定項目を、「設定元 → 通信の入口 → マッチングルール → 接続診断」の順に解説します。画面レイアウトによってメニュー名が多少異なる場合があります。設定フィールドは概念を理解するためのもので、すべてのコアで同じ書式が使われるわけではありません。
サブスクリプショングループ → グループ設定
サブスクリプションURLは、リモートの設定一覧を取得するための入口であり、単一のノードアドレスではありません。グループを追加してURLを入力し、保存して更新した後、一覧から使用するサーバーを選びます。グループを使うと設定元を分けて管理でき、更新間隔も個別に設定できます。共有リンクを1件ずつ貼り付ける方法とは異なり、サブスクリプションではサーバー一覧の追加や削除を同期できます。ただし、手動で編集した項目が更新時に上書きされる場合があります。更新に失敗したら、まずURLが有効か確認し、直結での更新とプロキシ経由での更新を比較してください。まだ使えないノードに依存した更新は避けましょう。
メイン画面またはトレイメニュー → システムプロキシ
システムプロキシを設定すると、クライアントはローカルの待ち受けアドレスをOSのプロキシ設定に登録します。ブラウザーなど、その設定を参照するアプリがローカルの入口にリクエストを渡すようになります。これはコアのルーティングにあるグローバルプロキシとは別の設定で、すべてのプログラムに自動適用されるわけではありません。初回接続では、まずシステムプロキシを使ってブラウザーで動作を確認しましょう。クライアントを終了する前にシステムプロキシを解除できます。ソフトを終了した後もブラウザーがローカルポートを参照していると、通常のWebページも開けなくなることがあります。その場合は、まずシステムのネットワーク設定を元に戻してください。
メイン画面 → TUNモードを有効化
TUNは仮想ネットワークインターフェースを通じてIP通信を処理するため、システムプロキシを参照しないアプリに適しています。デスクトップでは通常、必要な権限を求められます。通信を取り込む範囲はルーティング、除外設定、DNSの設定によって異なります。システムプロキシを高速化する機能ではなく、すべての接続がリモート経由になるとは限りません。有効にする前に通常のプロキシが使えることを確認し、ログとローカルネットワークへのアクセスをチェックしてください。他の仮想NIC、社内ネットワークツール、既存のVPNと競合する場合は、問題を切り分けるため、いずれか1つを停止して比較しましょう。
設定 → ルーティング設定 → プリセットルールセット
ルーティングルールでは、ドメイン、IP、ポートなどの条件に応じて、プロキシや直結といった出站を選択します。多くのルールは上から順に照合されるため、具体的な例外は範囲の広いルールより前に置きます。GeoSiteはドメインの集合、GeoIPはIPアドレスの集合で、用途が異なります。プリセットのルールセットを選んだら、モード名だけで判断せず、LAN、内部ドメイン、対象サイトの実際の接続先を確認してください。すべてを同じ出站に送る代わりに、ルーティングを使えばローカルサービスへの直結を維持できます。ルールファイルがない、またはタグが間違っている場合は、まずデータベースの参照を修正してください。
設定 → DNS設定
DNSはドメイン名をIPアドレスに変換します。名前解決のリクエストが通る経路と、Webページの通信経路は異なる場合があります。ブラウザーのセキュアDNS、OSのキャッシュ、コアのDNSが同じアクセスに関わることもあります。ドメインでは開けないのにIPアドレスなら接続できる場合は、まずどのDNSが名前解決を行っているか確認し、次に上流DNSへの到達性を調べてください。ルーティングのドメイン解決戦略によって、IPルールが照合されるかどうかも変わります。DNSアドレスを1つ変えただけで解決したと判断せず、同じドメインで再テストし、キャッシュの結果と新しい問い合わせを区別しましょう。
メイン画面 → ログ；設定 → パラメーター設定 → ログレベル
ログから、コアの起動、ドメインの名前解決、サーバーへの接続、プロトコルのハンドシェイクなど、どの段階で問題が起きたかを把握できます。失敗したアクセスの時刻を記録し、その前後のエラーを確認すると、ページ全体から「失敗」を検索するより原因を絞り込みやすくなります。接続拒否、タイムアウト、証明書名の不一致は別の問題であり、対処法も異なります。診断中は一時的にログの詳細度を上げ、再現後は通常のレベルに戻してください。ログを共有する前に、サブスクリプションURL、識別情報、非公開のサーバー情報を削除しましょう。ログは手掛かりとして使い、ブラウザーでの接続状況や使用中のサーバーの状態もあわせて確認してください。
初めて使うときは、ルーティングとDNSを初期設定のままにして、サブスクリプションを追加し、使用するサーバーを選びます。実際の接続テストで、そのサーバー経由のリクエストが成功することを確認してからシステムプロキシを設定し、ブラウザーでアクセスできるページを開いてください。この最短の接続経路が確認できてから、TUNの有効化、独自のルーティング設定、名前解決ポリシーの変更に進みます。そうしないと、未検証の設定が重なり、サーバー側とローカルネットワーク側のどちらに問題があるのか特定しにくくなります。
「グローバルプロキシ」は、設定されている場所によって意味が異なります。OSのグローバルプロキシは、アプリがローカルプロキシに通信を渡す方法を表すのが一般的です。一方、クライアントのルーティングにあるグローバルモードは、コアに入った通信の出站先を決めます。アプリが通信をクライアントに渡していなければ、ルーティングがグローバルでも通信は取り込まれません。逆に、アプリの通信がTUNに入っていても、直結ルールに一致する場合があります。プロキシが有効か判断するときは、状態アイコンだけでなく、入口と出站の両方を確認してください。
特定のサイトやアプリだけに問題がある場合、すぐにクライアントを再インストールする必要はありません。同じサーバーで別のページを開き、次に別のサーバー設定へ切り替えて比較します。その後、対象ドメインに適用されるルールとDNSの結果を確認してください。一度に変更する条件を1つにし、変更前後のログを残すと、「まったく接続できない」問題と「一部のルールだけが異常」な問題を分けて対処できます。詳しい手順はトラブルシューティング、フィールドの意味は用語集をご覧ください。
デスクトップではv2rayN、Androidではまずv2rayNGを確認してください。V2Fly向けの設定を使う場合は、v2flyNGも比較できます。以下のリンクから各プラットフォームのダウンロード項目に進めます。インストーラーのアーキテクチャ、システム要件、ファイルの説明はダウンロードページにまとめています。
v2rayNにはデスクトップ版と従来のWPF版があります。デスクトップ版はクロスプラットフォームのUIを採用し、WPF版は使い慣れたウィンドウやメニュー構成を維持しています。どちらも設定の管理とコアの起動に使えます。操作感やシステム要件に合わせて選び、同じサブスクリプションのために両方を同時に起動する必要はありません。
インストール前に、システムの「バージョン情報」でプロセッサのアーキテクチャを確認してください。初回起動後は、ローカルの待ち受けポートとシステムプロキシの状態を確認します。他のプロキシソフトを使用している場合は、ポートの競合やシステム設定の上書きを避けるため、終了してからテストしてください。TUNが必要な場合は、権限と仮想NICの設定を別途行います。
ダウンロードv2rayNのmacOS版は、Apple SiliconとIntelでインストーラーが分かれています。「このMacについて」でチップ情報を確認し、対応するアーキテクチャを選んでください。設定元は他のデスクトップ版と共通ですが、ネットワーク設定、起動権限、メニューの場所は現在のmacOSの画面に従って操作します。
サブスクリプションを追加したら、使用中のサーバーを確認し、現在のネットワークサービスにプロキシが設定されているか確認してください。ブラウザーは使えるのにターミナルのコマンドが直結する場合は、両者でプロキシの入口が異なる可能性があります。すぐにノードの問題と判断しないでください。Wi-Fiを切り替えた後も、ネットワーク環境が変わっていないか再確認しましょう。
ダウンロードv2rayNGはXrayコアを使用するAndroid向けの第一候補です。v2flyNGはV2Flyコアを使用し、対応する設定をすでに利用している場合に適しています。一般的な端末ではarm64を選びます。アーキテクチャがわからない場合は、汎用パッケージの説明を確認してください。プロトコルが利用できるかどうかはクライアントとコアの対応状況によって異なるため、共有リンクの名前だけでは判断できません。
初回接続時は、システムのVPN接続許可を確認してください。画面ロック後に接続が切れる場合は、サーバーを調べる前に、バッテリー最適化、バックグラウンド実行、ネットワーク切り替え時の動作を確認します。アプリごとのルーティング設定によって、通信を取り込む範囲も変わります。テスト時はブラウザーが除外リストに入っていないことを確認し、別のVPNサービスを同時に起動しないでください。
ダウンロードv2rayNのLinux版にはdeb形式とrpm形式があり、x64とarm64のアーキテクチャを選べます。ディストリビューションのパッケージ形式とプロセッサの種類を確認してから、適切なファイルを選んでください。GUIクライアントはデスクトップ環境で使用します。アプリがシステムプロキシを参照するかどうかは、デスクトップ環境とアプリ自体の実装にも左右されます。
デスクトップブラウザー、コマンドラインツール、バックグラウンドサービスでは、別々のプロキシ設定を使う場合があります。ブラウザーで接続できても、すべてのプロセスが通信を取り込まれているとは限りません。TUNを有効にする場合は、権限、システムルート、他の仮想ネットワークインターフェースを確認してください。LANへのアクセスに問題が起きたら、ノードを何度も切り替えるのではなく、除外するネットワークを調べましょう。
ダウンロードクライアントはローカルの設定管理、プロトコル処理、通信の転送を行いますが、リモートサーバーを自動で用意するものではありません。接続に必要なアドレス、ポート、認証情報、通信方式の設定は、サービス提供元から入手してください。サブスクリプションURLにはアクセス情報が含まれる場合があるため、機密情報として管理し、公開スクリーンショットや第三者のオンライン変換サービスに貼り付けないでください。端末を移行するときは、エクスポートする内容が単一のサーバー設定、サブスクリプションURL、クライアント全体の設定のどれかを確認しましょう。
すでに設定がある場合は、クライアントを更新したり別のプラットフォームに移行したりする前に、使用中のサーバー、ルーティングモード、ローカルポートを記録しておくことをおすすめします。復元可能な設定を保存しておけば、新しい環境との差を確認しやすくなります。プロトコルのフィールドを認識できない場合は、コアの対応状況と設定形式を照合してください。Project Vのエコシステムに属していても、各クライアントが互いの設定ファイル全体をそのまま読み込めるとは限りません。
オープンソースのエコシステムは、役割ごとに整理して理解する必要があります。プロジェクト名、実行コア、GUIクライアント、リモートサービスはそれぞれ役割が異なります。これらを混同すると、インストールや設定の判断を誤ることがあります。
設定画面 → コアで実行 → リモートサービス
Project VはV2Ray関連ツールを理解するうえでの背景となるプロジェクトです。V2FlyはV2Rayのコミュニティ開発を引き継ぎ、Xrayは関連技術を基盤に独自のコア開発を進めています。v2rayN、v2rayNG、v2flyNGはユーザー向けのGUIクライアントで、サブスクリプションやサーバーパラメーター、モードの選択をコアが実行できる設定に変換します。サーバー側のプロトコルは、クライアントで使用するコアの対応状況と一致している必要があります。
コアは、受信した通信にルーティングルールを適用し、出站の設定に従って接続を確立します。V2FlyとXrayには共通する歴史や設定概念がありますが、機能や設定形式はそれぞれ独自に開発されています。設定ファイルを自由に置き換えられるわけではありません。特にVLESS、REALITY、Visionを組み合わせる場合は、クライアント名だけで判断せず、実際に動作しているコアを確認してください。
プロトコル、トランスポート、セキュリティ層もそれぞれ異なる概念です。VLESSはプロキシプロトコル、REALITYはトランスポートのセキュリティ機構、Visionは特定の条件で使われるフロー制御方式です。設定時は、サーバー提供元から受け取った組み合わせをクライアントに正しく反映してください。プロトコルをVLESSにするだけでセキュリティ層やフロー制御の指定が抜けていると、ハンドシェイクに失敗することがあります。ポートを変えるだけでは、この不一致は解消できません。
v2rayN、v2rayNG、v2flyNGはいずれもオープンソースのクライアントで、主要なクライアントコードにはGPL系ライセンスが採用されています。V2FlyとXrayのコアは主にMPL 2.0で公開されています。クライアントのUI、コア、同梱コンポーネントには、それぞれ異なるライセンスが適用されます。無料で使えること、コードを閲覧できること、再配布できることは同じではありません。変更、配布、統合を行う場合は、各プロジェクトのライセンス条項を確認してください。
端末と設定を基準に選びましょう。デスクトップではv2rayNでサーバー、サブスクリプション、ルーティングをまとめて管理できます。AndroidではXrayエコシステム向けのv2rayNG、V2Fly系のv2flyNGが選択肢です。ここでの「第一候補」「代替」は、このサイトで案内する操作入口の順番を示します。ほかのクライアントの開発が終了したという意味でも、特定のコアがあらゆるネットワーク環境で高速という意味でもありません。
クライアントのアップグレード、サブスクリプションの更新、Geoデータベースの更新は、それぞれ別のメンテナンス作業です。クライアントのアップグレードではUIや同梱コンポーネントが変わります。サブスクリプションを更新すると、サービス提供元からサーバー一覧を再取得します。Geoデータベースの更新では、ドメインやIPアドレスの集合が変わります。サブスクリプションの更新が成功しても、ルーティングファイルが更新されたとは限りません。ルールファイルを更新しても、期限切れのサブスクリプションURLは修復されません。
更新の前後で、同じサーバー、同じルーティングモード、同じテスト用ドメインを使うなど、比較できる条件を保ってください。更新後に問題が起きたら、まず起動ログと実際の設定を確認してから、設定を戻すか判断します。自動更新の頻度を上げすぎず、設定元の要件に合わせて間隔を決めましょう。短い間隔でリクエストを送り続けると、サーバー側の制限にかかり、かえって正常に更新できなくなることがあります。
このサイトでは、クライアントの入手先と日本語の操作ガイドをまとめています。サイト名は識別のために使用しており、Project V、V2Fly、Xray、各クライアントの開発プロジェクトを運営していることを示すものではありません。ソフトウェアの機能とライセンスは各プロジェクトが定め、サブスクリプションサービスとサーバーの稼働状況はサービス提供元が管理します。ガイドではローカルの設定と通信経路を説明しますが、サーバー側のパラメーター説明に代わるものではありません。
設定例を読むときは、説明用のフィールドと実際の接続情報を区別してください。ドメイン名、識別子、セキュリティパラメーターはサーバー側の設定と一致させる必要があり、フィールド名から推測して入力することはできません。設定の読み込み後にエラーが出たら、形式を認識できないのか、コアの起動に失敗したのか、リモート接続に失敗したのかを確認してから、該当する手順で対処してください。プロジェクト名やプロトコルの階層については用語集、症状から問題を特定するにはトラブルシューティングガイドをご覧ください。
新着3記事では、操作上の疑問を順に取り上げます。まずサブスクリプションの取得が成功したかを確認し、次にルールデータベース、最後に選択中のサーバーとシステムプロキシを検証します。操作手順と設定の説明を分けているため、現在の問題に合わせて参照できます。
URLの無効化、ネットワーク接続、プロキシのループ、取得内容の形式異常という4つの観点から、サブスクリプション更新に失敗する原因を解説。サブスクリプショングループで自動更新間隔を設定する方法も紹介します。
「ノードは残っているのに、更新時にエラーが出る」場合におすすめです。有効な設定内容を取得できているかを確認してから、更新方法や間隔を見直しましょう。リモートから返されたエラーページをサブスクリプションとして読み込まないよう注意してください。
サブスクリプションのトラブル対処法を読む →ルーティングでGeoIPとGeoSiteのデータベースが果たす役割を解説します。クライアント内でルールファイルを更新する方法と、ルールにgeosite:cn、geoip:privateなどの一般的なタグを指定する方法も紹介します。
「クライアントは接続できるが、一部の通信先が想定と異なる」場合におすすめです。まずタグの種類とデータベースの有無を確認し、次にルールの順序を調べましょう。ドメインの集合とIPアドレスの集合は、名前が似ているだけで相互に置き換えられるものではありません。
ルールファイルの解説を読む →サブスクリプションを追加した後の最初の手順を解説します。実接続テストで使えるノードを選び、システムプロキシモードに切り替えてから、ブラウザーとコマンドラインの両方で通信が実際にプロキシ経由になっているか確認します。
サーバー一覧は表示されたものの、次に何をすればよいかわからない方におすすめです。テスト結果が示すのはテスト時点の通信経路であり、実際のアプリでの動作を保証するものではありません。サーバーを選んだ後も、通信の入口が正しく設定されているか確認してください。
初回接続の手順を読む →