オープンソースクライアント一覧

V2Ray中文站v2rayN のダウンロードと設定

プラットフォームに合ったオープンソースクライアントを選び、サブスクリプションの取り込みから始めましょう。ルーティングとカーネル設定も確認できます。

01 設定例

クライアント設定とJSONの項目

クライアントではサブスクリプションを管理してカーネルを起動し、設定ファイルではカーネルが通信を受信・解析・転送する方法を定義します。以下の例は項目を確認するためのもので、単独では完全な設定として実行できません。

サブスクリプションとローカル受信設定

サブスクリプションを使うと、ノードをまとめて更新できます。v2rayNの場合、まずサブスクリプションURLを追加して該当グループを更新し、更新後の一覧からノードを選びます。一覧に項目が表示されても、クライアントが設定を読み込んだことを示すだけで、サーバーへの接続成功を意味しません。サブスクリプションURLはクライアントの管理情報であり、カーネルのJSON項目ではありません。以下のSOCKS受信設定は、カーネル起動後にローカルアプリで使うプロキシの入口で、リモートのサブスクリプションURLとは別のものです。アプリにプロキシを手動設定する場合は、現在の設定で使われているポートを確認してください。

{
  "inbounds": [
    {
      "listen": "127.0.0.1",
      "port": 10808,
      "protocol": "socks"
    }
  ]
}

JSONマニュアルを見る

02 ダウンロード

OSに合わせてクライアントを選ぶ

まず使用するデバイスのOSを確認し、次にプロセッサーアーキテクチャを確認します。デスクトップではv2rayN、モバイルでは設定要件に応じてv2rayNGまたはv2flyNGを選びます。

v2rayNのダウンロードには、x64デスクトップ版と従来のWPF版があります。デスクトップ版はクロスプラットフォームのUIを採用し、WPF版は従来のUIを維持しています。どちらも異なるグラフィカルアプリであり、ノードのプロトコルが異なるわけではありません。まずシステムの「バージョン情報」を開き、システムの種類を確認して、対応するアーキテクチャのアプリを実行できるか確かめてください。

旧バージョンから移行する場合は、まず以前のアプリを終了してから新しいアプリを起動してください。同じマシンで2つのクライアントが同じローカル待ち受けポートを使うと、後から起動した方でポート使用中のエラーが発生することがあります。切り替え後は、システムプロキシが現在のアプリの実際の待ち受けアドレスとポートを参照しているかも確認してください。起動に失敗した場合は、UIアプリ自体が起動していないのか、UIは開いたもののカーネルの起動に失敗したのかを切り分け、それぞれのエラーメッセージを確認します。

システムの「このMacについて」でチップまたはプロセッサーの情報を確認します。Appleシリコン搭載デバイスにはApple Silicon用のarm64版、Intelプロセッサー搭載デバイスにはx64版を選んでください。選択の基準はプロセッサーアーキテクチャです。サブスクリプションのプロトコルで選ぶ必要はなく、デバイスの外観で判断するのも避けてください。

ディスクイメージを開いたら、アプリを「アプリケーション」に移動してから起動すると、以降は固定の場所から開けます。最初の動作確認では、システムプロキシを参照するブラウザーを一つ使い、複数のネットワーク設定を同時に切り替えないようにしましょう。Wi-Fiと有線LANでは、プロキシ設定が別々のネットワークサービスに属する場合があります。ネットワークを切り替えて動作が変わったら、サブスクリプションを再取り込みする前に、現在使っているネットワークサービスの設定を確認してください。

比較的新しいデバイスの多くではarm64版を選べますが、OSがそのアーキテクチャのアプリに対応していることが前提です。判断できない場合はユニバーサル版を確認してください。ユニバーサル版には複数のアーキテクチャ向けネイティブライブラリが含まれることが多いものの、クライアント自体のシステム要件は満たす必要があります。v2rayNGはXrayカーネルを採用しています。V2Flyの動作と比較する場合はv2flyNGを選んでください。

VPNモードを初めて使うとき、システムから接続権限の確認が求められます。別のアプリがすでにVPNを確立している場合は、競合していないか確認してください。接続後に一部のアプリだけ動作が異なる場合は、まずクライアントでアプリごとのフィルターが有効か、そのアプリが対象リストまたは除外リストに含まれているかを確認します。この段階では、通常インストール時やネイティブライブラリの読み込み時に問題となるアーキテクチャは、優先して調べる項目ではありません。

まずディストリビューションに合うパッケージ形式を選び、次にデバイスに合うアーキテクチャを選択します。Debian系のディストリビューションでは通常deb、RPM系では通常rpmを選びます。どちらの形式にもx64版とarm64版があります。パッケージ形式が合っていても、アーキテクチャまで合っているとは限らないため、それぞれ確認してください。

パッケージマネージャーで依存関係の不足や互換性の問題が報告された場合は、まず表示内容を記録し、インストール段階で解決してからv2rayNを起動します。起動後、デスクトップアプリがシステムプロキシを参照するかどうかは、デスクトップ環境とアプリ自体によって異なります。ブラウザーでは接続できてもターミナルではできない場合は、ターミナルツールのプロキシ引数や環境変数を個別に確認してください。ターミナルがプロキシを経由しないことを、インストール失敗と誤認しないようにしましょう。

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

03 初期設定

取り込み・ルーティング・接続確認

最初はノード1つ、ルーティング1つ、アプリ1つだけで動作を確認します。基本の接続経路を確認してから、ほかの接続方式を有効にしたりDNSを調整したりしましょう。

  1. 01 接続情報

    サブスクリプションを取り込む

    サブスクリプションURLを入手したら、サブスクリプショングループに登録して保存し、そのグループを更新します。URLを保存する操作とノード一覧を取得する操作は別です。一覧が空のままなら、追加したグループが選択されていることを確認してから、更新結果を確認してください。ノードの共有リンクが1つだけの場合は、単一ノード用の取り込み機能を使います。

    取り込み後は、プロトコルとトランスポートの設定が明確なノードを1つ選びます。更新エラーが出た場合は、URLが途中で切れていないか、余分な空白が付いていないか確認してください。更新に成功して一部のノードだけ表示されない場合は、そのノードの形式がクライアントでサポートされているか確認します。トラブル対処の画面を共有するときは、サブスクリプションURL、アカウント情報、ノードの認証情報を隠してください。

  2. 02 出力ルール

    ルーティングモードを選ぶ

    どの通信を直接接続し、どの通信をプロキシノードに送るかを整理します。クライアントのプリセットルールを使う場合は、どのルールセットが選択されているかを確認し、直接接続とプロキシの振り分け条件もチェックしてください。社内ネットワークやLAN内のサービスを直接接続のテスト対象に、プロキシ側には安定していて接続実績のある宛先を選びます。

    システムプロキシのオン・オフは、一部のアプリが通信をローカルの入口へ渡すかどうかを決めます。ルーティングモードは、カーネルに届いた接続をどこへ送るかを決めます。両者は別の設定で、互いに代用できません。ルール変更後にLANへのアクセスが変わった場合は、ノードをそのままにして以前のルールに戻し、条件の一致先が変わったのか、アプリの接続入口自体が変わったのかを確認してください。

  3. 03 実際の通信

    接続して動作を確認する

    デスクトップではノードを選び、カーネルの待ち受け準備ができたことを確認してから、必要に応じてシステムプロキシを有効にします。モバイルではノードを選んだ後にVPN接続を確立し、システムの許可を確認してください。実際にアプリを使って直接接続用とプロキシ用の宛先にそれぞれアクセスし、クライアントログに該当する通信が記録されるか確認します。ノード一覧の遅延表示や接続状態だけでは、動作確認になりません。

    両方の宛先に接続できない場合は、まずローカルの入口またはVPNの状態を調べます。プロキシ用の宛先だけ失敗する場合は、ノード、ルーティングの一致状況、リモートとのハンドシェイクを確認してください。ブラウザーで接続できた後、コマンドラインも使う場合は、対象ツールで個別にテストします。クライアントを終了する前にシステムプロキシを無効にするか解除しておくと、ほかのプログラムが停止済みのローカルポートへ接続し続けるのを防げます。

詳しい使い方を見る

04 オープンソースの仕組み

Project V、V2Fly、Xray

まずUI、カーネル、プロトコルを区別しましょう。クライアント名はソフトの選択に使い、プロトコルとトランスポートの設定は接続の互換性を判断するために確認します。

クライアント
サブスクリプションとノードを管理し、設定を生成または読み込む
カーネル
設定を読み込み、名前解決・ルーティング・転送を処理する
プロトコル
接続する両端がデータをやり取りする方法を定める

プロジェクトの概要を見る

  1. Project Vとクライアントの役割

    Project Vは、初期のV2Rayプロジェクトを理解するための出発点です。V2Rayでは、通信の入口、転送先、振り分けルールを分けて定義します。同じ入口で受け取った通信でも、リクエストごとに異なる出力先へルーティングできます。この構成により、通信の受信と転送先の決定を分けて確認でき、異なるGUIクライアントでも共通の設定概念を利用できます。

    v2rayN、v2rayNG、v2flyNGはオープンソースのGUIクライアントで、ノード管理、設定、起動の機能をそれぞれ提供します。デスクトップ版のUI設定はカーネルの設定ファイルと同じものではありません。モバイル版のVPN許可もOS側の動作です。情報を調べるときは、問題がUI、OS、カーネルのどこで発生しているかを見極めましょう。たとえば、アプリの画面が正常に開いてもカーネルが待ち受け状態とは限りません。また、OSからVPNの許可を得ても、リモートとのハンドシェイクが成功するとは限りません。

  2. V2FlyとXrayに共通する書式と違い

    V2FlyコミュニティはV2Rayカーネルの保守を引き継ぎ、XrayはV2Rayのコードから分岐して開発されました。両者は受信、出力、多くのルーティング項目で似た概念を引き継いでいますが、実装はそれぞれ独立しています。同じ名前の項目でも、使用中のカーネルが対応しているか確認が必要です。特に新しいトランスポートやセキュリティの設定は、一方の設定値をそのまま他方に流用できるとは限りません。

    選定時はまずノードの設定要件を確認し、次にクライアントから利用できるカーネルを確認します。ある環境では動作する設定が新しい環境で未知の項目や未対応オプションとしてエラーになる場合は、まずログから項目名を確認し、クライアントが正しい値を生成できていないのか、移行先のカーネルが認識しないのかを切り分けます。機密情報を除いた最小限の設定で確認すると、何度も再インストールするより原因を特定しやすくなります。名称はカーネル用語集で確認できます。

  3. プロトコル・トランスポート・セキュリティ層を個別に確認

    VMess、VLESS、Trojanはいずれもこのエコシステムで使われますが、認証方式、接続パラメーター、セキュリティ層の要件は異なります。プロトコルとトランスポートは別の設定項目です。クライアントが特定のプロトコルを認識できても、ノードで使われているあらゆるトランスポートとの組み合わせに対応しているとは限りません。接続先のアドレスとポートが正しくても、トランスポート設定やサーバー名の不一致で接続に失敗することがあります。

    たとえばVLESS自体には通信内容の暗号化機能がないため、関連する設定を読むときは、実際に使われるセキュリティ層も確認してください。プロトコル名だけから通信経路の特性を判断することはできません。クライアントやカーネルのソースコードが公開されていても、ソフトに取り込んだ第三者のノードを各プロジェクトが運営しているわけではありません。ソフトの配布元、接続設定、ノードの運営者は、それぞれ分けて確認してください。用語の意味はプロトコル早見表をご覧ください。

  4. クライアント・カーネル・サブスクリプションの更新範囲

    クライアントを更新するとUIや設定の生成方法が変わることがあり、カーネルの更新では利用できる項目が変わる場合があります。サブスクリプションの更新はグループ内のノード一覧を更新します。3つを同時に更新する必要はありません。最近の変更について調べるときは、どの操作から症状が始まったかを記録してください。ソフトの更新後に起動できなくなった場合はカーネルログを確認し、サブスクリプション更新後に特定のノードだけ使えなくなった場合は、そのノードの新しい設定を確認します。

    ルールを手動管理する場合は、使用中のルーティング設定、主要なタグ、ローカルポートを記録しておくと、変更前後を比較しやすくなります。まず動作確認済みのノードでプロキシの入口とリモート接続をテストし、その後、独自のルーティングや名前解決の設定を一つずつ戻します。サブスクリプションや独自設定を移行する場合、認証情報を含むデータはアクセスを制限した場所に保管してください。トラブルの記録を提出する際は、多くの場合、エラーの種類と関連項目名だけで十分です。

  5. エラーが発生した場所から情報を探す

    サブスクリプション一覧が空の場合は、取り込み画面、グループ、更新時のエラーから確認します。一覧は正常なのにすべてのアプリが接続できない場合は、カーネルが起動しているか、ポートが待ち受け中か、アプリがローカルの入口へ通信を送っているかを確認してください。一部の宛先だけ失敗する場合は、ルールの一致状況、名前解決、リモート接続を調べます。この順序で確認すれば、ローカル接続の問題をノードの変更で解決しようとしたり、ノードが無効なのにシステムプロキシを何度も変更したりするのを避けられます。

    画面操作は入門ガイドで、項目の値や構造はJSONマニュアルで確認できます。マニュアルの受信・出力設定例は、説明している部分だけを扱っています。既存の設定に組み合わせる場合は、同じ名前のタグ参照とデフォルト出力先の順序を確認してから、実際の通信で動作をテストしてください。

05 使い方のヒント

インストール・プロキシモード・ノード選び

現在の問題に合わせて項目を確認しましょう。まずクライアントが起動するか、次に通信がカーネルに届くか、最後にノードごとの動作を比べます。

すべての記事を見る