v2rayN Desktop（Avalonia）與 WPF 版差異：Windows、macOS、Linux 安裝包怎麼選

Desktop 與 WPF：差異在介面層，不在訂閱格式

Avalonia 是跨平台桌面介面框架，WPF 則是 Windows 專用的桌面介面框架。v2rayN Desktop 使用 Avalonia 建構介面，可提供 Windows、macOS、Linux 各自對應的版本；WPF 版則適用於 Windows。跨平台表示專案可針對不同系統發布各自的版本，並非一個安裝包就能在三種系統上直接執行。

v2rayN 負責訂閱分組、節點選擇、路由設定與核心程序管理，實際建立代理連線的是所選用的核心。VMess、VLESS 等協定能否使用，取決於核心版本、節點傳輸參數及伺服器設定，而非視窗由 Avalonia 或 WPF 繪製。更換介面無法修復過期訂閱，也不會讓不相容的核心自動支援新協定。

Windows、macOS、Linux 安裝包怎麼選

下載時要分清三個面向：作業系統、處理器架構與套件形式。檔名中的 x64 通常適用於 Intel 或 AMD 的 64 位元桌上型處理器，arm64 則適用於 ARM 64 位元處理器；兩者雖同為 64 位元，架構並不相同，不能互換。套件是否內含執行環境則是另一回事，請依下載頁面的說明確認。

以下所稱的「推薦」，僅適用於需要在多種桌面系統上使用相近介面的情境，不代表 Desktop 在所有 Windows 裝置上都比 WPF 合適。實際提供的架構與套件類型，請以下載中心當下列出的項目為準。

• Windows：開啟系統「設定」→「系統」→「系統資訊」，查看「系統類型」。先確認是 x64 或 ARM64，再選擇對應的 Desktop 或 WPF 套件。
• macOS：在蘋果選單中開啟「關於這台 Mac」，查看「晶片」或「處理器」。Apple 晶片裝置優先選擇 arm64 版本，Intel 裝置則選擇 x64 版本，請勿下載 Windows 套件。
• Linux：先確認處理器架構，再依發行版與桌面環境選擇可用的套件類型。壓縮檔能解開，不代表程式及其相依項目就能正常執行。

macOS 與 Linux 可在終端機查看處理器架構。以下指令只會讀取系統資訊，不會變更網路設定：

uname -m

輸出 x86_64 通常對應 x64；輸出 arm64 或 aarch64 則對應 ARM 64 位元。Linux 是否具備所需的圖形程式庫、執行環境及相容系統程式庫，仍須參考套件說明；架構相符只是第一步。

介面、系統匣與背景執行要分開測試

Desktop 與 WPF 在字型呈現、清單密度、縮放、選單位置及快速鍵回應上可能有所不同。若高解析度螢幕上的文字太大或對話框超出畫面，請先確認系統縮放與多螢幕縮放設定是否一致，再判斷是否為用戶端介面問題。不要一開始就刪除訂閱或路由設定。

關閉視窗不一定代表結束程式。是否縮到系統匣、核心程序是否仍在執行，取決於用戶端選項與目前系統的系統匣支援情況。Linux 桌面環境對狀態圖示的支援尤其不一致：看不到圖示，不足以證明核心已停止。

1. 首次啟動時保留主視窗：選好節點後，查看記錄是否顯示核心啟動成功；若失敗，先記下錯誤訊息。
2. 確認視窗關閉行為：按下視窗的關閉按鈕後，查看工作管理員或系統程序工具，確認用戶端是否仍在執行。
3. 檢查系統匣入口：Windows 請查看隱藏的通知區域圖示；macOS 請查看選單列；Linux 則確認桌面環境是否支援狀態圖示。
4. 確認正常結束程序：優先透過應用程式選單或系統匣選單結束程式，接著確認系統代理已恢復至預期狀態；日常結束程式時不要只靠強制終止程序。

從 WPF 遷移至 Desktop：分開處理訂閱與系統設定

遷移前請先備份現有資料，包括訂閱網址、分組資訊、自訂路由及必要的參數紀錄；其中可能含有存取憑證，請存放在安全的位置。不要把舊資料夾中的所有設定檔直接覆寫到另一種版本或不同版本的資料目錄，內部結構與路徑未必相容。

更新訂閱取得的是服務提供者提供的節點內容，不代表舊用戶端的所有本機設定也會同步。請逐項確認分組更新間隔、自訂規則、快速鍵與視窗行為。跨系統遷移時，尤其不能直接沿用舊環境的絕對路徑。

若同一台裝置上保留兩套程式，平時只執行其中一套。兩個程序同時設定系統代理、監聽相同埠號或建立虛擬網卡，會讓問題來源難以判斷。測試完成後，請明確決定保留哪個執行個體，並確認自動啟動設定，避免重新開機後舊執行個體再次接手。

安裝後先測試本機入口，再檢查系統代理與 TUN

「介面能開啟」和「代理能使用」是兩項不同的驗證。前者表示圖形程式至少已啟動；後者還需要核心執行檔、節點參數、本機入口與路由設定都正常。若提示缺少執行環境，請依套件說明補齊相依項目或改用合適的套件；若核心啟動失敗，應查看核心記錄，不要直接歸因於 Avalonia。

1. 確認核心狀態：查看啟動記錄，先排除核心缺漏、執行權限不足與埠號遭占用。Linux 還要留意程式所在位置是否允許執行檔案。
2. 確認本機入口：開啟「設定」→「參數設定」，確認實際的監聽位址、埠號與入口類型。不同版本的子項目配置可能不同，請以介面顯示的值為準。
3. 單獨測試代理：發出明確指定代理位址的請求，排除應用程式是否有讀取系統代理設定所造成的干擾。
4. 確認系統代理：本機入口運作正常後，再讓瀏覽器使用系統代理。系統代理不會強制所有程式都透過代理連線。
5. 最後測試 TUN：確實需要接管不支援代理設定的程式流量時再啟用，並確認系統授權、路由與 DNS。TUN 接管流量不代表所有目的地都會經由代理出口。

以下以本機已確認正在監聽的 SOCKS 入口 127.0.0.1:10808 為例。這只是測試範例，不保證是目前安裝版本的預設埠號；若介面顯示其他埠號，請務必替換。Windows 終端機中使用 curl.exe 可明確呼叫 curl 程式；macOS、Linux 則使用 curl。

curl --proxy socks5h://127.0.0.1:10808 --head --connect-timeout 10 https://example.com/

socks5h 會將網域名稱交由代理端解析，--connect-timeout 10 則將連線階段的逾時時間設為 10 秒。這項請求只能協助確認目前的連線路徑是否能抵達目標，不能只憑單次回應就判斷所有路由與 DNS 設定都正確。若立即顯示無法連線至本機埠號，請先檢查監聽狀態；若已連線但逾時，再檢查節點、出口與目標連線狀況。

安裝包選擇與遷移常見問題