macOS 和 Linux 請選 Avalonia 版;Windows 初次安裝可先使用跨平台桌面版。若已習慣傳統介面且目前運作正常,也可以繼續使用 WPF 版。下文將說明如何確認安裝檔架構、判斷關閉視窗後程式是否仍在執行,以及更換版本時如何保留訂閱並確認本機代理入口。
介面框架比較:如何選擇 Avalonia 與 WPF
Avalonia 跨平台桌面版
推薦Avalonia 用於建構跨平台介面。Windows、macOS 和 Linux 各有對應的發行套件,並非使用同一個安裝檔就能在三種系統上執行。
適合:初次安裝,或需要在不同桌面系統上使用相近的操作介面
WPF Windows 版
WPF 是 Windows 桌面介面框架。選擇此版本,主要是為了延續熟悉的視窗、選單和系統匣操作,而非變更節點協定。
適合:只使用 Windows,且目前的 WPF 設定與操作流程穩定
介面負責管理訂閱、編輯節點及啟動核心;核心則負責處理連線。Avalonia 和 WPF 都不是協定名稱,也不是核心名稱。若更換版本後,同一個節點無法連線,請先確認選取的節點、實際執行的核心與記錄,再檢查路由和本機連接埠設定。介面外觀不同,不代表協定支援或連線速度有所差異。
安裝檔命名:先確認系統,再確認架構
請拆解檔名逐項確認:系統與架構決定能否在裝置上執行,介面版本決定開啟哪一種桌面介面,副檔名則用來區分安裝程式、壓縮檔等格式。在 Windows 上,x64 不代表 WPF 版,也不能只憑 .exe 判斷是跨平台桌面版。若兩個項目的架構相同,請以下載項目標示的版本為準。
| 系統 | 介面版本 | 下載前確認 |
|---|---|---|
| Windows | Avalonia 或 WPF | 開啟「設定」→「系統」→「關於」,查看「系統類型」。x64 架構的處理器請選 x64;ARM 裝置則優先確認所選版本是否提供原生 ARM64 套件。 |
| macOS | Avalonia | 在「關於這台 Mac」查看晶片或處理器。Apple 晶片請選 ARM64,Intel 處理器請選 x64。 |
| Linux | Avalonia | 執行 uname -m。x86_64 對應 x64,aarch64 對應 ARM64;接著依發行版選擇適用的套件格式。 |
若下載的是壓縮檔,請先完整解壓縮到目前使用者可寫入的新資料夾,再啟動程式,不要只抽出主程式單獨執行。若該版本需要另外安裝執行階段,請依套件說明和啟動提示確認執行階段類型及架構。以 WPF 為例,若提示缺少 Microsoft.WindowsDesktop.App,請查找相應的 .NET 桌面執行階段,而非隨意安裝不同版本的基礎執行階段。
系統匣行為:關閉視窗不一定會結束程式
依桌面環境確認背景執行狀態
Windows:檢查通知區域
- 關閉視窗後,展開工作列的隱藏圖示區域,確認是否仍有 v2rayN 圖示。
- 試著從圖示重新開啟視窗;若要更換版本,請在系統匣選單中明確選擇「結束」,再用工作管理員確認舊版本程序已關閉。
macOS 與 Linux:確認桌面是否顯示狀態圖示
- macOS 請查看螢幕頂端的選單列,別將 Dock 中的應用程式圖示與選單列上的狀態圖示混淆。
- Linux 請先確認桌面面板是否支援狀態圖示。若看不到圖示,請使用系統監視工具確認程序狀態,不要反覆啟動多個執行個體。
先確認程式是否已結束,再檢查系統代理是否仍指向本機監聽位址。這兩項需要分開確認。
能否找到系統匣入口,取決於桌面環境、圖示顯示方式及應用程式設定。測試時請先開啟主視窗、關閉一次,再透過系統匣或選單列入口嘗試重新開啟。若只想停止代理,請依目前的使用方式關閉用戶端設定的系統代理或 TUN,再明確結束程式。原本手動設定代理的裝置,應還原先前的位址,不要直接清除系統設定。
更換版本驗證:保留訂閱並確認本機連接埠
更換版本前,請記下訂閱來源、目前使用的節點、路由模式和本機監聽連接埠。請妥善保管訂閱網址,不要貼在公開截圖中。若要保留手動新增的節點,請優先使用用戶端提供的匯入/匯出功能,或備份原始資料夾;不要讓新舊程式共用正在寫入的資料夾。
- 先結束舊版,再啟動新版。先匯入一筆訂閱或一個已知可用的節點,並選擇與舊版相同的測試節點,以免把節點差異誤判為版本更換問題。
- 在「設定」→「參數設定」確認本機監聽項目,再從記錄確認核心已啟動。上方的
127.0.0.1:10808僅用來示範代理入口由位址和連接埠組成;實際協定與連接埠請以本機設定為準。 - 先用一個遵循系統代理設定的瀏覽器測試連線,再測試原本手動設定代理的終端機或其他程式。若新版更改了連接埠,請一併更新這些程式中的舊連接埠。若記錄顯示連接埠已被占用,請先確認舊執行個體是否仍在執行,不要反覆開啟新執行個體來排查。
確認節點、路由和常用程式都正常後,再決定是否刪除舊資料夾。若需要還原,請結束新版、還原原有代理設定,再啟動舊版。保留獨立的舊資料夾和備份,比直接以新版檔案覆蓋舊資料夾更容易找出差異。
v2rayN 兩種桌面版常見問題
Windows 上可以同時保留兩套檔案嗎?
可以,請分別放在不同資料夾,測試時一次只執行一個版本。切換前先結束目前版本,確認本機連接埠已釋出,再啟動另一套,避免同時變更系統代理設定。
換成跨平台版後,訂閱需要重新購買嗎?
單純更換介面版本不需要。可先在新版新增原有訂閱並更新;若更新失敗,請確認連結是否仍有效,以及服務提供者是否限制訂閱格式或裝置數量。
開啟安裝檔後程式就退出,需要改用 WPF 版嗎?
不必急著更換版本。請先確認系統與架構、檔案是否完整解壓縮,以及目前使用者是否能寫入程式資料夾。Windows 若出現執行階段錯誤,可查看啟動提示或事件檢視器中的「Windows 記錄」→「應用程式」,再依實際缺少的項目處理。
從 WPF 換成 Avalonia 後,網頁能開但終端機無法連線,怎麼辦?
請先確認終端機是否仍保留舊的 http_proxy 或 https_proxy 設定,再比較連接埠和代理類型。變更環境變數後,請重新開啟終端機測試;瀏覽器能連線,不代表終端機使用了相同的代理入口。