v2rayN Linuxデスクトップ版のインストール手順：deb/rpmパッケージとsystemdログイン時自動起動

Linuxのグラフィカルデスクトップ環境に入り、v2rayNをインストールするユーザー向けの記事です。ディストリビューションに応じてdebまたはrpmパッケージを選び、実行ファイルのパスとXray Coreを確認します。その後、トレイコンポーネント、10808のローカルプロキシポート、systemdによるログイン時自動起動を設定します。完了後はログとポートの待受状態から正常に起動したか確認できます。

v2rayN Linuxデスクトップ版はグラフィカルセッションで動作します。Debian、Ubuntu、Linux Mintなどではdebパッケージ、Fedora、Rocky Linux、AlmaLinuxなどではrpmパッケージを使用します。パッケージ形式はディストリビューションに合わせ、プロセッサのアーキテクチャも一致させてください。一般的なPCはx64、ARMプロセッサ搭載デバイスはarm64を選びます。OSが64ビットだからといって、必ずしもx64とは限りません。

まずターミナルで次のコマンドを実行します。1行目はプロセッサのアーキテクチャ、2行目はディストリビューションの識別情報、3行目は現在のデスクトップセッションの種類を表示します。x86_64と表示された場合はx64パッケージ、aarch64と表示された場合はarm64パッケージを選択します。XDG_SESSION_TYPEには通常、waylandまたはx11と表示されます。

この記事では、v2rayN 7.15.2の画面とパッケージ管理手順を基準にしています。以降のバージョンではボタンの位置が多少変わる可能性がありますが、インストールコマンド、ユーザーサービスのディレクトリ、ポートの調査方法は変わりません。旧バージョンを更新する前に、実行中のv2rayNを終了し、古いプロセスが設定ファイルやローカルの待受ポートを使い続けないようにしてください。

debとrpmはいずれもシステム用パッケージです。プログラム、デスクトップエントリ、アイコンをディストリビューションで定められた場所に配置し、パッケージマネージャーに登録します。手動解凍と比べて、システムパッケージはファイルの場所を確認しやすく、アンインストールも簡単です。また、インストール時に不足している依存関係を明確に確認できます。

ダウンロードしたdebファイルを「ダウンロード」ディレクトリに入れ、そのディレクトリへ移動してapt installでローカルパッケージをインストールします。コマンド内のファイル名は実際の名前に置き換えてください。入力前にls *.debで確認できます。dpkgを直接使う場合と異なり、aptはリポジトリから取得できる依存関係も同時に処理します。

システムのディレクトリ名が英語の場合、パスは通常~/Downloadsです。すでにdpkg -iでインストールし、依存関係が満たされていないという表示が出た場合は、sudo apt -f installを実行して修復してから、インストールコマンドを再実行します。同じパッケージ名を更新する場合、aptはユーザーディレクトリ内の設定データを保持します。

Fedoraでは、ローカルrpmの処理にdnf installを使うことをおすすめします。コマンド先頭の./は現在のディレクトリにあるファイルを示すため、リポジトリのソフトウェア名として扱われないよう省略しないでください。インストール後は、大文字と小文字を区別しない検索コマンドでパッケージの登録を確認できます。

インストール後は、まずアプリケーションメニューからv2rayNを起動し、すぐにバックグラウンド自動起動を設定しないでください。初回起動では、メインウィンドウが開くこと、Coreが起動できること、設定ディレクトリに書き込めることを確認します。アプリケーションメニューがまだ更新されていない場合は、ログアウトしてデスクトップに入り直すか、ターミナルでcommand -v v2rayNを実行して起動コマンドを探します。

メイン画面を開いたら、「設定」→「パラメータ設定」→「Core タイプ」に進みます。VLESS、Reality、または新しいXrayの機能が必要なノードではXrayを選択します。既存のVMessノードもXrayで処理できます。ノードのプロトコル、アドレス、ポート、ユーザー識別子、通信方式、TLS、Realityの各パラメータは、サーバー側と一つずつ一致させてください。クライアントのインストールが成功しても、ノード設定が正しいとは限りません。

起動後、ssで待受状態を確認します。127.0.0.1:10808または設定画面で指定したローカルアドレスが表示されれば、Coreがローカルの入口を確立しています。メイン画面では起動済みと表示されるのに待受記録がない場合は、v2rayNのログでCoreが終了した原因を確認してください。

v2rayNはメインウィンドウを閉じた後も通常はトレイに常駐するため、トレイアイコンの表示は終了、ノード切り替え、ウィンドウの復元に直接影響します。アイコンが消えてもCoreが停止したとは限りません。まずpsとssでプロセスとポートを確認し、デスクトップ環境がステータスアイコンをサポートしているか調べてください。

Ubuntuおよび一部のGNOMEデスクトップでは、通常Ayatana AppIndicatorコンポーネントが必要です。まずランタイムをインストールし、ログアウトしてからデスクトップに再ログインします。Fedoraのパッケージ名はバージョンや有効なリポジトリによって異なるため、先にdnf search appindicatorで検索してください。他のディストリビューションのdebパッケージを混在させないでください。

Waylandセッションでメインウィンドウは正常に表示されるのにトレイメニューが現れない場合は、まずデスクトップパネルでアプリケーションのステータスアイコンが表示可能になっているか確認します。その後、v2rayNを完全に終了して再起動してください。アプリケーションメニューを何度もクリックするだけでは、シングルインスタンス制限により新しいウィンドウが開かず、バックグラウンドの古いプロセスだけが残ることがあります。

デスクトッププログラムには、システム全体のrootサービスではなくsystemdユーザーサービスが適しています。ユーザーサービスは現在のアカウントのユーザーマネージャーで実行され、そのアカウントの設定ディレクトリを読み込めます。また、journalctl --userでログを確認しやすくなります。ここでいう自動起動とは、そのユーザーがグラフィカルデスクトップにログインした後に自動起動することです。v2rayNにはトレイと表示セッションが必要なため、誰もログインしていない状態で強制的に起動する用途には向きません。

まずcommand -v v2rayNを実行して実際のパスを取得します。システムパッケージでは/usr/bin/v2rayNと表示されることが多いですが、必ず実機の結果を使用してください。その後、ユーザーサービスのディレクトリとサービスファイルを作成します。

以下の内容をファイルに書き込みます。1行目のコマンドが/usr/bin/v2rayN以外のパスを返した場合は、ExecStartも必ず同じパスに変更してください。サービスは異常終了後5秒待って再起動し、グラフィカルセッションとネットワークのターゲットが利用可能になってから起動する設定です。

保存後、ユーザーサービスを再読み込みし、有効化してすぐに起動します。約15秒待ってからサービスの状態を確認してください。状態がactive (running)で、ローカルポートも存在すれば、自動起動の設定は完了しています。

サービスを起動できない場合は、まずユーザーログの最新50行を確認します。よくある原因は、ExecStartのパス間違い、別のv2rayNインスタンスの起動、10808ポートの使用中、デスクトップセッションの準備未完了です。ログを確認せずにパッケージを何度も再インストールしないでください。設定ミスやポート競合は、再インストールだけでは解消しません。

ログにAddress already in useと表示された場合は、次のコマンドでポートを使用しているプロセスを特定します。プロセスの用途を確認したら、競合するプログラムを終了するか、v2rayNの「設定」→「パラメータ設定」でローカルの待受ポートを変更します。変更後は、ブラウザー、ターミナルの環境変数、システムプロキシに設定したポートも更新してください。

ログイン時の自動起動が一時的に不要な場合は、無効化と停止を同時に実行します。サービスファイルを変更した場合は、再読み込みして再起動してください。debまたはrpmでアップグレードした後も、command -v v2rayNを再実行し、プログラムのパスが変わっていないことを確認します。