適合第一次在 Windows 上使用 v2rayN，或換電腦後需要重新設定的使用者。依序確認系統架構、選擇介面版本、完整解壓縮、補齊執行環境、匯入訂閱及設定系統代理。若無法啟動，先檢查程式與執行環境；若介面正常但無法連線，再檢查核心、監聽連接埠與節點，不必一開始就啟用 TUN。
一、選擇 Windows 版本、處理器架構與安裝套件
先開啟 Windows 的設定 → 系統 → 關於 → 系統類型。常見的 Windows 10、Windows 11 電腦若搭載 Intel 或 AMD 64 位元處理器，通常選擇 x64 套件；ARM 電腦則優先確認下載頁是否提供相應的 ARM64 套件。不要只憑電腦品牌判斷架構，也別把作業系統位元數和用戶端介面版本混為一談。
v2rayN 是圖形化用戶端，可管理伺服器、訂閱與路由，並呼叫代理核心執行。桌面版採用 Avalonia 介面框架，WPF 版則使用 Windows 專用介面框架。兩者都不是節點協定名稱；選擇 WPF 也不代表只能使用特定協定。實際功能仍取決於用戶端版本、隨附核心及節點參數。
| 選項 | 判斷依據 | 操作建議 |
|---|---|---|
| 桌面版 | Avalonia 跨平台介面 | 選擇對應的 Windows 套件，並確認架構符合系統類型。 |
| WPF 版 | Windows 專用介面 | 習慣傳統 Windows 介面可選用；請依發行說明確認執行環境需求。 |
| x64 / ARM64 | 系統類型所列的處理器架構 | 優先選擇原生架構套件，並確認相應核心也能執行。 |
| 自包含／依賴執行環境 | 確認安裝套件是否包含執行環境 | 自包含套件通常較大；依賴執行環境的套件則須另行安裝指定環境。 |
選擇原則：先確認架構，再檢查執行環境需求
前往下載頁選擇 Windows 套件，記下所選版本與架構。只有出現明確的框架缺失提示時，才依提示安裝相應執行環境；不要反覆切換介面版本來取代問題排查。
二、完整解壓縮至可寫入的資料夾
壓縮檔中的主程式、相依檔案與核心資料夾都必須維持原有的相對位置。直接在解壓縮軟體中雙擊 v2rayN.exe，可能只會暫時解出部分檔案，導致介面能開啟但服務無法啟動。建議使用目前帳戶可寫入且位置固定的資料夾，例如 C:\Users\Public\Tools\v2rayN；若該資料夾受組織原則限制，請改用個人使用者目錄下的工具資料夾。
- 前往用戶端下載頁取得所選的 Windows 套件，下載完成後再執行「全部解壓縮」。
- 開啟解壓縮後的資料夾，確認其中有
v2rayN.exe和其他套件檔案；不要只把主程式拖到桌面。 - 首次執行前，請勿將資料夾放在壓縮檔內、暫存資料夾或需要額外寫入權限的位置。
- 雙擊實際資料夾中的
v2rayN.exe。若要建立桌面入口，請為這個檔案建立捷徑，而不是複製檔案本身。
遇到 Windows 安全性提示時，先確認下載來源與檔案資訊。公司電腦遭到封鎖可能是組織原則所致，請洽管理員確認。不要把關閉系統防護或將整個下載資料夾加入排除清單，當成通用安裝步驟。
三、首次啟動與 .NET 執行環境相依項目
首次啟動時，先確認「介面能否開啟」，再檢查「代理核心是否啟動」。這兩個階段應分開排查：主介面無法開啟時，通常先檢查架構、相依項目及檔案是否完整解壓縮；主介面正常但記錄顯示找不到核心檔案時，則檢查安裝套件內容、核心路徑及安全軟體記錄。
- 提示安裝 .NET：展開錯誤詳細資訊，記下要求的框架名稱、主要版本與架構。不同 v2rayN 發行版本的需求可能不同，請勿沿用舊教學中固定的執行環境版本號。
- WPF 版提示缺少 Windows Desktop 框架：請安裝相符的 .NET Desktop Runtime。只安裝一般的 .NET Runtime，不一定能滿足桌面框架需求。
- 已安裝執行環境仍提示缺失：確認 x64 或 ARM64 架構是否相符，以及主要版本是否符合需求。安裝較新的主要版本，不代表一定能取代程式要求的舊版主要版本。
- 使用自包含套件：通常不必另行安裝套件已包含的 .NET 環境，但仍須符合該套件的系統需求，並保留配套檔案。
一般系統代理模式通常不需要一直以系統管理員身分執行。首次排查時，先以一般帳戶啟動；只有明確啟用需要額外權限的功能時，才依用戶端提示授權。把「以系統管理員身分執行」當成所有問題的預設解法，可能會掩蓋資料夾權限或檔案缺失等真正原因。
四、匯入訂閱、選擇節點與設定系統代理
用戶端開啟後，不會自動取得可用伺服器。訂閱是提供伺服器設定的網址；VMess、VLESS 等則是節點使用的協定，兩者並非同一層概念。請使用服務提供者提供、相容於用戶端的訂閱網址，而不是帳戶管理頁面的網址。
- 開啟
訂閱群組 → 訂閱群組設定，新增群組，填入方便辨識的備註與完整訂閱網址後儲存。 - 在
訂閱群組選單中執行更新所有訂閱。若目前介面可選擇直接連線或透過代理更新，請依訂閱網址實際可連線的方式選擇；首次使用時若尚無可用節點，請勿仰賴無法運作的代理更新訂閱。 - 確認伺服器清單中已出現節點，再選擇一個節點並設為作用中伺服器。不同版本可透過右鍵選單或相應的設為作用中伺服器操作完成。
- 查看底部記錄，確認服務已啟動，且沒有監聽失敗或設定載入錯誤。
- 在主介面底部列或系統匣的
系統代理選單中選擇自動設定系統代理，再開啟瀏覽器測試。選單位置會因介面版本略有不同。 - 依需求前往
路由設定選擇繞過中國大陸（Whitelist）等規則。系統代理決定應用程式是否將請求送進用戶端；路由規則則決定請求進入用戶端後的走向。
五、確認本機連接埠與 Windows 代理狀態
以下數字僅用來說明本機連線方式，不代表所有 v2rayN 版本都採用相同的預設值。實際連接埠請前往設定 → 參數設定查看本機監聽相關選項；部分版本會將相關項目放在Core 基礎設定中。較新的設定可能使用混合連接埠，舊設定則可能分別提供 SOCKS 與 HTTP 監聽。
若某個應用程式要求單獨填寫 HTTP 代理，請使用用戶端實際提供的 HTTP 或混合監聽連接埠；只支援 SOCKS 的連接埠不能當作 HTTP 連接埠。也不要將遠端節點的伺服器連接埠填入 Windows 本機代理設定。
若出現連接埠占用，在命令提示字元中執行以下唯讀查詢。重點查看本機位址欄是否為該連接埠、狀態是否為 LISTENING，以及行尾的 PID；遠端位址中出現相同數字，不代表本機連接埠遭到占用。
netstat -ano | findstr ":10808"接著在工作管理員的「詳細資料」頁面依 PID 找出處理程序。若是另一個 v2rayN 執行個體，請先從其系統匣選單結束程式；若是必須保留的程式，可將本機監聽改為尚未使用的連接埠，例如確認空閒後使用 10818，儲存並重新啟動服務。重新套用系統代理，也要同步修改瀏覽器擴充功能或其他應用程式中手動填寫的舊連接埠；不要任意結束不熟悉的系統處理程序。
六、首次啟動常見錯誤與排除順序
以下原文可能出現在彈出視窗、用戶端記錄或核心記錄中，周邊文字會因版本而異。先記下完整錯誤訊息與發生時間，再依問題所在層級處理；不要只憑「網頁打不開」就判定安裝套件有問題。
錯誤：You must install or update .NET to run this application.
原因與解決方式：程式要求的 .NET 框架或架構不符。查看彈出視窗中的 Framework 與 Architecture，安裝相應執行環境後重新啟動；若要求 Windows Desktop 框架，請選擇對應的 Desktop Runtime。
錯誤：This app can't run on your PC
原因與解決方式：可能是系統架構不符、Windows 版本未達需求，或程式檔案損毀。返回「設定 → 系統 → 關於」確認系統類型，重新選擇支援目前系統的安裝套件並完整解壓縮。
錯誤：Only one usage of each socket address (protocol/network address/port) is normally permitted.
原因與解決方式：通常是監聽位址與連接埠已被其他處理程序占用。依錯誤訊息中的連接埠查詢 PID，結束重複執行的程式，或變更本機監聽連接埠並同步更新應用程式代理設定。
錯誤：An attempt was made to access a socket in a way forbidden by its access permissions.
原因與解決方式：連接埠繫結受到權限、保留連接埠範圍或安全性原則限制。先確認沒有重複監聽，再使用 netsh interface ipv4 show excludedportrange protocol=tcp 查看 TCP 排除範圍，並選擇允許使用且未被占用的連接埠；請勿直接刪除系統保留項目。
錯誤：connectex: No connection could be made because the target machine actively refused it.
原因與解決方式：目標拒絕連線。先查看錯誤中的目標位址：若為 127.0.0.1，請確認本機核心是否正在監聽，以及代理連接埠是否一致；若為遠端伺服器，則檢查節點位址、伺服器連接埠與服務狀態。
若用戶端提示找不到核心檔案，先結束程式，確認是否誤將單獨的主程式當成完整安裝資料夾，或下載了需要另外準備核心的套件。接著查看 Windows 安全性中的保護歷程記錄，確認檔案是否遭隔離。確認來源與具體檔案後再處理，請勿直接還原所有遭封鎖的項目。
七、安裝後常見問題
安裝後沒有桌面圖示，是不是沒有安裝成功？
以壓縮檔散布的版本不一定會建立系統安裝記錄或桌面捷徑。請先在完整解壓縮的資料夾中執行 v2rayN.exe，確認能正常開啟後再建立捷徑；不要因為沒有圖示就重複解壓縮多份並同時啟動。
介面能開啟，但更新訂閱後仍沒有節點，該怎麼辦？
前往「訂閱群組 → 訂閱群組設定」確認網址是否完整，再查看更新記錄，判斷是逾時、驗證失敗還是解析失敗。若訂閱結果是登入頁面，請改用服務提供者提供的訂閱網址；若逾時，先確認更新所使用的網路路徑是否可連線。
節點測試有結果，為什麼瀏覽器還是打不開網頁？
先確認該節點已設為作用中伺服器，再選擇「系統代理 → 自動設定系統代理」。開啟 Windows「設定 → 網路和網際網路 → 代理」，確認代理指向目前的本機監聽；同時檢查瀏覽器是否使用獨立的代理設定。單次延遲測試不代表所有目標網站都能連線。
結束 v2rayN 後，電腦反而無法連上網路？
可能是 Windows 仍指向已停止的本機代理。重新啟動用戶端，執行「系統代理 → 清除系統代理」後再結束程式；也可以在 Windows 代理設定中檢查手動代理。若原本使用組織提供的代理，請先記錄並還原組織設定，不要直接清除。
需要一開始就啟用開機啟動和 TUN 嗎？
先完成一次一般啟動、訂閱更新、節點連線，以及結束程式後恢復網路的測試。確認基本連線正常後，再逐一啟用開機啟動或 TUN；每次只變更一項設定，發生異常時才能回復到已驗證的狀態。
若要進一步排查，只需保留 Windows 系統類型、v2rayN 版本、所選介面版本、完整錯誤訊息與本機監聽連接埠。分享記錄前，請遮蔽訂閱網址、使用者識別資訊與驗證參數。依序檢查「程式啟動 → 核心執行 → 本機監聽 → 應用程式代理 → 遠端節點」，比同時更換安裝套件、連接埠與路由更容易找到問題。