適合第一次在 Windows 設定 v2rayN，或遇到程式無法開啟、訂閱清單空白、瀏覽器仍未走代理的使用者。先選對介面與架構，再完成安裝或完整解壓縮；依序確認「程式啟動 → 更新訂閱 → 選擇伺服器 → 系統代理 → 視需要啟用 TUN」。每次只調整一個環節，避免混淆執行階段、訂閱連線與路由問題。
一、安裝檔：先分清桌面版與 WPF
v2rayN 是用戶端介面，用來管理伺服器設定、呼叫核心及調整代理入口。安裝完成不代表已有可用伺服器，後續仍須匯入有效設定或訂閱。Windows 使用者可依介面習慣選擇桌面版或 WPF 版，兩者並非不同的訂閱服務。
桌面版（Avalonia）
推薦採用跨平台介面。初次使用或不熟悉舊版介面時，可先從這個版本開始；仍須另外確認安裝檔的架構與系統需求。
適合：初次設定，或希望在不同桌面系統維持相近操作體驗的使用者。
WPF 版
採用 Windows 桌面介面。熟悉傳統選單配置時可選用此版本；它不會讓同一個節點自動降低延遲。
適合：主要使用 Windows，且已熟悉傳統介面的使用者。
先開啟 Windows「設定」→「系統」→「關於」，查看「系統類型」。常見的 Intel、AMD 64 位元電腦選擇 x64 安裝檔；若顯示為 ARM 架構處理器，請先確認下載頁是否提供相容版本及其執行需求，不要只憑「64 位元」判斷是否相容。較舊版 Windows 也應先確認目前版本的最低系統需求。
- 可執行安裝檔：依照安裝精靈操作，不要把安裝程式當成需要解壓縮的可攜式壓縮檔。
- 壓縮檔：先選擇「全部解壓縮」，再從解壓縮後的資料夾啟動；不要直接在壓縮軟體的預覽視窗中雙擊執行。
- 切換介面：先備份現有設定，再用獨立資料夾測試；不要直接將兩種發行版本疊加覆蓋。
二、資料夾與執行階段：先確保程式穩定啟動
使用壓縮檔時，可選擇目前帳戶有寫入權限的獨立資料夾，例如 D:\Tools\v2rayN；沒有 D 槽也能放在使用者資料夾中。重點不在磁碟代號，而是程式能否儲存設定、記錄檔與更新檔。系統資料夾、暫存資料夾，以及會自動同步或清理的資料夾，都不適合當作長期執行位置。
-
完整解壓縮
在檔案總管中對壓縮檔選擇「全部解壓縮」，並保留檔案內的資料夾結構。不要只拖出
v2rayN.exe；核心、相依元件及資源檔也可能是程式運作所必需。 -
確認相依元件
初次啟動若提示缺少 .NET，請記下對話框中的執行階段名稱、主要版本與架構。WPF 版本通常需要相應的 .NET Desktop Runtime；只安裝 SDK 或 ASP.NET Core Runtime 不一定符合需求。
-
檢查是否遭封鎖
開啟「Windows 安全性」→「病毒與威脅防護」→「保護歷程記錄」，確認是否有相關檔案遭到隔離。先確認檔案來源與具體警示，不要以關閉整體防護取代問題排查。
-
初次啟動
執行主程式，確認視窗能開啟、設定能儲存，並檢查記錄檔是否提示缺少核心檔案。使用一般系統代理模式時，先以一般權限操作，暫時不要啟用 TUN。
-
建立捷徑
確認程式運作正常後，為實際執行的程式建立捷徑。日後移動整個資料夾時，也要更新捷徑，避免桌面圖示仍指向舊版本。
三、匯入訂閱：儲存網址後還要更新
訂閱網址是用戶端取得設定清單的入口，不是一般網站首頁，也不等同於單一的 vmess:// 或 vless:// 分享連結。取得網址後，先確認內容完整，沒有換行、空格或通訊軟體附加的標點。訂閱通常含有存取憑證，截圖或求助時請遮住完整網址。
以下以常見的中文選單名稱說明；不同介面版本的按鈕位置，或「透過代理」的括號標示可能略有差異，請依相同功能操作，不要為了尋找相同圖示而改用來源不明的舊版安裝檔。
- 在主介面選擇「訂閱分組」→「訂閱分組設定」，新增一個分組，填寫備註與「地址（URL）」，確認已啟用後儲存。
- 返回「訂閱分組」，選擇「更新全部訂閱（不透過代理）」進行首次更新。此時尚未建立可用代理，先測試直接連線較容易判斷問題。
- 更新後選取對應分組，確認伺服器清單是否出現項目。若記錄顯示成功但清單空白，先確認是否套用了分組篩選，再檢查訂閱回傳內容是否為用戶端支援的格式。
- 在清單中選取一個項目，透過右鍵選單的「設為活動伺服器」將它設為目前使用的伺服器，再確認核心是否正常啟動。
若訂閱網站只能透過代理存取，且已有可用伺服器，可改用「更新全部訂閱（透過代理）」。這並非所有訂閱更新失敗時都適用的解法：沒有可用伺服器時勉強使用代理，反而會陷入「需要更新才能連線、需要連線才能更新」的循環。單一分享連結則使用「伺服器」→「從剪貼簿匯入批次 URL」，不要填入訂閱網址欄位。
四、系統代理：先確認瀏覽器連線流程
選取伺服器後，在主介面或系統匣選單的「系統代理」中選擇「自動設定系統代理」。這裡的「自動設定」是 v2rayN 的選單操作，不代表瀏覽器一定使用 PAC。接著檢查 Windows「設定」→「網路和網際網路」→「Proxy」，確認代理位址與本機監聽連接埠相符。
開啟「設定」→「參數設定」，查看本機監聽或入站設定，並記下實際連接埠。部分版本使用混合監聽入口，舊設定也可能分別設定 HTTP 與 SOCKS；不要照抄他人的連接埠截圖。系統代理指向的入口必須能接受 HTTP 代理要求，不要誤填只支援 SOCKS 的連接埠。
| 觀察到的狀況 | 優先檢查項目 | 接下來的操作 |
|---|---|---|
| 所有瀏覽器都顯示代理連線失敗 | 本機核心是否已啟動，連接埠是否相符 | 先查看核心記錄，確認已成功監聽後再測試網頁 |
| 瀏覽器可用，但某個應用程式無法使用 | 該應用程式是否會讀取系統代理 | 檢查應用程式本身的代理設定，再評估是否使用 TUN |
| 部分網站直接連線，部分網站走代理 | 目前的路由規則與匹配的出站設定 | 查看連線記錄，不要只憑出口變化判斷代理失效 |
| 關閉用戶端後，網頁也無法開啟 | Windows 是否仍保留本機代理位址 | 重新開啟用戶端以清除系統代理，或關閉殘留的手動代理設定 |
系統代理只會影響願意讀取該設定的應用程式，不代表「所有流量都會走代理」。即使流量進入核心，路由規則仍可將部分目的地導向直接連線。初次驗證時，請選擇自己有權存取且回應穩定的 HTTPS 網頁，並搭配記錄檔確認要求是否確實送達核心。
五、TUN：依應用程式需求擴大接管範圍
TUN 透過虛擬網路介面接收流量，適合不會讀取系統代理的應用程式，但也會增加路由、DNS 與權限等變數。先確認訂閱與伺服器能正常使用，再啟用 TUN，才能區分「伺服器原本就無法使用」與「本機接管設定有衝突」。
選擇方案：先用系統代理，再視需要啟用 TUN
優先使用系統代理
- 主要需求是瀏覽器及支援代理的桌面應用程式。
- 可先以一般權限驗證，排查步驟較少。
- 應用程式是否會接入，取決於它是否讀取系統代理。
視需要啟用 TUN
- 目標應用程式不會讀取系統代理，也沒有合適的手動設定入口。
- 依用戶端提示處理管理員權限或服務權限。
- 啟用後，檢查 DNS、路由及其他虛擬網卡是否有衝突。
TUN 擴大的是流量接入範圍，不會自動讓所有路由改走代理，也無法修正錯誤的伺服器參數。
第一次在主介面啟用「啟用 TUN」時，先儲存工作並依提示取得較高權限。為減少變數，可先在「系統代理」中選擇「清除系統代理」，單獨測試 TUN；兩者不一定互斥，但初步排查時不必同時更動兩種入口。若公司網路或其他連線工具仰賴特定虛擬網卡，請先確認使用限制，不要任意刪除網卡或重設整台電腦的網路。
- 啟用後無法開啟網域：檢查核心記錄中的 DNS 錯誤，以及目前 DNS 設定是否形成迴圈；不要任意將伺服器網域改成來源不明的 IP。
- 無法存取區域網路裝置：檢查私有網段的路由策略，依實際需求設定直接連線，不要直接停用所有分流規則。
- 關閉後仍有異常：先結束用戶端，再檢查殘留的系統代理與其他網路軟體。必要時正常重新啟動，讓網路狀態重新建立。
六、常見問題：依現象找原因，別反覆重裝
重新安裝介面通常無法解決訂閱過期、連接埠占用或傳輸參數不符。尋求協助前，記下介面版本、Windows 版本、使用模式與一小段相關記錄；並刪除訂閱憑證、伺服器驗證資訊及個人資料夾路徑。以下問題可先自行縮小範圍。
雙擊後沒有視窗，是程式壞了嗎？
先查看系統匣，確認程式是否已啟動並縮至背景；再檢查工作管理員中是否有舊程序。若確實沒有程序，請檢查執行階段提示與保護歷程記錄。不要連續雙擊啟動多個執行個體，以免造成連接埠衝突。
訂閱更新成功了，為什麼還是無法上網？
更新成功只代表已取得並解析設定。先設定活動伺服器，再啟用系統代理，接著查看核心記錄。也請開啟「設定」→「時間與語言」→「日期與時間」，確認系統時間正確；TLS 憑證驗證等程序需要準確時間。
記錄顯示位址已被占用，需要更換連接埠嗎？
先查出占用連接埠的程序，優先結束重複啟動的舊執行個體。確實需要更換連接埠時，請在「設定」→「參數設定」修改實際入站連接埠，重新啟動核心，再重新套用系統代理；手動設定代理的應用程式也要同步修改。
切換核心就能解決所有逾時嗎？
不能。先核對設定所需的協定、傳輸方式、TLS 伺服器名稱與相關欄位，並確認所選核心支援這些組合。VLESS 與 VMess 不是可任意互換的標籤；不要為了消除錯誤而停用憑證驗證，也不要擅自修改伺服器指定的傳輸路徑。
快速檢查連接埠占用
如果本機實際監聽的連接埠是 10808，可在命令提示字元執行下列命令。若使用其他連接埠，請先替換數字。查看狀態為 LISTENING 的列及末尾的 PID，再到「工作管理員」→「詳細資料」核對程序；不要只看到 PID 就直接終止不明的系統程序。
netstat -ano | findstr ":10808"若本機監聽正常，但記錄顯示遠端連線逾時，請再檢查伺服器位址、連接埠、網路連線狀況及服務提供者狀態。延遲測試結果也無法單獨證明瀏覽器要求已經過代理；完整驗證仍須比對應用程式連線與核心記錄。
七、結束與更新：保留可還原的設定
安裝完成後，建議保留一份已驗證可用的設定備份。設定檔可能包含訂閱網址與驗證參數，請存放在可信任的位置；不要將整個程式資料夾上傳至公開空間。更新前先結束用戶端並確認相關程序已停止，避免檔案仍被占用而只更新一部分。
- 正常結束：先關閉 TUN，再清除系統代理，最後從系統匣結束程式。只關閉視窗可能只是將程式最小化，不能據此判斷核心已停止。
- 更新版本：依照對應的發行方式完成更新。使用壓縮檔時，先解壓縮至新資料夾並確認檔案完整，再依版本說明移轉必要設定；不要混用舊核心與新版介面檔案。
- 還原測試：保留原有設定備份，但不要同時啟動新舊兩套程式。更新後若出現異常，先比對核心啟動記錄與監聽連接埠，再決定是否還原。
最精簡的穩定設定流程是：程式能啟動、訂閱能更新、活動伺服器能連線、目標應用程式能使用系統代理。只有最後一項不符合需求時，再考慮 TUN。依照這個順序設定，遇到問題時就能判斷應該檢查哪個環節，而不必從頭重裝。