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

インストール前の確認：ディストリビューション、アーキテクチャ、デスクトップセッション

v2rayNはデスクトップ向けの設定管理アプリで、実際の接続処理は呼び出されたプロキシコアが行います。この記事で扱うのはGUIクライアントのため、利用可能なデスクトップセッションが必要です。ターミナルのみのサーバーには、この手順は適しません。まず通常ユーザーのターミナルで次のコマンドを実行し、ディストリビューション、CPUアーキテクチャ、デスクトップ環境を確認してください。

cat /etc/os-release
uname -m
printf 'デスクトップ環境：%s\nセッション種別：%s\n' "$XDG_CURRENT_DESKTOP" "$XDG_SESSION_TYPE"

クライアントのダウンロードページでLinuxと対応アーキテクチャを選択してください。Windows用ファイルをLinuxに使ったり、拡張子を変更してパッケージ形式を変換したりしないでください。以下のコマンドはBashで実行します。対話形式で実際のファイルパスを入力するため、特定のバージョン番号やファイル名には依存しません。

debのインストール：依存関係の処理はaptに任せる

DebianまたはUbuntuでは、ローカルのdebパッケージをaptでインストールする方法がおすすめです。設定済みのリポジトリから依存関係を解決できます。低レベルのインストールコマンドだけを使うと、展開は完了しても依存関係が未解決のままになることがあります。パスを入力するときは絶対パスをそのまま貼り付け、余分な引用符は付けないでください。変数は後続のコマンドで適切に引用しています。

read -r -p 'debファイルの絶対パスを入力してください：' package_file
dpkg-deb -f "$package_file" Package Version Architecture
sudo apt install "$package_file"

1. パッケージ情報の確認

   表示されたパッケージ名、バージョン、アーキテクチャを確認し、今回ダウンロードしたファイルと一致していることを確かめてください。アーキテクチャが違う場合はパッケージを選び直し、アーキテクチャチェックを強制的に無効化するオプションは使わないでください。

2. インストール結果の確認

   aptが正常に終了したことを確認してください。依存関係を利用できないというエラーが出た場合は、まずディストリビューションのリポジトリとサポート対象のバージョンを確認します。他のディストリビューションのシステムライブラリを混在させないでください。

3. アプリメニューから起動

   デスクトップのアプリメニューを開いてv2rayNを検索し、現在ログイン中のユーザーで起動してください。設定ファイルの所有者が管理者に変わるおそれがあるため、sudoでGUIを起動しないでください。

4. インポートして動作確認

   メイン画面で「サブスクリプショングループ」→「サブスクリプショングループの設定」を開き、信頼できる配布元のリンクを追加して更新します。ビルドによってボタンの表示名が多少異なる場合があるため、画面上の表示を確認してください。

インストールに成功したのにメニューに項目がない場合は、パッケージにデスクトップファイルが含まれているか確認してください。次のコマンドは、package_file変数が設定された同じターミナルで実行します。新しいターミナルを開いた場合は、先にファイルパスを読み込み直してください。

package_name=$(dpkg-deb -f "$package_file" Package)
dpkg-query -W "$package_name"
dpkg-query -L "$package_name" | grep -E '/applications/[^/]+\.desktop$'

rpmのインストール：FedoraとopenSUSEでコマンドを使い分ける

rpmはパッケージ形式であり、同じ形式を使うディストリビューションの実行環境が同じとは限りません。まずパッケージ情報を確認し、ディストリビューションに応じたコマンドを一つ選んで実行してください。dnfとzypperを両方実行したり、依存関係チェックを省略してランタイム不足を隠したりしないでください。

read -r -p 'rpmファイルの絶対パスを入力してください：' package_file
rpm -qp --queryformat '%{NAME}\n%{VERSION}-%{RELEASE}\n%{ARCH}\n' "$package_file"

# Fedora：次のコマンドを実行
sudo dnf install "$package_file"

# openSUSE：こちらのコマンドを実行
sudo zypper install "$package_file"

• 依存関係を解決できない場合：不足しているパッケージ名を控え、現在のディストリビューションのリポジトリで提供されているか確認してください。システムのグラフィックライブラリや暗号ライブラリを安易に置き換えないでください。
• 配布元の信頼性に関する注意：パッケージ管理ツールの警告を読み、ファイルの配布元を確認してください。全体的な検証を無効にする方法を通常のインストール手順として使わないでください。
• インストール直後に終了する場合：アプリのデスクトップファイルで実際の起動コマンドを確認し、ターミナルから実行してエラーを調べてください。既存の引数はそのまま使い、実行ファイルが特定の固定ディレクトリにあると決めつけないでください。

インストール後は、パッケージに含まれるアプリの起動項目を確認できます。ここで確認するのはインストール済みファイルの一覧です。インストール処理に失敗した場合は、先に問題を解決してください。自動起動の設定はその後に行います。

package_name=$(rpm -qp --queryformat '%{NAME}' "$package_file")
rpm -q "$package_name"
rpm -ql "$package_name" | grep -E '/applications/[^/]+\.desktop$'

初回接続：待ち受けを確認してからシステムプロキシを設定

サブスクリプションのインポート、コアの起動、アプリによるプロキシ利用は、それぞれ別の段階です。利用権限のあるサーバーを選び、ログでコアの起動結果を確認してください。「設定」→「パラメーター設定」を開き、ローカルの待ち受けアドレス、ポート、プロトコルを確認します。設定項目の場所はクライアントのバージョンによって変わるため、実際の設定内容と待ち受け状態を基準にしてください。

以下のポート番号は設定例であり、すべてのバージョンの初期値を示すものではありません。単一の混合ポートを使う設定もあれば、HTTPとSOCKSを別々に待ち受ける設定もあります。実際に該当ポートで待ち受けていることを確認してから設定してください。ローカルのデスクトップで使う場合は通常、ループバックアドレスのままにし、すべてのネットワークインターフェースで待ち受ける必要はありません。

# 実際のポートに合わせて条件を調整
ss -lntp | grep -E ':(10808|10809)[[:space:]]'

# 対応するプロキシプロトコルとポートを確認してからテスト
curl --proxy http://127.0.0.1:10809 --head --max-time 15 https://example.com/
curl --proxy socks5h://127.0.0.1:10808 --head --max-time 15 https://example.com/

socks5hは、接続先ドメインの名前解決をプロキシ側で行う指定です。HTTPレスポンスが返れば今回のリクエストが接続先に到達したと判断できますが、すべてのルーティング規則や名前解決経路が正しいとは限りません。接続拒否と表示された場合は、待ち受け状態とコアのログを優先して確認してください。ローカル接続は確立するもののタイムアウトする場合は、サーバー、通信パラメーター、ネットワークを調べます。

GNOMEとKDE：システムプロキシが適用される範囲

デスクトップのシステムプロキシは、アプリが参照する設定であり、すべての通信を透過的にプロキシへ転送する機能ではありません。ブラウザー、デスクトップコンポーネント、ターミナルのプログラムでは、プロキシ設定の読み取り方が異なる場合があります。まずプロキシに対応していることが明確なアプリでテストし、その後ほかのアプリにも適用してください。システム設定、ブラウザー設定、環境変数を同時に変更すると、原因の切り分けが難しくなります。

GNOMEで手動プロキシを設定

「設定」→「ネットワーク」→「ネットワークプロキシ」を開き、「手動」を選択します。HTTPとHTTPSにはHTTP CONNECTに対応するローカルHTTPプロキシを、SOCKSにはSOCKSの待ち受けポートを入力してください。HTTPSの項目は、ローカルプロキシの接続にTLSが必須という意味ではありません。設定場所はディストリビューションのカスタマイズによって異なる場合があります。次のコマンドで設定することもできます。

# 元の値を控えて復元できるようにする。現在のデスクトップユーザーのターミナルで実行
gsettings get org.gnome.system.proxy mode
gsettings list-recursively org.gnome.system.proxy.http
gsettings list-recursively org.gnome.system.proxy.https
gsettings list-recursively org.gnome.system.proxy.socks

# 例のポートが実際の待ち受けポートと一致する場合のみ実行
gsettings set org.gnome.system.proxy.http host '127.0.0.1'
gsettings set org.gnome.system.proxy.http port 10809
gsettings set org.gnome.system.proxy.https host '127.0.0.1'
gsettings set org.gnome.system.proxy.https port 10809
gsettings set org.gnome.system.proxy.socks host '127.0.0.1'
gsettings set org.gnome.system.proxy.socks port 10808
gsettings set org.gnome.system.proxy mode 'manual'

# 手動のシステムプロキシを使わない場合
gsettings set org.gnome.system.proxy mode 'none'

KDE Plasmaで手動プロキシを設定

「システム設定」を開き、「プロキシ」を検索して設定画面へ進み、「手動で指定したプロキシ設定を使用」を選択します。実際のHTTP、HTTPS、SOCKSの接続先を入力して適用してください。KDEの設定を参照するのは、主にデスクトップのプロキシ機構に対応したソフトです。ブラウザー独自の設定がある場合もあり、ターミナルツールには個別の設定が必要です。クライアントを終了する前にプロキシを無効にし、閉じたローカルポートへアプリが接続し続けないようにしてください。

• ブラウザーでシステムプロキシを選んでも適用されない場合は、拡張機能や個別のプロキシ設定が優先されていないか確認してください。
• curlの明示的なプロキシテストは成功するのに通常のリクエストが失敗する場合は、クライアントを再インストールする前に、アプリがどのプロキシ設定を参照しているか確認してください。
• クライアントと手動スクリプトの両方でシステムプロキシを繰り返し変更しないでください。設定方法を一つに決めてから動作を確認しましょう。

自動起動の設定：システムサービスではなく、デスクトップへのログイン後に起動

デスクトップクライアントの「起動時に自動起動」は、通常、グラフィカルデスクトップへのユーザーログイン後に起動することを指します。ログイン前からプロキシを提供する設定ではありません。デスクトップセッションのXDG Autostart機構を使い、インストールパッケージが用意した起動項目を利用するのがおすすめです。実行ファイルの正しいパスと引数を維持し、推測でExec行を作らないでください。

1. 重複する起動設定を無効にする

   クライアントの「設定」→「パラメーター設定」で自動起動の項目があるか確認してください。以下の手動設定を使う場合は、二重起動を防ぐため先にその項目を無効にします。

2. デスクトップファイルの場所を確認

   前述のパッケージファイル一覧のコマンドを使い、実際の.desktopファイルのパスを探します。まずアプリメニューから正常に起動できることを確認してから、そのパスを下のコピーコマンドに入力してください。

3. ユーザー用の起動項目をコピー

   デスクトップファイルを現在のユーザーのautostartディレクトリにコピーします。システム全体の起動項目は変更しません。この操作にsudoは不要です。

4. 再ログインして確認

   クライアントを終了してデスクトップからログアウトし、再ログイン後にウィンドウまたはバックグラウンドプロセス、ポートの待ち受け、システムプロキシを確認します。トレイアイコンだけでコアの動作を判断しないでください。

read -r -p 'インストール済み.desktopファイルの絶対パスを入力してください：' desktop_file
grep -E '^(Type|Name|Exec|TryExec|Hidden|OnlyShowIn|NotShowIn)=' "$desktop_file"

autostart_dir="${XDG_CONFIG_HOME:-$HOME/.config}/autostart"
mkdir -p "$autostart_dir"
cp -- "$desktop_file" "$autostart_dir/v2rayn-login.desktop"

コピーの前後にType=ApplicationとExec=を確認してください。Hidden=trueがある場合や、OnlyShowInまたはNotShowInによって現在のデスクトップが対象外になっている場合は、テキストエディターでユーザーディレクトリ内のコピーを修正します。システム側の元ファイルは変更しないでください。GNOMEではトレイアイコンが表示されない場合もあるため、プロセス、ログ、待ち受け状態を確認してください。

KDEでは「システム設定」で「自動起動」を検索し、「アプリケーションを追加」からv2rayNを選ぶ方法もあります。手動コピーとどちらか一方を使えば十分です。GUIアプリをシステムサービスに直接登録しないでください。サービスには通常、完全なデスクトップセッション環境がなく、ウィンドウやユーザー設定の保存先に問題が生じることがあります。

# この記事の手順で作成したログイン時の自動起動項目を削除
autostart_dir="${XDG_CONFIG_HOME:-$HOME/.config}/autostart"
rm -f -- "$autostart_dir/v2rayn-login.desktop"

よくある問題：アップデート、起動失敗、プロキシ設定の残存

導入後の確認は決まった順番で進めます。パッケージ管理ツールでインストール完了を確認し、アプリメニューから起動できること、サブスクリプションとコアのログが正常であること、ローカルプロキシのテストが成功すること、対象アプリがプロキシを使うことを確認します。最後にログアウトして自動起動を検証してください。アップグレード前に、クライアントのバックアップ機能または実際のデータディレクトリを使って設定を保存します。サブスクリプションURLや設定にアクセス情報が含まれる場合があるため、トラブルシューティングのスクリーンショットで公開しないでください。