Linux 安裝 v2rayN 圖文教學：deb/rpm 套件安裝、相依性處理與開機自動啟動設定

安裝前確認發行版、架構與桌面環境

在 Linux 安裝 v2rayN，第一步不是直接執行安裝指令，而是確認目前系統使用哪一種套件格式。Debian、Ubuntu 及常見衍生發行版通常使用 deb 套件；Fedora、openSUSE 以及採用 RPM 套件體系的發行版則使用 rpm 套件。選錯套件格式時，系統不會自動將它轉換成另一種格式。

還要確認處理器架構。一般桌上型電腦通常顯示為 x86_64，下載頁可能標示為 x64。部分裝置會顯示 aarch64 或 arm64。安裝套件的架構必須與系統架構一致，否則套件管理器會提示架構不相符，或程式在啟動階段直接失敗。

uname -m
cat /etc/os-release

uname -m 可用來查看處理器架構。/etc/os-release 會列出發行版名稱、版本與識別資訊。不要只依桌面外觀判斷系統類型，因為 GNOME、KDE Plasma 等桌面環境可以安裝在不同發行版上。

Debian 與 Ubuntu 使用者也可以執行以下指令，確認套件管理器辨識的架構：

dpkg --print-architecture

Fedora 與 openSUSE 使用者可以透過 RPM 查詢架構：

rpm --eval '%{_arch}'

v2rayN 是桌面用戶端。本文的啟動、系統代理與自動啟動步驟，前提是 Linux 系統具備圖形桌面工作階段。如果裝置只有終端機環境，安裝桌面用戶端通常不是合適的部署方式。即使安裝成功，也可能因缺少圖形工作階段、顯示服務或桌面元件而無法開啟主視窗。

下載前核對四項資訊

發行版體系：確認使用 deb 還是 rpm，不要依檔案圖示猜測。
處理器架構：讓安裝套件架構與 uname -m 的結果相符。
桌面工作階段：確認目前可以正常登入 GNOME、KDE Plasma 或其他桌面環境。
舊版本狀態：如果已安裝過 v2rayN，先退出正在執行的用戶端，再進行升級或重新安裝。

安裝套件應從本站的取得用戶端頁面進入。下載完成後，先在檔案管理器中確認檔案確實位於下載目錄，再開啟終端機。不同瀏覽器可能將檔案儲存到「下載」目錄、使用者指定的目錄或上次使用的目錄，終端機中的路徑必須與實際儲存位置一致。

Debian 與 Ubuntu 安裝 deb 套件

在 Debian 和 Ubuntu 上，優先使用 apt install 安裝本機 deb 套件。與單獨執行 dpkg -i 相比，APT 會同時分析套件宣告的相依性，並嘗試從目前已設定的套件來源補足相依套件。指令中的 ./ 很重要，表示安裝目前目錄中的本機檔案，而不是搜尋套件來源中的同名套件。

步驟一：進入下載目錄並確認檔名

cd ~/Downloads
ls -lh v2rayN*.deb

部分中文桌面環境會將下載目錄顯示為本地化名稱，但實際路徑仍可能由 XDG 使用者目錄設定決定。如果 ~/Downloads 不存在，可以先查詢實際的下載目錄：

xdg-user-dir DOWNLOAD

接著進入指令回傳的目錄。執行 ls 後應看到完整的 deb 檔名。版本更新時檔名可能變更，因此請以目前下載到本機的名稱為準。

步驟二：使用 APT 安裝本機套件

sudo apt update
sudo apt install ./v2rayN-linux-64.deb

上面的檔名只是用來說明指令結構。如果下載的檔名不同，應將指令結尾改成終端機中實際顯示的完整名稱。輸入 sudo 密碼時，終端機通常不會顯示星號或圓點，這是正常現象；輸入完成後按 Enter 即可。

apt update 只會更新套件來源索引，不會自動升級整個系統。更新索引有助於減少「相依套件存在但目前索引找不到」的情況。如果網路暫時無法使用，而相依套件先前未安裝，APT 將無法補足所需元件。

步驟三：處理 dpkg 安裝後留下的相依性問題

如果先前已執行過 sudo dpkg -i，並看到「相依性問題」或「套件尚未設定」的提示，不必反覆執行同一個 dpkg 指令。先讓 APT 修復尚未完成的相依性狀態：

sudo apt --fix-broken install
sudo dpkg --configure -a

第一個指令會檢查缺少的相依套件並完成安裝；第二個指令會繼續設定已解包但尚未完成設定的套件。執行結束後，再次執行本機 deb 安裝指令。如果系統提示找不到某個相依套件，應先檢查發行版版本是否仍受支援、套件來源是否可用，以及安裝套件是否針對目前的系統版本。

步驟四：從應用程式選單啟動

安裝完成後，先在桌面應用程式選單中搜尋 v2rayN。若能在應用程式選單找到入口，表示桌面檔案已被系統辨識。如果圖示沒有立即出現，可以登出並重新登入桌面工作階段，或在終端機中檢查可執行指令：

command -v v2rayN
v2rayN

第二個指令適合用來觀察啟動階段的終端機輸出。如果視窗正常出現，可以關閉終端機進行測試，之後改用應用程式選單啟動。如果終端機回報找不到指令，不要自行猜測安裝路徑；先透過套件清單查看實際安裝位置：

dpkg -L v2rayn | grep -E 'bin/|applications/'

套件名稱的大小寫與具體寫法可能隨版本調整。如果指令提示尚未安裝該套件，可先執行 dpkg -l | grep -i v2ray，再使用結果中顯示的套件名稱。

Fedora 與 openSUSE 安裝 rpm 套件

RPM 是套件格式，DNF 與 Zypper 才是負責解析相依性、呼叫套件來源並完成安裝的管理工具。直接執行底層的 rpm -i 可以安裝檔案，但不像 DNF 或 Zypper 會主動解決相依性，因此桌面使用者更適合使用發行版內建的高階套件管理器。

Fedora：使用 DNF 安裝

先進入下載目錄並核對檔案：

cd ~/Downloads
ls -lh v2rayN*.rpm

確認檔案存在後執行：

sudo dnf install ./v2rayN-linux-64.rpm

較新的 Fedora 版本可能在指令內部使用新版 DNF 實作，但本機 rpm 安裝方式維持不變。安裝前請注意閱讀交易摘要，重點查看新安裝、升級與移除的項目。正常情況下，安裝本機用戶端不應要求移除大量桌面基礎軟體。

如果曾中斷安裝，可以先檢查 RPM 資料庫與已安裝狀態：

rpm -qa | grep -i v2ray
sudo dnf check

dnf check 用來找出已安裝套件之間的相依性問題。如果錯誤來自尚未完成的系統更新，先完成目前的系統套件交易，再重新安裝 v2rayN，通常比連續強制覆寫更容易恢復一致狀態。

openSUSE：使用 Zypper 安裝

openSUSE 使用者同樣先確認下載目錄中的 rpm 檔案，再交由 Zypper 解析：

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

Zypper 可能會列出多個相依性解決方案。優先選擇保留桌面環境與系統基礎函式庫的方案。如果某個方案要求大幅降級或更換核心元件，應先取消，確認下載的套件是否適用於目前的發行版版本。

安裝完成後，可以使用以下指令查看套件內的檔案位置：

rpm -ql v2rayn | grep -E 'bin/|applications/'

如果套件名稱與指令不一致，先執行 rpm -qa | grep -i v2ray 取得準確名稱。應用程式選單尚未更新時，可以登出桌面工作階段後重新登入。也可以在終端機中啟動一次，以便保留完整的錯誤資訊。

用戶端首次啟動、匯入訂閱與確認核心

v2rayN 視窗能夠開啟，只代表桌面程式已安裝完成，不表示代理連線已可使用。首次啟動後，應依照「匯入設定、更新訂閱、選擇節點、啟動核心、設定系統代理」的順序操作。每一步完成後再進入下一步，有助於快速區分訂閱、節點與桌面代理問題。

匯入訂閱：在訂閱群組或訂閱設定中新增完整的訂閱網址，儲存後手動執行更新。
檢查節點清單：確認更新後出現伺服器項目，協定欄位與服務端提供的資訊一致。
選擇使用中的節點：選取準備使用的項目，並設為目前的使用中伺服器。
啟動核心：觀察記錄區域，確認沒有連接埠被佔用、設定解析失敗或核心啟動失敗的提示。
設定系統代理：核心正常執行後，再選擇自動設定系統代理。

VMess 與 VLESS 是不同的代理協定。用戶端會依節點設定產生對應的核心設定，使用者不需要將一種協定手動改寫成另一種。訂閱更新後沒有節點時，應先確認訂閱網址是否完整、訂閱是否仍有效，以及更新操作是否回傳錯誤。不要透過反覆重新安裝用戶端來解決訂閱內容為空的問題，因為套件安裝與訂閱回應屬於不同環節。

v2rayN 桌面版通常可搭配 Xray 或 V2Fly 系列核心使用，實際可選項目以目前版本介面為準。現有訂閱若包含特定傳輸方式或協定擴充，應使用能解析這些參數的核心。切換核心後要重新啟動相關程序，並查看記錄中是否出現「不支援欄位」或設定解析錯誤。

先查看記錄，再判斷連線失敗的位置

記錄中出現「監聽連接埠已啟動」之類的資訊，通常表示本機代理入口已建立，但不代表遠端連線一定成功。存取目標網站時才會觸發實際連線。如果記錄提示本機連接埠被佔用，應在 v2rayN 設定中調整本機監聽連接埠，或停止佔用該連接埠的舊程序。

ss -lntp
ps -ef | grep -i v2ray

ss -lntp 用來查看正在監聽的 TCP 連接埠。一般使用者可能看不到所有程序詳細資訊，必要時可以使用 sudo ss -lntp。如果同時啟動兩個 v2rayN 執行個體，後啟動的執行個體可能無法繫結同一個本機連接埠。先完全退出系統匣中的舊執行個體，再重新開啟用戶端。

Linux 桌面系統代理設定

核心執行與系統代理是兩個獨立狀態。核心負責建立本機代理連接埠並連線遠端伺服器；系統代理則負責告知桌面應用程式將請求傳送至這個本機連接埠。只啟動核心而未設定系統代理時，瀏覽器與其他應用程式可能仍會直接連線網路。

在 v2rayN 中選擇自動設定系統代理後，先開啟桌面環境的網路或代理設定，確認 HTTP、HTTPS 或 SOCKS 項目已相應變更。具體顯示方式取決於桌面環境與用戶端版本。不要直接照抄其他電腦的連接埠，應以目前 v2rayN 設定頁顯示的本機連接埠為準。

GNOME 桌面檢查

GNOME 使用者可以開啟「設定」，進入「網路」中的代理設定，查看模式是否變更為手動，以及位址是否指向本機。也可以使用指令查看目前的代理模式：

gsettings get org.gnome.system.proxy mode
gsettings get org.gnome.system.proxy.http host
gsettings get org.gnome.system.proxy.http port

當代理由用戶端自動控制時，不建議同時在 GNOME 設定中反覆手動修改。兩邊同時操作，容易出現用戶端顯示已啟用，但桌面儲存了另一組連接埠的情況。關閉 v2rayN 前，應先使用用戶端提供的「清除系統代理」或相應操作，讓桌面恢復正常的連線方式。

KDE Plasma 桌面檢查

KDE Plasma 使用者可在系統設定的網路代理頁面查看設定。不同 Plasma 版本的選單位置可能略有差異，但檢查重點相同：代理位址應為本機位址，連接埠應與 v2rayN 目前的監聽連接埠一致。修改後，已開啟的應用程式可能需要重新啟動才能讀取新設定。

瀏覽器與終端機為何表現不同

部分應用程式遵循桌面系統代理，部分應用程式有自己的網路設定，還有一些命令列工具只讀取環境變數。因此「瀏覽器可以存取，但終端機指令不走代理」不一定是核心故障。先判斷應用程式使用哪一種代理來源，再決定是否個別設定。

如果需要讓目前的終端機工作階段暫時使用代理，可以依照 v2rayN 顯示的實際監聽類型與連接埠設定環境變數。以下僅展示指令結構，其中連接埠必須與用戶端介面一致：

export http_proxy=http://127.0.0.1:10808
export https_proxy=http://127.0.0.1:10808
export all_proxy=socks5://127.0.0.1:10808

如果目前連接埠不是 10808，應改成實際值。關閉終端機後，這些暫時變數就會失效。尚未確認本機連接埠前，不要將它們寫入 shell 啟動檔案，否則每次開啟終端機都會指向不存在的代理入口。

設定開機自動啟動與登入後啟動

桌面用戶端所說的開機自動啟動，通常更準確的意思是「使用者登入圖形桌面後自動啟動」。v2rayN 需要桌面工作階段、系統匣與使用者設定目錄，因此不適合簡單地強制作為系統層級背景服務提前啟動。優先使用用戶端設定中的開機啟動選項；如果該選項在目前桌面環境中沒有生效，再使用 XDG 自動啟動目錄。

方法一：啟用用戶端內建選項

開啟 v2rayN 設定，找到開機啟動或登入後啟動選項。
儲存設定並完全退出用戶端。
登出目前的桌面使用者，然後重新登入。
檢查系統匣圖示、程序與記錄，確認只啟動了一個執行個體。
確認用戶端啟動後，是否依預期恢復系統代理狀態。

測試時應登出並重新登入，而不是只關閉視窗。部分桌面環境會將關閉主視窗解讀為縮小至系統匣，程序實際上仍在執行，因此無法驗證自動啟動是否真正生效。

方法二：將現有桌面入口複製到 autostart

套件安裝後通常會提供桌面入口檔案。可以先尋找該檔案，再複製到目前使用者的自動啟動目錄：

find /usr/share/applications -iname '*v2rayn*.desktop'
mkdir -p ~/.config/autostart
desktop_file="$(find /usr/share/applications -iname '*v2rayn*.desktop' | head -n 1)"
test -n "$desktop_file" && cp "$desktop_file" ~/.config/autostart/

複製完成後，登出並重新登入。如果第一個指令沒有回傳結果，應先透過套件檔案清單確認桌面檔案的安裝位置，不要建立指向未知程式路徑的啟動項目。deb 系統可使用 dpkg -L 查詢，rpm 系統可使用 rpm -ql 查詢。

如果登入後出現兩個 v2rayN 執行個體，表示用戶端內建啟動項目與手動複製的 XDG 啟動項目同時生效。保留其中一種方式即可。可以刪除使用者目錄中的重複項目：

rm -f ~/.config/autostart/*v2rayN*.desktop
rm -f ~/.config/autostart/*v2rayn*.desktop

刪除前可以先使用 ls -la ~/.config/autostart 查看檔案。Linux 檔名區分大小寫，因此這裡分別處理常見的大小寫形式。刪除自動啟動項目不會解除安裝 v2rayN，也不會刪除訂閱與用戶端設定。

避免使用系統層級 service 啟動桌面視窗

將圖形用戶端直接寫成系統層級 service，常見結果是程式找不到圖形顯示、無法連線使用者工作階段、讀取錯誤的主目錄，或以管理權限產生設定檔。桌面使用者應使用用戶端內建選項或 XDG autostart。只有在明確理解使用者層級服務、桌面工作階段環境與程式啟動參數時，才需要考慮額外的服務管理方案。

常見安裝與啟動故障逐項處理

套件提示架構不相符

重新執行 uname -m，並與下載檔案標示的架構相互比對。x64 套件不能直接安裝到 arm64 系統，反之亦然。架構不相符並非缺少相依套件，繼續安裝執行環境也無法解決問題。

雙擊套件沒有反應

檔案管理器中的雙擊操作依賴桌面提供的軟體安裝前端。前端未安裝、權限提示被遮住或檔案關聯異常時，雙擊可能不會有明顯回應。改用 APT、DNF 或 Zypper 執行安裝，可以直接看到錯誤文字，也更容易判斷是路徑、架構還是相依性問題。

啟動後視窗空白或立即退出

先從終端機啟動並保留完整輸出。檢查桌面工作階段是否正常、系統圖形元件是否完整，以及套件是否適用於目前的發行版版本。如果剛完成大規模系統升級，先登出或重新啟動系統，讓新安裝的圖形函式庫與桌面元件完整載入。

同時檢查使用者設定目錄的權限。若之前曾用 sudo 直接啟動圖形用戶端，可能導致部分設定檔屬於管理使用者，普通使用者之後無法寫入。不要長期以管理權限執行 v2rayN。可以先查看使用者目錄中相關檔案的擁有者，再針對確認屬於該用戶端的目錄修正權限。

用戶端啟動正常，但網頁無法連線

依四層順序檢查：第一層確認是否已選取節點；第二層確認核心是否成功啟動並監聽本機連接埠；第三層確認系統代理是否指向該連接埠；第四層確認目標應用程式是否遵循系統代理。不要一開始就刪除訂閱或重新安裝用戶端。

如果只有部分網站連線失敗，還要檢查路由分流規則。v2rayN 可以根據網域、位址範圍或規則集決定直連、代理或阻擋。錯誤的規則可能讓目標請求走向不合適的出口。測試時可以暫時切換到較容易判斷的路由模式，確認基礎連線正常後，再恢復並逐項檢查自訂規則。

訂閱更新成功，但清單沒有變化

先確認更新的是正確的訂閱群組，並查看更新記錄。某些訂閱回應可能為空，或回傳用戶端無法解析的內容。此時應核對訂閱網址、群組設定與服務端提供的格式。套件安裝正常不代表訂閱內容一定有效，兩者應分開處理。

重新啟動後系統代理指向失效連接埠

這通常是系統代理狀態比用戶端更早恢復，或 v2rayN 未能成功自動啟動。先清除桌面系統代理，再啟動用戶端並確認核心連接埠，最後重新啟用自動設定系統代理。接著檢查自動啟動項目是否重複、用戶端是否在登入後崩潰，以及本機連接埠是否被其他程式佔用。

解除安裝、重新安裝與升級時的處理順序

升級前先退出 v2rayN，避免舊程序持續佔用檔案或本機連接埠。使用相同套件體系安裝新版本時，APT、DNF 或 Zypper 通常會將它辨識為升級交易。執行前請閱讀交易摘要，確認套件名稱與架構正確。

如果需要解除安裝，先清除系統代理並退出用戶端。Debian、Ubuntu 可先查詢準確的套件名稱，再使用 APT 移除；Fedora、openSUSE 則先透過 RPM 查詢套件名稱，再交由對應的管理器處理。不要直接刪除 /usr 下的個別檔案，因為套件資料庫仍會認為程式處於已安裝狀態。

dpkg -l | grep -i v2ray
rpm -qa | grep -i v2ray

解除安裝應用程式與刪除使用者設定是兩回事。一般解除安裝通常會保留使用者目錄中的訂閱、路由與介面設定，方便再次安裝後恢復使用。如果故障源於設定內容，單純重新安裝套件後問題可能仍會存在。需要重設時，應先備份必要的訂閱資訊，再使用用戶端提供的重設功能，或確認設定目錄後再進行處理。