2026-10-14 · 平台安裝 · 約 10 分鐘

v2rayN Linux 桌面版安裝：deb／rpm 套件與登入後自動啟動設定

在 Ubuntu、Debian、Fedora 等 Linux 發行版安裝 v2rayN deb 或 rpm 套件，排除相依性與系統匣圖示問題，並設定登入桌面後自動啟動。

本文重點

適合已備妥 Linux 圖形桌面、準備安裝 v2rayN 的使用者。先依發行版與 CPU 架構選擇套件，再透過系統套件管理器處理相依性；首次啟動時確認訂閱、監聽連接埠與代理模式，最後沿用應用程式啟動器設定登入後自動執行。請分別檢查系統匣、桌面程式與代理核心，避免把視窗關閉、系統代理失效和程式當掉混為一談。

一、確認發行版、架構與安裝方式

v2rayN 是桌面用戶端，安裝成功不代表已有可用連線：還需要有效的伺服器設定或訂閱，以及相符的協定核心。本文說明圖形桌面環境中的用戶端安裝，不適用於無人登入時執行的系統代理服務。只有終端機的伺服器，不適合直接套用這套桌面自動啟動步驟。

開啟終端機並執行以下兩個指令。第一個查看發行版識別資訊與版本，第二個查看機器架構。一般來說，x86_64 對應 x64 套件，aarch64 對應 arm64 套件；架構不符時，補裝相依套件也無法解決執行檔不能執行的問題。

cat /etc/os-release
uname -m

發行版原生套件

建議

Ubuntu、Debian 優先選擇 deb，Fedora 優先選擇 rpm。套件管理器會登錄檔案、處理宣告的相依套件，並提供後續解除安裝的方式。仍須確認套件支援目前使用的發行版版本。

適合：長期在日常桌面使用，並希望妥善管理安裝紀錄。

可攜式封存檔

只有在下載頁提供相符架構的 Linux 封存檔時才選用。解壓縮後的存放位置、執行權限、桌面啟動器及更新替換都須自行維護，請勿使用 apt 或 dnf 安裝封存檔。

適合：暫時比對版本差異，或需要在獨立目錄測試。

二、在 Ubuntu 與 Debian 安裝 deb 套件

本機 deb 套件建議使用 apt install 安裝，而非只執行 dpkg -i。apt 會嘗試從已設定的套件來源補齊套件宣告的相依性。以下指令請在 Bash 終端機執行，出現提示後輸入下載檔案的實際路徑；路徑含空格時直接輸入，不必另外加上引號。

read -r -p "請輸入 deb 檔案的實際路徑：" pkg
pkg="$(realpath -- "$pkg")"
dpkg-deb -f "$pkg" Package Version Architecture
sudo apt update
sudo apt install "$pkg"

  1. 確認套件資訊

    查看上方輸出的 Package、Version 和 Architecture。若讀取失敗，請先確認輸入的是已下載的 deb 檔案，而非網頁檔案或壓縮封存檔。

  2. 檢查安裝計畫

    檢視 apt 列出的新增、升級與移除項目。若準備移除大量桌面元件，請先取消操作，並檢查套件來源是否混用了其他發行版或版本。

  3. 從選單啟動

    安裝完成後，在桌面應用程式選單搜尋 v2rayN，並以一般使用者身分開啟。安裝軟體需要提升權限，不代表執行圖形用戶端也需要提升權限。

  4. 保留錯誤輸出

    若視窗沒有出現，先找到安裝套件提供的桌面啟動器並查看其 Exec 欄位，再於終端機執行對應指令，記錄缺少的程式庫或權限錯誤。

若先前使用 dpkg -i 導致套件處於尚未設定的狀態，可先執行 sudo apt --fix-broken install，檢查修復計畫後再確認。這項操作可能補齊相依套件，也可能移除無法滿足相依性的套件，不能假設用戶端一定會保留下來。若套件來源連線失敗，請先恢復套件來源的連線，而不是反覆重新安裝。

三、在 Fedora 安裝 rpm 並找出啟動位置

Fedora 使用 dnf 安裝本機 rpm 套件。dnf 會搭配系統套件庫解析相依性；單獨使用 rpm -i 則不會連線下載相依套件。以下同樣先讀取實際檔案路徑，再查看套件中繼資料，最後進行安裝。

read -r -p "請輸入 rpm 檔案的實際路徑：" pkg
pkg="$(realpath -- "$pkg")"
rpm -qp --queryformat '%{NAME}\n%{VERSION}-%{RELEASE}\n%{ARCH}\n' "$pkg"
sudo dnf install "$pkg"

不要因為出現相依性衝突提示，就加入略過相依性或強制覆寫的參數。缺少共享程式庫、套件架構不符、混用不同版本的套件庫，是三種不同問題，請依終端機列出的具體套件名稱逐一確認。非 Fedora 的 rpm 系發行版也不能假設一定相容於同一個套件。

deb 安裝紀錄

讀取套件名稱
dpkg-deb -f "$pkg" Package
列出檔案
dpkg -L "$name"
啟動器位置
優先查看 /usr/share/applications/

先執行 name="$(dpkg-deb -f "$pkg" Package)"，再列出該套件安裝的檔案。

rpm 安裝紀錄

讀取套件名稱
rpm -qp --queryformat '%{NAME}' "$pkg"
列出檔案
rpm -ql "$name"
啟動器欄位
檢查 Exec= 與 TryExec=

先執行 name="$(rpm -qp --queryformat '%{NAME}' "$pkg")"，不要猜測安裝目錄或程式檔名。

桌面啟動器是後續排除問題與設定自動啟動的依據。若 Exec 行含有 %U、%F 等桌面欄位代碼，手動在終端機測試時不要直接將它們當成一般參數照抄。請以套件內的實際路徑為準，也不要遞迴修改整個安裝目錄，讓所有使用者都能寫入。

四、首次連線：訂閱、連接埠與系統代理

首次執行時先維持一般代理模式，暫時不要啟用 TUN。在主畫面選擇「訂閱群組」→「訂閱群組設定」，新增群組並填入訂閱網址，儲存後從「訂閱群組」執行更新。不同版本的按鈕名稱可能略有差異，請以群組設定視窗和更新選單為準。訂閱網址可能包含存取憑證，請在終端機截圖和求助紀錄中遮蔽。

選擇一個設定檔作為作用中的伺服器後，前往「設定」→「參數設定」確認本機監聽資訊，並查看用戶端日誌中的實際監聽位址。以下以 10808 作為確認範例，不代表所有版本或現有設定都使用此連接埠；只有確認該連接埠支援 HTTP 或混合代理後，才能直接套用相應的 curl 指令。

127.0.0.1
本機迴路位址，供本機應用程式連線
10808
本文測試用連接埠，須與實際監聽設定一致
15 秒
以下 curl 指令的最長等待時間
ss -ltnp 'sport = :10808'
curl --proxy http://127.0.0.1:10808 --max-time 15 -I https://example.com

若設定的是獨立 SOCKS 連接埠，請將 curl 的代理參數改為 --proxy socks5h://127.0.0.1:10808，並依實際設定調整連接埠。socks5h 會將目標網域交由代理端解析。收到 HTTP 回應只表示這次明確指定代理的請求取得回應，不代表系統中的所有應用程式都已透過代理連線。

五、系統匣圖示消失或視窗未顯示

GNOME、KDE Plasma 等桌面環境支援系統匣協定的方式各不相同。在 GNOME 看不到系統匣圖示，不一定代表 v2rayN 沒有執行；也可能是桌面缺少狀態指示器支援，或相關擴充功能尚未啟用。請先從應用程式選單嘗試重新開啟視窗，再檢查程序與本機監聽狀態。

關閉視窗後，為什麼找不到程式？

關閉視窗可能只是將程式隱藏到系統匣。請先檢查用戶端中關於關閉視窗、最小化與系統匣的選項，再從應用程式選單重新開啟。若無法確認程序狀態，可執行 pgrep -afi v2rayN 查看；不要連續點擊啟動，以免開啟多個執行個體。

Ubuntu 有視窗，卻沒有系統匣圖示？

請在桌面擴充功能管理器中確認 AppIndicator 支援是否已啟用。可先使用 Ubuntu 套件庫中的 apt policy gnome-shell-extension-appindicator 查詢相關套件；確認適用於目前的 GNOME 版本後再安裝或啟用，必要時登出並重新登入。

點擊應用程式選單後完全沒有反應？

依安裝紀錄找到 desktop 檔案，檢查 Exec 指向的檔案是否存在，再從終端機執行實際的啟動指令。若提示缺少共享程式庫，請依具體程式庫名稱處理；若提示設定目錄沒有權限，請確認是否曾使用 sudo 啟動用戶端，導致使用者設定檔的擁有者變成 root。

懷疑 Fedora 上的安全性政策阻擋程式？

先查看 journalctl --user -b -n 100 中的工作階段錯誤。若有明確的存取遭拒線索，再請管理員檢查稽核日誌。不要把停用 SELinux 當成一般安裝步驟，也不要用強制放寬權限來掩蓋錯誤路徑。

若程式可以正常開啟且連線可用，只是系統匣圖示不見，應優先修復桌面整合，無須重新安裝核心。若日誌顯示核心程序已結束，則應回頭檢查設定與核心權限；系統匣擴充功能無法修正協定參數錯誤或連接埠衝突。

六、登入後自動啟動：沿用桌面啟動器

一般所說的「開機自動啟動」，對 v2rayN 圖形用戶端來說，更精確的說法是「使用者登入桌面後啟動」。電腦通電後尚未登入、只進入文字終端機，或透過遠端指令登入，都不代表圖形工作階段已就緒。常見桌面環境支援 XDG 自動啟動目錄 ~/.config/autostart/，沿用軟體套件提供的 desktop 檔案，比猜測 Exec 路徑更可靠。

  1. 確認手動啟動正常

    先從應用程式選單啟動並完成一次連線測試。若用戶端本身已有自動啟動選項，先確認是否已建立自動啟動項目，避免重複設定。

  2. 找到啟動器

    依照前文列出的套件檔案清單，找到應用程式對應的 desktop 檔案。開啟檔案檢查其中的 Exec 路徑，確認它不是解除安裝入口，也沒有指向暫存下載目錄。

  3. 複製到使用者目錄

    執行下方指令，輸入該 desktop 檔案的完整路徑。目標名稱固定為 v2rayN.desktop，方便檢查與還原；此操作只會影響目前使用者。

  4. 登出後驗證

    先儲存其他工作，再登出並重新登入桌面。檢查用戶端程序、視窗或系統匣，再確認本機連接埠與實際連線；不要只憑圖示判斷自動啟動是否成功。

read -r -p "請輸入應用程式 desktop 檔案的完整路徑：" entry
grep -E '^(Type|Exec|TryExec|Hidden|OnlyShowIn|NotShowIn)=' "$entry"
install -Dm644 "$entry" "$HOME/.config/autostart/v2rayN.desktop"

複製前先查看 grep 輸出：Hidden=true 會停用此自動啟動項目，OnlyShowIn 與 NotShowIn 則會限制適用的桌面環境。若複製後沒有啟動，可用文字編輯器檢查這些欄位，以及是否存在 X-GNOME-Autostart-enabled=false。請勿只修改 Name 欄位；它僅用於顯示名稱，不會執行程式。

若要取消本節設定，只需刪除這次建立的檔案。若系統設定中還有另一筆 v2rayN 自動啟動紀錄，也要一併檢查並停用，避免誤以為取消設定沒有生效。

rm -- "$HOME/.config/autostart/v2rayN.desktop"

七、升級與重新啟動後的檢查清單

相同套件名稱的升級通常會由 apt 或 dnf 替換程式檔案，但使用者設定、自動啟動副本與桌面代理狀態彼此獨立。升級前請先結束用戶端，並備份實際使用的設定目錄；目錄位置以目前版本的設定或日誌為準，不要任意刪除整個使用者設定目錄。

完整的驗收順序是：手動啟動成功、明確指定代理可用、所需應用程式可正常使用、登出再登入後能恢復。逐項確認這四件事，比只觀察「開機後有沒有圖示」更容易找出問題。更多訂閱匯入與設定步驟，請參閱入門指南；進一步調整路由與 DNS，請參閱進階設定。

查看用戶端安裝套件