Windows x64 初次安裝可從標示為 Desktop 的 Avalonia 版開始;如果目前使用的 WPF 版順手且運作穩定,不必只為了更換介面而移轉。macOS 和 Linux 請選 Avalonia 版,並確認處理器架構與套件格式。更換版本後,先測試本機代理,再檢查系統代理與路由設定,避免把設定差異誤認為框架差異。
Windows x64:選 Desktop 版還是 WPF 版?
下載頁上的 Desktop 和 WPF 指的是兩種桌面介面,不是不同的代理協定。Avalonia 版可在多種桌面平台使用,WPF 版則保留經典的 Windows 介面。兩版的選單位置、系統匣操作、清單操作與縮放效果可能不同;即使設定項目名稱相近,也不必照著另一版的截圖逐一尋找按鈕。
Avalonia(Desktop)版
推薦首次安裝可以從 Desktop 版開始。如果還會在其他 macOS 或 Linux 電腦上操作,熟悉同一套介面會比較方便;但系統代理與權限仍須依各平台分別設定。
適用情境:Windows x64 初次安裝、跨桌面平台使用
WPF 版
如果目前版本的系統匣操作、快速鍵和畫面縮放都符合使用習慣,繼續使用熟悉的介面,會比換版後重新排查設定更省事。
適用情境:已有穩定設定、偏好經典 Windows 介面
在 Windows 的「設定」→「系統」→「關於」查看「系統類型」。別只看「64 位元」:x64 處理器和 ARM 處理器採用不同架構。本網站提供的 Windows 下載項目是 x64 版;ARM 裝置能否正常執行,須視系統的相容性與該版本的執行需求而定。如果啟動時出現缺少執行階段的錯誤,先記下錯誤訊息中的元件名稱,再對照下載版本的說明,不必盲目重裝兩種介面版本。
macOS 與 Linux:依架構和套件格式選擇
兩種平台都選 Avalonia,安裝前的確認項目則不同
macOS:先確認晶片
- 在「關於這台 Mac」查看「晶片」或「處理器」。Apple 晶片選 arm64,Intel 處理器選 x64。
- 相應的下載項目提供 DMG。安裝後先確認用戶端能否啟動,再檢查目前使用的網路服務是否已套用代理設定。
Linux:先確認發行版和系統架構
- Debian、Ubuntu 系統通常選 DEB;Fedora 等使用 RPM 的發行版則選 RPM,並確認發行說明中的相依套件需求。
uname -m顯示x86_64代表 x64,顯示aarch64代表 arm64;也要確認系統使用者空間與安裝包架構相符。
跨平台是指介面可在不同系統上執行,不代表同一個安裝包能通用。
Linux 桌面代理設定不會套用到所有應用程式。圖形介面瀏覽器、終端機工具和背景服務可能各自讀取不同的代理設定;如果瀏覽器能連線、終端機卻不行,先確認終端機工具實際讀取哪項設定。macOS 也要區分系統代理和應用程式手動指定的代理。如果切換 Wi-Fi 和有線網路後行為不同,請檢查目前使用的網路服務,不要只看用戶端視窗中的狀態。
功能與效能:分清介面、核心和流量入口
介面負責編輯設定、管理訂閱和顯示記錄;實際處理代理連線的是所選核心,例如 Xray。比較功能前,先記錄兩邊的用戶端版本與核心版本,再確認目前使用的設定、路由模式和流量入口。若兩個安裝包的版本不同,就不能只憑某個按鈕是否存在,判斷是哪種框架支援該功能。系統代理和 Tun 也是不同的流量入口:前者仰賴應用程式採用代理設定;後者則須考量虛擬介面、平台權限和路由變更。
更換版本後先測試本機連線,再啟用系統代理
在用戶端「設定」→「參數設定」中確認本機監聽設定,再讓支援手動代理的應用程式使用該位址和連接埠。代理類型也要符合實際的入站設定:例如設定只提供 SOCKS,就不要把同一個連接埠填入 HTTP 代理欄位。手動設定代理正常、啟用系統代理後卻出問題時,優先確認應用程式是否採用系統設定。
如果在意速度,請使用同一台電腦、同一組連線設定、同一個核心與版本,以及相同的測試目標進行測量,測試時只執行一套用戶端。工作管理員中的介面程序記憶體用量、點選清單的反應時間,以及實際下載速度,是不同的指標。單次下載速度波動不能證明哪種介面比較快;如果只有視窗操作卡頓,請另外檢查高解析度縮放和長清單捲動,不必同時修改代理設定。
從 WPF 換到 Avalonia:備份與驗收步驟
- 記錄舊版狀態。記下用戶端與核心版本、目前選取的設定、訂閱群組、自訂路由、本機連接埠和系統代理狀態。可以使用目前版本提供的匯出功能;另外也要備份舊版實際使用的資料目錄,不要一概把安裝目錄當成資料目錄。訂閱網址可能含有存取憑證,請存放在自己掌控的位置。
- 結束舊版,再開啟新版。從系統匣結束舊用戶端,不要只關閉主視窗。兩個程序共用同一個本機連接埠時,新版可能無法監聽;即使使用不同連接埠,兩邊同時修改系統代理也會增加排查難度。首次啟動新版時,先不要讓它自動接管流量。
- 依新版支援的方式匯入。可參考快速入門中的匯入說明,先還原常用設定或一組訂閱,再新增自訂規則。訂閱更新成功只代表清單已取得,不表示原有的本機分流、連接埠或選取項目也已還原。跨版本移轉時,不要直接覆蓋新版的整個設定目錄。
- 逐項驗收,並保留回復方式。先查看核心啟動記錄,再測試本機代理,接著啟用系統代理;原本使用 Tun 的話,最後再單獨驗證。需要回復舊版時,先在新版停用已啟用的流量接管功能並結束程式,再還原舊版。如果網路仍異常,請檢查系統代理是否仍指向已停止監聽的本機連接埠。
版本選擇與更換版本常見問題
可以在同一台 Windows 電腦上安裝兩個版本嗎?
可以保留兩個版本互相比較,但要先確認各自的資料位置,不要以為安裝目錄不同就一定能隔離設定。實際試用時,先關閉其中一個版本的開機啟動,再從系統匣結束程式,之後才啟動另一個版本。
新版有清單,但瀏覽器無法開啟網頁,該怎麼辦?
先查看記錄,確認核心已啟動且沒有監聽失敗。接著檢查瀏覽器是使用系統代理、手動設定,還是由擴充功能覆寫設定。如果瀏覽器仍指向舊連接埠,請改為新版實際監聽的連接埠,並確認代理協定相符。
原本的訂閱還在,為什麼分流結果不同?
先確認目前啟用的路由設定、規則順序和預設出站,再檢查應用程式是否真的連到本機代理。訂閱提供的連線清單與用戶端儲存的自訂路由並不相同,可參閱路由設定參考逐項檢查。
Linux 套件已安裝,為什麼系統匣找不到圖示?
先從應用程式選單重新開啟主視窗,確認程序是否正在執行。如果主視窗正常但沒有系統匣入口,請檢查目前的桌面環境是否支援並啟用了狀態圖示。排查期間不要只依賴系統匣結束程式,也不要把圖示消失當成核心啟動失敗。