v2rayNの全プラットフォーム導入・設定ガイド：macOS、Windows、Linux、Android

共通の準備：設定とネットワーク環境を確認

クライアント、カーネル、サーバー設定の違い

v2rayNは設定を管理するGUIクライアントです。サーバー情報を保存し、実行用の設定を生成して、利用可能なカーネルで通信を処理します。XrayとV2Flyは関連するプロキシエコシステムの異なるカーネル実装で、対応するプロトコルや拡張機能は完全には一致しません。クライアントをインストールしても、接続先のサーバーが自動的に利用可能になるわけではありません。開始前に、利用権限のあるサブスクリプションURLまたは接続情報一式を用意し、提供元の説明で対応クライアント、トランスポート方式、必要な認証情報を確認してください。

サブスクリプションURLは設定を取得するための入口であり、サーバーアドレスそのものではありません。手動設定では、アドレス、ポート、プロトコル認証、トランスポートの各項目を入力します。情報を受け取ったら、サブスクリプション、個別の共有リンク、カーネル設定ファイルのどれに当たるかを見極め、適切な方法でインポートしてください。完全なURLをアドレス欄に貼り付けたり、Webページの説明文をサブスクリプション内容として扱ったりしないでください。情報が不足している場合は提供元に確認しましょう。項目を推測で補うと、調査範囲が広がるだけです。

復元できるローカル環境を整える

まず、ネットワークを制御している他のプロキシや仮想ネットワークツールを停止し、テストにはクライアントを1つだけ使います。通常のWebページを開き、ネットワーク自体に接続できることを確認してください。システム設定で日付と時刻の自動設定を有効にし、タイムゾーンも確認します。時刻が大きくずれていると、証明書の検証や時刻確認を伴うプロトコルに影響することがあります。組織管理下の端末では、プロキシ、証明書、ネットワーク拡張に関する管理ルールを確認し、既存のポリシーを上書きしないでください。

既存のシステムプロキシ、手動DNS、ネットワークインターフェースの設定を記録します。スクリーンショットを共有する場合は、アカウント情報やURLを隠してください。設定変更は一度に1種類に絞り、まずサーバーを確認してからシステムプロキシを有効にし、最後にTUNを検討します。問題が起きても直前の状態に戻しやすくなります。初回接続時に複雑なルールのインポート、カーネルの変更、DNSの変更を同時に行うのは避けましょう。複数の条件を一度に変えると、接続が戻っても何が効いたのか判断しにくくなります。

準備項目	確認する内容	確認する理由
デバイス情報	OS、プロセッサアーキテクチャ、インストール権限	適切なインストーラーを選ぶ
接続情報	プロトコル、トランスポート、セキュリティ設定、有効期限	インポート後の設定不足を防ぐ
ネットワーク環境	通常の通信、時刻、既存のプロキシ	端末側とサーバー側の問題を切り分ける

通信を制御する範囲を決めてから検証する

システムプロキシの影響を受けるのは、システムプロキシ設定を参照するアプリだけです。ブラウザーは通常利用できますが、コマンドラインツール、ゲーム、独自のネットワーク処理を持つアプリは従わない場合があります。TUNは仮想ネットワークインターフェースを通じてより多くの通信を受け取るため、適用範囲が広い一方、適切な権限、ルーティング、DNS設定が必要です。初回はシステムプロキシで動作を確認しましょう。対象アプリがシステムプロキシを使わないと分かった場合や、端末全体の通信を振り分ける必要がある場合に、TUNを設定してください。

検証では、「設定が保存された」「カーネルが起動した」「Webページが想定した経路で開いた」の3つを区別します。画面にサーバーが表示されても認証成功とは限らず、トレイに稼働中と表示されてもブラウザーの通信が流れているとは限りません。通常アクセスできるページと、指定した経路を使う必要がある接続先を用意し、通常接続、プロキシ接続、直結ルールの順に確認します。ログもあわせて判断し、アイコンや一度の速度測定だけで結論を出さないでください。

ダウンロード先はクライアントのダウンロードページにまとめています。まずOS別のセクションを開き、アーキテクチャとパッケージ形式を確認してください。この記事では特定のメニュー配置を前提にしていません。同じ名前の項目が見つからない場合は、サブスクリプション、設定、システムプロキシなどの機能を探してください。まず接続を1回成功させたい場合は、クイックスタートへ進み、接続後にバックアップやトラブル対処の章をご覧ください。

macOS：チップの確認、インストール、ネットワーク権限

AppleシリコンとIntelのインストーラーを見分ける

Appleメニューから「このMacについて」を開き、「チップ」または「プロセッサ」を確認します。Appleシリコンと表示される場合は、macOSダウンロード欄でApple Silicon版を選択してください。Intelと表示される場合はIntel版を選びます。両者はプロセッサアーキテクチャが異なるため、外観だけで判断しないでください。変換環境が使える場合でも、別のアーキテクチャを優先する必要はありません。ネイティブ対応版を選ぶと、カーネルや補助コンポーネント、権限が正常か確認しやすくなります。

ダウンロードしたディスクイメージを開き、v2rayNを「アプリケーション」フォルダにドラッグしてから、フォルダ内のアプリを起動します。ディスクイメージからの起動を常用すると、アップデートや設定の保存、補助コンポーネントの参照に問題が出る場合があります。開けないという警告が表示されたら、まずファイルがダウンロードページの正規のリンクから取得されたこと、アーキテクチャが合っていること、ダウンロードが完了していることを確認し、「システム設定 → プライバシーとセキュリティ」に表示される内容を確認してください。アプリを起動するために、システム全体のセキュリティを無効にしないでください。

設定をインポートしてシステムプロキシを確認

初回起動後、サブスクリプショングループの管理画面を開き、用途の分かるグループを追加します。サブスクリプションURL全体をアドレス欄に貼り付けて保存し、サブスクリプションを更新してください。更新方法にプロキシ経由・非経由の選択肢がある場合、利用可能な接続がまだなければ、まずプロキシを使わずに更新します。URLへのアクセスにプロキシが必要なら、先に独立した接続を1つ用意してください。更新後、グループ内に選択可能なサーバーがあることを確認し、使用するサーバーを現在の接続先に設定します。

カーネルを起動したら、システムプロキシのメニューで「システムプロキシを自動設定」を選びます。ここでいう自動設定はクライアントが提供する設定操作であり、ブラウザーのプロキシ自動設定スクリプトモードと同じではありません。「システム設定 → ネットワーク」を開き、現在使っているネットワークサービスの詳細情報にあるプロキシ欄で、ホスト名とポートがクライアントのローカル待ち受け先と一致することを確認します。Wi-Fiと有線接続は別のネットワークサービスです。ネットワークを切り替えた後は、実際に設定が適用されているインターフェースを再確認してください。

まずブラウザーで確認し、その後ほかのアプリを調べます。ブラウザー拡張機能、アプリ独自のプロキシ設定、開発ツールの環境変数がシステム設定を上書きすることがあります。ブラウザーは正常で特定のアプリだけ直結する場合は、アプリがシステムプロキシを参照するか確認してください。すぐにサーバーを変更する必要はありません。テスト終了時は「システムプロキシをクリア」を選択します。「システムプロキシを変更しない」は、通常、クライアントが設定を変更しなくなるという意味で、設定のクリア操作ではありません。

TUNとスリープ復帰後の接続

システムプロキシが正常に動作することを確認してから、TUNを有効にしてください。インストール方法や実行環境によっては、補助サービス、ネットワーク拡張機能、管理者の許可が必要です。クライアントやOSの案内に従って必要な権限を許可し、カーネルが仮想インターフェースを正常に作成したことを確認します。許可画面が繰り返し表示されても、何度も連続して試さないでください。余分に起動しているインスタンスを終了し、ログで権限、サービスのインストール、インターフェース作成に関するエラーを確認してから対処します。会社の端末で管理上の制限がある場合は、管理者に確認してください。

スリープ、復帰、Wi-Fiから有線への切り替え後に接続できなくなった場合は、まずTUNを無効にし、通常のネットワーク接続が戻ることを確認します。その後カーネルを再起動し、通信の取り込みを再度有効にしてください。クライアントの終了後もシステムプロキシにローカルアドレスが残っていると、Webページが開けなくなることがあります。クライアントを再起動してプロキシを解除するか、該当するネットワークサービスで記録しておいた設定に戻してください。クライアントを終了した後に、待ち受けていないポートを指すプロキシ設定を残さないようにしましょう。

アップデート前にサブスクリプショングループとカスタムルールをバックアップし、旧インスタンスを終了してからアプリを置き換えます。アプリが使用中と表示された場合は、メニューバーのアイコンやバックグラウンドプロセスを確認してください。新旧のインスタンスを同時に実行したまま設定をインポートしないでください。置き換え後は、まず通常のプロキシ接続を確認し、次にTUNと自動起動を確認します。こうすれば、接続失敗の原因がアップデート後の設定互換性なのか、システム権限なのかを切り分けやすくなります。

Windows：デスクトップ版、WPF版、システムプロキシ

画面や互換性に合わせてダウンロード版を選ぶ

Windowsダウンロード欄では、v2rayNのデスクトップ版と従来のWPF版を提供しています。デスクトップ版は新世代のクロスプラットフォームUIを採用し、WPF版は従来の操作感を維持しています。初めて導入する場合は、まずデスクトップ版を検討してください。すでに使い慣れた設定や操作手順がある場合は、バックアップを取ってから移行するか判断しましょう。画面や設定の保存場所が異なる場合があるため、インストール後にすべてのデータが自動共有されるとは限りません。また、2つのアプリを同時に起動して別々のプロキシとして使わないでください。

ダウンロード前に、OSとプロセッサアーキテクチャがダウンロード欄の説明に合っていることを確認し、ユーザーフォルダへの書き込み権限を確保します。インストールウィザードの案内に沿って導入してください。解凍が必要な配布形式の場合は、完全に解凍してから起動します。圧縮ソフトのプレビュー画面から直接実行しないでください。実行環境が見つからないという警告が表示された場合は、必要な依存関係とOSの対応状況を確認します。出所不明のDLLをプログラムフォルダにコピーして修復しようとしないでください。

サブスクリプションをインポートしてローカルポートを確認

v2rayNを起動し、サブスクリプショングループを作成してURLを入力します。保存してから更新してください。サブスクリプションを取得できても、設定の入口にアクセスできたことを示すだけです。使用するサーバーを選択し、カーネルを起動する必要があります。共有リンクを手動でインポートする場合は、プロトコル、アドレス、ポート、トランスポートの各項目がそろっていることを確認し、想定したグループに保存されたかを確認します。既存の設定がある場合は、用途が明確なグループでテストしましょう。既定のグループとサブスクリプショングループに同名の項目があり、選択を間違えるのを防げます。

設定画面でローカルの待ち受けアドレスと、HTTPまたは混合プロキシのポートを確認します。ポートはクライアントで実際に有効になっているインバウンド設定と一致させてください。他の解説記事にある一般的な値をそのまま使ってはいけません。自分の端末だけで使う場合は、ループバックアドレスで待ち受ける設定を維持します。LANからの接続を許可する場合は、認証、ファイアウォール、アクセス可能な範囲も考慮してください。ポートが使用中なら、まず使用中のプロセスを特定してから、旧インスタンスを停止するかポートを変更します。変更後は、そのポートを手入力しているアプリの設定も更新してください。

システムプロキシのメニューで自動設定を有効にした後、「設定 → ネットワークとインターネット → プロキシ」を開き、手動プロキシの設定がクライアントと一致しているか確認します。ブラウザーに独自のプロキシ拡張機能がある場合は、テスト中だけ無効にしてください。アプリによってはネットワーク設定をキャッシュしており、切り替え後に再起動が必要なことがあります。システム設定にローカルプロキシのアドレスが表示されても、カーネルが待ち受けているとは限りません。クライアントのログで起動失敗やポートのバインドエラーがないかも確認してください。

TUN、権限、バックグラウンドのインスタンス

TUNを有効にする前に、使用中のクライアントがサービスや管理者権限について表示する案内を確認してください。実行方法によっては昇格や補助サービスのインストールが必要ですが、通常のシステムプロキシを試すだけなら、常に管理者権限で起動する必要はありません。必要な範囲だけ許可し、仮想ネットワークアダプターの作成、ルーティングの設定、DNSの取り込みが完了したことを確認します。セキュリティソフトがネットワークコンポーネントをブロックした場合は、ブロックの詳細とファイルの場所を確認し、組織のポリシーに沿って対処してください。セキュリティ機能全体を無効にして問題を調べないでください。

Windowsでは、トレイに複数のインスタンスがある、スタートアップ項目が残っている、古いサービスが動いているといった状況で問題が起きやすくなります。メインウィンドウを閉じてもアプリが終了するとは限らないため、トレイメニューから終了してください。PCを再起動するとプロキシ設定が書き換わる場合は、スタートアップアプリや既存のネットワークツールを確認し、ログイン時にシステムプロキシを設定しているものを特定します。クライアントを移行する際は、旧アプリを終了し、旧アプリによる通信制御を停止してから新しいアプリを起動します。2つのインスタンスが交互にシステム設定を書き換えると、接続が不安定になることがあります。

ブラウザーでは接続できてもターミナルのアプリで失敗する場合は、そのアプリがシステムプロキシを使うか、独自のプロキシ環境変数が設定されているか確認してください。必要なプロトコルと待ち受け方式が分かってから、アドレスを手動入力します。Webページがすべて開かない場合は、ローカルポート、カーネルの起動、システムプロキシを1つずつ確認してください。ブラウザーの詳しい対処手順は接続済みなのにWebページが開かないときの確認リストをご覧ください。最初からクライアント全体を再インストールする必要はありません。

Linux：パッケージ形式、デスクトッププロキシ、TUN

ディストリビューションとプロセッサアーキテクチャを確認

Linux用インストーラーは、ディストリビューションのパッケージ形式とデバイスのプロセッサアーキテクチャの両方を合わせる必要があります。DebianやUbuntuなどでは通常deb、Fedoraなどでは通常rpmを選びますが、最終的にはディストリビューションのパッケージ管理方式を確認してください。一般的なPCの多くはx64、一部の開発ボードやデスクトップ機器はarm64です。Linuxダウンロード欄を開き、まず形式、次にアーキテクチャを確認します。パッケージ形式とプロセッサの種類を取り違えないでください。

端末では、次の読み取り専用コマンドを実行して情報を確認できます。出力のx86_64は通常x64、aarch64は通常arm64に相当します。ディストリビューション情報はパッケージ管理方式の判断に使います。どちらも端末の情報を確認するだけで、クライアントのインストールや変更は行いません。別のアーキテクチャを使っている場合は、対応しないパッケージを無理にインストールせず、ダウンロードページに適切な選択肢があるか確認してください。

uname -m
cat /etc/os-release

ダウンロードしたパッケージは、まずディストリビューション標準のソフトウェアインストーラーで開きます。依存関係やインストール時の案内を確認してから導入してください。依存関係が不足している場合は、システムのパッケージマネージャーで解決します。別のディストリビューションからライブラリファイルをコピーしないでください。インストール後、アプリメニューからv2rayNを起動し、一般ユーザーで設定を保存できるか確認します。以前に管理者権限でクライアントを起動していた場合は、ユーザー設定フォルダの所有者に問題が残っていることがあります。まず該当フォルダと権限を確認し、ホームディレクトリ全体の権限を再帰的に変更しないでください。

設定のインポートとデスクトッププロキシの違い

サブスクリプショングループにURLを保存して更新し、サーバーを選択してからカーネルを起動します。まずローカルの待ち受けが正常であることを確認してください。Linuxのデスクトップ環境ではシステムプロキシの実装が統一されていません。クライアントがデスクトップのプロキシ設定を書き換えられる環境もあれば、システムのネットワーク設定から手入力が必要な環境もあります。GNOME、KDE、各アプリで設定を読み取る方法も異なります。クライアントにプロキシ設定済みと表示されていても、現在のデスクトップのネットワーク設定で実際のアドレスとポートを確認してください。

コマンドラインアプリは、デスクトッププロキシを有効にしても自動的にプロキシを使うとは限りません。環境変数、コマンド引数、独自の設定ファイルを使う場合があります。対象アプリのプロキシに関する説明を確認し、クライアントの待ち受け方式に合った設定を選びます。HTTPプロキシとSOCKSプロキシは、名称だけを置き換えてすべての構文を共用できるわけではありません。DNSをリモートで解決する動作もアプリごとに異なります。テスト中に複数の起動ファイルへプロキシ変数を一括で追加すると、古いポートをどこから引き継いでいるのか分かりにくくなるため避けてください。

最小限の権限と仮想インターフェースを確認

TUNにはカーネルの仮想ネットワークインターフェースと適切なネットワーク管理権限が必要です。GUIアプリを起動できても、それらの条件を満たすとは限りません。クライアントが対応する方法でサービスを設定するか、必要な権限を付与してください。デスクトップアプリ全体を常時高い権限で実行するのは避けましょう。ログにインターフェースが存在しない、操作が許可されていない、ルートを書き込めないといったエラーがある場合は、TUNデバイスが提供されているか、コンテナや制限付きセッションで操作が許可されているかを確認し、権限の問題かカーネル起動の問題かを切り分けます。

次の読み取り専用コマンドでアドレスとルートを確認できます。有効化の前後を比較するときは、新しいインターフェースとデフォルトルートの経路に注目してください。インターフェース名だけで接続成功を判断してはいけません。ほかの仮想ネットワークツールも動作していると、ルートの優先順位が競合する場合があります。通信を制御するツールは1つだけにし、通常のプロキシが動作することを確かめてからTUNを有効にします。無効化後も、クライアントのスイッチだけでなくシステムのルーティングが元に戻ったことを確認してください。

ip address show
ip route show

Linuxで直結は正常なのにプロキシが失敗する場合は、まずローカルの待ち受けとカーネルログを確認します。ドメイン名だけ解決できない場合は、続けてDNSの経路を調べてください。システムDNSはネットワーク管理サービス、名前解決サービス、接続設定などで管理されることがあります。原因を確かめずに名前解決設定ファイルを上書きするのは避けましょう。アップデート時はユーザー設定をバックアップし、パッケージマネージャーの手順でアプリを置き換えます。その後、デスクトッププロキシ、バックグラウンドサービス、自動起動を1つずつ確認し、旧サービスが置き換え済みのアプリパスを参照し続けないようにしてください。

Android：v2rayNGとv2flyNGの設定

クライアントを選んでからインストーラーのアーキテクチャを選択

Androidではv2rayNGを基本とし、Xrayカーネルを使用します。V2Flyカーネルとの互換性が必要な場合は、v2flyNGも検討してください。2つのクライアントで同時にシステム通信を制御しないようにし、接続情報で必要なプロトコルとカーネル機能を先に確認します。Androidダウンロード欄から該当する項目を選んでください。新しい一般的なスマートフォンではarm64が適していることが多いものの、最終的にはシステムのアーキテクチャを確認します。不明な場合は汎用版を検討し、プロセッサの製品名だけで実際に動作するアーキテクチャを判断しないでください。

インストーラーを開くと、現在使用しているブラウザーやファイルマネージャーからのアプリインストールを許可するよう、システムに求められることがあります。今回使用するインストール元だけを許可し、インストール後は必要に応じて許可を取り消してください。インストールできない場合は、OSの要件、ダウンロードの完了、アーキテクチャの一致、同じ名前で署名が異なるアプリの有無を確認します。アップデートに失敗しても、すぐに旧アプリをアンインストールしないでください。通常、アンインストールするとアプリの専用データも削除されるため、先に設定をバックアップしてください。

サブスクリプション、共有リンク、使用する設定

クライアントのサブスクリプション設定またはグループ管理を開き、サブスクリプション名とURL全体を追加して保存します。メイン画面に戻って更新してください。画面によってメニュー名は多少異なりますが、まず登録元を保存し、内容を取得してから使用する設定を選びます。個別の共有リンクは、クリップボードからインポートする機能で追加できます。QRコードを読み込む場合は提供元が信頼できることを確認し、認証情報を含むQRコードを公開の読み取りサービスにアップロードしないでください。

インポート後、設定の詳細を開いてプロトコル、接続先アドレス、ポート、トランスポートとセキュリティの設定を確認します。サブスクリプション由来の項目は通常、提供元が管理しています。ローカルで変更しても、次回更新時に上書きされる場合があります。一時的に問題を調べる必要があれば、設定を個別に複製し、変更点を記録してください。使用する項目を選んでから接続し、前回の接続先がそのまま使われるのを防ぎます。リストに項目があり、接続ボタンを押せるだけでは、カーネルが実際に起動したことの確認にはなりません。

VPNの許可とアプリごとのプロキシ

初めて接続するとき、AndroidはVPN接続のシステム許可を表示します。許可すると、クライアントはシステムの仮想ネットワークインターフェースを通して通信を受け取れるようになります。ここでいうVPNは通信を取り込むシステム機能であり、接続先サービスが従来型のVPNプロトコルを使うという意味ではありません。接続中はシステムの状態とクライアントのログを確認し、サービスが起動直後に終了していないことを確かめます。ほかのVPNアプリが接続中なら、先に切断してからテストしてください。

アプリごとのプロキシ設定では、選択したアプリだけを通信制御の対象にするモードと、選択したアプリを除外するモードが一般的です。2つのリストは意味が逆なので、保存前に現在のモードを確認し、対象アプリで動作を試してください。リストにアプリ名が表示されるだけで、必ずプロキシを通ると判断しないでください。仕事用プロファイル、別のユーザー領域、一部のシステムコンポーネントは異なる環境にある場合があります。管理ポリシーがある場合は端末で許可された範囲に従い、組織の制限を回避しようと権限を何度も切り替えないでください。

ルーティングモードはクライアントに入った後の通信経路を決め、アプリごとのプロキシ設定はどのアプリの通信をクライアントに入れるかを決めます。両者は別のレイヤーです。ブラウザーが対象外なら、ルーティングをグローバルに切り替えても自動的にプロキシへは入りません。問題を調べるときは、まず対象が分かりやすい範囲で通信を取り込み、次にルーティングを確認します。動作を確かめてからアプリごとの振り分けを徐々に戻し、意味が曖昧な許可リストと除外ルールを二重に管理しないようにしましょう。

バックグラウンド制限とネットワーク切り替え

画面消灯後に頻繁に切断される場合は、アプリのバッテリー最適化、バックグラウンド動作、メーカー独自の省電力制限を確認します。接続を維持する必要があるクライアントに限って必要な調整を行い、画面ロック中と復帰後の動作を確認してください。省電力機能を端末全体で無効にする必要はありません。Wi-Fiとモバイルネットワークを切り替えた後は、既存の接続を再確立する必要がある場合があります。まずスマートフォン自体がネットワークに接続できることを確認してから、サービスに再接続します。サブスクリプションの更新と接続サービスは別々に確認してください。バックグラウンドでの更新失敗が、現在のサーバーを使えないことを意味するとは限りません。

v2rayNGとv2flyNGを移行する場合は、同じ有効なサブスクリプションを再インポートし、ルーティング、DNS、アプリごとの設定を照合しながら戻します。互いのデータフォルダを直接上書きしないでください。サポートを求める際は、個人情報を伏せたログ、OS環境、失敗した手順を共有し、サブスクリプション、認証情報、QRコード全体は隠してください。プロトコルの選び方は4種類のプロキシプロトコル比較も参考にしてください。クライアントを変更すれば、接続先の問題まですべて直るわけではありません。

サブスクリプション管理：更新、移行、設定のバックアップ

サブスクリプションの登録元とサーバー項目を分けて管理

サブスクリプショングループには登録元URLと更新方法を保存し、サーバーリストには取得した接続情報を保存します。両者は別々に考えてください。サーバー項目を削除しても登録元は残ることがあり、次回更新時に同じ項目が再び表示される場合もあります。用途や登録元ごとにグループを作り、仕事用、テスト用、予備など実際の目的が分かる名前を付けましょう。グループ名にURL全体を含める必要はありません。分類が明確なら、更新に失敗した際も該当する登録元を特定しやすくなります。

サブスクリプションを初めてインポートするときは、URLを貼り付けた後に先頭や末尾の空白、改行、途中で切れた部分がないか確認します。チャットアプリでは長いURLが折りたたまれて表示されることがあり、見えている文字だけをコピーしてもURL全体とは限りません。サブスクリプションの形式や対応クライアントが提供元によって指定されている場合もあります。リストが空の場合は、取得した内容が設定なのか、ログイン画面なのか、エラー説明なのかを確認し、何度も繰り返しインポートしないでください。URLが失効している場合は提供元に新しいURLを依頼し、適当な文字を変更して復旧を試みないでください。

更新方法と自動更新の間隔を選ぶ

「サブスクリプションを更新（プロキシを使用しない）」は、現在のネットワークから登録元へ直接アクセスできる場合に適しています。サブスクリプション取得に接続が必要で、その接続にもサブスクリプションが必要になる循環も避けられます。プロキシ経由で更新する場合は、プロキシがすでに動作していなければなりません。この違いはリクエストの経路であり、サブスクリプションの形式ではありません。トラブル時は両方の方法を試してエラーを確認し、動作する方法を設定してください。利用可能なサーバーがない状態で、プロキシ経由の更新を繰り返すだけでは解決しません。

自動更新の間隔は、登録元の変更頻度、使い方、リクエスト制限を考慮して設定します。内容が安定している登録元を頻繁に取得する必要はありません。モバイル端末では通信量やバックグラウンド実行の制限も考慮してください。画面の単位が分なら、実際の単位に合わせて入力し、時間単位の数値をそのまま分として設定しないようにします。設定後、まず手動更新に成功することを確認してから、自動実行を待ちましょう。端末のスリープ、アプリの停止、ネットワーク制限によって自動処理が遅れることがあり、指定した時刻どおりの実行が保証されるわけではありません。

サブスクリプションを更新すると、提供元で削除された項目が消えたり、提供元が管理する一部の設定が上書きされたりする場合があります。残しておきたい一時設定は、別のグループに複製してから、別名、ルーティングの関連付け、トランスポート設定を変更してください。更新後は並び順が変わることがあるため、サーバーの行番号を長期的な識別子として使わないでください。自動選択やグループ選択を使っている場合は、更新後に接続先が意図どおりか確認し、通常の通信とルーティングもテストします。更新成功の表示だけで確認を終えないでください。

バックアップの範囲と機密情報の扱い

バックアップには、少なくともサブスクリプションの登録元、個別設定、カスタムルーティング、DNS、待ち受けポート、アプリごとの設定を含めます。まずクライアントのエクスポート機能やバックアップ機能を使ってください。データファイルをコピーする必要がある場合は、クライアントを完全に終了し、対象ファイルが現在使用中のインスタンスに対応しているか確認します。プログラムファイルだけをコピーしてもユーザー設定は保存されません。一方でユーザーデータ全体をコピーすると、別の端末では適さないパス、サービスの状態、インターフェース名まで移行される場合があります。

設定内容	移行方法	復元後の確認
サブスクリプションと個別設定	対応する方法でインポート	有効期限、使用中の設定
ルーティングとDNS	項目ごとに照合して移行	カーネルの対応状況、ルールの順序
パスとネットワーク権限	移行先の端末で再設定	待ち受け、サービス、仮想インターフェース

プラットフォーム間で移行する場合は、サブスクリプションURLや共通の共有形式を優先して使い、システムプロキシ、TUNサービス、プログラムパスは移行先で設定し直します。同じ設定をインポートできても、すべての拡張項目を別のカーネルが受け入れるとは限りません。まず基本的な接続を復元して確認し、その後ルーティングとDNSを戻します。元の端末に多くのカスタムルールがある場合は、設定全体を上書きするより、ルールを説明するテキストを残しておく方が、OS間の違いや非対応項目を見つけやすくなります。

サブスクリプションを変更したら、古い登録元の自動更新を無効にしてから不要な項目を整理します。URLが公開された場合、ローカルの記録を削除するだけでは他者のアクセスを取り消せません。登録元でURLを変更するか、失効させてください。更新エラーが発生した場合は、サブスクリプション更新に失敗する原因と間隔の設定を参考に、通信経路、時刻、証明書、取得内容を確認します。再インポートする前に、どの段階で失敗しているかを特定してください。

ルーティングとDNS：通信を取り込んだ後の経路選択

システムプロキシ、TUN、ルーティングモードの違いを確認

システムプロキシとTUNは通信をクライアントに取り込み、ルーティングルールは取り込んだ通信の経路を決めます。グローバルルーティングは通常、取り込まれた通信を指定したプロキシ経由で送る設定であり、すべてのアプリを自動的に対象にするわけではありません。中国本土向けの通信を迂回するなどの振り分けモードでは、ドメイン、アドレス、ルールセットに応じて直結とプロキシを使い分けます。アプリが想定した経路を通らない場合は、まずその通信がクライアントに入っているかを確認し、次に適用されたルールを確認してください。

多くのルーティング機能はルールを上から順に照合します。上位の大まかなルールが、下位の詳細なルールに先に一致することがあります。変更するときは、ドメイン、アプリ、対象範囲が明確なルールを先に記述し、最後に既定のルールを置きます。使用中のカーネルが該当する項目に対応していることも確認してください。異なるカーネルの設定構文を混在させないでください。クライアントに用意されたルーティングプリセットを基準にし、カスタマイズ前に元の設定をエクスポートして、追加したルールの位置と目的を記録しておくと復元しやすくなります。

設定例の断片を前後の文脈と合わせて読む

以下はXray/V2Ray形式のルーティングオブジェクトに含まれるルールの一部で、条件に一致したドメインをdirectというアウトバウンドへ送ります。クライアント設定全体ではありません。適切なrouting.rulesに置き、同名のアウトバウンドと利用可能なドメインルールデータが必要です。GUIクライアントにルール編集画面がある場合は、画面から入力してください。この断片で実行設定全体を上書きしたり、すべてのカーネルで同じ項目が使えると考えたりしないでください。

{
  "type": "field",
  "domain": [
    "geosite:cn"
  ],
  "outboundTag": "direct"
}

typeはルールの種類、domainはドメインの一致条件、outboundTagは送信先のタグを指定します。タグは設定内部の参照名なので、既存のアウトバウンドと同じ綴りにする必要があります。ルールデータがない、タグが存在しない、前のルールに先に一致するといった理由で、想定した動作にならないことがあります。変更後はまずカーネルが設定を受け付けたかを確認し、次に対象通信のマッチングログを確認してください。保存ボタンが成功しただけで、ルールが有効だと判断しないでください。

DNSの名前解決経路とドメインの一致

DNSはドメイン名をIPアドレスに変換しますが、プロキシ接続ではアプリ、OS、カーネルそれぞれの名前解決方法も関係します。ブラウザーが独自の暗号化DNSを使っていたり、OSが古い結果をキャッシュしていたりする場合があります。クライアントにリモートDNSを設定していても、クライアントに入っていない通信は別のDNSリゾルバーを使う可能性があります。調査前に、誰が問い合わせを行い、どの経路を通って、誰が結果を使って接続しているかを整理してください。DNSアドレスを1つ変えるだけで、すべての名前解決問題が解決するとは限りません。

直結用DNSとリモートDNSは、ルーティング設計に合わせて設定します。直結させるドメインには到達可能な名前解決経路が必要です。プロキシ経由にする対象についても、まだ確立されていない接続にDNS問い合わせが依存しないようにしてください。DoHは問い合わせの通信を暗号化しますが、サービスのアドレス自体に到達できる必要があり、初期接続時の名前解決が必要になる場合もあります。「DoHを使う」だけで結果が正しいとは限りません。タイムアウト、証明書、応答内容を合わせて確認してください。

FakeDNSは合成アドレスを使って、カーネルがドメイン名の情報を保持できるようにします。特定の通信取り込み方法に適していますが、アドレスの対応付け、ルーティング、DNSが連携して動作する必要があります。合成アドレスを取得したアプリがカーネルを経由せずに接続すると、通信に失敗する場合があります。通常のシステムプロキシで足りるなら、機能をすべて有効にするためだけに使う必要はありません。テスト前に現在のDNS設定を保存し、カーネルの対応状況と通信の取り込み範囲を確認してから、直結するアプリ、LAN内サービス、クライアント終了後の復旧を確認してください。

通信の振り分けを確認するには、直結させる対象とプロキシ経由にする対象を少なくとも1つずつ試し、ログで使用されたアウトバウンドを確認します。キャッシュの影響が疑われる場合は、アプリまたはOSの方法でキャッシュを消去し、接続し直してから試してください。すべてのネットワーク設定を同時にリセットしないでください。各項目の役割やDNSの選び方は、v2rayNのDNS振り分けと名前解決の解説をご覧ください。まずは単純で説明しやすいルールから始め、必要に応じて段階的に追加しましょう。

よくある設定トラブル：失敗した段階から順に確認

起動トラブルと接続トラブルを分けて調べる

まず、失敗している段階を特定します。アプリが開かない、カーネルが起動しない、ローカルポートに接続できない、接続先サーバーへ接続できない、特定のWebページだけ開かない、のどれでしょうか。アプリが起動しない場合は、アーキテクチャ、OSの要件、実行時の依存関係、設定フォルダの権限を確認します。カーネルの起動エラーでは、設定の解析、実行コンポーネント、ポートのバインドを確認し、すぐにサブスクリプションを変更しないでください。ローカルで正常に動作してから、リモート接続のタイムアウトや認証の問題を主な調査対象にします。

ログを開き、失敗した操作をもう一度実行して、前後の少数のエラーと発生順を記録します。単独のタイムアウトが根本原因とは限りません。それより前にDNSの失敗、接続拒否、設定の非対応が起きていないか確認してください。ログを共有する際はアドレス、認証情報、サブスクリプションの内容を隠しつつ、エラーの種類、プロトコル名、処理の順序は残します。認証情報を含む設定全体を公開しても問題の特定には役立たず、情報流出の危険が高まります。

接続タイムアウト、認証、トランスポート設定

接続先への接続がタイムアウトする場合は、まず現在のネットワークが正常で端末の時刻が正しいことを確認し、アドレスやポートの入力ミスを調べます。すべての設定で失敗する場合は、ローカルネットワーク、カーネルの起動、通信の取り込み方法を優先して確認してください。1つの設定だけが失敗する場合は、そのサーバーが現在も有効か、パラメーターが正しいかを調べます。速度測定の結果は測定方法や接続先にも左右されます。1回の測定失敗だけで、実際の通信がすべて使えないと判断せず、通常の接続も試してください。

認証エラーでは、プロトコルで必要なIDやパスワードを確認します。TLS関連のエラーでは、サーバー名、証明書チェーン、システム時刻、トランスポート設定も確認してください。接続先アドレスと検証に使うサーバー名は異なる場合があり、項目を減らすために適当な値を消してはいけません。トランスポート経路、Host、その他の拡張項目もサーバー側の設定と一致させる必要があります。設定ミスを隠すために証明書検証を無効にせず、情報が期限切れでないか、サーバー名に誤りがないかを確認してください。

カーネルを変更した後に失敗する場合は、対象プロトコルや拡張機能が新しいカーネルに対応しているか、サブスクリプション変換時に項目が欠落していないかを確認します。XrayとV2Flyの機能はすべて相互に置き換えられるわけではありません。まず以前に動作していたカーネルと基本設定に戻し、違いを1つずつ確認してください。リモート接続の詳しい確認手順はノードのタイムアウトと接続失敗のトラブル対処を参考にしてください。同じ誤った設定を残したまま、クライアントを何度も変更しないでください。

よくある質問：ネットワークを復旧し、原因を絞り込む

クライアントは起動しているのに、ブラウザーでページが開かないのはなぜですか？

まず、ブラウザーがシステムプロキシを参照していることを確認し、ローカルアドレスとポートを照合します。独自のプロキシ拡張機能を一時停止し、同じページをもう一度開いてください。ローカルポートに接続できてもアクセスに失敗する場合は、ルーティング先のアウトバウンドとDNSのログを確認します。特定のブラウザーだけで問題が起きる場合は、ブラウザー独自のプロキシ、暗号化DNS、キャッシュを優先して確認し、最初から全体のルールを変更しないでください。

TUNを有効にしたらネットワーク全体が切断されました。どうすれば復旧できますか？

まずTUNを無効にします。通信の取り込みを正常に解除できるよう、クライアントは起動したままにしてください。次にシステムプロキシを解除し、通常のネットワーク接続が戻るか確認します。まだ接続できない場合は、システムに残ったプロキシやDNS設定、ほかの仮想ネットワークツールを調べます。記録しておいた設定に戻してから、権限、仮想インターフェース、ルーティングのエラーを個別に確認し、すべての通信制御をすぐに再有効化しないでください。

サブスクリプションの更新は成功したのに、項目がすべて使えない場合はどうすればよいですか？

更新成功が示すのは、設定内容を取得できたことだけです。サーバーが現在も有効か、使用中の設定が正しいか、プロトコル拡張が現在のカーネルに対応しているかを確認し、具体的な接続エラーも調べてください。新しい項目だけが失敗する場合は、既知の正常な設定とトランスポートやセキュリティのパラメーターを比較します。更新先にアクセスできたことを、接続先サーバーに到達できる証拠として扱わないでください。

アップデート後に問題が起きました。以前のバックアップでそのまま上書きしてもよいですか？

まず問題発生時のログを残し、バックアップからサブスクリプションと必要な設定を復元します。画面やカーネル、OSをまたいで移行する場合は、データ全体を上書きせず、共通形式の情報を再インポートしてください。基本的な接続からテストし、次にルーティング、DNS、TUNを追加します。設定の互換性、パスの変更、権限の状態のどれが原因かを特定しやすくなります。

最後に、把握しやすい設定に戻す

トラブル対処が終わったら、一時的なテスト項目を削除し、本当に必要な自動起動と振り分けルールを元に戻します。クライアント終了後に通常のネットワークが使えることも再確認してください。動作を確認した設定をバックアップし、OS、アーキテクチャ、プロキシモード、主な変更点を記録しておきます。次に問題が起きたら、最初から再インストールするのではなく、直近の変更と照らし合わせましょう。基本の手順はクイックスタートガイドを、別のOS用インストーラーが必要な場合はダウンロードページをご覧ください。