Windows 使用者先依系統架構選擇套件,再決定使用 WPF 或 Desktop 介面。本文從首次解壓開始,說明如何處理執行階段提示、更新訂閱、搭配系統代理與路由,以及登入啟動後確認連線。建議先用一般系統代理完成驗證,再視需求啟用 TUN,避免同時變更多項設定而增加排查難度。
WPF 與 Desktop:先分辨介面,再看發行套件
WPF 是 Windows 專用的介面技術;v2rayN 的 Desktop 版本採用跨平台桌面介面技術。兩者主要差異在介面實作、操作細節與執行環境,並非使用不同的節點協定。伺服器能否使用,還取決於訂閱參數、實際使用的代理核心與網路狀況,不能只看視窗外觀判斷。
WPF:適合日常 Windows 使用
建議若只在 Windows 上使用,且沒有特定的跨平台介面需求,可先選擇 WPF。啟動時若提示缺少 .NET 桌面執行階段,請依該版本的要求安裝,不必修改節點參數。
適合:以 Windows 為主力電腦,並習慣 WPF 操作方式的使用者。
Desktop:跨平台介面體驗
若希望在不同桌面系統上使用相近的介面,可選擇 Desktop。Windows 使用者仍須下載符合 Windows 系統架構的套件;Desktop 名稱不代表套件一定內含執行階段,也不表示代理速度較快。
適合:重視跨平台介面一致性,或想比較兩種介面操作方式的使用者。
發行方式也要另外確認。可攜式壓縮檔須完整解壓後才能執行;安裝程式則依照精靈指示選擇安裝位置。是否包含核心或執行環境,應以下載頁說明和套件內容為準,不能只根據 WPF 或 Desktop 名稱推斷。可以分別測試兩種介面,但不要同時啟動,以免爭用同一個本機監聽連接埠。
下載前確認系統架構與執行階段
在 Windows「設定」→「系統」→「系統資訊」查看「系統類型」。一般 Intel、AMD 電腦通常使用 x64 套件;Windows on Arm 裝置則優先選擇發行方提供的 ARM64 套件。不能只看處理器品牌判斷架構,檔名標示的架構也必須與執行階段架構相符。
WPF 啟動檢查
- 介面技術
- Windows Presentation Foundation
- 架構選擇
- 依系統類型選擇 x64 或 ARM64
- 相依項目
- 使用架構相依部署的套件通常需要 .NET Desktop Runtime
- 相依版本
- 依啟動提示及發行說明指定的主要版本安裝
只安裝 .NET SDK 或其他主要版本的執行階段,不代表已符合目前程式所需的桌面執行環境。
Desktop 啟動檢查
- 介面技術
- Avalonia 桌面介面
- 架構選擇
- 下載符合 Windows 系統架構的發行套件
- 相依項目
- 視套件是否採用自包含部署而定
- 缺少執行環境
- 依啟動提示安裝指定的 .NET 執行環境
自包含套件通常不需要另外安裝相應的 .NET 執行階段,但仍受系統版本與其他原生相依項目限制。
若出現「必須安裝或更新 .NET 才能執行此應用程式」的提示,先記下提示中的架構名稱、主要版本與系統架構。WPF 所需的 Windows Desktop 執行環境與基本 .NET Runtime 並不相同。不要連續安裝多個不相關的執行階段,也不要從不明來源下載單一 DLL 放進程式資料夾,這些做法可能掩蓋真正的相依性問題。
- 提示缺少架構:確認架構名稱與主要版本,安裝後重新啟動用戶端。
- 提示無法在此電腦執行:先確認系統支援範圍、架構,以及下載的檔案是否已完整解壓。
- 主視窗正常,但節點啟動失敗:改查代理核心檔案與執行記錄,不要繼續重裝介面執行階段。
解壓執行與匯入訂閱:依序完成
以下以 Windows 可攜式壓縮檔為例。不同發行版本的選單文字可能略有差異,請以實際介面為準;操作順序相同:選定固定資料夾、啟動用戶端、儲存訂閱、更新清單,再選取伺服器。不要直接在壓縮軟體的預覽視窗中執行主程式,否則可能無法正確定位設定檔與核心檔案。
-
選擇發行套件
前往用戶端下載頁,依 Windows、處理器架構與介面類型選擇下載項目。先看清楚發行套件說明,再決定使用可攜式套件或安裝程式。
-
完整解壓縮
將所有檔案解壓縮至目前帳戶可寫入的固定資料夾,例如
D:\Tools\v2rayN。不要只複製v2rayN.exe,也不要將長期使用的設定留在暫存解壓縮資料夾。 -
啟動主程式
執行
v2rayN.exe。使用一般系統代理通常不需要系統管理員權限;若出現執行階段提示,先依上一節處理,再繼續設定。 -
儲存訂閱
在主介面選擇「訂閱分組」→「訂閱分組設定」,新增分組、填寫備註與訂閱網址後儲存。訂閱網址屬於存取憑證,請勿放進公開截圖。
-
更新清單
在「訂閱分組」中選擇「更新全部訂閱(不透過代理)」。首次使用且尚無可用代理時,先透過目前的網路取得訂閱;若訂閱來源另有存取條件,請依提供方說明處理。
-
設為使用中的伺服器
選取匯入的伺服器,在右鍵選單中選擇「設為活動伺服器」以啟用。接著查看記錄,確認對應的核心已成功啟動,最後再設定系統代理,避免把匯入成功誤當成連線成功。
儲存訂閱網址與下載訂閱內容是兩個步驟。清單空白時,先確認是否執行更新、記錄是否顯示請求失敗,以及目前選取的分組是否正確。若訂閱回傳登入頁面、到期提示或錯誤文字,重複按更新也不會取得有效節點,應先處理訂閱來源的問題。
系統代理、路由與 TUN:首次設定只啟用一種入口
v2rayN 啟動核心後,會在本機提供代理監聽入口。Windows 系統代理只是將入口位址寫入系統設定,只有會讀取系統代理設定的程式才會使用。路由則是在流量進入核心後,決定連線要直連、代理或封鎖。這兩個層次不可混為一談。
首次驗證:優先使用系統代理,按需求啟用 TUN
一般系統代理
- 在系統匣圖示上按右鍵,選擇「系統代理」→「自動設定系統代理」。
- 先用會讀取系統代理設定的瀏覽器測試網頁連線。
- 在主介面的路由選擇區確認目前的規則模式。
- 結束用戶端前,先清除系統代理,避免系統繼續指向已停止的連接埠。
TUN 接管流量
- 適用於不讀取系統代理,但需要透過虛擬網卡處理流量的程式。
- 可能需要系統管理員權限,並會影響網卡、路由與 DNS 設定。
- 依使用的核心與用戶端提示進行設定,不要照抄來路不明的參數。
- 首次排查時先關閉 TUN,建立一般代理可正常使用的基準。
系統代理與 TUN 並非絕對不能同時啟用;首次測試先簡化流量入口,更容易分辨問題出在節點或流量接管。
檢查本機連接埠時,請在「設定」→「參數設定」中尋找監聽連接埠相關項目;新舊版本的欄位與預設值可能不同。以下以本機 HTTP 相容入口 127.0.0.1:10808 為例,數字僅供說明。若實際監聽連接埠不同,命令中的數值也必須一併修改;若該連接埠只接受 SOCKS,則不能直接套用 HTTP 代理命令。
curl.exe --proxy http://127.0.0.1:10808 --head --connect-timeout 10 https://example.com/
此命令適用於系統已提供 curl.exe,且範例連接埠支援 HTTP 代理的情況。收到 HTTP 回應,表示該次請求已取得回應,但不代表所有網站都能存取,也不是效能測試。若提示無法連線至本機連接埠,先檢查用戶端是否正在監聽;若連上本機代理後才逾時,再檢查使用中的伺服器、路由、DNS 與遠端連線。
開機啟動:確認登入後啟動與代理恢復
桌面用戶端所說的「開機啟動」,通常是使用者登入 Windows 後啟動介面程式,不代表尚未登入系統就會建立代理。請先手動執行並確認正常,再設定自動啟動;否則每次登入只會重複遇到相同錯誤。
- 開啟「設定」→「參數設定」,尋找「開機自動啟動」相關選項並儲存。實際所在分頁依目前版本介面而定。
- 在 Windows「設定」→「應用程式」→「啟動」中,確認相關啟動項目未遭停用;依不同的登錄方式,也可能需要到工作排程器查看。
- 請勿變更程式資料夾的位置。移動資料夾後,舊的啟動項目可能仍指向原本的執行檔,必須重新設定。
- 登出後重新登入,確認系統匣圖示、使用中的伺服器與監聽連接埠,不要只看工作管理員中是否有程序。
- 需要使用 TUN 時,再確認權限要求與啟動方式。一般的登入後啟動不保證能自動取得系統管理員權限。
用戶端啟動與系統代理恢復也要分開驗證。若瀏覽器仍可直連,可能只是系統代理尚未啟用;若所有會讀取系統代理的程式都無法連線,可能是 Windows 保留了代理位址,但用戶端核心尚未開始監聽。開啟 Windows「設定」→「網路和網際網路」→「Proxy」,確認「手動設定 Proxy」中的位址與連接埠,不要只憑系統匣圖示判斷。
常見問題與切換介面的排查順序
切換 WPF 與 Desktop 適合用來排查介面相容性問題,不應當成所有連線故障的通用解法。若視窗能開啟但節點逾時,優先查看記錄;若程式完全無法啟動,才先檢查架構、執行階段與檔案權限。依故障發生階段逐步檢查,比反覆覆寫檔案更有效。
| 現象 | 優先檢查項目 | 處理方式 |
|---|---|---|
| 雙擊後提示缺少架構 | 執行環境類型、主要版本與系統架構 | 依提示安裝相符的執行環境,不要修改訂閱參數。 |
| 視窗正常,但核心啟動失敗 | 記錄中的檔案路徑、設定錯誤與連接埠占用情況 | 確認檔案已完整解壓,並且只執行一個測試執行個體。 |
| 更新後仍沒有伺服器 | 訂閱回應與分組篩選條件 | 查看更新記錄,確認網址有效且選取了正確分組。 |
| 瀏覽器可用,其他程式無法連線 | 程式是否會讀取系統代理設定 | 依應用程式說明設定代理,有需要時再評估 TUN。 |
| 結束用戶端後網頁無法開啟 | Windows 是否仍保留手動代理設定 | 清除失效的本機代理,確認直連是否恢復。 |
| 自動啟動後找不到設定 | 啟動路徑、執行帳戶與資料目錄 | 確認實際使用的資料位置,避免啟動到另一份程式。 |
升級或切換前,先保留可還原的備份
升級前先結束用戶端,備份實際使用的資料目錄與目前可用的設定。可攜式套件的資料通常會保存在程式目錄中,但不能據此認定所有發行形式都使用相同位置;請以目前用戶端的資料目錄功能、設定或發行說明為準。備份可能包含訂閱網址與伺服器憑證,請妥善保管。
- 將新發行套件解壓縮至獨立資料夾,避免直接覆寫正在執行的程式與核心。
- 優先使用用戶端提供的匯出、匯入功能進行移轉;若要手動移轉,先確認兩端的資料格式相容。
- 只啟動新的程式副本,確認訂閱、使用中的伺服器、路由與系統代理正常後,再重新設定啟動項目。
- 新版本寫入的資料不保證能由舊版本讀取。若要回復舊版,請還原升級前的備份,不要讓舊程式直接讀取已移轉的資料。
選擇並不複雜:只在 Windows 上使用,可先試試 WPF;需要跨平台介面體驗,則可試試 Desktop。不論選哪一種,都先完成架構比對、完整解壓、執行環境檢查,以及一般系統代理測試,再設定登入啟動、調整規則或啟用 TUN。更多基礎設定請參考入門指南;連線異常則可依使用手冊逐步排查。