適合第一次在 Linux 圖形桌面安裝 v2rayN 的使用者。先依 Linux 發行版和 CPU 架構選擇套件,再以一般使用者帳號啟動應用程式、匯入訂閱並確認本機代理可用。手動啟動確認正常後,再將相同的桌面捷徑加入登入自動啟動,最後檢查目標應用程式是否會讀取 GNOME 或 KDE 的代理設定。
選擇安裝套件:Linux 發行版與 CPU 架構
在終端機執行 cat /etc/os-release 查看 Linux 發行版,執行 uname -m 查看 CPU 架構。若輸出為 x86_64,下載項目可能標示為 x64,deb 套件中繼資料則常寫作 amd64;若輸出為 aarch64,請選擇相符的 ARM64 版本。副檔名正確不代表架構相符,也不代表套件支援目前的發行版版本。
原生套件
建議Debian 和 Ubuntu 請選 deb;Fedora 和 openSUSE 請選與發行版相容的 rpm。套件管理工具可依套件宣告安裝相依項目,並記錄應用程式安裝的檔案。
適用情況:下載頁提供相符架構的套件,且本機套件庫可滿足相依需求
壓縮檔安裝
若下載頁提供相符架構的壓縮檔,可解壓縮至使用者目錄中的固定位置。程式仍可能需要系統程式庫,桌面捷徑也可能需要自行新增。
適用情況:想在使用者目錄管理程式,且已確認執行環境相容
deb 與 rpm 安裝指令
在終端機切換至安裝套件所在目錄,將下列指令中的範例檔名 v2rayN.deb 或 v2rayN.rpm 改為實際檔名。保留前面的 ./,代表安裝目前目錄中的本機檔案。依 Linux 發行版選擇其中一個指令即可,不必逐一執行。
- Debian/Ubuntu:
sudo apt install "./v2rayN.deb"。 - Fedora:
sudo dnf install "./v2rayN.rpm"。 - openSUSE:
sudo zypper install "./v2rayN.rpm"。
若出現架構不相符的提示,請回到下載頁改用正確套件;若找不到相依項目,優先查看錯誤訊息中的程式庫名稱和最低版本,再確認發行版版本與已啟用的套件庫。也可用 dpkg-deb -I "./v2rayN.deb" 檢查 deb 中繼資料,或用 rpm -qpR "./v2rayN.rpm" 查看 rpm 宣告的相依項目。請勿強制安裝:略過相依性檢查並不能補上缺少的執行程式庫。
首次啟動:桌面捷徑、訂閱與監聽連接埠
開啟應用程式
在 GNOME 應用程式總覽或 KDE Plasma 應用程式啟動器搜尋「v2rayN」,並以一般使用者身分開啟。若搜尋不到,請檢查安裝套件的檔案清單中是否有
.desktop檔案;啟動指令不一定與應用程式顯示名稱相同。新增訂閱
在主視窗開啟「訂閱群組」→「訂閱群組設定」,新增群組、填入訂閱網址並儲存。若介面上有「+」按鈕,也可直接從群組清單新增。接著從「訂閱群組」選單執行更新;若尚無可用節點,請先嘗試不透過代理更新。
選取節點
切換至剛更新的群組,在候選節點上按一下滑鼠右鍵,選擇「設為活動伺服器」。節點出現在清單中只代表匯入成功;還要查看主視窗記錄,確認核心啟動後沒有立即結束。
確認本機連接埠
開啟「設定」→「參數設定」,查看本機監聽連接埠;確認目前使用的核心採用獨立連接埠或混合連接埠,再用
ss -ltn檢查對應的 TCP 連線是否正在監聽。首次測試時先關閉 TUN,避免虛擬網卡問題干擾代理連接埠排查。
請勿只根據連接埠號碼判斷通訊協定。如果目前是 SOCKS 監聽,請填入應用程式的 SOCKS 欄位;HTTP 欄位則應填入實際支援 HTTP 的連接埠。若記錄顯示位址已被占用,先用 ss -ltnp 查看目前帳號可見的監聽程序;確認是重複啟動,還是被其他應用程式使用,再決定關閉舊程序或更換連接埠。變更後也要更新先前手動填入的代理位址。
登入自動啟動:登入圖形桌面後執行
桌面版的自動啟動通常是指使用者登入圖形工作階段後執行,而非在登入畫面出現前執行。先確認可從應用程式選單正常啟動,再選用用戶端內建的自動啟動功能,或桌面的自動啟動項目。兩邊都設定可能導致重複啟動;若電腦停留在登入畫面,也不能據此判定自動啟動失敗。
- GNOME:可將已確認可正常使用的應用程式捷徑複製到使用者的自動啟動目錄。系統捷徑通常位於
/usr/share/applications/,使用者捷徑通常位於~/.local/share/applications/。先執行mkdir -p ~/.config/autostart建立預設的自動啟動目錄,再將實際的.desktop檔案複製至該目錄;若已自訂XDG_CONFIG_HOME,則使用該目錄下的autostart。 - KDE Plasma:開啟「系統設定」,搜尋「自動啟動」或「Autostart」,選擇「新增應用程式」,再從清單中選取 v2rayN。不同 Plasma 版本的設定分類可能不同,直接依名稱搜尋通常比依固定分類查找更可靠。
- 確認:登出後重新登入,檢查應用程式視窗、程序或本機監聽連接埠。若應用程式可手動啟動,但登入時未自動啟動,請確認使用者自動啟動項目的
Exec是否仍指向現有程式,尤其是在移動壓縮檔目錄或升級後變更路徑時。
GNOME 與 KDE:系統代理設定
GNOME
- 設定路徑
- 「設定」→「網路」→「網路代理」
- 模式
- 手動
- 位址
127.0.0.1,依代理類型填入連接埠
先記下原本的設定;若 v2rayN 已能設定桌面代理,就不必再手動維護另一份。
KDE Plasma
- 設定路徑
- 在「系統設定」中搜尋「代理」
- 模式
- 手動設定代理
- 位址
- 依 HTTP 和 SOCKS 各自的監聽設定填寫
儲存後,使用目標應用程式測試,尤其要留意可個別設定代理的瀏覽器。
系統代理是桌面工作階段提供給應用程式的一組設定,不代表接管整個系統的流量。瀏覽器若選擇手動設定代理,會使用自己的設定;終端機工具也可能只讀取環境變數或指令選項。若某個應用程式可正常連線、另一個卻不行,請先比較兩者讀取代理設定的方式,不要直接判定節點故障。若只需要讓少數應用程式使用代理,可保留桌面原有設定,只在目標應用程式中設定本機代理。
安裝與自動啟動故障排除
安裝完成後,為什麼在應用程式選單中找不到?
先用 dpkg-deb -c "./v2rayN.deb" 或 rpm -qpl "./v2rayN.rpm" 檢查套件內是否包含桌面捷徑,再確認安裝程序已完成。若捷徑存在但選單尚未更新,可登出後重新登入;若套件中沒有捷徑,請先依檔案清單找出實際的執行檔並手動啟動。
登入後看不到視窗,代表沒有啟動嗎?
不一定。先檢查本機監聽狀態,再確認應用程式是否設定為啟動時最小化。部分桌面環境不會顯示系統匣圖示,因此看不到視窗不代表程序沒有執行。若沒有監聽,請從應用程式選單手動啟動一次,確認問題是否只在登入時發生。
關閉用戶端後瀏覽器無法開啟網頁,該如何恢復?
確認 GNOME 或 KDE 的代理設定是否仍指向已停止的本機連接埠。若留有舊設定,請還原先前的桌面代理設定;若之前沒有使用代理,則關閉手動代理。若只有某個瀏覽器受影響,再檢查該瀏覽器是否另行儲存了迴送位址和連接埠。