v2rayN Avalonia 與 WPF 版差異:介面框架、支援平台與選擇指南

v2rayN WPF 版僅支援 Windows;Avalonia 桌面版支援 Windows、macOS 與 Linux。本文整理介面框架、執行需求、功能差異及遷移方式,協助選擇合適版本。

本文重點

首次安裝可優先選擇 Avalonia 桌面版;若 Windows 上的 WPF 設定已穩定運作,也可以繼續使用。切換版本時,先遷移節點,再確認核心、路由與系統代理,不必為了介面一致而照搬舊設定。

支援平台:Windows 可選兩種版本,macOS 和 Linux 請選桌面版

Avalonia 和 WPF 是兩種介面框架,會影響視窗與控制項的呈現方式,以及程式可執行的桌面作業系統。VMess 或 VLESS 是否能連線,則取決於實際使用的核心、節點參數與伺服器設定。安裝套件上的介面框架名稱,不代表核心名稱。

首次安裝與現有設定

Avalonia 桌面版

推薦

支援 Windows、macOS 和 Linux。跨作業系統使用時,訂閱與節點管理方式大致相同,但系統匣入口、系統代理及權限仍須依各平台確認。

適合:首次安裝,或需要在不同桌面作業系統上使用 v2rayN

WPF 版

僅支援 Windows。若目前版本符合協定需求,且路由規則已驗證無誤,無須只為更換介面框架而重新設定。

適合:繼續使用已設定妥當的 Windows 環境

安裝套件與執行需求:先確認作業系統、架構和執行階段

下載前,先確認執行用戶端的電腦規格,而非節點伺服器使用的作業系統。Windows 可在「設定」→「系統」→「系統資訊」查看系統類型;macOS 可在「關於這台 Mac」確認使用 Apple 晶片或 Intel 處理器。Linux 可執行 uname -m;常見輸出 x86_64 對應 x64,aarch64 對應 ARM64。

是否需要另外安裝 .NET,取決於個別發行套件是否已內含執行階段,而非只看 Avalonia 或 WPF。若 Windows 啟動時提示缺少 Microsoft.WindowsDesktop.App,請依提示確認所需版本與架構,安裝對應的 .NET Desktop Runtime,而非只安裝相同世代的基礎執行階段。若主視窗能開啟,但啟動節點後才發生錯誤,應先查看核心記錄,不要將核心啟動失敗誤判為介面執行階段缺失。

功能差異:分別確認核心、路由與流量入口

切換版本後看到相同的節點,只能證明節點資料已匯入。若要比較實際運作情況,請使用同一個節點並確認核心類型,再比較路由與流量入口。若同時更換介面、核心和測試節點,即使延遲有所不同,也無法判斷是哪項變更造成的。

  1. 核心與協定:選擇原本可用的節點,確認協定、傳輸方式和安全設定,再查看記錄中實際啟動的核心。VLESS 節點的傳輸與安全參數仍須和伺服器設定一致,改用 Avalonia 不會自動補上這些欄位。
  2. 路由:在「設定」→「路由設定」確認目前選用的規則集。匯入自訂規則後,也要檢查比對順序及引用的規則資源是否齊全。分別測試一個預期直連及一個預期透過代理連線的目標,不要只以能開啟某個網頁作為驗收標準。
  3. 流量入口:在主畫面或系統匣選單確認「系統代理」狀態。先使用會遵循系統代理設定的應用程式測試連線,再決定是否需要另外測試 TUN。系統代理不會自動接管所有應用程式;TUN 則涉及平台權限與網路設定,不建議在初步排錯時和系統代理一起測試。

同時測試時的連接埠範例

10808
範例:舊版目前使用的本機監聽連接埠
10818
範例:新版可選用的測試連接埠,須先確認未被占用

這兩個連接埠僅用於說明衝突情況,並非兩個版本各自固定使用的數值。請在「設定」→「參數設定」查看本機監聽連接埠。若舊版已占用相同位址與連接埠,新版可能在介面正常開啟後回報監聽失敗。遷移時最簡單的做法是先從系統匣結束舊版;若確實需要同時測試,除主要監聽連接埠外,也要檢查其他已啟用的監聽項目,並確保只有一個執行個體修改系統代理。

設定遷移:訂閱可重新建立,手動設定須個別確認

先確認節點的來源。訂閱群組可在新版重新新增訂閱網址,再從「訂閱群組」選單更新訂閱。手動新增的節點不包含在訂閱中,必須另外保留分享連結或備份至本機。訂閱網址和節點分享連結可能含有存取憑證,請只存放在自己能控管的位置,不要貼到公開截圖或疑難排解文章中。

依遷移情境選擇做法

在同一台 Windows 電腦切換版本,或遷移至其他桌面作業系統

Windows 上從 WPF 切換至 Avalonia
  • 先在舊版停用系統代理、關閉已啟用的 TUN,並從系統匣結束程式,再備份舊版實際使用的資料目錄。
  • 將新版安裝在獨立位置進行測試。若需還原資料檔,請先確認兩個版本的資料格式與目錄結構相容,並保留新版原始資料的副本。
  • 參照舊版的紀錄還原路由和本機連接埠。若發生讀取錯誤,先還原新版自己的資料,再透過訂閱與分享連結重新建立節點。
從 Windows 遷移至 macOS 或 Linux
  • 在目標作業系統安裝架構相符的 Avalonia 套件,重新新增訂閱並匯入必要的手動節點。
  • 在目標作業系統重新設定規則檔案位置、應用程式的手動代理位址及開機啟動選項,不要複製 Windows 專用路徑。
  • 先確認一般代理連線與路由結果。若確實需要接管所有裝置的流量,再於目標作業系統個別設定並測試 TUN。

驗收標準為新版可獨立啟動、節點能連線,且路由結果符合預期。確認以上項目後,再決定是否移除舊版。

常見問題:切換版本後無法連線、節點變少或應用程式未走代理

依問題症狀排查

關閉視窗了,為什麼新版仍提示連接埠遭占用?

關閉視窗後,舊版可能仍在系統匣執行。找到舊版的系統匣圖示並選擇「結束」,再重新啟動新版核心。若仍提示連接埠遭占用,請在「設定」→「參數設定」確認衝突的連接埠;變更連接埠後,也要同步修改手動填寫代理位址的應用程式。

訂閱更新成功了,為什麼比舊版少了幾個節點?

先選取相同的訂閱群組,確認訂閱網址一致,再檢查群組設定中的篩選條件。接著確認舊版中消失的節點是否為手動新增。更新訂閱不會將手動節點同步至新版,這些節點必須另外匯入。

瀏覽器可以連線,為什麼另一個應用程式不行?

先確認該應用程式是否會讀取系統代理設定。若支援手動設定代理,請將代理類型、位址與連接埠設為用戶端實際提供的本機監聽項目。只有在應用程式無法使用這些連線方式,且確實需要接管流量時,才另外測試 TUN。

新版不適合使用,如何切回 WPF?

先在新版停用系統代理並關閉 TUN,再從系統匣結束程式。使用保留的舊目錄啟動 WPF,確認目前節點和路由後,再恢復原有的系統代理設定。若兩個版本曾共用資料目錄,請先使用遷移前的備份還原舊版資料。

v2rayN 用戶端依平台查看下載項目