第一次安裝 v2rayN，先選對 Windows 架構與介面套件，再確認檔案已完整解壓縮，並了解訂閱更新和本機監聽連接埠。本文依照「主程式能啟動 → 節點能匯入 → 核心能連線 → 應用程式走代理」的順序操作；已安裝但網頁無法開啟，也能藉此判斷問題出在哪個環節。
一、如何選擇 WPF 版與 Desktop 版
v2rayN 是用來管理節點、訂閱與代理設定的桌面介面，實際連線則由核心處理。WPF 與 Desktop 的差異主要在介面技術和執行環境，並非兩種代理協定；選哪一版不代表連線自然會更快。Desktop 採用跨平台介面，WPF 則保留傳統 Windows 介面。支援哪些協定，仍取決於套件內的核心及其版本。
Desktop 版
建議首次安裝可以從 Desktop 版開始，並依下載頁說明確認 Windows 架構與執行環境需求。跨平台介面的選單配置可能與 WPF 不同；參考舊教學時，依設定項目的用途尋找即可，不必逐一比對截圖。
適合對象：初次安裝、想使用跨平台介面的 Windows 使用者。
WPF 版
習慣傳統 Windows 介面時，可以選擇 WPF 版。如果啟動時提示缺少執行架構，請確認該發行套件要求的 .NET Desktop Runtime 和處理器架構，不要只安裝名稱相似的一般執行階段。
適合對象：習慣傳統介面操作方式、希望沿用既有流程的使用者。
下載前，開啟 Windows「設定」→「系統」→「系統資訊」，查看「系統類型」。x64 和 ARM64 應依下載頁與套件說明選擇；不要只根據裝置品牌判斷。下載入口集中在用戶端下載頁。本文不指定版本號，也不將特定執行環境版本視為所有發行套件的共同需求。
二、完整解壓縮並首次啟動
使用解壓縮版時，必須先解開所有檔案，再執行其中的 v2rayN.exe。直接在壓縮軟體中開啟主程式，或只複製這個檔案，都可能缺少相依檔案、核心或資源。建議使用目前帳戶可寫入的固定資料夾，例如 D:\Tools\v2rayN；若沒有 D 槽，可在使用者資料夾下建立專用資料夾。
-
確認套件類型
在下載頁選擇 Windows 的 Desktop 或 WPF 版，確認架構與執行環境需求，下載完成後再解壓縮。
-
解壓縮所有檔案
在檔案總管中按右鍵點選壓縮檔，選擇「全部解壓縮」。不要直接從壓縮檔視窗執行，也不要將不同介面版本的檔案覆蓋到同一個資料夾。
-
啟動主程式
開啟解壓縮資料夾中的
v2rayN.exe。一般系統代理流程先以標準權限執行；若發生錯誤，請保留完整提示訊息與記錄。 -
確認監聽設定
開啟「設定」→「參數設定」，找到本機監聽位址與連接埠相關選項，並記下目前設定值。不同介面版本可能將這些選項放在不同分頁。
-
確認設定可以儲存
儲存設定後正常結束程式，再重新啟動，確認設定仍然保留。若每次啟動都恢復預設值，請先檢查資料夾寫入權限，以及是否執行了另一份程式。
中文路徑不必一概視為故障原因。個別外部元件可能無法正確處理路徑，但應先查看記錄是否指出路徑或讀取檔案錯誤。需要確認時，先結束程式，再將完整資料夾複製到較短的英文路徑後測試；保留原資料夾，以便還原訂閱與設定。網路磁碟、同步資料夾和受系統保護的目錄，則較容易遇到寫入權限或檔案鎖定問題。
三、匯入訂閱與選擇節點
訂閱網址用來取得節點清單，與單一節點分享連結不同。先確認取得的是完整訂閱 URL，再前往「訂閱分組」→「訂閱分組設定」，新增分組、填寫別名與網址後儲存。如果目前介面以「+」表示新增，新增的仍是訂閱分組，而非伺服器設定。
- 填寫網址：移除複製時混入的空格與換行，但保留網址原有的路徑和查詢參數。別名可使用「主要訂閱」等名稱，不必包含帳戶資訊。
- 更新分組：在「訂閱分組」選單中，選擇對應的更新訂閱指令。尚無可用節點時，先嘗試「不透過代理」更新；若直連失敗且已有可用連線，再嘗試「透過代理」更新。
- 確認結果：查看記錄確認要求是否成功，再確認節點是否已加入剛建立的分組。清單為空可能是訂閱過期、伺服器回傳空內容，或目前版本無法辨識格式。
- 設為目前使用的節點：在伺服器清單中按右鍵點選目標節點，選擇「設為活動伺服器」。清單中有節點，不代表該節點已成為目前使用的出口。
V2Ray 協定應依服務提供者提供的節點參數，以及目前核心支援的功能選擇。看到 VLESS、VMess、TLS、傳輸類型等欄位時，不要為了「最佳化」任意修改伺服器位址、連接埠、使用者識別碼或伺服器名稱；這些參數必須與伺服器端一致。重新更新訂閱後，手動修改過的節點也可能遭到取代。
- VLESS：協定本身不提供載荷加密，安全性取決於 TLS 等配套機制；不能只憑協定名稱判斷連線設定是否正確。
- VMess：請確保系統時間準確；時間差距過大可能影響驗證。不要將驗證失敗直接歸因於本機代理連接埠。
- 核心相容性：v2rayN 介面與核心屬於不同層級；若核心不支援某種設定，通常光是更換介面版本無法解決問題。
四、設定系統代理並確認本機連接埠
確認目前使用的節點後，在 v2rayN「系統代理」選單中選擇「自動設定系統代理」，再使用遵循系統代理設定的瀏覽器進行測試。這項設定只會修改 Windows 代理設定，不保證所有程式都會使用代理；終端機工具、遊戲或自行管理代理設定的應用程式，可能需要另外設定。
本機監聽連接埠與遠端伺服器連接埠是兩回事。以下以 127.0.0.1:10808 為例，但不同發行版本或舊設定可能使用不同連接埠，也可能將 HTTP、SOCKS 或混合監聽分開設定。請先確認該連接埠接受 HTTP 代理要求，才能使用下方指令；不要將 SOCKS 專用連接埠填入 HTTP 代理設定。
curl.exe --proxy http://127.0.0.1:10808 --head --max-time 15 https://example.com/- 連線遭拒：優先檢查本機連接埠是否填錯、核心是否啟動，以及監聽是否失敗。此時要求通常尚未送達遠端節點。
- 逾時或交握錯誤：搭配核心記錄檢查遠端連線、驗證、傳輸參數與系統時間，不能只憑瀏覽器錯誤頁面判斷問題所在。
- 收到 HTTP 回應：表示這次要求已取得回應，但不能據此認定所有網域或應用程式都已透過代理連線。
這個指令會明確指定代理，不必依賴終端機是否讀取 Windows 系統代理設定。若瀏覽器失敗但指令成功，請檢查瀏覽器代理擴充功能、自訂代理與略過規則；若瀏覽器成功但終端機失敗，請檢查工具本身的代理選項或環境變數。平時不使用代理時，請先在用戶端選擇「清除系統代理」，再結束程式，避免 Windows 留下已停止監聽的位址。
五、測試 V2Ray 節點並確認連線
測試 V2Ray 節點時，不能只看單一延遲數值。TCP 連線測試、實際要求測試與下載速度測試的測量項目不同：TCP 連線成功不一定代表驗證成功，延遲低也不代表持續傳輸速度快。首次設定時，先在伺服器清單的右鍵選單中選擇名稱包含「真連線」或「延遲」的測試項目，再用瀏覽器瀏覽已知可連線的頁面。
| 測試結果 | 可判斷的範圍 | 下一步 |
|---|---|---|
| TCP 測試成功，實際要求失敗 | 伺服器連接埠可能可連線，但尚未確認驗證與傳輸 | 檢查使用者參數、TLS 伺服器名稱與核心記錄 |
| 實際要求成功，瀏覽器失敗 | 節點可用，但應用程式的代理連線路徑可能不一致 | 檢查系統代理、瀏覽器擴充功能與略過清單 |
| 部分網域可用，部分無法使用 | 可能與路由、DNS 或目標網站限制有關 | 確認規則比對結果與目標網域的解析結果 |
| 所有節點都顯示本機監聽失敗 | 應優先檢查共同的本機環境，而非遠端節點 | 檢查連接埠占用、處理程序狀態與檔案權限 |
比較節點時，請使用相同的測試目標、路由模式與網路環境；先測試少數候選節點，避免大量並行要求觸發流量限制。下載速度測試可能消耗大量流量；若訂閱有流量額度，請先查看服務提供者的計費說明。偶爾出現波動時可以重複測試，但不要將單次結果當作節點的固定效能。
六、系統代理與 v2rayN TUN 模式
v2rayN TUN 模式會透過虛擬網路介面接管符合規則的流量，涵蓋範圍與系統代理不同。首次安裝時，先完成系統代理設定；只有在應用程式不遵循系統代理，或需要接管更多流量時，再考慮使用 TUN。如此可分開判斷節點問題與虛擬介面、路由和 DNS 問題。
依應用程式是否遵循系統代理選擇
系統代理
- 從「系統代理」→「自動設定系統代理」開始。
- 適用於遵循系統代理設定的瀏覽器與應用程式。
- 一般情況下，不需要以系統管理員權限啟動主程式。
- 可在終端機使用明確指定代理的參數單獨測試。
TUN 模式
- 先確認目前發行套件是否支援 TUN，以及需要哪些元件。
- 可能需要系統管理員權限、服務或虛擬介面。
- 啟用後，請檢查 DNS、路由與區域網路存取。
- 發生問題時，先關閉 TUN，再以系統代理進行對照測試。
選擇依據是流量接管需求，而不是哪種模式「比較快」；切換時請保留原有設定，並一次只變更一項條件。
若已安裝其他 VPN 或虛擬網卡，TUN 可能受到預設路由、DNS 或介面優先順序影響。不要同時啟用多種流量接管工具，又一次修改所有路由設定。使用遠端桌面時尤其要小心：變更路由可能中斷目前連線，請事先準備本機復原方式，並確認如何關閉 TUN。
七、排除閃退、權限與連接埠占用問題
排除問題時，應從記錄中第一筆有效錯誤開始。介面無法開啟、核心啟動失敗、訂閱要求失敗與網頁無法載入，是四種不同問題；「重新下載」無法一併解釋這些狀況。請先記下發生錯誤的步驟、所選介面套件、系統架構與錯誤訊息，再採取下列對應措施。
點兩下後沒有視窗，是缺少執行環境嗎？
先查看工作管理員是否已有相關處理程序，並確認視窗是否只是縮到系統匣。若明確提示缺少執行架構，再依發行套件需求安裝符合架構的執行環境；WPF 套件若提示需要 Desktop Runtime，一般 .NET Runtime 無法直接取代。若沒有提示，可在 Windows「事件檢視器」→「Windows 記錄」→「應用程式」中查看對應時間的錯誤。
記錄顯示連接埠遭占用，要怎麼查？
在 PowerShell 執行下方的監聽查詢指令，並以實際連接埠取代範例中的 10808。接著依 PID 在工作管理員的「詳細資料」中找到處理程序；若是重複啟動的 v2rayN，請正常關閉多餘的執行個體。不要直接結束不認識的系統處理程序。
移到英文資料夾就正常了，原本的資料夾不能用嗎？
這只能說明兩次執行環境不同，無法單獨證明問題出在中文字元。請繼續比對資料夾權限、檔案是否完整、是否位於同步資料夾，以及安全軟體的處理記錄；判斷時應以記錄中的具體路徑錯誤為依據。
是不是一直以系統管理員身分執行才穩定？
一般系統代理通常不需要這麼做。若記錄提示無法寫入設定，請先改用可寫入的資料夾；若啟用 TUN 需要提高權限，則依目前發行說明處理。提高權限無法修復訂閱失效、遠端逾時或驗證參數錯誤。
主程式正常，但找不到核心檔案？
確認檔案已完整解壓縮，並檢查 Windows「安全性中心」→「病毒與威脅防護」→「保護歷程記錄」。若發現封鎖記錄，請先確認檔案來源與風險說明，不要直接關閉整套防護；同時確認所選套件是否要求另外準備核心元件。
Get-NetTCPConnection -State Listen -LocalPort 10808 |
Select-Object LocalAddress, LocalPort, OwningProcess查詢沒有結果，通常表示當時沒有該 TCP 監聽；即使有結果，也要確認監聽位址與處理程序，不能只看連接埠號碼。變更本機連接埠後，請儲存設定並重新載入核心，再重新設定系統代理；瀏覽器或終端機中手動輸入的代理位址也要一併更新。
八、升級前備份與完成檢查
升級前請正常結束 v2rayN，並確認相關核心處理程序已停止，再備份原本的工作資料夾。Desktop 與 WPF 版的設定遷移方式，應以各自的發行說明為準；不要預設任意兩個資料夾都能互相覆蓋。備份可能包含訂閱網址與節點憑證，請存放在私人位置，不要上傳至公開雲端硬碟。
- 主程式：可正常啟動與結束，重新開啟後設定仍能保留。
- 訂閱：分組更新成功、目前使用的節點明確，且記錄中沒有持續出現解析錯誤。
- 核心：本機監聽正常，沒有連接埠占用或檔案遺失提示。
- 代理：瀏覽器與明確指定代理的指令結果可以互相比對，路由規則也符合預期。
- 結束使用：停止使用時清除系統代理；若曾啟用 TUN，請確認介面與路由已恢復正常。
完成 Windows 上的 V2Ray 用戶端設定後，重點就不再是「安裝哪種介面」，而是節點、核心、路由與應用程式是否彼此配合。若要在 Android 裝置使用同一項服務，可前往下載頁查看 v2rayNG 或 v2flyNG 的下載入口；v2rayNG 使用 Xray 核心，v2flyNG 使用 V2Fly 核心，請分別確認協定支援情況。v2rayNG 也需要另外匯入並更新訂閱，桌面版修改節點不會自動同步到其他裝置。