本文適合正在下載 v2rayN、準備從 WPF 版移轉，或需要在 Windows、macOS、Linux 之間維持一致操作方式的使用者。閱讀後即可判斷兩個版本適合的環境，並依步驟移轉訂閱、路由、連接埠與系統代理設定。
Avalonia 桌面版與 WPF 版分別是什麼
v2rayN 的兩條桌面介面路線並不是兩個完全無關的用戶端。兩者都能管理伺服器設定、訂閱群組、路由規則、代理核心與系統代理狀態，主要差異來自圖形介面技術與作業系統適配方式。下載頁中的「桌面版」通常指採用 Avalonia 建置的跨平台介面；「WPF 版」則指採用 Windows Presentation Foundation 建置的傳統 Windows 介面。
Avalonia 讓同一套主要介面邏輯能在 Windows、macOS、Linux 上執行，因此更適合需要跨系統使用相近操作流程的使用者。WPF 依賴 Windows 桌面技術，只支援 Windows，但與 Windows 通知區域、視窗行為及系統代理操作的整合更直接，長期使用舊版 v2rayN 的使用者也更熟悉其選單位置。
這兩個數字需要搭配設定理解。10808 是不少 v2rayN 設定使用的本機代理連接埠，但升級或匯入備份後可能保留其他數值；127.0.0.1 表示只接受本機連線。實際連接埠應在「設定」→「參數設定」中核對，不要只根據教學範例修改瀏覽器或其他軟體。
| 比較項目 | Avalonia 桌面版 | WPF 版 |
|---|---|---|
| 執行平台 | Windows、macOS、Linux | Windows |
| 介面技術 | Avalonia 跨平台介面 | Windows WPF 介面 |
| 適合的新安裝情境 | 跨平台使用、統一操作習慣 | 只使用 Windows、延續舊版習慣 |
| 系統整合 | 依不同系統分別適配 | 以 Windows 桌面環境為核心實作 |
介面與操作流程有哪些實際差異
兩個版本的核心物件基本一致：主視窗顯示伺服器清單與延遲資訊，訂閱管理儲存遠端訂閱位址，路由設定決定網域或位址的連線走向，系統代理選單控制其他應用程式是否將流量交給 v2rayN。差異主要體現在按鈕排列、右鍵選單、彈出視窗配置與托盤選單層級，而非基礎概念有所改變。
WPF 版更接近長期沿用的 Windows 桌面軟體配置，伺服器清單通常是操作中心，許多指令可透過清單右鍵選單或頂端選單完成。Avalonia 桌面版需要同時配合不同系統的視窗規範，因此控制項間距、對話方塊樣式、快速鍵回應與通知區域表現可能和 WPF 版不同。參考舊截圖操作時，應依指令名稱尋找入口，不要只對照按鈕所在位置。
Avalonia 桌面版
推薦涵蓋三種桌面系統，主要功能採用相近的資訊結構，日後更換系統時學習成本較低。
適合：新安裝、跨平台辦公、希望統一介面邏輯
WPF 版
保留傳統 Windows 操作方式，對舊設定流程、通知區域選單與既有使用習慣更友善。
適合：固定使用 Windows、延續舊版、優先降低移轉成本
常用工作應該尋找哪些指令
- 新增訂閱：尋找「訂閱群組設定」或同義的訂閱管理入口，儲存位址後再執行更新訂閱，不要將訂閱位址直接當成單一伺服器匯入。
- 修改本機連接埠：進入「設定」→「參數設定」，核對本機監聽連接埠及區域網路存取選項。選單末端名稱可能隨版本調整，但參數設定仍是主要入口。
- 切換路由：從路由設定或托盤選單選擇現有規則。全域、直連與規則分流的處理範圍不同，切換版本不會自動改變規則含義。
- 啟用系統代理：先選擇可用伺服器並啟動核心，再設定系統代理模式。只啟動主程式不代表系統流量已經進入代理。
- 查看故障資訊：開啟日誌區域，先檢查核心是否啟動，再查看連接埠占用、設定解析與連線握手資訊。
結論：對照指令名稱，不要機械照搬舊截圖
Avalonia 與 WPF 的選單位置可能不同，但「訂閱、參數設定、路由、系統代理、日誌」五類工作保持穩定。移轉時依工作名稱尋找，比按照截圖座標操作更可靠。
核心功能是否完全一致
介面框架不負責定義 VMess、VLESS、路由分流或 TLS 等協定能力。真正建立連線的是用戶端呼叫的代理核心，v2rayN 則負責產生設定、啟動核心並顯示狀態。因此，判斷某個節點能否使用時，需要同時檢查 v2rayN 版本、所選核心、伺服器參數與執行平台，不能只看介面屬於 Avalonia 還是 WPF。
訂閱匯入、手動新增伺服器、測試延遲、切換使用中的設定、查看日誌與設定系統代理，是兩條路線都應涵蓋的基礎功能。不過，新功能可能先在其中一條路線完成介面適配，複雜設定的控制項名稱也可能暫時不同。尤其是需要管理員權限、虛擬網路介面或系統層級啟動項目的功能，會受到作業系統權限模型影響，不能用 Windows 上的結果直接推論 macOS 或 Linux。
| 功能 | 兩個版本的關係 | 核對重點 |
|---|---|---|
| VMess 與 VLESS 設定 | 均由所選核心處理 | 位址、連接埠、傳輸層、TLS 與 SNI 參數 |
| 訂閱更新 | 均可管理訂閱群組 | 訂閱位址、更新方式、群組篩選結果 |
| 路由分流 | 均可產生路由設定 | 規則順序、比對範圍、最終出站 |
| 系統代理 | 目標相同，實作取決於系統 | 代理模式、本機連接埠、系統權限 |
| 開機啟動與通知區域 | 操作方式因平台而異 | 系統授權、桌面環境、背景執行狀態 |
連接埠與區域網路存取需要另外確認
- 開啟「設定」→「參數設定」，記錄目前的本機代理連接埠。常見設定使用 10808，但舊備份也可能保留 10809 或自訂連接埠。
- 檢查監聽位址。127.0.0.1 僅供本機使用；若要讓區域網路裝置連線，還需要明確啟用允許區域網路存取，並設定作業系統防火牆。
- 檢查瀏覽器、下載工具或開發工具中固定寫入的代理連接埠。用戶端連接埠變更後，這些獨立設定不會自動同步。
- 啟動核心後查看日誌，確認沒有「連接埠已被占用」等錯誤，再切換系統代理並存取目標網站進行測試。
結論：介面相同不代表系統行為完全一致
訂閱與路由可以移轉，但系統代理、背景執行、權限請求與防火牆規則需要在每台裝置上重新確認。跨平台移轉時，應將「設定資料」與「系統整合」分成兩組處理。
Windows、macOS、Linux 該如何選擇
Windows 使用者有兩種選擇。如果是第一次安裝，希望之後的介面路線與其他桌面系統保持一致，建議優先嘗試 Avalonia 桌面版。如果已長期使用 WPF 版，現有訂閱、路由與托盤操作都穩定，也沒有跨平台需求，繼續使用 WPF 版可以減少重新熟悉選單與視窗行為的成本。
macOS 與 Linux 使用者應選擇 Avalonia 桌面版，因為 WPF 版依賴 Windows 桌面執行環境。下載時也要配合處理器架構，並閱讀對應平台的啟動與授權說明。Linux 的通知區域、開機啟動與系統代理表現可能受桌面環境影響；macOS 首次執行時則需要完成系統要求的應用程式授權。
- Windows 新使用者：先選擇 Avalonia 桌面版，匯入訂閱後完成延遲測試、系統代理與路由驗證；若特定 Windows 工作流程不相容，再比較 WPF 版。
- Windows 舊使用者：穩定優先時保留 WPF 版；準備移轉前先匯出設定，並記錄參數設定中的本機連接埠。
- macOS 使用者：選擇 Avalonia 桌面版，依裝置處理器架構下載，並在首次啟動後檢查系統代理是否確實寫入。
- Linux 使用者：選擇 Avalonia 桌面版，除了用戶端設定外，還要檢查桌面環境的通知區域支援、檔案執行權限與代理設定入口。
依需求做最後判斷
| 使用需求 | 建議版本 | 理由 |
|---|---|---|
| 三種桌面系統採用相近流程 | Avalonia 桌面版 | 介面邏輯跨平台，切換裝置時更容易找到功能 |
| 在 Windows 延續舊操作習慣 | WPF 版 | 傳統選單、視窗與通知區域流程更熟悉 |
| 第一次安裝 v2rayN | 優先選擇 Avalonia 桌面版 | 直接採用跨平台路線，減少日後重新適應 |
| 已有複雜的 Windows 設定 | 先保留 WPF 版並行測試 | 確認訂閱、路由、連接埠與系統代理後再移轉 |
從 WPF 版移轉到 Avalonia 桌面版的檢查步驟
移轉的重點不是重新新增每一台伺服器，而是保留設定資料，並避免兩個程式同時修改系統代理。開始前先關閉自動啟動與系統代理，記錄目前使用中的伺服器、訂閱群組、路由方案、本機連接埠與核心選擇。複雜的自訂規則應另外保存，方便移轉後逐項核對。
如果兩個版本需要短期並行測試，不要讓它們同時使用 10808 等相同的監聽連接埠。連接埠衝突會導致後啟動的核心失敗，但介面仍可能停留在已選取伺服器的狀態。測試時一次只啟動一個版本，或將測試版本設為不同連接埠，並確認瀏覽器目前連線的是哪個連接埠。
- 停止舊版連線：在 WPF 版中關閉系統代理並退出核心，確認通知區域沒有殘留的執行個體。
- 整理設定：匯出可用設定，記錄訂閱群組名稱、路由規則、本機連接埠與區域網路存取狀態。
- 安裝相符版本：依 Windows、macOS 或 Linux 以及處理器架構選擇 Avalonia 桌面版。
- 還原訂閱與伺服器：先匯入設定，再更新訂閱，檢查伺服器數量與群組是否符合預期。
- 還原參數：進入「設定」→「參數設定」，核對 127.0.0.1、10808 等監聽參數，不要假設匯入過程會覆蓋所有程式設定。
- 驗證路由：選擇原本使用的路由方案，分別測試直連位址與需要代理的位址，確認規則走向正確。
- 最後啟用系統代理：確認核心日誌正常、連接埠沒有衝突後，再開啟系統代理並驗證常用應用程式。
常見選擇與移轉問題
以下幾類問題通常不是協定本身故障，而是版本選錯、連接埠衝突或系統代理狀態未同步。依現象檢查，比反覆刪除訂閱更容易找出原因。
Windows 上一定要改用 Avalonia 桌面版嗎？
不需要強制移轉。WPF 版執行穩定且符合現有需求時，可以繼續使用；需要跨平台一致性或準備採用新介面路線時，再依移轉清單測試 Avalonia 桌面版。
兩個版本可以同時安裝嗎？
可以保留兩套程式進行比較，但不要同時啟動核心或同時接管系統代理。分別檢查「設定」→「參數設定」中的連接埠，避免兩個執行個體都監聽 10808。
匯入訂閱後伺服器清單空白怎麼辦？
先確認訂閱位址完整，再執行更新訂閱並查看日誌。若使用群組篩選，清除關鍵字過濾後重新檢查；仍為空白時，再確認訂閱回傳格式是否能被目前版本識別。
移轉後顯示已連線，但網頁打不開？
先檢查核心日誌與系統代理狀態，再核對本機連接埠。若瀏覽器固定使用 127.0.0.1:10808，而新版本改用其他連接埠，就會出現介面顯示已連線但應用程式無法存取的情況。
Avalonia 版與 WPF 版的節點速度會不同嗎？
介面框架通常不是影響速度的主要因素。應使用相同伺服器、相同核心、相同協定參數與相同路由規則進行比較，並優先檢查網路品質、伺服器負載與傳輸設定。
簡單來說，macOS 與 Linux 直接選擇 Avalonia 桌面版；Windows 新使用者建議從 Avalonia 桌面版開始，長期使用舊介面且工作流程穩定的 Windows 使用者則可以繼續使用 WPF 版。無論選擇哪條路線，都應以訂閱更新、核心啟動、路由結果、本機連接埠與系統代理五項實際驗證為準。