2026年9月11日 · プラットフォーム · 約10分

v2rayN Linux版のインストール｜deb・rpmパッケージと自動起動設定

Debian・Ubuntu・Fedora向けに、deb・rpmのインストール、依存関係の解決、トレイアイコンの表示、ログイン後の自動起動設定を解説します。

この記事の概要

まずディストリビューションとCPUアーキテクチャを確認し、aptまたはdnfでローカルパッケージをインストールします。初回起動後は、サブスクリプション、コア、ローカルの待ち受けポート、システムプロキシをそれぞれ確認します。最後に、パッケージに含まれるデスクトップランチャーをユーザーの自動起動ディレクトリにコピーします。対象はGUI環境のLinuxユーザーです。ここでいう自動起動はデスクトップへのログイン後に起動する設定であり、起動時に動くシステムサービスではありません。

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

v2rayNはデスクトップ向けのGUIクライアントで、V2RayやXrayなどのコアが実際の接続を処理します。クライアントのインストール、コアの起動、アプリでのプロキシ利用は、それぞれ別の段階です。この記事ではLinuxのインストールとデスクトップセッションの設定を扱い、Android版のv2rayNGやv2flyNGの操作手順は適用しません。

ターミナルを開き、ディストリビューション情報とマシンのアーキテクチャを確認します。Debian・Ubuntuでは通常deb、Fedoraではrpmを選びます。ほかのディストリビューションもrpmを採用している場合がありますが、拡張子だけで互換性を判断せず、パッケージの依存関係を満たすか事前に確認してください。

cat /etc/os-release
uname -m

Debian / Ubuntu

パッケージ形式
deb
インストールツール
apt
x86_64
x64版をダウンロード
aarch64
ARM64版をダウンロード

debのメタデータでは、x64はamd64、ARM64はarm64と表記されることがあります。

Fedora

パッケージ形式
rpm
インストールツール
dnf
x86_64
x64版をダウンロード
aarch64
ARM64版をダウンロード

ARM64とx64は互換性がありません。アーキテクチャが一致しない場合、通常はパッケージマネージャーがエラーを表示します。

クライアントのダウンロードページでLinuxと対応するアーキテクチャを選択します。以下のコマンドでは、ダウンロードしたファイルの名前をファイルマネージャーでv2rayn-linux.debまたはv2rayn-linux.rpmに変更し、そのファイルがあるフォルダーでターミナルを開くものとします。名前を変更するのはコマンドを簡潔にするためで、パッケージ内部のバージョン、パッケージ名、アーキテクチャは変わりません。

ディストリビューションのパッケージ

おすすめ

aptまたはdnfでローカルのdeb・rpmパッケージをインストールします。パッケージマネージャーがファイルと依存関係を管理するため、デスクトップランチャーの確認やアップグレードも行えます。

対象：Debian・Ubuntu・Fedoraの一般的なデスクトップ環境。

ポータブルアーカイブ

ダウンロードページにポータブル版がある場合は、展開先や実行権限、ランチャーを自分で管理する必要があります。ディレクトリを移動した場合は、自動起動項目に記載されたプログラムのパスも変更してください。

対象：依存関係が整った環境で、インストール先を自分で管理したいユーザー。

2. deb・rpmをインストールし、エラーに応じて依存関係を解決

ローカルパッケージのインストールには、低レベルのインストールコマンドだけでなく、aptまたはdnfを使うのがおすすめです。パッケージマネージャーは有効なソフトウェアリポジトリから依存関係を解決できます。リポジトリを利用できない場合はインストールに失敗するため、依存関係の確認を省略せず、ネットワークやリポジトリの問題を先に解決してください。

Debian・Ubuntu：aptでローカルのdebをインストール

# debファイルがあるディレクトリで実行
dpkg-deb -f ./v2rayn-linux.deb Package Version Architecture
sudo apt update
sudo apt install ./v2rayn-linux.deb

./はカレントディレクトリのファイルを表します。省略すると、aptが入力をリポジトリ内のパッケージ名として扱う場合があります。以前にdpkg -iでインストールし、依存関係が未設定のままになっている場合は、次の修復コマンドを実行してください。aptが提示するインストールまたは削除の内容を確認し、問題がないことを確かめてから進めます。その後、ローカルパッケージのインストールを再実行してください。

sudo apt --fix-broken install

Fedora：dnfでローカルのrpmをインストール

# rpmファイルがあるディレクトリで実行
rpm -qp --queryformat '%{NAME} %{VERSION}-%{RELEASE} %{ARCH}\n' ./v2rayn-linux.rpm
sudo dnf install ./v2rayn-linux.rpm

3. 初回起動：サブスクリプション・待ち受けポート・システムプロキシを個別に確認

インストール後、デスクトップのアプリケーションメニューからv2rayNを検索します。まずメインウィンドウが開くことを確認してから、接続設定をインポートしてください。メニュー名はバージョンによって変わります。以下ではデスクトップ版でよく使われる「サブスクリプショングループ」「設定」「パラメーター設定」などの名称を使います。現在のバージョンで表示が異なる場合は、機能を基準に探してください。Android版のメニュー位置は参照しないでください。

  1. クライアントを起動

    アプリケーションメニューからv2rayNを起動します。ウィンドウが表示されない場合は、デスクトップランチャーのExec=に記載されたプログラムをターミナルから実行し、ライブラリ不足やディスプレイセッションのエラーを確認してください。

  2. サブスクリプションをインポート

    「サブスクリプショングループ」→「サブスクリプショングループの設定」を開き、グループを追加して、メモとサブスクリプションURLを入力して保存します。その後、「サブスクリプショングループ」から更新してください。共有リンクはメイン画面のクリップボードからインポートする機能を使います。

  3. サーバーを選択

    リストから利用可能な設定を選び、アクティブサーバーに設定します。VMessやVLESSなどの接続パラメーターは、サブスクリプションまたは共有リンクから提供されます。トラブルシューティングのためだけに、伝送方式、TLS、サーバーアドレスをむやみに変更しないでください。

  4. 待ち受けを確認

    「設定」→「パラメーター設定」を開き、基本設定にあるローカルの待ち受けポートを確認します。ログにコアの起動失敗やポート競合がないかも確認してください。設定を保存した後は、クライアントの案内に従って関連サービスを再起動します。

  5. システムプロキシを設定

    メイン画面またはトレイの「システムプロキシ」メニューから「システムプロキシを自動設定」を選びます。デスクトップ環境のネットワークプロキシ設定も確認してください。各アプリがその設定に従うかどうかは、個別に確認する必要があります。

以下の2つのポートは、説明用の一般的な設定例です。すべてのバージョンで初期値として使われているとは限りません。実際の値は本機のパラメーター設定を確認してください。クライアントが単一の混合ポートを使う場合は、その受信設定が対応するプロトコルを使ってテストし、2つ目の待ち受けを追加する必要はありません。

10808
この節で使うSOCKS待ち受けポートの例
10809
この節で使うHTTP待ち受けポートの例
127.0.0.1
ローカルのループバックアドレス。リモートサーバーではありません。
# 対応するTCP待ち受けの有無を確認。ポートは本機の設定に合わせて変更
ss -lntp | grep -E ':(10808|10809)\b'

# 対応する待ち受けプロトコルを確認してからテスト。curlのインストールが必要
curl --connect-timeout 10 --max-time 20 \
  --proxy socks5h://127.0.0.1:10808 https://example.com/

curl --connect-timeout 10 --max-time 20 \
  --proxy http://127.0.0.1:10809 https://example.com/

プロキシを明示したcurlリクエストを使うと、「プロキシサービスが利用できない」のか「アプリがプロキシを使っていない」のかを切り分けられます。socks5hでは、接続先のドメイン名をプロキシ側で解決します。リクエストが成功しても、すべてのアプリがプロキシを利用しているとは限りません。また、システムプロキシとルーティングモードは別の設定です。「グローバル」や「中国本土を除外」などのルールは、コアに届いたリクエストの経路を決めるものであり、システムプロキシを無視するアプリを自動的に接続するものではありません。

4. トレイアイコンが表示されない場合：まずデスクトップ環境を確認

Linuxでのトレイ表示は、デスクトップ環境が提供するステータスアイコンの仕組みに左右されます。メインウィンドウとコアが正常なのにトレイだけ表示されない場合は、すぐにクライアントを再インストールせず、まずデスクトップとの連携を確認してください。特にGNOMEでは、アプリケーションインジケーターのサポートが有効になっていないことがあります。

デスクトップ拡張機能をインストールまたは有効にした後は、作業内容を保存してログアウトし、再ログインしてください。クライアントのプロセスを何度も終了するより、問題の切り分けに役立ちます。Waylandセッションでは、別のセッション向けのデスクトップ再起動ショートカットをそのまま使わないでください。メインウィンドウ自体が開かない場合は、ターミナルに戻って起動エラーを確認します。トレイ拡張機能では、実行ライブラリの不足は解消できません。

5. デスクトップの自動起動でログイン後に起動

GUIクライアントはユーザーのデスクトップセッションに合わせて起動するのが適切です。XDGの自動起動ディレクトリ~/.config/autostart/は、この用途に適しています。ログイン画面が表示される前に起動する設定ではなく、/etc/rc.localへの書き込みやrootの定期実行タスクも必要ありません。まず手動起動が正常に動くことを確認してから、自動起動を設定すると原因を絞り込みやすくなります。

パッケージに含まれるデスクトップランチャーを探す

インストールに使ったパッケージのファイル一覧を調べると、配布元が設定した起動パス、引数、アイコンをそのまま利用できます。以下では、本機のパッケージ形式に合ったコマンドを一組だけ実行してください。インストールパッケージを移動した場合は、現在の保存先ディレクトリに移動してから実行します。

# Debian / Ubuntu
pkg_name=$(dpkg-deb -f ./v2rayn-linux.deb Package)
dpkg -L "$pkg_name" | grep -E '/applications/.*\.desktop$'

# Fedora
pkg_name=$(rpm -qp --queryformat '%{NAME}' ./v2rayn-linux.rpm)
rpm -ql "$pkg_name" | grep -E '/applications/.*\.desktop$'

出力から、メイン画面を起動するための.desktopファイルを選びます。複数のランチャーが含まれる場合は、Name=とExec=を確認し、アンインストール用や補助ツール用のファイルをコピーしないでください。続いてBashターミナルで次のコマンドを実行し、プロンプトが表示されたら、先ほど確認したフルパスを引用符なしで貼り付けます。

read -r -p "メイン画面の .desktop ファイルのフルパスを貼り付けてください：" desktop_file

if [ -f "$desktop_file" ]; then
  mkdir -p "$HOME/.config/autostart"
  install -m 644 "$desktop_file" \
    "$HOME/.config/autostart/v2rayn.desktop"
  sed -i '/^Hidden=/d; /^X-GNOME-Autostart-enabled=/d' \
    "$HOME/.config/autostart/v2rayn.desktop"
  grep -E '^(Name|Exec|TryExec|Hidden|OnlyShowIn|NotShowIn|X-GNOME-Autostart-enabled)=' \
    "$HOME/.config/autostart/v2rayn.desktop"
else
  printf '%s\n' "ファイルが見つかりません。自動起動項目は作成されませんでした。"
fi

この手順では元のランチャーの実行コマンドを維持し、自動起動を妨げる可能性のある2つのオプションを削除します。OnlyShowIn=またはNotShowIn=が残っている場合は、現在のデスクトップ環境に対する制限が適切か確認してください。Exec=をプログラム名だけに置き換えてパスを推測したり、~、パイプ、&を記述したりしないでください。デスクトップランチャーは通常のシェルスクリプトとして解釈されません。

動作確認・無効化・アップグレード後の確認

  1. クライアントから完全に「終了」し、ウィンドウや重複したプロセスが残っていないことを確認します。
  2. ほかの作業を保存してログアウトし、再ログインします。v2rayNが起動することと、ローカルの待ち受けが復旧することを確認してください。
  3. システムプロキシが想定どおりに設定されているか確認します。自動起動しただけでは、サーバーが自動選択されたり、すべてのプロキシ状態が復元されたりするわけではありません。
  4. 自動起動を無効にする場合は、次の削除コマンドを実行してください。ユーザーの自動起動用コピーだけを削除し、クライアントはアンインストールしません。
rm -f "$HOME/.config/autostart/v2rayn.desktop"

クライアントにも自動起動の設定がある場合は、内蔵機能か手動で作成した項目のどちらか一方だけを使い、二重起動を避けてください。アップグレード後にインストール先や起動引数が変わった場合は、新しいパッケージに含まれるランチャーを改めてコピーします。自動起動ディレクトリ内の古いコピーは、システムディレクトリの更新に自動では追従しません。

6. インストールと自動起動に関するよくある質問

インストールは成功したのに、アプリケーションメニューに表示されないのはなぜ？

まずパッケージのファイル一覧を確認し、.desktopランチャーがインストールされているか調べます。次に、対応するExec=のパスが存在するか確認してください。必要なファイルがそろっている場合は、ログアウトして再ログインし、デスクトップメニューを更新します。メニューのキャッシュだけを見てインストール失敗と判断しないでください。

ログイン後にウィンドウが2つ開く場合、どちらを削除すればいい？

デスクトップの「自動起動するアプリケーション」設定で重複項目を確認し、~/.config/autostart/とクライアント内蔵の自動起動設定も確認してください。起動方法はどちらか一方にします。この記事の設定を取り消す場合は、ユーザー用コピーのv2rayn.desktopだけを削除してください。

自動起動後はサブスクリプションの更新に失敗するのに、手動で再試行すると成功するのはなぜ？

ログイン時にはネットワーク接続の準備ができていない場合があります。デスクトップのネットワーク接続が完了するまで待ってから、「サブスクリプショングループ」を手動で更新してください。ログイン直後だけ失敗する場合は、デスクトップの自動起動管理機能に遅延起動の設定があれば利用します。サブスクリプションの内容を変更したり、自動起動項目を何度も作成したりする必要はありません。

ブラウザーではアクセスできるのに、ターミナルのコマンドがタイムアウトするのはなぜ？

多くのコマンドラインツールは、デスクトップのシステムプロキシ設定を参照しません。まずこの記事のcurl --proxyを使って明示的にテストし、実際の待ち受けポートを確認します。その後、ツールに応じてプロキシ環境変数を設定してください。HTTPプロキシとSOCKSプロキシでは、プロトコルのプレフィックスを混同しないでください。

クライアントを終了したら、ブラウザーもネットに接続できなくなったのはなぜ？

デスクトップのネットワークプロキシが、停止済みのローカル待ち受けを参照したままになっていないか確認してください。クライアントを再起動して「システムプロキシ」→「システムプロキシを解除」を選ぶか、デスクトップのネットワーク設定でプロキシをオフにしてから、直接接続を確認します。システムプロキシを解除しても、サブスクリプションやルーティングルールは削除されません。

安定した導入手順は、パッケージのインストール、通常ユーザーでの手動起動、プロキシ経路の確認、最後にログイン時の自動起動、の順です。各段階が完了してから次に進めば、依存関係、デスクトップのトレイ、リモート接続の問題が混ざりにくくなります。初期設定の詳しい手順は入門ガイドを、プロトコルの項目やルーティングの概念はプロトコルガイドをご覧ください。

v2rayN / v2rayNG ダウンロード