Linuxのデスクトップ環境にv2rayNをインストールしたい方に向けた記事です。まずディストリビューションとCPUアーキテクチャに合ったパッケージを選び、システムのパッケージマネージャーでインストールします。通常ユーザーでアプリメニューからv2rayNを起動し、正常に動作することを確認してから、インストール済みのデスクトップエントリーを使ってログイン時の自動起動を設定します。クライアントのプロセスとプロキシ通信をそれぞれ確認しましょう。
パッケージの選び方:ディストリビューションとCPUアーキテクチャを確認
v2rayNを使うシステムで、次の2つのコマンドを実行します。1つ目でディストリビューションの識別情報を、2つ目でシステムのアーキテクチャを確認できます。仮想マシンで使う場合は、ホストではなく仮想マシン内で調べてください。
cat /etc/os-release
uname -m
Debian / Ubuntu
- インストールパッケージ
.deb- パッケージ管理ツール
apt- アーキテクチャの確認
dpkg --print-architecture
パッケージのメタデータでは、amd64 が x86_64、arm64 が aarch64 に対応します。
Fedora / openSUSE
- インストールパッケージ
.rpm- パッケージ管理ツール
- Fedoraは
dnf、openSUSEはzypperを使用 - アーキテクチャ名
x86_64またはaarch64
拡張子が同じでも依存関係は異なります。リリースノートで対応するディストリビューションとバージョンを確認してください。
deb・rpmパッケージをインストールする:依存関係はパッケージマネージャーに処理させる
ターミナルでインストールパッケージのあるディレクトリに移動します。以下の./v2rayN.debと./v2rayN.rpmはローカルファイル名の例です。実際に実行するときは手元のファイル名に置き換えてください。./を付けることで、現在のディレクトリにあるファイルをインストールすることを明示できます。以下の3つのコマンドから、使用中のディストリビューションに合うものを1つ選んでください。
# Debian / Ubuntu
sudo apt install ./v2rayN.deb
# Fedora
sudo dnf install ./v2rayN.rpm
# openSUSE
sudo zypper install ./v2rayN.rpm
ディストリビューション別のパッケージマネージャー
推奨ローカルファイルから依存関係を読み取り、有効なリポジトリから条件に合うバージョンを探します。処理を確定する前に、追加・更新・削除されるパッケージを確認できます。
用途:初回インストール、既存環境のアップグレード
低レベルのパッケージツール
dpkg-deb -I ./v2rayN.debまたはrpm -qpR ./v2rayN.rpmで、パッケージのメタデータや依存関係を確認できます。低レベルのツールで直接インストールする場合、上記のパッケージマネージャーのようにリポジトリから依存パッケージを補完することはありません。
用途:パッケージの宣言内容や不足している依存関係の確認
DebianやUbuntuで依存パッケージが見つからない場合は、まずsudo apt updateを実行してから、同じインストールコマンドを再実行してください。ライブラリのバージョンが要件を満たさないというエラーが出たら、エラーメッセージに記載されたライブラリ名と最低バージョンを確認し、使用中のディストリビューションのバージョンがパッケージの対応範囲内か調べます。依存関係を無視するオプションを使ってインストールを強行しないでください。以前のdpkgの実行で未設定のパッケージが残っている場合は、sudo apt --fix-broken installを実行する前に処理内容を確認してください。リポジトリで依存関係を解決できないと、そのパッケージがインストールされず、削除される場合があります。
アプリメニューから起動する:エントリーの場所と起動時の問題
アプリを検索
インストール後、GNOMEのアプリ検索またはKDE Plasmaのアプリケーションランチャーで「v2rayN」を検索します。まずは現在ログイン中のユーザーで一度起動してください。インストール時には管理者権限が必要ですが、グラフィカルクライアントの起動に管理者権限は必要ありません。
パッケージのファイル一覧を確認
メニューに表示されない場合、Debian系では
dpkg-query -Lにインストール済みのパッケージ名を付けて実行します。RPM系ではrpm -qlを使います。パッケージ名は、dpkg-deb -f ./v2rayN.deb Packageまたはrpm -qp --qf '%{NAME}\n' ./v2rayN.rpmで確認できます。ファイル一覧にある.desktopファイルが起動エントリーです。インストールパッケージのファイル名を起動コマンドとして使わないでください。エントリーの項目を確認
デスクトップエントリーファイルを開き、
NameとExecを確認します。NoDisplay=trueが設定されている場合、エントリーは存在していてもアプリメニューに表示されません。TryExecがある場合は、指定されたプログラムが存在し、実行可能かも確認してください。システムディレクトリにあるエントリーは直接編集しないでください。ソフトウェアのアップグレードで変更が上書きされることがあります。起動時の出力を確認
アイコンは表示されるのにウィンドウが開かない場合は、まずトレイにすでに起動中のインスタンスがないか確認します。次に、グラフィカルセッション内のターミナルから、エントリーが指定するプログラムを通常ユーザーで起動してください。エントリーに必要な引数は残しつつ、
%Uや%Fなどのデスクトップエントリー用フィールドコードはプログラムにそのまま渡さないでください。最初に出た起動エラーを記録し、共有ライブラリの不足、パスの誤り、クライアントの二重起動を切り分けます。
XDG自動起動:デスクトップへのログイン後にv2rayNを起動
XDG自動起動はグラフィカルデスクトップセッションによって処理されます。ユーザーのログイン後に実行される仕組みで、PCの電源投入後、ログイン前にサービスを起動する方法とは異なります。まず、クライアント側で自動起動が有効になっていないか、デスクトップ環境の自動起動一覧にv2rayNが登録されていないか確認してください。同じユーザーアカウントではエントリーを1つだけにし、起動処理の重複を防ぎます。
- 以下のコマンドで、現在のユーザー用の自動起動ディレクトリを作成します。
XDG_CONFIG_HOMEが設定されている場合は、そのディレクトリ内にautostartを作成してください。通常は~/.config/autostartです。 - ファイルマネージャーを使い、前のセクションでパッケージ一覧から見つけた
.desktopファイルをこのディレクトリにコピーします。実際のファイル名と元のExecを保持してください。インストールパッケージをコピーしたり、sudoでユーザー用エントリーを作成したりしないでください。 - テキストエディターでコピーしたファイルの
[Desktop Entry]セクションを確認します。Hidden=trueがあれば、その行を削除するかHidden=falseに変更してください。OnlyShowInとNotShowInが現在のデスクトップセッションに対応しているか、TryExecが引き続き有効かも確認します。 - 現在のグラフィカルセッションからログアウトし、再度ログインします。ウィンドウ、トレイ、またはシステムモニターで起動状態を確認してください。プロセスだけが見えてウィンドウが表示されない場合は、最小化起動が有効になっていないか確認してから、起動に失敗しているか判断します。
autostart_dir="${XDG_CONFIG_HOME:-$HOME/.config}/autostart"
mkdir -p "$autostart_dir"
printf '%s\n' "$autostart_dir"
手動で設定した自動起動を無効にするには、ユーザーディレクトリにコピーしたエントリーだけを削除し、システムディレクトリの元ファイルは残します。デスクトップ環境に同名のシステム自動起動項目がある場合、ユーザー側のコピーを削除するとシステム項目が再び有効になることがあります。その場合はデスクトップの自動起動設定で無効にするか、同名のユーザーエントリーにHidden=trueを設定して上書きしてください。アップグレード後は、システム側のExecが変更されていないか確認し、ユーザー側のコピーにも反映します。
ログイン後のトラブルシューティング:プログラム、ポート、プロキシ設定を切り分ける
メニューからは起動するのに、再ログイン後に起動しないのはなぜ?
まず、ターミナルに表示された自動起動ディレクトリを確認し、実際の.desktopファイルが置かれているか調べます。テキストエディターが追加した.txt拡張子付きのコピーではないことも確認してください。次に、エントリーの実行制限とパスをチェックします。エントリーを手動で実行しても失敗する場合は、起動エラーを解決してください。起動を遅らせて問題を覆い隠さないようにしましょう。
プロセスは動いているのに、ブラウザーがプロキシを使わないのはなぜ?
v2rayNの「設定」→「パラメーター設定」を開き、ローカルの待ち受けポートを確認します。次に、トレイの「システムプロキシ」が設定済みか解除済みかを確認してください。ss -ltnpでTCPの待ち受けを確認し、クライアントに表示された実際のポートを調べます。ポートが待ち受け中でも、ローカルのプロセスが接続を受け付けていることしか分かりません。ブラウザーのプロキシ設定元、選択中のノード、クライアントのログも確認してください。
ログイン後にサブスクリプションが更新されない。自動起動の問題?
まずクライアントが起動していることを確認し、ネットワークに接続されてからサブスクリプションを手動で更新します。手動更新が成功する場合は、ログイン時にWi-Fi接続が完了していたか、クライアントのサブスクリプション更新設定に問題がないか確認してください。デスクトップアプリの起動、ネットワーク接続、自動更新はそれぞれ独立した処理です。個別に動作を確認しましょう。