第一次安裝 v2rayN,建議優先選擇符合系統與處理器架構的 Avalonia 桌面版;如果只使用 Windows,而且已習慣經典介面,繼續使用 WPF 版也沒問題。兩者主要差異在介面和系統支援,並非節點類型。切換前先備份,切換後再確認訂閱、路由和本機連接埠。
系統支援:如何選擇 Avalonia 與 WPF 版
Avalonia 和 WPF 是用來製作視窗、選單和按鈕的介面框架,不是代理通訊協定,也不是負責處理連線的核心。比較同一個 VLESS 或 VMess 節點時,請先確認使用的核心及版本、節點參數和路由設定都相同;不能只憑介面名稱判斷相容性或連線速度。
Avalonia 桌面版
推薦支援 Windows、macOS 和 Linux,三種平台各有對應的安裝套件。採用相同的介面框架有助於維持一致的操作習慣,但視窗選單、系統匣和系統代理功能仍會因作業系統而異。
適合:首次安裝,或需要在不同桌面作業系統間切換。
WPF 版
適用於 Windows。若已熟悉經典介面,且目前設定運作正常,就不必只為了更換介面而重新安裝。選擇版本時仍須確認下載頁列出的處理器架構和執行需求。
適合:只使用 Windows,並希望沿用經典介面的操作習慣。
依照舊教學操作時,先確認教學截圖使用的是哪一種介面。視窗配置不同,不代表功能已移除。尋找節點清單、訂閱群組或記錄檔等區域時,優先依功能名稱查找,不必要求按鈕出現在截圖中的相同位置。
安裝套件架構與 .NET 執行需求
選擇安裝套件時,依序確認作業系統、處理器架構、套件格式,最後再確認是否需要另外安裝執行階段。以 v2rayN 7.x 系列為例,不能只憑主版本號推定每個發布套件都依賴相同的 .NET 版本,或都已內含執行階段。若啟動時出現提示,請以目前套件的說明,以及錯誤訊息列出的框架名稱、版本和架構為準。
- Windows:前往「設定」→「系統」→「關於」,查看「系統類型」,再到下載頁選擇相符的套件。若 WPF 啟動錯誤明確指出缺少
Microsoft.WindowsDesktop.App,就需要安裝版本和架構相符的 .NET Desktop Runtime;只安裝一般的 .NET Runtime 無法補上這個桌面框架。 - macOS:在蘋果選單中開啟「關於這台 Mac」,查看「晶片」或「處理器」。Apple 晶片請選 ARM64,Intel 處理器請選 x64;不要只因為兩種套件的副檔名都是
.dmg就隨意選擇。 - Linux:在終端機執行
uname -m確認架構。選對架構後,還要依發行版選擇套件格式:例如 Debian 或 Ubuntu 通常選 DEB,Fedora 通常選 RPM。套件格式相符不代表能相容所有版本的發行版;安裝失敗時,先查看套件管理工具回報的具體相依性問題。
切換前先備份,依遷移情境還原設定
切換介面不只是重新匯入節點。訂閱群組、本機手動新增的節點、自訂路由和本機監聽設定都是不同資料;重新更新訂閱通常只能還原訂閱提供的節點。備份前先在舊版關閉「系統代理」,再從系統匣結束用戶端,避免只關閉視窗、背景仍在寫入設定。
同一台電腦切換版本與跨系統遷移
在同一台 Windows 電腦切換介面
- 先備份舊版實際使用的資料目錄。如果程式目錄中有正在使用的
guiConfigs,請備份整個目錄,不要只挑一個 JSON 檔案。 - 優先選擇相同發布版本的兩種介面。先讓新版獨立啟動一次,確認實際讀取的資料位置,再退出並備份這份新資料。
- 確認資料格式相容後,再用舊資料的副本進行還原。不要讓兩種介面同時讀寫同一份資料,也不要把舊版核心執行檔一併覆蓋到新版。
切換到 macOS 或 Linux
- 在舊版前往「訂閱群組」→「訂閱群組設定」,記下訂閱網址;手動新增的節點則另外匯出或記錄。
- 先在新系統安裝架構相符的用戶端,再還原訂閱和節點。不要直接沿用 Windows 的絕對路徑、自動啟動設定或核心程式檔案。
- 前往「設定」→「路由設定」,確認自訂規則及其引用的本機檔案,並依新系統的目錄重新指定路徑。
不論採用哪種方式,都請保留原始備份;訂閱網址和節點分享連結可能包含存取憑證,不要放進公開截圖或記錄檔。
切換版本後檢查節點、連接埠與路由
先確認新版已讀取原有資料,再啟用系統代理。遇到問題時,才能分辨是設定未完整遷移、核心未啟動,還是應用程式未使用正確的代理入口。
- 確認群組和目前使用的節點。查看訂閱群組名稱、手動新增的節點,以及目前選取的節點。若清單是空的,先確認新版是否讀取了預期的資料目錄,不要急著清除訂閱或覆蓋舊版。
- 確認代理入口和記錄檔。前往「設定」→「參數設定」查看本機監聽連接埠。若記錄檔顯示
address already in use,先確認舊版及其核心程序都已結束。若確實需要更改連接埠,也要同步修改手動填寫代理位址的應用程式,並確認使用的是 HTTP 還是 SOCKS。 - 使用同一組目標測試路由。啟用所需的系統代理模式後,分別測試一個原本應直接連線的網域,以及一個原本應透過代理連線的網域。網頁能開啟只能代表請求成功,還要搭配核心記錄檔和目前啟用的路由規則判斷流量走向。若只在終端機重現問題,請確認終端機程式是否讀取系統代理,或是否另行設定了代理環境變數。
切換版本常見問題
WPF 版目前運作正常,一定要換成 Avalonia 嗎?
不必只為了更換介面而遷移。先確認需要的是新版核心支援,還是跨平台介面。若只涉及核心,先確認目前用戶端支援哪些核心及版本;準備試用另一種介面時,請保留舊版和備份,先結束舊版再啟動新版。
開啟新版時提示缺少 .NET,安裝較新的版本可以嗎?
不一定。先查看錯誤訊息中的框架名稱、要求版本和架構,不要只看電腦已安裝的較新主版本。若發布頁提供適用於本機的自包含套件,也可以選用,以免另外安裝該套件所需的 .NET 執行階段。
訂閱和節點都在,為什麼瀏覽器還是沒有透過代理連線?
先查看記錄檔,確認核心已啟動,再檢查系統匣中的「系統代理」是否設為需要的模式。如果瀏覽器有另外指定代理,請確認填寫的連接埠和代理類型。更換介面不會自動更新瀏覽器中設定的舊位址。
切換版本後分流不正常,該如何退回舊版?
先關閉新版的系統代理並結束新版,再啟動舊版。如果試用期間曾修改舊版的資料目錄,請先用遷移前另行保存的備份還原;不要將新版寫入的資料庫直接交給舊版讀取。最後重新選取原本的路由規則和節點,再啟用系統代理。