Linuxのデスクトップ環境にv2rayNを初めて導入する方向けです。ディストリビューションとCPUアーキテクチャに合ったパッケージを選び、一般ユーザーで起動してサブスクリプションを追加し、ローカルプロキシを確認します。手動起動で動作を確認してから、同じアプリの起動項目をログイン時に実行するよう設定し、GNOMEまたはKDEのプロキシ設定が対象アプリに反映されるか確認しましょう。
インストールパッケージの選び方:ディストリビューションとCPUアーキテクチャ
ターミナルで cat /etc/os-release を実行してディストリビューションを、uname -m でCPUアーキテクチャを確認します。出力が x86_64 の場合、ダウンロード項目では x64、debパッケージのメタデータでは amd64 と表記されることがあります。aarch64 の場合は、対応するARM64ビルドを選びます。拡張子が合っていても、アーキテクチャや使用中のディストリビューションのバージョンに対応しているとは限りません。
ディストリビューション向けパッケージ
おすすめDebianとUbuntuではdeb、FedoraとopenSUSEではディストリビューションに対応したrpmを選びます。パッケージマネージャーを使うと、宣言済みの依存関係を確認でき、アプリがインストールしたファイルも管理できます。
適しています:ダウンロードページに対応アーキテクチャのパッケージがあり、必要な依存関係をローカルのリポジトリから導入できる環境
アーカイブからインストール
ダウンロードページに対応アーキテクチャのアーカイブがある場合は、ホームディレクトリ内の決まった場所に展開できます。ただし、システムライブラリへの依存が残ることがあり、デスクトップの起動項目も手動で追加する場合があります。
適しています:ホームディレクトリ内でアプリを管理し、実行環境との互換性を確認済みの場合
deb/rpmパッケージのインストールコマンド
ターミナルでインストールパッケージのあるディレクトリに移動し、以下のコマンドにある例のファイル名 v2rayN.deb または v2rayN.rpm を実際のファイル名に置き換えてください。先頭の ./ は、現在のディレクトリにあるファイルを指定するため、そのまま残します。使用するコマンドはディストリビューションに合わせて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" でdebのメタデータを、rpm -qpR "./v2rayN.rpm" でrpmが宣言する依存関係を確認できます。依存関係を無視して強制インストールしないでください。不足しているランタイムライブラリは補われません。
初回起動:デスクトップの起動項目、サブスクリプション、待ち受けポート
アプリを起動する
GNOMEのアプリ一覧またはKDE Plasmaのアプリケーションランチャーで「v2rayN」を検索し、一般ユーザーとして起動します。見つからない場合は、パッケージ内に
.desktopファイルがあるか確認してください。起動コマンドとアプリの表示名が同じとは限りません。サブスクリプションを追加する
メインウィンドウで「サブスクリプショングループ」→「サブスクリプショングループの設定」を開き、グループを追加してサブスクリプションURLを入力し、保存します。「+」ボタンがある画面では、グループ一覧から直接追加することもできます。続いて「サブスクリプショングループ」メニューから更新します。利用できるノードがまだない場合は、まずプロキシを使わずに更新する項目を試してください。
ノードを選択する
更新したグループに切り替え、候補のノードを右クリックして「アクティブサーバーに設定」を選びます。ノードが一覧に表示されても、確認できるのはインポートが成功したことだけです。メインウィンドウのログを見て、コアが起動直後に終了していないことも確認してください。
ローカルポートを確認する
「設定」→「パラメーター設定」を開き、ローカルの待ち受けポートを確認します。現在のコアが個別ポートと混合ポートのどちらを使っているかを確認し、
ss -ltnで該当するTCPポートが待ち受け中か調べます。初回の動作確認ではTUNをオフにし、仮想ネットワークインターフェースの問題とプロキシポートの問題を切り分けてください。
ポート番号だけでプロトコルを判断しないでください。SOCKSで待ち受けている場合は、アプリのSOCKS欄に設定します。HTTP欄には、実際にHTTPに対応したポートを入力してください。ログにアドレスが使用中と表示されたら、まず ss -ltnp で現在のユーザーから確認できる待ち受けプロセスを調べます。二重起動か、別のアプリが使用中かを確認してから、古いプロセスを終了するかポートを変更してください。変更後は、手動で設定したプロキシアドレスも更新します。
自動起動:デスクトップへのログイン後に起動
デスクトップアプリの自動起動は、通常、グラフィカルセッションへのログイン後に実行する設定であり、ログイン画面が表示される前に起動する設定ではありません。まずアプリメニューから正常に起動できることを確認し、クライアント内蔵の自動起動機能か、デスクトップの自動起動項目のどちらか一方を設定します。両方に登録すると二重起動する場合があります。また、ログイン画面のままでは、自動起動に失敗したかどうかを判断できません。
- GNOME:動作確認済みのアプリ起動項目を、ユーザーの自動起動ディレクトリにコピーできます。システムの起動項目は通常
/usr/share/applications/、ユーザーの起動項目は通常~/.local/share/applications/にあります。まずmkdir -p ~/.config/autostartを実行して標準の自動起動ディレクトリを作成し、実際の.desktopファイルをそこにコピーします。XDG_CONFIG_HOMEを独自に設定している場合は、そのディレクトリ内のautostartを使ってください。 - KDE Plasma:「システム設定」を開き、「自動起動」または「Autostart」を検索して、「アプリケーションを追加」を選び、一覧からv2rayNを選択します。設定項目の分類はPlasmaのバージョンによって異なるため、固定のカテゴリを探すより、名前で検索するほうが確実です。
- 動作確認:ログアウトして再ログインし、アプリのウィンドウ、プロセス、またはローカルの待ち受けポートを確認します。手動では起動できるのに自動起動しない場合は、ユーザーの自動起動項目にある
Execが現在の実行ファイルを指しているか確認してください。アーカイブの展開先を移動したり、アップグレードでパスが変わったりした場合は特に注意が必要です。
GNOMEとKDEのシステムプロキシ設定
GNOME
- 設定画面
- 「設定」→「ネットワーク」→「ネットワークプロキシ」
- モード
- 手動
- アドレス
127.0.0.1、ポートはプロキシの種類に合わせて入力
変更前の設定を控えておきます。v2rayNがデスクトップのプロキシ設定を変更できている場合は、手動で別途設定する必要はありません。
KDE Plasma
- 設定画面
- 「システム設定」で「プロキシ」を検索
- モード
- プロキシを手動で設定
- アドレス
- HTTPとSOCKSは、それぞれの待ち受け設定に合わせて入力
保存後、対象アプリで動作を確認します。独自のプロキシ設定があるブラウザーは特に確認してください。
システムプロキシは、デスクトップセッションからアプリに渡される設定であり、システム全体の通信をプロキシ経由にするものではありません。ブラウザーで独自の手動プロキシを設定している場合は、その設定が使われます。ターミナルのツールも、環境変数やコマンドオプションだけを参照する場合があります。一方のアプリでは使えて、もう一方では使えない場合は、ノードの障害と決めつけず、それぞれがどの設定からプロキシを読み込むか確認してください。一部のアプリだけにプロキシを使う場合は、デスクトップの設定をそのままにして、対象アプリにローカルプロキシを設定できます。
インストール・自動起動のトラブル対処
インストール後、アプリメニューに表示されない
まず dpkg-deb -c "./v2rayN.deb" または rpm -qpl "./v2rayN.rpm" で、パッケージ内にデスクトップの起動項目があるか確認し、インストール処理が完了していることも確認します。起動項目があるのにメニューに反映されない場合は、ログアウトして再ログインしてください。パッケージに起動項目がない場合は、ファイル一覧から実際の実行ファイルを探して手動で起動します。
ログイン後にウィンドウが見えない。起動していない?
必ずしもそうとは限りません。まずローカルの待ち受けを確認し、次にアプリが起動時に最小化する設定になっていないか調べます。デスクトップ環境によってはトレイアイコンが表示されないため、ウィンドウが見えなくてもプロセスが動作していることがあります。待ち受けが確認できない場合は、アプリメニューから手動で一度起動し、ログイン時だけ問題が起きるか確認してください。
クライアント終了後にブラウザーでページを開けない場合の対処
GNOMEまたはKDEのプロキシ設定が、停止したローカルポートを指したままになっていないか確認します。設定が残っている場合は、変更前のデスクトッププロキシ設定に戻してください。以前プロキシを使っていなかった場合は、手動プロキシをオフにします。特定のブラウザーだけに問題がある場合は、ループバックアドレスとポートが独自に保存されていないか確認してください。