デスクトップクライアント · 日本語設定ガイド

V2Ray for Macv2rayNのダウンロードと設定

サブスクリプションの取り込みからルーティング設定まで、オープンソースクライアントを手順に沿って設定。システムプロキシ、TUN、コアの設定も解説します。

永久無料 オープンソース Xray-core · sing-box

クライアントの操作

サブスクリプション・プロキシ・ルーティング
個別に設定し、一つずつ動作を確認

GUIクライアントは接続情報や実行状態を管理し、実際の通信処理はコアが担います。インポートの成功、コアの起動、アプリでのプロキシ利用は、それぞれ別の確認ポイントです。まず一つの接続を正常に動作させてから、ルールや適用範囲を広げましょう。設定変更の影響箇所を絞れるため、問題の切り分けも容易になります。

サブスクリプショングループの設定

グループ名個人用サブスクリプション
サブスクリプションURL利用中のURLを入力
サブスクリプションを更新サーバー設定を取得
更新後に確認利用サーバーとプロトコル

画面は操作の構成を示すイメージです。メニュー名はプラットフォームやビルドによって異なり、ポートも変更できます。設定項目を確認する際は、まずクライアントがどのコアを使用しているか確認し、対応する設定構造を参照してください。GUIの項目名をそのままJSONのキーとしてコピーしないでください。

設定ファイルのリファレンスを見る →

インストーラーの選び方

OSとプロセッサに合ったクライアントを選択

デスクトップではv2rayN、Androidではまずv2rayNGを確認し、V2Flyコアを使う場合はv2flyNGも選択肢になります。同じOS向けでも、インストーラーを共用できるとは限りません。ダウンロード前にCPUアーキテクチャとパッケージ形式を確認してください。インストール後、手元にあるサーバー情報またはサブスクリプションを使って設定します。

Windows

v2rayN · Desktop / WPF

新しいクロスプラットフォームUI版と、従来のWPF版を選べます。初めてインストールする場合は、ダウンロードページで両者の違いを確認し、実行環境に合った版を選びましょう。現在の設定を継続して使う場合は、更新前にサブスクリプショングループ、独自ルール、関連設定をバックアップしてください。

プログラムは、現在のユーザーが書き込み可能なフォルダーに配置し、圧縮ファイルの中から直接実行しないでください。起動時に実行環境に関するメッセージが表示された場合は、案内に従って必要な依存関係を解決します。ウィンドウが開かないことを、サーバーの障害と決めつけないようにしましょう。システムプロキシが有効になった後も、ブラウザーが独自のプロキシ拡張機能を使っていないか、ローカルの待ち受けポートが他のプログラムと競合していないか確認してください。

ダウンロードページへ

macOS

v2rayN · Apple Silicon / Intel

「このMacについて」でチップ情報を確認します。Apple Siliconはarm64、Intelプロセッサはx64に対応します。外観や購入年ではなく、搭載チップに合わせてインストーラーを選んでください。インストール後はアプリケーションフォルダーから起動し、アプリの起動に関するシステムの案内に従います。

メニューバーからシステムプロキシの切り替えや動作状態の確認ができます。TUNを使う場合は、現在のビルドが対応しているか、必要な権限は何かを確認してください。最初から複数の通信制御ツールを同時に有効にするのは避けましょう。メインウィンドウを閉じても接続が続く場合は、メニューバーでクライアントが動作中か確認します。終了時には、ネットワークのプロキシ設定が元に戻っていることも確認してください。

ダウンロードページへ

Android

v2rayNG · v2flyNG

v2rayNGはXrayコア、v2flyNGはV2Flyコアを使用します。比較的新しいスマートフォンの多くはarm64版を選べます。端末のアーキテクチャがわからない場合は、ダウンロードページにある汎用版を確認してください。名前が似ていても、コアの機能や設定への対応状況は異なります。アイコンだけで判断せず、それぞれ確認しましょう。

初回接続時には、システムのVpnServiceを許可する必要があります。許可後に接続を確認し、バックグラウンドで切断されやすい場合は、バッテリー最適化やメーカー独自のバックグラウンド制限を確認してください。アプリごとのプロキシ設定では、どのアプリを通信制御の対象にするかを指定します。「選択したアプリ」の意味を確認してから設定し、プロキシ経由と対象外を取り違えないようにしましょう。他の通信制御アプリを同時に使うと、権限や実際の通信経路に影響する場合もあります。

ダウンロードページへ

Linux

v2rayN · deb / rpm

まずディストリビューションで使われているパッケージ形式を確認し、x64版とarm64版を選びます。debとrpmは異なる形式のため、拡張子を書き換えても相互に使えるようにはなりません。ダウンロードページには形式ごとの入口があり、GUIのソフトウェア管理ツールでインストールするデスクトップ環境に適しています。

システムプロキシを参照する方法はデスクトップ環境によって異なります。ブラウザーで使えても、すべてのプログラムがプロキシを利用するとは限りません。初回起動時はコアの起動ログを確認し、実際に通信させたいアプリで動作を検証してください。TUNを有効にする前に、必要な権限とネットワーク管理方式を確認します。競合が起きたら、他の仮想インターフェースや同種の通信制御プログラムを停止してください。問題を再現できる最小限の設定を残し、DNS、ルーティング、サーバーを同時に変更しないようにしましょう。

ダウンロードページへ

インストーラーとシステム要件はダウンロードページにまとめています。クライアントを変更する前に、元のサブスクリプション情報を保管してください。クライアントが出力する実行用設定には自動生成された項目が含まれる場合があるため、別のコアへそのまま移行するのは避けましょう。

すべてのクライアントを見る →

オープンソースと設定の基礎

Project V、V2Fly、Xray

V2Rayは、エコシステムや技術に関する議論で広く使われる名称です。実際に利用できる機能は、クライアント、コア、設定の組み合わせによって決まります。この3つを分けて考えると、インストーラーやガイド、プロトコル設定が現在の環境に適しているか判断しやすくなり、「取り込めたのに接続できない」といった誤解も減らせます。

Project Vのモジュール設計

Project Vは、モジュール化されたネットワークプロキシツールを目指して開発され、V2Rayはその中でも広く使われている実装です。設定は、inbounds、outbounds、routing、DNSなどの要素で構成されます。inboundsはローカルアプリからの接続を受け付け、outboundsは接続先やプロキシサーバーへの接続方法を定義し、routingは出口を選択します。この構造により、プロトコルと通信処理を個別に設定できますが、接続全体には複数の要素が関わります。問題を調べる際は、サーバーアドレスだけでなく、ローカルポート、通信パラメーター、ルーティング先も確認してください。

V2FlyとXrayの関係

V2FlyはV2Rayのコミュニティによる保守と実装の発展を引き継ぎ、Xrayは関連コードを基盤として独立して開発されているコアプロジェクトです。技術的な背景は共通していますが、その後の機能や設定項目への対応は完全には一致しません。VMess、VLESSなどのプロトコル名を確認したら、通信方式、安全設定、コアごとの実装要件も確認してください。設定の見た目が似ていても、すべての項目を異なるコア間でそのまま使えるとは限りません。sing-boxにも独自の設定体系があるため、Xrayのルーティング設定をそのまま貼り付けず、対応する構文を確認しましょう。

3つのGUIクライアントの役割

v2rayNはデスクトップ向けで、サーバー管理、サブスクリプショングループ、システムプロキシ、コア関連の設定を提供します。v2rayNGはAndroid向けで、Xrayコアとシステムのネットワークサービスを利用して接続を処理します。v2flyNGは、AndroidでV2Flyコアを使いたい場合の選択肢です。いずれもオープンソースで、ソースコードをコミュニティが確認・改善できます。GUIは手動で設定を書く手間を減らしますが、有効なサーバー情報を用意したり、誤った認証情報やサーバー側の通信設定を自動修正したりするものではありません。

オープンソースライセンスとサービスの提供元

オープンソースライセンスは、コードの使用、改変、再配布に関する条件を定めるもので、プロキシサービスの利用規約とは異なります。クライアント、コア、パッケージに含まれる依存ソフトウェアには、それぞれ別のライセンスが適用される場合があります。再配布する際は、各プロジェクトのライセンスと告知を確認してください。クライアントを無料で使えても、サーバーへの接続情報がクライアントプロジェクトから提供されるわけではありません。サブスクリプションの提供状況、認証情報、利用範囲は、情報の提供元に確認してください。設定を公開する前に、サブスクリプションURL、ユーザーID、パスワードなど、個人のサービスにアクセスできる情報を削除しましょう。

クライアントとコアの更新

GUI、コア、ルールセットの更新は、それぞれ異なる問題に対応します。GUIの更新では操作方法や設定生成の仕組みが変わることがあり、コアの更新ではプロトコル実装やパラメーターの制約が変わる場合があります。ルールセットの更新は、ドメインやアドレスの分類に影響します。更新前に動作する設定を記録し、変更内容を確認してから、更新後に同じ手順で動作を検証してください。設定の解析に失敗したら、ログに示された項目とファイルの場所を優先して確認します。アップグレード、プロトコルの切り替え、ルーティングの変更を同時に行わないでください。一度に一つだけ変更すれば、原因を特定しやすくなります。

接続確認からルーティング確認へ

まずコアが起動することを確認し、次にローカルの待ち受けを調べ、最後にアプリの通信が実際にプロキシを経由しているか確認します。Webページが表示されても、すべてのアプリやリクエストが同じ出口を使っているとは限りません。基本接続ができたら、LANへのアクセス、特定ドメインのルール、DNSの動作を順に確認しましょう。遅延テストは特定の経路を測るもので、実際の通信全体が成功することを保証しません。タイムアウトが続く場合は、システム時刻、ポート、ファイアウォール、認証、通信設定の順に確認し、一度のテスト結果だけでサーバーをすべて削除しないでください。

設定リファレンスの読み進め方

すでに接続できている場合は、outboundsの出力タグとroutingルールの関係から確認してください。ローカル接続を調べる場合は、inboundsの待ち受けアドレス、プロトコル、ポートから始めます。ドメインの名前解決が関係する場合は、dnsとルーティングの名前解決ポリシーを合わせて確認しましょう。policyなどのポリシー項目は、初回起動で必ず変更する必要はありません。明確な目的がある場合にのみ調整してください。設定例は項目同士の関係を説明するものです。統合する前に、使用中のコアの完全な設定構造と照らし合わせ、動作している元の設定を復元用に保存しておきましょう。

使い方とトラブル対処の記事

最近更新された使い方ガイド

実際の利用場面に合わせてクライアントの使い方を解説します。バックグラウンドで切断される、LANで共有できない、起動しないといった場合は、該当する症状を確認し、記事の順序に沿って切り分けてください。権限やファイアウォールを変更する際は、影響範囲を把握し、元の設定に戻す方法も確保しておきましょう。

v2rayNGの使い方:VpnServiceの許可、バッテリー最適化の対象外設定、アプリごとのプロキシ

Androidで接続が切れる、またはプロキシを経由しない場合、システムの許可、バックグラウンドでの省電力制御、対象アプリの設定が原因のことがあります。接続前の許可、バックグラウンド動作、アプリごとの設定の順に確認し、クライアント設定とシステム制限を切り分けましょう。

記事を読む →

v2rayNの起動直後にクラッシュする場合:.NETランタイム、フォルダーのアクセス権、設定ファイルの破損への対処

ウィンドウがすぐ閉じる場合は、まずGUIのビルドと実行環境を切り分け、フォルダーの書き込み権限と設定ファイルを確認します。元の情報を残し、一つずつ原因を除外して起動を復旧しましょう。設定をすべて削除するのは避けてください。

記事を読む →
v2rayN をダウンロード