デスクトップ・Android向けクライアント設定ガイド
サブスクリプションの読み込みからルーティング設定まで、実際のメニューに沿ってv2rayNとv2rayNGの設定手順を解説します。
画面は設定項目のイメージです。メニューの場所や利用できるコアは、実際のクライアントでご確認ください。端末間で設定を共有する際は、コアと項目の互換性を確認してください。
設定ガイド
設定の取得元、トラフィックの入口、リクエストの転送先を区別してから、高度な項目を調整しましょう。GUIクライアントは設定を管理し、コアは生成された設定に従って接続を処理します。それぞれの役割は異なります。
サブスクリプションURLから取得できるのは複数のサーバー設定で、個別の共有リンクとは異なります。v2rayNでは「サブスクリプショングループ設定」に名前とURLを入力して保存し、対象グループを更新します。v2rayNGでは「サブスクリプショングループ設定」から追加し、「サブスクリプションを更新」を実行します。取得元ごとにグループを分けると更新範囲が明確になり、手動設定とサブスクリプションの内容が混ざるのを防げます。更新後はサーバーアドレス、プロトコル、通信方式を確認してから使用する設定を切り替えましょう。URLに認証情報が含まれる場合があるため、スクリーンショットや調査記録では全体を隠してください。
システムプロキシは、システム設定に従うアプリのリクエストをローカルポートへ送るかどうかを決めます。ルーティングは、リクエストがコアに届いた後、どのアウトバウンドを使うかを決めます。v2rayNでは、まず「システムプロキシを自動設定」が有効か確認し、次にルーティングモードを選びます。細かく設定する場合は「ルーティング設定」で既定のルールセットを確認してください。中国本土をバイパスする設定は、通常ドメインやアドレスのルールに基づくもので、プロキシを単に無効にすることではありません。カスタムルールは上から順に照合されるため、具体的なルールを広範囲のルールより前に置きます。システムプロキシを参照しないアプリもあるため、ブラウザーだけで全アプリの通信経路を判断しないでください。
v2rayNでは複数のコアを管理できますが、同じ項目の組み合わせをすべてのコアでそのまま使えるとは限りません。Xray、V2Fly、sing-boxでは、対応プロトコル、通信方式の項目、設定構造が異なります。切り替える前に、サーバーのプロトコル、通信方式、安全設定を確認し、クライアントで選べるコアと照らし合わせてください。v2rayNGはXrayコアを使用し、v2flyNGはV2Flyコアを使うAndroid向けの選択肢です。起動に失敗した場合は、まずログの設定解析エラーを確認し、プロトコルとルーティングを同時に変更しないでください。切り替え前の設定を残しておくと、違いを一つずつ再現できます。
v2rayNGの「アプリごとのプロキシ」では、VPNで通信を処理するアプリを選べます。有効にしたら、まず「バイパスモード」の動作を確認してください。バイパスモードでは、選択したアプリはプロキシを経由しません。バイパスモードを無効にすると、選択したアプリがプロキシ対象になります。アプリ一覧の選択とドメインルーティングは別のルールです。前者はアプリを入口に通すかを決め、後者はコアに届いたリクエストを処理します。変更後は接続を確立し直し、対象アプリを開いて確認してください。テスト時はほかのVPNサービスを終了します。Androidでは同時に有効にできるVPNが一つだけという制限を、サーバーやルールの問題と取り違えないためです。
デスクトップとAndroidの間で設定を移す場合は、まずクライアントが対応する共有リンクやサブスクリプションを使いましょう。サーバーアドレス、ポート、プロトコルの項目は設定とともに移せますが、ローカルの待ち受けポート、システムプロキシ、VPN権限、アプリごとの対象リストは移行先で再設定してください。完全なJSON設定にはローカルファイルやルールリソースへの参照が含まれる場合もあり、コピーできても互換性があるとは限りません。読み込み後にプロトコル、通信方式、安全設定を確認し、まず一つの接続をテストしてからカスタムルーティングを戻します。エクスポートファイルには認証情報が含まれることがあるため、安全な場所に保管し、公開ログから機密情報を削除してください。
初回設定では、まず手順を一つに絞りましょう。サブスクリプショングループを一つ追加し、使える設定を一つ選び、ローカルのプロキシ入口を有効にして、対象アプリを確認します。一連の動作を確認してから、ドメイン振り分け、アプリ一覧、カスタムDNSを追加してください。変更する項目を一度に一種類にすれば、問題が起きた箇所を特定しやすくなります。コア、ポート、ルーティングを同時に変更すると、正常だった状態との比較が難しくなります。
ここにある画面カードはメニューの概念を比較するためのもので、実際の設定を代替するものではありません。クライアントによってボタン名は変更される場合があります。判断の基準は各設定の役割です。サブスクリプションは設定の取得、インバウンドはローカルのリクエスト受信、アウトバウンドは接続の確立、ルーティングはアウトバウンドの選択を担います。JSONを編集する場合は、まず設定項目リファレンスを読み、各項目がどのセクションに属するかを確認してから、GUIの外で編集する必要があるか判断してください。
クライアントのダウンロード
デスクトップではv2rayN、Androidではまずv2rayNGをご確認ください。インストーラーはCPUアーキテクチャやOS環境にも合わせる必要があります。端末の設定で情報を確認してから、対応するプラットフォームのダウンロードページへ進みましょう。
v2rayNにはデスクトップ版と従来のWPF版があります。デスクトップ版はクロスプラットフォームのUIを採用し、WPF版は従来のデスクトップ操作画面を維持しています。選ぶ際はまずシステム要件を確認し、普段使うメニュー構成に合わせてください。同じサブスクリプションを読み込むために、両方を同時に起動する必要はありません。
初回起動後、ローカルの待ち受けポートとシステムプロキシの状態を確認してください。古いクライアントが動作中だと、同じポートを使用している場合があります。古いプロセスを終了してからテストしましょう。ブラウザーにプロキシ拡張機能がある場合は、システム設定を上書きしていないかも確認してください。入口が二重になり、互いに干渉するのを防げます。
v2rayNはApple Silicon版とIntel版を選べます。「このMacについて」でチップまたはプロセッサの情報を確認してから、対応するインストーラーを選択してください。CPUアーキテクチャは表示言語とは関係ありません。外観や購入年だけで判断しないでください。
インストール後は、まずクライアントが正常に起動することを確認してから、サブスクリプションとシステムプロキシを設定します。OSのセキュリティ警告が表示された場合は、ダウンロード元と警告の具体的な内容を確認し、システム設定に従って対処してください。セキュリティ機能全体を無効にするのは避けましょう。接続後も、実際に使うアプリでプロキシの動作を確認してください。
v2rayNGはXrayコアを使用するAndroid向けの第一候補です。V2Flyコアの設定が必要な場合はv2flyNGをご確認ください。多くの端末はarm64ですが、分からない場合は端末情報を確認するか、ダウンロードページの汎用版の説明をご覧ください。
初回接続時は、システムのVPN接続許可が必要です。この許可は端末のネットワーク通信をVPNで処理するためのもので、サーバーへの接続成功を意味するものではありません。接続後は対象アプリで動作を確認し、バックグラウンド実行の制限も確認してください。バックグラウンドにすると接続が切れる場合は、設定を変更する前に、OSによるクライアントの実行制限を調べましょう。
v2rayNはdeb版とrpm版のインストーラーがあり、x64とarm64を選べます。まずディストリビューションに合わせてパッケージ形式を選び、次にCPUアーキテクチャを確認してください。パッケージ形式はプロキシプロトコルではなく、サブスクリプション内のサーバー設定にも影響しません。
インストール後はGUIクライアントから設定を読み込みます。デスクトップ環境によってシステムプロキシへの対応が異なり、アプリによってはローカルのHTTPまたはSOCKSの接続先を個別に入力する必要があります。ブラウザー、デスクトップアプリ、ターミナルのプログラムを分けて確認してください。一つのプログラムが接続できても、すべてのプログラムが同じ設定を参照しているとは限りません。
クライアントのインストール後も、有効なサーバー設定またはサブスクリプションが必要です。インストーラーにはクライアント本体が含まれますが、そのまま使える接続情報は含まれていません。
すべてのクライアントを見る →クイックスタート
まず再現可能な基本設定を整えてから、必要に応じて独自ルールを追加します。次の3ステップは詳しいガイドの操作順に沿っており、デスクトップとAndroidの違いは主にローカルトラフィックの入口にあります。
最初に、入手したものがサブスクリプションURLか、vmess://やvless://などで始まる個別の共有リンクかを確認します。サブスクリプションURLは「サブスクリプショングループ設定」に追加して更新します。個別の共有リンクは、クライアントのクリップボードからの読み込み機能を使います。Webページの説明URLをサブスクリプションとして登録したり、サーバーアドレス欄にサブスクリプションURLを入力したりしないでください。
読み込み後は、メモ、プロトコル、サーバーアドレス、ポートが正しく表示されているか確認します。サブスクリプションの更新に失敗した場合は、URLが途中で切れていないか、余分な空白がないかを確認し、更新時のメッセージを確認してください。サブスクリプションのWebページが開けても、クライアントが有効な設定を読み込めたとは限りません。初回のトラブルシューティングでは、比較に必要な情報が失われないよう、既存のグループを削除して作り直さないでください。
デスクトップでは使用するサーバー設定を選び、「システムプロキシを自動設定」を有効にします。Androidでは設定を選んで接続ボタンをタップし、システムのVPN接続許可を確認してください。ルーティングには明確な既定モードを使い、複雑なカスタムルールはまだ追加しないでください。システムプロキシ、VPNによる通信の処理、コアのルーティングは別々の階層です。名前が似ていても代用できません。
LAN内のサービスに接続する場合は、バイパスルールと対象アドレスを確認します。Androidで対象アプリを絞り込む場合は、「アプリごとのプロキシ」を設定し、バイパスモードの状態も確認してください。これらの設定を変更した後は再接続し、実際のアプリからリクエストを送って動作を確かめましょう。ほかのプロキシやVPNツールも動作している場合は、終了してからテストしてください。
接続ボタンに「起動中」と表示されても、クライアントが動作状態に入ったことしか分かりません。実際に使うWebサイトやアプリを開き、リクエストが完了するか確認して、ログのアウトバウンド、名前解決、ハンドシェイクに関するメッセージを確認してください。内蔵の速度テストはその時点の接続状況を比較するためのもので、継続的なダウンロード速度を示すものでも、実際のアプリでのアクセス確認に代わるものでもありません。
問題が発生したら、ローカルの入口、DNS、サーバー接続、接続先サービスの順に確認します。使用中のモードと変更した項目を記録し、一度に一つの条件だけを変更してください。ブラウザーは正常で特定のソフトだけ失敗する場合は、そのソフト独自のプロキシ設定を優先して確認します。すべてのリクエストが失敗する場合は、設定値、システム時刻、サーバーへの接続性を調べ、やみくもにルーティングルールを増やさないでください。
設定を元に戻す場合は、まず接続を終了してシステムプロキシを元に戻し、その後で設定を選び直します。動作する基本設定を残しておくと、その後のルール変更による問題を特定しやすくなります。
詳しい使い方を見る →オープンソースのエコシステム
V2Rayはエコシステムと技術の背景を示す名称で、v2rayN、v2rayNG、v2flyNGは個別のクライアント名です。画面とコアの役割を区別すれば、各設定がどこで適用されるかを判断しやすくなります。
Project Vはモジュール型のネットワークプロキシを中心とするプロジェクトで、V2Rayは広く使われている実装の一つです。V2FlyはV2Rayを引き継いでコミュニティによるメンテナンスを続けています。Xrayは関連するコードや技術エコシステムをもとに独自の実装と機能を発展させてきました。共通する概念や設定方法もありますが、プロジェクト名だけで完全な互換性があるとは判断できません。あるプロトコルに対応していても、すべての通信方式、安全設定、ルーティングリソースをそのまま相互利用できるとは限りません。
GUIクライアントはサブスクリプションの管理、設定編集、起動制御、システム連携を担い、コアは実際のネットワーク処理を行います。メニューの項目を確認するときは、クライアントがその設定をどう保存するかと、現在のコアが該当項目を認識するかの両方を確認してください。実行時に生成されたファイルを手動で変更すると、次回の設定保存時に上書きされる場合があります。変更を維持するには、クライアントが対応する設定画面から編集してください。
v2rayN、v2rayNG、v2flyNGはいずれもオープンソースのクライアントで、デスクトップまたはAndroid向けにGUI操作を提供します。v2rayNとv2rayNGはGPL系ライセンス、v2flyNGはGPLv3ライセンスを採用しています。具体的な適用範囲、サードパーティ製コンポーネント、再配布条件については、各プロジェクトのライセンス文書をご確認ください。V2FlyとXrayのコアはMPL 2.0ライセンスです。クライアントとコアは別のソフトウェアであり、一方のライセンスがすべてのコンポーネントに適用されるわけではありません。
オープンソースとは、ライセンスの条件に従ってコードを閲覧、研究、メンテナンスに参加できることを意味します。入手元の異なるインストーラーがすべて同じ状態だという意味ではありません。クライアントは、端末のプラットフォーム、必要なプロトコル、設定の互換性を踏まえて選びましょう。デスクトップではv2rayN、AndroidでXray設定を使う場合はv2rayNGを優先して確認し、V2Flyに対応する動作が必要な場合はv2flyNGを検討してください。クライアントはサーバーの運用方法を決めるものではなく、サブスクリプションの入手元を判断するものでもありません。
クライアントの画面、コアの機能、ルールリソースはそれぞれ別に更新されることがあります。画面を更新した後も実際に有効なコアを確認し、ルールファイルを更新した後はカスタムタグとの対応が保たれているか確認してください。更新前にローカルポート、システムプロキシのモード、使用中の設定、カスタムルーティングを記録します。エクスポート機能がある場合は、安全な場所にバックアップを保存してください。更新後は、まず以前から使えていたリクエストをテストし、その後で高度な設定を一つずつ戻します。複数の変更を同時に行うと、問題の原因を特定しにくくなります。
サブスクリプションの更新とソフトウェアの更新は別のものです。前者はサーバー設定を更新し、アドレス、プロトコル、接続パラメーターが変わる場合があります。後者はクライアントやコンポーネントを更新します。サブスクリプションに含まれる個別設定では、端末全体のルーティング設定を表せないことがあり、クライアントのローカルルールもほかの端末に自動で共有されません。複数の端末を管理する場合は、サブスクリプション由来の設定と端末ごとの設定を記録しておくと、端末間の移行で誤認しにくくなります。
さらに設定を確認する場合は、まずinbounds、outbounds、routing、dnsの4つのセクションを読みましょう。インバウンドの待ち受け範囲は必要な範囲に限定し、アウトバウンドのタグはルーティングから参照されるタグと一致させます。DNSの動作はドメインの振り分け方針と合わせて判断してください。例にあるgeosite:cnのルールは対応するリソースを必要とします。ルールだけをコピーして有効なリソースファイルがない場合、設定が想定どおりに起動しないことがあります。
完全な設定、共有リンク、サブスクリプションURLには、アクセス認証情報が含まれることがあります。問い合わせ時は必要な項目だけ残し、認証情報とサブスクリプションURL全体を隠したうえで、クライアント名、使用コア、エラーが起きた段階、関連するログを伝えてください。ログに表示される接続先ドメインから利用履歴が分かる場合もあるため、調査に必要な部分だけを共有しましょう。接続失敗のスクリーンショットだけを送るより、こうした点に配慮して情報を整理したほうが問題を再現しやすくなります。
V2Rayの設定項目について読む →設定の読み方
読み込み方法からゲートウェイ構築、段階的なトラブルシューティングまで解説します。最近公開された3記事から、問題に合ったものを選んでご覧ください。一度にすべての設定を変更する必要はありません。
個別の共有リンクには一つの接続設定が含まれ、サブスクリプションURLからは複数の設定を取得・更新できます。この記事では、それぞれの読み込み方法、更新範囲、保管方法を解説し、v2rayNとv2rayNGの操作を比較します。リンクを貼り付けても認識されない、読み込み先を間違えた、更新後に設定が変わった場合に役立ちます。
読み込み方法を見る →メインルーター上でコアを動かす構成と、バイパスルーターをゲートウェイとして使う構成は、ネットワーク上の配置が異なります。この記事では、端末のゲートウェイ、透過プロキシ、DNS振り分けの関係を解説し、導入前に確認すべき転送経路と切り戻し方法を紹介します。構築方法の参考としてご利用ください。デスクトップクライアントのシステムプロキシ設定を、LAN全体の通信制御と同じものと考えないようにしてください。
構築のポイントを見る →速度低下の原因は、サーバーの負荷や通信経路、ローカル設定、接続先サービスなどさまざまです。この記事では確認項目を段階ごとに整理し、接続時間、継続的な転送速度、アプリの応答を区別して解説します。テスト条件を固定して一度に一つの要因を比較しましょう。一度の速度測定だけを根拠に設定を何度も変更すると、ボトルネックを特定できなくなることがあります。
段階別のトラブル対処を見る →システムプロキシや接続ログを確認中ですか？記事一覧では、モードの選び方やエラーメッセージの読み解き方も紹介しています。具体的な問題に合わせてご覧ください。
すべての記事を見る →