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,桌面入口不會像互動式 shell 一樣展開這些符號。

適用情況:使用封存檔套件,或目前建置版本未安裝應用程式選單項目。

若要將圖示放到桌面,先執行 xdg-user-dir DESKTOP 查詢目前使用者的桌面路徑,不要假設目錄名稱一定是 Desktop。只有在桌面環境支援桌面圖示,且命令回傳的確實是桌面目錄時,才複製已確認可用的入口,並依桌面環境提示允許啟動。有些桌面環境預設不顯示桌面檔案,這種情況保留應用程式選單項目即可。

設定登入後自動啟動並確認代理狀態

只保留一種自動啟動設定方式。若目前建置版本的「設定」→「參數設定」中有可用的登入啟動選項,可先使用該選項並登出測試;若沒有,則使用桌面環境支援的 XDG 自動啟動目錄。以下路徑用來區分桌面入口、自動啟動入口與本機監聽,三者用途不同,不能互相取代。

10808
本機監聽連接埠範例,實際值以參數設定為準
1
同一用戶端應保留的自動啟動來源數
  1. 執行 mkdir -p "${XDG_CONFIG_HOME:-$HOME/.config}/autostart"。將上一步確認可用的 .desktop 檔案複製到該目錄。無須使用 sudo,也不需要為圖形介面用戶端建立系統層級服務。
  2. 確認副本中的 Exec 和 TryExec 仍指向目前的安裝位置。若有 Hidden=true、OnlyShowIn 或 NotShowIn,請確認這些設定沒有停用入口或排除目前的桌面環境。若 Exec 含有檔案或網址參數欄位,自動啟動副本應改用已確認可用的一般啟動命令,不要傳入檔案或網址。
  3. 結束用戶端,再登出並登入同一個圖形桌面帳號。先不要手動開啟,確認程式是否已自行啟動;接著前往「設定」→「參數設定」確認本機監聽連接埠。若實際設定為 10808,可執行 ss -ltn 'sport = :10808' 檢查監聽狀態;若連接埠已被占用,可用 ss -ltnp 'sport = :10808' 嘗試確認所屬處理程序。
  4. 最後確認系統代理狀態,以及目標應用程式是否使用代理。存在監聽連接埠,只代表有處理程序接收本機連線,不代表瀏覽器已透過代理連線,也不代表路由規則選中了預期的出口。先用原本可手動運作的節點與應用程式測試,不要同時變更訂閱、連接埠和路由設定。

Linux 部署常見問題

本機套件無法安裝,提示相依套件版本太舊怎麼辦?

執行 cat /etc/os-release 確認建置版本的適用目標。Debian 系統可用 apt-cache policy 套件名稱 查看候選版本;若發行版的套件來源未提供所需版本,請改用適用於目前發行版的建置版本,或先正常升級發行版。替換系統共用程式庫,可能影響其他依賴同一程式庫的程式。

從選單可以啟動,登出再登入後卻沒有自動啟動?

查看實際的 XDG_CONFIG_HOME,確認入口位於該帳號的 autostart 目錄,而非只放在 applications。檢查自動啟動副本中的路徑與桌面限制欄位。若自訂命令依賴終端機啟動指令碼設定的環境變數,請改用安裝套件提供的入口,或可在桌面工作階段中獨立執行的命令。

登入後重複啟動,或升級後啟動時發生錯誤?

先查看桌面環境的自動啟動清單與使用者自動啟動目錄,避免用戶端內建設定和手動入口重複登記。升級後重新檢查套件提供的桌面入口;若手動建立的副本仍指向舊位置,請以已確認可用的新入口取代。若要停用手動設定的自動啟動,只需刪除自動啟動目錄中的副本,保留應用程式選單入口。

下載v2rayN