· プラットフォーム · 約8分

v2rayNをLinuxにインストールする方法｜deb/rpmパッケージと自動起動設定

Debian/UbuntuやFedoraにv2rayNをインストール。依存関係と権限を確認し、デスクトップログイン時の自動起動を設定します。

この記事の概要

この記事は、Linuxのデスクトップ環境を使用している方向けです。まずディストリビューションとCPUアーキテクチャを確認し、システムのパッケージマネージャーでv2rayNをインストールします。続いてサブスクリプション、待ち受けポート、システムプロキシを確認し、デスクトップの自動起動項目を設定します。ここでいう「自動起動」はユーザーがデスクトップにログインした後の起動を指し、ログイン前に動作するシステムサービスではありません。

インストール前に確認すること：ディストリビューション、アーキテクチャ、パッケージ形式

debとrpmはソフトウェアのパッケージ形式であり、プロキシプロトコルではありません。DebianやUbuntuでは通常deb、Fedoraではrpmを使用します。どちらもLinux向けだからといって、rpmをaptでインストールすることはできません。ディストリビューションの違いを回避するために、パッケージ形式を変換する方法もおすすめしません。ダウンロードページでLinux用パッケージを選ぶ際は、CPUアーキテクチャも確認してください。

cat /etc/os-release
uname -m
printf '%s\n' "$XDG_CURRENT_DESKTOP" "$XDG_SESSION_TYPE"

uname -mの出力がx86_64なら、通常はx64またはamd64パッケージに対応します。aarch64なら、通常はarm64パッケージに対応します。パッケージ名の表記とシステムツールの出力は異なる場合があるため、パッケージ内のメタデータを確認してください。インストーラーでアーキテクチャの不一致が表示された場合は、チェックを無視して強制せず、適切なパッケージを選び直してください。

Debian / Ubuntu

パッケージ形式
deb
インストールツール
apt
メタデータの確認
dpkg-deb -f
主なアーキテクチャ名
amd64、arm64

ローカルのファイルパスを指定してインストールすると、aptが宣言済みの依存関係も処理します。

Fedora

パッケージ形式
rpm
インストールツール
dnf
メタデータの確認
rpm -qp
主なアーキテクチャ名
x86_64、aarch64

以下のrpmコマンドはFedora向けです。ほかのrpm系ディストリビューションでは、それぞれのパッケージマネージャーを使用してください。

debとrpmのインストール：パッケージマネージャーを使う

以下のコマンドはBashターミナルで実行します。パッケージのパスは実行時に入力するため、固定のバージョン番号や架空のファイル名には依存しません。絶対パスをすべて入力してください。パスに空白が含まれていても、入力時に引用符を追加する必要はありません。コマンド内の変数には引用符を付けています。誤ってダウンロードフォルダー内の別のソフトウェアをインストールしないよう、まずメタデータを確認してから、インストール内容を確かめてください。

Debian / Ubuntuでdebをインストール

read -r -p 'debファイルの絶対パスを入力してください：' package
if [ -f "$package" ]; then
  dpkg-deb -f "$package" Package Version Architecture
  sudo apt update
  sudo apt install "$package"
else
  printf '%s\n' 'ファイルが見つかりません。パスを確認してください。'
fi

apt installは、設定済みのソフトウェアリポジトリから依存関係を解決します。依存関係を満たせないというエラーが表示された場合は、まずディストリビューションのバージョン、リポジトリの状態、パッケージの要件を確認してください。別のディストリビューションのリポジトリを追加したり、強制上書きオプションでシステムの基本ライブラリを置き換えたりしないでください。以前にdpkg -iを使って未設定のパッケージが残っている場合は、sudo apt --fix-broken installを実行し、インストールまたは削除されるパッケージの一覧を確認してから続行してください。

Fedoraでrpmをインストール

read -r -p 'rpmファイルの絶対パスを入力してください：' package
if [ -f "$package" ]; then
  rpm -qp --queryformat '%{NAME} %{VERSION}-%{RELEASE} %{ARCH}\n' "$package"
  sudo dnf install "$package"
else
  printf '%s\n' 'ファイルが見つかりません。パスを確認してください。'
fi

インストール時の権限と実行時の権限は別です：システムディレクトリへの書き込みには管理者権限が必要ですが、v2rayNは普段使用しているデスクトップユーザーで起動してください。インストール後はアプリケーションメニューからv2rayNを検索して起動します。sudoでGUIクライアント全体を起動すると、rootユーザー所有の設定ファイルが作成され、デスクトップセッションからアクセスできなくなる場合があります。

初回起動：ローカルプロキシを確認してからデスクトッププロキシを設定

起動後、まずサブスクリプションを追加してください。サブスクリプションURLからノード設定を取得しますが、インストールパッケージが自動生成するものではありません。VMessやVLESSなどは接続プロトコルであり、debやrpmのインストールオプションではありません。サブスクリプションに含まれるプロトコル、転送方式、セキュリティ設定は、選択中のコアが対応している必要があります。エラーを解消するために、サブスクリプションのポート、転送パス、TLS設定をむやみに変更しないでください。

  1. サブスクリプションを追加

    メイン画面で「サブスクリプショングループ」→「サブスクリプショングループの設定」を開き、新しいグループを追加して有効なサブスクリプションURLを入力します。保存後、「サブスクリプショングループ」メニューから該当のサブスクリプションを更新してください。バージョンによってボタン名が多少異なる場合があります。実際の画面に従って操作してください。

  2. ノードを選択

    更新後、ノード一覧から項目を選び、右クリックメニューの「アクティブサーバーに設定」を選択します。ログでコアが正常に起動しているか確認してください。ノードが一覧に表示されていても、接続先に到達できるとは限りません。

  3. 待ち受け設定を確認

    「設定」→「パラメーター設定」を開き、ローカルの待ち受けアドレス、ポート、インバウンドの種類を確認します。以降では、SOCKSインバウンドを127.0.0.1:10808に手動設定した例を使います。実際のテストでは、画面に表示されている値を使用してください。

  4. プロキシを設定

    デスクトッププロキシを設定する前に、以下のコマンドで接続をテストしてください。GNOMEでは通常、「設定」→「ネットワーク」→「ネットワークプロキシ」→「手動」から設定します。KDE Plasmaでは通常、「システム設定」→「ネットワーク」→「プロキシ」から設定します。具体的な項目名や構成はデスクトップ環境のバージョンによって異なります。

127.0.0.1
ローカルの待ち受けアドレスの例
10808
この記事で使用するSOCKSの例示ポート
15秒
以下の接続テストのタイムアウト時間
ss -lntp | grep ':10808'
curl --proxy socks5h://127.0.0.1:10808 \
  --connect-timeout 15 --max-time 30 \
  -I https://v2rayhk.com/

1つ目のコマンドでTCPの待ち受け状態を確認します。2つ目のコマンドはSOCKSプロキシ経由でリクエストを送り、接続先ドメイン名もプロキシ側で解決します。これは接続確認用であり、速度や匿名性を測定するものではありません。実際の設定がHTTPインバウンドの場合は、対応するHTTPプロキシアドレスを使用してください。SOCKSポートをデスクトップのHTTPプロキシ欄に入力してはいけません。アプリによってデスクトッププロキシへの対応状況は異なり、ターミナルのツールがGUI環境の設定を読み取るとも限りません。

デスクトップの自動起動：既存の起動項目をコピー

GUIクライアントは通常、ユーザーセッションで動作します。「PCの起動後にクライアントを自動で開く」には、rootのシステムサービスではなく、デスクトップへのログイン時に自動起動するよう設定してください。標準的な方法は、インストールパッケージに含まれる.desktop起動項目を、現在のユーザーの~/.config/autostart/にコピーすることです。元のExecを保持すれば、実行ファイルのパスを推測せずに済みます。

デスクトップログイン時の自動起動

おすすめ

現在のユーザーのデスクトップセッションでv2rayNを起動し、アプリケーションメニューの起動項目に設定された実行パラメーターをそのまま使います。ユーザー設定やデスクトッププロキシ設定にもアクセスしやすくなります。

対象：Debian、Ubuntu、Fedoraのデスクトップ環境で日常的に使用する場合。

アプリケーションメニューから手動で起動

インストール、サブスクリプション、プロキシ接続が正常に動作することを確認してから、自動起動を有効にしてください。トラブルシューティング中は手動起動にすると、複数のインスタンスや起動タイミングの影響を減らせます。

対象：初回セットアップ、たまに使用する場合、起動エラーを調査中の場合。

起動ファイルを探してコピー

find /usr/share/applications "$HOME/.local/share/applications" \
  -maxdepth 1 -type f -iname '*v2rayn*.desktop' -print 2>/dev/null

read -r -p '見つかったdesktopファイルの絶対パスを入力してください：' entry
if [ -f "$entry" ]; then
  grep -E '^\[Desktop Entry\]|^(Name|Exec|TryExec|Hidden|OnlyShowIn|NotShowIn|X-GNOME-Autostart-enabled)=' "$entry"
  mkdir -p "$HOME/.config/autostart"
  cp -- "$entry" "$HOME/.config/autostart/v2rayn.desktop"
  chmod 644 "$HOME/.config/autostart/v2rayn.desktop"
else
  printf '%s\n' '起動ファイルが見つかりません。インストールが完了しているか確認してください。'
fi

コピーする前に、コピー先ファイルに残しておきたいカスタム設定がないことを確認してください。上記のコピーコマンドは、同名の自動起動項目を上書きします。検索しても見つからない場合は、アプリケーションメニューでランチャーのプロパティを確認するか、インストールパッケージのファイル一覧から場所を特定してください。確認せずにExec=v2rayNを作成するのは避けてください。debの内容はdpkg-deb -c、rpmのファイルパスはrpm -qplで確認できます。

自動起動を停止するには、ユーザーディレクトリにあるコピーを削除します：rm "$HOME/.config/autostart/v2rayn.desktop"。アプリケーション自体はアンインストールされません。クライアント内蔵の自動起動機能を有効にしている場合は、同じファイルを管理していないか確認してください。自動起動の設定が重複する可能性があります。デスクトップの自動起動は、システムプロキシを自動的に有効にする設定ではありません。プロキシが有効になるかどうかは、クライアントに保存された設定とデスクトップ環境によります。

依存関係、権限、ログイン時の起動に関するトラブルシューティング

トラブルシューティングは、ローカルからリモートへ順番に確認します。プログラムが起動するか、コアが起動するか、ポートが待ち受けているか、プロキシ経由のリクエストが成功するか、アプリがプロキシを使用しているかを調べてください。こうすれば「インストールの失敗」「ノードに接続できない」「デスクトップがプロキシを使っていない」を切り分けられます。原因が変わっていないのに何度も再インストールする事態も避けられます。

依存関係が不足していると表示されます。ライブラリを手動でダウンロードする必要がありますか？

まずaptまたはdnfが表示する依存パッケージ名とバージョン条件を確認し、ソフトウェアリポジトリが利用可能か、アーキテクチャが正しいかを確認してください。パッケージが現在のディストリビューションより新しい基本ライブラリを要求する場合は、互換性のあるパッケージを選ぶか、ディストリビューションをアップグレードしてください。システムライブラリをむやみに置き換えないでください。

アイコンをクリックしても反応しません。原因を調べるには？

起動項目のExecを確認し、通常のユーザー権限で、その中のプログラムを実際のパラメーターとともにターミナルから実行します。デスクトップランチャー専用のフィールドコードである%Uや%Fなどは取り除いてください。ライブラリ不足、ディスプレイセッション、設定ファイルの権限に関するエラーを記録し、内容に応じて対処します。最初から管理者権限での起動に切り替えないでください。

ログにポートが使用中と表示されます。どうすればよいですか？

ss -lntp | grep ':10808'を実行して、例示ポートを確認します。まず、重複して起動しているクライアントを終了してください。別のプログラムがそのポートを使用している場合は、パラメーター設定で空いているポートに変更し、デスクトッププロキシとテストコマンドも同じポートに合わせてください。

ログイン後にウィンドウが表示されません。自動起動に失敗していますか？

まずpgrep -afi v2raynを実行してプロセスを確認し、起動後に最小化する設定になっていないかも確認してください。デスクトップによっては、システムトレイ拡張機能が初期状態で有効になっていません。トレイアイコンが表示されなくても、プログラムが動作している場合があります。自動起動ファイルの非表示設定やデスクトップ環境の制限キーも確認してください。

通常のプロキシは使えますが、TUNの起動に失敗します。

TUNは仮想ネットワークアダプター、ルーティング、追加の権限を必要とするため、通常のローカルプロキシを使うための必須条件ではありません。まずTUNを無効にして基本的な接続を確認し、その後、使用中のバージョンの案内に従って権限を設定してください。Fedoraでセキュリティポリシーによるブロックが疑われる場合は、拒否ログを確認し、セキュリティ機能を安易に無効にしないでください。

アップグレード前にクライアントを終了し、現在のユーザー設定を保持してください。同じパッケージマネージャーで新しいパッケージをインストールし、完了後にアプリケーションメニューの起動項目と自動起動用コピーのExecが一致しているか再確認します。パッケージをアンインストールしても、ユーザーディレクトリ内の設定や手動でコピーした自動起動項目がすべて削除されるとは限りません。アンインストール後も~/.config/autostart/を確認してください。接続に関する問題は、トラブルシューティングの確認手順も参考にしてください。

v2rayNをダウンロードクライアントとプラットフォームを選択