全プラットフォームガイド · インストールと設定
全プラットフォーム対応 V2Ray インストール・設定ガイド
初めて設定する場合は、クイックスタートガイドに沿って、インポート、接続、動作確認まで進めてください。このページはOS別に参照できるマニュアルです。該当する章から始め、OSをまたぐ問題はサブスクリプション、プロキシの接続方法、トラブル対処の各項目を確認してください。デスクトップではv2rayN、Androidではv2rayNGをおすすめします。
共通の準備:パッケージ、サブスクリプション、権限
| 項目 | 確認場所 | 推奨事項 |
|---|---|---|
| OSとアーキテクチャ | システム情報 | アーキテクチャを確認してからパッケージを選ぶ |
| サブスクリプションURL | プロバイダーのアカウントまたはドキュメント | URL全体をコピーし、公開しない |
| 初回の動作確認 | クライアントのログとブラウザー | まず単一ノードで確認し、その後に通信の取り込み方法を調整する |
端末シリーズではなく、実際のアーキテクチャでパッケージを選ぶ
クライアントを入手ページでOSを選び、アーキテクチャとパッケージ形式を確認してください。x64とx86-64は同じ種類のアーキテクチャを指し、arm64はシステム情報ではAArch64と表示されることがあります。OS名だけでアーキテクチャを判断することはできません。デスクトップ端末のプロセッサメーカーと配布パッケージ名も別のものです。たとえばLinux向けパッケージにamd64と記載されている場合、通常は同じアーキテクチャのIntelプロセッサでも利用できます。ダウンロードページに掲載されるアーキテクチャは、そのプラットフォームの一部に限られる場合があります。該当する選択肢がない場合は、OSの種類とリリース情報を確認し、別プラットフォームのパッケージを代用しないでください。古い端末では、OSのバージョンがクライアントの最低要件を満たすかも確認してください。
サブスクリプション、ノード、プロキシの接続先を区別する
サブスクリプションURLはノード一覧を取得するためのものです。ノード情報にはプロトコル、接続先アドレス、ポート、通信パラメーターが含まれます。ローカルプロキシの接続先は、端末上のアプリからクライアントへ通信を渡すために使います。この3つは別のものです。サブスクリプションの更新に成功した場合、取得したデータを認識できたことは示しますが、すべてのノードへの接続を保証するものではありません。反対に、サブスクリプションのサイトに一時的に接続できなくても、インポート済みのノードがすぐに使えなくなるとは限りません。問題を記録するときは、更新、コアの起動、接続先へのアクセスのどの段階で失敗したかを明確にし、確認する層を判断してください。
インポート前に、受け取ったものがサブスクリプションURLか、単一ノードの共有リンクかを確認してください。前者はサブスクリプショングループに追加して手動更新し、後者はクリップボードまたはQRコードからインポートします。ノード共有リンクやサブスクリプションURLにはアクセス認証情報が含まれることがあります。オンライン解析サービスに貼り付けたり、QRコードが写った画像を公開の場で共有したりしないでください。手動で追加したノードとサブスクリプションのノードを区別できるよう、提供元や用途に基づいてグループ名を付けましょう。サブスクリプションを更新する前に、現在選択中のノードとグループを記録してください。更新によって項目が再作成される場合があり、サブスクリプションのノードを手動で編集した設定が上書きされることもあります。
テストの基準を決めてから設定を変更する
開始前に、システムプロキシの現在の状態、ほかに通信を取り込むネットワークツールが動作しているか、クライアントの現在のモードを記録してください。組織のプロキシ、固定スクリプト、手動の例外ルールにも用途があるため、インストール前に削除すべき残存設定とは限りません。テストには、普段アクセスできるHTTPSページを固定の接続先として選びます。同じネットワーク、同じノード、同じブラウザーを使い、まず通信の取り込みを無効にした状態を確認してから、設定を一度に1つだけ変更してください。ブラウザーにプロキシ拡張機能が入っている場合や独自のプロキシ設定を使っている場合は、テスト前にシステム設定を上書きしていないか確認してください。デスクトップではシステムプロキシの動作確認が済むまでTUNを急いで有効にする必要はありません。AndroidではシステムVPNの許可を使って通信を取り込みます。
初回の接続では、カスタムDNS、手動ルーティング、ログイン時の自動起動を同時に有効にしないでください。接続できたら必要な設定を1つずつ追加し、変更ごとに同じテストを繰り返します。クライアントのログと実際のページ表示を併せて確認してください。トレイアイコンの色が変わっても、画面上の状態が変化したことしか分かりません。また、ページが正常に表示されてもキャッシュによる可能性があります。ページを再読み込みし、同じ時間帯のログと照合して、リクエストが想定した接続先に送られたことを確認してください。サポートを求める場合は、OS、パッケージ形式、失敗した段階、個人情報を伏せたエラー情報を共有し、設定全体のエクスポートは送らないでください。
Windows:v2rayNデスクトップ版とWPF版
| 設定項目 | 選択肢 | 推奨事項 |
|---|---|---|
| 配布形式 | デスクトップ版 / WPF版 | 新規導入ではデスクトップ版から開始。必要に応じてWPF版を選択 |
| システムプロキシ | 自動設定 / 解除 | まずシステムプロキシを読み取るアプリで確認 |
| TUN | 有効 / 無効 | 権限とルーティングの要件を確認してから有効化 |
画面の種類と実行場所を選ぶ
Windowsのダウンロードページで、v2rayNデスクトップ版と従来のWPF版から選択してください。デスクトップ版はクロスプラットフォームのUIを採用しており、異なるデスクトップOS間で操作感をそろえやすいのが特長です。WPF版は従来のWindows画面に慣れている方や、既存の作業手順を引き継ぎたい方に適しています。主な違いは画面と実行環境で、サブスクリプションURLの種類ではありません。同じPCで配布形式を切り替えるときは、まず旧クライアントをトレイから完全に終了してください。2つのコアが同じローカルポートを使おうとしたり、2つのプロセスがシステムプロキシ設定を交互に書き換えたりするのを防げます。
圧縮ファイルをダウンロードした場合は、まず書き込み可能なユーザーフォルダーにすべて展開してから、メインプログラムを実行してください。圧縮ファイルのプレビュー画面から直接起動しないでください。インストーラーをダウンロードした場合は、画面の案内に従ってインストールし、スタートメニューまたは作成されたショートカットから起動します。実行コンポーネントが見つからないというエラーが出たら、エラーに記載されたランタイム名とアーキテクチャを記録し、その配布形式の説明に従って必要なものを追加してください。検索結果から同名のライブラリファイルだけをダウンロードして、アプリのフォルダーに入れるのは避けてください。組織のセキュリティポリシーによって実行がブロックされた場合は、保護機能を無効にして無理にインストールせず、端末の管理者に許可を確認してください。
グループをインポートしてシステムプロキシを設定する
サブスクリプショングループの設定を開き、名前と完全なサブスクリプションURLを追加して保存した後、そのグループを更新します。ノードが表示されたら1つ選択し、アクティブサーバーに設定してください。まずログを確認し、コアの起動失敗やポートのバインドエラーがないか調べます。次にトレイメニューから「システムプロキシを自動設定」を選択します。Windowsのネットワーク設定でプロキシの状態を確認し、ブラウザーから固定のテスト先にアクセスしてください。システムプロキシが設定済みなのにブラウザーがプロキシを使わない場合は、ブラウザーのプロキシ拡張機能、アプリ独自の通信設定、管理ポリシーを確認します。メインウィンドウを閉じても、トレイに最小化されるだけの場合があります。クライアントが終了したことや、以前のシステム設定に戻ったことを意味するわけではありません。
TUN、ポートの競合、終了後に残る設定への対処
システムプロキシを読み取らないアプリの通信も取り込む必要がある場合は、まず現在の設定を記録し、画面の案内に従ってTUNに必要な権限を許可してください。初期化に失敗したら、ログを見て仮想インターフェースの作成、ルートの変更、コアの起動のどの段階で失敗したかを切り分けます。ほかにネットワークを取り込むクライアントがあれば、一度終了して単独でテストしてください。2つのツールが同じデフォルトルートを奪い合う状態を常用しないでください。有効化後は、LAN内のリソースや職場のネットワークに従来どおりアクセスできることも確認します。想定以上の範囲が取り込まれている場合は、まずTUNを無効にして基準状態に戻し、その後ルートを個別に調整してください。
次のコマンドはPowerShellでTCPの待ち受け状態を確認します。ポート番号はよく使われるローカルSOCKSポートの例です。クライアント画面に別の値が表示されている場合は、その値を使ってください。出力のOwningProcessは、タスクマネージャーのプロセスIDと照合できます。何も表示されない場合に分かるのは、そのポートでTCPの待ち受けが確認できなかったことだけです。リモートサーバーが稼働しているかどうかは判断できません。
Get-NetTCPConnection -State Listen -LocalPort 10808 -ErrorAction SilentlyContinue
ポートが使用中の場合は、まず該当プロセスが古いコア、別のローカルサービス、今回のクライアントのどれかを確認してください。待ち受けポートを変更する場合は、アドレスを手入力したアプリの設定も合わせて更新します。クライアントを終了した後にウェブページが表示できなくなった場合は、システムのプロキシ設定が停止済みのローカルプロキシを指したままになっていないか確認してください。組織のプロキシを使っていた端末では、すべて消去するのではなく元の設定に戻してください。画面の選び方やインストール方法については、Windowsデスクトップ版とWPF版のインストールガイドも参照してください。
macOS:チップに合ったパッケージとネットワークサービス
| 項目 | 確認場所 | 推奨事項 |
|---|---|---|
| チップ | このMacについて | Apple Siliconはarm64、Intelはx64を選択 |
| システムプロキシ | 現在のネットワークサービスのプロキシ設定 | ネットワークサービスを切り替えたら再確認 |
| TUN | クライアントの切り替えとログ | 権限とルートを個別に確認 |
アプリケーションフォルダーにインストールしてから初回起動
システムメニューから「このMacについて」を開き、AppleチップかIntelプロセッサかを確認してから、macOSのダウンロードページで対応するv2rayNディスクイメージを選んでください。Macの購入年だけで判断したり、標準パッケージを使うために別アーキテクチャの実行環境を追加したりする必要はありません。ダウンロードしたイメージを開き、画面の案内に従ってアプリを「アプリケーション」フォルダーにコピーします。コピーしたアプリを起動してから、ディスクイメージを取り出してください。イメージ上のアプリを実行したままだと、後でアプリを入れ替える際や起動元を確認する際に分かりにくくなります。アプリのコピーが複数ある場合は、古いものを終了し、コピーしたばかりのアプリが起動していることを確認してください。
初回起動時の警告が表示されたら、アーキテクチャの不一致、OSのバージョンが古い、配布元を確認できない、端末管理ポリシーによるブロックのどれに該当するかを確認してください。状況によって対処方法は異なります。配布元と端末のルールを確認したうえで、システムが許可する単一アプリ向けの承認手順だけを利用してください。組織管理の端末の場合は管理者に相談してください。システム全体のアプリ審査設定を変更しないでください。アプリのウィンドウは開くのにコアが起動しない場合は、実行権限、実行コンポーネント、設定の解析のどこで問題が起きているか、ログを確認してください。ウィンドウが開いたからといって、インストールがすべて正常に完了したとは限りません。
サブスクリプションを追加し、現在のサービスを確認する
v2rayNでサブスクリプショングループを新規作成し、URL全体を貼り付けて保存した後、手動で更新します。アクティブノードを選択したら、まずローカルの待ち受け状態を確認し、その後システムプロキシの自動設定を有効にしてください。システム設定の「ネットワーク」を開き、使用中のWi-Fiまたは有線サービスを選択して、詳細情報にある「プロキシ」を確認します。プロキシ設定はネットワークサービスごとに保存されます。2つのサービスを使っている場合は、一覧の先頭にあるサービスだけでなく、実際に使用中のサービスを確認してください。OSのバージョンや表示言語によってメニュー名は異なることがあるため、現在のサービスに表示される設定を基準にしてください。
オフィスの有線ネットワークで設定した後、自宅でWi-Fiに切り替えると動作が変わる場合は、Wi-Fiサービスのプロキシ状態を改めて確認し、クライアントが設定を再適用したかも確認してください。ネットワーク接続前にウェブ認証が必要な場合もあります。その場合、サブスクリプションの更新失敗がノードの問題とは限りません。次の2つのコマンドはネットワーク状態を読み取るだけです。1つ目はネットワークサービスの順序と、サービスとデバイスの対応関係を確認します。2つ目は現在のシステムプロキシの概要を表示します。プロキシが有効なら、クライアント画面に表示されたローカルポートと照合してください。概要に問題がなくても、すべてのアプリがプロキシを使うとは限りません。
networksetup -listnetworkserviceorder
scutil --proxy
TUNとスリープ復帰後の状態を確認する
システムプロキシを読み取らないアプリでTUNを使う場合は、まず比較用のシステムプロキシを無効にし、現在のパッケージがTUNに対応していることを確認してから、クライアントでTUNを有効にして画面の案内どおりに許可します。インターフェースの初期化、固定のテスト先へのリクエスト、直結のままにするローカルリソースの順に確認してください。端末に既存のVPN、プロキシ設定、管理対象のフィルター機能がある場合は、組織の設定を勝手に無効にしないでください。許可されたネットワークと端末で個別にテストできます。モードを切り替えても、既存の接続がすぐに再確立されるとは限りません。開いたままのページを見るだけでなく、テストアプリを終了するか、接続を新たに開始してください。
スリープからの復帰後やネットワーク切り替え後に接続が不安定になる場合は、スリープ前のインターフェースと復帰後の実際のインターフェースを記録し、古い接続だけに問題があるか確認してください。新しい接続も失敗する場合は、クライアントのコアが動作中か、ネットワークサービスのプロキシが有効な待ち受け先を指しているか、TUNが再確立されているかを確認します。復旧時は、まずクライアントから該当モードを無効にし、現在のネットワークサービスの状態を確認してください。すべてのネットワーク設定をリセットする必要はありません。問題を安定して再現できるようになってから、ログイン時の自動起動を有効にするか検討します。先に自動起動を設定すると、残存設定や起動順序の問題を切り分けにくくなります。
Linux:deb、rpm、デスクトップセッション
| 項目 | 選択肢 | 推奨事項 |
|---|---|---|
| パッケージ形式 | deb / rpm | ディストリビューションのパッケージ管理方式に合わせて選択 |
| 環境変数によるプロキシ | デスクトッププロキシ / プロセス環境変数 | GUIアプリとターミナルプログラムを区別する |
| 仮想インターフェース | TUN | 対応状況と権限を先に確認 |
ディストリビューションとプロセッサアーキテクチャに合わせてインストール
Debian、Ubuntuでは通常deb、Fedora、openSUSEではrpmを選びます。ただし、rpm形式が同じでも依存関係が完全に同じとは限りません。Linuxのダウンロードページで対応するOSのリリース情報を確認し、x64またはarm64を選択してください。uname -mでマシンのアーキテクチャを、cat /etc/os-releaseでディストリビューションを確認できます。コンテナやリモートホストでコマンドを実行する場合、表示されるのはその環境の情報であり、GUIクライアントを実行するデスクトップの情報とは限らない点に注意してください。パッケージをインストールするために、別のディストリビューションのソフトウェアリポジトリをシステムに追加しないでください。
まずデスクトップのソフトウェアインストーラーでローカルのパッケージを開いてください。ターミナルからインストールする場合は、以下にDebian系、Fedora、openSUSEのコマンド例を示します。該当するものを1つだけ選んでください。例では、選択した実際のパッケージを現在のディレクトリに置き、指定の短いファイル名に変更してあるものとします。実際のパスに置き換えても構いません。パスに空白が含まれる場合は引用符で囲んでください。パッケージマネージャーが依存関係の不足や競合を報告した場合は、依存関係の確認を無視して進めないでください。
sudo apt install ./v2rayn.deb
sudo dnf install ./v2rayn.rpm
sudo zypper install ./v2rayn.rpm
実際に使うデスクトップセッションでインポートして動作確認
インストール後、普段使っているユーザーアカウントでアプリメニューからv2rayNを起動してください。インストール時に管理者権限を使ったからといって、日常のGUI操作にも管理者アカウントが必要なわけではありません。通常のユーザーアカウントでサブスクリプショングループを追加して手動更新し、アクティブノードを選択してから、ログでコアと待ち受けの準備ができているか確認します。アプリメニューに項目が見つからない場合は、まずインストール処理が完了しているか確認し、デスクトップセッションに再ログインしてメニューを更新してください。別ユーザーの設定ディレクトリから管理者権限で起動し、パスや権限の問題をごまかさないでください。
GNOMEとKDE Plasmaでは、システムプロキシの設定に異なる仕組みが使われる場合があります。ターミナルプログラムも、プロセス環境変数や独自設定だけを参照することがあります。起動時にプロキシ設定を読み込むアプリでは、デスクトップのプロキシを変更した後にアプリを再起動してテストしてください。ブラウザーではアクセスできてもパッケージマネージャーでは失敗する場合は、後者がどのプロキシ設定を参照しているか確認します。管理者権限で起動したプロセスは、通常ユーザーの環境変数を引き継がないことがあります。次のコマンドはローカルの待ち受けを確認するだけで、デスクトップやターミナルのプロキシ設定は変更しません。画面に別のポートが表示されている場合は、その実際のポートに合わせて条件を変更してください。
ss -ltn 'sport = :10808'
仮想インターフェースとログイン時の自動起動を確認
TUNが必要な場合は、システムに/dev/net/tunがあることを確認し、クライアントが要求する権限がリリース情報に従って付与されているかも確認してください。デバイスパスが存在していても、現在のプロセスが必ず開けるとは限りません。また、システムルートを変更できることも保証されません。コンテナや管理対象のセッションでは、インターフェースとルートの権限がホスト環境によって制限される場合があります。ログにインターフェースの作成失敗が記録されていたら、デバイスが利用できないのか権限が不足しているのかを切り分けてください。インターフェースは作成できたのに特定の接続先だけ失敗する場合は、アプリの権限をさらに広げるのではなく、ルートとDNSを確認します。
手動接続が安定してから、ログイン時の自動起動を設定してください。デスクトップセッションの自動起動と、システムサービスの起動時実行は別のものです。前者はユーザーのGUIセッションでデスクトップ設定を利用できますが、後者はログイン前に動作するため、同じデスクトッププロキシ設定やユーザーディレクトリを使うとは限りません。自動起動を確認するときは、ログアウトして再度ログインし、トレイ、アクティブノード、ログを確認してください。バックグラウンドプロセスが見えるだけでシステムプロキシが有効だとは判断できません。自動起動時だけ失敗する場合は、ネットワークの準備順序や古いプロセスの二重起動を確認してください。Linuxのパッケージ導入と自動起動ガイドも参照してください。
Android:サブスクリプショングループとVPNによる通信の取り込み
| 項目 | 選択肢 | 推奨事項 |
|---|---|---|
| クライアント | v2rayNG / v2flyNG | v2rayNGを推奨。プロトコル要件に応じて別のクライアントを選択 |
| APKのアーキテクチャ | arm64 / 汎用版 | 専用パッケージは、システムがarm64に対応していることを確認してから選ぶ |
| 通信の取り込み方法 | Android VPNサービス | 初回起動時に許可を求めているアプリを確認 |
クライアント、アーキテクチャ、入手元を選ぶ
Androidのダウンロードページで、まずXrayコアを使用するv2rayNGを選んでください。V2Flyコアが必要な場合に限り、v2flyNGを検討します。2つのクライアントでは、対応するノード形式や設定項目が異なる場合があります。クライアントを切り替える前に、サブスクリプションのプロトコルと通信方式の要件を確認してください。インポートできるかどうかだけで、接続できるかを判断しないでください。比較的新しいAndroid端末の多くは、まずarm64パッケージを利用できるか確認できます。対応アーキテクチャが分からない場合は、汎用版を選んでください。プロセッサが64ビットに対応していても、システムがそのアーキテクチャのアプリのインストールを許可するとは限りません。
ダウンロードしたAPKを開くと、ブラウザーやファイル管理アプリなど、現在インストールに使っている入手元の許可を求められる場合があります。実際にAPKを開いた入手元だけに必要な許可を与え、完了後に一時的な許可を取り消すこともできます。端末が組織管理下にあり、こうしたインストールが禁止されている場合は、まず端末のルールを確認してください。インストールに失敗した場合は、パッケージの不適合、ストレージ不足、旧アプリを上書きできない状態を切り分けます。バックアップせずにアンインストールしないでください。サブスクリプション、手動ノード、アプリごとの設定が削除される可能性があります。
サブスクリプションを追加・更新してサービスを起動
v2rayNGでサブスクリプショングループの管理画面を開き、新しいグループを作成してURL全体を入力します。一覧に戻ってサブスクリプションを更新し、結果がそのグループに表示されたことを確認してからノードを選択してください。QRコードを受け取った場合は、単一ノードのリンクかサブスクリプションの入口かを確認し、クライアントの対応するインポート機能を使います。画像をアップロードする認識サービスは使わないでください。手動でインポートしたノードとサブスクリプショングループは別々に管理すると、更新後に選択中のノードが消えたと誤解しにくくなります。
接続を開始すると、AndroidにVPN接続のリクエストが表示されます。現在選択しているクライアントからの要求であることを確認してから許可してください。この許可によって、クライアントはシステムが提供する仮想ネットワークインターフェース経由で通信を受け取ります。Wi-Fiの手動プロキシ設定を変更する必要はありません。ステータスバーにVPNアイコンが表示されても、サービスが確立したことしか分からず、アクティブノードのハンドシェイク成功までは確認できません。接続経路に影響するほかのネットワークツールをいったん無効にし、ブラウザーで新しいページを開いて、同じ時間帯のクライアントログと照合してください。Wi-Fiとモバイルデータを比較する場合は、毎回ネットワークだけを切り替え、同じノードとテストアプリを使ってください。
アプリごとの設定、常時接続、バックグラウンドでの切断
アプリごとの設定を使う場合は、画面で現在選択されているのが「許可リスト内のアプリのみ」か「除外リスト内のアプリ」かを確認してください。同じブラウザーがリストにあっても、モードによって意味が逆になります。まずテスト用アプリ1つだけで確認し、その後ほかのアプリを追加してください。対象アプリが仕事用プロファイル内にある場合や端末ポリシーで管理されている場合、個人用プロファイルのクライアントでは通信を取り込めないことがあります。1つのアプリの問題を調べるために、最初からアプリごとの設定、常時接続VPN、VPN切断時の通信遮断を同時に有効にしないでください。
バックグラウンドに移動したり画面を消したりした後に切断される場合は、まず通知とクライアントログを確認してください。サービスが停止したのか、Wi-Fiからモバイルデータに切り替わったのか、ノードは選択されたままなのに新しい接続だけが失敗するのかを切り分けます。バックグラウンド制限が原因だと分かってから、システムで許可されている方法で、そのクライアントのバッテリー使用制限とバックグラウンド動作の設定を確認してください。すべてのアプリが突然接続できなくなった場合は、システムが現在どのVPNアプリを使用しているか、VPN切断時にネットワークを遮断する設定が有効かを確認します。設定を戻す前に、自分または管理者が設定したものかどうかを確かめてください。v2rayNGとv2flyNGを比較するときは、誤ってVPNの切り替えをノード切断と判断しないよう、同時に実行するのは1つだけにしてください。
システムプロキシとTUN:通信の取り込み範囲と確認方法
| 接続方法 | 適用範囲 | 推奨事項 |
|---|---|---|
| システムプロキシ | システムプロキシを読み取るアプリ | デスクトップでの初回接続確認におすすめ |
| ローカルSOCKS | SOCKSを手動指定できるアプリ | 個別アプリの診断に使用 |
| TUN | 仮想インターフェースに入る通信 | 対象範囲を広げる前にルートとDNSを確認 |
システムプロキシが入口を、ルートが出口を決める
デスクトップクライアントのシステムプロキシ設定は、通常、OSのプロキシ設定をローカルの待ち受け先に向けるために使います。アプリがこの設定を参照して初めて、リクエストがクライアントに送られます。あるブラウザーがプロキシを使っていても、ターミナル、バックグラウンドの更新プログラム、LAN内のアプリも同じ接続方法を使うとは限りません。クライアントのルーティング設定は、すでにクライアントに渡されたリクエストを処理します。ドメイン名やアドレスなどの条件に応じて、プロキシ経由、直接接続、ブロックを選べます。ルーティングをグローバルにしても、システムプロキシを読み取らないアプリから通信が送られるわけではありません。反対に、TUNを有効にしても、すべての接続先が必ずリモートノード経由になるとは限りません。
リクエストを1回だけ送ってローカルプロキシを切り分ける
デスクトップOSにcurlがインストールされている場合は、システムプロキシの選択を一時的に迂回し、ローカルのSOCKSアドレスを直接指定してテストできます。コマンドでは例示用の公開ドメインを使用しています。実際の調査では、アクセスできることが分かっているHTTPSの接続先に置き換えてください。クライアントがSOCKS接続を提供していることを確認し、ポート番号も画面と一致させます。HTTPプロキシのポートやリモートノードのポートを指定しないでください。Windows PowerShellでは同名の別名が呼び出されないよう、curl.exeを使用できます。例のsocks5hは、curlがローカルで名前解決するのではなく、接続先のホスト名をSOCKSサービスに渡す指定です。これだけで、クライアントがその後に特定のDNSサービスを使うとは限りません。
curl --noproxy "" --proxy socks5h://127.0.0.1:10808 --max-time 15 -I https://example.com/
ローカル接続が明示的に拒否された場合は、まず待ち受けポートとプロセスの状態を確認してください。ローカルサービスには接続できたものの、接続先からの応答待ちでタイムアウトした場合は、ログのルーティングとリモート接続を確認します。接続先からHTTP応答が返った場合、このリクエストがアプリケーション層の応答を受け取ったことは分かりますが、ほかの接続先、アプリ、UDP通信が正常かどうかは判断できません。接続先がHEADリクエストに対応していない場合は、通常のGETリクエストでもう一度確認できます。診断後に、ついでにローカル待ち受けをLAN内から接続可能な状態に変更しないでください。同じ端末からのテストにはループバックアドレスで十分です。ほかの端末に公開すると、アクセス範囲が変わります。
TUNを有効にしてルートとDNSを確認
TUNは仮想ネットワークインターフェースを使い、OSのルーティングによって振り分けられた通信を受け取ります。まず比較用としてシステムプロキシを無効にした状態で、同じテストアプリを使い、その後TUNだけを有効にしてください。確認するのは、通信を取り込む対象のアプリ、直結を維持するローカルサービス、ドメイン名でアクセスするテスト先の3つです。TUNを有効にしたときだけLAN内のリソースに接続できない場合は、LANのサブネットとインターフェースの選択を確認します。ネットワーク自体は到達可能なのにドメイン名だけ失敗する場合は、DNSリクエストの経路を確認してください。最終確認にIPアドレスだけを使わないでください。HTTPS証明書、仮想ホスト、ルーティングルールがドメイン名に依存している場合があります。
対応するコアと設定では、FakeDNSがドメイン名に仮想アドレスを返し、通信がクライアントに入った後、マッピングを使って元のドメイン名を特定できます。この仕組みが機能するには、DNS問い合わせと接続の処理経路が連携している必要があります。アプリが独自に名前解決する場合、モード切り替えをまたいでDNSキャッシュが残る場合、または仮想アドレスが想定したインターフェースに入らない場合は、想定と異なる結果になることがあります。通常のインストールでは、この機能を有効にする必要はありません。特定の通信をドメイン名に基づいて処理する必要があると確認できた場合にのみ、利用を検討してください。まず無効時の状態を記録してから、この設定だけを変更します。仕組みはFakeDNSの仮想アドレスマッピング解説を、用語は用語集を参照してください。
設定時によくある問題:失敗した段階から確認する
| 症状 | 最初に確認する項目 | 次の手順 |
|---|---|---|
| 一覧が空 | サブスクリプションの更新結果 | グループと返されたデータの種類を確認 |
| ローカル接続が拒否される | クライアントの待ち受け状態 | ポート、プロセス、起動エラーを確認 |
| 一部のアプリだけ失敗 | アプリの通信がクライアントに届いているか | システムプロキシ、TUN、アプリごとの設定を比較 |
まず状況を記録:再現できるテストを1回行う
問題を「システムプロキシを無効にすると同じブラウザーでテストページを開けるが、有効にするとローカル待ち受けエラーが出る」のように、検証できる短い文にまとめてください。「接続できない」とだけ書くのは避けます。テスト時のネットワーク、プロキシモード、アクティブなグループ、接続先を記録し、そのリクエストを含む範囲のログを必要最小限だけ保存します。ログにサブスクリプションのクエリパラメーター、アカウント情報、ノードのアドレスが含まれている場合は、他者に送る前に伏せてください。再テストではネットワーク、ノード、コアを同時に切り替えないでください。接続が戻っても、どの変更を維持すべきか分からなくなります。
ログの最後の行だけを見るのではなく、問題に関係する最初のエラーを確認してください。設定の解析失敗、ポートのバインド失敗、リモートとのハンドシェイク失敗は、それぞれ発生段階が異なります。前の段階で失敗していれば、その後のタイムアウトは結果にすぎない可能性があります。1回の遅延テストだけでは、実際のアクセス状況は判断できません。テストがサーバーのポートまでしか確認していなかったり、実際とは異なるリクエスト先を使っていたりする場合があります。遅延の結果は、テストの種類、ログの時刻、実際にアプリを使ったときの状態と併せて判断してください。近い段階から順に調べる方法は、ノードのタイムアウト・接続できない場合のトラブル対処を参照してください。
よくある症状と次の手順
サブスクリプションを追加したのにノードが表示されないのはなぜ?
グループを保存しただけではURLが保存されるだけで、データが取得されたことにはなりません。該当グループを手動で更新し、ログに接続失敗、アクセス拒否、形式エラーなどがないか確認してください。ログイン案内や通常のウェブページが返された場合、クライアントがノード情報を解析できないことがあります。プロバイダーのアカウントから、クライアントが認識できるサブスクリプションURLを取得し直してください。更新に成功したのに一覧が空の場合は、更新したグループが現在選択されているか、検索フィルターが有効なままになっていないかを確認します。古い一覧がまだ使える場合は、新しいサブスクリプションをインポートできると確認するまで、古いグループを削除しないでください。
ノードは一覧にあるのに、どの接続先にもつながらない?
まずシステムの時刻とタイムゾーンが同期しているか確認し、アクティブノードが選択済みで、コアが起動し、ローカルプロキシのポートが待ち受け中であることを確認してください。固定の接続先にリクエストを1回送ります。対応するログがまったくない場合は、まずアプリ側のプロキシ設定を調べます。リクエストがクライアントに届いている場合は、接続先の名前解決、リモート接続、通信のハンドシェイクを切り分けてください。提供元の設定情報がある場合に限り、通信方式、サービス名、TLS設定を変更します。証明書エラーを解消するために検証を無効にしないでください。時刻、接続先の名前、ノードの元の設定を改めて確認してください。
ノードの切り替えやアップデート後に問題が起きた?
まず同じ古いノードを使って比較してください。更新した項目だけ失敗する場合は、アクティブグループが変わっていないか、提供元がポートや通信方式を変更していないか、使用中のコアがその設定に対応しているか確認します。アップデート後にすべてのノードが失敗する場合は、別のアプリのコピーを起動していないか、元のデータディレクトリを読み込んでいるか、古いプロセスがポートを使用中のままになっていないかを優先して確認してください。バックアップを復元する際はクライアントを終了し、形式の互換性を確認してから該当データを戻します。異なる配布形式の設定ファイルをすべてまとめて混在させないでください。
ウィンドウを閉じた後にインターネットへ接続できない場合の復旧方法
まずクライアントがトレイで動作中か確認し、ウィンドウを閉じただけなのか、コアを停止したのか、完全に終了したのかを切り分けます。クライアントを開ける場合は、画面から有効にした通信取り込みモードを無効にし、システムプロキシがローカルポートを指したままになっていないか確認します。クライアントが異常終了した場合は、準備段階で記録した状態に従って、元のプロキシ、自動設定スクリプト、VPN設定を復元してください。組織のプロキシを使っている端末で、プロキシ設定をすべて削除しないでください。復旧後は同じ接続先にリクエストを再送し、LAN内のリソースにも正常にアクセスできることを確認します。