首次安裝可優先選擇 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。
- Windows:本站提供的兩種 Windows 版本皆為 x64。確認架構相符後,再依使用習慣選擇桌面版或經典 WPF 版。
- macOS:Apple 晶片請選 ARM64 DMG,Intel 處理器請選 x64 DMG。兩種安裝套件都屬於 Avalonia 桌面版,差別在於處理器架構。
- Linux:架構相符後,Debian、Ubuntu 等系統通常選 DEB;Fedora 等使用 RPM 的系統則選 RPM。套件格式正確,不代表目前的發行版已具備套件所需的所有相依項目。
是否需要另外安裝 .NET,取決於個別發行套件是否已內含執行階段,而非只看 Avalonia 或 WPF。若 Windows 啟動時提示缺少 Microsoft.WindowsDesktop.App,請依提示確認所需版本與架構,安裝對應的 .NET Desktop Runtime,而非只安裝相同世代的基礎執行階段。若主視窗能開啟,但啟動節點後才發生錯誤,應先查看核心記錄,不要將核心啟動失敗誤判為介面執行階段缺失。
功能差異:分別確認核心、路由與流量入口
切換版本後看到相同的節點,只能證明節點資料已匯入。若要比較實際運作情況,請使用同一個節點並確認核心類型,再比較路由與流量入口。若同時更換介面、核心和測試節點,即使延遲有所不同,也無法判斷是哪項變更造成的。
- 核心與協定:選擇原本可用的節點,確認協定、傳輸方式和安全設定,再查看記錄中實際啟動的核心。VLESS 節點的傳輸與安全參數仍須和伺服器設定一致,改用 Avalonia 不會自動補上這些欄位。
- 路由:在「設定」→「路由設定」確認目前選用的規則集。匯入自訂規則後,也要檢查比對順序及引用的規則資源是否齊全。分別測試一個預期直連及一個預期透過代理連線的目標,不要只以能開啟某個網頁作為驗收標準。
- 流量入口:在主畫面或系統匣選單確認「系統代理」狀態。先使用會遵循系統代理設定的應用程式測試連線,再決定是否需要另外測試 TUN。系統代理不會自動接管所有應用程式;TUN 則涉及平台權限與網路設定,不建議在初步排錯時和系統代理一起測試。
同時測試時的連接埠範例
這兩個連接埠僅用於說明衝突情況,並非兩個版本各自固定使用的數值。請在「設定」→「參數設定」查看本機監聽連接埠。若舊版已占用相同位址與連接埠,新版可能在介面正常開啟後回報監聽失敗。遷移時最簡單的做法是先從系統匣結束舊版;若確實需要同時測試,除主要監聽連接埠外,也要檢查其他已啟用的監聽項目,並確保只有一個執行個體修改系統代理。
設定遷移:訂閱可重新建立,手動設定須個別確認
先確認節點的來源。訂閱群組可在新版重新新增訂閱網址,再從「訂閱群組」選單更新訂閱。手動新增的節點不包含在訂閱中,必須另外保留分享連結或備份至本機。訂閱網址和節點分享連結可能含有存取憑證,請只存放在自己能控管的位置,不要貼到公開截圖或疑難排解文章中。
依遷移情境選擇做法
在同一台 Windows 電腦切換版本,或遷移至其他桌面作業系統
Windows 上從 WPF 切換至 Avalonia
- 先在舊版停用系統代理、關閉已啟用的 TUN,並從系統匣結束程式,再備份舊版實際使用的資料目錄。
- 將新版安裝在獨立位置進行測試。若需還原資料檔,請先確認兩個版本的資料格式與目錄結構相容,並保留新版原始資料的副本。
- 參照舊版的紀錄還原路由和本機連接埠。若發生讀取錯誤,先還原新版自己的資料,再透過訂閱與分享連結重新建立節點。
從 Windows 遷移至 macOS 或 Linux
- 在目標作業系統安裝架構相符的 Avalonia 套件,重新新增訂閱並匯入必要的手動節點。
- 在目標作業系統重新設定規則檔案位置、應用程式的手動代理位址及開機啟動選項,不要複製 Windows 專用路徑。
- 先確認一般代理連線與路由結果。若確實需要接管所有裝置的流量,再於目標作業系統個別設定並測試 TUN。
驗收標準為新版可獨立啟動、節點能連線,且路由結果符合預期。確認以上項目後,再決定是否移除舊版。
常見問題:切換版本後無法連線、節點變少或應用程式未走代理
依問題症狀排查
關閉視窗了,為什麼新版仍提示連接埠遭占用?
關閉視窗後,舊版可能仍在系統匣執行。找到舊版的系統匣圖示並選擇「結束」,再重新啟動新版核心。若仍提示連接埠遭占用,請在「設定」→「參數設定」確認衝突的連接埠;變更連接埠後,也要同步修改手動填寫代理位址的應用程式。
訂閱更新成功了,為什麼比舊版少了幾個節點?
先選取相同的訂閱群組,確認訂閱網址一致,再檢查群組設定中的篩選條件。接著確認舊版中消失的節點是否為手動新增。更新訂閱不會將手動節點同步至新版,這些節點必須另外匯入。
瀏覽器可以連線,為什麼另一個應用程式不行?
先確認該應用程式是否會讀取系統代理設定。若支援手動設定代理,請將代理類型、位址與連接埠設為用戶端實際提供的本機監聽項目。只有在應用程式無法使用這些連線方式,且確實需要接管流量時,才另外測試 TUN。
新版不適合使用,如何切回 WPF?
先在新版停用系統代理並關閉 TUN,再從系統匣結束程式。使用保留的舊目錄啟動 WPF,確認目前節點和路由後,再恢復原有的系統代理設定。若兩個版本曾共用資料目錄,請先使用遷移前的備份還原舊版資料。