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:先看芯片
- 在「关于本机」查看「芯片」或「处理器」。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 包装好了,为什么托盘找不到图标?
先从应用菜单重新打开主窗口,确认进程是否运行。若主窗口正常但没有托盘入口,检查当前桌面环境是否支持并启用了状态图标。排查期间不要只依赖托盘退出,也别把图标缺失当成内核启动失败。