v2rayN Linux版のデスクトップへのインストール｜deb/rpmパッケージと自動起動設定

1. ディストリビューション、アーキテクチャ、インストール方法を確認

v2rayNはデスクトップ向けクライアントです。インストールできても、接続に使えるわけではありません。有効なサーバー設定またはサブスクリプションと、プロトコルに対応したコアが必要です。この記事ではデスクトップ環境でのクライアント導入を扱います。ユーザーがログインしていない状態で動作するシステムプロキシサービスとは別のものです。ターミナルだけのサーバーには、このデスクトップ自動起動手順をそのまま適用できません。

ターミナルを開き、次の2つのコマンドを実行します。1つ目でディストリビューション名とバージョン、2つ目でマシンのアーキテクチャを確認します。通常、x86_64はx64パッケージ、aarch64はarm64パッケージに対応します。アーキテクチャが合わない場合、依存関係を追加しても実行ファイルは動きません。

cat /etc/os-release
uname -m

2. Ubuntu・Debianにdebパッケージをインストール

ローカルのdebファイルは、dpkg -iだけで済ませず、apt installでインストールするのがおすすめです。aptは設定済みのリポジトリから、パッケージが宣言する依存関係を補おうとします。以下のコマンドはBashターミナルで実行します。プロンプトが表示されたら、ダウンロードしたファイルの実際のパスを入力してください。パスに空白が含まれていても、引用符で囲む必要はありません。

read -r -p "debファイルの実際のパスを入力してください：" pkg
pkg="$(realpath -- "$pkg")"
dpkg-deb -f "$pkg" Package Version Architecture
sudo apt update
sudo apt install "$pkg"

1. パッケージ情報を確認

   上記の出力にあるPackage、Version、Architectureを確認します。読み込みに失敗した場合は、入力したファイルがダウンロード済みのdebファイルであり、Webページや圧縮アーカイブではないことを確認してください。

2. インストール内容を確認

   aptが表示する追加、アップグレード、削除の対象を確認します。デスクトップ関連のパッケージが大量に削除される場合は、いったん操作を中止し、別のディストリビューションやバージョンのリポジトリが混在していないか確認してください。

3. アプリメニューから起動

   インストール後、デスクトップのアプリメニューでv2rayNを検索し、一般ユーザーとして起動します。ソフトウェアのインストールに管理者権限が必要でも、GUIクライアントの起動に管理者権限が必要とは限りません。

4. エラー出力を確認

   ウィンドウが表示されない場合は、まずインストールパッケージに含まれるデスクトップランチャーを探し、Execフィールドを確認します。対応するコマンドをターミナルから実行し、不足しているライブラリや権限エラーを記録してください。

以前にdpkg -iを実行してインストールが未設定の状態になった場合は、sudo apt --fix-broken installを実行し、修復内容を確認してから確定します。依存関係が補われる場合もあれば、依存関係を満たせないパッケージが削除される場合もあります。このコマンドを実行すればクライアントが必ず残るとは限りません。リポジトリに接続できない場合は、インストールを繰り返すのではなく、まずリポジトリへの接続を復旧してください。

3. Fedoraにrpmをインストールし、起動方法を確認

Fedoraではdnfを使ってローカルのrpmをインストールします。dnfはシステムのリポジトリも参照して依存関係を解決しますが、rpm -i単体では依存関係をネットワークから補いません。以下では実際のファイルパスを読み込み、パッケージ情報を確認してからインストールします。

read -r -p "rpmファイルの実際のパスを入力してください：" pkg
pkg="$(realpath -- "$pkg")"
rpm -qp --queryformat '%{NAME}\n%{VERSION}-%{RELEASE}\n%{ARCH}\n' "$pkg"
sudo dnf install "$pkg"

依存関係の競合が表示されても、依存関係を無視したり強制的に上書きしたりするオプションを追加しないでください。共有ライブラリの不足、パッケージのアーキテクチャ不一致、異なるリポジトリのバージョン混在は、それぞれ別の問題です。ターミナルに表示されたパッケージ名をもとに原因を特定してください。Fedora以外のrpm系ディストリビューションでは、同じパッケージが必ず互換性を持つとは限りません。

デスクトップランチャーは、以降のトラブル対処や自動起動設定の手がかりになります。Exec行に%Uや%Fなどのデスクトップフィールドコードが含まれている場合、ターミナルで手動テストするときに通常の引数としてそのまま入力しないでください。パッケージ内の実際のパスを確認し、インストールディレクトリ全体をすべてのユーザーが書き込めるように変更することも避けてください。

4. 初回接続：サブスクリプション、ポート、システムプロキシ

初回起動時は通常のプロキシ方式を使い、TUNはまだ有効にしないでください。メイン画面の「サブスクリプショングループ」→「サブスクリプショングループの設定」を開き、グループを追加してサブスクリプションURLを入力します。保存後、「サブスクリプショングループ」から更新を実行します。ボタン名はバージョンによって多少異なる場合があるため、グループ設定画面と更新メニューを確認してください。サブスクリプションURLにアクセス情報が含まれる場合があります。ターミナルのスクリーンショットや問い合わせ記録では必ず隠してください。

設定を1つ選んで使用中のサーバーにしたら、「設定」→「パラメーター設定」でローカルの待ち受け情報を確認し、クライアントのログで実際の待ち受けアドレスを確認します。以下では例として10808を使いますが、すべてのバージョンや既存の設定でこのポートが使われるわけではありません。HTTPまたは混合プロキシに対応していることを確認してから、該当するcurlコマンドを使ってください。

ss -ltnp 'sport = :10808'
curl --proxy http://127.0.0.1:10808 --max-time 15 -I https://example.com

SOCKS専用ポートを設定している場合は、curlのプロキシ引数を--proxy socks5h://127.0.0.1:10808に変更し、ポート番号も実際の設定に合わせてください。socks5hでは、接続先のドメイン名をプロキシ側で解決します。HTTPレスポンスが返れば、その明示的なプロキシリクエストに応答があったことを示します。システム上のすべてのアプリがプロキシを経由しているとは限りません。

• ローカルで待ち受けていない：コアの起動ログ、設定の解析エラー、ポートの競合を確認してください。まずブラウザーの設定を変更する必要はありません。
• 明示的なプロキシ接続はできるが、ブラウザーは使えない：クライアントの「システムプロキシ」メニューの状態と、デスクトップのネットワークプロキシ設定を確認してください。デスクトップのプロキシ設定を参照しないアプリもあります。
• ターミナルの通信が直接接続のまま：ターミナルアプリは通常、デスクトップのプロキシ設定を自動では引き継ぎません。アプリ固有のプロキシ引数で確認するほうが確実です。
• TUNを有効にする場合：先にルーティングとDNSの設定をバックアップし、使用中のバージョンが求める権限に従って設定してください。通常のプロキシを試すために、デスクトップアプリ全体をrootで起動しないでください。

5. トレイアイコンが表示されない・ウィンドウが開かない

GNOMEやKDE Plasmaなどのデスクトップ環境では、トレイプロトコルの対応方法が異なります。GNOMEでトレイアイコンが見えなくても、v2rayNが起動していないとは限りません。ステータスインジケーターに対応していない、または関連する拡張機能がインストール済みでも有効になっていない可能性があります。まずアプリメニューからウィンドウを開き直し、次にプロセスとローカルの待ち受け状態を確認してください。

アプリが正常に起動し、接続もできていて、トレイアイコンだけが表示されない場合は、カーネルを再インストールせず、デスクトップとの連携を修復してください。ログにコアプロセスの終了が記録されている場合は、設定とコアの権限を再確認します。トレイ拡張機能では、プロトコルの設定ミスやポートの競合は解決できません。

6. ログイン時の自動起動：デスクトップランチャーを再利用

一般に「起動時の自動実行」と呼ばれる設定は、v2rayNのGUIクライアントでは「ユーザーがデスクトップにログインした後の起動」と表現するのが正確です。電源を入れても未ログインの状態や、テキスト端末のみの状態、リモートコマンドでのログインは、GUIセッションが準備できている状態とは異なります。一般的なデスクトップ環境では、XDG自動起動ディレクトリ~/.config/autostart/が使えます。Execのパスを推測するより、ソフトウェアパッケージに含まれるdesktopファイルを再利用するほうが確実です。

1. 手動で起動できることを確認

   まずアプリメニューから起動し、接続テストを一度行います。クライアントに自動起動の設定がある場合は、すでに自動起動項目が作成されていないか確認し、設定が重複しないようにしてください。

2. ランチャーを探す

   前述のパッケージファイル一覧から、アプリに対応するdesktopファイルを探します。内容を開いてExecのパスを確認し、アンインストール用の項目ではないこと、また一時ダウンロードディレクトリを参照していないことを確かめてください。

3. ユーザーディレクトリにコピー

   以下のコマンドを実行し、desktopファイルの完全なパスを入力します。保存先のファイル名は確認や取り消しがしやすいようにv2rayN.desktopに固定しています。この操作は現在のユーザーにのみ適用されます。

4. ログアウト後に動作を確認

   作業内容を保存し、デスクトップからログアウトして再度ログインします。クライアントのプロセス、ウィンドウまたはトレイを確認したうえで、ローカルポートと実際の接続も確認してください。アイコンが表示されるかどうかだけで自動起動の成否を判断しないでください。

read -r -p "アプリのdesktopファイルの完全なパスを入力してください：" entry
grep -E '^(Type|Exec|TryExec|Hidden|OnlyShowIn|NotShowIn)=' "$entry"
install -Dm644 "$entry" "$HOME/.config/autostart/v2rayN.desktop"

grepの出力を読んでからコピーしてください。Hidden=trueは自動起動項目を無効にし、OnlyShowInとNotShowInは対象となるデスクトップ環境を制限します。コピー後に起動しない場合は、テキストエディターでこれらのフィールドを確認し、X-GNOME-Autostart-enabled=falseがないかも確認してください。Nameフィールドは表示名にすぎず、プログラムの実行には関係しません。

この節で設定した自動起動を取り消すには、今回作成したファイルだけを削除します。システム設定に別のv2rayN自動起動項目がある場合は、それも確認して無効にしてください。取り消しが反映されていないと誤解するのを防げます。

rm -- "$HOME/.config/autostart/v2rayN.desktop"

7. アップデート後・再起動後の確認リスト

同じパッケージ名のソフトウェアをアップデートすると、通常aptやdnfがプログラムファイルを置き換えます。一方、ユーザー設定、自動起動用のコピー、デスクトップのプロキシ状態はそれぞれ別に管理されます。アップデート前にクライアントを終了し、実際に使用している設定ディレクトリをバックアップしてください。ディレクトリの場所は、使用中のバージョンの設定やログで確認し、ユーザー設定のディレクトリ全体を安易に削除しないでください。

• アプリの起動：アプリメニューから新しいバージョンが開くことを確認します。ランチャーが動作しない場合は、新しいパッケージのファイル一覧とExecのパスを照合してください。
• 自動起動用ファイル：インストール後の元のdesktopファイルと~/.config/autostart/v2rayN.desktopを比較します。プログラムのパスが変わっている場合は、必要なユーザー設定を保ったままコピーし直してください。
• 接続設定：使用中のサーバー、サブスクリプショングループ、ルーティング設定を確認し、アップデート後に別の設定を誤って選んでいないか確認します。
• ローカルの待ち受け：実際のポートを指定してssを実行し、明示的なプロキシリクエストも試します。待ち受けに問題がなくリモート接続に失敗する場合は、パッケージを再インストールせず、接続ログを確認してください。
• 終了時の動作：クライアントを終了した後、デスクトップのネットワークプロキシ状態を確認します。停止済みのローカルポートが設定されたままの場合は、システムプロキシを解除するか、元のネットワーク設定に戻してください。

確認は、手動起動、明示的なプロキシ接続、必要なアプリの動作、ログアウト後の再ログインによる復帰の順に行います。この4項目を個別に確かめるほうが、「起動後にアイコンが表示されたか」だけを見るより問題を特定しやすくなります。サブスクリプションの追加や設定方法は入門ガイド、ルーティングとDNSの詳しい調整は設定ガイドをご覧ください。