v2rayN Linux 桌面版安裝:deb/rpm 套件與登入自動啟動設定

提供 Debian/Ubuntu 與 Fedora/openSUSE 的安裝方式,說明相依套件、應用程式選單,以及如何透過 XDG 自動啟動目錄設定 v2rayN 隨登入啟動。

本文重點

本文適合想在 Linux 圖形桌面安裝 v2rayN 的使用者。先依發行版與 CPU 架構選擇套件,再透過系統套件管理器安裝,並以一般使用者身分從應用程式選單啟動 v2rayN。確認手動啟動正常後,再沿用套件提供的桌面入口設定登入時自動啟動,並分別確認用戶端程序與代理流量。

選擇套件:先確認發行版,再確認 CPU 架構

請在要執行 v2rayN 的系統上執行以下兩個指令。第一個會讀取發行版識別資訊,第二個會顯示系統架構。若實際執行環境是虛擬機器,請在虛擬機器內查詢,不要依照主機的規格選擇套件。

cat /etc/os-release
uname -m

Debian / Ubuntu

套件管理器
.deb
安裝工具
apt
確認架構
dpkg --print-architecture

套件中繼資料的 amd64 對應 x86_64,arm64 則對應 aarch64。

Fedora / openSUSE

套件管理器
.rpm
安裝工具
Fedora 使用 dnf,openSUSE 使用 zypper
架構名稱
x86_64 或 aarch64

副檔名相同不代表相依套件也相同;請一併確認發行說明列出的發行版與版本範圍。

64 位元
x86_64 架構位元數
10808
常見本機連接埠,實際值以用戶端顯示為準

安裝 deb 或 rpm:交由套件管理器處理相依套件

在終端機切換到安裝套件所在目錄。以下範例中的 ./v2rayN.deb 和 ./v2rayN.rpm 是本機檔名,執行時請換成實際檔名。保留 ./,明確指定要安裝的是目前目錄中的檔案。以下三個指令請依目前使用的發行版擇一執行。

# Debian / Ubuntu
sudo apt install ./v2rayN.deb

# Fedora
sudo dnf install ./v2rayN.rpm

# openSUSE
sudo zypper install ./v2rayN.rpm

發行版套件管理器

建議

從本機檔案讀取相依需求,並在已啟用的套件庫中尋找符合條件的版本。確認交易前,可以先查看將新增、升級或移除哪些套件。

適用情境:首次安裝、升級現有版本

底層套件工具

使用 dpkg-deb -I ./v2rayN.deb 或 rpm -qpR ./v2rayN.rpm 查看套件中繼資料或相依項目。直接使用底層工具安裝時,不會像上方的套件管理器一樣從套件庫補齊相依套件。

適用情境:查看套件宣告、找出缺少的相依項目

如果 Debian 或 Ubuntu 顯示找不到相依套件,請先執行 sudo apt update,再重新執行原本的安裝指令。如果提示某個程式庫版本不符合需求,請記下錯誤訊息中的程式庫名稱與最低版本,並確認套件是否支援目前的發行版版本。請勿強制忽略相依問題來完成安裝。若先前使用 dpkg 留下尚未設定的套件,執行 sudo apt --fix-broken install 時請先檢查交易摘要:若套件庫無法滿足相依需求,修復方案可能是移除該套件,而非安裝它。

從應用程式選單啟動:尋找入口並排除問題

  1. 搜尋應用程式

    安裝完成後,請在 GNOME 的應用程式搜尋或 KDE Plasma 的應用程式啟動器中搜尋「v2rayN」,並先以目前的桌面使用者身分啟動一次。安裝指令需要管理員權限,但開啟圖形用戶端不必使用管理員權限。

  2. 查看套件檔案清單

    若選單中找不到應用程式,Debian 系統可使用 dpkg-query -L 搭配已安裝的套件名稱,RPM 系統則使用 rpm -ql 搭配已安裝的套件名稱。套件名稱可分別透過 dpkg-deb -f ./v2rayN.deb Package 或 rpm -qp --qf '%{NAME}\n' ./v2rayN.rpm 查詢。清單中的 .desktop 檔案才是接下來要找的桌面入口,請勿將安裝套件檔名當成啟動指令。

  3. 查看桌面入口欄位

    開啟桌面入口檔案,確認 Name 和 Exec。若有 NoDisplay=true,代表入口可能存在,但不會顯示在應用程式選單中;若有 TryExec,也請確認指定的程式存在且可執行。不要直接編輯系統目錄中的入口,因為軟體套件更新時可能會覆蓋修改內容。

  4. 檢查啟動訊息

    若圖示出現但點擊後沒有視窗,請先確認系統匣是否已有執行中的實例,再從圖形工作階段的終端機以一般使用者身分啟動入口指定的程式。保留入口所需的參數,但不要將 %U、%F 等桌面入口欄位代碼原樣傳給程式。記下第一則啟動錯誤,判斷問題是缺少動態程式庫、路徑無效,還是用戶端已在執行。

XDG 自動啟動:登入桌面後自動開啟 v2rayN

XDG 自動啟動由圖形桌面工作階段處理,會在使用者登入後執行,並不等同於系統開機後、登入前啟動服務。請先確認用戶端是否已啟用自動啟動,或桌面環境的自動啟動清單中是否已經有 v2rayN;同一個帳號只保留一個入口,避免重複啟動。

  1. 執行以下指令,建立目前使用者的自動啟動目錄。若已設定 XDG_CONFIG_HOME,請使用該目錄下的 autostart;一般預設路徑是 ~/.config/autostart。
  2. 在檔案管理器中,將上一節依套件清單找到的 .desktop 檔案複製到該目錄。保留實際檔名與原有的 Exec,不要將安裝套件拖進去,也不要使用 sudo 建立使用者入口。
  3. 使用文字編輯器查看副本中的 [Desktop Entry] 區段。若有 Hidden=true,請刪除該行或改為 Hidden=false。確認 OnlyShowIn 和 NotShowIn 是否允許目前的桌面工作階段,並確認 TryExec 仍然有效。
  4. 登出目前的圖形工作階段後重新登入,檢查視窗、系統匣或系統監視器。若只看到程序,沒有看到視窗,請先確認是否啟用了最小化啟動,再判斷是否啟動失敗。
autostart_dir="${XDG_CONFIG_HOME:-$HOME/.config}/autostart"
mkdir -p "$autostart_dir"
printf '%s\n' "$autostart_dir"

若要關閉手動設定的自動啟動,只需刪除使用者目錄中複製的入口,保留系統目錄中的原始檔案。若桌面環境已有同名的系統層級自動啟動項目,刪除使用者副本後可能會重新啟用系統項目;此時可在桌面的自動啟動設定中停用,或使用同名使用者項目的 Hidden=true 覆蓋。軟體更新後若系統入口的 Exec 有變更,請記得重新確認使用者副本。

登入後排查:釐清程式、連接埠與代理設定

從選單點開可以啟動,重新登入後卻沒有自動開啟?

先比對終端機顯示的自動啟動目錄,確認放入的是實際的 .desktop 檔案,而不是文字編輯器另存成帶有 .txt 副檔名的副本。接著檢查入口限制與執行路徑。若手動執行入口也失敗,請先排除啟動錯誤,不要用延遲啟動來掩蓋問題。

程序正在執行,為什麼瀏覽器沒有透過代理連線?

開啟 v2rayN 的「設定」→「參數設定」,確認本機監聽連接埠;再查看系統匣中的「系統代理」目前是設定還是清除狀態。可使用 ss -ltnp 查看 TCP 監聽狀態,並依用戶端顯示的實際連接埠確認。連接埠正在監聽,只代表本機有程序接收連線;還需確認瀏覽器使用的代理來源、目前啟用的節點,以及用戶端記錄。

登入後訂閱沒有更新,是自動啟動出問題嗎?

先確認用戶端已啟動,等網路連線就緒後再手動更新一次訂閱。若此時更新成功,請檢查登入時 Wi-Fi 是否尚未連線,以及用戶端的訂閱更新設定。桌面程式啟動、網路就緒與訂閱更新是三個獨立環節,應分別確認。

下載v2rayN