v2rayN Windows 安裝與設定教學：WPF、Desktop 版本比較及常見問題

一、WPF 與 Desktop：先選介面，再確認架構

v2rayN 是管理節點、訂閱、路由及本機代理入口的桌面用戶端；實際網路連線則由它呼叫的核心處理。WPF 與 Desktop 的主要差異在於介面實作及平台支援，並非兩種不同的節點協定。訂閱能否使用，取決於節點參數、所選核心及伺服器設定，不能只憑視窗外觀判斷。

在 Windows「設定」→「系統」→「系統資訊」查看「系統類型」；部分版本會將最後一項顯示為「關於」。一般 Intel、AMD 電腦通常選擇 x64；Windows on ARM 裝置則優先確認 ARM64 套件。處理器品牌並非唯一判斷依據，請以系統顯示的架構及下載頁說明為準。

• 先確認架構：x64 與 ARM64 套件不能只看檔案大小互換；架構選錯可能導致程式或核心無法啟動。
• 再確認套件類型：是否包含執行環境或所需核心，請查看目前版本的發布說明，不要只憑檔名中的縮寫推測套件內容。
• 最後確認系統需求：舊版 Windows 未必符合目前用戶端及執行環境的需求；反覆下載同一套件並不能解決相容性問題。

二、解壓縮與首次啟動：保留完整目錄

前往本站用戶端下載頁選擇 Windows 下載項目。若下載的是壓縮檔，請先完整解壓縮再執行；直接在壓縮軟體的預覽視窗中開啟主程式，可能讓核心、設定檔或相依程式庫留在暫存目錄，造成視窗能開啟、卻始終無法連線。

1. 準備目錄

   建立一般使用者可寫入的獨立目錄，例如 D:\Tools\v2rayN。如果沒有 D 槽，可在個人使用者目錄下建立資料夾；避免放在需要額外寫入權限的系統目錄。

2. 完整解壓縮

   解壓縮壓縮檔中的所有內容，並保留原有子目錄。不要只抽出 v2rayN.exe，也不要將不同架構或不同介面的檔案混放在同一個資料夾。

3. 啟動主程式

   執行 v2rayN.exe。一般系統代理用途通常不需要系統管理員權限；初次設定時先關閉 TUN，避免權限與虛擬網卡增加排查變數。

4. 安裝執行環境

   若跳出缺少 .NET 的提示，請記下視窗中的架構名稱、主要版本及處理器架構，再依提示安裝相應的執行環境。安裝完成後重新啟動用戶端；只安裝 SDK 不代表相依元件一定齊全。

5. 檢查記錄

   確認主視窗能正常開啟，再查看記錄區是否出現缺少核心、啟動失敗或設定解析錯誤。此時尚未匯入訂閱、沒有節點是正常情況，不代表安裝失敗。

三、匯入訂閱：分清楚儲存連結與更新節點

訂閱連結通常用來取得一組節點設定，不是本機代理位址，也不能直接填入 Windows「Proxy 伺服器」欄位。連結中的權杖可能與個人帳戶相關，分享截圖、記錄或進行遠端協助時，請遮蔽完整網址。

1. 開啟主介面的「訂閱群組設定」；部分介面會將入口放在「訂閱群組」選單中。選擇「新增」，輸入方便辨識的備註及完整訂閱網址，然後儲存。
2. 返回「訂閱群組」選單，選擇「更新全部訂閱（不透過代理）」進行首次取得。不同介面可能省略括號中的文字，請確認選擇的是不經本機代理的更新方式。
3. 更新後請檢查目前的群組篩選條件及搜尋欄，確認節點沒有被篩掉；儲存訂閱網址本身，不代表節點已成功下載。
4. 選取一個節點，透過右鍵選單選擇「設為活動伺服器」；確認狀態列或目前節點標記已變更，再進行後續代理測試。

若目前網路無法直接連線至訂閱伺服器，而用戶端中已有可連線的節點，可先啟用該節點，再選擇「更新全部訂閱（透過代理）」。首次安裝時清單為空，沒有可用的對外連線，反覆選擇透過代理更新通常無法解決問題；請先向訂閱服務提供者確認連結是否有效及可用的存取方式。

四、系統代理與本機連接埠：先確認瀏覽器能連線

選好活動節點後，在系統匣圖示的右鍵選單中開啟「系統代理」，選擇「自動設定系統代理」。此處的「自動設定」是由用戶端設定 Windows 系統代理，不代表所有程式都會遵循這項設定。瀏覽器通常適合作為第一個測試對象；遊戲、命令列工具等應用程式可能需要另外設定。

開啟「設定」→「參數設定」，確認本機監聽位址及連接埠。不同版本可能提供混合入口，或分別列出 HTTP 與 SOCKS 入口，請勿直接將舊教學中的 10809 當作目前的 HTTP 連接埠。只有在目前核心設定確實支援時，混合入口才能同時接收 HTTP 與 SOCKS 請求。

若已確認本機 10808 是 HTTP 或混合入口，可在 PowerShell 執行下列測試。若只有 SOCKS 入口，請使用第二條命令；不必兩條都執行，並請將連接埠換成目前實際使用的數值。範例目標僅用於檢查請求路徑，單一網站測試成功不代表所有路由都已確認。

curl.exe --proxy http://127.0.0.1:10808 --connect-timeout 5 --max-time 15 -I https://example.com
curl.exe --proxy socks5h://127.0.0.1:10808 --connect-timeout 5 --max-time 15 -I https://example.com

第一條命令若只顯示 200 Connection established，代表代理接受了通道請求，尚不足以證明後續 TLS 交握及目標網站請求成功；還需查看最終回應或後續錯誤。第二條使用 socks5h，會將目標網域交由代理端解析，有助於縮小本機 DNS 解析問題的範圍。

五、路由與核心：每次只調整一項設定

系統代理處理的是「應用程式是否將請求交給用戶端」；路由規則決定「進入用戶端的請求從哪個出口送出」。兩者是不同的設定。在狀態列或主介面的「路由」選擇器中查看目前方案；開啟系統代理不代表所有網域都會經由遠端節點連線。

• 先保留預設路由：以已知需要代理的目標進行測試，並查看記錄中的出口選擇。網頁雖能開啟，但記錄顯示直連，並不能證明遠端節點可用。
• 再確認協定相容性：VMess、VLESS 是協定名稱，Xray 則是可執行連線的核心之一。遇到不支援的欄位時，請確認目前核心及節點需求，不要只因為「換核心可能更快」就盲目切換。
• 最後排查 DNS：發生網域解析錯誤時，先確認錯誤是在本機、核心還是遠端發生。任意將 DNS 位址改成某個公共 DNS，不一定能解決路由或存取訂閱的問題。

六、啟動失敗與連接埠占用：依錯誤訊息排查

主視窗正常開啟，不代表核心已成功啟動。若記錄顯示 address already in use 或繫結失敗，請檢查本機監聽連接埠；若提示找不到檔案，則應檢查解壓縮目錄及安全軟體記錄。這兩種問題都發生在連線至伺服器之前，重新購買或更換訂閱通常無濟於事。

以 10808 為例，可在 PowerShell 檢查監聽記錄；最後一欄是處理程序 ID。假設實際輸出的處理程序 ID 為 4321，再執行第二條命令查詢程式名稱。此處的處理程序編號僅供示範，請勿直接依此終止電腦上的程序。

netstat -ano -p tcp | findstr ":10808"
tasklist /FI "PID eq 4321"

確認輸出中的「本機位址」確實以該連接埠結尾，且狀態為監聽中，不要將遠端連線記錄誤判為連接埠占用。若占用者是舊版 v2rayN 執行個體，請先正常關閉；若是其他必要軟體，可在 v2rayN 參數設定中改用未占用的本機連接埠，重新啟動核心後再套用系統代理。

七、常見問答：訂閱、權限與網路中斷後的恢復

八、升級與遷移：先備份再更換

升級前先清除系統代理並關閉用戶端，確認舊程序已結束，再備份設定及訂閱資訊。設定中可能包含節點憑證，請將備份保存在個人可控的位置，不要直接上傳至公開雲端硬碟。WPF 與 Desktop 版本之間也不能假設所有設定檔都能直接覆蓋沿用。

1. 保留可還原的備份：分別備份舊程式目錄與實際設定目錄；設定位置可能因發布方式而異，請以目前用戶端的目錄入口或發布說明為準。
2. 在新目錄試用：將新套件完整解壓縮至另一個目錄，不要同時執行兩個執行個體。先檢查啟動記錄，再匯入訂閱並確認活動節點。
3. 重新確認本機入口：記錄升級前後的監聽位址、連接埠、系統代理模式及路由方案。若外部應用程式曾手動設定連接埠，也請一併確認。
4. 最後再恢復其他功能：確認瀏覽器基本請求正常後，再逐一恢復自訂 DNS、路由規則及 TUN；每調整一項就測試一次，方便找出衝突來源。

完整驗收安裝結果應包含三項：用戶端能啟動核心、訂閱能產生可選節點，以及實際請求能透過預期出口取得回應。只確認主視窗、節點數量或單次延遲測試，都不能取代這三項檢查。之後遇到問題時，依序檢查「本機入口 → 系統代理 → 路由 → 遠端連線」，通常比從頭重裝更容易找出原因。