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

Debian・UbuntuとFedora・openSUSE向けに、v2rayNのインストールや依存関係の確認、デスクトップのショートカット作成、ログイン時の自動起動設定を解説します。

この記事の概要

Linuxのデスクトップ環境にv2rayNをインストール、または移行する方向けです。まずディストリビューション、パッケージのアーキテクチャ、依存関係を確認します。次にアプリケーションメニューから起動できることを確かめ、動作確認済みのデスクトップエントリーを使ってログイン時の自動起動を設定します。ここで説明する自動起動はデスクトップへのログイン後に行われるもので、ログイン画面が表示される前にシステムサービスとして起動する設定ではありません。

debとrpmの選び方:ディストリビューションとアーキテクチャを確認

まずcat /etc/os-releaseを実行してディストリビューションとバージョンを確認し、続いてuname -mでマシンのアーキテクチャを調べます。Debian系ではdpkg --print-architectureでパッケージ管理ツールが使うアーキテクチャ名を確認できます。RPM系ではrpm --eval '%{_arch}'を実行してください。ファイル名のx64、amd64、x86_64は同じ種類のマシンを指すことが多いものの、互換性はパッケージ管理ツールがパッケージヘッダーの情報に基づいて判定します。

Debian / Ubuntu

パッケージ形式
.deb
64ビット x86 のパッケージアーキテクチャ
amd64
64ビット ARM のパッケージアーキテクチャ
arm64
ローカルパッケージのインストール
apt install ./ファイル名.deb

APTでローカルパッケージをインストールします。有効になっているリポジトリから、解決可能な依存関係もインストールされます。

Fedora / openSUSE

パッケージ形式
.rpm
64ビット x86 のパッケージアーキテクチャ
x86_64
64ビット ARM のパッケージアーキテクチャ
aarch64
ローカルパッケージのインストール
FedoraではDNF、openSUSEではZypperを使用

同じRPM形式でも、依存関係に互換性があるとは限りません。対象のディストリビューションとバージョンを確認してください。

アーキテクチャ名が一致していても、そのバージョン向けのビルドが提供されているとは限りません。ダウンロードページに対応パッケージがない場合、拡張子を変更したり、アーキテクチャのチェックを強制的に無視したりしてインストールしないでください。同じディストリビューションとバージョン向けのアーカイブがある場合は、そのビルドの手順に従い、ユーザー用の固定ディレクトリに配置します。後で作成するデスクトップエントリーに、一時展開ディレクトリを指定しないでください。

パッケージ管理ツールでインストールし、依存関係を解決する

  1. パッケージヘッダーを確認

    インストールパッケージのあるディレクトリで、debはdpkg-deb -f ファイル名.deb Package Version Architecture Depends、rpmはrpm -qp --qf '%{NAME} %{VERSION}-%{RELEASE} %{ARCH}\n' ファイル名.rpmを実行します。コマンド内のファイル名は実際にダウンロードした名前に置き換えてください。パッケージ名を控えておきましょう。アプリケーションメニューに表示されるv2rayNとは異なる場合があり、後でインストール済みファイルを調べる際に必要です。

  2. ローカルパッケージをインストール

    DebianまたはUbuntuでは、まずsudo apt updateを実行し、続いてsudo apt install ./ファイル名.debを実行します。Fedoraではsudo dnf install ./ファイル名.rpm、openSUSEではsudo zypper install ./ファイル名.rpmを使います。パッケージ管理ツールにローカルパスとして認識させるため、./を付けてください。実際のファイル名に空白が含まれる場合は、パス全体を引用符で囲みます。

  3. 依存関係を確認

    インストーラーで依存関係の不足が報告されたら、不足しているパッケージ名やライブラリ名、必要な最低バージョンを控えます。APTではDependsを確認し、RPMではrpm -qpR ファイル名.rpmで依存関係の宣言を調べてください。現在のディストリビューションのリポジトリで必要な依存関係が提供されているか確認してから、別のビルドが必要か判断します。異なるディストリビューションのリポジトリを混在させたり、依存関係を無視するオプションでインストールしたりしないでください。

  4. 手動で起動

    現在のユーザーのアプリケーションメニューでv2rayNを検索します。ウィンドウが開き、終了後にもう一度起動できることを確認してから、サブスクリプションとシステムプロキシを設定してください。システムパッケージのインストールには管理者権限を使いますが、クライアントの日常的な実行にはデスクトップにログインしているアカウントを使いましょう。管理者のホームディレクトリに設定ファイルが作成されたり、現在のユーザーが書き込めないファイルが作られたりするのを防げます。

アプリケーションメニュー、デスクトップショートカット、起動コマンド

インストールパッケージによっては.desktopファイルが登録されます。先ほど控えたパッケージ名を使ってdpkg -L パッケージ名またはrpm -ql パッケージ名を実行し、出力から.desktopファイルを探してください。見つかったらName、Exec、既存のTryExecを確認します。ファイル名から実際の起動コマンドを推測しないでください。デスクトップ環境によってはトレイアイコンが表示されないため、ウィンドウやプロセス、ログも併せて確認して起動を判断します。

パッケージのエントリーを再利用

おすすめ

登録済みのアプリケーションメニュー項目を使う方法をおすすめします。ショートカットを常に表示したい場合は、デスクトップ環境の機能でタスクバーやお気に入りに追加してください。実行ファイルのパスはインストールパッケージによって管理されます。

適用条件:debまたはrpmをインストール済みで、アプリケーションメニューから正常に起動できる。

ユーザー用エントリーを作成

${XDG_DATA_HOME:-$HOME/.local/share}/applicationsにv2rayn-local.desktopを作成します。[Desktop Entry]、Type=Application、Name=v2rayN、Terminal=falseを記述し、Execには動作確認済みの実行ファイルのパスを指定してください。実行ファイルのパスに空白が含まれる場合は、パス全体を二重引用符で囲みます。~や$HOMEは使わないでください。デスクトップエントリーでは、対話型シェルのように展開されません。

適用条件:アーカイブ版を使う場合、または現在のビルドにアプリケーションメニュー項目がない場合。

デスクトップにアイコンを置く場合は、まずxdg-user-dir DESKTOPを実行し、現在のユーザーのデスクトップパスを確認します。ディレクトリ名がDesktopとは限りません。デスクトップ環境がデスクトップアイコンに対応し、コマンドの出力先が実際のデスクトップディレクトリである場合に限り、動作確認済みのエントリーをコピーし、デスクトップの案内に従って起動を許可してください。デスクトップ上のファイルが標準では表示されない環境では、アプリケーションメニュー項目をそのまま使えます。

ログイン時の自動起動を設定し、プロキシの状態を確認

自動起動の登録方法は1つだけにしてください。現在のビルドで「設定」→「パラメーター設定」にログイン時の起動オプションがある場合は、それを使ってログアウト後に動作を確認できます。オプションがない場合は、デスクトップ環境がサポートするXDG自動起動ディレクトリを使います。以下に示すパスは、デスクトップエントリー、自動起動エントリー、ローカルのリスニングポートを区別するためのものです。これらは互いに置き換えられません。

10808
ローカルのリスニングポートの例。実際の値はパラメーター設定を確認してください
1
同じクライアントに設定する自動起動元の数
  1. mkdir -p "${XDG_CONFIG_HOME:-$HOME/.config}/autostart"を実行します。前の手順で動作確認した.desktopファイルを、このディレクトリにコピーしてください。sudoは不要です。デスクトップクライアント用のシステムサービスを作成する必要もありません。
  2. コピーしたエントリーのExecとTryExecが現在のインストール先を指していることを確認します。Hidden=true、OnlyShowIn、NotShowInがある場合は、エントリーが無効化されていないか、現在のデスクトップ環境が対象外になっていないかを確認してください。ExecにファイルやURL用の引数フィールドが含まれている場合、自動起動用のコピーには、動作確認済みの通常の起動コマンドを指定し、ファイルやURLを渡さないでください。
  3. クライアントを終了し、同じデスクトップアカウントでログアウトしてから再ログインします。手動で起動する前に、プログラムがすでに起動しているか確認してください。次に「設定」→「パラメーター設定」でローカルのリスニングポートを確認します。実際のポートが10808の場合は、ss -ltn 'sport = :10808'でリスニング状態を確認できます。ポートが使用中の場合は、ss -ltnp 'sport = :10808'を実行して該当プロセスを確認してください。
  4. 最後にシステムプロキシの状態と、対象アプリがプロキシを使っているかを確認します。ポートで待ち受けているプロセスがあっても、ブラウザーがプロキシ経由で通信していることや、ルーティングルールで想定したアウトバウンドが選ばれていることを意味しません。まずは以前手動で動作確認したノードとアプリを使い、サブスクリプション、ポート、ルーティングを同時に変更しないでください。

Linuxへの導入でよくある質問

ローカルパッケージをインストールできず、依存関係のバージョンが古いと表示される場合は?

cat /etc/os-releaseを実行して、ビルドの対象ディストリビューションを確認します。Debian系ではapt-cache policy パッケージ名で候補バージョンを調べてください。ディストリビューションのリポジトリに必要なバージョンがない場合は、現在の環境に対応するビルドに切り替えるか、ディストリビューションを通常の手順でアップグレードします。システム共有ライブラリを置き換えると、同じライブラリに依存する他のプログラムに影響することがあります。

メニューから起動できるのに、ログアウトして再ログインすると起動しない場合は?

実際のXDG_CONFIG_HOMEを確認し、エントリーがapplicationsだけでなく、そのアカウントのautostartディレクトリにも置かれていることを確認します。自動起動用コピーのパスと、デスクトップ環境を制限するフィールドも確認してください。独自のコマンドが端末起動スクリプトで設定される環境変数に依存している場合は、インストールパッケージのエントリーか、デスクトップセッション内で単独実行できるコマンドに切り替えます。

ログイン後に二重起動する場合や、アップデート後に起動エラーが出る場合は?

デスクトップ環境の自動起動一覧とユーザーの自動起動ディレクトリを確認し、クライアント内蔵の設定と手動で作成したエントリーが重複していないか調べます。アップデート後は、パッケージに含まれるデスクトップエントリーを再確認してください。手動コピーが古い場所を指している場合は、動作確認済みの新しいエントリーに置き換えます。手動設定の自動起動を無効にするには、自動起動ディレクトリ内のコピーだけを削除し、アプリケーションメニューのエントリーは残してください。

v2rayN をダウンロード