クライアントインストーラーOSを選んでからアーキテクチャを選択
OSに合わせてインストーラーを選択してください。デスクトップ向けはv2rayN、Android向けはv2rayNGを推奨し、代替としてv2flyNGも用意しています。
インストーラーにサーバー設定は含まれません。インストール後、利用権限のあるサブスクリプションURLまたは設定リンクをインポートしてください。
インストーラー一覧
デバイスに合うインストーラーを1つだけダウンロードしてください。プラットフォームを切り替えたら、カード下部のインストール要件も確認してください。
Windows x64版にはDesktopと従来のWPFがあります。初めて使う場合はDesktop、従来のメニュー構成に慣れている場合はWPFを選んでください。
新世代のクロスプラットフォームUIを採用。新規インストールや、異なるデスクトップOSでも近い操作感を求める方に適しています。
安定した従来版で、使い慣れたWindowsデスクトップUIを維持しています。設定済みの場合は、更新前に現在のUI系列を確認してください。
| 確認項目 | 選択の目安 | インストール前の確認 |
|---|---|---|
| OSとアーキテクチャ | Windows x64向け。サポート中のWindows 10またはWindows 11の使用を推奨 | 「設定 → システム → バージョン情報」でシステムの種類を確認 |
| パッケージ形式 | ZIPアーカイブ。選択した系列に対応するインストーラーを収録 | すべて展開してから、フォルダー内のインストーラーを実行 |
| 実行環境 | 必要なランタイムは選択した系列と配布パッケージによって異なります | ランタイム不足のメッセージが表示された場合は、案内に従って必要なコンポーネントを追加 |
ダウンロード後、保存先のフォルダーを開き、書き込み可能な場所にZIPをすべて展開してください。アーカイブのプレビュー画面から直接プログラムを起動すると、関連ファイルが所定の場所に展開されないことがあります。起動中の旧クライアントを終了してからインストールしてください。インストール先と設定の保存先は同じとは限らないため、プログラムのフォルダーをコピーしただけでは完全なバックアップになりません。
初回起動時にサーバー一覧が空なのは正常です。「サブスクリプショングループ → サブスクリプショングループの設定」を開き、グループとサブスクリプションURLを追加して更新してください。次にサーバーを選択し、画面下部の「システムプロキシ」が「システムプロキシを自動設定」になっているか確認します。最初はシステムプロキシで接続を試し、成功してから必要に応じてTUNモードを設定してください。一度に複数の項目を変更すると、原因の特定が難しくなります。
WPF版からDesktop版に切り替える場合は、元の設定とプログラムを残したまま、新しいUIでサブスクリプション、ルーティング、待ち受けポートを確認してください。2つのインスタンスを同時に起動すると、ローカルの混合待ち受けポートが競合することがあります。ポートが使用中の場合は、再インストールを繰り返すのではなく、もう一方のインスタンスを終了してください。詳しくはv2rayN 設定ガイドをご覧ください。
Appleメニューの「このMacについて」でチップ名を確認してください。Apple Mシリーズと表示される場合はApple Silicon、Intelプロセッサと表示される場合はIntelを選択します。
Apple Mシリーズ搭載Mac向け。ネイティブのアーキテクチャを選ぶことで、互換レイヤー経由の実行による余分な要因を減らせます。
Intelチップ搭載Mac向けです。外観や購入時期だけでCPUアーキテクチャを判断しないでください。
| 確認項目 | 選択の目安 | インストール前の確認 |
|---|---|---|
| チップのアーキテクチャ | Apple Siliconはarm64、Intelはx64 | Appleメニュー → このMacについてを開く |
| OSの互換性 | 最低対応バージョンは、現在のインストーラーに表示される互換性情報を確認 | 現在のmacOSバージョンを記録。チップが一致していてもOSの互換性があるとは限りません |
| パッケージ形式と権限 | DMGディスクイメージ。アプリケーションフォルダーに書き込み権限が必要 | 「アプリケーション」にインストールし、初回起動時にシステムの警告を確認 |
DMGを開き、ディスクイメージのウィンドウに表示された手順に従ってクライアントを「アプリケーション」に移し、そこから起動してください。マウントしたディスクイメージ内で使い続けないでください。更新前に旧クライアントを終了し、メニューバーで動作中のインスタンスが残っていないことを確認してからアプリを置き換えます。ファイル使用中と表示された場合は、バックグラウンドプロセスを確認し、無理に上書きしないでください。
初回起動時にシステムのセキュリティ機能でブロックされた場合は、まずダウンロード元とアプリ名を確認し、「システム設定 → プライバシーとセキュリティ」で該当する案内を確認してください。OSのバージョンによって操作場所が多少異なることがあります。入手元が不明なターミナルコマンドは実行せず、アプリを起動するためだけにシステム全体のセキュリティ保護を無効にしないでください。
サブスクリプションをインポートしたら、クライアントでサーバーを選択してからシステムプロキシを有効にしてください。Webページを開けない場合は、ブラウザー独自のプロキシ拡張機能や、システムプロキシを上書きする他のネットワークツールがないか確認します。TUNが必要な場合は、クライアントの案内に従って権限を設定してください。クライアントを終了する前にシステムプロキシを解除すると、アプリ終了後もブラウザーがローカルポートに接続し続ける事態を防ぎやすくなります。
Xrayコアを使用するAndroid向けGUIクライアントです。2015年以降の一般的なスマートフォンではarm64が目安ですが、最終的には端末のOSが対応するアーキテクチャを確認してください。
arm64-v8a対応デバイス向け。単一アーキテクチャ版のため、通常はユニバーサル版よりファイルサイズが小さくなります。
アーキテクチャを確認できない場合の選択肢です。複数のアーキテクチャに対応しており、arm64版と同時にインストールする必要はありません。
V2Flyコア環境が必要な場合に使えるAndroid向けの代替クライアントです。既存の設定に必要なプロトコルと通信方式に対応していることを確認してから選んでください。
arm64-v8a対応デバイス向けです。別のクライアントを使用中の場合は、接続を停止してからテストしてください。
アーキテクチャが分からない場合に選択してください。クライアントを切り替える前にサブスクリプションURLを控えておき、2つのアプリが同じ設定フォルダーを使うとは限らない点に注意してください。
| 確認項目 | 選択の目安 | インストール前の確認 |
|---|---|---|
| CPUとシステムアーキテクチャ | 一般的な端末ではarm64を推奨。不明な場合はユニバーサル版を選択 | 端末の仕様を確認してください。古いシステムアーキテクチャで動作する端末もあります |
| OSバージョン | 最低要件は、現在のパッケージに対するインストーラーの案内を確認 | 「設定 → デバイス情報」でAndroidのバージョンを確認 |
| インストールと接続の権限 | 使用するブラウザーまたはファイル管理アプリからのインストールを許可。接続時にはVPNの許可が必要 | 今回使用する入手元に限ってインストールを許可し、インストール後は無効にできます |
APKをダウンロードしたら、ブラウザーのダウンロード一覧またはファイル管理アプリから開いてください。インストールの許可を求められた場合は、対象が直前に使用したブラウザーまたはファイル管理アプリであることを確認します。「アプリをインストールできません」と表示されたら、アーキテクチャの非対応、ストレージ不足、旧版と新版の署名の不一致を確認してください。ユニバーサル版で解決できるアーキテクチャの問題はありますが、署名の競合は解消できません。
v2rayNGを開き、「サブスクリプショングループの設定」でサブスクリプションURLを追加します。保存後に「サブスクリプションを更新」を実行してください。設定が一覧に表示されたら1つ選び、接続ボタンをタップします。初回接続時はシステムのVPN許可画面が表示され、承認すると端末全体の接続が確立されます。通常、スマートフォンでは同種のVPNサービスを複数同時に維持できません。テスト前に同じ接続経路を使用する他のアプリを停止し、VPNの制御が切り替わらないようにしてください。
画面ロック後に接続が切れる場合は、インストーラーを変える前に、アプリのバッテリー管理、バックグラウンド動作の制限、省電力モードを確認してください。モバイル通信でのみ問題が起きる場合は、Wi-Fi接続時の状態も比較します。v2rayNGとv2flyNGを試す場合は、それぞれに設定をインポートして個別にログを確認してください。一方のコアで設定を読み込めても、もう一方がすべてのパラメーターに対応するとは限りません。
Linuxデスクトップ向けです。ディストリビューションがdebとrpmのどちらに対応するかを確認し、CPUがx86_64かaarch64かも調べてください。
Debian、Ubuntuなどの対応するデスクトップディストリビューション向けです。パッケージ名のamd64はx64アーキテクチャを表し、特定のCPUメーカーに限定されません。
RPM系の対応ディストリビューション向けです。拡張子だけで判断せず、依存関係とOSバージョンがパッケージの要件を満たすことも確認してください。
| 確認項目 | 選択の目安 | インストール前の確認 |
|---|---|---|
| CPUアーキテクチャ | x86_64はx64、aarch64はarm64を選択 | システム情報でアーキテクチャを確認し、必要に応じてuname -mを実行 |
| ディストリビューションとパッケージ形式 | Debian系は通常deb、RPM系は通常rpm | ディストリビューションのバージョンとパッケージマネージャーの互換性を確認 |
| デスクトップ環境と依存関係 | 利用可能なGUIデスクトップ、ネットワーク接続、要件を満たすシステムライブラリが必要 | システムのソフトウェアインストーラーで依存関係を処理し、エラー内容を記録 |
対応するパッケージをダウンロードしたら、まずディストリビューション付属のソフトウェアインストーラーで開いてください。依存関係が不足していると表示された場合は、不足しているライブラリ名と必要な最小バージョンを記録し、OSの更新が必要か判断します。依存関係を無視して強制インストールしたり、別のディストリビューションのシステムライブラリで現在の環境を上書きしたりしないでください。古いディストリビューションでは、アーキテクチャが一致していても必要な実行環境が不足する場合があります。
インストール後、アプリケーションメニューからv2rayNを起動し、通常のデスクトップユーザーとしてサブスクリプションを設定してください。システムプロキシが影響するのは現在のデスクトップセッションであり、ターミナルツールやすべてのアプリに適用されるとは限りません。まずシステムプロキシに従うブラウザーで確認し、他のプログラムは個別にプロキシ設定をチェックしてください。TUNには追加のネットワーク権限が必要です。適切な権限設定の代わりに、GUIクライアント全体を常に高い権限で実行することは避けてください。
ログイン後に自動起動する場合は、手動起動、サブスクリプションの更新、終了時の処理が正常に動作することを先に確認し、デスクトップ環境の自動起動アプリ設定を使ってください。更新後にトレイアイコンが2つ表示される場合は、古いショートカットと新しい自動起動項目が両方残っていないか確認します。デスクトップへのインストール方法はdeb/rpmのインストールと自動起動設定をご覧ください。
インストール前後の確認
インストールの問題と接続の問題を分けて対処しましょう。一度に変更するのは1項目だけにし、問題を再現するための手がかりを残してください。
現在のクライアント名、UIの系列、待ち受けポート、ルーティングモードを記録し、クライアントのエクスポートまたはバックアップ機能で設定を保存してください。サブスクリプションURLにはアクセス用の認証情報が含まれる場合があります。バックアップは安全な場所に保管し、スクリーンショットや問い合わせ用ログにURL全体を表示しないでください。
旧プログラムを終了してからインストールし、トレイやバックグラウンドにインスタンスが残っていないことを確認してください。アーキテクチャ、入手元、デスクトップUIの系列を切り替える場合は、設定の移行方法を先に確認します。インストーラーのエラーだけを理由に元の設定をすぐ削除しないでください。何度も上書きするより、元の状態に戻せることが重要です。
サブスクリプションをインポートしたら、サーバー一覧が更新されたことを確認し、設定を選んで接続してください。サブスクリプションは設定を配布する方法であり、クライアントにサービスが付属するわけではありません。URLの失効、利用期限、設定の互換性などの問題は、それぞれ該当する箇所で対処してください。
更新に失敗した場合は、接続できないのか、アクセスを拒否されたのか、内容を認識できないのか、エラーの種類を確認します。接続中のサーバーがある場合は、通常の更新と「プロキシを経由しない更新」の結果を比較できます。アクセス権が漏れるおそれがあるため、入手元が不明な変換サイトにサブスクリプションURLを入力しないでください。
デスクトップでは、まずローカルの待ち受けが正常に動作することを確認してから「システムプロキシを自動設定」を有効にします。AndroidではVPNの許可と接続状態を確認してください。実際に利用するWebサイトを開いて検証します。遅延テストは特定の測定方法の結果にすぎず、Webサイトへアクセスできるかどうかの確認には代用できません。
ブラウザーでは接続できるのにターミナルで失敗する場合は、ターミナルのプロキシ設定を個別に確認してください。一部のドメインだけで失敗する場合は、ルーティングとDNSも調べます。まずはプロキシの適用方法を1つに絞って基準を確認し、複数のクライアントやプロキシ拡張機能を同時に使わないでください。
OSのバージョン、クライアント名、アーキテクチャ、エラーの全文を記録してください。インストーラーが開かない、起動直後に終了する、サブスクリプションの更新に失敗する、接続後にアクセスできないなど、発生している段階も記載します。症状に応じて確認すべき箇所が異なります。
ポート競合なら他のクライアント、名前解決の失敗ならDNS、画面ロック後の切断ならバックグラウンド制限を確認します。ログを送る前に、サブスクリプションURL、アクセス用認証情報、個人のネットワーク情報を削除してください。症状に合わせてトラブルシューティングガイドを参照し、すべての問題をインストーラーのせいにしないようにしましょう。
ダウンロードとインストールに関するQ&A
インストーラーに含まれるのはクライアントプログラムのみで、利用可能なサーバー設定は含まれません。利用権限のあるサブスクリプションURLまたは設定リンクを用意し、v2rayNの「サブスクリプショングループ」に追加して更新するか、クリップボードからインポートしてください。Android版では「サブスクリプショングループの設定」からURLを追加し、「サブスクリプションを更新」を実行します。
初めて使う場合は、新しいクロスプラットフォームUIを採用したDesktop版がおすすめです。従来のWindowsメニューや操作感に慣れている場合は、安定したWPF版を選べます。これはUIの違いであり、ダウンロード後に異なるサーバー設定が付属するわけではありません。切り替える前に設定をバックアップし、起動中のクライアントを終了してください。
2015年以降の一般的なスマートフォンなら、まずarm64を選ぶのが目安です。ただし、最終的には端末のOSが対応するアーキテクチャを確認してください。判断できない場合やarm64版が非対応と表示される場合は、ユニバーサル版を選べます。複数のアーキテクチャに対応するため、ファイルサイズは大きめです。同じクライアントの2種類を同時にインストールする必要はありません。
通常は設定をバックアップしてからクライアントを終了し、同じアプリ、同じ入手元、同じアーキテクチャの新しい版に更新します。先に旧設定を削除しないでください。Androidで署名の競合が表示された場合、上書きや即時アンインストールを繰り返さず、アプリの入手元とバックアップの復元可否を確認します。デスクトップ版の異なるUI間で設定を移す場合は、移行方法を別途確認してください。
まず設定をインポートし、サーバーを選択していることを確認してから、ログでローカルポートの競合や接続エラーを調べてください。デスクトップでは「システムプロキシを自動設定」が有効か、AndroidではVPNの許可と接続状態を確認します。プログラムファイルの破損、アーキテクチャの不一致、インストール失敗がある場合に限り、インストーラーの問題を優先して対処してください。
まずブラウザーのダウンロード一覧にタスクがあるか、ディスク容量と保存先のアクセス権に問題がないか確認してください。通信が切れた場合は、同じインストーラーを再度ダウンロードします。未完了のファイルをインストーラーとして開かないでください。それでも失敗する場合は、OS、アーキテクチャ、パッケージ形式、ブラウザーのエラー内容を記録し、安定した別のネットワークで試してください。
設定ガイドに従ってサブスクリプションをインポートしてください。症状から解決策を探す場合はトラブルシューティングをご覧ください。