v2rayN Windows 安裝與設定完整教學：桌面版、WPF 版選擇及常見問題

桌面版與 WPF 版：先辨別介面，再確認架構

v2rayN 是桌面用戶端，介面用來管理訂閱、產生設定並控制代理；實際建立連線的是搭配使用的核心。下載頁若將「桌面版」和「WPF 版」分開，前者通常是採用 Avalonia 的桌面介面版本，後者則採用 Windows 的 WPF 介面框架。請以所選安裝包的說明為準，不要只憑名稱判斷內含元件。

介面框架不會決定節點協定，也不會直接影響速度。兩種版本能否使用某筆 VLESS 或 VMess 設定，仍取決於隨附核心、核心版本及完整參數。更換介面版本無法取代修正錯誤的伺服器位址、UUID、傳輸路徑或 REALITY 參數。

開啟 Windows「設定」→「系統」→「系統資訊」，查看「系統類型」。x64 系統優先選擇 x64 版本；ARM64 裝置則優先選擇明確提供的 ARM64 版本。處理器架構是安裝前提；桌面版或 WPF 版則是另一項選擇，兩者不可混為一談。

完整解壓縮與執行階段：排除啟動前問題

請先完整解壓縮壓縮檔，再啟動程式。直接在壓縮軟體中雙擊主程式，可能只會暫時解壓部分檔案，導致找不到核心、資源資料夾或設定資料庫。建議使用具備寫入權限的一般資料夾，例如 D:\Tools\v2rayN；若沒有 D 槽，也可使用目前使用者資料夾下的工具資料夾。

1. 確認處理器架構

   前往「設定」→「系統」→「系統資訊」確認為 x64 或 ARM64，再到下載中心選擇相符的 Windows 版本，並記下選擇的是桌面版還是 WPF 版。

2. 完整解壓縮

   將壓縮檔中的所有檔案解壓到獨立資料夾，再執行其中的 v2rayN.exe。請保留壓縮檔內的資料夾結構，不要只複製可執行檔。

3. 安裝所需元件

   若彈出視窗要求安裝 .NET，請記下提示中的框架名稱、版本及架構。WPF 相依框架的版本請依要求安裝 Desktop Runtime；SDK 或其他執行階段不能視為相同的相依元件。

4. 確認能否啟動

   一般方式啟動後，先確認主視窗與記錄區域可正常使用。暫時不要啟用 TUN 或設定開機啟動，先排除資料夾權限及程式檔案不完整等問題。

匯入與更新訂閱：將設定載入節點清單

v2rayN 安裝完成，不代表已經有可用節點。訂閱連結通常會回傳設定清單，其中可能包含存取憑證。請只使用有權使用且來源明確的連結，也不要在公開截圖或求助內容中貼出完整連結。

以下步驟以常見的中文介面為例。不同版本可能將相同功能放在選單列或工具列，按鈕文字也可能略有不同；請以「訂閱群組」及「更新訂閱」功能為準。不要將整條訂閱網址填入單一伺服器的位址欄。

1. 新增群組

   開啟「訂閱群組」→「訂閱群組設定」→「新增」，輸入方便辨識的備註，將完整訂閱網址貼到 URL 欄位，然後儲存。

2. 首次更新

   在「訂閱群組」選單選擇「更新全部訂閱（不透過代理）」。首次更新時若尚無可用代理，請先確認目前網路能否直接連線至訂閱服務。

3. 確認清單

   更新後確認目標群組中出現伺服器項目。若顯示成功但沒有項目，請檢查群組篩選條件、訂閱內容格式，以及伺服器是否回傳登入頁面或錯誤頁面。

4. 設為目前使用的伺服器

   在伺服器清單中以滑鼠右鍵點選目標項目，選擇「設為活動伺服器」，再查看核心記錄。匯入清單與啟用設定是兩個步驟；訂閱更新成功本身不代表連線可用。

若本機已有一筆確認可用的設定，而訂閱網址只能透過代理存取，再選擇「更新全部訂閱（透過代理）」。若沒有可用連線，反覆切換此選項無法解決訂閱網址失效、存取權杖過期或伺服器回傳錯誤等問題。VLESS、VMess 及傳輸安全欄位應優先保留訂閱提供的值，不要為了「相容」而任意更改協定。

系統代理：先確認瀏覽器連線正常

第一次設定建議只啟用系統代理。它會讓遵循 Windows 代理設定的程式將要求送至本機監聽連接埠，並不會接管所有應用程式的流量。右下角系統匣選單中的「系統代理」→「自動設定系統代理」用來寫入系統代理設定；「自動設定」不代表所有網站一定會透過遠端節點，實際路徑仍由用戶端的路由規則決定。

以下三個數值用於記錄本機排查時的項目，不是目前版本的預設設定，也不是遠端伺服器連接埠。只有實際設定使用這些數值時，後續命令才能直接執行。

Windows 代理頁面顯示正確，不代表核心已啟動。必須同時符合「活動設定有效、核心正在執行、本機連接埠正在監聽」三項條件。瀏覽器擴充功能也可能另行指定代理；排查時請先讓瀏覽器使用系統代理，避免兩組設定指向不同連接埠。

TUN 與路由分流：依需求擴大流量接管範圍

TUN 透過虛擬網路介面接收流量，適用於不讀取系統代理的程式，但仍會受到路由、DNS、應用程式行為及權限影響。它不是解決所有網路問題的開關。先確認同一個節點透過系統代理可正常使用，再測試 TUN，才能分辨是節點故障還是本機流量接管異常。

• 先記錄基準狀態：記下目前使用的設定、本機連接埠及路由模式，並保留可還原的設定。排查期間一次只修改一個項目。
• 分開測試：先透過系統匣的「系統代理」→「清除系統代理」，移除測試期間的瀏覽器代理設定，再從主介面啟用「TUN」。兩者並非永遠不能同時使用；分開測試是為了確認實際流量入口。
• 處理權限：若用戶端提示需要提高權限，請依提示重新啟動並授權。系統管理員權限只能滿足部分啟動條件；虛擬介面、路由衝突及相關元件缺失仍需查看記錄。
• 確認分流規則：在主介面找到路由選項，確認目前使用的規則。網域、IP、規則順序及最終出站共同決定流量去向；不能只憑「全域」或「繞過」幾個字，就推斷每個連線的路徑。
• 測試後還原：停用 TUN，確認一般網路連線恢復；若要改回系統代理，再重新啟用相應選項。不要同時修改 DNS、路由及節點，再猜測是哪項設定生效。

Windows 常見錯誤：從連接埠與記錄找出問題

排查時先開啟主視窗的記錄區域，記下問題發生時間及第一筆具體錯誤。只截取「啟動失敗」或「連線失敗」的結尾，往往找不到真正原因。對外提供記錄前，請移除訂閱權杖、UUID、伺服器位址等敏感內容；不要將整份設定公開當作一般附件。

以下命令請在 PowerShell 中執行。假設實際 HTTP 監聽連接埠為 10809，先查看監聽狀態，再透過明確指定的代理發出要求。example.com 僅為目標位址範例；測試時請選擇有權存取且狀態已知的位址，並確認該要求是否經由代理出站。

# 查看範例連接埠及對應的處理程序 PID
netstat -ano | findstr :10809

# 明確使用本機 HTTP 代理，排除應用程式是否讀取系統代理的變因
curl.exe --proxy http://127.0.0.1:10809 --connect-timeout 10 --max-time 20 -I https://example.com

# 關閉用戶端後，確認一般直接連線是否仍可使用
curl.exe --noproxy "*" --connect-timeout 10 --max-time 20 -I https://example.com

LISTENING 只表示某個處理程序正在監聽，不能證明它就是目前的 v2rayN 核心；可使用輸出中的 PID，到工作管理員的「詳細資料」頁面核對。收到 HTTP 回應代表要求鏈路有回應，不代表一定使用了遠端代理，仍須搭配路由記錄判斷。連線遭拒時通常先檢查本機監聽；若是交握錯誤，則需進一步確認協定參數與系統時間。

升級與移轉：保留設定，避免混用不同版本檔案

升級前先確認目前環境可正常運作，再備份設定。切換桌面版與 WPF 版時，使用獨立資料夾比直接覆蓋更容易復原；不同版本的設定格式、資料庫位置與移轉方式可能不同，不建議新版本寫入資料後，再讓舊版繼續使用同一份資料。

1. 記錄目前狀態：記下應用程式顯示的版本、安裝包類型、本機監聽連接埠、目前使用的路由及 TUN 狀態。記錄實際狀況，不要假設「最新版應該都一樣」。
2. 先退出再備份：先清除系統代理並停用 TUN，再正常關閉程式。可攜式安裝包可備份整個解壓縮資料夾；若使用獨立的使用者資料資料夾，也請依該版本說明備份相應位置。
3. 在新資料夾測試：完整解壓縮新安裝包，依版本提供的匯入或移轉說明還原設定。先確認一個已知可用的節點，再測試訂閱更新、系統代理與 TUN。
4. 最後再設定開機啟動：確認運作穩定後，再啟用需要的開機啟動功能。若開機自動啟動後視窗正常，但 TUN 失敗，請檢查權限與啟動記錄，不要靠重複新增啟動項目解決。

安裝流程的終點不只是「程式能開啟」，還要清楚目前安裝包的相依需求、使用哪筆設定、流量經由哪個連接埠進入，以及關閉程式時如何還原系統設定。依照這個順序完成驗證，之後遇到訂閱更新失敗、核心錯誤或路由異常，也能更快縮小排查範圍。