v2rayN Windows 安裝與設定完整流程：Desktop 與 WPF 版怎麼選、常見錯誤排解

安裝前先選 Desktop 版還是 WPF 版

v2rayN 的 Windows 建置可能同時提供 Desktop 與 WPF 兩類介面。兩者都負責設定管理、訂閱更新、路由分流與核心控制，可使用的 VMess、VLESS、Trojan、Shadowsocks、REALITY 等協定，主要取決於所選核心及其版本，而非介面名稱。

WPF 版採用 Windows Presentation Foundation，介面行為更貼近傳統 Windows 桌面程式，適合只在 Windows 使用、希望通知區選單與視窗操作維持經典形式的使用者。Desktop 版採用較新的桌面介面實作，設定結構更接近其他桌面環境，適合想使用新介面或需要統一操作習慣的使用者。

安裝包名稱中如果帶有 SelfContained，通常表示已包含對應的 .NET 執行元件，檔案較大，但能減少執行階段缺失造成的啟動失敗。不帶此標記的安裝包檔案較小，需要系統預先安裝與目前版本相符的 .NET Runtime 或 .NET Desktop Runtime。實際相依需求應以下載頁與程式啟動提示為準。

下載、解壓縮與首次啟動

v2rayN 通常以壓縮包形式發佈。下載完成後應先完整解壓縮，再執行目錄中的主程式。不要在壓縮軟體預覽視窗中直接雙擊執行，因為核心、語言檔案與設定目錄尚未完整釋出時，程式可能只短暫出現程序，隨後直接關閉。

建議將程式放在目前帳戶具備完整讀寫權限的固定路徑，例如 D:\Apps\v2rayN。路徑應盡量簡短，並避免放入需要系統管理員權限寫入的系統目錄。後續核心更新、日誌寫入與設定儲存都會存取此目錄。

1. 選擇安裝包

   前往本站安裝包頁面，依據系統架構選擇 Windows x64 的 Desktop 或 WPF 版本；不確定執行階段需求時，優先選擇帶有 SelfContained 標記的安裝包。

2. 完整解壓縮

   在壓縮包上按右鍵，選擇「全部解壓縮」，目標路徑可設為 D:\Apps\v2rayN。確認主程式、核心目錄與資源檔案位於同一個解壓縮目錄。

3. 解除檔案封鎖

   如果系統在壓縮包內容頁顯示「解除封鎖」，請勾選後再解壓縮。已解壓縮的檔案仍遭封鎖時，可重新處理原壓縮包並再次解壓縮。

4. 啟動主程式

   雙擊 v2rayN.exe，首次執行後查看工作列通知區。關閉視窗後，程式通常仍在通知區執行，不代表已經結束。

5. 檢查核心

   開啟「設定」→「參數設定」，確認 Core 類型與節點協定相符。VLESS、REALITY 等設定通常使用支援相應欄位的 Xray 核心。

程式首次開啟後，可以在「設定」→「參數設定」中確認介面語言、開機啟動、日誌層級、本機監聽連接埠與 Core 類型。修改 Core 類型或重要連接埠後，應先停止目前核心，再重新啟動節點，確保新產生的設定已完整載入。

匯入訂閱並完成第一次連線

訂閱連結與單筆分享連結不是同一種入口。訂閱網址通常會回傳一組可更新的伺服器設定，應放入訂閱群組；以 vmess://、vless://、trojan:// 或 ss:// 開頭的內容通常代表單筆分享連結，可以從剪貼簿批次匯入。

新增訂閱時，進入「訂閱群組」→「訂閱群組設定」，建立新群組後填寫別名與訂閱網址。儲存後使用「訂閱群組」→「更新全部訂閱（不透過代理）」執行首次擷取。如果訂閱服務只能透過現有代理存取，應先連線到可用節點，再改用透過代理更新的選項。

1. 新增群組

   進入「訂閱群組」→「訂閱群組設定」，按一下新增，填寫容易辨識的備註並貼上完整訂閱網址。

2. 更新清單

   儲存後選擇「訂閱群組」→「更新全部訂閱（不透過代理）」。更新成功時，主清單會顯示伺服器位址、連接埠、協定與傳輸方式。

3. 選擇節點

   在主清單選取一個節點並設為活動伺服器。先執行實際延遲或連通性測試，逾時節點不要繼續用於後續系統代理驗證。

4. 啟動系統代理

   在通知區選單或主介面的系統代理選項中選擇「自動設定系統代理」，確認通知區狀態發生變化後，再開啟瀏覽器進行測試。

單筆分享連結可以先複製到剪貼簿，再使用「伺服器」選單中的剪貼簿匯入功能。匯入後應檢查位址、連接埠、使用者 ID、傳輸方式、TLS、SNI、指紋與 Flow。VLESS 與 REALITY 組合還要確認公鑰、Short ID、Server Name 與伺服器端設定一致。

系統代理、連接埠與 TUN 模式如何設定

系統代理模式與 TUN 模式解決的問題不同。系統代理會將 Windows 的代理設定指向 v2rayN 的本機監聽連接埠，遵循系統代理設定的瀏覽器與應用程式會經過節點；不讀取系統代理的程式仍可能直接連線。TUN 模式則透過虛擬網路介面接管更廣泛的流量，適合需要代理非瀏覽器應用程式的情境。

在常見設定中，本機 SOCKS 連接埠可能使用 10808，HTTP 連接埠可能使用 10809；部分新設定會使用單一 mixed 連接埠同時處理兩類請求。不要只照抄連接埠號，應進入「設定」→「參數設定」查看目前實際監聽值，並與 Windows 系統代理中的位址與連接埠逐項核對。

如果瀏覽器能開啟網頁，但某個桌面程式無法連線，先確認該程式是否支援讀取 Windows 系統代理。如果應用程式只接受 SOCKS 位址，應在其自身的網路設定中填寫 127.0.0.1 與 v2rayN 目前的 SOCKS 連接埠，而不是填寫遠端伺服器位址。

啟用 TUN 模式前，應先用系統代理確認節點本身可用。接著從 v2rayN 的 TUN 入口啟用虛擬網卡，並依程式提示完成權限操作。TUN 啟動失敗時，應檢查是否存在其他虛擬網卡、佔用相同路由的網路工具，以及 Windows 安全性原則是否阻止驅動程式或網路設定變更。

啟動失敗與核心錯誤如何處理

排錯時先開啟日誌，不要只看主清單中的延遲結果。進入日誌視窗後重新啟動活動伺服器，重點觀察錯誤出現在哪個階段：GUI 尚未載入、核心程序無法啟動、本機連接埠繫結失敗、網域解析失敗，還是遠端握手遭拒。不同階段對應的處理方式完全不同。

如果錯誤只在更新訂閱時出現，應區分 HTTP 狀態錯誤與連線逾時。回傳 401 或 403 通常表示訂閱憑證失效、存取政策限制或網址遭截斷；回傳 404 通常表示路徑已變更；連線逾時則需要檢查 DNS、目前網路，以及是否必須透過代理更新。

如果核心能夠啟動但所有節點都逾時，可先切換兩個不同的伺服器位址進行比較，再檢查系統時間。TLS 與 REALITY 握手依賴合理的本機時間，Windows 時間偏差過大可能造成握手異常。完成時間同步後，應徹底停止舊核心程序再重試。

系統代理無效、通知區圖示消失與升級問題

系統代理無效時，首先確認 v2rayN 核心正在執行，其次確認已選取活動伺服器，最後檢查 Windows 的代理位址是否指向 127.0.0.1 與目前的 HTTP 或 mixed 連接埠。若代理開關保留舊連接埠，請先在通知區選單選擇清除系統代理，再重新啟用自動設定。

通知區圖示消失不一定代表程式已退出。Windows 可能將圖示收進通知區的摺疊選單，也可能關閉了該應用程式的通知區顯示。請先展開工作列右側的隱藏圖示，再進入 Windows 工作列設定，將 v2rayN 的通知區圖示設為顯示。工作管理員中存在 v2rayN 程序時，不要反覆雙擊啟動多個執行個體。

升級時不要在 v2rayN 執行期間覆蓋檔案。請先退出通知區程式，複製舊目錄作為備份，再將新版本解壓縮到獨立目錄。啟動新版本後檢查訂閱群組、路由規則、自訂 DNS、Core 類型與本機連接埠，確認無誤後再處理舊目錄。

• 訂閱可以更新但節點無法連線：檢查節點欄位、系統時間、核心版本與遠端網路狀態。
• 節點能連線但瀏覽器無法存取：檢查系統代理開關、本機監聽位址、連接埠與瀏覽器代理策略。
• 瀏覽器正常但其他程式直接連線：確認該程式是否讀取系統代理，必要時單獨填寫 SOCKS 參數或測試 TUN。
• 重新啟動後設定遺失：檢查程式目錄寫入權限，以及是否啟動了另一個解壓縮目錄中的副本。
• 同一連接埠持續被佔用：退出重複執行個體，在工作管理員確認舊核心結束後再啟動。

完成安裝後的基礎檢查

安裝完成不應只以視窗能夠開啟作為判斷標準。一套可重現的檢查順序是：確認版本與 Core 類型、更新訂閱、選取活動伺服器、查看核心日誌、啟用系統代理、測試瀏覽器存取，最後再驗證路由分流與 TUN。任何一步失敗，都應先停留在目前層級處理，不要同時更換協定、DNS、連接埠與核心。

路由分流應在基本連線穩定後設定。規則通常依網域、IP、程序或連接埠，決定流量使用代理、直接連線或阻擋出站。建立新規則後要注意比對順序：較具體的規則放在通用規則之前，避免前方寬泛條件提前接管流量。