適合初次在 Windows 設定 v2rayN,或從 WPF 版轉用跨平台桌面版的使用者。先選擇介面版本與系統架構,再完成解壓縮、執行環境檢查、更新訂閱、啟用節點及設定系統代理。若遇到無法啟動、連接埠衝突或瀏覽器無法連線,可依照文中的狀況逐項排查,不必反覆重新安裝。
WPF 版和跨平台桌面版怎麼選
v2rayN 是用來管理節點、訂閱和代理設定的用戶端,實際連線則由設定所指定的代理核心負責。WPF 版與跨平台桌面版主要差異在介面技術和適用環境,並非兩種代理協定。節點能否使用,還取決於核心功能、設定參數和伺服器狀態,不能只看介面版本判斷。
跨平台桌面版
推薦初次設定可優先選擇下載頁提供的跨平台桌面版。Windows、macOS 和 Linux 的操作介面較一致,日後更換電腦時也較容易找到對應設定;下載時仍須依實際作業系統與架構選擇安裝檔。
適合:初次使用,或需要在不同桌面作業系統間切換的使用者。
經典 WPF 版
採用 Windows 桌面介面,適合已熟悉傳統選單和清單操作的使用者。選擇這個版本不代表必須使用舊協定,也不保證能在舊版 Windows 上執行,仍須確認該版本的系統與執行環境需求。
適合:已習慣 WPF 操作方式、希望沿用熟悉介面的 Windows 使用者。
兩個版本不要解壓縮到同一個資料夾,也不要同時啟用系統代理或 TUN。測試另一個版本前,先清除目前版本的系統代理並結束系統匣中的程式。這樣能避免設定檔互相覆蓋,也能確認是哪個程序正在使用連接埠。
下載前確認系統架構,並解壓縮到可寫入的資料夾
先開啟 Windows「設定」→「系統」→「系統資訊」,查看「系統類型」。一般 Intel、AMD 桌上型電腦通常選擇 x64 版本;ARM 裝置則應確認下載頁與版本說明中的架構支援情形,不要只憑「64 位元」判斷。所有下載入口都在下載用戶端頁面。
-
確認安裝檔
確認檔案名稱對應 Windows、所需架構及 WPF 或跨平台桌面版。若下載的是安裝程式,依照安裝精靈操作;若是壓縮檔,再進行下方的解壓縮步驟。
-
完整解壓縮
將壓縮檔完整解壓縮到目前帳戶可寫入的固定資料夾,例如使用者資料夾下的
Apps\v2rayN。不要直接從壓縮軟體的預覽視窗執行程式。 -
檢查檔案
保留主程式、隨附設定檔與核心相關資料夾的原有結構。若只把
v2rayN.exe複製到桌面,可能會找不到相依檔案或核心;需要快速開啟時,建立捷徑即可。 -
首次啟動
以一般使用者權限啟動主程式,先不要開啟 TUN。進入主畫面後,再查看記錄是否有設定檔寫入失敗、檔案遺失或核心啟動異常等訊息。
無法啟動:先查看執行環境提示
按兩下後沒有視窗,不代表節點無法使用。此時程式尚未進入網路連線階段,應先確認程式是否已縮到系統匣、缺少執行環境、架構不相容,或檔案遭安全軟體隔離。開啟工作管理員確認是否已有 v2rayN 程序,再查看工作列通知區域。
| 看到的狀況 | 優先檢查項目 | 處理方式 |
|---|---|---|
| 提示需要 .NET | 提示中的執行階段名稱、主版本與架構 | 依照目前版本說明安裝相應的執行環境;若 WPF 版本要求 Windows Desktop Runtime,不要只安裝基礎 Runtime。 |
| 提示無法執行此應用程式 | Windows 版本與程式架構 | 重新確認系統類型與版本需求,不要只靠反覆以系統管理員身分啟動來處理。 |
| 提示檔案或核心遺失 | 是否完整解壓縮,以及檔案是否遭隔離 | 檢查解壓縮結果與 Windows 安全性中的保護歷程記錄,再從可信來源重新下載完整檔案。 |
| 儲存設定時顯示拒絕存取 | 資料夾權限、唯讀屬性與檔案是否正在使用 | 結束程式後,將檔案移至目前帳戶可寫入的資料夾,並確認只有一個執行個體正在運作。 |
執行環境需求會隨版本而變,不宜直接照搬舊教學中的固定主版本號。內含執行環境的獨立部署版本,與依賴系統執行環境的版本,處理方式也不同;請以實際啟動提示和對應版本說明為準。安裝完成後重新啟動用戶端,確認錯誤是否仍然出現。
首次匯入訂閱:先更新,再啟用節點
訂閱網址和單一節點分享連結是不同類型的輸入。訂閱通常是用來取得節點清單的 HTTPS 網址;VMess、VLESS 等分享連結則代表單一設定。若將網頁網址、登入頁面網址,或附有多餘說明文字的內容貼到訂閱欄,更新後可能不會出現節點。
-
新增群組
前往主畫面的「訂閱分組」→「訂閱分組設定」,選擇新增或「+」。輸入方便辨識的群組名稱,將完整訂閱網址貼到網址欄,再儲存。部分介面會將入口收在群組管理按鈕中,請尋找名稱相同的功能。
-
更新訂閱
初次設定且尚無可用代理時,選擇「訂閱分組」→「更新全部訂閱(不通過代理)」。若網址只能透過代理存取,請先準備一筆可用設定,再選擇「更新全部訂閱(通過代理)」。
-
檢查清單
查看更新記錄是否成功,並確認目前顯示的是剛建立的群組。若清單為空,請檢查訂閱是否已過期、回傳內容是否為登入頁面,以及群組篩選是否隱藏了其他節點。
-
設為作用中
選取要使用的節點,從右鍵選單選擇「設為活動伺服器」以啟用。查看記錄確認對應核心已啟動,再進行連線測試;只選取清單中的項目,不一定代表已完成切換。
訂閱連結通常包含帳戶存取權杖,不要貼到公開聊天室,也不要將含有完整連結的截圖傳給陌生人。排查時只需記錄錯誤提示、協定和更新時間。若用戶端記錄含有節點網址或使用者識別資訊,分享前也應先去識別化。
節點測試結果只能作為參考。TCP 連線成功不代表 TLS、驗證及後續請求都正常;測試逾時也可能是測試目標無法連線。啟用節點後,應搭配記錄和實際網頁請求判斷,不要只依延遲數字反覆切換。
設定系統代理:先確認本機監聽連接埠
開啟「設定」→「參數設定」,查看本機監聽連接埠及對應的入站協定。以下三個數字僅供辨識設定,並非每個版本都會同時監聽這些連接埠。尤其不要直接套用舊教學中的 HTTP 連接埠,實際值應以目前設定和啟動記錄為準。
- 先確認節點已設為活動伺服器,且核心記錄沒有啟動錯誤。
- 在主畫面底部或系統匣右鍵選單的「系統代理」中,選擇「自動配置系統代理」。選單位置可能因介面而異,這項操作會寫入 Windows 代理設定。
- 開啟 Windows「設定」→「網路和網際網路」→「Proxy」,確認位址和連接埠指向用戶端實際提供的本機 HTTP 或混合監聽。
- 如果瀏覽器擴充功能另行管理代理,請先改為使用系統設定,避免擴充功能的設定覆蓋 Windows 代理。
- 前往目標網頁並查看用戶端記錄;測試完成後若要結束用戶端,請先選擇「清除系統代理」。
「自動配置系統代理」這個選單名稱,不代表所有應用程式都會使用代理,也不代表會自動選擇速度最快的節點。遵循 Windows 系統代理設定的應用程式會使用這個入口,其他程式可能仍直接連線;請求進入核心後要走代理或直連,則由用戶端路由規則決定。
系統代理與 TUN 的啟用順序
先使用系統代理
- 適合先測試瀏覽器連線。
- 一般本機監聽通常不需要系統管理員權限。
- 優先檢查代理位址、連接埠與路由規則。
有需要時再使用 TUN
- 適用於需要透過虛擬網卡接管流量的情境。
- 可能需要調整權限、路由和 DNS 設定。
- 應先確認一般代理已連線,再單獨測試。
初次設定時先關閉 TUN;確認基本連線正常後,再設定應用程式流量接管範圍,避免混淆節點故障與虛擬網卡問題。
連接埠遭占用或權限不足:依狀況排查
記錄出現 address already in use 或繫結失敗時,先檢查監聽連接埠,不要立即刪除設定。最常見的原因是舊程序仍在系統匣執行,或另一個用戶端占用了相同連接埠。以下命令只會查詢本機 TCP 監聽狀態,不會修改網路設定。
netstat -ano -p tcp | findstr LISTENING | findstr ":10808"
tasklist /FI "PID eq 1234"
第一個命令最後一欄是 PID。第二個命令中的 1234 僅為操作範例,請替換成第一個命令實際回傳的 PID。確認本機位址使用的連接埠確實是 10808,再判斷程序用途;不要只因文字中出現相同數字就結束程序。
- 發現另一個 v2rayN:從其系統匣選單正常結束程式,確認監聽連接埠已釋放後,再啟動目前版本,避免兩個程式爭用系統代理。
- 連接埠供必要程式使用:前往「設定」→「參數設定」,將本機監聽改為未占用的連接埠,例如
10818;先確認該連接埠未被使用,再儲存並重新啟動相關核心。 - 修改後仍無法連線:重新套用系統代理,並同步修改手動指定連接埠的瀏覽器擴充功能、終端工具等。只修改用戶端設定,其他程式仍會連線到舊的連接埠。
- 連接埠未占用卻顯示拒絕存取:檢查系統保留連接埠、安全性原則與端點防護記錄。一般連接埠監聽和 TUN 提權是不同問題,不應一律長期以系統管理員身分執行來規避。
完成設定後的檢查與升級備份
檢查項目應涵蓋啟動、代理和結束程式三個環節。能成功開啟一次網頁,只能證明當下有一筆請求成功;還要確認關閉用戶端後不會留下失效代理,並且重新啟動後能恢復預期設定。依照以下順序檢查,日後遇到問題也更容易找出變動原因。
- 檢查啟動:結束程式後重新開啟,確認訂閱群組、活動節點和本機連接埠仍保留,且記錄中沒有重複出現核心啟動失敗。
- 檢查代理:啟用系統代理後,分別連線至預期直連與預期使用代理的目標,搭配記錄確認路由;不要把單一網頁的快取內容當成連線成功的證明。
- 檢查結束程式:先清除系統代理,再結束程式,確認一般網路仍可使用。若程式意外終止,可在 Windows 代理設定中檢查並移除殘留的手動代理。
- 檢查備份:升級前先結束程式,備份目前版本的使用者設定與訂閱群組資訊;免安裝部署可備份完整資料夾,安裝式部署則依實際使用者資料位置備份。
- 檢查移轉:更換介面版本時,優先使用用戶端提供的匯入與匯出功能;若沒有明確的移轉說明,請重新匯入訂閱並確認重要設定,不要直接混合覆蓋兩個程式的資料夾。
備份檔也可能包含訂閱權杖和節點驗證資訊,請存放在只有本人能存取的位置。升級後若只有介面異常,先保留記錄和原始備份,再查看版本說明;若網頁無法連線,則依序檢查本機監聽、系統代理和節點記錄。更多基本操作請參閱快速入門,較複雜的連線問題可前往故障排除。