2026-10-19 · 平台部署 · 約 12 分鐘

Linux 版 v2rayN 安裝教學：deb／rpm 套件與登入自動啟動設定

在 Debian／Ubuntu 或 Fedora 安裝 v2rayN 桌面版，設定登入自動啟動與系統代理，並排解常見相依套件問題。

本文速覽

適合已進入 Linux 圖形桌面的使用者：先確認發行版與處理器架構，再透過系統套件管理器安裝 v2rayN，完成節點匯入、代理測試與登入自動啟動。文中的 10808 僅為設定範例，並非所有版本的預設連接埠；實際操作請以用戶端目前的設定與記錄為準。

安裝前：確認發行版、架構與桌面工作階段

v2rayN 是桌面用戶端，負責管理節點、啟動核心與設定代理。deb／rpm 套件只負責部署程式，不會自動提供節點或訂閱。只有終端機、沒有圖形桌面的伺服器不適用本文的部署方式；也不要將桌面用戶端當成開機即執行的系統服務。

先在終端機查看系統資訊。Ubuntu、Debian 通常選 deb；Fedora 通常選 rpm。處理器名稱中的 x86_64 對應 x64，aarch64 對應 arm64。套件格式相同，不代表可以跨發行版或跨架構直接使用。

cat /etc/os-release
uname -m
printf '桌面：%s\n工作階段：%s\n' "$XDG_CURRENT_DESKTOP" "$XDG_SESSION_TYPE"

安裝方式：依發行版選擇套件，依處理器選擇架構

Debian / Ubuntu
  • 使用 deb 安裝套件。
  • 透過 apt 安裝本機檔案並處理相依套件。
  • 使用 dpkg 查詢套件內的檔案與桌面啟動項目。
Fedora
  • 使用 rpm 安裝套件。
  • 透過 dnf 安裝本機檔案並處理相依套件。
  • 使用 rpm 查詢套件資訊與已安裝的檔案。

兩種方式都應在一般使用者的圖形工作階段中執行用戶端；只有安裝軟體時才使用管理員權限。

前往下載中心選擇 Linux 安裝套件。為方便複製指令，以下假設已將下載的 deb 檔案重新命名為 v2rayN.deb，或將 rpm 檔案重新命名為 v2rayN.rpm，接著在檔案所在目錄開啟終端機。這只是本機檔名的約定，不會變更套件內的版本、架構或套件名稱。

deb／rpm 部署：交由套件管理器處理相依套件

先查看套件資訊，再進行安裝。如此可在安裝前發現架構選錯、檔案格式不符等問題。不要把網頁回傳內容當成安裝套件，也不要使用強制忽略相依套件的參數來略過錯誤。

Debian／Ubuntu：使用 apt 安裝本機 deb

dpkg-deb -f ./v2rayN.deb Package Version Architecture
sudo apt update
sudo apt install ./v2rayN.deb

./ 表示安裝目前目錄中的檔案，不可省略為軟體庫套件名稱。相較於單獨執行 dpkg -i，apt 可搭配已啟用的軟體來源處理相依套件。如果先前安裝因相依套件錯誤而中斷，請先檢視 sudo apt --fix-broken install 的處理計畫，確認不會移除仍需要的軟體後再繼續。

Fedora：使用 dnf 安裝本機 rpm

rpm -qp --queryformat '%{NAME} %{VERSION}-%{RELEASE} %{ARCH}\n' ./v2rayN.rpm
sudo dnf install ./v2rayN.rpm

dnf 提示缺少相依套件時，請檢查發行版版本、軟體來源狀態與套件適用環境。不要將 Debian 的程式庫檔案複製到 Fedora，也不要隨意建立共享程式庫符號連結來假裝符合相依需求。套件能解開，不代表程式就能正常啟動。

  1. 查看套件資訊

    確認套件的 Version 與 Architecture；Debian 的 amd64 和 RPM 常見的 x86_64 都代表 x64 架構。

  2. 完成安裝

    執行對應的 apt 或 dnf 指令，保留終端機顯示的完整錯誤訊息，不要只記下「安裝失敗」。

  3. 啟動用戶端

    在桌面應用程式選單搜尋 v2rayN，以目前使用者身分啟動。不要使用 sudo 啟動圖形介面。

  4. 匯入並測試

    複製分享連結後，在主視窗的節點清單按右鍵，選擇「從剪貼簿匯入分享連結」；選取節點後，執行「設為作用中伺服器」。不同版本的實際選項名稱可能略有差異。

代理設定：先確認監聽狀態，再設定桌面代理

安裝成功只完成第一步。還要確認作用中節點可用、核心已執行、本機入站正在監聽。前往「設定」→「參數設定」，查看本機監聽連接埠與相關入站設定，並在用戶端記錄中確認實際啟動結果。不同版本可能將這些設定放在不同分頁，請勿只憑舊截圖尋找固定位置。

127.0.0.1
本文使用的本機代理位址
10808
HTTP 或混合入站連接埠範例
15 秒
後續請求測試的逾時上限

以下假設用戶端已在 127.0.0.1:10808 提供 HTTP 代理或混合入站。如果實際連接埠不同，請一併修改桌面設定與測試指令；若該連接埠只接受 SOCKS，就不能填入 HTTP 代理欄位。通常不必將監聽位址改成 0.0.0.0，否則代理連接埠可能會暴露給其他裝置。

GNOME 手動代理

設定位置
設定 → 網路 → 網路代理
模式
手動
HTTP 主機
127.0.0.1
HTTP 連接埠
10808，請依實際入站設定修改
HTTPS 代理
相同的 HTTP 代理位址與連接埠

部分桌面版本的代理設定入口位於「網路」頁面的設定按鈕中。

KDE Plasma 手動代理

設定位置
系統設定 → 網路 → 代理伺服器
模式
使用手動指定的代理設定
HTTP 主機
127.0.0.1
HTTP 連接埠
10808，請依實際入站設定修改
HTTPS 代理
相同的 HTTP 代理位址與連接埠

設定頁面的名稱可能因 Plasma 版本而異；搜尋「代理」即可找到設定入口。

HTTPS 代理欄位表示「瀏覽 HTTPS 網站時使用的代理」，不代表必須在本機架設 TLS 代理服務。HTTP 代理可透過 CONNECT 轉送 HTTPS 請求。系統代理也不會接管所有流量：部分終端機程式、獨立網路元件，以及自行設定代理的應用程式不會遵循桌面設定。

連線驗證：分開檢查連接埠、請求與瀏覽器

節點清單中的延遲數字不能取代完整驗證。TCP 連線成功只表示目標連接埠可能可達；實際連線測試更接近真正的代理請求，但仍應再用瀏覽器測試一次。先確認監聽狀態，再透過明確指定代理的指令送出請求，最後確認桌面應用程式是否有讀取代理設定。

# 檢查範例連接埠是否正在監聽
ss -lntp 'sport = :10808'

# 明確使用 HTTP 代理，排除桌面設定是否生效的影響
curl --noproxy "" --proxy http://127.0.0.1:10808 \
  --connect-timeout 5 --max-time 15 \
  -I https://example.com/

example.com 是公開的範例網站，此指令僅用於測試請求路徑，不是訂閱網址。若收到 HTTP 回應標頭，表示這次請求透過指定代理取得了回應；但不能據此判定所有網站或所有分流規則都正常。若尚未安裝 curl，Debian／Ubuntu 可執行 sudo apt install curl，Fedora 可執行 sudo dnf install curl。

觀察結果優先檢查項目下一步
10808 未在監聽核心啟動失敗、連接埠設定不同查看記錄中的入站位址與錯誤，並確認作用中節點
連接埠正在監聽，但 curl 失敗代理協定不符、節點連線失敗確認 HTTP／SOCKS 類型，再更換節點測試
curl 成功，瀏覽器失敗系統代理未套用、瀏覽器使用獨立代理設定檢查桌面代理與瀏覽器網路設定
只有部分網站正常路由分流、DNS、目標網站狀態查看記錄，確認該請求是直連還是透過代理

若瀏覽器設定為「沿用系統代理」，通常需要重新發起連線；仍未生效時，可完全關閉瀏覽器後重新開啟。不要同時修改 DNS、路由、節點與監聽連接埠，否則難以判斷成功或失敗的原因。每次只變更一項，並記錄請求時間與對應的記錄。

自動啟動：使用桌面登入項目，不要將介面程式設為系統服務

這裡所說的「開機自動啟動」，準確來說是「使用者登入圖形桌面後啟動」。電腦停留在登入畫面時，使用者的桌面工作階段尚未建立。v2rayN 依賴圖形工作階段與使用者設定；將它塞進系統層級服務，不僅無法取代桌面登入項目，也容易造成顯示環境、權限與設定目錄不一致。

桌面登入時自動啟動

建議

使用已安裝的桌面啟動項目，讓用戶端隨目前使用者的圖形工作階段啟動。可透過桌面設定或使用者的 autostart 目錄管理。

適用情境：個人電腦、登入後使用代理的桌面使用者。

手動啟動用戶端

每次從應用程式選單啟動，先選擇節點再啟用代理。安裝除錯或確認升級結果時，較容易觀察啟動過程。

適用情境：首次部署、臨時使用、排查相依套件問題。

從已安裝的套件尋找桌面啟動項目

不同安裝套件可能採用不同的程式路徑與桌面檔案名稱，因此不要自行猜測並寫死 Exec。以下兩段指令擇一，依安裝格式在安裝套件所在目錄執行，透過套件中繼資料找出實際的桌面啟動項目。

# Debian / Ubuntu
pkg=$(dpkg-deb -f ./v2rayN.deb Package)
dpkg -L "$pkg" | grep -E '/applications/[^/]+\.desktop$'

# Fedora
pkg=$(rpm -qp --queryformat '%{NAME}' ./v2rayN.rpm)
rpm -ql "$pkg" | grep -E '/applications/[^/]+\.desktop$'

在檔案管理員中複製找到的 v2rayN 桌面檔案，放入目前使用者的 ~/.config/autostart/。若目錄不存在，請先建立。如果已設定 XDG_CONFIG_HOME，應使用該目錄下的 autostart/，而非固定使用預設路徑。

mkdir -p "${XDG_CONFIG_HOME:-$HOME/.config}/autostart"

設定完成後，請登出再重新登入，比單純關閉視窗更能驗證登入項目。確認只有一個用戶端執行個體，再檢查監聽連接埠與代理狀態。登入項目只能確保程式啟動；是否自動連線至作用中節點、是否自動設定系統代理，仍須確認目前版本提供的個別選項。

常見問題：相依套件、桌面啟動項目與連接埠衝突

排除問題時，記下發行版版本、架構、套件內版本與完整錯誤訊息，比反覆重新安裝更有效。不要以管理員身分執行用戶端來掩蓋權限問題，否則可能將使用者設定檔的擁有者改成 root，導致下次以一般使用者身分啟動時無法儲存設定。

提示缺少共享程式庫時，該安裝哪個相依套件？

以錯誤訊息中實際顯示的程式庫檔名為線索，透過目前發行版的軟體來源查詢所屬套件。Fedora 可使用 dnf provides 查詢；Debian／Ubuntu 可使用 apt-file 查詢檔案所屬套件。不要照搬其他發行版的套件名稱，也不要手動替換系統 libc。若系統執行階段程式庫版本低於程式需求，請改用相容的套件，或升級至受支援的系統環境。

應用程式選單有圖示，點擊後卻沒有視窗，該怎麼辦？

先確認程式是否已在背景或系統匣執行。接著查看桌面檔案中的 Exec=，並在圖形工作階段的終端機中依實際路徑啟動，以查看錯誤訊息；桌面欄位中的檔案參數標記不是一般 shell 參數，不應照原樣複製。若錯誤與顯示伺服器有關，請確認目前使用的是 Wayland 還是 X11 工作階段，不要直接修改全域環境變數。

記錄顯示 address already in use，該怎麼辦？

使用 ss -lntp 'sport = :10808' 檢查範例連接埠。如果一般使用者看不到其他程序的資訊，只在診斷指令中使用 sudo。優先關閉重複啟動的用戶端；若確實需要更換連接埠，必須一併更新桌面代理、終端機環境變數與測試指令。

升級後自動啟動失效，需要重建所有設定嗎？

先比較新套件提供的桌面檔案與使用者 autostart 副本。複製的登入項目不會隨系統桌面檔案自動更新；程式路徑變更後，可能仍指向舊位置。修正登入項目並重新登入測試即可，不必一開始就刪除節點、訂閱或路由設定。

升級與回復：保留使用者設定，重新檢查登入項目

之後升級時，仍使用相同的套件管理器安裝新版 deb／rpm 檔案。升級前請先關閉用戶端，並透過用戶端提供的備份功能或實際設定位置備份使用者資料；設定路徑可能因版本與封裝方式而異，不應直接假設程式目錄就是設定目錄。備份檔可能含有訂閱憑證，請存放在目前使用者可控的位置。

  1. 確認新套件適用的發行版範圍與處理器架構。
  2. 關閉用戶端，再執行前文對應的本機套件安裝指令。
  3. 手動啟動一次，檢查作用中節點、監聽連接埠與請求結果。
  4. 確認使用者登入項目的執行路徑，最後再登出並登入測試。

若要暫時停用，請先關閉系統代理，再退出用戶端，最後停用桌面登入項目。若要解除安裝，請依前文查得的實際套件名稱，使用 apt 或 dnf 移除；使用者目錄中的登入項目副本與設定可能仍會保留，請另外檢查。解除安裝程式與還原桌面代理是兩回事，不能將前者視為後者。

下載v2rayN