v2rayN Desktop 與 WPF 版差異：Avalonia 跨平台版本怎麼選

Desktop 與 WPF：先分清介面和核心

兩者最主要的差異在介面框架與支援的平台。Desktop 使用 Avalonia 打造跨平台介面，支援 Windows、macOS 和 Linux；WPF 則是 Windows 桌面介面框架，因此 WPF 版應在 Windows 環境中使用。檔名中的 Desktop 不代表「伺服器版」，也不代表安裝後會自動接管所有網路流量。

v2rayN 負責管理訂閱、伺服器、路由和核心執行；實際處理連線的是所選核心。VMess、VLESS 是協定名稱，Xray 與 V2Fly 是不同的核心專案，而 Avalonia 和 WPF 則是介面技術。不能因為改用 Desktop 介面，就認定某個節點一定更快，或原本不支援的協定參數會因此變得可用。

依平台選擇：Windows 可擇一，其他桌面系統選 Desktop

初次安裝可以先試用 Desktop；已經穩定使用的 Windows 用戶，不必只因介面名稱不同就移轉。選擇時應考量目前使用的系統、實際需要的功能和既有操作習慣，而不是認為跨平台就代表功能完全一致。不同發行版本的選單位置、系統匣操作和系統代理實作可能有所不同，請以安裝後的介面和版本說明為準。

• Windows：前往「設定」→「系統」→「關於」查看系統類型；下載頁的 x64 安裝套件適用於 x64 系統，不要只憑電腦品牌判斷處理器架構。
• macOS：從 Apple 選單開啟「關於這台 Mac」；Apple 晶片選 ARM64，Intel 處理器選 x64。初次安裝時不建議預設採用跨架構轉譯。
• Linux：使用 uname -m 查看架構；x86_64 對應 x64，aarch64 對應 ARM64。Debian、Ubuntu 等系統通常選 DEB；Fedora 等使用 RPM 的系統則選 RPM。

執行需求：介面能啟動，不代表代理已準備就緒

執行需求取決於實際發行的套件，不能簡單認定「Desktop 不需要 .NET，WPF 一定得另外安裝 .NET」。兩種介面都可能採用自包含發行方式，將所需的受控執行階段一併打包；依賴架構的套件則需要系統已安裝相符的執行階段。使用 WPF 時，特別要確認 .NET Desktop Runtime，而不只是一般的 .NET Runtime。

1. 先確認安裝套件：核對作業系統、處理器架構和套件的版本說明。如果啟動時提示缺少執行階段，請依提示確認執行階段類型和主版本，不要隨意安裝其他版本後一再重試。
2. 接著檢查應用程式啟動：確認主視窗能正常開啟，且設定目錄可寫入。不要在同一個目錄混合解壓 Desktop 和 WPF 檔案，以免覆寫元件或核心。
3. 然後啟動核心：選擇伺服器並查看記錄檔。缺少核心檔案、沒有執行權限或連接埠遭占用，都可能造成「視窗正常但網路不通」的情況。
4. 最後讓應用程式流量經過代理：啟用所需的系統代理，或在測試應用程式中明確指定本機代理。只有入口、路由和遠端連線都正常，才算完成安裝。

macOS 初次執行時也可能需要允許開啟應用程式並授予網路權限；Linux 的 TUN 則可能需要存取虛擬網卡和修改路由的權限。這些問題屬於作業系統整合層，更換介面不一定能解決。請先確認一般代理連線可正常運作，再處理需要較高權限的流量接管方式，這樣更容易縮小排查範圍。

功能確認：分別測試訂閱、系統代理與 TUN

日常功能可分三個層次確認：訂閱是否產生正確的伺服器清單、核心能否建立連線，以及應用程式流量是否經過用戶端。系統代理主要影響遵循系統代理設定的應用程式；TUN 則透過虛擬網卡接管流量，但仍會受到路由、DNS、權限和排除規則影響。兩者不是同一個開關，也不能只憑「啟用成功」的提示，就認定連線正常。

以上連接埠僅用於說明測試方式，不代表所有版本的預設值。有些設定使用獨立的 SOCKS 與 HTTP 入站，有些則使用混合入站；請前往「設定」→「參數設定」，確認實際監聽連接埠與入站類型，介面名稱可能會隨版本調整。只有在確實提供相應入站的情況下，以下命令才適用。

# SOCKS 入站：由代理端解析目標網域
curl --proxy socks5h://127.0.0.1:10808 --connect-timeout 10 https://example.com/

# HTTP 入站：透過 HTTP 代理建立 HTTPS 連線
curl --proxy http://127.0.0.1:10809 --connect-timeout 10 https://example.com/

明確指定代理後測試成功，只能證明這條代理路徑可用，不能表示系統代理或 TUN 已涵蓋其他應用程式。如果命令能傳回內容但瀏覽器無法開啟，請檢查瀏覽器代理設定和系統代理狀態；若連不上本機連接埠，先確認核心是否正在執行，以及連接埠是否一致；若已連上本機代理但仍逾時，再檢查節點、DNS 和路由。

• 訂閱：在「訂閱群組」中新增網址並執行更新，確認節點數量、群組名稱和協定欄位。不要只看更新提示，也要檢查產生的伺服器記錄。
• 路由：使用相同的一組規則進行測試，區分直連出口與代理出口。更換介面後，也應確認原有規則檔案路徑和外部資料檔案。
• TUN：先停用其他用戶端執行個體，再檢查所需權限、DNS 和路由。避免兩套 TUN 同時變更系統路由，讓故障原因難以判斷。

從 WPF 移轉至 Desktop：先備份，再分開測試

移轉時先保留原有環境，再建立可還原的全新環境。訂閱網址通常可以重新新增，但訂閱不會包含所有本機設定：自訂路由、監聽連接埠、快速鍵、DNS、核心選擇和 TUN 參數都需要分別確認。即使同為 v2rayN，也不要預設所有版本都能直接沿用同一個設定目錄。

1. 記錄基準狀態：記下原環境的用戶端版本、核心版本、使用中的節點和代理模式。記錄可正常連線的測試目標即可，不必把完整記錄檔交給第三方。
2. 匯入最基本的設定：先只新增訂閱和一個可用節點。暫時不要還原複雜路由、自動化工作和 TUN，減少首次測試時的變數。
3. 逐項還原：每還原一項設定就測試一次。如果還原路由後才發生故障，應優先檢查規則和資料檔案，而不是重新安裝介面。
4. 確認結束程式後的狀態：關閉或結束用戶端後，確認系統代理是否如預期還原。如果舊程式留下代理設定，即使新程式尚未啟動，也可能造成網路異常。

跨平台移轉時也要留意路徑格式。Windows 磁碟機路徑無法直接用於 macOS 或 Linux；如果匯出的設定參照外部規則、憑證或其他檔案，請在目標系統重新指定路徑。不要為了省事而直接將整個設定目錄覆蓋到新平台，否則也會一併移轉僅適用於原系統的設定。

常見問題：啟動失敗、連接埠衝突與選擇迷思

建議固定依照「安裝套件與相依項目 → 核心啟動 → 本機入站 → 節點連線 → 系統代理或 TUN」的順序排查。這樣可以區分介面故障與網路故障，也能避免把訂閱更新失敗誤判為 Avalonia 不相容。以下問題都可先透過小範圍檢查找出原因，再決定是否切換版本。

最後可歸納為兩個原則：macOS 與 Linux 請從 Desktop 對應的安裝套件開始；Windows 初次安裝建議優先評估 Desktop，已有穩定 WPF 環境則依需求決定是否移轉。無論選擇哪種介面，都先確認一個節點、一種入站和一種代理模式可正常運作，再逐步加入自訂分流和 TUN。