CLIENT WORKBENCH / インストーラーの選択
v2rayNデスクトップクライアント · v2rayNG・v2flyNG Androidクライアント
まずOSを選び、次にアーキテクチャを確認します。デスクトップではv2rayN、Androidではv2rayNGがおすすめです。インストーラーでアプリを導入したら、サブスクリプションとプロキシを設定します。
プラットフォームのタブは矢印キーで切り替えられます。リンクにプラットフォームのアンカーが含まれる場合は、該当する一覧を直接開けます。
DESKTOP / x64
v2rayN Desktop版をダウンロード新世代のクロスプラットフォームUIを採用。初めて使う場合はDesktop版から始めると、異なるデスクトップOS間でも操作に慣れやすくなります。このリンクはx64のインストーラーZIPです。ダウンロード後に解凍し、フォルダー内のインストーラーを実行してください。
CLASSIC WPF / x64
v2rayN 従来のWPF版をダウンロードWindowsのWPF UIを採用した従来の安定版です。サーバー一覧やトレイメニュー、設定画面の配置に慣れている場合は、この版を引き続き利用できます。別のプロキシソフトではなく、UIの技術と操作レイアウトが主な違いです。
どちらもv2rayNです。まずは一方をインストールしてください。UI版を切り替える前に、サブスクリプショングループとルーティング設定をバックアップしましょう。
| 確認項目 | 選び方と準備 |
|---|---|
| OSとアーキテクチャ | 引き続きOSの更新を受けられるWindows 10 / 11を推奨します。このページの2つのパッケージはどちらもx64です。「設定 → システム → バージョン情報」でシステムの種類を確認してください。 |
| パッケージ形式 | ZIPアーカイブです。書き込み可能なローカルフォルダーに解凍してからインストーラーを実行してください。ZIPのプレビュー画面から直接起動しないでください。 |
| 実行環境 | 追加の.NETランタイムが必要かどうかは、配布パッケージと起動時のメッセージを確認してください。必要な場合は、対応するアーキテクチャと種類のランタイムをインストールします。 |
| プロキシの権限 | 通常のシステムプロキシは一般ユーザー権限で起動できます。TUNを有効にする場合は、管理者権限と仮想ネットワークインターフェイスが必要になることがあります。 |
ファイル名にSetupとあっても、外側のファイル形式はZIPの場合があります。先に解凍し、インストーラーと付属ファイルを同じフォルダーに置いてから、案内に従ってインストールしてください。パスはなるべく短くし、読み取り専用の場所、同期中のフォルダー、追加権限が必要な場所は避けましょう。起動に失敗した場合は、まずエラーメッセージを確認してください。ランタイム、権限、設定の破損はそれぞれ別の問題です。再インストールする前に原因を切り分けましょう。
v2rayNを開き、「サブスクリプショングループ設定」でグループを追加し、自分のサブスクリプションURLを入力して保存します。「サブスクリプションを更新」を実行してノードを取得してください。使うサーバーを選び、クライアントが起動していることを確認したら、システムプロキシのメニューで「システムプロキシを自動設定」を選択します。システムプロキシはアプリからの通信を受け付け、ルーティングは通信の行き先を決めます。別々の設定です。
旧バージョンから移行する場合は、ローカルポートを2つのアプリが同時に使わないよう、先に旧クライアントを終了してください。サブスクリプションURLは通常、再取得できますが、手動で追加したノード、カスタムルーティング、DNS設定は別途保存が必要です。まず通常のシステムプロキシで接続を確認してからTUNを試しましょう。基本の接続ができていない状態で仮想ネットワークアダプターを追加すると、原因の切り分けが難しくなります。
Windowsのインストール・設定手順を詳しく見る →
APPLE SILICON / arm64
Apple Silicon版をダウンロードApple Silicon搭載のMacはこちらを選択してください。arm64はチップのアーキテクチャを示すもので、OSのバージョン番号ではありません。Appleメニューの「このMacについて」で「チップ」を確認し、Apple Mシリーズと表示されていればこのパッケージを選びます。
INTEL / x64
Intel版をダウンロードIntelプロセッサ搭載のMacではx64版を選びます。「このMacについて」にIntelプロセッサと表示されている場合はこちらです。外観や購入時期からアーキテクチャを推測せず、チップ名を確認しましょう。やり直しを防げます。
| 確認項目 | 選び方と準備 |
|---|---|
| プロセッサ | Apple Siliconはarm64、Intelはx64です。「このMacについて」で確認してください。 |
| OSの対応状況 | 引き続きOSの更新を受けられるmacOSを使用してください。最低バージョンは、現在のアプリの配布要件とOSのインストール時の案内を確認してください。 |
| パッケージ形式 | DMGディスクイメージです。開いた後、アプリを「アプリケーション」フォルダーにコピーし、ローカルのアプリフォルダーから起動してください。 |
| ネットワーク権限 | システムプロキシの変更やTUNの有効化では、OSに表示される権限の確認に従ってください。通常の起動だけでは、ネットワーク通信がプロキシ経由になったとは限りません。 |
DMGをダウンロードしたら、ブラウザーの保存が完了してからディスクイメージを開きます。v2rayNを「アプリケーション」にコピーし、マウントしたイメージから長期間起動しないでください。コピー後、ローカルのアプリが起動することを確認したら、ディスクイメージを取り出せます。OSに起動をブロックされた場合は、まず理由を確認し、「システム設定 → プライバシーとセキュリティ」で該当する記録を確認してください。セキュリティチェックを一括で無効にして対処しないでください。
初回起動時はサブスクリプションを追加してノードを更新し、サーバーを選択します。システムプロキシを有効にしたら、「システム設定 → ネットワーク」で現在のネットワークサービスのプロキシ設定を確認すると、クライアント側の設定状況を把握できます。Wi-Fi、有線LAN、職場のネットワークを切り替えた後は、プロキシの状態を再確認してください。ブラウザーで通信できても、すべてのターミナルアプリがシステムプロキシを使うとは限りません。
TUNを使う前に、正常に動作する基本設定を保存してから、アプリの案内に従って権限を許可してください。接続に問題が出たら、新しく有効にしたモードをオフにして基本設定へ戻します。ノード、DNS、ルーティングを一度に変更しないでください。クライアントを終了する前にプロキシをオフにしましょう。特に更新やクライアントの切り替え時は、停止したプロセスが待ち受けるローカルポートをシステムが参照し続けないよう注意してください。
macOSのインストール・設定手順を詳しく見る →
Xrayコア · サブスクリプショングループ · VPNモード
arm64-v8a / 主流アーキテクチャ
v2rayNG arm64版をダウンロード2015年以降に発売された一般的なスマートフォンでは、まずarm64版を選ぶとよいでしょう。このパッケージには対象アーキテクチャ向けのファイルのみが含まれ、64ビットアプリに対応する端末に適しています。最終的には端末の実行環境を確認してください。プロセッサが64ビットに対応していても、OSが同じアプリ対応を提供しているとは限りません。
UNIVERSAL / 複数アーキテクチャ対応
v2rayNG Universal版をダウンロードアプリのアーキテクチャがわからない場合はUniversal版を選べます。複数のアーキテクチャ向けコンポーネントを含むため、単一アーキテクチャ版よりファイルサイズが大きくなります。Universal版でもアプリの最低OS要件は変わりません。
v2flyコア · 設定との互換性で選択
arm64-v8a / 主流アーキテクチャ
v2flyNG arm64版をダウンロードv2flyコアが必要で、端末がarm64アプリに対応している場合に適しています。同じコア環境向けの設定をすでに使っている場合は、代替クライアントとして選択できます。プロトコルと通信方式はサーバー側と一致させる必要があります。コア名だけで設定の確認を省略することはできません。
UNIVERSAL / 複数アーキテクチャ対応
v2flyNG Universal版をダウンロードアーキテクチャがわからない場合はUniversal版を選んでください。v2flyNGとv2rayNGは別のアプリのため、設定と権限をそれぞれ設定する必要があります。切り替えて試す際は、もう一方の接続を停止し、同時にVPNを制御するアプリは1つだけにしてください。
| 確認項目 | 選び方と準備 |
|---|---|
| アプリのアーキテクチャ | 一般的な端末ではarm64がおすすめです。判断できない場合はUniversal版を選んでください。インストーラーにアーキテクチャ非対応と表示されたら、OSが実際に対応するアーキテクチャを再確認します。 |
| OSのバージョン | 最低OS要件はクライアントのバージョンによって異なるため、インストーラーの案内を確認してください。Universal版でも最低OS要件は変わりません。 |
| インストール権限 | APKのインストールには、使用中のブラウザーまたはファイル管理アプリで「不明なアプリのインストール」を許可する必要があります。インストール後は、そのアプリからのインストール権限を取り消せます。 |
| 接続権限 | 初回接続時にOSのVPN許可が必要です。バックグラウンドでの動作が停止する場合は、バッテリー設定で該当アプリの制限を緩和してください。 |
ダウンロードしたAPKを開き、OSの案内に従って現在のファイル提供元にインストールを許可してください。「提供元」とはファイルを開いたアプリ（ブラウザーやファイル管理アプリなど）を指します。端末全体のセキュリティ設定を変更する必要はありません。インストーラーに「アプリをインストールできませんでした」と表示された場合は、まず理由を記録し、アーキテクチャ、空き容量、OSのバージョン、旧版との署名の競合を確認してください。すべての失敗をダウンロードファイルの問題と決めつけないでください。
v2rayNGの「サブスクリプショングループ設定」にURLを保存し、メイン画面に戻って「サブスクリプションを更新」を実行します。単一ノードの共有リンクを受け取った場合は「クリップボードからインポート」を使い、サブスクリプションURL欄には入力しないでください。インポート後にノードを選択し、接続ボタンをタップしてVPNを許可します。VPNモードはアプリの通信をクライアントに取り込む機能で、通信を直接接続するかプロキシ経由にするかはルーティング設定で決まります。
バックグラウンドで切断される場合は、まずOSのバッテリー設定でアプリが停止されていないか確認し、次にノードのログを確認してください。対象クライアントだけバックグラウンド実行を許可すればよく、すべてのアプリの制限を緩和する必要はありません。v2rayNGはXrayコア、v2flyNGはv2flyコアを使用しており、対応する設定項目は異なる場合があります。特にプロトコルと通信方式の組み合わせに注意してください。使用中のサービス設定でXray固有の機能が必要な場合は、v2rayNGを優先してください。
v2rayNGのサブスクリプション設定と初回接続の手順を見る →
DEB / x64
v2rayNのDEBパッケージをダウンロードUbuntuやDebianなど、DEB形式のパッケージ管理を採用するx64デスクトップではこちらを選択してください。ファイル名のamd64は一般的なx86_64と同じ系統のアーキテクチャを指し、プロセッサのメーカーを限定しません。インストール時はOSのソフトウェアインストーラーで依存関係を処理してください。
RPM / x64
v2rayNのRPMパッケージをダウンロードFedoraやopenSUSEなど、RPM形式を採用するx64デスクトップはこちらからダウンロードしてください。同じパッケージ形式でも、ディストリビューション間で依存関係が完全に一致するとは限りません。ライブラリ不足やパッケージのバージョン競合が表示された場合は、使用中のディストリビューションに応じて対処してください。
ARM64デスクトップでは対応パッケージを選んでください。上のx64ファイルはインストールしないでください。
| 確認項目 | 選び方と準備 |
|---|---|
| デスクトップ環境 | GUIアプリを実行できるLinuxデスクトップセッションが必要です。このページで配布しているのはGUIクライアントで、サーバー用のインストールパッケージではありません。 |
| プロセッサのアーキテクチャ | x86_64 / amd64はx64、aarch64 / arm64はARM64を選択します。OSの「バージョン情報」またはハードウェア情報で確認してください。 |
| パッケージ管理方式 | UbuntuやDebianではDEB、FedoraやopenSUSEなどRPM系のディストリビューションではRPMを選び、使用中のOSとの依存関係の互換性も確認してください。 |
| 権限と依存関係 | パッケージのインストールには管理者権限が必要です。GUIアプリは通常、一般ユーザーで起動します。TUNは案内に従って別途権限を許可してください。 |
Linuxパッケージを選ぶ際は、パッケージ管理方式とプロセッサのアーキテクチャを順番に確認してください。DEBとRPMはインストール形式、x64とARM64は実行アーキテクチャで、互いに置き換えることはできません。拡張子を書き換えても形式は変換されません。インストールパッケージを開いてOSのソフトウェアインストーラーに渡し、依存関係の案内を確認してからインストールしてください。ディストリビューション非対応と明示された場合は中止し、依存関係を無視して進めないでください。
インストール後、アプリメニューからv2rayNを起動し、サブスクリプショングループを追加してノードを更新します。Linuxデスクトップでシステムプロキシが有効になるかは、デスクトップ環境とアプリによって異なります。ブラウザーはデスクトップのプロキシ設定を参照しても、コマンドラインツールは参照しない場合があります。まずシステムプロキシに対応したアプリでテストし、ほかのプログラムのプロキシ設定はその後に行ってください。ノードが使えるかどうかと、アプリの通信がプロキシを経由するかどうかは分けて確認しましょう。
ログイン後に自動起動するには、デスクトップ環境の「自動起動アプリ」などの設定にv2rayNを追加します。ユーザーログイン時の自動起動と、OS起動時のシステムサービスは別の仕組みです。GUIクライアントはユーザーセッションの準備ができてから起動してください。更新前はアプリを正常に終了し、ユーザー設定を保管します。TUNを有効にした後にネットワークの問題が出た場合は、通常のプロキシ方式に戻してから権限、インターフェイス、ルーティングを確認してください。
Linuxデスクトップへのインストールと自動起動の手順を見る →ダウンロードが終わっても、作業はまだ続きます。クライアント、サブスクリプション、通信の入口、ルーティングはそれぞれ別の役割を担います。順番に設定すると問題を特定しやすくなります。まずシンプルな接続を確認し、その後でルーティング、DNS、TUNを追加してください。一度に変更する設定を1つにすれば、ログを比較しやすくなります。
01 / 設定情報
更新可能なサブスクリプションURLか、vmess://、vless://などで始まる単一ノードのリンクかを確認してください。サブスクリプションは「サブスクリプショングループ設定」に登録し、共有リンクはクリップボードからインポートします。WebページのURL、ログインページのURL、サブスクリプションURLは異なる場合があります。インポート前にサービスの案内を確認してください。
02 / プロキシの入口
デスクトップではシステムプロキシを有効にし、AndroidではVPNを許可します。ノードが一覧に表示されるのは、インポートが成功したという意味にすぎません。接続テストを始めるには、クライアントを起動し、アプリの通信を取り込む必要があります。ポートの競合、システムプロキシの上書き、VPNの競合を避けるため、ほかのプロキシアプリは先に停止してください。
03 / 接続結果の確認
普段使っているブラウザーで対象サイトにアクセスし、クライアントのログに接続記録が表示されるか確認してください。接続できたら、適切なルーティングモードを選択します。システムプロキシと「LAN内および中国本土のアドレスをバイパス」などのルーティング設定は別の機能です。ルーティングを切り替えても、システムプロキシの設定漏れは解消されません。
バージョン番号はダウンロード一覧の更新に応じて変わります。デスクトップ版とAndroid版はそれぞれ個別に管理されているため、番号を一致させる必要はありません。更新するかどうかは、必要な機能とリリース内容を確認して判断してください。設定が正常に動いている場合は、更新前にバックアップを取ります。問題が起きた際は、何度も再インストールするより、更新前後の違いを記録するほうが原因を特定しやすくなります。詳しい手順は使い方ガイド、OS別の詳細は全プラットフォーム向けインストール・設定ガイドをご覧ください。
設定を変更する前に、インストールの問題か接続の問題かを切り分けましょう。
初めてインストールする場合は、新世代のクロスプラットフォームUIを採用したDesktop版がおすすめです。従来のWindows画面や操作に慣れている場合はWPF版を選びましょう。どちらもv2rayNです。ダウンロード前にパッケージ名を確認し、切り替える前に設定をバックアップしてください。2つのクライアントを同時にシステムプロキシへ適用しないでください。
2015年以降に発売された一般的なスマートフォンでは、まずarm64版を選ぶとよいでしょう。ただし、実際に対応するアプリのアーキテクチャを確認してください。判断できない場合はUniversal版を選べます。インストールに失敗する原因は、ダウンロードの中断、OSのバージョン、署名の競合、インストール権限なども考えられます。購入年だけで判断しないでください。
インストーラーに含まれるのはクライアントアプリで、すぐ使えるサブスクリプションは含まれていません。サブスクリプションURLや共有リンクは、利用中のサービスまたは自分で構築したサーバーから入手してください。v2rayNとv2rayNGそれぞれの「サブスクリプショングループ設定」にURLを保存し、サブスクリプションを更新します。URLにアクセス認証情報が含まれる場合があるため、公開しないでください。
サブスクリプショングループ、ルーティング設定、必要な設定をバックアップしてから、旧クライアントを終了してください。同じアプリで署名に問題がなければ、Androidでは通常、上書きインストールできます。デスクトップ版はインストーラーの案内に従って更新してください。署名の競合、配布パッケージの変更、UI版の切り替えがある場合は、旧データをすぐに削除せず、新しいクライアントで設定を読み込めることを確認してください。
まずブラウザーのダウンロードが完了していることと、ファイルの拡張子が選択したOSに合っていることを確認してください。WindowsのZIPは解凍してから実行します。AndroidはAPK、macOSはDMG、Linuxはディストリビューションに応じてDEBまたはRPMを使用します。ダウンロードが中断された場合は再度ダウンロードしてください。OSにインストールをブロックされた場合は、表示されたメッセージを確認し、セキュリティ機能を一括で無効にしないでください。
インストール、インポート、プロキシの起動はそれぞれ別の手順です。まずノードを選択してクライアントを起動し、デスクトップではシステムプロキシが有効か、AndroidではVPNの許可が完了しているか確認してください。ブラウザーのプロキシ設定、ほかのプロキシアプリ、ルーティングルール、DNSも接続に影響します。ログに表示されたエラーを一つずつ確認し、複数の設定をまとめて変更しないでください。
さらに確認する：よくある質問 · 3つのクライアントを比較