v2rayNのサブスクリプション追加
とシステムプロキシ設定ガイド

ステップ1：サブスクリプションを追加して一覧を更新

まず、サブスクリプション提供元のアカウントページからURLをすべてコピーします。コピーするのはサーバー設定を更新するためのリンクであり、アカウントのログインページやプランの説明ページではありません。URLには認証情報が含まれることが多いため、公開チャットやスクリーンショットで共有しないでください。問題を報告する際は、末尾の数文字だけでなくURL全体を隠します。QRコードや個別の共有リンクしか提供されていない場合は、種類を確認してから、クライアントの対応する追加メニューを使います。

v2rayNにサブスクリプショングループを追加する

v2rayNのメインウィンドウを開き、メニューから「サブスクリプショングループ」→「サブスクリプショングループ設定」を選び、新規追加します。見分けやすいメモを入力し、サブスクリプションURL欄にURL全体を貼り付けて保存してください。画面のバージョンによっては、追加操作がプラスボタンや右クリックメニューにありますが、URLを登録したグループを作成する点は同じです。この時点では更新元を保存しただけなので、サーバー一覧にまだ変化がなくても失敗ではありません。

メインウィンドウに戻り、「サブスクリプショングループ」メニューから作成したグループのサブスクリプションを更新します。まだプロキシ接続を確立していない場合は、まず「プロキシを使用せず更新」を選びます。現在のネットワークからURLにアクセスできない場合に限り、利用可能と確認できている別の接続経路を検討してください。更新が終わったら対象のグループに切り替え、サーバーが表示されることを確認します。更新結果がないと誤解しないよう、まずグループの絞り込み条件も確認してください。

一覧が空のままなら、クライアントに表示されたメッセージを確認します。ネットワークのタイムアウトと、内容の解析エラーは別の問題です。前者ではURLにアクセスできるか、有効期限が切れていないかを確認します。後者では、コピーした内容がクライアント対応のサブスクリプション形式かを確認してください。取得したWebページの内容をそのままconfig.jsonに書き込んではいけません。サブスクリプションURL、vmess://やvless://形式の個別共有リンク、JSON設定全体では追加方法が異なります。どれもテキストだからといって、同じ方法で読み込まないでください。

v2rayNGで対応するメニューを使う

v2rayNGでサイドメニューを開き、「サブスクリプショングループ設定」に進みます。プラスボタンでグループを追加し、メモとサブスクリプションURLを入力して保存してください。サーバー一覧に戻り、メニューから「サブスクリプションを更新」を実行して対象のグループを確認します。グループを追加しただけで更新していない場合、サーバーが表示されないことがあります。すでに一覧にサーバーがあり、サブスクリプションの変更が反映されていない場合は、同じURLを何度も追加せず、もう一度更新してください。

この手順の完了条件は、正しいグループに選択可能なサーバーが表示され、更新中にエラーが続かないことです。今はすべてのサーバーをひとつずつ試したり、サーバーのパラメーターを手動で書き換えたりする必要はありません。サブスクリプションのエンコード形式と共有リンクの違いは、サブスクリプションの追加方法とBase64／URI形式の解説をご覧ください。準備ができたらサーバー一覧をそのままにして、プロキシモードの設定に進みます。

ステップ2：システムプロキシとルーティングモードを選ぶ

サーバーが一覧に表示されても、アプリのリクエストがクライアントに届いているとは限りません。ここでは、システムプロキシまたはTUNがリクエストを端末上のクライアントに渡す方法を決め、ルーティングルールが受け取ったリクエストの出力先を決める、という2つの役割を分けて考えます。これは別々の設定です。初回はシステムプロキシを使ってブラウザーで確認し、既存の基本ルーティングプリセットを維持したまま、TUNの有効化やDNSの変更は避けてください。

システムプロキシの3つの選択肢

v2rayNの「システムプロキシを自動設定」は、システムプロキシをクライアントのローカル待受アドレスに向け、システムプロキシ設定に従うアプリが利用できるようにします。「システムプロキシを解除」は設定を取り消す項目で、通常は使用を終えるときや問題を調べるときに選びます。「システムプロキシを変更しない」は、クライアントが現在のシステム設定を書き換えないという意味です。直接接続やプロキシが有効な状態を意味するわけではありません。システムに別のプロキシアドレスが残っていれば、その設定が引き続き使われる可能性があります。

まず、この3つの選択肢がどこにあるかを確認します。実際に「システムプロキシを自動設定」に切り替えるのは、次の手順でサーバーを選び、コアが起動したことを確認してからです。現在のシステムプロキシが起動していないプログラムを指している場合は、準備中にブラウザーが接続できなくならないよう、先に解除してください。自動設定を行う際は、クライアントに表示されるローカル待受アドレスとポートを使い、ほかのガイドにある固定ポートをそのまま使わないでください。

まずルーティングプリセットを使い、TUNは必要に応じて設定する

クライアントのルーティング設定またはルーティング選択メニューで、用途に合う既存のルーティングプリセットを選びます。ルーティングでは、一部のリクエストを直接接続し、残りをプロキシ経由で送ります。グローバルプロキシ系のプリセットでは、より多くのリクエストがプロキシ経由になります。実際の動作はルールの内容と順序で決まり、プリセット名だけでは判断できません。初回の動作確認では、プロキシルールが適用されることが明確なアクセス先を選び、比較用に直接接続のアクセス先もひとつ用意してください。

TUNは仮想ネットワークインターフェースを使って通信を取り込み、追加の権限が必要になるほか、DNSやルーティングの動作が変わることがあります。システムプロキシに従わないアプリへの対応に適していますが、初回接続に失敗したときにすぐ追加する設定ではありません。まずTUNをオフにしてシステムプロキシで基本的な接続を確認し、アプリの通信を取り込む必要がある場合は、完全版ドキュメントのプラットフォーム別の章を参照して個別に設定します。2つの通信制御方法を同時に変更すると、原因を特定しにくくなります。

v2rayNGは主にシステムのVPNインターフェースを使ってアプリの通信を取り込むため、デスクトップ版のシステムプロキシの3つの選択肢を探す必要はありません。アプリごとのプロキシ設定を有効にしている場合は、テストするブラウザーが対象に含まれているか確認してください。ルーティングモードとアプリ別の対象リストはいずれも結果に影響します。初回の確認では基本設定を維持し、例外ルールを増やさないようにしましょう。モードを選んだら、次は選択したサーバーに接続します。

ステップ3：サーバーを選択して接続する

v2rayNのサーバー一覧に戻り、提供元が利用可能と明記していて、用途にも合うサーバーをひとつ選びます。行をクリックしてハイライトされても、選択されたにすぎず、アクティブサーバーになったとは限りません。右クリックメニューの「アクティブサーバーに設定」または使用中のバージョンに応じた操作を行い、アクティブ表示がその行に移ったことを確認してください。名前が似ているサーバーでも、プロトコルやトランスポート方式が異なることがあります。あるサーバーの設定項目を別のサーバーにコピーして組み合わせないでください。

システムプロキシを設定する前にコアを確認

v2rayNは通常、サーバーをアクティブにした後にコアを起動または再読み込みします。メインウィンドウのログ欄を開き、最新の記録に設定解析エラー、起動失敗、ポートの競合が続いていないことを確認してください。ウィンドウが開いていても、コアが正常に動作しているとは限りません。ローカル待受が確立していなければ、システムプロキシが正しく設定されていても、リクエストを受け取るローカルサービスがありません。

ログにポートの競合が表示されたら、ほかのプロキシプログラムやクライアントの重複起動を終了してから再試行します。ポートを適当に変更し、システム設定との同期を忘れないようにしてください。設定項目がサポートされていないというログが出た場合は、クライアントのバージョンとサブスクリプション形式を確認します。内容がわからない項目を削除して、無理に起動しないでください。インストール権限、アプリの起動制限、プラットフォームの実行環境に関する問題は、全プラットフォーム向けインストール・設定ドキュメントで確認します。初回接続のために設定ファイル全体を手作業で管理する必要はありません。

コアが正常に動作したら、v2rayNのメニューから「システムプロキシを自動設定」を選びます。macOSでは「システム設定 → ネットワーク」で使用中のネットワークサービスを選択し、「詳細 → プロキシ」から設定を確認できます。項目名や階層はmacOSのバージョンによって多少異なります。有効になっているプロキシがこの端末を指し、ポートがクライアントの現在の待受設定と一致しているかを確認してください。実際に有効な項目だけを確認すればよく、一覧にあるすべてのプロキシをオンにする必要はありません。

Androidでは接続をタップし、システムのリクエストを確認する

v2rayNGのサーバー一覧から対象のサーバーを選び、接続ボタンをタップします。初回にシステムのVPN接続リクエストが表示されたら、使用中のクライアントが要求元であることを確認してから接続を許可してください。ステータスバーに接続マークが表示されれば、通信を取り込むインターフェースが確立した状態です。ただし、それだけでは接続先サーバーにアクセスできるとは限りません。同じ種類のインターフェースを使うネットワークツールが起動している場合は、先に停止してから再接続し、インターフェースの競合を避けてください。

接続後は、クライアントに用意されたテスト機能を目安として使えます。ただし、テストに失敗してもすべてのアプリがアクセスできないとは限らず、成功してもすべてのアプリが同じ経路を使うとは限りません。ひとつのテスト結果だけを見て複数の設定を続けて変更しないでください。ここではサーバー、ルーティング、通信を取り込むモードを維持し、次の手順で実際のブラウザー通信を確認します。

ステップ4：動作を確認する

システムプロキシに従うブラウザーを開き、新しいタブで、利用する権限がありプロキシルールの対象になると想定されるHTTPSサイトにアクセスします。すでに開いているページだけで判断しないでください。キャッシュ、既存の接続、バックグラウンドでの先読みがあると、正常に見えることがあります。ページを再読み込みして新たな操作を行い、クライアントのログに追加された接続記録とアクセス時刻を照らし合わせます。

ページ、ログ、システム設定を照らし合わせる

確認できる情報が一致することが重要です。ページで新しいリクエストが完了し、クライアントに対応する通信が記録され、システムプロキシまたはAndroidの通信制御状態も想定どおりであることを確認します。ログに出力タグが記録される場合は、リクエストがproxyとdirectのどちらを通ったかも確認できます。実際のタグ名は設定によって異なり、例と同じとは限りません。ルーティングモードでは直結するサイトもあるため、すべての接続にプロキシ経由の記録が必要なわけではありません。

次に、直接接続する想定のページも開き、通常のネットワーク接続に影響がないことを確認します。接続元アドレスの確認サイトを使う場合は、補助的な判断材料として扱ってください。ルーティングルールによって確認サイト自体は直接接続し、同じブラウザーのほかのリクエストはプロキシ経由になることがあります。接続元アドレスを確認する前に、そのサイトにどのルールが適用されたかを確認し、アドレスが変わらないことだけでプロキシ全体の不具合と判断しないでください。

問題が起きたら、一度に確認するのは1つの層だけ

すべてのページが開かない場合は、まずシステムプロキシを解除し、通常のネットワーク接続が戻るか確認します。Androidではv2rayNGの接続を切ってから、同様に比較してください。通常のネットワークが使えることを確認したら、クライアントに戻り、コアの状態とアクティブサーバーを確認します。ブラウザーでローカルプロキシへの接続拒否が表示された場合は、まず待受サービスとポートを確認します。リクエストがクライアントに届いてから接続先へのタイムアウトが起きる場合は、サーバーの利用状況、サブスクリプションの状態、現在のネットワーク環境を調べます。異なる層のエラーをすべてDNSの問題と決めつけないでください。

ブラウザーは正常でも特定のアプリだけ変化がない場合は、アプリ独自のプロキシ設定と、システムプロキシに従うアプリかどうかを確認します。個別に設定が必要なアプリもあれば、TUNで通信を取り込む方法が適しているアプリもあります。特定のドメインだけで問題が起きる場合は、ルーティングルールの適用先とDNSの動作を確認してください。詳しい切り分け手順は完全版ドキュメントの設定に関するよくある問題をご覧ください。まずは動作確認済みのブラウザー経路を維持し、ひとつのアプリを直すためにすべての設定を変更しないようにしましょう。

使用を終える前にネットワーク設定を元に戻す

デスクトップ版の使用を終えるときは、先に「システムプロキシを解除」してからv2rayNを終了します。メインウィンドウを閉じただけでは画面が隠れるだけの場合があり、プロセスを強制終了すると、システムプロキシが停止済みのローカルポートを指したままになることもあります。終了後にブラウザーがネットワークへ接続できなくなった場合は、システムのネットワーク設定にプロキシが残っていないかを確認し、操作前の状態に戻してください。組織が一元管理する端末では、管理設定を削除せず、変更可能な範囲を事前に確認してください。

v2rayNGでは、先に切断ボタンをタップし、システムの接続マークが消えたことを確認してからアプリを終了します。最後に、今回の確認で使えたサーバー、ルーティングプリセット、通信を取り込む方法を記録しておけば十分です。サブスクリプションURLを記録したり公開したりする必要はありません。これで、サブスクリプションの更新、アクティブサーバーの選択、リクエストの取り込み、実際のアクセスまでを一通り確認できます。今後設定を変更するときも、同じ順序で一度にひとつだけ変更し、同じアクセス先で確認しましょう。問題が起きた場合、直前の変更に原因を絞り込めます。