首次安装可先选 Avalonia 桌面版;Windows 上已有稳定的 WPF 配置,可以继续使用。换版时先迁移节点,再核对内核、路由和系统代理,不必为了界面一致而照搬旧设置。
平台覆盖:Windows 两版可选,macOS 和 Linux 选桌面版
Avalonia 和 WPF 首先是两种界面框架。它们决定窗口和控件如何呈现、程序能在哪些桌面系统上运行;VMess 或 VLESS 能否连接,则取决于实际使用的内核、节点参数和服务端配置。不要把安装包上的界面框架名称当成内核名称。
首次安装与已有配置
Avalonia 桌面版
推荐覆盖 Windows、macOS 和 Linux。跨系统使用时可以沿用订阅和节点管理思路,但托盘入口、系统代理和权限仍要按各自系统核对。
适合:首次安装,或需要在不同桌面系统上使用 v2rayN
WPF 版
只面向 Windows。当前版本如果满足协议需求、路由规则已验证,没必要只为切换界面框架重新配置一遍。
适合:继续使用已经配置妥当的 Windows 环境
安装包与运行依赖:先分清系统、架构和运行时
下载前先看运行客户端的那台机器,而不是看节点服务器用什么系统。Windows 可在「设置」→「系统」→「系统信息」中查看系统类型;macOS 可在「关于本机」中确认是 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,核对当前节点和路由后,再恢复原来的系统代理设置。如果两个版本曾共用数据目录,先用迁移前的备份恢复旧版数据。