UbuntuとDebianではdeb、Fedoraではrpmを選びます。管理者権限が必要なのはインストール時だけです。初回起動は普段使っているデスクトップアカウントで行い、ローカルプロキシが使えることを確認してから、システムプロキシとログイン時の自動起動を設定します。以下では、インストールコマンドやポートの確認方法、アプリメニューからは起動できてもログイン後に起動しない場合の対処法を紹介します。
Linuxのインストールパッケージの選び方:ディストリビューションとCPUアーキテクチャ
まずディストリビューション、次にアーキテクチャを確認します。端末で次の2つのコマンドを実行してください。1つ目でディストリビューションとバージョン、2つ目でマシンのアーキテクチャを確認できます。UbuntuとDebianでは、パッケージのメタデータ上でx86_64はamd64、aarch64はarm64と表記されるのが一般的です。Fedoraでは通常、x86_64とaarch64が使われます。ダウンロードページのx64は前者を指します。
cat /etc/os-release
uname -m
Debian系のパッケージ
- デスクトップディストリビューション
- Ubuntu、Debian
- ファイル拡張子
.deb- パッケージのアーキテクチャ表記
amd64またはarm64- インストールツール
apt
aptでローカルパッケージをインストールすると、ソフトウェアリポジトリから入手できる依存関係もあわせて処理できます。
Fedora用パッケージ
- デスクトップディストリビューション
- Fedora
- ファイル拡張子
.rpm- パッケージのアーキテクチャ表記
x86_64またはaarch64- インストールツール
dnf
rpm形式が同じでも、依存関係まで同じとは限りません。他のディストリビューションでは、パッケージの互換性を個別に確認してください。
アーキテクチャの不一致が明示された場合は、ダウンロードページに戻って適切なパッケージを選び直してください。強制インストールは避けましょう。アーキテクチャが合っているのにライブラリ不足のエラーが出る場合は、最初に解決できない依存パッケージとそのバージョンを控え、現在のディストリビューションとバージョンに対応したリポジトリを確認します。別のディストリビューションから同名のライブラリだけを持ち込まないでください。
deb・rpmのインストールコマンド
以下のうち、使用しているディストリビューションに対応する方だけを実行してください。入力プロンプトが表示されたら、ダウンロードしたパッケージの絶対パスを貼り付けます。入力するパスを引用符で囲む必要はありません。インストールコマンド内の二重引用符が、パスに含まれるスペースを処理します。まずパッケージのメタデータで名前、バージョン、アーキテクチャを確認してから、sudoを使うインストールコマンドを実行してください。
Ubuntu・Debian:aptでdebをインストール
printf 'debパッケージの絶対パスを入力:'
IFS= read -r pkg
dpkg-deb -f "$pkg" Package Version Architecture
sudo apt install "$pkg"
端末に依存パッケージのダウンロード失敗と表示された場合は、まずプロキシを無効にした状態でシステムのリポジトリにアクセスできることを確認します。その後、sudo apt updateを実行してから再試行してください。インストール計画に既存のデスクトップコンポーネントの削除が含まれている場合は、いったん中止し、異なるディストリビューションやバージョンのリポジトリが混在していないか確認します。
Fedora:dnfでrpmをインストール
printf 'rpmパッケージの絶対パスを入力:'
IFS= read -r pkg
rpm -qp --queryformat '%{NAME} %{VERSION}-%{RELEASE} %{ARCH}\n' "$pkg"
sudo dnf install "$pkg"
インストールが終わったら、アプリケーションメニューで「v2rayN」を検索します。端末にパッケージがインストール済みと表示されても、インストールが完了したことを示すだけで、GUIやコアが起動しているとは限りません。メニューに項目がない場合は、上で確認したパッケージ名を使います。Ubuntu・Debianではdpkg -L、Fedoraではrpm -qlの後にパッケージ名を指定し、パッケージに含まれる.desktopファイルとインストール先を確認してください。
初回起動時の権限とシステムプロキシの確認
まず通常のデスクトップアカウントでv2rayNを起動し、TUNは有効にせず、sudoでGUIを開かないでください。ソフトウェアのインストールには管理者権限が必要ですが、通常、個人設定の読み書きやローカルプロキシの実行には必要ありません。起動ログにPermission deniedと表示された場合は、エラーの対象がユーザー設定ファイルなのか、コアの実行ファイルのパスなのかを確認します。インストールディレクトリ全体の権限を再帰的に変更しないでください。
使用するノードを選択
設定済みの場合は、メイン画面のノード一覧からノードを選び、右クリックして「アクティブサーバーに設定」を選択します。新規インストールで一覧が空の場合は、まず「サブスクリプショングループ」からサブスクリプションを追加して更新してください。その後、メイン画面のログでコアの起動エラーがないことを確認します。
待ち受けポートを確認
「設定」→「パラメーター設定」を開き、「ローカル待ち受けポート」とローカルのインバウンド設定を確認します。項目名はバージョンによって多少異なる場合があります。画面に表示されている実際のポートを使い、ノードサーバーのリモートポートをローカルアプリに設定しないでください。
ローカルプロキシをテスト
まず端末からローカルプロキシを明示してリクエストし、コアの接続問題とデスクトップのプロキシ設定の問題を切り分けます。以下のコマンドでは混合インバウンドポート
10808を例にしています。バージョンによってHTTPとSOCKSのポートが分かれている場合は、インバウンドのプロトコルと実際のポートに合わせてください。システムプロキシを設定
v2rayNのメイン画面下部またはトレイから「システムプロキシ」を開き、「システムプロキシを自動設定」を選択します。GNOMEでは「設定」→「ネットワーク」→「ネットワークプロキシ」で設定内容を確認できます。デスクトップ側の設定が変わらない場合は、対象アプリのプロキシ設定を使ってください。コアを何度も再起動する必要はありません。
ss -ltn 'sport = :10808'
curl --max-time 15 -I --proxy socks5h://127.0.0.1:10808 https://example.com/
1つ目のコマンドでは、ローカルのTCPポートが待ち受け中かどうかだけを確認します。2つ目のコマンドで接続先サイトのHTTPレスポンスヘッダーを受信できれば、指定したプロキシ経由でアクセスできたことがわかります。ローカルポートへの接続にすぐ失敗する場合は、ポート番号とコアのログを確認してください。ポートが待ち受け中なのにタイムアウトする場合は、使用中のノード、ネットワーク、ルーティングを確認します。ブラウザーでは使えて端末では使えなくても、インストール失敗とは限りません。端末のプログラムはデスクトップのプロキシ設定を参照しないことが多いため、アプリごとにプロキシを指定してください。
ログイン時にv2rayNを自動起動する設定
デスクトップ版の自動起動は通常、グラフィカルセッションへのログイン後に起動する設定です。ログイン画面が表示される前に起動するわけではありません。まずアプリケーションメニューからv2rayNが正常に開くことを確認し、以下の2つの方法からどちらか1つを選んでください。複数の方法を設定すると、1回のログインで何度も起動し、停止やトラブルの原因特定も難しくなります。
デスクトップ環境の自動起動設定
おすすめKDE Plasmaでは「システム設定」を開いて「自動起動」を検索し、「追加」→「アプリケーションを追加」を選んで、一覧からv2rayNを選択します。Ubuntuのアプリケーションメニューに「自動起動するアプリケーション(Startup Applications)」がある場合は、「追加」を選び、実際に起動できることを確認したコマンドを入力してください。メニュー名はデスクトップ環境のバージョンによって異なる場合があります。
おすすめのケース:デスクトップに自動起動の管理機能があり、GUIから手軽に有効・無効を切り替えたい場合。
ユーザー単位のXDG自動起動エントリー
インストール済みパッケージのファイル一覧から、アプリケーションメニューに対応する.desktopファイルを見つけ、現在のユーザーの自動起動ディレクトリにコピーします。他の環境のインストール先を参考に手入力するより、元のExec=起動コマンドをそのまま使う方が確実です。
おすすめのケース:デスクトップ環境がXDG自動起動に対応しているものの、使いやすいGUI設定がない場合。
ファイルを使う場合は、端末で以下のコマンドを実行し、確認済みの.desktopファイルの絶対パスを入力してください。sudoは付けないでください。XDG_CONFIG_HOMEを変更していない場合、自動起動ディレクトリは~/.config/autostartです。
printf 'インストール済み.desktopファイルの絶対パスを入力:'
IFS= read -r desktop_file
autostart_dir="${XDG_CONFIG_HOME:-$HOME/.config}/autostart"
mkdir -p "$autostart_dir"
cp -i -- "$desktop_file" "$autostart_dir/"
いったんログアウトして再ログインします。先にv2rayNを手動で起動しないでください。デスクトップの読み込みが終わったら、トレイ、ウィンドウ、またはローカルの待ち受けポートを確認します。ウィンドウが表示されてもWebページがプロキシ経由にならない場合は、システムプロキシの状態を確認してください。アプリの起動とプロキシ設定の反映は別の操作です。ファイル方式の自動起動を解除するには、現在のユーザーの自動起動ディレクトリにあるコピーだけを削除します。アプリケーションメニューの項目は残ります。
Linuxのインストールと自動起動に関するよくある質問
インストールしたのに、メニューから起動できない場合
まず、パッケージ内の.desktopファイルにあるExec=の実行先を確認します。command -v v2rayNを実行し、その名前が検索パスにあるか調べる方法もあります。見つからない場合は、パッケージのファイル一覧から実際の実行ファイルを探し、通常のユーザーで端末から起動してエラーを確認してください。共有ライブラリが見つからないというエラーが出た場合は、管理者権限で再起動せず、ライブラリ名とディストリビューションのバージョンに基づいて依存関係を確認します。
手動では起動するのに、再ログイン後に起動しない場合
まず、自動起動項目を追加したときと同じユーザーでログインしているか確認してください。次に、ユーザーディレクトリ内の.desktopファイルを開き、Hidden=true、OnlyShowIn、NotShowInによる制限がないか確認します。パッケージを最近アップグレードした場合は、アプリケーションメニューで現在使われているファイルと照らし合わせ、コピー内のExec=が古い場所を指していないか確認してください。
ログにポートが使用中と表示された場合
ss -ltnp 'sport = :10808'を実行して例のポートを確認します。実際のポートが異なる場合は、数字を置き換えてください。まず、v2rayNを重複して起動していれば終了します。別の正常なプログラムがポートを使用している場合は、「設定」→「パラメーター設定」でローカル待ち受けポートを変更し、手動で設定したブラウザーや端末のプロキシもあわせて更新してください。
アプリを終了した後、ブラウザーでWebページを開けない場合
自動設定を有効にしていた場合は、終了前に「システムプロキシ」から「システムプロキシを解除」を選択してください。すでに終了している場合は、デスクトップのネットワークプロキシ設定を開き、有効にする前の状態に戻します。ブラウザーにプロキシを手動で設定していた場合は、ブラウザー側の設定も戻してください。設定を戻さないと、すでに停止したローカルポートへの接続を続けることがあります。