v2rayN Linux 桌面安裝：deb/rpm 套件安裝與開機自動啟動設定

確認安裝套件與系統架構

Linux 安裝的第一步不是直接雙擊檔案，而是確認發行版套件格式與處理器架構。Ubuntu、Debian、Linux Mint 等 Debian 系發行版使用 deb 套件；Fedora、Rocky Linux 等 RPM 系發行版使用 rpm 套件。套件格式選錯時，圖形化軟體中心通常只會顯示無法安裝或不支援該格式。

處理器架構同樣必須相符。常見桌上型電腦執行 uname -m 後通常會回傳 x86_64，對應下載項目中的 x64 或 64；部分 ARM 桌面裝置會回傳 aarch64，對應 arm64。不要依系統名稱猜測架構，也不要把 Android 安裝套件用於 Linux 桌面。

也可以執行 cat /etc/os-release 查看發行版名稱與版本。遠端連線至多台主機時，這個指令比依賴桌面外觀判斷更可靠。v2rayN 是桌面客戶端，本文的自動啟動設定也以已登入圖形工作階段的普通使用者為界線，不應將圖形程式設定為 root 層級的系統服務。

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

deb 與 rpm 本機安裝流程

下載完成後，建議從終端機呼叫系統套件管理器進行安裝，而不是直接使用底層的 dpkg -i 或 rpm -i。APT 與 DNF 會讀取套件的相依性宣告，並從目前啟用的軟體來源補齊缺少的共享函式庫。安裝指令必須在安裝套件所在的目錄執行，檔案萬用字元也應確保只比對到一個 v2rayN 套件。

1. 確認架構

   執行 uname -m。回傳 x86_64 時選擇 x64 套件，回傳 aarch64 時選擇 arm64 套件。

2. 選擇套件格式

   Ubuntu、Debian 選擇 deb；Fedora 選擇 rpm。安裝套件請僅從本站客戶端頁面的 Linux 平台取得。

3. 執行安裝

   在下載目錄執行 sudo apt install ./v2rayN-linux-*.deb，或在 Fedora 執行 sudo dnf install ./v2rayN-linux-*.rpm。

4. 定位程式

   執行 command -v v2rayN，記下實際的可執行檔路徑。常見結果為 /usr/bin/v2rayN。

5. 完成首次啟動

   從應用程式選單啟動 v2rayN，進入「設定」→「參數設定」→「Core 類型」，確認使用 Xray 內核並儲存。

Ubuntu 與 Debian 建議使用 sudo apt install ./v2rayN-linux-*.deb。指令中的 ./ 表示安裝目前目錄中的本機檔案；省略這段時，APT 會將名稱視為軟體庫套件進行查詢。若先前使用 dpkg -i 後出現相依性未設定完成的情況，可執行 sudo apt --fix-broken install 修復，再重新執行本機安裝指令。

Fedora 使用 sudo dnf install ./v2rayN-linux-*.rpm。DNF 5 會列出需要補充的套件、下載大小與安裝結果。若系統啟用了嚴格的軟體來源政策，先執行 sudo dnf makecache 更新中繼資料，再重試安裝；不要略過相依性，強行寫入 rpm 資料庫。

cd "$HOME/Downloads"

# Ubuntu / Debian
sudo apt update
sudo apt install ./v2rayN-linux-*.deb

# Fedora
sudo dnf makecache
sudo dnf install ./v2rayN-linux-*.rpm

# 安裝後確認
command -v v2rayN
v2rayN --version

首次啟動、訂閱與內核監聽

程式成功開啟只代表圖形介面可以執行，不表示代理鏈路已建立。完整狀態至少包括四項：訂閱已更新、節點已選取、Xray 內核程序正常運作，以及桌面應用程式流量已進入本機監聽連接埠。首次設定應依照這個順序執行，避免在系統代理尚未啟用時誤判節點無法使用。

在 v2rayN 主介面新增訂閱後，先更新目前的訂閱群組，再選取節點並啟動。VLESS、VMess 等協定參數通常會由訂閱匯入；手動修改位址、連接埠、UUID、傳輸方式或 TLS 項目，可能造成設定與伺服器端不一致。訂閱只負責分發設定，客戶端本身不會提供節點位址。

v2rayN 常見的本機 SOCKS 監聽連接埠為 10808，HTTP 監聽連接埠為 10809。實際值應以「設定」→「參數設定」中的本機監聽設定為準，因為舊設定移轉、連接埠衝突或使用者修改都可能改變最終連接埠。執行 ss -lntp 即可直接確認對應連接埠是否處於 LISTEN 狀態。

確認連接埠存在後，可分別測試 SOCKS 與 HTTP 路徑。SOCKS 測試建議使用 socks5h，其中字母 h 表示網域名稱解析也會經由代理處理。測試能回傳 HTTP 回應標頭，表示本機客戶端、所選節點與目標網站之間已建立基本連線；若只有瀏覽器失敗，排查重點應轉向桌面代理與瀏覽器代理設定。

ss -lntp | grep -E '10808|10809'

curl -I --proxy socks5h://127.0.0.1:10808 https://v2rayair.com/
curl -I --proxy http://127.0.0.1:10809 https://v2rayair.com/

systemd 使用者層級開機自動啟動

Linux 桌面程式適合使用 systemd 使用者層級服務，而不是寫入 /etc/systemd/system 的系統層級服務。使用者服務會在桌面帳號登入後執行，能夠繼承使用者目錄、D-Bus 工作階段與圖形環境資訊；系統層級服務則可能在登入畫面出現前啟動，此時缺少圖形工作階段，v2rayN 視窗與托盤狀態都可能無法正常建立。

建立服務前，先執行 command -v v2rayN。下方範例使用常見路徑 /usr/bin/v2rayN；若指令回傳其他路徑，必須修改 ExecStart。服務檔案儲存於目前使用者的 ~/.config/systemd/user/，整個過程不使用 sudo。

mkdir -p "$HOME/.config/systemd/user"

cat > "$HOME/.config/systemd/user/v2rayn.service" <<'EOF'
[Unit]
Description=v2rayN Linux desktop client
After=graphical-session.target network-online.target
PartOf=graphical-session.target

[Service]
Type=simple
ExecStart=/usr/bin/v2rayN
Restart=on-failure
RestartSec=5

[Install]
WantedBy=graphical-session.target
EOF

systemctl --user daemon-reload
systemctl --user enable --now v2rayn.service

Restart=on-failure 只會在程序異常結束時重新啟動，正常關閉客戶端不會形成持續啟動迴圈；RestartSec=5 提供 5 秒間隔，避免設定錯誤時快速重複啟動。PartOf=graphical-session.target 讓服務隨圖形工作階段結束，適合需要視窗與托盤互動的客戶端。

部分桌面環境不會主動啟動 graphical-session.target，或使用者管理器未及時取得 Wayland、X11 與 D-Bus 環境變數。先匯入環境，再重新啟動服務。若服務狀態顯示成功但介面沒有出現，可檢查 systemctl --user show-environment 中是否存在 DISPLAY、WAYLAND_DISPLAY 與 DBUS_SESSION_BUS_ADDRESS。

systemctl --user import-environment DISPLAY WAYLAND_DISPLAY XDG_CURRENT_DESKTOP DBUS_SESSION_BUS_ADDRESS
dbus-update-activation-environment --systemd DISPLAY WAYLAND_DISPLAY XDG_CURRENT_DESKTOP DBUS_SESSION_BUS_ADDRESS

systemctl --user restart v2rayn.service
systemctl --user status v2rayn.service
journalctl --user -u v2rayn.service -b --no-pager

• Loaded 為 loaded：systemd 已讀取服務檔案，語法與路徑至少可以解析。
• Active 為 active (running)：v2rayN 主程序仍在執行，但仍需檢查 Xray 內核與監聽連接埠。
• 狀態為 203/EXEC：ExecStart 路徑錯誤、檔案不存在或不可執行。
• 短時間內重複啟動：讀取日誌最後 30 行，檢查設定損壞、連接埠占用與圖形環境變數。
• 手動啟動正常、自動啟動失敗：重點比較登入終端機與 systemd 使用者管理器的環境變數。

若桌面環境不啟用 graphical-session.target，可以將服務安裝目標調整為 default.target，但仍應保留圖形環境匯入。修改後執行 systemctl --user disable v2rayn.service，編輯服務檔案，再執行 systemctl --user daemon-reload 與 systemctl --user enable --now v2rayn.service。不要同時設定 systemd 服務與桌面環境自動啟動項目，否則登入時可能出現兩個啟動要求。

系統代理生效與路由驗證

自動啟動成功後，還要區分「客戶端啟動」與「系統代理已接管」兩種狀態。v2rayN 可以在啟動後執行內核，但系統代理開關是否自動恢復，取決於客戶端參數、桌面環境與上次結束時的狀態。登入後應先觀察托盤狀態，再開啟「設定」→「參數設定」，確認啟動行為與系統代理相關選項。

系統代理主要影響會讀取桌面代理設定的應用程式。終端機中的 curl、套件管理器與開發工具可能忽略桌面設定，或只讀取 http_proxy、https_proxy 與 all_proxy 環境變數。因此，「瀏覽器可以存取但終端機無法連線」通常不是路由規則失效，而是兩個程式採用了不同的代理入口。

驗證路由時，可以先將 v2rayN 切換至全域代理模式，確認節點與傳輸鏈路正常，再恢復規則模式。全域模式可用而規則模式不可用，表示問題較可能出在網域、IP、geosite、geoip 或出站標籤匹配；兩種模式都不可用，則應先查看節點參數、時間同步、DNS 與核心日誌。

VMess 對系統時間偏差較敏感，VLESS Reality 也依賴正確的網域、連接埠、伺服器名稱、指紋與公鑰參數。執行 timedatectl status，確認 System clock synchronized 為 yes。若時間尚未同步，可啟用系統的網路時間服務後重新測試連線。

1. 執行 systemctl --user status v2rayn.service，確認桌面客戶端程序處於執行狀態。
2. 執行 ss -lntp，確認設定中的 SOCKS 或 HTTP 連接埠正在監聽。
3. 使用明確的 curl --proxy 指令驗證本機代理入口，不依賴桌面環境。
4. 開啟桌面網路代理頁面，確認位址為 127.0.0.1 且連接埠一致。
5. 分別測試全域與規則模式，判斷故障位於基礎連線還是路由匹配。
6. 執行 journalctl --user -u v2rayn.service -b，保留本次啟動週期的日誌線索。

timedatectl status
systemctl --user status v2rayn.service
ss -lntp | grep -E '10808|10809'
journalctl --user -u v2rayn.service -b -n 30 --no-pager

常見安裝與自動啟動問題

Linux 桌面部署中的多數問題都可歸入四類：安裝套件不相容、可執行檔路徑變更、圖形工作階段環境未匯入，以及本機連接埠被占用。依安裝層、程序層、內核層、系統代理層逐級檢查，比反覆解除安裝再安裝更容易找出真正原因。

升級 v2rayN 後應再次執行 command -v v2rayN，確認套件管理器沒有變更啟動路徑。然後重新啟動使用者服務並檢查日誌。訂閱更新失敗時，先確認訂閱位址完整、系統時間正確，以及目前網路可以存取訂閱服務；若需要透過既有節點更新訂閱，應在訂閱設定中啟用相應的代理更新選項。

解除安裝前若已建立 systemd 使用者服務，應先執行 systemctl --user disable --now v2rayn.service，再刪除 ~/.config/systemd/user/v2rayn.service 並重新載入使用者服務。如此可避免套件解除安裝後，使用者管理器仍嘗試呼叫已不存在的可執行檔。

systemctl --user disable --now v2rayn.service
rm "$HOME/.config/systemd/user/v2rayn.service"
systemctl --user daemon-reload
systemctl --user reset-failed