v2rayN 桌面版與 WPF 版有什麼不同：Avalonia 跨平台版選擇指南

Avalonia 桌面版與 WPF 版的核心差異

兩種版本首先是使用者介面技術不同，而不是代理協定不同。Avalonia 是跨平台介面框架，同一套 v2rayN 桌面介面可針對 Windows、macOS 與 Linux 建置；WPF 是 Windows 桌面介面技術，因此 WPF 版僅適用於 Windows。兩者都負責訂閱管理、節點選擇、路由設定、系統代理控制與核心程序管理，實際連線能力主要取決於隨套件提供或由使用者設定的 Xray 核心，而不是視窗採用哪種框架繪製。

在同一份有效設定下，VMess、VLESS、Trojan、Shadowsocks、REALITY 與常見傳輸方式不會因為換成 Avalonia 或 WPF 介面而自動改變。節點位址、連接埠、使用者識別碼、傳輸層、安全參數與路由規則一致時，傳給核心的設定目標也應一致。因此，不能直接把「某個節點在 WPF 版可用、在 Avalonia 版不可用」歸因於介面框架，還需要檢查核心版本、設定遷移、權限、DNS 與系統代理狀態。

「桌面版」這個名稱也容易與「依賴執行環境的安裝套件」混淆。下載時應同時查看平台、架構、介面類型及是否包含執行環境，不能只看檔名是否出現 desktop。以 Windows x64 為例，框架相依套件通常體積較小，但系統必須已具備頁面說明要求的 .NET 執行環境；自包含套件會附帶所需的執行元件，體積較大，適合不想另外處理執行環境的情境。

如何比較系統支援、介面與系統匣行為

作業系統是最明確的篩選條件。macOS 與 Linux 直接選擇 Avalonia 桌面版，因為 WPF 無法在這兩個平台執行。Windows 則有更多選擇：希望介面與其他平台接近，可以使用 Avalonia；更依賴 Windows 通知區域、視窗最小化、開機啟動與原生檔案對話方塊，則優先考慮 WPF 版。

Avalonia 的優勢是跨平台結構統一，但「統一」不代表三個系統的桌面行為完全相同。macOS 的狀態列、Linux 不同桌面環境的系統匣協定，以及 Windows 通知區域各有實作差異。關閉主視窗後，程式究竟退出還是留在系統匣，也會受到 v2rayN 參數選項和桌面環境支援情況影響。第一次啟動後，應主動測試關閉視窗、雙擊系統匣圖示、右鍵系統匣選單及退出程式四個動作。

高解析度縮放也值得單獨檢查。在 125%、150% 或多螢幕不同縮放比例下，觀察節點清單欄寬、QR Code 視窗、記錄視窗及選單彈出位置。如果出現文字截斷，先確認系統縮放設定和 v2rayN 目前版本，再嘗試重新啟動客戶端；不要透過修改節點設定來解決純介面問題。

Linux 使用者還要確認所用桌面環境是否提供系統匣支援。系統匣圖示消失不代表核心未執行，可以回到主視窗查看連線狀態與記錄，也可以檢查本機監聽連接埠。macOS 使用者則應在首次執行時處理系統提示的網路存取權限，切換系統代理後再透過瀏覽器實際瀏覽確認。

系統代理、路由規則與核心執行是否有差異

v2rayN 的「系統代理」和「核心執行」屬於兩個層次。核心啟動後，會在本機位址上監聽 SOCKS、HTTP 或混合代理連接埠；系統代理功能則會將 Windows、macOS 或 Linux 桌面環境中的代理設定指向該連接埠。核心正常執行但系統代理未寫入時，手動設定代理的應用程式可能可以連線，一般瀏覽器卻仍會直接連線。

WPF 版在 Windows 上呼叫系統代理介面，常見操作入口位於主介面或系統匣選單中的「系統代理」。Avalonia 版也提供對應功能，但具體選單位置和狀態圖示可能因版本、平台而異。切換後不要只看選單勾選狀態，還應核對系統代理位址是否指向 127.0.0.1，以及連接埠是否與「設定」→「參數設定」中的本機連接埠一致。

1. 在伺服器清單中選擇一個已知可用的節點，並將其設為作用中伺服器。
2. 開啟「設定」→「參數設定」，記錄本機 SOCKS、HTTP 或混合代理連接埠。
3. 啟動核心，查看記錄中是否出現監聽成功訊息，確認沒有連接埠占用或設定解析錯誤。
4. 從主介面或系統匣選單開啟系統代理，依需求選擇自動設定或全域代理模式。
5. 開啟瀏覽器進行實際瀏覽，再切換一次直連模式，確認流量路徑確實會隨設定變更。

路由規則同樣由產生後的核心設定執行。網域規則、IP 規則、geosite、geoip、直連出口、代理出口與阻擋出口的邏輯，不會因介面是 Avalonia 還是 WPF 而改變。不過，兩套介面在路由編輯器的表格版面、按鈕位置和預設欄寬上可能不同，遷移後應檢查規則順序，因為前置規則可能先符合並改變最終出口。

如果只想讓特定應用程式使用代理，可以維持系統代理關閉，直接在應用程式內填入 127.0.0.1 與本機連接埠。此時要分清代理類型：應用程式填寫 SOCKS5 時，應對應 SOCKS 監聽連接埠；填寫 HTTP 時，應對應 HTTP 或相容的混合連接埠。將 10808 和 10809 對調，是遷移後「核心已啟動但應用程式無法連線」的常見原因之一。

Windows 檢查 10808 連接埠：
netstat -ano | findstr :10808

macOS 或 Linux 檢查 10808 連接埠：
lsof -nP -iTCP:10808 -sTCP:LISTEN

依作業系統與使用習慣選擇版本

對於只使用 Windows 的使用者，WPF 版通常是更直接的起點，尤其適合習慣通知區域、最小化至系統匣、隨系統啟動和 Windows 原生視窗行為的人。如果現有 WPF 版設定穩定，也沒有跨平台遷移需求，不必只因 Avalonia 是跨平台框架就立即更換。

Windows 使用者選擇 Avalonia 的合理情境，是需要與 macOS 或 Linux 裝置維持相似介面，或希望提前熟悉跨平台版的選單結構。切換前應備份訂閱位址、路由規則與必要的自訂設定，不建議將舊程式目錄整個覆蓋到新目錄，因為介面版本、執行環境結構與設定檔組織方式可能隨發行版本調整。

macOS 與 Linux 使用者不需要在兩者之間反覆比較，選擇 Avalonia 對應平台與處理器架構的建置版本即可。下載前先查看裝置架構，避免在不相容的處理器環境使用 x64 建置。Linux 還應確認發行套件形式所需的執行權限與桌面相依項目；macOS 則要完成首次啟動所需的系統安全允許與網路權限確認。

辦公環境與個人環境也可能得出不同結論。辦公裝置如果對寫入系統代理、開機啟動或背景程式有統一限制，應先遵循裝置管理規則，並使用應用程式層級代理進行測試。個人裝置則可以依使用頻率決定是否啟用開機啟動，但無論哪種環境，都不建議同時執行兩個 v2rayN 執行個體並爭用同一個監聽連接埠。

• 只使用 Windows：先選擇 WPF 版，除非明確需要跨平台一致的介面。
• 同時使用 Windows 與其他桌面平台：可統一選擇 Avalonia，降低切換選單結構的成本。
• 重視系統匣穩定性：Windows 優先測試 WPF；Linux 先確認桌面環境支援系統匣協定。
• 已有穩定設定：保留目前可用版本，透過匯出設定進行遷移測試，不要直接覆蓋原目錄。
• 執行環境安裝受限：查看下載頁說明，選擇與目前系統及執行環境相符的建置版本。

從一個版本遷移到另一個版本的步驟

遷移的目標是保留必要設定，同時避免將舊介面的快取、視窗狀態與不相容設定直接帶入新版本。開始前先退出 v2rayN，並確認工作管理員或系統程序清單中沒有殘留的 v2rayN 與 Xray 程序。程式仍在執行時複製設定，可能會得到寫入不完整的檔案。

訂閱使用者應優先記錄訂閱群組名稱、訂閱位址、更新方式與自訂備註。手動節點則應透過客戶端提供的匯出功能保存分享連結或設定。路由方面，需要記錄目前啟用的規則集、規則順序、預設出口與 DNS 設定；這些內容比視窗大小、主題或清單欄寬更值得遷移。

1. 在舊版本中更新一次訂閱，刪除確認不再使用的重複節點。
2. 匯出必要的伺服器設定，並另外記錄訂閱位址與群組設定。
3. 開啟「設定」→「參數設定」，記錄本機連接埠、記錄層級、系統代理模式與開機啟動狀態。
4. 完全退出舊版本，將新版本解壓縮或安裝到新的獨立目錄。
5. 首次啟動新版本後先不要開啟系統代理，匯入訂閱與節點並檢查欄位。
6. 選擇一個節點啟動核心，確認記錄正常後，再開啟系統代理進行瀏覽器測試。
7. 核對路由與 DNS，測試完成後再決定是否保留舊目錄。

如果舊版使用 10808，而新版首次啟動產生了不同連接埠，依賴舊連接埠的瀏覽器擴充功能、開發工具或命令列環境不會自動跟著變更。可以將新版連接埠改回原值，也可以逐一更新呼叫端設定，但必須避免兩個程式同時監聽 127.0.0.1:10808。

遷移後出現節點清單正常、連線卻失敗時，先比較核心記錄，不要先刪除所有訂閱。重點檢查伺服器位址解析、系統時間、傳輸參數、REALITY 相關欄位、TLS 伺服器名稱與本機連接埠占用。如果所有節點同時失敗，更可能是核心、權限、DNS 或系統代理問題；只有單一節點失敗時，才優先檢查該節點參數。

下載前與啟動後的核對清單

下載前只需確認四件事：作業系統、處理器架構、介面類型、執行環境形式。Windows x64 使用者可以在 Avalonia 與 WPF 之間選擇；macOS 和 Linux 選擇 Avalonia 對應建置版本。框架相依與自包含建置的主要差異，在於執行元件是否隨程式提供，不應將它們誤認為兩種不同的協定能力。

啟動後則依「設定、核心、連接埠、系統代理、路由」的順序驗證。這個順序可以將介面問題與網路問題分開：視窗能開啟只代表介面程序啟動，記錄顯示核心監聽成功才代表本機代理入口建立，瀏覽器流量依預期切換才表示系統代理設定完整生效。

• 確認下載的是 Windows、macOS 或 Linux 對應建置版本，處理器架構也要與裝置一致。
• Windows 使用者明確選擇 Avalonia 或 WPF，不要依壓縮檔大小判斷功能多寡。
• 框架相依建置須先符合頁面標示的 .NET 執行環境需求。
• 首次啟動後進入「設定」→「參數設定」，記錄實際本機監聽連接埠。
• 啟動一個有效節點，檢查核心記錄中是否有設定解析與連接埠占用錯誤。
• 開啟系統代理後進行實際瀏覽測試，再切回直連確認狀態切換有效。
• 匯入自訂路由後核對規則順序、預設出口與 DNS，不要只檢查節點清單。
• 確認關閉視窗後的行為符合預期，並找到系統匣選單中的退出入口。

如果仍無法確定，可以先保留現有穩定版本，將另一個版本放入獨立目錄進行短時間測試。使用同一份訂閱、同一個節點與相同的路由條件，分別驗證啟動速度、系統匣行為、系統代理切換與休眠恢復。完成這些實際操作後，選擇結果通常比單看介面截圖更可靠。