V2Rayインストール・設定ガイド

クイックスタートでは、初回接続までの手順を順に進められます。このページはOS別に調べられるガイドです。まず共通の準備を確認し、使用するデバイスの項目へ進んでください。クライアントのインストールが済んでいる場合は、動作確認やトラブルシューティングから直接参照できます。

v2rayN デスクトップ向け v2rayNG Android向け v2flyNG Android向け代替

共通の準備:インストールパッケージ、サブスクリプション、通信の取り込み方法

OSの種類とクライアントを確認する

デスクトップではv2rayN、Androidではv2rayNGを選びます。v2flyNGは、設定の提供元からV2Flyコアの使用を指定され、プロトコル、通信方式、安全設定がすべて対応していると確認できた場合に検討してください。クライアントは設定の保存、接続の開始、動作状態の管理を行う画面です。コアはプロキシプロトコルとルーティングを処理します。同じ形式の共有リンクを読み込めても、すべてのオプションを両方のクライアントで利用できるとは限りません。特にAndroid版はデスクトップ版の単純な移植ではありません。通信を取り込む方法や対象アプリの範囲が異なります。

クライアント一覧を開き、使用中のOSとプロセッサのアーキテクチャに合ったパッケージを選びます。アーキテクチャはシステム情報や、デバイスで利用可能なアプリのアーキテクチャを確認してください。発売時期から推測するのは避けましょう。既存のクライアントと設定はバックアップしてから、新しいパッケージを試してください。古いクライアントがバックグラウンドで動作している場合は、テスト前にタスクトレイやステータスメニューから終了します。ウィンドウを閉じるだけでは不十分です。複数のインスタンスが同じローカルポートを取り合ったり、システムプロキシ設定を書き換え合ったりすることがあります。

OSクライアント選び方
Windowsv2rayN当サイトではx64デスクトップ版と従来のWPF版を提供
macOSv2rayNApple Silicon搭載機はarm64、Intel搭載機はx64
Linuxv2rayNdebまたはrpmを選び、x64かarm64かも確認
Androidv2rayNG、v2flyNGarm64対応を確認して該当パッケージを選ぶ。不明な場合は汎用版を確認

サブスクリプションURL、個別の共有リンク、バックアップを区別する

サブスクリプションURLは、一覧を再取得するための入口です。通常はサブスクリプショングループに登録してから更新します。URLを貼り付けて保存しただけでは、一覧はダウンロードされていません。共有リンクやQRコードは通常、個別の設定を1件だけ取り込み、元のサブスクリプションに連動して更新されることはありません。クライアントのバックアップには、グループ、ルーティング、ローカル設定などが含まれる場合があります。主に同じ種類のクライアントで復元するためのもので、汎用の交換形式ではありません。デバイス間で移行するときは、必要なサブスクリプションや個別設定をコピーし、デバイスごとに通信の取り込み方法を確認してください。あるプラットフォームで出力したバックアップ全体を、別のプラットフォームにそのまま上書きしないでください。詳しくは複数デバイス間でV2Ray設定を同期する方法をご覧ください。

サブスクリプションURLにはアクセス認証情報が含まれている場合があります。公開の問い合わせ窓口、オンラインデコードツール、チャットのスクリーンショットなどに貼り付けないでください。問題を調べる際は、失敗した時刻、エラーの種類、応答ステータスを記録すれば十分です。ログを共有する前に、URLのクエリパラメーター、アカウント識別情報、サーバー情報も削除してください。更新時にログインページや案内ページが返ってくる場合、通常は提供元がクライアントで読み込める設定を返していません。インポート方法を変えるだけでは解決しません。

初回設定では接続経路を1つだけ確認する

設定を取り込んだら、利用可能と分かっている設定を1つ選び、ルーティングは初期設定のままにします。まずローカルプロキシがリクエストを処理できることを確認し、その後に通信を取り込む範囲を広げてください。デスクトップのシステムプロキシは、システム設定を参照するアプリにプロキシの入口を提供します。TUNは仮想インターフェースとルーティングを使って、選択した範囲の通信を処理します。Androidクライアントは通常、システムのVPNインターフェースを使ってアプリの通信を取り込みます。許可も接続経路を確立する手順の一部です。どの入口が動作しているかを切り分けてから、対象アプリをテストしてください。複数の取り込み方法を同時に有効にすると、通信できても、どの層が機能したのか判断しにくくなります。

Windows:v2rayNのインストールとシステムプロキシ

ダウンロード、インストール、初回起動

Windowsのダウンロードページからデスクトップ版または従来のWPF版を選びます。デスクトップ版はクロスプラットフォームのUIフレームワークを使用し、WPF版はWindows専用の画面です。ウィンドウのレイアウトや設定項目の場所が異なる場合があります。どちらか一方を選んでテストしてください。「設定 → システム → バージョン情報」を開き、システムの種類とプロセッサ情報を確認します。x64版がすべてのWindowsデバイスに適しているわけではありません。すでにWPF版を使っていて、設定だけを更新したい場合は、サブスクリプションを追加するために画面の種類を変更する必要はありません。

インストーラーは画面の指示に従って実行します。プログラムファイルを含む圧縮ファイルの場合は、すべて展開してから、現在のユーザーが読み書きできる固定のフォルダーに保存し、プログラムを起動してください。圧縮ファイルのプレビュー内から実行したり、実行ファイルだけをコピーしたりしないでください。初回起動時にランタイム不足のメッセージが表示されたら、必要なランタイムの種類とアーキテクチャを確認し、指示に従ってください。画面が開いても、GUIプログラムが起動したことを示すだけで、コアが起動したとは限りません。設定を選んだ後にログでファイルが見つからないと表示された場合は、まずパッケージ内の関連ファイルとフォルダー構成を確認し、次に使用中のコアの種類を確認してください。

サブスクリプションを更新して接続先を選ぶ

メイン画面の「サブスクリプショングループ」メニューから「サブスクリプショングループ設定」を開き、グループを追加します。「備考」と「任意のURL」を入力し、そのグループで更新が有効になっていることを確認してください。初回の確認では「フィルター」を空欄にして、ダウンロードした一覧がキーワードで除外されないようにします。保存後、「サブスクリプショングループ」に戻り、既存のプロキシを経由しない方法で現在のサブスクリプションを更新します。提供元へのアクセスに既存の接続が本当に必要な場合は、その接続が使えるかを別に確認してください。まだ存在しない接続に新しいサブスクリプションを依存させないようにします。複数の提供元を使う場合のフィルター方法は、サブスクリプショングループとサーバーフィルターをご覧ください。

更新後、一覧に表示されているのが新しいグループかどうか確認します。以前のグループや検索結果と取り違えないようにしてください。サーバーを1つ選んで接続先に設定し、設定の解析エラー、ポートの競合、起動失敗がログに出ていないか確認します。接続先を切り替えたら、テスト用のWebページを開き直すか、新しい接続を開始してください。既存の長時間接続は自動で切り替わらない場合があります。サーバー一覧に項目があるだけでは、取り込みに成功したことしか分かりません。

まずシステムプロキシを試し、必要に応じてTUNを使う

システムプロキシを参照するブラウザーでテストする場合は、v2rayNの「システムプロキシ」メニューから「システムプロキシを自動設定」を選びます。「システムプロキシを変更しない」は、クライアントがシステム設定を書き換えないという意味で、既存のプロキシを無効にすることではありません。v2rayNが設定したプロキシを解除するには「システムプロキシをクリア」を選び、Windowsの「ネットワークとインターネット → プロキシ」で状態を確認します。手動プロキシやスクリプトを使っていたデバイスでは、クリア後に記録した設定を復元する必要がある場合があります。自動で元に戻るとは限りません。

ブラウザーは使えるのに特定のデスクトップアプリが直接接続する場合は、まずアプリ独自のプロキシ設定を確認します。システム設定を参照しないプログラムも通信を取り込む必要がある場合に限り、v2rayNの「TUNを有効にする」を試してください。切り替える前に今回設定したシステムプロキシを解除し、二重に通信を取り込まないようにします。TUNは仮想インターフェースを作成してルーティングを変更するため、クライアントやシステムの指示に従って必要な権限を付与してください。テストのためにすべてのプログラムを常に管理者権限で実行しないでください。有効にした後、LANへのアクセスも変わった場合は、まずTUNを無効にして元の経路に戻し、必要に応じて個別のルーティングを検討します。

タスクトレイの残存プロセス、ポート競合、終了後の通信切断

ウィンドウを閉じてもポートが使用中と表示される場合は、タスクトレイに古いインスタンスが残っていないか、同じクライアントを別の場所から起動していないか確認します。ポートを使用しているプロセスを特定してから、古いインスタンスを終了するか、クライアントで別のポートを使うか決めてください。ポートを変更した場合は、手動設定したブラウザー、開発ツール、ターミナルも更新します。システムプロキシは新しいポートで待ち受けが始まってから再設定してください。終了後にブラウザーが使えなくなり、システムプロキシを無効にすると復旧する場合は、システムが停止済みのローカルポートを参照している可能性があります。特定のアプリだけ使えない場合は、アプリ独自のプロキシアドレスも確認してください。

macOS:チップに合ったパッケージ、ネットワークサービス、権限

ディスクイメージを選んでアプリを起動する

Appleメニューから「このMacについて」を開きます。Apple Silicon搭載機はmacOSのダウンロードページでarm64を選び、Intelプロセッサ搭載機はx64を選んでください。互換レイヤーがインストール済みでも、別アーキテクチャのパッケージを優先する必要はありません。デスクトップアプリが起動しても、同梱のコアやランタイムには独自のアーキテクチャ要件がある場合があります。パッケージを入れ替えるときは、実行中のアプリを終了してから置き換えてください。古いフォルダーと新しいフォルダーからv2rayNを同時に起動しないようにします。

ディスクイメージを開き、画面の指示に従ってアプリを「アプリケーション」へコピーします。コピー先から起動したら、ディスクイメージを取り出してください。起動場所が固定され、どのアプリが動いているかも判別しやすくなります。システムのセキュリティ警告が表示された場合は、アプリの入手元とチップのアーキテクチャを確認し、初回起動時の確認、組織のポリシーによるブロック、実行ファイルの問題を区別してください。個別アプリの問題を解決するために、システム全体のセキュリティ機能を無効にしないでください。ウィンドウが空白になったり、起動直後に終了したりする場合は、まずアプリ本体が動作しているかを確かめます。起動の問題をサブスクリプションの問題と混同しないようにしてください。

v2rayNにサブスクリプションを登録して更新する

メイン画面で「サブスクリプショングループ設定」を開き、備考を追加して「任意のURL」に提供元の完全なアドレスを入力します。保存してサブスクリプションを更新したら、該当するグループに切り替えて結果を確認してください。受け取ったものが個別の共有リンクだけの場合は、クリップボードから共有リンクをインポートする機能を使います。サブスクリプションURL欄には貼り付けないでください。URLエラーが出た場合は、分からないクエリパラメーターを削除するのではなく、説明文、改行、引用符まで一緒にコピーしていないか確認します。

一覧が取得できたら接続先を選び、ログに明らかなコア起動エラーがないか確認します。Windowsから移行する場合、同じサブスクリプションURLは再利用できますが、システムプロキシの状態やローカルファイルを参照するパスはそのまま移さないでください。同じサブスクリプションを使っていても、接続先、ルーティングのグループ、LANへのアクセス要件はデバイスごとに異なる場合があります。まず設定を1つ使える状態にし、その後で追加設定を1つずつ戻すと、取り込んだ内容とローカル設定のどちらが違いの原因か調べやすくなります。

現在のネットワークサービスのプロキシ状態を確認する

まずv2rayNで「システムプロキシを自動設定」を選び、「システム設定 → ネットワーク」から接続中のネットワークサービスを開きます。「詳細 → プロキシ」で有効な項目とローカルアドレスを確認してください。プロキシ設定はネットワークサービスごとに適用されます。Wi-Fiと有線接続を切り替えた場合は、実際に通信を担っているサービスを確認しましょう。ブラウザーでアクセスできても、ターミナルがシステムプロキシを使うとは限りません。コマンドラインのプログラムは独自の引数や環境変数を参照することがあります。ターミナルとブラウザーのテスト結果が違っても、すぐにブラウザーの結果を無効と判断しないでください。

デバイスで自動プロキシ設定ファイルを使っていた場合は、まず有効状態を記録します。テスト後は今回の変更を取り消し、元の状態に戻してください。2つの自動設定を長期間併用しないようにします。クライアントがシステムプロキシの設定に権限を求める場合は、その要求が今回の操作によるものか確認してください。管理対象のデバイスで変更が許可されていない場合は現状を維持し、アプリが対応するローカルプロキシでテストします。ローカルの入口でテストに成功しても、システム全体の設定を変更する権限があるとは限りません。

TUNとネットワーク切り替えを個別に確認する

システムプロキシを参照しないアプリの通信を取り込む必要がある場合に限り、現在のv2rayNビルドと選択したコアがTUNに対応しているかを確認し、指示に従って必要な権限を付与します。画面のスイッチがオンになることと、仮想インターフェースが通信を取り込めることは別です。クライアントのログと新しい接続で動作を確認してください。有効にした後に内部ドメインやLANサービスへ接続できなくなった場合は、まずTUNを無効にし、同じネットワークで元の経路を確認します。スリープから復帰した後や別のネットワークに切り替えた後に問題が起きた場合も、先にネットワークサービスとクライアントの状態を調べてください。切り替え後にだけ発生した問題なら、同じサブスクリプションを再インポートする必要は通常ありません。

Linux:ディストリビューションに合ったパッケージ、デスクトッププロキシ、ルーティング

パッケージ管理方式とアーキテクチャで選ぶ

Linuxのダウンロードページを開きます。DebianやUbuntuなどではdeb、Fedoraなどではrpmを選びます。パッケージ形式が合っていることは最初の条件にすぎません。ディストリビューションにパッケージが要求する依存関係があり、利用可能なグラフィカルセッションも必要です。デスクトップクライアントをGUIのない環境で動かすサービスとして扱わないでください。別の形式でもたまたま展開できるからといって、異なるパッケージ管理方式のシステムにインストールしないでください。

次の2つの読み取り専用コマンドで、マシンのアーキテクチャとディストリビューションの識別情報を確認します。一般的な出力のx86_64はダウンロードページのx64、aarch64はarm64に対応します。コンテナやリモートターミナルでコマンドを実行する場合は、デスクトップクライアントを実際にインストールするシステムを調べているか確認してください。

uname -m
grep -E '^(ID|ID_LIKE|VERSION_ID)=' /etc/os-release

ダウンロードしたパッケージは、ディストリビューションのソフトウェアインストーラーから開けます。ターミナルを使う場合は、sudo apt install またはsudo dnf install の後に、ダウンロードしたファイルの絶対パスを入力します。パスに空白が含まれる場合は、パス全体を引用符で囲んでください。依存関係の解決はパッケージ管理ツールに任せ、競合が起きたら具体的なパッケージ名を確認します。エラーを無視して強制的に進めないでください。インストール後はアプリランチャーから通常のユーザーとしてv2rayNを起動します。GUIプログラム全体を管理者権限で起動すると、設定の所有者が変わり、通常のユーザーでは保存済みのグループや設定を読めなくなることがあります。

サブスクリプションを更新してローカル待ち受けの状態を確認する

「サブスクリプショングループ設定」に備考とサブスクリプションURLを登録し、保存後に該当するグループを更新します。更新結果があるのに項目が見えない場合は、まずメイン画面の検索語を消し、グループのフィルター条件を確認してください。サーバーを選択したら、コアが正常に起動したことを確かめます。ログに起動失敗が表示される場合は、依存関係の不足、ファイルのアーキテクチャ違い、ポート競合など、ローカルの問題を先に解決します。この段階でサブスクリプションを何度更新しても、ローカルの待ち受けは開始されません。

ss -ltnで現在のTCP待ち受けアドレスとポートを確認し、v2rayNの設定値と比較できます。待ち受けがあることは、何らかのプログラムがそのポートを使用しているという意味です。v2rayNが使用していることや、リモート接続が確立したことを示すわけではありません。クライアントを起動していないのに同じ待ち受けが見える場合は、別のプロキシプログラムがないか調べてください。見覚えのないプロセスをいきなり終了しないでください。同じマシン上のアプリから接続するために、ローカルの待ち受けをすべてのネットワークインターフェースに公開する必要もありません。

デスクトップのシステムプロキシ、ターミナルの設定、TUNを分けて確認する

まずv2rayNの「システムプロキシを自動設定」を試し、デスクトップ環境のネットワークプロキシ設定を確認します。GNOMEやKDEなどでは設定画面の場所や対応範囲が異なり、アプリによっては独自の設定だけを参照します。ターミナルでプロキシ環境変数を設定しても、デスクトップアプリに反映されるとは限りません。逆に、GUIの設定を変更しても、起動済みのコマンドラインプログラムが再読み込みするとは限りません。差を調べるには、同じ接続先を明示的なプロキシとデスクトップアプリでそれぞれテストします。一方の結果からすべてのプログラムの動作を推測しないでください。

TUNを使う場合は、選択したコアがTUNモードに対応していることをクライアントのログで確認します。システムに仮想ネットワークデバイスがあり、必要なルーティング操作が許可されていることも確認してください。次の読み取り専用チェックは、「デバイスのパスが存在しない」場合と「デバイスはあるがアプリに権限がない」場合の切り分けに役立ちます。出力に問題がなくても、必要な権限があるとは限りません。コンテナや管理対象のマシンでは、外側の環境によって権限が制限される場合があります。用途に応じて管理者に許可を依頼し、デバイス全体の権限を広げる方法を一般的な対処として使わないでください。

ls -l /dev/net/tun
ip route show default

ルーティング変更でリモート接続を失わないようにする

リモートデスクトップやリモートターミナルからTUNを有効にする前に、ローカルコンソールなど復旧手段があることを確認してください。デフォルトルートに変更がなくても、ポリシールーティングによって通信経路が変わる場合があります。インストールの確認だけなら、明示的なローカルプロキシで十分です。まずネットワーク全体を変更する必要はありません。TUNを使わないモードに戻したら、デスクトッププロキシが有効なポートを参照していることを確認してから比較を続けます。Wi-Fiの切り替え後やスリープからの復帰後にだけ問題が起きる場合は、ソフトウェアを再インストールする前に通信の取り込み状態を確認してください。

Android:インストールパッケージ、サブスクリプション、VPNによる通信の取り込み

クライアントとアプリのアーキテクチャを選ぶ

Androidのダウンロードページでは、まずv2rayNGを選びます。V2Flyコアが必要で、設定との互換性も確認できている場合に限り、v2flyNGを選んでください。どちらにもarm64版と汎用版があります。プロセッサ名に「64ビット」とあっても、システム環境がarm64アプリに対応しているとは限りません。デバイスで利用できるアプリのアーキテクチャを確認してください。arm64対応が確認できたら該当パッケージを選び、判断がつかない場合は汎用版を確認します。ただし、汎用版でもシステムバージョンの要件を満たせない場合は使えません。

ダウンロードしたファイルを開くと、現在使用中のブラウザーやファイル管理アプリにインストール許可を求められる場合があります。この権限はインストール元に対するもので、接続の許可とは別です。必要な場合だけ一時的に許可し、インストール後に取り消せます。既存アプリとの競合が表示されても、すぐにアンインストールしないでください。異なる署名の同名アプリを上書きしようとしているのか、仕事用プロファイルに既存アプリがあるのかを確認します。アンインストールするとローカルのグループやルーティングが消える場合があります。信頼できる場所にバックアップしてから、移行するか決めてください。

サブスクリプションの追加と個別設定のインポート

v2rayNGではサイドメニューから「サブスクリプショングループ設定」を開き、グループを追加して備考とURLを入力します。保存したらサーバー一覧に戻り、右上のメニューからサブスクリプションを更新してください。v2flyNGでも、サイドバーのサブスクリプション設定と一覧画面の更新操作を区別します。画面によってメニュー名が異なる場合があります。共有リンクを受け取った場合は、メイン画面の追加メニューからクリップボードでインポートします。QRコードの場合はスキャン機能を使い、カメラの許可は読み取り時にのみ与えてください。

更新後に該当するグループへ切り替え、項目があることを確認してから接続先を選びます。スマートフォンでは、説明文まで含めてURLを選択しがちです。更新に失敗したら、提供元から完全なURLをコピーし直し、前後の空白を取り除いてください。パラメーターを手作業で分割・変更しないでください。個別の共有リンクだけを使っている場合は、機種変更前に共有リンクを保存するか、対応する方法でバックアップする必要があります。サブスクリプションに含まれない項目が更新で復元されることはありません。

接続を開始して対象アプリを確認する

メイン画面の接続ボタンをタップします。VPNモードを初めて使うときはシステムの接続要求を許可し、クライアントの動作状態とシステムのVPNアイコンを確認してください。デバイスの通信を取り込むにはAndroidのVPNインターフェースを使います。デスクトップの「システムプロキシを自動設定」をそのまま適用する必要はありません。別のVPNがすでに有効な場合は、仕事用プロファイル、管理対象の接続、常時接続VPNのどれなのかを確認してください。用途が分からないまま置き換えないでください。システムアイコンはインターフェースが確立したことを示すだけです。新しいリクエストで実際の接続経路も確認します。

v2rayNGで「アプリごとのプロキシ」を有効にしている場合は、テスト対象のアプリが選択範囲に含まれるか、リストが対象アプリを含める設定か除外する設定かを確認してください。アプリにチェックを入れても、現在のリストモードによっては通信が取り込まれない場合があります。ブラウザーでテストしていて、そのブラウザーが対象外なら、すべてのアプリの状態を判断する材料にはなりません。対象範囲を変更したらクライアントの指示に従って再接続し、テスト対象のアプリから新しいリクエストを送ります。すでに確立したセッションだけを見て判断しないでください。

画面ロック後の切断、ネットワーク切り替え、システムによる遮断を区別する

アプリを前面で使えるのに画面をロックすると切断される場合は、アプリのバッテリー管理、バックグラウンド制限、VPNの状態を確認します。問題が起きるアプリだけを調整し、デバイス全体の省電力機能を無効にする必要はありません。Wi-Fiでは正常でモバイルデータ通信では失敗する場合は、モバイルデータの権限とクライアントのログを確認し、同じ接続先で比較します。VPN切断後もデバイス全体がインターネットに接続できない場合は、システムVPN設定の常時接続や「VPN未接続時に接続をブロック」の設定を確認してください。管理対象デバイスの設定は管理者に確認します。こうしたシステムレベルの制限をサブスクリプションの無効化と混同しないでください。

接続確認:リクエストが失敗する段階を切り分ける

クライアントを経由しない比較用の接続を残す

接続前に、アクセス権があり普段から安定しているHTTPSページを選び、現在のネットワークで新しい接続を開始できるか記録します。ネットワークへのログインが必要な場合は、クライアントを有効にする前にシステムのログインページで認証してください。テストでは可能な限り同じネットワーク、同じURL、同じアプリを使い、サーバー、プロトコル、プロキシモードを同時に変更しないようにします。直接接続も失敗するなら、まず基本的なネットワークの問題を解決してください。そうしないと、その後の違いがクライアントによるものか、テスト先にアクセスできないためか判断できません。

次に接続先を選んでログを確認し、ローカルの待ち受け、またはAndroidのVPN状態を調べます。結果を3段階に分けてください。クライアントが設定を取得できたか、コアが動作を開始したか、リクエストが想定した入口を通ったかです。一覧に項目があることが示すのは最初の段階です。緑色のスイッチやシステムアイコンが主に示すのは2番目の段階です。3番目は、新しい接続と該当するログで確認します。ブラウザーは既存の接続やキャッシュを再利用する場合があります。開いたままのタブが表示できるかだけで判断しないでください。

デスクトップでは明示的なプロキシを使って再現性のあるテストを行う

次のコマンドは、curlがインストールされ、クライアントがループバックアドレスの10808番ポートでSOCKSサービスを提供しているデスクトップ環境向けです。まずv2rayNの設定またはログでプロトコル、アドレス、ポートを確認してください。待ち受け値が異なる場合は、実際の設定に合わせてコマンドを変更します。Windowsでは明示的にcurl.exeを使うと、コマンド環境によって短い名前が別のツールとして解釈されるのを避けられます。この例では公開されているテスト用サイトにリクエストを送り、アカウント情報は使用しません。システムプロキシも不要です。

curl --max-time 15 --socks5-hostname 127.0.0.1:10808 --head https://example.com/

--socks5-hostnameを使うと、curlがローカルで名前解決してからリクエストを送るのではなく、接続先のドメイン名をSOCKSサービスに渡して処理させます。明示的なプロキシ経由の接続確認には使えますが、ブラウザーのDNS経路や、すべてのアプリの通信が取り込まれているかまでは判断できません。ローカルポートに接続できない場合は、待ち受けアドレスとプロトコルを確認します。ローカルの待ち受けに接続できた後でタイムアウトする場合は、そのリクエスト付近のログで送信処理、名前解決、リモートとのハンドシェイクを調べてください。HTTP応答が返れば、リクエストが何らかの応答可能なサービスまで届いたことを示します。ただし、一部のステータスコードは接続先による拒否を意味するため、すべてをネットワーク障害と見なさないでください。

通信の入口、ルーティング、名前解決を分けて確認する

明示的なプロキシで成功するのにブラウザーが使えない場合は、まずブラウザーがシステムプロキシを参照しているか、独自の設定で上書きされていないか確認します。TUNだけで失敗する場合は、TUNの起動ログと影響を受けるアプリを調べ、LANへの接続やネットワーク切り替え時の状態を比較してください。ドメインによる振り分けが期待どおりでない場合は、そのリクエストがクライアントに取り込まれているか確認してから、ドメインルールとルールの優先順を調べます。入口で通信が取り込まれていなければ、ルーティングルールを何十件変更してもリクエストには影響しません。

同じドメインが複数のアドレスに解決される場合があります。ドメインルールとIPルールも同じ層ではありません。アプリが独自に名前解決し、IPアドレスをクライアントに渡す場合、期待するドメインルールに一致しないことがあります。IPアドレスを直接入力すると、HTTPS証明書や仮想ホストの設定によって失敗する場合があるため、DNS障害ではない証拠とは限りません。ログにルールや送信先の情報がある場合は、実際に一致した内容を優先して確認します。ルールデータベースの確認が必要な場合は、GeoIP・GeoSiteルールデータベースの更新方法を参照してください。同じ比較の中で、データベースとルーティングの順序を同時に変更しないでください。

設定のよくある問題:症状から次の確認項目を探す

更新に失敗する/更新成功後も一覧が空

更新リクエストが失敗した場合は、どのグループを確認しているか、今回のリクエストが既存のプロキシを経由する設定だったかを確認します。初回インポートでよくある誤りは、まだ接続できないプロキシ経由で新しい設定を取得しようとすることです。更新結果は、リクエストを送信できたか、提供元が内容を返したか、その内容をクライアントが読み込めたかに分けて確認します。タイムアウトならネットワーク経路を調べます。アクセス拒否が明示されている場合は、提供元に認証や接続先を確認してください。内容を読み込めない場合は、対応するサブスクリプション形式か、ログインページか、別種の設定ファイルかを確認します。必要のない第三者サービスにサブスクリプションの内容を貼り付けないでください。

成功のメッセージが出ても項目が表示されない場合は、該当するグループに切り替えて検索を解除し、グループのキーワードフィルターを一時的に無効にして再更新します。他のグループに項目がある場合は、すべての設定を消す必要はありません。削除して作り直す前に、ローカルで編集した項目がないか、更新時にクライアントが既存項目を置き換えるかを確認してください。共有リンク1件だけが非対応の場合は、その項目だけを個別にテストし、すべての提供元を同じグループにまとめないでください。画面操作のよくある質問はFAQをご覧ください。

一覧には表示されるが、接続先の起動時にエラーが出る

接続先が選択されているか確認してから、実質的な内容がある最初のエラーを読みます。アドレス、プロトコル、通信方式、安全設定は互いに適合している必要があります。たとえば、インポート後にサーバーアドレスは表示されていても、通信方式のパラメーターが正しく認識されていないと、一覧は正常に見えても起動やハンドシェイクに失敗する場合があります。エラーが未対応の設定項目やプロトコルを示している場合は、使用中のコアを確認し、提供元に互換性のある設定を依頼してください。ハンドシェイクの一般的な対処としてTLS検証を無効にしないでください。まずシステム時刻、接続先アドレス、サーバー名など、一致しているべき設定を確認します。

ポート競合、ファイルパスの欠落、権限不足、アーキテクチャの誤りが表示される場合は、まずローカル環境を修正します。これらの問題はサーバーに接続する前に発生するため、一覧のサーバーを何度切り替えても解決しません。ローカルのコアは起動するのに、特定の設定だけハンドシェイクに繰り返し失敗する場合は、同じネットワークで利用可能と分かっている別の設定と比較してください。両方とも失敗する場合は、共通の入口とルーティングを再確認します。すべての症状を1つの設定だけの問題と決めつけないでください。

ブラウザーは使えるが他のアプリは使えない/終了後に通信できない

アプリごとに通信の入口は異なります。デスクトップではアプリ独自のプロキシ、システムプロキシ、ターミナルの環境変数を確認します。Androidではアプリごとの対象範囲とシステムVPNの状態を確認してください。プロキシ環境での動作を禁止するアプリや、特定の社内ネットワークへのアクセスが必要なアプリもあります。通信を取り込む範囲を無理に広げるのが適切とは限りません。クライアント終了後にデスクトップのブラウザーだけ使えなくなった場合は、システムやブラウザーがローカルプロキシを参照したままになっていないか確認します。Androidで切断後にすべてのアプリへ影響が出る場合は、VPN未接続時の通信をブロックするシステム設定も調べてください。

復旧時は変更した順序の逆から戻します。まず今回有効にしたTUNを停止するかVPNを切断し、次に今回設定したシステムプロキシやアプリ独自の設定を確認し、最後に基本ネットワークを再確認します。組織が配布したプロキシやVPNのポリシーを消去せず、最初から再インストールしないでください。再インストールでプログラムファイルは置き換えられても、システムプロキシ、既存の設定フォルダー、デバイス管理ポリシーが消えるとは限りません。インストールファイルの破損、アーキテクチャの誤り、更新の競合を特定できた場合に限り、再インストールを対処として検討します。

「接続できない」だけでなく、切り分け結果を記録する

OSとアーキテクチャ、クライアント名、通信の取り込み方法、接続先を選択したか、更新・起動・新規接続のどの段階で失敗したかを記録します。同じネットワークで明示的なプロキシは成功するがシステムプロキシは失敗する、あるいはネットワーク切り替え後にだけ失敗するといった比較結果も役立ちます。ログは再現した時刻付近の必要な部分だけ残し、サブスクリプションURLとアカウント情報を削除してください。最初からやり直す場合はクイックスタートに戻り、インポート、選択、通信の取り込み、動作確認の手順だけをやり直します。確認に成功した後で、このページの該当するプラットフォームの項目を参照し、追加設定を戻してください。