システムプロキシからトラフィックのルーティングまで、まず対象にする通信を決め、それに応じたクライアント機能を選びます。以下の例は設定の構造を示すものです。実際の設定では、クライアント画面と使用中のカーネルが対応する項目を確認してください。
ローカルのSOCKSインバウンドは、アプリからのプロキシリクエストを受け付けます。一方、システムプロキシは、OSの設定に従うアプリをこのローカルポートへ誘導します。両者は別々の設定です。普段のブラウジングでは、まず「システムプロキシを自動設定」を有効にします。接続先によってプロキシ経由かどうかを変える場合は、PACモードを確認してください。ターミナルや個別にプロキシを指定したブラウザーは独自の設定を使うことがあるため、メニューバーの表示だけでは接続状況を判断できません。ページを開けない場合は、ローカルポート、システムプロキシの接続先、使用中のサーバーの状態を順に確認しましょう。ノードを何度も切り替えるより、原因を特定しやすくなります。
{
"inbounds": [{
"listen": "127.0.0.1",
"port": 10808,
"protocol": "socks",
"settings": { "auth": "noauth" }
}]
}ルーティングルールは、条件に一致した通信を指定のアウトバウンドへ振り分けるもので、サーバー設定を置き換えるものではありません。一般的には、まず明示的なダイレクト接続先のドメインやプライベートアドレスを処理し、残りのリクエストをデフォルトのアウトバウンドへ送ります。ルールは上から順に評価されるため、範囲の広いルールを先に置くと、より具体的なルールより優先されることがあります。編集前に、カーネルが必要なジオデータを読み込んでいるか、ルールで参照するアウトバウンドのタグが存在するかを確認してください。Webサイトとアプリで結果が異なる場合は、同じローカルインバウンドを経由しているかも確認しましょう。クライアントを経由しない通信には、これらのルールは適用されません。
{
"routing": {
"domainStrategy": "AsIs",
"rules": [{
"type": "field",
"domain": ["geosite:private"],
"outboundTag": "direct"
}]
}
}サブスクリプショングループには更新元が保存され、グループ内のサーバー一覧には更新後の結果が表示されます。URLを追加したら更新を実行し、一覧にサーバーが表示されたことを確認してから、使用するサーバーを選択します。複数の配信元を管理する場合は、どの一覧か見分けやすい名前を各グループに付けましょう。更新によってサーバー名や並び順が変わることがあるため、一覧の位置だけで使用中のサーバーを覚えるのは避けてください。取り込みに失敗したら、URLが完全か、応答内容がクライアント対応の形式かを確認し、その後ネットワーク接続を確認します。サブスクリプションURLを単一サーバーの設定として取り込まないようにしてください。
サブスクリプショングループ：作業環境
サブスクリプションを更新 → サーバー一覧を確認 → 使用するサーバーを選択
サブスクリプションの配信元とローカルのルーティングルールは個別に管理TUNモードは仮想ネットワークインターフェースを使い、条件に合うシステム通信を取り込みます。システムプロキシに従わないアプリも対象にしたい場合に便利です。通常のシステムプロキシとは適用範囲が異なり、追加のシステム権限が必要な場合もあります。有効にする前に通常のプロキシ接続が動作することを確認し、使用中のOSに対応したTUN設定とルーティング項目を確認してください。有効にした後、LAN内の機器へ接続できなくなった場合は、サーバーのプロトコルを変更するのではなく、プライベートアドレス、DNS、除外ルールを優先して確認します。使用を終えたらクライアントでTUNを無効にし、OSのネットワーク設定が想定どおりに戻っているか確認してください。
接続確認の順序：
通常のシステムプロキシ → DNS設定 → TUN仮想インターフェース
LANへのアクセスに問題がある → プライベートアドレスのルーティングを確認v2rayNではサブスクリプション管理、サーバー選択、プロキシモードなどを画面上で操作し、実際のプロトコル処理は選択したカーネルが担います。XrayとV2Flyは関連しながらも、独立して保守されているカーネルの系統です。プロトコルやトランスポート設定が使えるかどうかは、カーネルの対応状況とクライアントの設定画面によって異なります。カーネルを切り替える前に現在使えている接続方法を記録し、切り替え先が既存のサーバーパラメーターに対応しているか確認してください。その後、関連サービスを再起動して接続を検証します。起動エラーが発生した場合は、システムプロキシのアイコンだけを見るより、クライアントログに記録された項目やプロセスの問題を確認するほうが原因を絞り込めます。
クライアント：v2rayN
カーネルの選択：Xray / V2Fly
確認の順序：プロトコル対応 → 設定項目 → 起動ログルールやDNS、サブスクリプション管理を詳しく確認するには、応用設定ガイド →をご覧ください
デスクトップではv2rayNを使用します。Androidでは、必要なカーネルに応じてv2rayNGまたはv2flyNGを選べます。まずOSとプロセッサーのアーキテクチャを確認してから、各プラットフォームのダウンロード情報をご覧ください。
v2rayNにはデスクトップ版と従来のWPF版があります。デスクトップ版はクロスプラットフォームのUIを採用しています。WPF版の操作に慣れている場合は、従来版のダウンロード先も確認できます。
ダウンロードページへ →v2rayNはApple Silicon搭載MacとIntel搭載Macでダウンロード先が分かれています。「システム情報」でチップの種類を確認し、対応するインストーラーを選んでください。
ダウンロードページへ →まずXrayカーネルを採用したv2rayNGをご確認ください。V2Flyカーネルが必要な場合はv2flyNGを選べます。どちらもarm64版と汎用版を掲載しています。
ダウンロードページへ →v2rayNはdeb形式とrpm形式のパッケージに対応し、それぞれarm64版も用意されています。ディストリビューションのパッケージ管理方式とプロセッサーのアーキテクチャを確認してください。
ダウンロードページへ →どのビルドを選べばよいかわからない場合は、ダウンロードページでプラットフォーム別のインストーラー、アーキテクチャ、システム要件を確認できます。クライアント一覧を見る →
まず通常のシステムプロキシモードでサーバーに接続し、その後でルーティング、DNS、TUNを調整します。一度に変更する設定の種類を一つに絞ると、接続結果を判断しやすくなります。
システムのアーキテクチャに合ったクライアントをインストールします。サブスクリプション設定にサービス提供元のURLを追加し、手動で更新して、サーバーが一覧に表示されたことを確認してください。単一の設定リンクを受け取った場合は、サブスクリプショングループではなく、クライアントのリンク取り込み機能を使います。
サーバーを選択して使用中の設定にし、カーネルを起動してシステムプロキシを有効にします。まず通常のプロキシモードで基本的な接続を確認しましょう。接続先ごとに通信を振り分ける場合は、ルーティング設定を開き、ルールの順序とアウトバウンドのタグを確認してください。
システムプロキシに従うアプリから接続先にアクセスし、その後クライアントのログを確認します。接続できない場合は、サブスクリプションが更新済みか、サーバーを選択しているか、ローカルポートが正常に待ち受けているか、アプリがシステムプロキシ設定を参照しているかを順に確認してください。
サーバーが一覧にあるのに接続できない？一覧に表示されているのは取り込みが成功したということです。サーバーを選択し、カーネルを起動して、システムプロキシの状態も確認してください。接続手順を見る →
ブラウザーは使えるのに、ターミナルから接続できない？ターミナルではプロキシ環境変数を別途設定する必要がある場合があります。まず、クライアントのローカル待ち受けポートに接続しているか確認してください。モードの説明を見る →
ルーティングを切り替えたら、一部のサイトが開けなくなった？ドメインルールの評価順、DNSの名前解決結果、対応するアウトバウンドを確認してください。まず直前の動作していた設定に戻し、一項目ずつ調整します。ルーティングガイドを見る →
画面上の操作で設定を管理し、カーネルが接続を処理します。この役割分担を理解するとエラーログを読み解きやすくなり、クライアントの機能とプロトコルの対応範囲を混同せずに済みます。
Project VはV2Rayのプロトコルと設定方式の基礎を築きました。その基礎をもとに、カーネルの実装、GUIクライアント、ルールデータなど、さまざまなプロジェクトが生まれています。技術的なつながりはありますが、個々のGUIクライアントの機能一覧がエコシステム全体の能力を示すわけではありません。設定ガイドを読むときは、クライアントの操作、カーネルのパラメーター、サーバーから提供された接続情報のどれを扱っているか確認しましょう。同じ用語でも指す階層が異なる場合があります。階層を整理してから設定を変更すれば、設定場所の誤りによるトラブルシューティングの手間を減らせます。
V2FlyはV2Rayプロジェクトのカーネル保守を引き継ぎ、Xrayは関連エコシステムに属する別のカーネル系統です。どちらも接続処理を担いますが、対応するプロトコル、トランスポートの選択肢、設定項目は異なる場合があります。サーバー設定で特定の機能が必要な場合は、クライアントでの取り込み方法と、現在選択しているカーネルの両方を確認してください。設定の解析に失敗したら、エラーになった項目を記録し、該当カーネルの設定ガイドを参照しましょう。クライアント名だけで互換性を判断しないでください。複数のカーネルを選べるのは、実際の設定要件に合わせるためであり、同じ設定をすべての実装で自動的に使えるようにするものではありません。
v2rayNはWindows、macOS、Linuxのデスクトップ環境向けで、サーバー管理、サブスクリプションの更新、システムプロキシ、ルーティングをまとめて操作できます。Android向けのv2rayNGはXrayカーネルを使用し、v2flyNGはV2Flyカーネルを選びたい場合の選択肢です。3つともソースコードが公開されたプロジェクトですが、画面構成、更新頻度、対応機能はそれぞれ異なります。OSを確認したうえで、必要なカーネルと設定機能に合うものを選んでください。同じサブスクリプションを複数の端末で使う場合も、端末ごとにプロキシモードとローカルルールを確認する必要があります。
各プロジェクトはオープンソースライセンスのもとで公開されています。具体的なライセンス条件は各プロジェクトの公開情報をご確認ください。エコシステムではGPL-3.0やMITなどのライセンスが使われています。クライアント、カーネル、ルールデータの更新はそれぞれ独立して進むことがあり、あるコンポーネントを更新しても、別のコンポーネントの動作が必ず変わるとは限りません。大きな設定変更の前に、動作中の設定を保存し、クライアント、カーネル、OSを記録しておきましょう。問題が発生した場合、こうした情報があれば「接続できない」という曖昧な説明より原因を特定しやすくなります。ダウンロードページには各プラットフォームへのリンクをまとめ、設定の詳細は応用ガイドでテーマ別に解説しています。
サブスクリプションのフィルタリング、DNS、FakeDNS、自作アウトバウンドを確認するには、応用ガイド →をご覧ください
起動エラー、ポートの競合、初回利用時の問題について、具体的な確認手順をまとめています。各記事では、再現可能な設定状況を一つ取り上げます。
デスクトップOSごとに起動時の依存関係、ディレクトリの権限、セキュリティによるブロックを確認し、アプリが起動しない場合とカーネルの起動に失敗した場合を切り分けます。
記事を読む →ポートを使用しているプロセスを特定し、ローカルの待ち受けポートを変更して、ブラウザーとターミナルのプロキシ接続先も更新します。
記事を読む →クライアントの選び方、サブスクリプションの取り込み、システムプロキシモード、ルール切り替えでよくある疑問を解説します。
記事を読む →