Linux デスクトップで v2rayN を使いたい方向けに、CPU アーキテクチャの確認、deb・rpm のインストール、初回起動、サブスクリプションの追加、システムプロキシ、デスクトップアイコンの修復、systemd ユーザーサービスの設定を解説します。設定後は、現在のユーザーのログイン時にクライアントを起動し、ポート競合や権限エラーを切り分けられるようになります。
インストール前にディストリビューション、アーキテクチャ、デスクトップセッションを確認
Linux のインストールパッケージは、ディストリビューション名だけでなく、パッケージ形式と CPU アーキテクチャも確認する必要があります。Debian、Ubuntu および派生ディストリビューションでは通常 deb、Fedora、Rocky Linux など RPM パッケージ管理を採用する環境では通常 rpm を選びます。x86_64 端末はパッケージ名の x64 または 64 ビット表記、ARM64 端末は arm64 を選択します。両者は互換性がないため、混在させないでください。
v2rayN はデスクトップクライアントであり、正常に動作させるにはグラフィカルセッション、トレイ領域、現在のユーザーの設定ディレクトリが必要です。コマンドラインだけのリモートサーバーに、この記事の手順をそのまま適用することはおすすめしません。GNOME や KDE Plasma など一般的なデスクトップで動作しますが、トレイアイコンが表示されるかどうかは、デスクトップ環境でステータスアイコンが有効かどうかに左右されます。トレイに表示されないからといって、コアが起動していないとは限りません。
ディストリビューション標準パッケージ
おすすめdeb または rpm をシステムのパッケージマネージャーに任せてインストールします。デスクトップエントリ、プログラムファイル、アンインストール情報をパッケージマネージャーで一元管理できます。
おすすめ: 長期利用、デスクトップアイコンと標準的なアップデートが必要な場合
解凍したディレクトリから実行
プログラムをユーザーディレクトリに保存するため移行しやすい一方、デスクトップエントリ、権限、アップデートは自分で管理する必要があります。
おすすめ: 一時的なテスト、システムへのインストール権限がない場合
systemd ユーザーサービス
ユーザーのログイン後にデスクトッププロセスを起動します。システムサービスを作成する必要がなく、root 権限でユーザー設定を書き込むこともありません。
おすすめ: 固定のデスクトップアカウント、自動起動が必要な場合
まず、ターミナルで次のコマンドを実行してアーキテクチャを確認します。Debian 系では amd64 が通常 x64 パッケージ、arm64 が ARM64 パッケージに対応します。RPM 系では x86_64 または aarch64 と表示されることが一般的です。異なるアーキテクチャのパッケージをダウンロードすると、インストーラーはパッケージの不一致を報告します。依存関係を追加しても解決できません。
dpkg --print-architecture
uname -m
rpm --eval '%{_arch}'- amd64 または x86_64：Linux x64 インストールパッケージを選択します。
- arm64 または aarch64：Linux ARM64 インストールパッケージを選択します。
- グラフィカルセッションの確認：
echo "$XDG_CURRENT_DESKTOP"を実行します。通常のデスクトップログインでは、GNOME や KDE などの名称が返ります。 - systemd バージョンの確認：
systemctl --versionを実行します。Ubuntu 24.04 LTS など現行のデスクトップディストリビューションは、すでにユーザーサービスに対応しています。
Debian と Ubuntu に deb パッケージをインストール
deb パッケージは、低レベルの dpkg だけでなく APT を使ってインストールします。APT はローカルパッケージを読み込みながら、ソフトウェアソースで解決できる依存関係も処理するため、実行ライブラリが不足している場合でも原因を確認しやすくなります。インストールコマンドの前にある ./ は省略できません。これにより、対象がソフトウェアソース上の同名パッケージではなく、現在のディレクトリにあるローカルファイルだと APT に明示できます。
パッケージをダウンロード
当サイトのクライアントページで Linux を選択し、CPU アーキテクチャに合った v2rayN deb パッケージをダウンロードします。ファイルは現在のユーザーの「ダウンロード」フォルダーに保存してください。
ディレクトリに移動
ターミナルを開いて
cd ~/ダウンロードを実行します。英語のディレクトリ環境では通常cd ~/Downloadsを使います。その後、lsで実際のファイル名を確認します。インストールを実行
sudo apt install ./v2rayN-linux-*.debを実行し、インストール対象のパッケージ名とアーキテクチャを確認してから、案内に従って続行します。初回起動
デスクトップのアプリ一覧で v2rayN を検索して起動します。初回起動は通常のデスクトップアカウントで行い、ターミナルの先頭に sudo を付けないでください。
コアを確認
「設定」→「パラメーター設定」→「Core タイプ」を開き、VLESS、VMess などのノードを日常的に使う場合は、Xray コアが選択されていることを優先的に確認します。
cd ~/ダウンロード
sudo apt install ./v2rayN-linux-*.deb
# 英語のユーザーディレクトリでは次のように変更
cd ~/Downloads
sudo apt install ./v2rayN-linux-*.debAPT がファイルを見つけられないと表示した場合は、まず pwd と ls -lh を実行し、ターミナルの現在地とダウンロード先が一致しているか確認します。ワイルドカードは、現在のディレクトリに一致するファイルが実際に存在する場合にだけ展開されます。同時に複数のバージョンを残していると、コマンドが複数のパッケージに一致することがあります。その場合は完全なファイル名を入力し、旧版と新版を同時にインストーラーへ渡さないようにしてください。
インストール完了後、command -v v2rayN で起動コマンドを確認し、dpkg -l | grep -i v2rayn でパッケージマネージャーの記録を確認できます。実行ファイルの具体的なパスは、インストールパッケージが提供するデスクトップエントリを基準にしてください。すべてのディストリビューションが同じディレクトリを使うと決めつけないようにしましょう。
Fedora 系ディストリビューションに rpm パッケージをインストール
Fedora のデスクトップ環境では、DNF を使ってローカル rpm パッケージを処理します。低レベルの rpm コマンドを直接実行する場合と違い、dnf install は依存関係を解決し、インストール内容を通常のパッケージデータベースに登録します。コマンド中のローカルパスでも ./ を残してください。省略すると、DNF がソフトウェアソース上のパッケージ名として検索する場合があります。
アーキテクチャを確認
uname -mを実行します。x86_64 なら x64 パッケージ、aarch64 なら ARM64 パッケージを選び、端末のブランドだけで判断しないでください。rpm をインストール
ダウンロードディレクトリに移動し、
sudo dnf install ./v2rayN-linux-*.rpmを実行します。依存関係の一覧を確認してからインストールを確定してください。エントリを更新
インストール完了後、アプリ一覧で v2rayN を検索します。デスクトップに古いメニューがキャッシュされている場合は、現在のセッションからログアウトして再ログインしてください。
コアを選択
起動後、「設定」→「パラメーター設定」→「Core タイプ」を開き、ノードのプロトコルに応じて Xray または v2ray コアを選択します。
接続をテスト
サブスクリプションを追加してノードを更新し、ノードを選択してからシステムプロキシを有効にします。その後、接続テストの結果とログの時刻を確認してください。
cd ~/ダウンロード
sudo dnf install ./v2rayN-linux-*.rpm
# 英語のユーザーディレクトリでは次のように変更
cd ~/Downloads
sudo dnf install ./v2rayN-linux-*.rpm「アーキテクチャに互換性がありません」と表示された場合は、追加のソフトウェアソースを登録するのではなく、適切なパッケージを選び直します。システムライブラリが不足している場合は、まず sudo dnf upgrade --refresh を実行してリポジトリのメタデータを更新し、ローカル rpm を再インストールします。ディストリビューションのバージョンがすでにサポート終了している場合、依存関係の不足はシステムのソフトウェアソースが無効になっていることが原因になりがちです。その場合は、先にディストリビューションをアップグレードするのが適切です。
初回起動、サブスクリプション追加、システムプロキシ
初回起動時、v2rayN は現在のユーザーディレクトリに設定とログのデータを作成します。この段階で最も重要なのは、常に同じ通常のデスクトップアカウントでクライアントを実行することです。最初に sudo で起動し、その後通常ユーザーに切り替えると、設定ディレクトリの所有者が一致しなくなり、設定を保存できない、サブスクリプションを更新できない、ログを書き込めないといった問題が起きやすくなります。
サブスクリプション URL と単一ノードの共有リンクは、同じ種類のデータではありません。サブスクリプション URL は更新可能なノード一覧を指し、長期的な管理に適しています。vmess:// または vless:// の共有リンクは、通常 1 つのノードだけを含みます。サブスクリプションを追加した後は更新操作も必要です。グループ名だけが表示され、サーバー一覧がない場合は、未更新、URL のコピー漏れ、またはシステム時刻のずれが考えられます。
推奨構成：デスクトップセッションとプロキシ設定を分けて管理
v2rayN クライアント
- 通常ユーザーで起動
- 「設定」→「パラメーター設定」→「Core タイプ」でコアを選択
- ローカル待受ポートはクライアントの現在の設定に従う
Linux デスクトップ環境
- ログイン後にユーザーサービスを起動
- デスクトップのプロキシ設定に従ってアプリの通信を転送
- クライアント終了前にシステムプロキシの状態を元に戻す
クライアントはノード、ルーティング、ローカルポートを担当し、デスクトップ環境はアプリの通信をそのポートへ送ります。両方の状態を確認する必要があります。
- サブスクリプション管理画面を開き、新しいサブスクリプショングループを追加して完全な URL を貼り付けます。
- 「すべてのサブスクリプションを更新」を実行し、ノード一覧が表示されてからサーバーを選択します。
- 「設定」→「パラメーター設定」を開き、ローカル待受ポートを確認します。一般的な初期値は 10808 ですが、画面に表示される値を優先してください。
- 「設定」→「パラメーター設定」→「Core タイプ」を開きます。VLESS ノードは通常 Xray コアを使用し、従来型の VMess ノードはサーバー側の設定に応じて互換性のあるコアを選択します。
- システムプロキシを有効にした後、ブラウザーの接続を再確立します。すでに開いている長時間接続は、切り替え前のネットワーク経路を使い続けることがあります。
接続できない場合は、まずログを確認し、すべての項目を無作為に切り替え続けないでください。ログにポート競合が表示されている場合は、ss -lntp で 10808 付近の待受プロセスを確認し、パラメーター設定で未使用のポートに変更します。ポートを変更した後は、デスクトップのシステムプロキシと、手動でプロキシを設定したアプリも同時に更新してください。
デスクトップアイコンがない、またはクリックしても反応しない
deb または rpm で正常にインストールした場合、デスクトップメニューのエントリは通常 /usr/share/applications にある desktop ファイルから提供されます。アプリ一覧にすぐ表示されない場合は、デスクトップメニューのキャッシュがまだ更新されていない可能性があります。アイコンをクリックしても画面が表示されない場合は、desktop ファイルの Exec パス、プログラムの実行権限、現在のユーザーのログを確認してください。
grep -R "^Exec=" /usr/share/applications 2>/dev/null | grep -i v2rayn
command -v v2rayN
ls -l "$(command -v v2rayN)"- desktop エントリを確認できる：Exec が指しているファイルの存在を確認し、通常ユーザーのターミナルで同じコマンドを実行してみます。
- ターミナルでは起動するが、メニューから起動しない：デスクトップセッションからログアウトして再ログインし、アプリメニューにエントリファイルを再読み込みさせます。
- プログラムがバックグラウンドで実行中：トレイ領域とプロセス一覧を確認します。もう一度クリックしても、既存のインスタンスがアクティブになるだけで、2 つ目のウィンドウは作成されない場合があります。
- 設定ディレクトリの権限エラー：
find ~/.local/share -maxdepth 2 -iname '*v2rayn*' -lsで所有者を確認し、使用中の設定を直接削除しないでください。 - Wayland でトレイが表示されない：まずウィンドウ一覧でメイン画面を確認し、次にデスクトップ環境のステータスアイコン対応を確認します。トレイの問題をコアが実行されていないと誤認しないでください。
以前 sudo でクライアントを実行したことがある場合は、まずプロセスを完全に終了し、関連するユーザー設定ディレクトリの所有者を確認します。ファイルが現在のユーザーの v2rayN 設定であることを確認してから、chown で修正してください。ホームディレクトリ全体に再帰的な権限変更を行うと、ブラウザー、鍵、その他のデスクトッププログラムに影響するため避けてください。
systemd ユーザーサービスでログイン後に自動起動
グラフィカルクライアントは、システムレベルの root サービスではなく systemd ユーザーサービスとして設定するのが適しています。ユーザーサービスは現在のアカウントのログイン後に動作し、設定、ログ、デスクトップセッションを同じユーザーで管理できます。サービスを作成する前に command -v v2rayN を実行して実際の起動パスを取得します。以下の例では一般的な /usr/bin/v2rayN を使用しています。検索結果が異なる場合は、ExecStart を実際の絶対パスに変更してください。
サービスファイルは ~/.config/systemd/user に保存します。ファイル名には v2rayn-desktop.service を使用し、システムサービスと区別しやすくします。Restart は on-failure に設定します。これにより、異常終了時だけ再起動され、ユーザーが正常に終了した場合は再起動ループになりません。
mkdir -p ~/.config/systemd/user
nano ~/.config/systemd/user/v2rayn-desktop.service[Unit]
Description=v2rayN desktop client
After=graphical-session.target network-online.target
Wants=network-online.target
[Service]
Type=simple
ExecStart=/usr/bin/v2rayN
Restart=on-failure
RestartSec=5
[Install]
WantedBy=default.targetファイルを保存したら、ユーザーサービスの設定を再読み込みし、続けて有効化と即時起動を行います。enable --now は、「次回以降のログイン時に起動」と「今回のセッションで直ちに起動」を同時に実行します。操作前に手動で起動した v2rayN を終了し、2 つの起動経路が同じ設定ディレクトリを競合したり、単一インスタンス制限にかかったりしないようにしてください。
systemctl --user daemon-reload
systemctl --user enable --now v2rayn-desktop.service
systemctl --user status v2rayn-desktop.service- 今回の起動ログを確認：
journalctl --user -u v2rayn-desktop.service -b - 直近 80 行を確認：
journalctl --user -u v2rayn-desktop.service -n 80 - ファイル変更後に再読み込み：
systemctl --user daemon-reloadを実行し、その後 restart を実行します。 - 自動起動を一時停止：
systemctl --user disable --now v2rayn-desktop.service
サービスの状態が起動成功になっているのにウィンドウが表示されない場合は、まず現在のグラフィカルログインユーザーで実行されているか確認し、ログに DISPLAY、WAYLAND_DISPLAY、またはデスクトップバス環境の不足がないか調べます。デスクトップ環境によって、セッション変数が systemd ユーザーマネージャーへ取り込まれるタイミングは異なります。この場合も root サービスに変更せず、デスクトップへのログインが完全に完了してからユーザーサービスを手動で再起動し、セッション環境の準備不足が原因か確認してください。
ユーザーサービス
おすすめ設定とログを現在のアカウントで管理でき、systemctl --user で状態を確認できます。ユーザーのログイン後に起動します。
おすすめ: 固定アカウントの Linux デスクトップ
デスクトップ自動起動項目
GNOME や KDE のセッションから直接起動するため、グラフィカル環境変数を引き継ぎやすい方法です。
おすすめ: ユーザーサービスがグラフィカルセッション変数を取得できない場合
手動起動
ログイン後、必要なときだけ起動します。動作がシンプルで、デスクトップに入るたびにローカル待受ポートを占有することもありません。
おすすめ: たまに使う場合、必要なときだけ厳密に実行したい場合
アップグレード、アンインストール、よくあるトラブルの確認
deb または rpm パッケージをアップグレードする場合は、パッケージマネージャーで新しいファイルを直接インストールできます。インストール前に v2rayN を終了し、現在のバージョン、Core タイプ、ローカルポートを記録してください。インストール後は、サブスクリプショングループ、ルーティングルール、システムプロキシの状態を確認します。設定は通常ユーザーディレクトリに保存されるため、パッケージのアップグレードでユーザー設定がリセットされるわけではありません。ただし、クライアントの実行中にプログラムファイルを同時に置き換えることは避けてください。
アンインストールする際は、まず systemd ユーザーサービスを停止・無効化してください。そうしないと、サービスマネージャーが削除済みの実行ファイルを起動し続けようとします。その後、ディストリビューションのパッケージマネージャーでソフトウェアを削除します。ユーザー設定を残すかどうかは、再インストールの予定に応じて決めてください。プログラムパッケージの削除とユーザーデータの消去を一度に行わないようにしましょう。
systemctl --user disable --now v2rayn-desktop.serviceを実行して停止し、自動起動を解除します。systemctl --user status v2rayn-desktop.serviceを実行し、プロセスが終了していることを確認します。- Debian/Ubuntu では
dpkg -l | grep -i v2raynで正確なパッケージ名を調べ、その名前を APT に渡して削除します。 - Fedora 系では
dnf list installed | grep -i v2raynで正確なパッケージ名を調べ、その名前を DNF に渡して削除します。 - 自動起動が不要になったことを確認したら、ユーザーサービスファイルを削除して
systemctl --user daemon-reloadを実行します。
| 症状 | 優先して確認する項目 | 対処方法 |
|---|---|---|
| インストール時にアーキテクチャエラーが表示される | uname -m |
x64 または ARM64 パッケージを選び直す |
| サブスクリプション更新後もノードが表示されない | サブスクリプション URL、システム時刻、更新ログ | 完全な URL をコピーし直して手動更新する |
| コア起動直後に終了する | ポート競合とコアのログ | 10808 付近のポートを確認するか、待受ポートを変更する |
| システムプロキシを有効にしてもアクセスできない | デスクトップのプロキシ状態、ブラウザーの古い接続 | ポートを確認して接続を再確立する |
| ログイン後にサービスが繰り返し失敗する | journalctl --user |
ExecStart のパスとグラフィカルセッション環境を修正する |
トラブルシューティングの順序は固定してください。まず通常ユーザーでプログラムを起動できることを確認し、次にコアが正常にポートを待ち受けていることを確認します。その後、ノード接続とルーティングを確認し、最後にシステムプロキシを確認します。インストール権限、コアプロトコル、デスクトッププロキシを同時に変更すると、ログから原因と結果を追いにくくなります。一度に変更する変数を 1 つに絞り、各手順で状態を記録するほうが、何度も再インストールするより早く問題を特定できます。