· 平台部署 · 約 8 分鐘

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

在 Debian／Ubuntu 與 Fedora 桌面安裝 v2rayN deb、rpm 套件，處理相依套件與權限，並設定登入桌面後自動啟動。

本文重點

本文適用於已在使用 Linux 圖形桌面的使用者。先確認發行版與處理器架構，再透過系統套件管理工具安裝 v2rayN，接著確認訂閱、監聽連接埠與系統代理，最後設定桌面登入時自動啟動。此處的「開機自動啟動」是指進入使用者桌面後啟動，不是在登入前以系統服務執行。

安裝前：確認發行版、架構與套件格式

deb 與 rpm 是套件格式，不是代理協定。Debian、Ubuntu 通常使用 deb，Fedora 則使用 rpm。檔案都適用於 Linux，不代表可以把 rpm 套件交給 apt 安裝；也不建議先轉換套件格式來規避發行版差異。前往下載頁選擇 Linux 安裝套件時，也要確認處理器架構。

cat /etc/os-release
uname -m
printf '%s\n' "$XDG_CURRENT_DESKTOP" "$XDG_SESSION_TYPE"

uname -m 輸出 x86_64，通常對應 x64 或 amd64 套件；輸出 aarch64，通常對應 arm64 套件。套件名稱中的標記不一定與系統工具輸出使用相同寫法，請以套件中繼資料為準。安裝程式若提示架構不符，請重新選擇安裝套件，不要強制略過檢查。

Debian / Ubuntu

安裝套件
deb
安裝工具
apt
查詢中繼資料
dpkg-deb -f
常見架構名稱
amd64、arm64

使用本機檔案路徑安裝，讓 apt 一併處理已宣告的相依套件。

Fedora

安裝套件
rpm
安裝工具
dnf
查詢中繼資料
rpm -qp
常見架構名稱
x86_64、aarch64

以下 rpm 指令適用於 Fedora；其他 rpm 系發行版請使用各自的套件管理工具。

deb 與 rpm：透過套件管理工具完成安裝

以下指令請在 Bash 終端機執行。安裝套件路徑會由使用者輸入，不依賴固定版本號或假造的檔名。輸入完整的絕對路徑即可；即使路徑含有空格，也不必額外加上引號，指令中的變數已妥善加上引號。先查看中繼資料，再確認安裝作業，避免誤裝下載資料夾中的其他軟體。

在 Debian／Ubuntu 安裝 deb 套件

read -r -p '請輸入 deb 檔案的絕對路徑：' package
if [ -f "$package" ]; then
  dpkg-deb -f "$package" Package Version Architecture
  sudo apt update
  sudo apt install "$package"
else
  printf '%s\n' '找不到檔案，請檢查路徑。'
fi

apt install 會從已設定的軟體來源解析相依套件。若提示無法滿足相依需求，請先檢查發行版版本、軟體來源狀態及安裝套件的需求。不要直接加入其他發行版的軟體來源，也不要使用強制覆寫參數取代系統基礎程式庫。若先前使用 dpkg -i 留下尚未設定的套件，可先執行 sudo apt --fix-broken install，閱讀預計安裝或移除的清單後再確認。

在 Fedora 安裝 rpm 套件

read -r -p '請輸入 rpm 檔案的絕對路徑：' package
if [ -f "$package" ]; then
  rpm -qp --queryformat '%{NAME} %{VERSION}-%{RELEASE} %{ARCH}\n' "$package"
  sudo dnf install "$package"
else
  printf '%s\n' '找不到檔案，請檢查路徑。'
fi

安裝權限與執行權限應分開：寫入系統目錄需要管理員權限；日常啟動 v2rayN 時應使用目前的桌面使用者。安裝後請從應用程式選單搜尋 v2rayN，不要以 sudo 啟動整個圖形用戶端，否則可能產生屬於 root 的設定檔，並影響桌面工作階段存取。

首次執行：先確認本機代理，再設定桌面代理

啟動後先匯入訂閱。訂閱網址提供節點設定，不會由安裝套件自動產生；VMess、VLESS 等是連線協定，不是 deb 或 rpm 的安裝選項。訂閱所含的協定、傳輸與安全設定，必須由目前選用的核心支援。不要為了排除錯誤而任意改寫訂閱中的連接埠、傳輸路徑或 TLS 參數。

  1. 新增訂閱

    在主畫面開啟「訂閱群組」→「訂閱群組設定」，新增群組並填入有效的訂閱網址，儲存後從「訂閱群組」選單更新對應訂閱。不同版本的按鈕文字可能略有差異，請以實際介面為準。

  2. 選擇節點

    更新完成後，在節點清單選取一個項目，使用右鍵選單中的「設為作用中伺服器」。查看記錄，確認核心是否正常啟動；節點出現在清單中，不代表遠端連線已經暢通。

  3. 確認監聽設定

    開啟「設定」→「參數設定」，檢查本機監聽位址、連接埠與輸入類型。本文以下以手動設定為 127.0.0.1:10808 的 SOCKS 輸入為例，實際測試時請使用介面顯示的數值。

  4. 設定代理

    先完成下方指令測試，再設定桌面代理。GNOME 通常位於系統「設定」→「網路」→「網路代理」→「手動」；KDE Plasma 通常位於「系統設定」→「網路」→「代理」，實際分類會依桌面版本而異。

127.0.0.1
本機監聽位址範例
10808
本文採用的 SOCKS 範例連接埠
15 秒
下方連線測試的逾時上限
ss -lntp | grep ':10808'
curl --proxy socks5h://127.0.0.1:10808 \
  --connect-timeout 15 --max-time 30 \
  -I https://v2rayhk.com/

第一個指令檢查 TCP 監聽狀態；第二個指令明確透過 SOCKS 代理發出請求，並由代理端解析目標網域。這只用於測試連線，不是速度或匿名性評測。若實際設定為 HTTP 輸入，請改用對應的 HTTP 代理位址，不要把 SOCKS 連接埠填入桌面的 HTTP 代理欄位。不同應用程式支援桌面代理的程度不一，終端機工具也不一定會讀取圖形桌面的設定。

桌面自動啟動：複製現有啟動項目

圖形用戶端通常依賴使用者工作階段。若希望「開機後自動顯示用戶端」，應設定桌面登入時自動啟動，而非建立 root 系統服務。標準做法是將安裝套件提供的 .desktop 啟動項目複製到目前使用者的 ~/.config/autostart/；保留原始的 Exec，可避免猜錯可執行檔路徑。

登入桌面時自動啟動

建議方式

在目前使用者的桌面工作階段啟動 v2rayN，沿用應用程式選單啟動項目中的執行參數，方便存取使用者設定與桌面代理設定。

適用情境：Debian、Ubuntu、Fedora 圖形桌面的日常使用。

從應用程式選單手動啟動

先確認安裝、訂閱與代理連線正常，再決定是否啟用自動啟動。排除問題時可暫時採用此方式，減少重複執行個體與啟動時序造成的干擾。

適用情境：首次部署、偶爾使用，或正在排查啟動失敗。

尋找並複製啟動檔案

find /usr/share/applications "$HOME/.local/share/applications" \
  -maxdepth 1 -type f -iname '*v2rayn*.desktop' -print 2>/dev/null

read -r -p '請輸入找到的 desktop 檔案完整路徑：' entry
if [ -f "$entry" ]; then
  grep -E '^\[Desktop Entry\]|^(Name|Exec|TryExec|Hidden|OnlyShowIn|NotShowIn|X-GNOME-Autostart-enabled)=' "$entry"
  mkdir -p "$HOME/.config/autostart"
  cp -- "$entry" "$HOME/.config/autostart/v2rayn.desktop"
  chmod 644 "$HOME/.config/autostart/v2rayn.desktop"
else
  printf '%s\n' '找不到啟動檔案，請先確認安裝是否完成。'
fi

複製前請確認目標檔案沒有需要保留的自訂設定；上方的複製指令會覆寫同名的自動啟動項目。若找不到搜尋結果，可在應用程式選單查看啟動器屬性，或透過安裝套件的檔案清單定位；不要自行撰寫未經確認的 Exec=v2rayN。deb 可使用 dpkg-deb -c 查看套件內容，rpm 則可使用 rpm -qpl 查看檔案路徑。

若要停止自動啟動，只要刪除使用者目錄中的副本：rm "$HOME/.config/autostart/v2rayn.desktop"。這不會解除安裝應用程式。若用戶端內部也啟用了自動啟動，請先確認它是否管理同一個檔案，避免同時維護兩個啟動入口。桌面自動啟動也不代表系統代理會自動開啟；後者仍取決於用戶端儲存的設定與桌面環境。

相依套件、權限與登入啟動問題排解

排查時應由本機往遠端逐步檢查：程式能否執行、核心能否啟動、連接埠是否正在監聽、代理請求是否成功，以及應用程式是否遵循代理設定。如此可分別處理「安裝失敗」、「節點無法連線」與「桌面未使用代理」，避免反覆重新安裝卻沒有修正真正出錯的環節。

安裝時提示缺少相依套件，需要手動下載程式庫嗎？

先查看 apt 或 dnf 顯示的完整相依套件名稱與版本條件，並確認軟體來源可用、架構正確。若套件要求的基礎程式庫版本高於目前發行版所提供的版本，請改用相容套件或升級發行版；不要任意替換系統程式庫檔案。

點擊圖示沒有反應，該怎麼查？

查看啟動項目的 Exec，並在一般使用者的終端機執行其中的程式與實際參數；記得移除僅供桌面啟動器使用的 %U、%F 等欄位代碼。記錄缺少程式庫、顯示工作階段或設定權限相關錯誤，再依錯誤內容處理，不要直接改用管理員身分執行。

記錄顯示連接埠已被占用，該怎麼辦？

執行 ss -lntp | grep ':10808' 檢查範例連接埠。先關閉重複啟動的用戶端；若該連接埠確實由其他程式使用，請在參數設定中改用未占用的連接埠，並同步更新桌面代理與測試指令。

登入後沒有視窗，是自動啟動失敗嗎？

先執行 pgrep -afi v2rayn 檢查程序，再確認是否設定為啟動後最小化。部分桌面環境預設未啟用系統匣擴充功能，沒有系統匣圖示不代表程式沒有執行；也請檢查自動啟動檔案中的隱藏及桌面環境限制鍵值。

一般代理可以使用，TUN 卻啟動失敗？

TUN 涉及虛擬網卡、路由與額外權限，不是一般本機代理的必要條件。請先關閉 TUN，完成基本連線測試，再依目前版本的提示設定權限；若懷疑 Fedora 的安全政策阻擋操作，請查看拒絕記錄，不要直接停用安全機制。

升級前請先退出用戶端，並保留目前使用者的設定。繼續使用相同的套件管理工具安裝新套件，完成後再確認應用程式選單啟動項目與自動啟動副本的 Exec 是否仍一致。解除安裝軟體套件通常不會自動清除使用者目錄中的所有設定及手動複製的自動啟動項目，因此解除安裝後也應檢查 ~/.config/autostart/。其他連線問題可依問題排解中的檢查順序繼續查找原因。

下載v2rayN用戶端與平台選擇