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

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

v2rayN 是桌面圖形用戶端，V2Ray、Xray 等核心負責實際處理連線。安裝用戶端、啟動核心，以及讓應用程式使用代理，是三個不同環節。本文說明安裝與桌面工作階段設定，不會將 Android 用戶端 v2rayNG、v2flyNG 的操作方式套用到 Linux。

開啟終端機，查看發行版資訊與電腦架構。Debian、Ubuntu 通常選擇 deb；Fedora 則選擇 rpm。其他發行版即使也使用 rpm，仍應先確認目前發行版符合套件相依需求，不能只憑副檔名判定相容性。

cat /etc/os-release
uname -m

前往用戶端下載頁選擇 Linux 與相應架構。以下安裝命令假設你已在檔案管理員中將下載的檔案重新命名為 v2rayn-linux.deb 或 v2rayn-linux.rpm，並在該檔案所在資料夾開啟終端機。重新命名只是方便輸入命令，不會變更套件內的版本、套件名稱或架構。

二、安裝 deb／rpm 套件，依錯誤訊息處理相依性

建議使用 apt 或 dnf 安裝本機套件，而不是只執行底層安裝命令。套件管理工具可從已啟用的套件來源解析相依性；若目前的套件來源無法使用，安裝仍會失敗。此時應先修復網路或套件來源，不要略過相依性檢查。

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

# 在 deb 檔案所在目錄執行
dpkg-deb -f ./v2rayn-linux.deb Package Version Architecture
sudo apt update
sudo apt install ./v2rayn-linux.deb

./ 代表目前目錄中的檔案。若省略它，apt 可能會將輸入內容視為套件來源中的套件名稱。若先前使用 dpkg -i 安裝後留下尚未設定的相依套件，可執行以下修復命令。確認 apt 提出的安裝或移除方案符合預期後再繼續，接著重新執行本機套件安裝。

sudo apt --fix-broken install

Fedora：使用 dnf 安裝本機 rpm 套件

# 在 rpm 檔案所在目錄執行
rpm -qp --queryformat '%{NAME} %{VERSION}-%{RELEASE} %{ARCH}\n' ./v2rayn-linux.rpm
sudo dnf install ./v2rayn-linux.rpm

• 若顯示架構錯誤：重新確認 uname -m 的結果，不要強制安裝不同架構的套件。
• 若顯示缺少相依套件：記下完整的套件名稱或函式庫名稱，並檢查套件來源是否已啟用、是否支援目前的系統版本。
• 若顯示檔案衝突：先查明舊檔案的安裝來源，不要直接覆寫系統目錄中的檔案。
• 若顯示函式庫版本過舊：優先確認用戶端支援的系統需求，不要將其他發行版的基礎函式庫複製到系統目錄。

三、首次啟動：分別確認訂閱、監聽連接埠與系統代理

安裝完成後，從桌面應用程式選單搜尋 v2rayN。先確認主視窗能正常開啟，再匯入連線設定。選單名稱可能會隨版本調整；以下以桌面版常見的「訂閱群組」、「設定」、「參數設定」等名稱說明。若目前版本的名稱不同，請依功能判斷，不要尋找 Android 版的選單位置。

1. 啟動用戶端

   從應用程式選單啟動 v2rayN。若沒有出現視窗，先在終端機執行桌面啟動器中 Exec= 所指定的程式，以查看是否有缺少函式庫或顯示工作階段錯誤。

2. 匯入訂閱

   前往「訂閱群組」→「訂閱群組設定」，新增群組、填寫備註與訂閱網址後儲存，再從「訂閱群組」執行更新。若使用分享連結，請透過主畫面的剪貼簿匯入功能加入。

3. 選擇伺服器

   從清單中選取可用設定，並設為目前使用的伺服器。VMess、VLESS 等設定參數由訂閱或分享連結提供；排除問題時，不要任意修改傳輸方式、TLS 或伺服器位址。

4. 確認監聽狀態

   前往「設定」→「參數設定」，查看基本設定中的本機監聽連接埠，並檢查記錄是否有核心啟動失敗或連接埠遭占用的訊息。儲存設定後，依用戶端提示重新啟動相關服務。

5. 設定系統代理

   從主畫面或系統匣的「系統代理」選單選擇「自動設定系統代理」。接著檢查桌面環境的網路代理設定，並另外確認應用程式是否會遵循該設定。

以下兩個連接埠只是方便說明的常見設定範例，並非所有版本的預設值。請以本機的參數設定為準；若用戶端使用單一混合連接埠，應依該入口實際支援的協定進行測試，不必另外建立第二個監聽。

# 查看是否有對應的 TCP 監聽；請依本機設定調整連接埠
ss -lntp | grep -E ':(10808|10809)\b'

# 確認對應的監聽協定後再測試；系統需已安裝 curl
curl --connect-timeout 10 --max-time 20 \
  --proxy socks5h://127.0.0.1:10808 https://example.com/

curl --connect-timeout 10 --max-time 20 \
  --proxy http://127.0.0.1:10809 https://example.com/

明確指定代理的 curl 請求，有助於區分「代理服務無法使用」與「應用程式未使用代理」。socks5h 會將目標網域名稱交由代理端解析；請求成功仍不代表所有應用程式都已使用代理。系統代理也不等於路由模式：「全域」或「繞過中國大陸」等規則，會決定已送入核心的請求如何路由，無法讓忽略系統代理的應用程式自動使用代理。

四、系統匣沒有圖示：先檢查桌面環境

Linux 系統匣能否顯示圖示，取決於桌面環境提供的狀態圖示機制。若主視窗與核心都正常，但系統匣圖示未顯示，通常應先檢查桌面整合，不必立即重新安裝用戶端。特別是在 GNOME 中，桌面環境本身可能尚未啟用應用程式指示器支援。

• GNOME：開啟系統的擴充功能管理工具，確認是否已安裝並啟用 AppIndicator／KStatusNotifierItem 支援。Debian／Ubuntu 可先用 apt search appindicator 搜尋目前套件來源提供的擴充功能；Fedora 則可使用 dnf search appindicator。套件名稱與可用版本依目前發行版而異。
• KDE Plasma：在系統匣按右鍵開啟設定，檢查「項目」中是否將應用程式狀態設為隱藏，並查看折疊區域。
• Xfce：確認面板是否已加入支援狀態通知的系統匣外掛；若沒有面板顯示圖示，單靠用戶端設定無法補出系統匣圖示。
• 遠端或精簡桌面：確認目前工作階段確實有執行面板與系統匣元件，而不只是視窗管理員。

安裝或啟用桌面擴充功能後，先儲存工作並登出、重新登入，通常比反覆強制結束用戶端程序更有助於排查問題。Wayland 工作階段不適用其他工作階段的桌面重新啟動快捷操作。若主視窗本身無法開啟，請回到終端機檢查啟動錯誤；系統匣擴充功能無法修復缺少執行階段函式庫的問題。

五、設定桌面自動啟動，登入後執行

圖形用戶端應隨使用者的桌面工作階段啟動。XDG 自動啟動目錄 ~/.config/autostart/ 正適用於此情境。它不會在登入畫面出現前啟動，也不需要寫入 /etc/rc.local 或建立 root 排程工作。先確認手動執行正常，再設定自動啟動，問題會更容易排查。

尋找套件安裝的桌面啟動器

透過原套件查詢檔案清單，能保留發行者設定的啟動路徑、參數與圖示。以下只需執行符合本機套件格式的其中一組命令；若已移動安裝套件，請先切換到目前所在目錄。

# Debian / Ubuntu
pkg_name=$(dpkg-deb -f ./v2rayn-linux.deb Package)
dpkg -L "$pkg_name" | grep -E '/applications/.*\.desktop$'

# Fedora
pkg_name=$(rpm -qp --queryformat '%{NAME}' ./v2rayn-linux.rpm)
rpm -ql "$pkg_name" | grep -E '/applications/.*\.desktop$'

從輸出結果中選擇用來啟動主介面的 .desktop 檔案。如果套件內有多個啟動器，先查看各檔案中的 Name= 與 Exec=，不要複製解除安裝入口或輔助工具。接著在 Bash 終端機執行以下命令，出現提示時貼上前一步查到的完整路徑，不要加引號。

read -r -p "貼上主介面 .desktop 檔案的完整路徑：" desktop_file

if [ -f "$desktop_file" ]; then
  mkdir -p "$HOME/.config/autostart"
  install -m 644 "$desktop_file" \
    "$HOME/.config/autostart/v2rayn.desktop"
  sed -i '/^Hidden=/d; /^X-GNOME-Autostart-enabled=/d' \
    "$HOME/.config/autostart/v2rayn.desktop"
  grep -E '^(Name|Exec|TryExec|Hidden|OnlyShowIn|NotShowIn|X-GNOME-Autostart-enabled)=' \
    "$HOME/.config/autostart/v2rayn.desktop"
else
  printf '%s\n' "檔案不存在，未建立自動啟動項目。"
fi

這項操作會保留原啟動器的執行命令，並移除可能阻止自動啟動的兩個選項。若仍有 OnlyShowIn= 或 NotShowIn=，請檢查其中的桌面環境限制是否符合目前工作階段。不要直接將 Exec= 改成程式檔名並猜測路徑，也不要在其中加入 ~、管線或 &；桌面啟動器不會像一般 shell 腳本那樣解讀內容。

測試、停用與升級後檢查

1. 在用戶端中確實執行「結束」，確認沒有殘留視窗或重複執行的執行個體。
2. 儲存其他工作並登出，再次登入後確認 v2rayN 是否啟動，以及本機監聽是否恢復。
3. 確認系統代理設定符合預期；程式自動啟動，不代表會自動選擇伺服器或還原所有代理狀態。
4. 若要停用，執行以下刪除命令即可移除使用者的自動啟動副本，不會解除安裝用戶端。

rm -f "$HOME/.config/autostart/v2rayn.desktop"

如果用戶端本身也有開機啟動選項，請在內建選項與手動建立的項目中擇一使用，避免重複啟動。升級後若安裝路徑或啟動參數有所變更，請從新版套件提供的啟動器重新複製；自動啟動目錄中的舊副本不會隨系統目錄自動更新。

六、安裝與自動啟動常見問題

穩妥的部署順序是：成功安裝套件、以一般使用者帳號手動啟動成功、確認代理連線正常，最後再測試登入後自動啟動。每完成一個階段再進入下一階段，才不會把相依性、桌面系統匣與遠端連線問題混在一起。更多初始設定步驟請參閱入門指南；協定欄位與路由概念請見協定手冊。