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

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

v2rayN 是桌面用戶端，可管理節點、更新訂閱並啟動代理核心。Linux 版需要可用的圖形工作階段；只有終端機的伺服器不適合照搬本文的桌面安裝流程。v2rayNG 與 v2flyNG 是 Android 用戶端，不能取代 Linux 安裝套件。

套件格式取決於 Linux 發行版，處理器架構則依硬體而定。請先執行下列兩個指令。不要只看機器外觀選套件，也不要將 Windows 版主程式交給 Linux 套件管理工具安裝。

cat /etc/os-release
uname -m

請從下載中心選擇 Linux 套件。本文不指定特定版本號：套件名稱、相依套件與介面都可能隨版本調整。安裝前記下版本與架構，之後排查問題時才有明確依據。

deb 與 rpm：使用套件管理工具處理相依套件

建議優先使用 apt、dnf 或 zypper 安裝本機套件。這些工具會讀取套件宣告的相依項目，並從已設定的系統套件庫取得所需元件。直接使用底層工具只會解開套件，容易留下「已安裝但相依套件未齊全」的半成品。

在 Ubuntu、Debian 安裝 deb 套件

cd "$HOME/Downloads/v2rayn-linux"
ls -lh ./*.deb
dpkg-deb -f ./*.deb Package Version Architecture Depends
sudo apt update
sudo apt install ./*.deb

./會告訴 apt 這是本機檔案，而不是套件庫中的套件名稱。查看Architecture後，再確認是否安裝。若先前用其他方式安裝而留下未滿足的相依項目，可執行sudo apt --fix-broken install；但請先檢查它準備安裝或移除的項目，不要不看內容就一路確認。

在 Fedora 安裝 rpm 套件

cd "$HOME/Downloads/v2rayn-linux"
ls -lh ./*.rpm
rpm -qp --queryformat '%{NAME} %{VERSION}-%{RELEASE} %{ARCH}\n' ./*.rpm
rpm -qp --requires ./*.rpm
sudo dnf install ./*.rpm

在 openSUSE 安裝 rpm 套件

cd "$HOME/Downloads/v2rayn-linux"
ls -lh ./*.rpm
rpm -qp --queryformat '%{NAME} %{VERSION}-%{RELEASE} %{ARCH}\n' ./*.rpm
sudo zypper refresh
sudo zypper install ./*.rpm

執行階段函式庫也不能靠猜。不同建置版本可能採用不同發佈方式，並非所有 Linux 套件都需要另外安裝 .NET。請先查看套件相依項目與啟動錯誤；缺少哪個共用函式庫，再查詢對應發行版提供該函式庫的套件。不要照搬 Windows 的執行階段修復方式。

首次啟動：檢查桌面捷徑、節點與連接埠

安裝完成後，從應用程式選單搜尋 v2rayN，並以目前的一般使用者帳戶啟動。安裝軟體需要管理員權限，但日常執行圖形介面用戶端通常不需要。使用sudo啟動可能會把設定寫入另一個使用者的資料夾，下一次正常啟動時就像「設定不見了」。

1. 檢查桌面捷徑

   在應用程式選單搜尋 v2rayN。若找不到，請執行grep -il 'v2rayn' /usr/share/applications/*.desktop，確認安裝套件是否提供桌面啟動檔。先確認啟動捷徑可用，再設定自動啟動。

2. 匯入節點

   若已有單一節點分享連結，請複製完整內容，並在主視窗選擇「伺服器」→「從剪貼簿匯入批次 URL」。若使用訂閱網址，請前往「訂閱群組」→「訂閱群組設定」，填入網址並儲存，再選擇「更新所有訂閱（不透過代理）」。

3. 確認是否正常執行

   選取一個節點並設為作用中伺服器，接著檢查底部記錄是否出現核心啟動錯誤。VMess、VLESS 是節點協定；介面能開啟，不代表所選核心與節點參數都能正常運作。

4. 檢查連接埠

   開啟「設定」→「參數設定」，查看目前版本顯示的本機監聽連接埠。使用ss -lntp比對實際監聽狀況。若在參數設定中變更連接埠，測試指令與應用程式的代理位址也必須一併修改。

以下數字僅為說明與測試用的連接埠範例，不代表每個版本都使用相同的預設值。部分版本採用同時支援 HTTP 與 SOCKS 的混合連接埠；舊設定也可能分開使用兩種連線入口。請以介面與記錄為準，不要將舊教學中的連接埠直接套用到新設定。

ss -lntp | grep -E ':(10808|10809)\b'
curl --proxy socks5h://127.0.0.1:10808 --connect-timeout 10 --max-time 20 -I https://example.com

只有在實際 SOCKS 入口為10808時，才使用第二個指令。socks5h會將目標網域交由代理端解析；收到 HTTP 回應只表示這次請求經過指定入口，不代表所有應用程式都已使用代理。Linux 應用程式對桌面系統代理的支援程度不一，終端機程式也不一定會讀取相關設定。

登入後自動啟動：分清桌面項目與背景服務

搜尋「v2rayN Linux 開機啟動」時，容易把兩件事混為一談：使用者登入桌面後啟動圖形介面用戶端，以及系統啟動後執行背景處理程序。本文採用前者。顯示環境、桌面代理設定與使用者設定都屬於登入工作階段，不應直接將用戶端塞進系統層級服務。

複製安裝套件提供的桌面啟動檔

先關閉重複執行的視窗。請在 Bash 中執行下列程式碼：搜尋系統桌面啟動檔，只有找到恰好一個符合項目時才會複製。若找不到或找到多個，請停止並檢查，不要猜測可執行檔路徑。

bash <<'BASH'
mapfile -t launchers < <(grep -il 'v2rayn' /usr/share/applications/*.desktop 2>/dev/null)
if [ "${#launchers[@]}" -ne 1 ]; then
  printf '桌面啟動檔數量為 %s，請先檢查安裝套件提供的啟動檔。\n' "${#launchers[@]}"
  printf '%s\n' "${launchers[@]}"
  exit 1
fi
autostart_dir="${XDG_CONFIG_HOME:-$HOME/.config}/autostart"
mkdir -p "$autostart_dir"
install -m 644 "${launchers[0]}" "$autostart_dir/v2rayn.desktop"
grep -E '^(Type|Exec|TryExec|Path|Hidden|OnlyShowIn|NotShowIn|X-GNOME-Autostart-enabled)=' \
  "$autostart_dir/v2rayn.desktop"
BASH

• Exec是啟動指令，請沿用原始檔案的內容，不要憑印象改寫路徑。
• 若有TryExec，必須能找到對應程式；否則桌面環境可能會略過這個啟動項目。
• Hidden=true會停用該項目；X-GNOME-Autostart-enabled=false也可能讓對應的桌面環境略過啟動。
• OnlyShowIn與NotShowIn會限制適用的桌面環境。若設定不符，請先確認原始啟動項目的用途，再調整使用者副本。
• 若用戶端已建立自動啟動項目，就不要再複製第二份。同一個程式開啟兩個視窗，通常不代表啟動更可靠。

此檔案以644權限儲存即可，不需要執行權限。桌面環境通常會依照登入啟動規範讀取它。手動點擊桌面檔案時是否需要標記為「信任」，屬於另一種行為；不要為了自動啟動而任意放寬檔案權限。

驗收與復原：登出一次，再檢查啟動結果

儲存啟動項目後，先登出目前的桌面工作階段，再重新登入。鎖定螢幕後再解鎖，不會重新觸發登入啟動。第一次驗收不必重新啟動整台電腦，先確認啟動流程是否正常。

1. 登入後確認 v2rayN 是否出現；視窗或系統匣圖示的顯示方式，可能會受用戶端設定與桌面系統匣支援影響。
2. 查看目前使用者的處理程序：pgrep -a -i v2rayn。找到處理程序不代表核心已成功啟動，還要查看用戶端記錄。
3. 確認節點仍存在、作用中伺服器選擇正確，而且本機連接埠已開始監聽。
4. 重新執行上一節的明確代理請求，再分別測試需要使用代理的應用程式。
5. 若需要登入後自動連線，請確認用戶端是否會還原作用中伺服器。桌面啟動項目只負責開啟程式，不會修復失效的節點。

若要移除本文建立的登入啟動項目，只要刪除使用者副本即可，不會影響系統應用程式選單中的捷徑。指令只會處理本文命名的檔案；以其他方式建立的項目，請使用對應工具停用。

rm -f "${XDG_CONFIG_HOME:-$HOME/.config}/autostart/v2rayn.desktop"

升級時，使用相同管道提供的新套件執行 apt、dnf 或 zypper 安裝，通常就能取代舊版軟體檔案。升級前請備份用戶端實際使用的資料目錄；不要假設設定永遠位於固定路徑。訂閱網址、節點憑證與自訂路由都是需要妥善保護的資料。

常見問題：安裝成功但執行異常

最後，驗收標準可歸納為一句話：套件架構正確、一般使用者能手動啟動、核心沒有啟動錯誤、入口連接埠可用，而且重新登入後只啟動一次。每個項目各自負責不同環節，排查時逐項確認，比反覆解除安裝再重裝更省時間。