適合要在 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 格式不代表相依套件相容,仍須確認目標發行版與版本。
架構名稱相符,不代表該版本一定有提供對應的建置版本。若下載頁沒有相符的套件,請勿只改副檔名或強制忽略架構來安裝。若同一發行版有適用的封存檔套件,可依該建置版本的說明安裝至固定的使用者目錄;不要將臨時解壓縮目錄設為稍後建立的桌面入口路徑。
使用套件管理工具安裝並處理相依套件
檢查套件標頭
在安裝套件所在目錄,deb 使用
dpkg-deb -f 檔名.deb Package Version Architecture Depends,rpm 使用rpm -qp --qf '%{NAME} %{VERSION}-%{RELEASE} %{ARCH}\n' 檔名.rpm。將命令中的檔名換成實際下載的檔案名稱,並記下套件名稱。套件名稱可能與應用程式選單中顯示的 v2rayN 不同,稍後查詢安裝檔案時會用到。安裝本機套件
Debian 或 Ubuntu 請先執行
sudo apt update,再執行sudo apt install ./檔名.deb。Fedora 使用sudo dnf install ./檔名.rpm,openSUSE 使用sudo zypper install ./檔名.rpm。保留./,讓套件管理工具將參數辨識為本機路徑;若實際檔名包含空格,請將整個路徑用引號括起來。確認相依套件
若安裝程式提示缺少相依套件,先記下缺少的套件名稱、程式庫名稱或最低版本。APT 系統可查看
Depends;RPM 系統則用rpm -qpR 檔名.rpm查看套件宣告的需求。先確認目前發行版的套件來源是否提供這些相依項目,再判斷是否需要改用其他建置版本。請勿混用不同發行版的套件來源,也不要使用忽略相依性的參數完成安裝。手動啟動
在目前使用者的應用程式選單搜尋 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 自動啟動目錄。以下路徑用來區分桌面入口、自動啟動入口與本機監聽,三者用途不同,不能互相取代。
- 執行
mkdir -p "${XDG_CONFIG_HOME:-$HOME/.config}/autostart"。將上一步確認可用的.desktop檔案複製到該目錄。無須使用sudo,也不需要為圖形介面用戶端建立系統層級服務。 - 確認副本中的
Exec和TryExec仍指向目前的安裝位置。若有Hidden=true、OnlyShowIn或NotShowIn,請確認這些設定沒有停用入口或排除目前的桌面環境。若Exec含有檔案或網址參數欄位,自動啟動副本應改用已確認可用的一般啟動命令,不要傳入檔案或網址。 - 結束用戶端,再登出並登入同一個圖形桌面帳號。先不要手動開啟,確認程式是否已自行啟動;接著前往「設定」→「參數設定」確認本機監聽連接埠。若實際設定為
10808,可執行ss -ltn 'sport = :10808'檢查監聽狀態;若連接埠已被占用,可用ss -ltnp 'sport = :10808'嘗試確認所屬處理程序。 - 最後確認系統代理狀態,以及目標應用程式是否使用代理。存在監聽連接埠,只代表有處理程序接收本機連線,不代表瀏覽器已透過代理連線,也不代表路由規則選中了預期的出口。先用原本可手動運作的節點與應用程式測試,不要同時變更訂閱、連接埠和路由設定。
Linux 部署常見問題
本機套件無法安裝,提示相依套件版本太舊怎麼辦?
執行 cat /etc/os-release 確認建置版本的適用目標。Debian 系統可用 apt-cache policy 套件名稱 查看候選版本;若發行版的套件來源未提供所需版本,請改用適用於目前發行版的建置版本,或先正常升級發行版。替換系統共用程式庫,可能影響其他依賴同一程式庫的程式。
從選單可以啟動,登出再登入後卻沒有自動啟動?
查看實際的 XDG_CONFIG_HOME,確認入口位於該帳號的 autostart 目錄,而非只放在 applications。檢查自動啟動副本中的路徑與桌面限制欄位。若自訂命令依賴終端機啟動指令碼設定的環境變數,請改用安裝套件提供的入口,或可在桌面工作階段中獨立執行的命令。
登入後重複啟動,或升級後啟動時發生錯誤?
先查看桌面環境的自動啟動清單與使用者自動啟動目錄,避免用戶端內建設定和手動入口重複登記。升級後重新檢查套件提供的桌面入口;若手動建立的副本仍指向舊位置,請以已確認可用的新入口取代。若要停用手動設定的自動啟動,只需刪除自動啟動目錄中的副本,保留應用程式選單入口。