本文適合想在 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
副檔名相同不代表相依套件也相同;請一併確認發行說明列出的發行版與版本範圍。
安裝 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 時請先檢查交易摘要:若套件庫無法滿足相依需求,修復方案可能是移除該套件,而非安裝它。
從應用程式選單啟動:尋找入口並排除問題
搜尋應用程式
安裝完成後,請在 GNOME 的應用程式搜尋或 KDE Plasma 的應用程式啟動器中搜尋「v2rayN」,並先以目前的桌面使用者身分啟動一次。安裝指令需要管理員權限,但開啟圖形用戶端不必使用管理員權限。
查看套件檔案清單
若選單中找不到應用程式,Debian 系統可使用
dpkg-query -L搭配已安裝的套件名稱,RPM 系統則使用rpm -ql搭配已安裝的套件名稱。套件名稱可分別透過dpkg-deb -f ./v2rayN.deb Package或rpm -qp --qf '%{NAME}\n' ./v2rayN.rpm查詢。清單中的.desktop檔案才是接下來要找的桌面入口,請勿將安裝套件檔名當成啟動指令。查看桌面入口欄位
開啟桌面入口檔案,確認
Name和Exec。若有NoDisplay=true,代表入口可能存在,但不會顯示在應用程式選單中;若有TryExec,也請確認指定的程式存在且可執行。不要直接編輯系統目錄中的入口,因為軟體套件更新時可能會覆蓋修改內容。檢查啟動訊息
若圖示出現但點擊後沒有視窗,請先確認系統匣是否已有執行中的實例,再從圖形工作階段的終端機以一般使用者身分啟動入口指定的程式。保留入口所需的參數,但不要將
%U、%F等桌面入口欄位代碼原樣傳給程式。記下第一則啟動錯誤,判斷問題是缺少動態程式庫、路徑無效,還是用戶端已在執行。
XDG 自動啟動:登入桌面後自動開啟 v2rayN
XDG 自動啟動由圖形桌面工作階段處理,會在使用者登入後執行,並不等同於系統開機後、登入前啟動服務。請先確認用戶端是否已啟用自動啟動,或桌面環境的自動啟動清單中是否已經有 v2rayN;同一個帳號只保留一個入口,避免重複啟動。
- 執行以下指令,建立目前使用者的自動啟動目錄。若已設定
XDG_CONFIG_HOME,請使用該目錄下的autostart;一般預設路徑是~/.config/autostart。 - 在檔案管理器中,將上一節依套件清單找到的
.desktop檔案複製到該目錄。保留實際檔名與原有的Exec,不要將安裝套件拖進去,也不要使用sudo建立使用者入口。 - 使用文字編輯器查看副本中的
[Desktop Entry]區段。若有Hidden=true,請刪除該行或改為Hidden=false。確認OnlyShowIn和NotShowIn是否允許目前的桌面工作階段,並確認TryExec仍然有效。 - 登出目前的圖形工作階段後重新登入,檢查視窗、系統匣或系統監視器。若只看到程序,沒有看到視窗,請先確認是否啟用了最小化啟動,再判斷是否啟動失敗。
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 是否尚未連線,以及用戶端的訂閱更新設定。桌面程式啟動、網路就緒與訂閱更新是三個獨立環節,應分別確認。