v2rayN Avalonia 桌面版與 WPF 版差異:支援系統與版本選擇

比較 v2rayN Avalonia 與 WPF 版的支援平台、執行需求和介面差異,協助 Windows、macOS、Linux 使用者選擇合適版本,並了解切換版本時如何遷移設定。

本文重點

第一次安裝 v2rayN,建議優先選擇符合系統與處理器架構的 Avalonia 桌面版;如果只使用 Windows,而且已習慣經典介面,繼續使用 WPF 版也沒問題。兩者主要差異在介面和系統支援,並非節點類型。切換前先備份,切換後再確認訂閱、路由和本機連接埠。

系統支援:如何選擇 Avalonia 與 WPF 版

Avalonia 和 WPF 是用來製作視窗、選單和按鈕的介面框架,不是代理通訊協定,也不是負責處理連線的核心。比較同一個 VLESS 或 VMess 節點時,請先確認使用的核心及版本、節點參數和路由設定都相同;不能只憑介面名稱判斷相容性或連線速度。

Avalonia 桌面版

推薦

支援 Windows、macOS 和 Linux,三種平台各有對應的安裝套件。採用相同的介面框架有助於維持一致的操作習慣,但視窗選單、系統匣和系統代理功能仍會因作業系統而異。

適合:首次安裝,或需要在不同桌面作業系統間切換。

WPF 版

適用於 Windows。若已熟悉經典介面,且目前設定運作正常,就不必只為了更換介面而重新安裝。選擇版本時仍須確認下載頁列出的處理器架構和執行需求。

適合:只使用 Windows,並希望沿用經典介面的操作習慣。

依照舊教學操作時,先確認教學截圖使用的是哪一種介面。視窗配置不同,不代表功能已移除。尋找節點清單、訂閱群組或記錄檔等區域時,優先依功能名稱查找,不必要求按鈕出現在截圖中的相同位置。

安裝套件架構與 .NET 執行需求

選擇安裝套件時,依序確認作業系統、處理器架構、套件格式,最後再確認是否需要另外安裝執行階段。以 v2rayN 7.x 系列為例,不能只憑主版本號推定每個發布套件都依賴相同的 .NET 版本,或都已內含執行階段。若啟動時出現提示,請以目前套件的說明,以及錯誤訊息列出的框架名稱、版本和架構為準。

x64
常見於 64 位元 Intel 或 AMD 電腦;Linux 對應 x86_64
ARM64
適用於 Apple 晶片等 ARM 裝置;Linux 對應 aarch64
10808
v2rayN 常用的本機輸入連接埠;實際值請以參數設定為準

切換前先備份,依遷移情境還原設定

切換介面不只是重新匯入節點。訂閱群組、本機手動新增的節點、自訂路由和本機監聽設定都是不同資料;重新更新訂閱通常只能還原訂閱提供的節點。備份前先在舊版關閉「系統代理」,再從系統匣結束用戶端,避免只關閉視窗、背景仍在寫入設定。

同一台電腦切換版本與跨系統遷移

在同一台 Windows 電腦切換介面
  • 先備份舊版實際使用的資料目錄。如果程式目錄中有正在使用的 guiConfigs,請備份整個目錄,不要只挑一個 JSON 檔案。
  • 優先選擇相同發布版本的兩種介面。先讓新版獨立啟動一次,確認實際讀取的資料位置,再退出並備份這份新資料。
  • 確認資料格式相容後,再用舊資料的副本進行還原。不要讓兩種介面同時讀寫同一份資料,也不要把舊版核心執行檔一併覆蓋到新版。
切換到 macOS 或 Linux
  • 在舊版前往「訂閱群組」→「訂閱群組設定」,記下訂閱網址;手動新增的節點則另外匯出或記錄。
  • 先在新系統安裝架構相符的用戶端,再還原訂閱和節點。不要直接沿用 Windows 的絕對路徑、自動啟動設定或核心程式檔案。
  • 前往「設定」→「路由設定」,確認自訂規則及其引用的本機檔案,並依新系統的目錄重新指定路徑。

不論採用哪種方式,都請保留原始備份;訂閱網址和節點分享連結可能包含存取憑證,不要放進公開截圖或記錄檔。

切換版本後檢查節點、連接埠與路由

先確認新版已讀取原有資料,再啟用系統代理。遇到問題時,才能分辨是設定未完整遷移、核心未啟動,還是應用程式未使用正確的代理入口。

  1. 確認群組和目前使用的節點。查看訂閱群組名稱、手動新增的節點,以及目前選取的節點。若清單是空的,先確認新版是否讀取了預期的資料目錄,不要急著清除訂閱或覆蓋舊版。
  2. 確認代理入口和記錄檔。前往「設定」→「參數設定」查看本機監聽連接埠。若記錄檔顯示 address already in use,先確認舊版及其核心程序都已結束。若確實需要更改連接埠,也要同步修改手動填寫代理位址的應用程式,並確認使用的是 HTTP 還是 SOCKS。
  3. 使用同一組目標測試路由。啟用所需的系統代理模式後,分別測試一個原本應直接連線的網域,以及一個原本應透過代理連線的網域。網頁能開啟只能代表請求成功,還要搭配核心記錄檔和目前啟用的路由規則判斷流量走向。若只在終端機重現問題,請確認終端機程式是否讀取系統代理,或是否另行設定了代理環境變數。

切換版本常見問題

WPF 版目前運作正常,一定要換成 Avalonia 嗎?

不必只為了更換介面而遷移。先確認需要的是新版核心支援,還是跨平台介面。若只涉及核心,先確認目前用戶端支援哪些核心及版本;準備試用另一種介面時,請保留舊版和備份,先結束舊版再啟動新版。

開啟新版時提示缺少 .NET,安裝較新的版本可以嗎?

不一定。先查看錯誤訊息中的框架名稱、要求版本和架構,不要只看電腦已安裝的較新主版本。若發布頁提供適用於本機的自包含套件,也可以選用,以免另外安裝該套件所需的 .NET 執行階段。

訂閱和節點都在,為什麼瀏覽器還是沒有透過代理連線?

先查看記錄檔,確認核心已啟動,再檢查系統匣中的「系統代理」是否設為需要的模式。如果瀏覽器有另外指定代理,請確認填寫的連接埠和代理類型。更換介面不會自動更新瀏覽器中設定的舊位址。

切換版本後分流不正常,該如何退回舊版?

先關閉新版的系統代理並結束新版,再啟動舊版。如果試用期間曾修改舊版的資料目錄,請先用遷移前另行保存的備份還原;不要將新版寫入的資料庫直接交給舊版讀取。最後重新選取原本的路由規則和節點,再啟用系統代理。

下載v2rayN依平台選擇用戶端