適合第一次在 Windows 使用 v2rayN，或打算從 WPF 版改用桌面版的使用者。先確認系統架構與軟體包類型，再完成解壓縮、執行環境檢查、匯入訂閱及設定系統代理。排查問題時，請分別確認「介面能否啟動」、「核心能否執行」及「應用程式是否經過代理」，別把網頁無法開啟一概當成安裝失敗。
桌面版與 WPF 版怎麼選
v2rayN 是用來管理伺服器設定、訂閱與路由規則的用戶端介面，實際連線則由它呼叫的代理核心處理。桌面版與 WPF 版主要差異在介面技術與使用方式，並非兩套伺服器協定，也不是兩種訂閱服務。能否連上相同伺服器，仍取決於使用的核心、節點參數與網路環境。
桌面版
推薦採用跨平台介面。初次安裝可從下載頁的 Windows 桌面版入口開始，並依目前軟體包說明確認系統架構與執行環境。推薦的原因是新手比較容易找到合適的選項，不代表連線速度一定比 WPF 版快。
適合：首次設定、想熟悉跨平台介面的使用者
WPF 版
採用經典 Windows 介面，適合熟悉原有選單配置的使用者。所需相依項目請以該軟體包的發行說明及啟動提示為準；介面看起來相似，不代表可以混用舊目錄中的程式與新軟體包檔案。
適合：習慣經典 Windows 介面、已有固定操作流程的使用者
切換介面版本時，先放在獨立目錄試用。請勿同時啟動兩個用戶端，否則系統代理設定可能反覆變更，本機監聽連接埠也可能衝突。確認新版本能匯入設定並成功連線後，再處理舊目錄；個人訂閱網址與設定備份應存放在只有自己能存取的位置。
下載前檢查系統架構與軟體包
開啟 Windows「設定」→「系統」→「關於」，查看「系統類型」。x64 與 ARM64 指的是處理器架構，不是介面風格；請依下載頁實際列出的軟體包選擇。若沒有對應的架構選項，別只憑檔名猜測相容性。較舊的系統也應先確認目前版本的系統需求，不要反覆重裝同一個軟體包。
| 檢查項目 | 操作方式 | 避免的問題 |
|---|---|---|
| 處理器架構 | 在「系統類型」確認 x64 或 ARM64，再與下載頁的選項比對。 | 程式無法執行，或相依項目的架構不相符。 |
| 軟體包類型 | 壓縮檔請使用「全部解壓縮」；安裝程式則依精靈指示完成安裝。 | 把安裝程式和免安裝資料夾當成相同方式處理。 |
| 執行環境 | 記下啟動提示要求的 .NET 執行階段類型、主要版本與架構。 | 只安裝 SDK，或安裝錯誤的執行階段類型，仍然無法啟動。 |
| 核心檔案 | 保留軟體包的資料夾結構，並查看記錄是否指出缺少核心檔案。 | 只複製主程式，導致介面能開啟、連線卻無法使用。 |
若啟動畫面明確要求 .NET Desktop Runtime，請安裝對應主要版本與架構的桌面執行階段；若提示要求其他執行階段，則依指示處理。WPF 需要桌面執行階段，但不同發行包是否已包含相依項目並不一致，不能替所有版本指定同一個固定版本號。若沒有缺少檔案的提示，也不必為了「預防問題」額外安裝開發工具。
解壓縮與首次啟動依序完成
-
取得軟體包
前往用戶端安裝包頁面，選擇 Windows 版 v2rayN 桌面版或 WPF 版。儲存檔案後，先確認它是壓縮檔還是安裝程式，再進行下一步。
-
完整解壓縮
在壓縮檔上按右鍵，選擇「全部解壓縮」，並解壓縮至自己有寫入權限的獨立資料夾，例如
D:\Apps\v2rayN。請勿直接在壓縮檔預覽視窗中連按兩下執行，也不要只把單一執行檔拖出來。 -
啟動主程式
進入解壓縮後的實際程式資料夾，執行主程式。若出現缺少執行階段的提示，先安裝相依項目；若沒有主視窗，請查看工作列通知區域，確認程式是否已最小化至系統匣。
-
檢查本機設定
開啟「設定」→「參數設定」，查看本機監聽連接埠及相關選項。首次測試請先維持 TUN 關閉，避免同時使用虛擬網卡與系統代理兩種流量接管方式。
-
建立捷徑
確認程式能正常啟動並儲存設定後，再為主程式建立捷徑。之後透過捷徑啟動，不要移動主程式，也不要把解壓縮資料夾當成暫存資料夾清除。
首次匯入訂閱分清網址與節點
訂閱網址用來取得一組伺服器設定，單一分享連結則代表一個節點。安裝好用戶端後不會自動取得伺服器，請使用自己有權存取的訂閱或節點資訊。訂閱連結通常含有存取權杖，截圖、記錄檔及公開求助內容都不應包含完整網址。
- 開啟「訂閱群組」→「訂閱群組設定」，選擇「新增」。填入方便辨識的備註，將完整訂閱連結貼到網址欄，再儲存。不同介面版本的新增入口可能顯示為加號，操作方式相同。
- 返回主視窗，開啟「訂閱群組」選單；首次更新可選擇「更新全部訂閱（不透過代理）」。尚無可用節點時，別先依賴「透過代理更新」來建立第一條連線。
- 更新後查看伺服器清單。若目前選到其他群組或輸入了搜尋文字，請先切換至目標群組並清除篩選條件，以免把「沒有顯示」誤認為「沒有匯入」。
- 選取要使用的伺服器，按右鍵選擇「設為活動伺服器」。確認目前活動項目已變更，再查看核心啟動資訊；只選取某一列，不一定代表已切換活動伺服器。
若手上的是以 vmess:// 或 vless:// 開頭的單一分享連結，可先複製，再選擇「伺服器」→「從剪貼簿匯入分享連結」。不要將這類連結貼到需要 HTTP 網址的訂閱更新欄。選單文字可能隨版本調整，辨識時請留意「匯入分享連結」與「更新訂閱」的差異。
系統代理與連接埠先測試瀏覽器
設定活動伺服器後，還需要讓應用程式將要求傳送至本機代理。透過系統匣選單或主視窗中的「系統代理」入口，選擇「自動設定系統代理」。路由先使用內建的「繞過中國大陸」類預設，實際名稱請以目前的規則清單為準。系統代理負責應用程式的流量入口，路由則決定流量進入核心後使用哪個出口，兩者不能互相取代。
這些連接埠是本機應用程式連線至用戶端的入口，不是遠端伺服器連接埠。較新的設定可能使用單一混合入口，同時接受 HTTP 與 SOCKS 要求；舊設定也可能分開監聽。不要照著教學額外啟用不存在的連接埠，請以「設定」→「參數設定」及執行記錄實際顯示的監聽資訊為準。
首次連線檢查
- 活動伺服器
- 已透過右鍵選單設為活動項目
- 系統代理
- 自動設定系統代理
- TUN 模式
- 首次測試時維持關閉
- 路由設定
- 先使用內建預設，不要疊加自訂規則
先確認支援系統代理的瀏覽器能正常連線，再擴展至其他應用程式。
手動設定代理
- 伺服器位址
127.0.0.1- 連接埠範例
10808，須與實際監聽設定一致- 代理類型
- 依應用程式需求選擇 HTTP 或 SOCKS5
- 監聽範圍
- 僅供本機使用時，維持回環位址監聽
只有當應用程式不讀取系統代理，且提供獨立代理設定時，才需要在應用程式內填寫。
先用瀏覽器開啟自己有權存取的網站，同時查看記錄是否出現新的連線紀錄。瀏覽器能連線，不代表所有程式都會使用代理：有些程式會忽略系統代理，或已有獨立的代理設定。遇到這種情況，請優先檢查該程式的網路設定；「自動設定系統代理」並不代表接管整台電腦的所有流量。
啟動與連線故障分層排查
連按兩下程式沒反應，需要重新安裝嗎？
先查看系統匣是否已有程式執行，再確認是否完整解壓縮，以及是否出現執行階段提示。若提示需要桌面執行階段，請確認主要版本與 x64、ARM64 架構。不要在原資料夾反覆覆蓋不同介面版本，改用獨立資料夾重現問題，比較容易找出原因。
伺服器清單有資料，為什麼核心無法啟動？
開啟主視窗底部的記錄或資訊區域，查看是否提示檔案不存在、設定不受支援或連接埠遭占用。若缺少檔案，請重新完整解壓縮；若是協定或參數不受支援，請確認目前節點的需求與所選核心。不要只因成功匯入清單，就認定設定有效。
提示連接埠遭占用，該改哪一個？
先退出其他用戶端及代理程式。必要時執行 netstat -ano | findstr :10808 查看占用資訊，再到工作管理員依 PID 確認程序。只有確認需要變更時，才調整本機監聽連接埠，並同步更新手動設定代理的應用程式。
退出後，瀏覽器也無法開啟網頁？
重新啟動用戶端，先在「系統代理」中選擇「清除系統代理」，再正常退出。若程式無法啟動，可到 Windows「設定」→「網路和網際網路」→「Proxy」檢查「使用 Proxy 伺服器」，移除這次留下的本機代理設定；若是由公司或機構管理的設定，請先向管理員確認。
憑證錯誤也不適合靠重新安裝解決。先到 Windows「設定」→「時間與語言」→「日期與時間」確認時間是否正確，再檢查節點的伺服器名稱與 TLS 設定。請保留憑證驗證，並依記錄定位具體欄位；長期使用「略過憑證驗證」會失去必要的身分驗證。
更新與日常使用保留可復原的設定
首次成功執行後，只要記下使用的介面類型、本機連接埠、路由預設與訂閱群組名稱即可，不必公開完整伺服器參數。之後升級時，仍應先到安裝包頁面確認軟體包類型，退出正在執行的用戶端，再依該軟體包的更新方式處理。若使用壓縮檔，先在新資料夾試用，比直接混合覆蓋更容易排除舊檔殘留。
- 備份前先退出：完整退出用戶端後再備份個人設定，降低寫入期間檔案不一致的風險；備份可能含有訂閱憑證，請限制存取權限。
- 升級後重新確認：檢查活動伺服器、監聽連接埠、系統代理與路由是否符合預期，再測試瀏覽器連線；不要只確認主視窗能否開啟。
- 一次只調整一項：切換介面、調整核心、啟用 TUN 與修改 DNS 不要同時進行。每次變更後都測試一次連線，若失敗才知道該還原哪一項。
- 退出前先清除代理：不再使用時，先清除系統代理再退出程式；等手動連線穩定後，再啟用開機啟動。
完成上述步驟後，基本連線流程就很清楚：應用程式連到本機監聽入口，用戶端依路由將要求交給對應出口，再由核心連線至遠端伺服器。若要讓不遵循系統代理的應用程式連線，請參閱進階設定中的 TUN 與路由說明；若基本設定仍有疑問，可先查看疑難排解，不要用更多選項掩蓋尚未釐清的問題。