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

安裝前檢查系統架構與桌面工作階段

先在終端機確認處理器架構，不要只依發行版名稱選擇軟體套件。一般桌上型電腦會輸出 x86_64，對應下載頁中的 64 位元或 x64 套件；部分 ARM 裝置會輸出 aarch64，應選擇 arm64 套件。兩種套件不能混裝，架構選錯通常會直接出現「軟體套件架構不相容」或「無法執行二進位檔」。

uname -m
cat /etc/os-release
echo "$XDG_CURRENT_DESKTOP"
echo "$XDG_SESSION_TYPE"

/etc/os-release 可用來判斷套件系統：Ubuntu、Debian、Linux Mint 等優先使用 deb；Fedora、Rocky Linux、openSUSE 等 rpm 系發行版則使用 rpm。桌面工作階段也會影響系統匣與自動啟動行為，GNOME、KDE Plasma、Xfce 的狀態區域實作並不完全相同。

本文命令以 64 位元測試機為例：Ubuntu 24.04、GNOME、Wayland，以及 Fedora 42、KDE Plasma、Wayland。不同版本的安裝套件檔名可能隨發布方式調整，因此執行安裝命令前，應先用 ls -lh ~/Downloads 核對實際檔名。

在 Ubuntu 與 Debian 安裝 deb 套件

進入本站用戶端頁面，選擇 Linux 平台並下載符合架構的 v2rayN deb 套件。下載後先核對檔案類型，再交由 APT 安裝本機套件。使用 apt install 而不是直接呼叫底層解包命令，可讓套件管理器同時解析軟體源中可用的相依套件。

1. 核對架構

   執行 uname -m。輸出 x86_64 時選擇 64 位元套件，輸出 aarch64 時選擇 arm64 套件。

2. 取得安裝套件

   開啟用戶端頁面的 Linux 標籤，下載 deb 檔案並儲存至目前使用者的 Downloads 目錄。

3. 安裝軟體套件

   在下載目錄執行本機安裝命令。APT 會讀取套件資訊，並從已設定的軟體源補足可用的相依套件。

4. 選擇核心

   啟動後開啟「設定」→「參數設定」→「Core 類型」，選擇 Xray，然後儲存並重新啟動核心。

5. 驗證代理

   匯入訂閱並選擇節點，開啟系統代理，再檢查本機監聽連接埠與核心記錄是否正常。

cd ~/Downloads
ls -lh v2rayN*.deb
sudo apt update
sudo apt install ./v2rayN-linux-64.deb

如果下載的是 arm64 套件，請將命令中的檔名改為終端機顯示的 arm64 檔名。檔名區分大小寫，也不能省略本機路徑前面的 ./。安裝完成後，可在應用程式選單搜尋 v2rayN，或執行 command -v v2rayN 尋找可執行檔。

出現未滿足相依性時，先完成系統軟體源更新，再執行修復安裝。不要反覆雙擊套件，因為圖形化軟體中心可能只顯示「安裝失敗」，不會提供具體缺少的函式庫。

sudo apt --fix-broken install
sudo apt install ./v2rayN-linux-64.deb
apt-cache policy libicu-dev

若終端機明確提示缺少特定執行函式庫，請依錯誤訊息中的套件名稱，從目前發行版的軟體源安裝。跨發行版複製單一共享函式庫可能造成版本鏈不一致，不適合作為長期解決方案。

在 Fedora 與 rpm 系發行版安裝 rpm 套件

Fedora 使用 DNF 安裝本機 rpm 套件。DNF 會檢查架構、簽章中繼資料與相依關係，並將安裝記錄納入系統套件資料庫。命令中的 ./ 同樣表示目前目錄中的本機檔案。

cd ~/Downloads
ls -lh v2rayN*.rpm
sudo dnf install ./v2rayN-linux-64.rpm

如果系統啟用了較新的 DNF 命令實作，安裝語法維持不變。升級至新版本時，可以再次對下載的新 rpm 檔案執行本機安裝；套件管理器會依版本號完成替換，使用者設定通常會繼續保留在家目錄中。

安裝後可執行以下命令，確認套件記錄與程式入口。若 rpm -qa 能查到套件，但 command -v 沒有輸出，可用 rpm -ql 查看套件實際安裝了哪些檔案。

rpm -qa | grep -i v2rayn
command -v v2rayN
rpm -ql v2rayN | grep -E '/bin/|applications'

完成首次啟動、核心與代理連接埠設定

首次開啟後先檢查核心，不要立即啟用系統代理。進入「設定」→「參數設定」→「Core 類型」，選擇訂閱節點所需的 Xray 核心；儲存後執行一次核心重啟。VLESS、VMess 等節點參數通常會由訂閱匯入，手動修改傳輸方式、安全設定或伺服器位址可能導致連線失敗。

接著在「訂閱群組」中新增訂閱網址，更新訂閱並選擇一個節點。需要測試基本連通性時，可先使用主介面的延遲測試，再查看執行記錄。有延遲結果只代表探測程序完成，網頁能否存取仍取決於系統代理、DNS 與路由設定。

開啟系統代理後，使用 ss 檢查本機監聽狀態。以下命令只檢查常見連接埠 10808；如果參數設定使用了其他連接埠，請同步替換查詢條件。

ss -lntp | grep 10808
curl --proxy http://127.0.0.1:10808 https://example.com/ -I

如果 ss 沒有結果，先查看 v2rayN 記錄中的核心啟動錯誤。常見原因包括連接埠已被占用、核心路徑無法執行、設定產生失敗或節點欄位不完整。若監聽正常但瀏覽器仍直接連線，請檢查桌面系統的網路代理是否已切換至 v2rayN 提供的本機位址。

• 僅供本機使用時，請將監聽位址維持為 127.0.0.1，避免將代理連接埠暴露給區域網路。
• 更換連接埠後，也要同步更新系統代理設定，舊連接埠不會自動跟著變更。
• 切換節點後觀察記錄是否出現新的輸出連線，不要只看介面上的選取狀態。
• 需要路由分流時，先使用預設規則，再逐項新增網域或 IP 規則。

修復桌面圖示與系統匣圖示

套件安裝完成但應用程式選單中沒有圖示時，先確認桌面入口檔案是否存在。標準入口通常位於 /usr/share/applications；目前使用者也可以在 ~/.local/share/applications 放置自己的入口。桌面資料庫尚未重新整理時，登出後重新登入通常比反覆安裝更直接。

find /usr/share/applications ~/.local/share/applications \
  -iname '*v2rayn*.desktop' 2>/dev/null
update-desktop-database ~/.local/share/applications 2>/dev/null || true

若套件沒有產生可用入口，可以建立使用者層級的桌面檔案。執行前先用 command -v v2rayN 確認可執行檔路徑；如果結果不是 /usr/bin/v2rayN，請在檔案中使用終端機實際回傳的路徑。

mkdir -p ~/.local/share/applications
cat > ~/.local/share/applications/v2rayN.desktop <<'EOF'
[Desktop Entry]
Type=Application
Name=v2rayN
Comment=Proxy client
Exec=/usr/bin/v2rayN
Icon=v2rayN
Terminal=false
Categories=Network;
StartupNotify=true
EOF
chmod 644 ~/.local/share/applications/v2rayN.desktop
update-desktop-database ~/.local/share/applications

系統匣問題通常不會阻止核心執行。可先用 pgrep -af v2rayN 與 ss -lntp 判斷程序、連接埠是否正常，再單獨修復桌面狀態區域。如此可以區分「介面入口缺失」與「代理核心未啟動」這兩類問題。

設定桌面自動啟動或 systemd 使用者服務

Linux 桌面上有兩種常見的自動啟動方式。XDG 桌面自動啟動會隨圖形工作階段啟動，能直接取得 Wayland、DBus 與系統匣所需環境，適合大多數使用者；systemd 使用者服務則提供重新啟動策略與記錄查詢，適合需要明確管理程序狀態的環境。

XDG 桌面自動啟動

如果前面已建立 ~/.local/share/applications/v2rayN.desktop，只要複製到目前使用者的 autostart 目錄即可。登入後桌面環境會讀取該檔案並啟動程式。

mkdir -p ~/.config/autostart
cp ~/.local/share/applications/v2rayN.desktop \
  ~/.config/autostart/v2rayN.desktop

若使用系統套件附帶的桌面檔案，可先透過 find 找到實際檔名，再複製到 autostart 目錄。需要取消時只刪除使用者目錄中的自動啟動副本，不必解除安裝 v2rayN。

rm ~/.config/autostart/v2rayN.desktop

systemd 使用者服務

建立服務前先停用 XDG 自動啟動，避免兩個程序同時搶占 10808 等本機連接埠。服務檔案放在目前使用者目錄，請不要使用 sudo systemctl enable，否則會錯誤地設定成系統層級服務。

mkdir -p ~/.config/systemd/user
cat > ~/.config/systemd/user/v2rayn.service <<'EOF'
[Unit]
Description=v2rayN 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

若 command -v v2rayN 回傳其他路徑，應同步修改 ExecStart。Wayland 或 DBus 環境未被使用者服務繼承時，程式可能正在執行卻沒有視窗與系統匣圖示。登入桌面後，可先匯入工作階段變數，再重新啟動服務。

systemctl --user import-environment \
  DISPLAY WAYLAND_DISPLAY XAUTHORITY DBUS_SESSION_BUS_ADDRESS
systemctl --user restart v2rayn.service
systemctl --user status v2rayn.service
journalctl --user -u v2rayn.service -n 80 --no-pager

處理無法啟動、連接埠占用與解除安裝

程式無法啟動時，應直接從終端機執行並保留完整錯誤輸出。雙擊桌面圖示產生的錯誤通常會隨視窗關閉而消失，終端機輸出則能區分共享函式庫、權限、核心檔案與圖形工作階段問題。

command -v v2rayN
v2rayN
pgrep -af 'v2rayN|xray'
ss -lntp | grep -E '10808|10809'

如果記錄提示位址已被占用，先根據 ss 輸出找出占用連接埠的程序。常見情況是舊版 v2rayN、自動啟動服務與手動啟動同時執行。停止多餘的執行個體後再重新啟動核心，不要任意結束無法確認用途的系統程序。

• 桌面自動啟動與 systemd 服務二選一，避免重複啟動。
• 修改本機代理連接埠後，瀏覽器與桌面系統代理必須使用相同連接埠。
• 核心啟動失敗時，進入「設定」→「參數設定」→「Core 類型」重新確認 Xray。
• 訂閱更新失敗時，先查看網路與訂閱網址，再決定是否啟用透過代理更新。
• 升級後發生異常，可先退出程式、備份設定，再重新安裝符合目前架構的套件。

需要解除安裝時，請使用對應發行版的套件管理器。解除安裝套件不代表使用者設定也會自動刪除；如需重新測試全新設定，應先備份家目錄中的 v2rayN 設定，再依實際路徑處理。未備份訂閱與自訂路由規則前，不要直接清理使用者目錄。

# Ubuntu 或 Debian
sudo apt remove v2rayn

# Fedora 或同類 rpm 系發行版
sudo dnf remove v2rayN

# 停用使用者服務
systemctl --user disable --now v2rayn.service
rm ~/.config/systemd/user/v2rayn.service
systemctl --user daemon-reload

套件名稱的大小寫與實際登記名稱可能不同。若解除安裝命令提示找不到套件，deb 系統可執行 dpkg -l | grep -i v2ray，rpm 系統可執行 rpm -qa | grep -i v2ray，再使用查詢結果中的正確名稱。