v2rayN Linuxインストールガイド：deb/rpmパッケージの導入、デスクトップアイコン、自動起動の設定

インストール前にシステムアーキテクチャとデスクトップセッションを確認

まずターミナルでCPUアーキテクチャを確認し、ディストリビューション名だけでパッケージを選ばないようにします。一般的なデスクトップPCでは x86_64 と表示され、ダウンロードページの64ビットまたはx64パッケージに対応します。一部のARMデバイスでは aarch64 と表示されるため、arm64パッケージを選択してください。2種類のパッケージは混在できず、アーキテクチャを間違えると通常は「パッケージのアーキテクチャが一致しません」や「バイナリファイルを実行できません」といったエラーが表示されます。

uname -m
cat /etc/os-release
echo "$XDG_CURRENT_DESKTOP"
echo "$XDG_SESSION_TYPE"

/etc/os-release はパッケージ体系の判定に使います。Ubuntu、Debian、Linux Mintなどではdebを、Fedora、Rocky Linux、openSUSEなどrpm系ディストリビューションではrpmを優先します。デスクトップセッションはトレイや自動起動の挙動にも影響します。GNOME、KDE Plasma、Xfceではステータス領域の実装が完全には同じではありません。

この記事のコマンドは64ビットのテスト環境を例にしています。環境はUbuntu 24.04、GNOME、Wayland、およびFedora 42、KDE Plasma、Waylandです。リリース方式によってパッケージのファイル名が変わる場合があるため、インストールコマンドを実行する前に ls -lh ~/Downloads で実際のファイル名を確認してください。

UbuntuとDebianにdebパッケージをインストール

当サイトのクライアントページを開き、Linuxプラットフォームとアーキテクチャに対応したv2rayN debパッケージをダウンロードします。ダウンロード後にファイル形式を確認し、APTでローカルパッケージをインストールしてください。低レベルの展開コマンドを直接使うのではなく apt install を使うと、パッケージマネージャーが利用可能なリポジトリ依存関係も同時に解決できます。

1. アーキテクチャを確認

   uname -m を実行します。x86_64 と表示されたら64ビットパッケージを、aarch64 と表示されたらarm64パッケージを選択します。

2. パッケージを取得

   クライアントページのLinuxタブを開き、debファイルをダウンロードして現在のユーザーの Downloads ディレクトリに保存します。

3. パッケージをインストール

   ダウンロードディレクトリでローカルインストールコマンドを実行します。APTがパッケージ情報を読み取り、設定済みのソフトウェアソースから利用可能な依存関係を補います。

4. コアを選択

   起動後、「設定」→「パラメーター設定」→「Core タイプ」を開き、Xrayを選択して保存し、コアを再起動します。

5. プロキシを確認

   サブスクリプションをインポートしてノードを選択し、システムプロキシを有効にします。その後、ローカル待受ポートとコアのログが正常か確認してください。

cd ~/Downloads
ls -lh v2rayN*.deb
sudo apt update
sudo apt install ./v2rayN-linux-64.deb

arm64パッケージをダウンロードした場合は、コマンド内のファイル名をターミナルに表示されたarm64ファイル名へ変更します。ファイル名は大文字と小文字を区別し、ローカルパスの先頭にある ./ も省略できません。インストール後はアプリケーションメニューでv2rayNを検索するか、command -v v2rayN を実行して実行ファイルを確認できます。

依存関係が満たされていない場合は、まずシステムのソフトウェアソースを更新してから修復インストールを実行します。パッケージを何度もダブルクリックするのは避けてください。グラフィカルなソフトウェアセンターでは「インストールに失敗しました」としか表示されず、不足しているライブラリが分からないことがあります。

sudo apt --fix-broken install
sudo apt install ./v2rayN-linux-64.deb
apt-cache policy libicu-dev

ターミナルに特定のランタイムライブラリが不足していると明確に表示された場合は、エラーメッセージにあるパッケージ名を使い、現在のディストリビューションのリポジトリからインストールします。別のディストリビューションから共有ライブラリを単体でコピーすると、バージョンの依存関係が崩れるおそれがあり、長期的な解決策には適しません。

Fedoraとrpm系ディストリビューションにrpmパッケージをインストール

FedoraではDNFを使ってローカルrpmパッケージをインストールします。DNFがアーキテクチャ、署名メタデータ、依存関係を確認し、インストール記録をシステムのパッケージデータベースに登録します。コマンド内の ./ は、現在のディレクトリにあるローカルファイルを示します。

cd ~/Downloads
ls -lh v2rayN*.rpm
sudo dnf install ./v2rayN-linux-64.rpm

新しいDNFコマンド実装が有効なシステムでも、インストール構文は同じです。新バージョンへ更新する場合は、新しくダウンロードしたrpmファイルに対して同じローカルインストールを実行できます。パッケージマネージャーがバージョン番号に基づいて置き換えるため、ユーザー設定は通常ホームディレクトリ内に残ります。

インストール後は、次のコマンドでパッケージの登録情報とプログラムのエントリーを確認できます。rpm -qa でパッケージが見つかるのに command -v で何も表示されない場合は、rpm -ql で実際にインストールされたファイルを確認してください。

rpm -qa | grep -i v2rayn
command -v v2rayN
rpm -ql v2rayN | grep -E '/bin/|applications'

初回起動、コア、プロキシポートを設定

初回起動後はまずコアを確認し、すぐにシステムプロキシを有効にしないでください。「設定」→「パラメーター設定」→「Core タイプ」を開き、サブスクリプションのノードに必要なXrayコアを選択します。保存後、コアを一度再起動してください。VLESSやVMessなどのノードパラメーターは通常サブスクリプションからインポートされます。トランスポート、セキュリティ、サーバーアドレスを手動で変更すると、接続に失敗することがあります。

続いて「サブスクリプショングループ」でサブスクリプションURLを追加し、サブスクリプションを更新してノードを1つ選択します。基本的な接続性を確認する場合は、メイン画面の遅延テストを実行してから実行ログを確認します。遅延結果が表示されても、探索処理が完了したことを示すだけです。ウェブページにアクセスできるかどうかは、システムプロキシ、DNS、ルーティング設定にも左右されます。

システムプロキシを有効にしたら、ss でローカルの待受を確認します。以下のコマンドは一般的なポート10808のみを確認します。パラメーター設定で別のポートを使っている場合は、検索条件も合わせて変更してください。

ss -lntp | grep 10808
curl --proxy http://127.0.0.1:10808 https://example.com/ -I

ss で結果が表示されない場合は、まずv2rayNのログにあるコア起動エラーを確認します。よくある原因は、ポートの使用中、コアの実行不可、設定生成の失敗、ノード情報の不足です。待受が正常なのにブラウザーが直接接続する場合は、デスクトップシステムのネットワークプロキシがv2rayNのローカルアドレスに切り替わっているか確認してください。

• この端末だけで使う場合は、待受アドレスを 127.0.0.1 に保ち、プロキシポートをLANに公開しないようにします。
• ポートを変更したらシステムプロキシの設定も更新してください。旧ポートは自動的に追従しません。
• ノードを切り替えた後は、ログに新しいアウトバウンド接続が表示されるか確認してください。画面上で選択されていることだけを確認しないようにします。
• ルーティングが必要な場合は、まずプリセットのルールを使い、その後ドメインやIPルールを1つずつ追加します。

デスクトップアイコンとトレイアイコンを修復

パッケージのインストール後にアプリケーションメニューへアイコンが表示されない場合は、まずデスクトップエントリーファイルの存在を確認します。標準のエントリーは通常 /usr/share/applications にあります。現在のユーザーが ~/.local/share/applications に独自のエントリーを置くこともできます。デスクトップデータベースがまだ更新されていない場合は、何度も再インストールするよりログアウトして再ログインする方が簡単です。

find /usr/share/applications ~/.local/share/applications \
  -iname '*v2rayn*.desktop' 2>/dev/null
update-desktop-database ~/.local/share/applications 2>/dev/null || true

パッケージによって有効なエントリーが生成されない場合は、ユーザー単位のデスクトップファイルを作成できます。実行前に command -v v2rayN で実行パスを確認してください。結果が /usr/bin/v2rayN でない場合は、ターミナルに実際に表示されたパスをファイル内で使用します。

mkdir -p ~/.local/share/applications
cat > ~/.local/share/applications/v2rayN.desktop <<'EOF'
[Desktop Entry]
Type=Application
Name=v2rayN
Comment=Proxy client
Exec=/usr/bin/v2rayN
Icon=v2rayN
Terminal=false
Categories=Network;
StartupNotify=true
EOF
chmod 644 ~/.local/share/applications/v2rayN.desktop
update-desktop-database ~/.local/share/applications

トレイの問題がコアの実行を妨げることは通常ありません。まず pgrep -af v2rayN と ss -lntp でプロセスとポートが正常か確認し、その後デスクトップのステータス領域を個別に修復します。これにより「画面エントリーがない」問題と「プロキシコアが起動していない」問題を切り分けられます。

デスクトップ自動起動またはsystemdユーザーサービスを設定

Linuxデスクトップでは、一般的に2種類の自動起動方法があります。XDGデスクトップ自動起動はグラフィカルセッションに連動し、Wayland、DBus、トレイに必要な環境をそのまま利用できるため、多くのユーザーに適しています。systemdユーザーサービスは再起動ポリシーやログ確認に対応し、プロセス状態を明確に管理したい環境に向いています。

XDGデスクトップ自動起動

前の手順で ~/.local/share/applications/v2rayN.desktop を作成している場合は、現在のユーザーのautostartディレクトリへコピーするだけで構いません。ログイン後、デスクトップ環境がこのファイルを読み込み、プログラムを起動します。

mkdir -p ~/.config/autostart
cp ~/.local/share/applications/v2rayN.desktop \
  ~/.config/autostart/v2rayN.desktop

システムパッケージに付属するデスクトップファイルを使う場合は、まず find で実際のファイル名を探してからautostartディレクトリへコピーします。無効にするときはユーザーディレクトリ内の自動起動コピーだけを削除すればよく、v2rayNをアンインストールする必要はありません。

rm ~/.config/autostart/v2rayN.desktop

systemdユーザーサービス

サービスを作成する前にXDG自動起動を無効にし、2つのプロセスが10808などのローカルポートを同時に使用しないようにします。サービスファイルは現在のユーザーディレクトリに置き、sudo systemctl enable は使わないでください。誤ってシステム単位のサービスとして設定されます。

mkdir -p ~/.config/systemd/user
cat > ~/.config/systemd/user/v2rayn.service <<'EOF'
[Unit]
Description=v2rayN desktop client
After=graphical-session.target network-online.target
PartOf=graphical-session.target

[Service]
Type=simple
ExecStart=/usr/bin/v2rayN
Restart=on-failure
RestartSec=5

[Install]
WantedBy=graphical-session.target
EOF

systemctl --user daemon-reload
systemctl --user enable --now v2rayn.service

command -v v2rayN が別のパスを返す場合は、ExecStart も合わせて変更します。WaylandまたはDBus環境がユーザーサービスへ継承されないと、プログラムは動作していてもウィンドウやトレイアイコンが表示されないことがあります。デスクトップにログイン後、まずセッション変数を取り込んでからサービスを再起動してください。

systemctl --user import-environment \
  DISPLAY WAYLAND_DISPLAY XAUTHORITY DBUS_SESSION_BUS_ADDRESS
systemctl --user restart v2rayn.service
systemctl --user status v2rayn.service
journalctl --user -u v2rayn.service -n 80 --no-pager

起動不能、ポート競合、アンインストールへの対処

プログラムが起動しない場合は、ターミナルから直接実行し、完全なエラー出力を保存します。デスクトップアイコンのダブルクリックで発生したエラーはウィンドウを閉じると消えることがありますが、ターミナル出力なら共有ライブラリ、権限、コアファイル、グラフィカルセッションのどの問題かを切り分けられます。

command -v v2rayN
v2rayN
pgrep -af 'v2rayN|xray'
ss -lntp | grep -E '10808|10809'

ログにアドレスが使用中と表示された場合は、まず ss の出力からポートを使用しているプロセスを特定します。よくあるのは、旧版v2rayN、自動起動サービス、手動起動が同時に動いているケースです。不要なインスタンスを停止してからコアを再起動し、用途を確認できないシステムプロセスをむやみに終了しないでください。

• デスクトップ自動起動とsystemdサービスはどちらか一方だけを使い、二重起動を避けます。
• ローカルプロキシポートを変更した場合、ブラウザーとデスクトップシステムのプロキシ設定も同じポートに合わせる必要があります。
• コアの起動に失敗した場合は、「設定」→「パラメーター設定」→「Core タイプ」を開き、Xrayを選び直します。
• サブスクリプションの更新に失敗した場合は、まずネットワークとサブスクリプションURLを確認し、そのうえでプロキシ経由の更新を有効にするか判断します。
• アップグレード後に異常が発生した場合は、まずプログラムを終了して設定をバックアップし、現在のアーキテクチャに合うパッケージを再インストールします。

アンインストールする場合は、対応するディストリビューションのパッケージマネージャーを使います。パッケージを削除してもユーザー設定まで自動的に削除されるわけではありません。新しい設定で再テストする場合は、まずホームディレクトリ内のv2rayN設定をバックアップし、実際のパスに応じて処理してください。サブスクリプションやカスタムルーティングルールをバックアップせずに、ユーザーディレクトリを直接削除しないでください。

# Ubuntu または Debian
sudo apt remove v2rayn

# Fedora または同系統のrpmディストリビューション
sudo dnf remove v2rayN

# ユーザーサービスを停止
systemctl --user disable --now v2rayn.service
rm ~/.config/systemd/user/v2rayn.service
systemctl --user daemon-reload

パッケージ名の大文字・小文字や実際の登録名は異なる場合があります。アンインストール時にパッケージが見つからない場合、deb系では dpkg -l | grep -i v2ray、rpm系では rpm -qa | grep -i v2ray を実行し、検索結果に表示された正確な名前を使ってください。