第一次装 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:在苹果菜单 →「关于本机」查看「芯片」或「处理器」。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 运行时的步骤。
订阅和节点都在,为什么浏览器还是没走代理?
先看日志确认内核已启动,再检查托盘里的「系统代理」是否处于你需要的模式。如果浏览器单独指定过代理,核对它填写的端口和代理类型。换界面不会自动改掉浏览器里写死的旧地址。
换版后分流不对,怎样退回旧版?
先关闭新版的系统代理并退出新版,再启动旧版。如果试用时动过旧版的数据目录,先用迁移前的独立备份恢复;不要把新版已经写过的数据库直接交给旧版读取。最后重新选中原来的路由规则和节点,再开启系统代理。