クライアント / サブスクリプション追加 / JSON設定
オープンソースクライアントのダウンロード先、サブスクリプションの追加手順、JSON設定をまとめました。プラットフォームとコアに応じて選べます。
01 / クライアントを選ぶ
まずOSとCPUアーキテクチャを確認してから、インストーラーを選びましょう。デスクトップではv2rayN、Androidではv2rayNGが基本です。V2Flyコアとの互換性が必要な場合は、v2flyNGも検討してください。ダウンロードページでは各クライアントの入手先と動作条件を案内しています。トップページでは特定のリリース版に固定していません。
v2rayNにはデスクトップ版と従来のWPF版があります。デスクトップ版はクロスプラットフォームのUIを採用し、WPF版は従来のデスクトップ操作を引き継いでいます。どちらも設定とサブスクリプションを管理できます。OSの要件や使い慣れた操作方法を基準に選び、同じサブスクリプションのために両方をインストールする必要はありません。
インストール前に、システムの「バージョン情報」でOSの種類を確認してください。初回起動後は既存の設定をインポートし、使用する設定を選んでからシステムプロキシを設定します。ブラウザーは通常システムプロキシを参照しますが、ターミナルや一部のアプリではプロキシアドレスを個別に設定する必要があります。クライアントが起動しても、すべてのアプリがプロキシを使うとは限りません。
既存の設定を移行する場合は、サブスクリプショングループとカスタムルーティングを先にバックアップしてください。動作する設定をひとつ残し、ローカルポートとプロキシモードをひとつずつ変更すると、違いを特定しやすくなります。
v2rayNのmacOS版は、Apple SiliconとIntelでダウンロード先が分かれています。「このMacについて」でチップまたはプロセッサ情報を確認し、対応するインストーラーを選んでください。設定はデスクトップOS間で引き継げますが、ローカルのファイルパスや権限、ネットワーク接続方式は改めて確認が必要です。
インストール後は、サブスクリプションを正常に追加できるか確認し、使用中の設定と待ち受けポートをチェックします。システムプロキシとTUN接続では対象となる通信範囲が異なり、TUNではネットワーク権限やルーティングの変更も関係します。初めて設定する場合は、状況を確認しやすい接続方式から始め、通信を確認してからルールを追加しましょう。
OSのセキュリティ警告が表示されたら、内容を読み、選択したファイルがデバイスのアーキテクチャに合っているか確認してください。起動失敗、権限の要求、リモート接続の失敗は、別々の問題として切り分けましょう。
v2rayNGはXrayコアを採用し、一般的な共有リンクやサブスクリプションの管理に適しています。v2flyNGはV2Flyコアを採用した代替候補で、特定の設定要件がある場合に検討できます。比較的新しい端末ではarm64を選べます。アーキテクチャが不明な場合やインストール時に互換性の問題が起きた場合は、ダウンロードページの説明を確認して汎用版を選んでください。
設定をインポートした後、使用する項目を選んで接続を開始してください。VPN接続の許可を求められるのは、アプリの通信を端末内の転送経路に流すためです。同種の接続を使う別のアプリがある場合は競合を確認し、アプリごとのプロキシ設定、ルーティングモード、バックグラウンド動作の制限もチェックしましょう。
v2rayNGでは、サブスクリプションの追加と個別リンクのインポートは別の操作です。複数の設定を継続的に更新する場合はサブスクリプショングループを使い、単一の設定を一時的に追加する場合はクリップボードまたはQRコードを使います。
Linuxデスクトップではv2rayNを使います。ディストリビューションのパッケージ形式に合わせてdebまたはrpmを選び、CPUがx64かarm64かも確認してください。パッケージ形式とCPUアーキテクチャは別の条件です。パッケージ管理ツールがファイルを認識しても、その中のプログラムが現在のCPUで動くとは限りません。
インストール後、GUIからサブスクリプションを追加し、ローカルの待ち受け状態を確認します。デスクトップ環境、ブラウザー、ターミナルでプロキシ設定の参照方法が異なる場合があるため、それぞれ個別に動作を確かめてください。TUNを有効にする前に、必要な権限とシステムルートも確認しましょう。通信を制御するツールを複数同時に動かすと競合することがあります。
トラブル時は、まずデフォルトルートとポートを変えず、ログに待ち受けエラーや名前解決エラーがないか確認します。クライアントの起動問題とアプリの接続問題を切り分けてから、コアの設定を変更してください。
すべてのクライアントを見る → コアの違いがわからない場合は、まず選び方ガイドをご覧ください。
02 / 設定セクション一覧
GUIは設定の作成と管理を担い、コアは設定に従って通信を転送します。通信がどこから入り、どのoutboundから送られるかを把握してから、ルーティングやDNSを調整すると、複数の設定を同時に誤るリスクを減らせます。以下の設定例は各フィールドの説明用であり、リモート接続にそのまま使える完全な設定ではありません。
ローカルのinboundは、ブラウザーやほかのアプリから渡された接続を受け取ります。GUIクライアントが通常この設定を生成するため、普段は設定画面で待ち受けポートを確認し、アプリ側にも同じアドレスとポートを指定してください。例ではループバックアドレスだけを待ち受けるため、この端末内からの接続に適しています。LANに公開する場合は、別途アクセス制御が必要です。SOCKSとHTTPではinboundの使い方が異なるため、ポートだけを変えてプロトコルを無視しないでください。ポートが使用中の場合は、リモート側の設定を何度も変更せず、競合しているプログラムを先に調べましょう。
{
"inbounds": [
{
"tag": "socks-in",
"listen": "127.0.0.1",
"port": 10808,
"protocol": "socks",
"settings": {
"auth": "noauth",
"udp": true
}
}
]
}outboundは、接続を最終的にどのように送信するかを定義します。プロキシoutboundにはサーバーから提供されたアドレス、ポート、認証情報が必要で、プロトコル名だけで接続できるわけではありません。例では基本となるdirectとblockを示し、ルーティングからタグを参照する方法を説明します。VMess、VLESS、Trojanを使う場合は、トランスポート方式とセキュリティ層も確認してください。REALITYは安全な通信に関わる機能で、これらのプロトコルと完全に同じ階層の代替方式ではありません。まずインポートしたパラメーターを維持し、実際に使うコアの対応状況を確認してから調整しましょう。フィールドの組み合わせを推測で設定するのは避けてください。
{
"outbounds": [
{
"tag": "direct",
"protocol": "freedom",
"settings": {}
},
{
"tag": "block",
"protocol": "blackhole",
"settings": {}
}
]
}ルーティングルールは、条件に一致した接続を指定のoutboundに渡します。outbound自体を作成する機能ではありません。例ではプライベートアドレスをdirectに渡しています。実際に使うには、同じ名前のタグが存在し、参照するアドレスデータファイルを読み込める必要があります。ルールは通常、上から順に処理されます。範囲の広いルールを先に置くと、後続の細かなルールが適用されないことがあります。IPIfNonMatchは、ドメインルールに一致しなかったときに名前解決を試み、IP条件との照合を続ける設定です。すべてのドメインを常に事前解決するという意味ではありません。変更後は対象ドメインと、実際に選ばれたoutboundの両方を確認してください。
{
"routing": {
"domainStrategy": "IPIfNonMatch",
"rules": [
{
"type": "field",
"ip": ["geoip:private"],
"outboundTag": "direct"
}
]
}
}DNS設定は、コアがドメイン名を解決する際の動作に影響しますが、すべてのアプリのDNS問い合わせが自動的にコアへ送られるわけではありません。アプリ自身が名前解決するか、通信の取り込みが有効か、outboundがドメイン名をどう処理するかによって、実際の経路は変わります。例ではIPv4の問い合わせに限定し、ローカルの名前解決元を使っています。フィールド間の関係を示すためのもので、汎用的な最適化設定ではありません。アドレス種別を制限するのは、端末のネットワーク環境と接続先の条件を確認してからにしてください。ドメイン名で接続できずIPアドレスなら接続できる場合は、サーバー一覧を変更する前に、名前解決ログと問い合わせ元を確認しましょう。
{
"dns": {
"servers": ["localhost"],
"queryStrategy": "UseIPv4"
}
}03 / オープンソースのエコシステムと保守
製品名、コア名、プロトコル名は、それぞれ異なる階層を指します。クライアントを選ぶときは対応プラットフォームを確認し、設定が使えるか判断するときはコアの対応範囲とサーバー側のパラメーターを確認してください。オープンソースのエコシステムでは、実装を確認しながら開発が続けられていますが、実際の接続結果は設定、OS、ネットワーク環境に左右されます。
PROJECT V
Project Vは、V2Ray関連ツールのエコシステムを理解する出発点です。コアはプロトコル処理や通信転送、ルーティング、名前解決などの基盤機能を担い、GUIクライアントはその上で設定編集、サブスクリプション管理、システム接続の機能を提供します。そのため「V2Ray 公式サイト」や「V2Ray クライアント」で検索すると、プロジェクトのドキュメント、コアの説明、GUIアプリなど、異なる内容が見つかることがあります。当サイトではダウンロード、入門、設定項目の参照先を分け、役割を混同しないようにしています。
役割の違いを理解すると、トラブルの切り分けも簡単になります。インポートメニューが見つからない場合は、まずクライアントの操作を確認します。ログに未対応フィールドが表示された場合は、コアの機能を確認してください。ブラウザーがローカルポートに接続できない場合は、システムプロキシの設定を調べます。GUIを変えてもリモート側のパラメーターエラーが直るとは限らず、プロトコルを変えてもアプリの接続設定の代わりにはなりません。
XRAY / V2FLY
V2FlyはV2Rayのコミュニティによる保守を引き継ぎ、Xrayは関連技術を基盤に独自の機能と設定を発展させています。共通する概念はありますが、追加フィールドやトランスポートの組み合わせ、デフォルト動作がすべて同じとは限りません。特にREALITYやXTLS Visionを使う場合は、Xrayでの対応設定を確認し、任意のコアに設定例をそのまま流用しないでください。コアは名前や速度のイメージだけで選ばず、必要な機能と設定の互換性を基準に選びましょう。
V2Rayのプロトコル選びには、サーバー側の対応も必要です。VMess、VLESS、Trojanでは認証方式が異なり、TLS、REALITY、トランスポート層のパラメーターにもそれぞれ条件があります。共有リンクには通常、これらの組み合わせが含まれています。インポート後はアドレス、ポート、サーバー名、フロー制御の設定を確認してください。特定のテストに成功しても、そのテスト経路が使えたことを示すだけで、すべてのサイトやアプリでの動作を保証するものではありません。
CLIENTS
v2rayNはデスクトップ向けで、サブスクリプショングループ、使用する設定の選択、ルーティング管理、プロキシ接続を設定できます。利用できるコアは配布パッケージとクライアントの対応状況によって異なります。v2rayNGはAndroid向けで、XrayコアとOSのVPN接続機能を使って通信を管理します。v2flyNGもAndroid向けですが、V2Flyコアを採用しており、その実装に依存する既存設定がある場合に適しています。いずれもオープンソースプロジェクトです。利用前に各リリースの説明とライセンスを確認してください。
クライアントは設定を保存するものであり、サーバーを自動で提供するものではありません。サブスクリプションのURLや認証情報は、信頼できる入手先から取得し、利用条件に従って管理してください。サブスクリプションのURLにはアクセス用の認証情報が含まれる場合があるため、トラブル対応時にURL全体を公開しないでください。エラー情報を共有するときは、エラーの種類、フィールド名、発生手順を残しつつ、URL内の個人識別情報や認証情報を削除しましょう。
LICENSE / UPDATE
オープンソースライセンスには、ソースコードの利用、改変、再配布に関する条件が記載されています。GUIクライアント、コア、付属データには異なるライセンスが適用される場合があり、エコシステム全体を単一のライセンス名でまとめることはできません。無料で利用できても、サーバーのリソースやネットワーク接続、サードパーティサービスにはそれぞれ利用条件があります。この設定マニュアルは技術的なフィールドを解説するもので、プロジェクトのライセンス文書に代わるものではなく、あらゆる入手元の設定の適合性を保証するものでもありません。
クライアントの更新はプログラムや関連コンポーネントの入れ替え、サブスクリプションの更新は接続設定の再取得、ルーティングデータの更新はgeositeやgeoipなどの分類に基づく照合内容の変更です。それぞれ解決する問題は異なります。アップグレード前にカスタムルーティングとサブスクリプショングループをバックアップし、更新後は動作確認済みの設定を試してから新機能をひとつずつ有効にしましょう。「サブスクリプションの更新成功」は、プログラム自体が更新されたことを意味しません。トラブル対応中にすべての設定を同時に変更するのも避けてください。
初回はまずインポートするデータの種類を確認します。vmess://やvless://で始まるデータは通常、共有リンクです。複数の設定を定期的に取得するURLは、サブスクリプション管理に追加します。インポート後に使用する項目を選び、プラットフォームに合った通信接続方式を有効にしてから、ブラウザーとネットワークを使うアプリを個別にテストしてください。ひとつの手順ごとに確認を進めると、インポート、接続、アプリへの接続のどの段階で失敗したか特定しやすくなります。
使えていた設定が突然動かなくなった場合は、まずローカルの待ち受け、使用中の設定、エラーログを確認し、次にサブスクリプションに変更がないか調べます。V2Rayの遅延テストと実際のWebサイト閲覧は、同じ動作確認ではありません。テスト先や名前解決の経路、ルールの照合結果が異なる場合があります。手順を確認するには入門ガイド、症状から原因を探すにはよくある質問、設定項目を変更するにはJSONマニュアルをご覧ください。
04 / 設定ガイド
以下では、設定の入手元、通信の振り分け、アプリの接続という異なるテーマを扱います。問題が起きている階層に合わせて読み進め、クライアント側で結果を確認してください。形式を変換しても、足りないサーバーパラメーターは補えません。ルーティングルールで選べるのは既存のoutboundであり、正しい接続設定の代わりにはなりません。
よく使われる3種類のサブスクリプション・設定形式について、構造と用途を比較します。相互変換の考え方と、変換後にクライアントでインポート結果を確認する方法も解説します。
記事を読む →実際のrouting設定例を使って、中国本土のサイトを直接接続し、海外サイトをプロキシ経由にする方法を紹介。domainStrategyの選び方とルールの照合順も解説します。
記事を読む →ブラウザーとターミナルではプロキシ設定の参照方法が異なります。拡張機能の競合、PACモード、環境変数、ローカルポートの4項目を順番に確認します。
記事を読む →