オープンソースクライアントダウンロードと設定ガイド
デスクトップ・Androidクライアントを紹介し、サブスクリプションの読み込みとルーティング設定の手順を解説します。
Project V エコシステム · クライアントとコアの役割
ダウンロード
デスクトップではv2rayN、Androidではv2rayNGが主な選択肢です。まずOSとCPUアーキテクチャを確認し、該当するパッケージ一覧を開いてください。
DesktopはクロスプラットフォームのUIを採用し、WPF版は従来のデスクトップ操作に対応しています。どちらもサブスクリプション管理とプロキシ設定が中心です。画面が異なっても、再購入やサブスクリプションの変更は必要ありません。
まず「設定 → システム → バージョン情報」でシステムの種類を確認します。初回起動時にランタイムの案内が表示された場合は、パッケージの説明に従って必要な依存関係を追加してください。UI版を切り替える際は、使用中のファイルを上書きしないよう、設定フォルダーを残してから作業します。
ダウンロードへ Windows クライアント →チップに合わせてApple Silicon版またはIntel版を選びます。システムメニューの「このMacについて」を開き、チップ名かIntelプロセッサのどちらが表示されるか確認してください。外観や購入年だけでアーキテクチャを判断しないでください。
クライアントはアプリケーションフォルダーに移してから起動すると、更新や権限の管理がしやすくなります。システムプロキシとTUNは別の機能です。初めて設定する場合は、通常のプロキシ接続を確認してから、用途に応じてネットワーク権限を設定してください。
ダウンロードへ macOS クライアント →v2rayNGはXrayコアを使用するAndroid向けの主な選択肢です。v2flyNGはV2Flyコアを使用し、対応する設定をすでに利用している場合に適しています。比較的新しい端末ではarm64版を確認してください。アーキテクチャが不明な場合は、汎用版の説明を参照します。
接続時にAndroidのVPN接続許可を確認してください。別のネットワークツールが接続を使用中の場合は、先にそちらを停止します。バックグラウンドで接続が切れる原因には、バッテリー管理も考えられます。設定を読み込めても、継続動作に必要な権限が付与されたとは限りません。
ダウンロードへ Android クライアント →ディストリビューションのパッケージ形式に合わせてdebまたはrpmを選び、x64とarm64のどちらかを確認してください。デスクトップ環境のシステムプロキシ設定が適用されるのは、その設定に従うアプリだけです。ターミナルのツールでは、プロキシを別途指定する必要がある場合があります。
初回はサブスクリプションを更新し、設定を選んでからアプリの通信をテストします。TUNを使う場合は、必要な権限とローカルのネットワーク管理方法を確認してください。原因を特定しやすくするため、ルーティング、DNS、ファイアウォールを一度に変更しないでください。
ダウンロードへ Linux クライアント →クライアントは設定を読み込み、ローカルの接続口を制御します。サーバーアドレス、ポート、認証情報は別途用意してください。当サイトはダウンロード情報と技術ガイドを掲載しており、サブスクリプションアカウントやサーバーを提供していません。
すべてのクライアントを見る →設定ガイド
設定の入手元、通信の入口、コアの接続先を分けて確認しましょう。項目を選ぶと、対応する操作手順と設定例を確認できます。
複数の設定をまとめて更新するには、サブスクリプションが便利です。v2rayNの「サブスクリプショングループ → サブスクリプショングループの設定」でグループを追加し、URLを入力して保存したら、サブスクリプションを更新します。個別の共有リンクはクリップボードから読み込み、サブスクリプションURL欄には入力しないでください。グループを使えば提供元ごとに整理し、一括管理できます。更新するとグループ内の内容が置き換わるため、手動で変更した設定を残す場合は事前にエクスポートしてください。サンプルURLは形式の確認用で、実際の接続には使えません。
https://example.com/sub?token=xxxxルーティングルールは、コアに通信が届いた後に適用され、通常は上から順に確認して最初に一致したルールが使われます。すべてのリクエストを同じ接続先に送る方法と異なり、カスタムルールならローカルネットワーク、指定ドメイン、その他の通信を個別に扱えます。以下の例では、中国のドメインセットとプライベートIPアドレスをdirectに振り分けます。実際の設定では、同じ名前の出力先と、対応するルールデータベースが必要です。変更前に既存のルールをバックアップし、一度に変更する条件を一つに絞って対象アプリで確認してください。入口の問題をルーティングの問題と取り違えないようにしましょう。
{
"routing": {
"rules": [
{
"type": "field",
"domain": ["geosite:cn"],
"outboundTag": "direct"
},
{
"type": "field",
"ip": ["geoip:private"],
"outboundTag": "direct"
}
]
}
}システムプロキシはOSの設定を通じて、対応するアプリにローカルプロキシの使用を促します。この設定に従うアプリにのみ有効です。「システムプロキシを自動設定」は設定を書き込み、「システムプロキシを解除」は設定を削除します。「システムプロキシを変更しない」は現在の状態を維持します。TUNは仮想ネットワークインターフェースを使って通信を取り込むため、通常のシステムプロキシとは対象範囲が異なり、権限、ルーティング、DNSにも関係します。まずシステムプロキシで動作を確認し、必要に応じてTUNを有効にしてください。どちらも、サーバー側の設定の代わりにはなりません。
アプリがプロキシを使わない場合の対処 →v2rayNの画面は設定を管理し、コアはプロトコルの処理と通信の転送を担います。利用できるコアや切り替え方法は、使用中のパッケージによって異なります。選択が必要な場合は、設定画面で対象プロトコルに対応するコアの種類を確認してください。Xray-coreとv2fly-coreはそれぞれ独自に開発が進んでおり、プロトコル名が似ていても、すべての設定項目に互換性があるとは限りません。画面だけを変更する場合とは異なり、コアの切り替えは設定の解析能力にも影響します。切り替え後は起動ログを確認し、コアの起動と、トランスポートやセキュリティの設定がサーバー側と一致していることを確かめてください。
コアとプロトコルの用語を見る →端末間の移行では、まず元のサブスクリプションURLを使います。個別設定しかない場合は、サーバー一覧で項目を選び、右クリックメニューから共有リンクをエクスポートして、移行先のクライアントでクリップボードから読み込みます。画面によってメニュー名が異なる場合があるため、エクスポートとインポートの機能を確認してください。設定フォルダー全体のコピーよりも共有リンクのほうが接続情報を渡しやすい一方、通常はルーティング、DNS、システム権限までは含まれません。移行後はローカルポートとプロキシモードを確認してください。認証情報を含むリンクは、管理された端末間でのみ共有します。
全OSのインストール・移行ガイドを見る →設定を読み込んだら、まず選択可能な設定があることを確認し、次にコアが起動するか、アプリの通信が入口を通っているかを確認します。その後でルーティングとDNSを調整してください。ブラウザーで特定のページが開けても、そのリクエストが成功したことを示すだけで、すべてのアプリが同じプロキシ設定に従うとは限りません。さらに調べる場合は、同じアプリと接続先でテストを繰り返し、直前に変更した項目を記録します。一度に変更する条件を一つにすれば、問題が起きた際に戻す根拠が明確になります。
オープンソースのエコシステムとメンテナンス範囲
クライアント、コア、サブスクリプションサービスはそれぞれ異なる役割を担います。役割を区別すると、ソフトウェア名だけを覚えるよりも選定やトラブル対処がしやすくなります。
Project Vは、プロキシ通信ツールを中心に形成された技術エコシステムで、V2Rayはその中で広く使われている実装です。V2FlyはV2Rayのコミュニティによる保守と開発を引き継ぎ、Xrayは関連するコードを基盤としながら独自に発展しています。共通する概念もありますが、新機能、設定項目、リリースのペースは完全には一致しません。設定ドキュメントを読む際は、対象のコアも確認してください。ある実装の設定を、別の実装にそのまま適用できるとは限りません。
プロトコル、トランスポート方式、セキュリティレイヤーも分けて理解する必要があります。VMess、VLESS、Trojan、Shadowsocksはそれぞれ異なるプロトコル方式を示し、WebSocketなどのトランスポート設定はデータの運び方、TLSなどのセキュリティ設定は別のレイヤーを扱います。クライアントを選ぶ前に、既存のサーバーが必要とする機能を確認してください。互換性のあるツールを、設定項目の多さだけを理由に変更する必要はありません。各項目の詳細は、サーバーから提供された情報と使用するコアの対応範囲を基準にしてください。
v2rayNはデスクトップ向けで、サブスクリプショングループ、サーバー設定、ルーティング、ローカルプロキシの入口を管理できます。v2rayNGはAndroid向けでXrayコアを使用し、v2flyNGもAndroid向けでV2Flyコアを採用しています。いずれもオープンソースプロジェクトです。画面は操作を整理する役割を担い、実際のプロトコル対応状況は同梱コアと設定に左右されます。デスクトップとスマートフォンで同じサブスクリプションを使える場合もありますが、各端末のネットワーク設定は個別に確認してください。
AndroidのシステムVPN許可、デスクトップのシステムプロキシ、TUNの権限は、それぞれ異なる仕組みです。接続情報を移行しても、すべてのアプリが通信に接続されたとは限りません。クライアントの違いを比較する場合は、OS、コアの系統、設定管理の方法を確認してください。特定のプロトコルが使えるか判断するには、トランスポートとセキュリティの設定も確認します。画面の複雑さや設定項目の数から通信速度を判断することはできません。
オープンソースとは、各ライセンスの条件に従ってコードを閲覧、利用、変更できることを意味します。V2FlyのV2Rayコアは主にMITライセンス、Xrayコアは主にMPL-2.0ライセンスを採用しています。クライアント、コア、同梱コンポーネントのライセンスは、それぞれ付属の説明を確認してください。一つのプロジェクトのライセンスだけで、パッケージ全体の利用条件を判断することはできません。再配布や改変を行う場合は、適用される表示を残し、具体的な義務を確認してください。
コードが公開されていても、すべてのサブスクリプションが安全とは限らず、設定の提供元を確認する必要があります。サブスクリプションURLにはアクセス情報が含まれる場合があり、共有リンクにはサーバーアドレスや認証情報が含まれることがあります。問題を報告する際は、エラーの種類、コア名、関連設定を残し、アカウントを特定できる情報は削除してください。クライアントの利用にあたっては、所在地の法律と利用するネットワークの管理規則を守ってください。このガイドではソフトウェアのインストールと技術設定を扱います。
クライアントの更新は画面や設定生成の仕組みに、コアの更新はプロトコル解析や通信転送に、GeoIP・GeoSiteデータの更新はルールセットに影響します。それぞれ解決する問題が異なります。ドメインの振り分け結果が変わった場合は、ルールの参照先とデータベースを確認してください。設定を解析できない場合は、まずログとコアの互換性を確認します。すべての問題をクライアントの古さのせいにしたり、原因を確かめずに全コンポーネントを一度に更新したりしないでください。
更新前にサブスクリプショングループと手動管理しているルールを保存し、以前の設定に戻せることを確認してから、ダウンロードページでパッケージ形式とアーキテクチャに合ったものを選んでください。当サイトはインストールと設定の手順を紹介するサイトであり、クライアントの公式開発チームではありません。サーバーへの接続を保証するものでもありません。ガイド内の画面表示は機能を見つけるための目安です。画面が異なる場合は、現在のUIとログを基準に確認してください。
設定とトラブル対処の記録
まず症状を特定し、該当する手順を確認してください。以下の記事では、アプリの通信経路、クライアントの起動、ルールの適用をそれぞれ扱い、異なる問題を切り分けます。
ブラウザーがプロキシを経由しない場合は、拡張機能やプロキシ設定の上書きが原因のことがあります。ターミナルの場合は環境変数を手動で設定する必要があります。この記事では、それぞれの確認手順を紹介します。
記事を読む →.NETデスクトップランタイムの不足、インストール先への書き込み権限、コアファイルの欠落やブロックなど、クライアントが起動直後に終了する主な原因を、発生頻度順に整理して対処法を紹介します。
記事を読む →v2rayNのカスタムルーティングを例に、domain、ip、outboundTagの各項目を解説します。直接接続、プロキシ、ブロックの3種類のルールについて、優先順や一般的な記述方法も紹介します。
記事を読む →よくある質問
インストール、設定の読み込み、接続は連続する3つの段階です。現在つまずいている手順のガイドを確認すれば、すべてのコンポーネントを最初から入れ直す必要はありません。
ヘルプセンターを見る →クライアントには個人用のサーバーアカウントは付属していません。有効なサブスクリプションまたは個別の共有リンクを用意し、読み込んで設定を選ぶと接続できます。サブスクリプションを更新できない場合は、URLの形式、提供元の状態、ネットワークへの接続を確認してください。認証情報を含むURLを、安易にオンライン変換サービスへ渡さないでください。手順は使い方ガイドをご覧ください。
異なります。システムプロキシは、OS設定に従うアプリのリクエストをローカルのプロキシ入口へ送るかどうかを決めます。「グローバル」は通常クライアントのルーティング設定で、コアに届いた通信の接続先を決めます。アプリがプロキシに接続されていない場合、ルーティングモードを切り替えても解決しません。関連用語は用語集をご覧ください。
変換で変更できるのは主に設定の表現形式です。コアに元からないプロトコル機能を追加することはできず、独自の設定項目が失われる場合もあります。提供元が用意する互換性のあるサブスクリプションを優先してください。変換が必要な場合は、ツールの提供元、設定項目が保持されるか、認証情報がどう扱われるかを確認し、変換結果も一つずつ点検します。詳しくはヘルプセンターをご覧ください。
まず使用中の設定とコアの対応状況を比較し、次に端末の時刻、ネットワーク環境、アプリのプロキシ接続を確認します。正常な端末の設定フォルダー全体を別のOSの端末に上書きしないでください。共有リンクで接続情報を移行できても、ローカル権限、DNS、ルーティングは個別に確認する必要があります。OS別の手順はインストールガイド一覧をご覧ください。