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

適用於 Ubuntu、Debian、Fedora 等桌面版 Linux,介紹 deb 與 rpm 套件安裝、首次啟動權限、系統代理及登入後自動啟動設定。

本文重點

Ubuntu 和 Debian 使用 deb,Fedora 使用 rpm;只有安裝時需要管理員權限。首次執行請使用目前的桌面帳號,先確認本機代理可正常使用,再啟用系統代理和登入自動啟動。下文提供安裝指令、連接埠檢查方式,以及應用程式選單可啟動、但登入後未自動啟動時的排查步驟。

Linux 安裝套件選擇:發行版與 CPU 架構

先確認發行版,再確認架構。在終端機執行以下兩個指令:第一個查看發行版和版本,第二個查看機器架構。Ubuntu 和 Debian 的套件中繼資料通常以 amd64 表示 x86_64,以 arm64 表示 aarch64;Fedora 套件中繼資料通常使用 x86_64 和 aarch64。下載頁上的 x64 指的是前一組架構。

cat /etc/os-release
uname -m

Debian 系安裝套件

桌面版 Linux 發行版
Ubuntu、Debian
副檔名
.deb
套件架構欄位
amd64 或 arm64
安裝工具
apt

使用 apt 安裝本機套件,並一併處理軟體來源中可取得的相依套件。

Fedora 安裝套件

桌面版 Linux 發行版
Fedora
副檔名
.rpm
套件架構欄位
x86_64 或 aarch64
安裝工具
dnf

同為 rpm 格式不代表相依套件相同;其他發行版請另外確認套件是否相容。

如果錯誤明確指出架構不符,請回到下載頁改下載正確的套件,不要強制安裝。如果架構相符,但提示缺少某個程式庫,請記下第一個無法滿足的相依項目及其版本,再檢查目前發行版的軟體來源和版本;不要從其他發行版單獨搬入同名程式庫。

deb 與 rpm 安裝指令

以下兩段指令只執行符合你所用發行版的一段。出現輸入提示後,貼上剛下載的安裝套件完整路徑,不要另外加上引號。安裝指令中的雙引號會保留路徑內的空格。先查看套件中繼資料,確認名稱、版本和架構,再執行含 sudo 的安裝指令。

Ubuntu、Debian:使用 apt 安裝 deb 套件

printf '請輸入 deb 安裝套件的完整路徑:'
IFS= read -r pkg
dpkg-deb -f "$pkg" Package Version Architecture
sudo apt install "$pkg"

如果終端機顯示無法下載相依套件,請先確認系統在關閉代理時能連線至自己的軟體來源,再執行 sudo apt update 並重試。如果安裝計畫顯示將移除現有桌面元件,請先取消,檢查是否混用了不同發行版或不同版本的軟體來源。

Fedora:使用 dnf 安裝 rpm 套件

printf '請輸入 rpm 安裝套件的完整路徑:'
IFS= read -r pkg
rpm -qp --queryformat '%{NAME} %{VERSION}-%{RELEASE} %{ARCH}\n' "$pkg"
sudo dnf install "$pkg"

安裝完成後,在桌面應用程式選單搜尋「v2rayN」。終端機顯示套件已安裝,只代表部署完成,不表示圖形介面和核心已經啟動。如果選單中沒有項目,請記下上方查到的套件名稱:Ubuntu、Debian 可用 dpkg -L 加上套件名稱,Fedora 可用 rpm -ql 加上套件名稱,查看套件提供的 .desktop 檔案及安裝路徑。

首次啟動權限與系統代理測試

請先使用一般桌面帳號啟動 v2rayN,暫時不要啟用 TUN,也不要用 sudo 開啟介面。安裝軟體需要管理員權限,但讀寫個人設定和執行本機代理通常不需要。如果啟動記錄出現 Permission denied,請先確認錯誤指向使用者設定檔還是核心程式路徑,不要遞迴開放整個安裝目錄的權限。

  1. 選取目前使用的節點

    已有設定時,請在主畫面的節點清單選取節點,按右鍵選擇「設為活動伺服器」;如果是剛安裝、清單仍是空的,請先到「訂閱群組」新增訂閱並更新。接著查看主畫面的記錄,確認核心沒有啟動錯誤。

  2. 確認監聽連接埠

    開啟「設定」→「參數設定」,查看「本機監聽連接埠」和本機入站設定。不同版本的欄位名稱可能略有差異;請使用介面顯示的實際連接埠,不要將節點伺服器的遠端連接埠填成本機應用程式的連接埠。

  3. 測試本機代理

    先讓終端機請求明確透過本機代理,藉此區分核心連線問題和桌面代理設定問題。以下指令以混合入站連接埠 10808 為例;如果你的版本將 HTTP 和 SOCKS 分開設定,請依入站協定和實際連接埠調整。

  4. 設定系統代理

    在 v2rayN 主畫面底部或系統匣開啟「系統代理」,選擇「自動設定系統代理」。GNOME 使用者可到「設定」→「網路」→「網路代理」確認設定是否已寫入;如果桌面設定沒有變更,請先讓目標應用程式使用自己的代理設定,不必反覆重新啟動核心。

127.0.0.1
本機代理範例位址
10808
混合監聽連接埠範例,請以目前設定為準
15 秒
以下測試請求的總逾時時間
ss -ltn 'sport = :10808'
curl --max-time 15 -I --proxy socks5h://127.0.0.1:10808 https://example.com/

第一個指令只確認本機 TCP 連接埠是否正在監聽;第二個指令收到目標網站的 HTTP 回應標頭,才表示這次請求確實透過指定代理完成連線。如果立即顯示無法連線至本機連接埠,請先檢查連接埠和核心記錄;如果連接埠正在監聽但請求逾時,再檢查目前節點、網路和路由。瀏覽器可用、終端機卻無法連線時,不代表安裝失敗:不少終端機程式不會讀取桌面代理設定,可依個別應用程式指定代理。

登入後自動啟動:登入桌面時執行 v2rayN

桌面版的自動啟動通常是指登入圖形工作階段後才啟動,不是在登入畫面出現前執行。請先確認能從應用程式選單正常開啟 v2rayN,再從以下兩種方式擇一設定。重複設定會導致同一次登入啟動多個執行個體,也會讓停用和排錯更難處理。

設定桌面工作階段自動啟動

建議

KDE Plasma 使用者可開啟「系統設定」,搜尋「自動啟動」,進入後選擇「新增」→「新增應用程式」,再從清單選取 v2rayN。如果 Ubuntu 的應用程式選單提供「啟動應用程式(Startup Applications)」,可在其中選擇「新增」,填入已確認可正常啟動的實際程式指令。選單名稱可能因桌面版本而異。

適用情況:桌面已提供自動啟動管理功能,想直接透過圖形介面啟用或停用。

使用者層級的 XDG 自動啟動項目

從已安裝套件的檔案清單找出應用程式選單對應的 .desktop 檔案,將它複製到目前使用者的自動啟動目錄。保留原本的 Exec= 啟動指令,比照其他電腦的安裝路徑自行撰寫更可靠。

適用情況:桌面遵循 XDG 自動啟動規範,但未提供方便使用的圖形介面。

若要使用檔案方式,請在終端機執行以下指令,並依提示輸入已確認的 .desktop 檔案完整路徑。不要加上 sudo。如果沒有自訂 XDG_CONFIG_HOME,自動啟動目錄就是 ~/.config/autostart。

printf '請輸入已安裝 .desktop 檔案的完整路徑:'
IFS= read -r desktop_file
autostart_dir="${XDG_CONFIG_HOME:-$HOME/.config}/autostart"
mkdir -p "$autostart_dir"
cp -i -- "$desktop_file" "$autostart_dir/"

請先登出再重新登入,不要預先手動開啟 v2rayN。桌面載入完成後,查看系統匣、視窗或本機監聽連接埠。若視窗已出現,但網頁沒有透過代理連線,請重新確認系統代理狀態:啟動程式和設定代理是兩件不同的事。若要取消檔案方式的自動啟動,只要移除目前使用者自動啟動目錄中的副本,應用程式選單入口仍會保留。

Linux 安裝與自動啟動常見問題

已完成安裝,點選選單卻沒有反應?

先查看套件內 .desktop 檔案的 Exec= 指向何處;也可用 command -v v2rayN 檢查該名稱是否在搜尋路徑中。如果找不到,請依套件檔案清單找出實際的可執行檔,再以一般使用者身分從終端機執行並查看錯誤訊息。如果提示找不到共用程式庫,請依程式庫名稱和發行版版本排查相依性,不要改用管理員權限重新開啟。

手動可以啟動,重新登入後卻沒有自動啟動?

先確認登入的帳號是當初新增自動啟動項目的帳號,再開啟使用者目錄中的 .desktop 檔案,檢查是否設有 Hidden=true、OnlyShowIn 或 NotShowIn 限制。如果最近更新過套件,請對照應用程式選單目前使用的檔案,確認副本中的 Exec= 是否仍指向原本的位置。

記錄顯示連接埠已被占用,該怎麼處理?

使用 ss -ltnp 'sport = :10808' 檢查範例連接埠;如果實際連接埠不同,請替換數字。先關閉重複開啟的 v2rayN;如果連接埠是由其他正常運作的程式占用,請到「設定」→「參數設定」調整本機監聽連接埠,並同步修改手動設定過的瀏覽器或終端機代理。

關閉軟體後,瀏覽器還是無法開啟網頁?

如果先前啟用了自動設定,結束前可在「系統代理」選擇「清除系統代理」。如果程式已經關閉,請在桌面的網路代理設定中還原啟用前的選項;若曾手動為瀏覽器指定代理,也要還原瀏覽器本身的設定。否則應用程式可能仍會連線至已停止監聽的本機連接埠。

下載 v2rayN查看平台與安裝套件