適合第一次在 Windows 上設定 v2rayN，或遇到啟動閃退、匯入訂閱後無法上網的使用者。先確認系統架構與介面版本，再完整解壓縮、安裝所需執行環境並匯入訂閱，最後逐一確認節點、本機連接埠與系統代理。每次只調整一項，才能分辨是安裝問題還是連線問題。
一、Desktop 版與 WPF 版：先選介面，再確認系統架構
開啟 Windows「設定」→「系統」→「系統資訊」，查看「系統類型」。x64 處理器通常選 Windows x64 套件；ARM64 裝置優先選對應的 ARM64 套件，但要先確認該介面版本確實提供此架構。別只因檔名有 Windows 就下載，也別把系統架構和節點協定混為一談。
Desktop 版
推薦採用跨平台桌面介面。第一次設定可從這個版本開始，依目前下載頁說明選擇 Windows 架構。介面版本會影響選單配置，不會自動提升節點頻寬或降低網路延遲。
適合：首次安裝，或希望沿用跨平台介面操作習慣的使用者。
WPF 版
採用經典 Windows 桌面介面。熟悉這種配置的使用者可以繼續使用。執行環境需求以下載的發行套件為準，別直接套用舊版教學中的依賴版本。
適合：習慣經典介面，或已有明確 Windows 操作流程的使用者。
Desktop 與 WPF 是介面實作方式的差異；Xray 與 V2Ray 是代理核心的差異；VMess 與 VLESS 則是節點使用的協定。三者所屬層級不同。切換介面無法修正錯誤的伺服器位址，切換核心也不能取代主程式所需的執行環境。
二、完整解壓縮並首次啟動：不要直接在壓縮檔內執行
-
確認安裝套件
前往下載中心，選擇適用的 Windows 介面版本與系統架構。先查看套件類型說明，確認下載的是壓縮檔、安裝程式，還是已包含執行環境的發行套件。
-
完整解壓縮
可將壓縮檔解壓縮至
C:\Tools\v2rayN這類具有寫入權限的固定資料夾。不要只把v2rayN.exe拖出來，也不要直接從壓縮軟體的預覽視窗啟動。 -
安裝必要依賴
若啟動時提示缺少 .NET，記下視窗要求的執行階段名稱、主要版本與系統架構，再安裝相符的元件。若 WPF 套件要求 Windows Desktop Runtime，只安裝一般的 .NET Runtime 可能不夠。
-
確認能否啟動
執行主程式，確認主視窗與記錄區域都能正常開啟。初次檢查先使用一般使用者權限；之後只有啟用 TUN 等需要權限的功能時，才依介面提示操作。
如果使用安裝程式，依照安裝精靈完成安裝即可，不必再進行壓縮檔解壓縮。遇到閃退時，先記下錯誤訊息與套件類型；反覆將程式移到不同資料夾，或安裝多個不相容的執行環境，只會讓後續排查更困難。
三、匯入訂閱：先取得節點清單，再開始連線
訂閱連結用來取得節點設定，不是瀏覽器的代理伺服器位址。連結通常包含存取憑證，請妥善保護，勿將完整連結貼到公開截圖或求助記錄中。訂閱到期、流量用完或伺服器回傳登入頁面，都可能造成更新失敗。
-
新增群組
在主介面開啟「訂閱群組」→「訂閱群組設定」並新增群組；若目前介面提供「+」按鈕，也可以從該處新增。輸入方便辨識的名稱，再將完整訂閱連結貼到網址欄位。
-
更新訂閱
儲存後，在「訂閱群組」選單中選擇「更新全部訂閱（不透過代理）」。初次設定時尚無可用代理，先嘗試直接連線更新；不同發行版的括號文字可能略有差異，請以實際選單為準。
-
確認節點清單
確認清單中是否顯示節點名稱、位址、連接埠與協定。若清單為空，先查看更新記錄，不要急著啟用系統代理。若回傳內容是網頁而非訂閱資料，請向服務提供者確認連結用途。
-
設為目前使用的節點
選取一個節點，在右鍵選單中設為目前使用的伺服器。執行「測試伺服器真實連線延遲」之類的測試，確認有結果後，再設定瀏覽器代理。
只有現有節點已可用，且訂閱網址確實需要透過代理存取時，才嘗試透過代理更新訂閱。真實連線延遲會受到測試目標與目前路線影響；例如顯示 180 ms，只代表該次請求成功及所花時間，不代表持續下載速度，也不能保證所有網站都能存取。
四、本機連接埠與系統代理：確認流量入口
開啟「設定」→「參數設定」，查看基本設定或本機監聽相關頁面中的連接埠數值。不同版本可能使用「本機混合監聽連接埠」等名稱。以下以混合連接埠 10808 為例；若實際設定不同，命令與系統設定都必須一併調整。
- 先啟用節點，確認記錄中沒有核心啟動失敗，再從主介面底部或系統匣選單的「系統代理」中選擇「自動設定系統代理」。
- 開啟 Windows「設定」→「網路和網際網路」→「Proxy」，確認用戶端寫入的位址與連接埠符合目前的監聽設定。
- 初次測試時，不要同時手動修改 Windows 代理、瀏覽器擴充功能與用戶端連接埠。先讓瀏覽器使用系統代理，再逐項檢查。
- 若只在本機使用，請保留迴送位址監聽與預設存取限制。不要為了方便測試而任意啟用允許區域網路連線。
舊版教學有時會分別設定 SOCKS 連接埠 10808 與 HTTP 連接埠 10809。目前安裝是否分開監聽，請以實際參數為準，不要直接照抄。HTTP 代理請求必須使用支援 HTTP 的連接埠；混合監聽則可在同一連接埠接收相應類型的代理請求。
五、系統代理與 TUN：先用一種模式完成驗證
初次安裝建議：先設定系統代理，有需要再啟用 TUN
系統代理
- 先用於瀏覽器等會遵循系統代理設定的應用程式。
- 在主介面的「系統代理」選單中啟用，結束使用前記得清除。
- 不遵循系統代理設定的程式仍可能直接連線。
TUN 模式
- 適用於需要在網路層接管流量的情境。
- 可能需要提高權限、安裝虛擬網卡，並使用相容的核心。
- 另行檢查 DNS、路由與其他虛擬網卡是否衝突。
先關閉 TUN，使用系統代理驗證節點與連接埠；確實需要接管應用程式流量時，再單獨測試 TUN，避免同時變更多項設定。
路由分流與系統代理也是不同的功能。系統代理決定應用程式是否將請求交給用戶端；路由規則則決定用戶端收到請求後要代理、直連或阻擋。初次使用可選擇介面提供的一般分流模式；若特定網域異常，再查看該請求實際套用哪條規則。
別以為「全域」模式會自動涵蓋所有 Windows 程式。在系統代理模式下，若應用程式根本不讀取系統代理設定，變更用戶端的路由模式也無法讓它自動接入。先用明確支援代理的工具測試，再判斷是否需要 TUN。
六、使用命令列驗收：區分本機與遠端問題
在 PowerShell 中依序執行以下命令。第一個命令確認本機是否有處理程序監聽範例連接埠；第二個命令明確指定 HTTP 代理，避免瀏覽器快取、擴充功能或系統代理讀取差異影響結果。測試網址可替換為確認能存取的 HTTPS 網站。
Get-NetTCPConnection -State Listen -LocalPort 10808
curl.exe --proxy http://127.0.0.1:10808 --connect-timeout 10 --max-time 20 -I https://example.com/| 結果 | 說明 | 下一步 |
|---|---|---|
| 查不到監聽連接埠 | 核心未監聽該連接埠，或範例數值與實際設定不同。 | 確認參數設定與核心記錄，不要先更換節點。 |
| 連線至本機遭拒 | 請求尚未成功送入本機代理。 | 檢查連接埠、監聽位址與核心處理程序。 |
| 連上本機後逾時 | 可能與遠端連線、DNS 或目標網站有關。 | 換一個測試目標，再比對節點測試結果與錯誤記錄。 |
| 收到 HTTP 回應標頭 | 這次明確指定代理的請求已收到回應。 | 接著用瀏覽器確認系統代理與路由選擇。 |
若只看到 200 Connection established，代表代理通道建立階段成功，還要繼續查看目標網站的回應或後續錯誤。即使最後收到 403，也要區分是「網站拒絕存取」還是「本機代理未啟動」，兩者的處理方式不同。
七、常見安裝問題：依症狀排除，不要反覆重裝
雙擊後沒有視窗，應該先重新安裝嗎？
先查看工作列系統匣與工作管理員，確認程式是否已在背景執行。若處理程序立即結束，記下啟動提示，並確認系統架構、執行環境與解壓縮內容是否完整。別直接覆蓋舊資料夾碰運氣；需要比較時，將新套件解壓縮到獨立資料夾，結束舊處理程序後再啟動。
顯示連接埠已被占用，該如何查找？
執行 Get-NetTCPConnection -State Listen -LocalPort 10808，查看 OwningProcess，再用 Get-Process -Id 進程編號 查詢處理程序名稱。先確認是否有重複啟動的舊核心。若改用其他未占用的連接埠，記得重新套用系統代理，並同步修改手動設定的應用程式代理。
節點顯示有延遲，瀏覽器卻無法連線怎麼辦？
先執行明確指定代理的命令。若命令成功、瀏覽器失敗，優先檢查瀏覽器代理擴充功能、系統代理位址與路由規則；若命令也失敗，再檢查目前使用的節點與核心記錄。一般延遲或 TCP 測試不等於完整的代理請求驗證。
更新後節點或設定不見了，該怎麼辦？
先確認是否從新資料夾啟動了另一份程式。更新前請完整結束程式，並備份原資料夾中的設定資料；實際資料位置請參閱該版本說明。不要在兩個正在執行的介面版本之間直接覆蓋設定檔。訂閱可重新匯入，但自訂路由與本機參數需要另外備份。
退出後所有網頁都無法開啟，如何復原？
先重新開啟用戶端，在「系統代理」中選擇「清除系統代理」後再退出。若用戶端無法啟動，請到 Windows 代理設定中移除已失效的本機手動代理；受管理的公司裝置請先聯絡管理員。接著檢查是否還有其他網路流量接管程式。
八、安裝完成後的檢查清單
- 啟動：主程式與核心都正常執行，記錄中沒有持續重複的啟動錯誤。
- 訂閱：節點清單非空，已選擇目前使用的伺服器，且未在公開內容中洩漏訂閱網址。
- 連接埠：實際監聽值與系統代理設定一致，明確指定代理的命令可取得目標回應。
- 瀏覽器：能透過系統代理存取測試網站，路由結果符合預期。
- 結束使用：清除系統代理後，一般直連恢復正常；重新啟動用戶端後也能再次完成驗證。
完成以上檢查，安裝流程才算完整。之後若只有單一節點逾時或單一網站異常，應從節點、目標網站與路由規則著手，不必先切換 Desktop 與 WPF 介面。保留安裝套件類型、系統架構與已去除敏感資訊的錯誤記錄，有助減少重複排查。