2026-08-04 · 平台部署 · 約 10 分鐘

v2rayN Linux 安裝教學：deb／rpm 套件安裝與開機自動啟動設定

說明 Debian／Ubuntu 與 Fedora／openSUSE 的 v2rayN 套件安裝、相依套件處理、桌面啟動項目及登入後自動啟動設定，並整理常見權限問題。

本文重點

在 Linux 桌面安裝 v2rayN，先依發行版與 CPU 架構選擇套件，再交由套件管理工具處理相依套件。首次請以一般使用者身分啟動並確認本機代理可用，最後設定登入後自動啟動。本文說明桌面啟動項目與背景服務的差異，適合需要在 Debian、Ubuntu、Fedora 或 openSUSE 長期使用桌面用戶端的使用者。

安裝前：確認發行版、架構與執行方式

v2rayN 是桌面用戶端，Linux 圖形介面版本採用 Avalonia。用戶端負責管理設定、啟動核心及顯示記錄；實際處理代理連線的是所選核心。安裝桌面套件不代表已安裝開機即執行的系統服務，也不表示所有應用程式都已透過代理連線。

請先執行以下兩個指令。uname -m 回傳 x86_64 時選擇 x64 套件，回傳 aarch64 時選擇 arm64 套件；使用 deb 或 rpm 則依發行版而定。請勿只憑電腦品牌判斷架構。

cat /etc/os-release
uname -m

Debian / Ubuntu

套件格式
deb
x64 架構名稱
amd64
ARM 架構名稱
arm64
安裝工具
apt

也可以使用 dpkg-deb 讀取套件架構，再與本機 dpkg 架構比對。

Fedora / openSUSE

套件格式
rpm
x64 架構名稱
x86_64
ARM 架構名稱
aarch64
安裝工具
dnf / zypper

兩者都使用 rpm 套件，但軟體來源與相依套件名稱可能不同。

以下將下載的安裝套件重新命名為 v2rayN.deb 或 v2rayN.rpm，並放在 ~/Downloads。這只是本機操作時使用的名稱，不是伺服器上的原始檔名；若下載位置不同，請先切換至實際目錄。請從用戶端下載頁面選擇安裝套件，勿強行安裝不同架構的套件。

Debian 與 Ubuntu：使用 apt 安裝本機 deb 套件

建議使用 apt install ./檔名。路徑前的 ./ 表示本機檔案，apt 會透過已啟用的軟體來源解析套件宣告的相依套件。直接執行 dpkg -i 也能解開套件，但不會自動下載缺少的相依套件，不建議只用這個步驟完成首次安裝。

cd ~/Downloads
dpkg --print-architecture
dpkg-deb -f ./v2rayN.deb Package Version Architecture
sudo apt update
sudo apt install ./v2rayN.deb

  1. 確認套件資訊

    比對本機架構與套件的 Architecture 欄位，並記下 Version 欄位；後續排查時，請一併提供用戶端與系統版本。

  2. 安裝相依套件

    先檢視 apt 的安裝計畫。若系統提示需要移除大量桌面元件，請先取消，不要使用強制選項略過衝突。

  3. 首次手動啟動

    在桌面應用程式選單搜尋 v2rayN，並以目前登入的使用者身分開啟。安裝指令需要 sudo，啟動圖形介面則不需要。

  4. 記錄錯誤輸出

    若沒有出現視窗，請讀取桌面啟動檔的 Exec 欄位，再從終端機執行對應程式，並保留完整錯誤訊息。

如果先前使用 dpkg 安裝後留下「未設定」狀態，可執行以下修復指令。此指令可能會安裝相依套件，也可能要求移除無法滿足相依條件的套件；確認處理計畫後再繼續。若無法連線至軟體來源，應先修復網路或來源設定，反覆解開套件無法解決下載失敗。

sudo apt --fix-broken install
sudo dpkg --configure -a

Fedora 與 openSUSE：使用發行版工具安裝 rpm

rpm 是套件格式，不代表各發行版之間完全相容。Fedora 使用 dnf，openSUSE 使用 zypper；兩者都應透過本機套件管理工具處理相依套件。安裝前先檢視套件資訊，確認架構與版本，再執行適用於該發行版的安裝指令。

cd ~/Downloads
rpm -qp --queryformat '%{NAME} %{VERSION}-%{RELEASE} %{ARCH}\n' ./v2rayN.rpm

# Fedora
sudo dnf install ./v2rayN.rpm

# openSUSE：使用這一行即可，不必重複執行上方的 dnf 指令
sudo zypper install ./v2rayN.rpm
提示類型優先檢查項目處理注意事項
架構不符套件的 ARCH 與 uname 輸出重新選擇 x64 或 arm64 套件，不要強制忽略架構差異
找不到相依套件發行版版本與已啟用的軟體來源不要混用不同發行版的基礎執行環境套件
執行環境版本過舊終端機顯示 GLIBC 或其他版本需求評估升級系統，不要手動替換系統 libc
套件來源確認提示下載來源與套件管理工具提示確認來源後再決定如何處理，不要全面停用安全檢查

若安裝成功但無法啟動，請分別確認「套件相依條件已滿足」及「圖形執行環境可用」。沒有圖形工作階段、缺少顯示環境變數，或遠端終端機未連接桌面，都可能導致 GUI 無法開啟。不要以 sudo 啟動來掩蓋這些問題。

首次執行：先確認本機監聽，再啟用系統代理

先匯入已取得的節點或訂閱，選擇可用節點，再確認核心正在監聽。訂閱包含伺服器連線參數，不能用隨意填寫的位址測試。協定與傳輸方式的組合，請以目前核心實際支援的範圍為準；更換核心後也要重新檢查記錄。

若目前版本提供這些選單項目，請前往「設定」→「參數設定」→「基本設定」查看本機監聽連接埠；連接埠與選單分類可能因版本而異，請以介面顯示為準。以下以 HTTP 代理監聽於 127.0.0.1:10808 作為排查範例，並非要求覆寫現有設定。

10808
本文範例的 HTTP 代理連接埠
127.0.0.1
僅供本機連線的監聽位址
15 秒
下方 curl 請求的逾時上限
ss -lntp 'sport = :10808'
curl --proxy http://127.0.0.1:10808 --max-time 15 -I https://example.com/

第一個指令檢查 TCP 監聽，第二個指令明確透過 HTTP 代理連線至測試網站。若該連接埠提供的是 SOCKS 服務，請改用 socks5h://127.0.0.1:10808；此設定會將網域名稱交由代理端解析。若沒有監聽，請先檢查核心啟動錯誤，不要直接歸因於連線速度。

桌面自動啟動：優先使用使用者登入啟動項目

對桌面用戶端而言，「開機自動啟動」通常是指登入圖形桌面後自動啟動。建議使用 XDG Autostart：沿用安裝套件提供的 desktop 檔案，保留正確的 Exec、圖示與啟動參數。如此無須猜測主程式所在目錄，也不必讓整個用戶端以 root 身分執行。

XDG 登入啟動

建議

在目前使用者的圖形工作階段中啟動，沿用桌面環境與使用者設定。適合需要桌面、系統匣與視窗的使用情境。

適用情境：個人 Linux 桌面、登入後自動連線

systemd 服務

服務需要另外規劃執行環境、權限與生命週期。系統層級的服務不會自動取得圖形工作階段，不適合直接套用於桌面 GUI。

適用情境：明確需要獨立執行核心的背景部署

先檢查用戶端「設定」→「參數設定」中是否提供「開機自動啟動」選項。若目前版本已能正確建立使用者啟動項目，直接使用即可；不要再複製一份，以免登入時重複啟動。需要手動設定時，請先找出安裝套件提供的桌面檔案：

find /usr/share/applications -maxdepth 1 -type f -iname '*v2rayn*.desktop' -print

只有在確認找到唯一一個對應檔案後，才執行以下複製操作。指令碼會檢查符合條件的檔案數量，避免從多個桌面啟動項目中任意選取一個。若沒有符合項目，請使用 deb 的 dpkg-deb -c 或 rpm 的 rpm -qlp 檢視套件清單，確認桌面檔案的實際名稱與位置。

bash <<'BASH'
mapfile -t entries < <(find /usr/share/applications -maxdepth 1 -type f -iname '*v2rayn*.desktop')
if [ "${#entries[@]}" -ne 1 ]; then
  printf '必須恰好有一個桌面啟動項目，目前找到 %s 個。\n' "${#entries[@]}"
  exit 1
fi
target="${XDG_CONFIG_HOME:-$HOME/.config}/autostart"
mkdir -p "$target"
cp -- "${entries[0]}" "$target/v2rayN.desktop"
chmod 644 "$target/v2rayN.desktop"
grep -E '^(Type|Name|Exec|TryExec|Hidden|OnlyShowIn|NotShowIn|X-GNOME-Autostart-enabled)=' "$target/v2rayN.desktop"
BASH

儲存後請登出再重新登入，確認只啟動一個用戶端程序，且範例連接埠已恢復監聽。只關閉視窗再重新開啟，無法驗證登入啟動是否生效。用戶端更新後，若安裝路徑或啟動參數有所變更，手動複製的 desktop 檔案也要同步更新。

權限、系統匣與重新啟動後的常見問題

請依序排查「程式能否啟動、核心能否監聽、請求能否透過代理、登入啟動是否生效」。依照這個順序，能避免將視窗隱藏、連接埠衝突與網路故障混為一談。首次部署時，以下四種情況尤其常見。

安裝完成後，選單裡找不到 v2rayN？

先執行上文的 find 指令檢查 desktop 檔案，再檢視套件檔案清單。若檔案存在，可登出後重新登入以更新應用程式選單；若檔案不存在，請確認下載的是預期的桌面套件，不要自行猜測執行路徑。

使用 sudo 可以開啟，一般使用者卻收到權限不足的提示？

先停止以 root 身分啟動的執行個體，再於終端機查看錯誤訊息所涉及的設定目錄，並使用 ls -ld 檢查擁有者。只修正已確認屬於目前使用者的應用程式設定目錄權限；不要遞迴修改整個家目錄或安裝目錄的權限，更不可設定為所有人都能寫入。

登入後沒有視窗，是不是沒有啟動？

先使用系統程序檢視工具搜尋 v2rayN，並確認本機監聽狀態。程式可能已縮小至系統匣；部分桌面環境需要另外啟用系統匣支援。首次確認時，先關閉用戶端的啟動後隱藏選項，確認視窗出現後再調整。

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

執行 ss -lntp 'sport = :10808' 查詢佔用連接埠的程序；若權限不足，可只對這個診斷指令使用 sudo。先排除重複自動啟動，再決定關閉舊執行個體或變更監聽連接埠。變更連接埠後，也要同步更新系統代理與命令列參數。

更新與回復舊版：維持套件管理與啟動項目一致

後續更新請沿用相同的套件管理方式安裝新版。更新前先在用戶端備份設定，並妥善保管訂閱網址與節點憑證；這些資訊可能包含存取權限，不應附在公開的故障截圖中。更新後請再次確認用戶端版本、核心版本、監聽連接埠與自動啟動項目。

  1. 退出用戶端，確認原有程序與核心都已停止，再安裝架構相符的新套件。
  2. 先手動啟動並完成一次明確指定代理的請求，再登出以確認登入啟動有效。
  3. 若新版發生異常，請保留具體錯誤訊息，確認是否因系統執行環境需求變更所致；不要一開始就刪除所有使用者設定。
  4. 需要回復舊版時，請使用套件管理工具支援的版本處理方式；舊版與新版的設定相容性須另外確認，不能假設兩者可雙向相容。
  5. 要取消手動設定的登入啟動，請刪除使用者 autostart 目錄中的對應 desktop 檔案；解除安裝系統套件不一定會刪除使用者複製的檔案。

部署完成的標準不只是「視窗能開啟」，還要確認一般使用者能啟動、代理請求可正常通過、登入後只啟動一次，以及退出後應用程式的網路狀態能恢復。請逐項確認這四點，日後遇到問題時便能快速判斷是安裝、核心、代理入口或桌面工作階段出了狀況。

下載v2rayN