v2rayN 桌面版（Avalonia）與 WPF 版差異：介面框架、平台支援與版本選擇

介面框架與代理核心

Avalonia 與 WPF 負責視窗介面，代理核心負責連線。v2rayN 是桌面用戶端，負責管理伺服器清單、訂閱、路由選項與核心程序。WPF 是 Windows 專用介面框架；Avalonia 則是跨平台介面框架，可用於 Windows、macOS 與 Linux。下載頁所稱的「桌面版」與「WPF 版」，主要是用來區分這兩種介面實作。

實際代理連線還會經過用戶端產生設定、啟動核心、建立對外連線等步驟。VMess、VLESS、REALITY 是否可用，必須確認所選核心及其版本、節點參數與伺服器設定，不能只看視窗外觀判斷。改用 Avalonia 不會自動變更訂閱內容，改用 WPF 也不會自動取得特定協定支援。

因此，介面卡頓與網站無法開啟應分開排查。前者可能與圖形繪製、縮放或桌面工作階段有關；後者通常應先確認核心是否啟動、本機連接埠是否正在監聽，以及應用程式流量是否進入代理。

Windows、macOS、Linux 版本選擇

先依作業系統篩選，再依處理器架構篩選，最後才比較介面。框架支援某個平台，不代表每次發布都會提供所有系統與架構的安裝檔；實際可選項目請以用戶端下載頁目前列出的內容為準。

• Windows：前往「設定」→「系統」→「系統資訊」查看系統類型。選擇符合處理器與系統的套件，不要把介面名稱誤認為架構名稱。
• macOS：在「關於這台 Mac」查看晶片或處理器資訊，確認是 Apple 晶片還是 Intel 處理器，再選擇相符的架構。
• Linux：執行 uname -m 查看架構；常見的 x86_64 對應 x64，aarch64 對應 ARM64。也要依發行版選擇合適的套件格式。

外觀、執行相依性與系統整合

兩種介面在清單密度、選單位置、字型觀感與高解析度螢幕縮放上可能有所不同。Avalonia 使用自己的跨平台介面系統；WPF 則與 Windows 桌面環境整合得更緊密。不過字型是否清晰、視窗拖曳是否流暢，也會受到顯示卡驅動程式、系統縮放與具體建置版本影響，不能只看框架名稱下結論。

兩者都採用 .NET 技術，但是否需要另外安裝執行階段，取決於安裝套件的發布方式。自包含發布會附帶所需的執行元件；依賴架構的發布則要求系統已具備相應執行階段。不能一概而論地說某個版本一定不需要安裝相依元件，也不能根據另一台裝置的執行環境推斷本機符合需求。

系統匣行為也值得另外確認。Linux 桌面環境可能需要系統匣擴充功能或相關元件；關閉視窗後是否繼續執行，則應檢查用戶端設定。若遇到「關閉後找不到視窗」，先查看程序、系統匣與關閉行為選項，不要反覆啟動多個執行個體，以免介面問題演變成本機連接埠衝突。

設定移轉與訂閱還原

更換介面版本前，先保存訂閱網址與重要設定，再備份現有使用者資料。訂閱通常可以還原伺服器清單，但不一定包含本機路由、自訂 DNS、快速鍵、監聽連接埠或自訂設定。只保存訂閱網址，不代表已完成所有設定的備份。

不同發布版本的資料結構與儲存位置可能改變，不建議將舊目錄整個覆蓋到新目錄。尤其跨系統移轉時，路徑分隔符號、核心執行檔路徑與權限都可能不同。請優先使用目前版本提供的匯出、匯入或備份功能；若找不到相關功能，至少保留原始資料副本，並記下需要手動重建的項目。

1. 記錄原有狀態：保存訂閱來源、目前使用的節點、路由模式與本機連接埠。如果介面提供「設定」→「參數設定」，請在其中確認監聽與基本選項；實際分類名稱以目前介面為準。
2. 結束舊執行個體：先關閉系統代理或 Tun，再結束用戶端。確認舊核心不再占用監聽連接埠後，才啟動新版本。
3. 還原伺服器清單：在訂閱管理頁面新增原有訂閱網址並更新。訂閱網址可能包含存取憑證，請勿將完整網址放入公開截圖或記錄。
4. 先進行基本測試：選擇一個已知可用的節點，只啟用系統代理，確認網頁瀏覽與記錄正常後，再逐項還原路由、DNS 與 Tun。
5. 保留回復方式：新版本測試完成前不要刪除原有資料。需要回復時，先結束新執行個體，再還原舊環境，避免兩個執行個體同時修改系統代理。

連線檢查與連接埠範例

「桌面版能連線、WPF 版不能連線」不一定是框架造成的差異。常見原因包括兩邊使用不同的目前節點、核心版本、路由模式或監聽連接埠。比較前先統一這些條件、關閉另一個執行個體，再測試相同的目標位址。以下數字僅用於說明測試流程，不代表所有安裝套件的預設值。

假設目前用戶端設定的本機代理連接埠為 10808，請先檢查迴路位址上的監聽狀態。Windows 可在 PowerShell 執行下方命令；此命令只用來確認本機連接埠能否建立 TCP 連線，不會檢查節點、DNS 或遠端網站是否正常。

Test-NetConnection -ComputerName 127.0.0.1 -Port 10808

Linux 可用下方命令查看對應的 TCP 監聽記錄。如果沒有輸出，請先查看核心啟動記錄與實際連接埠設定，不要直接修改訂閱。macOS 可使用 lsof -nP -iTCP:10808 -sTCP:LISTEN 查看監聽程序。

ss -ltnp 'sport = :10808'

• 沒有監聽：檢查核心啟動失敗、設定解析錯誤與連接埠占用；並確認檢查的是目前介面顯示的實際連接埠。
• 監聽正常，但瀏覽器無法瀏覽：確認系統代理指向正確的位址與連接埠，並檢查瀏覽器是否使用獨立的代理設定。
• 只有部分應用程式未走代理：該應用程式可能不遵循系統代理設定。先檢查應用程式設定，再決定是否使用 Tun。
• 只有部分網站異常：檢查 DNS、規則是否生效與節點對外連線記錄。不要把特定流量分流問題歸因於 Avalonia 或 WPF。

一般節點的延遲測試也不能取代完整的應用程式測試。比較下載速度時，應使用相同節點、目標、時段與路由設定。若未控制這些條件，就無法將速度差異歸因於介面框架；本文不提供缺乏實測依據的效能排名。

常見問題