本文面向正在下载 v2rayN、准备从 WPF 版迁移，或需要在 Windows、macOS、Linux 之间统一使用方式的用户。读完可以判断两个版本分别适合什么环境，并按步骤迁移订阅、路由、端口和系统代理设置。
Avalonia 桌面版与 WPF 版分别是什么
v2rayN 的两条桌面界面路线并不是两个完全无关的客户端。它们都负责管理服务器配置、订阅分组、路由规则、代理核心与系统代理状态，主要差异来自图形界面技术和操作系统适配方式。下载页中的“桌面版”通常指采用 Avalonia 构建的跨平台界面，“WPF 版”则指采用 Windows Presentation Foundation 构建的传统 Windows 界面。
Avalonia 允许同一套主要界面逻辑运行在 Windows、macOS、Linux，因此更适合需要跨系统使用相近操作流程的用户。WPF 依赖 Windows 桌面技术，只面向 Windows，但它与 Windows 通知区域、窗口行为和系统代理操作的结合更直接，长期使用旧版 v2rayN 的用户也更熟悉其菜单位置。
两个数字需要结合配置理解。10808 是不少 v2rayN 配置中使用的本地代理端口，但升级或导入备份后可能保留其他数值；127.0.0.1 表示只接受本机连接。实际端口应在「设置」→「参数设置」中核对，不要仅凭教程里的示例修改浏览器或其他软件。
| 比较项 | Avalonia 桌面版 | WPF 版 |
|---|---|---|
| 运行平台 | Windows、macOS、Linux | Windows |
| 界面技术 | Avalonia 跨平台界面 | Windows WPF 界面 |
| 适合的新安装场景 | 跨平台使用、统一操作习惯 | 只使用 Windows、延续旧版习惯 |
| 系统集成 | 按不同系统分别适配 | 围绕 Windows 桌面环境实现 |
界面和操作路径有哪些实际差异
两版的核心对象基本一致：主窗口显示服务器列表和延迟信息，订阅管理保存远程订阅地址，路由设置决定域名或地址的连接走向，系统代理菜单控制其他应用是否把流量交给 v2rayN。差异更多体现在按钮排列、右键菜单、弹窗布局和托盘菜单层级，而不是基础概念发生变化。
WPF 版更接近长期沿用的 Windows 桌面软件布局，服务器列表通常是操作中心，很多命令可通过列表右键菜单或顶部菜单完成。Avalonia 桌面版需要同时照顾不同系统的窗口规范，控件间距、对话框样式、快捷键响应和通知区域表现可能与 WPF 版不同。照着旧截图操作时，应根据命令名称寻找入口，不要只对照按钮所在位置。
Avalonia 桌面版
推荐覆盖三个桌面系统，主要功能使用相近的信息结构，后续更换系统时学习成本较低。
适合:新安装、跨平台办公、希望统一界面逻辑
WPF 版
保留传统 Windows 操作方式，对旧配置流程、通知区域菜单和既有使用习惯更友好。
适合:Windows 固定环境、旧版延续、迁移成本优先
常用任务应该找什么命令
- 添加订阅：寻找「订阅分组设置」或同义的订阅管理入口，保存地址后再执行更新订阅，不要把订阅地址直接当成单个服务器导入。
- 修改本地端口：进入「设置」→「参数设置」，核对本地监听端口及局域网访问选项。菜单末级名称可能随版本调整，但参数设置仍是主要入口。
- 切换路由：从路由设置或托盘菜单选择已有规则。全局、直连与规则分流处理范围不同，切换版本不会自动改变规则含义。
- 启用系统代理：先选择可用服务器并启动核心，再设置系统代理模式。仅启动主程序不等于系统流量已经进入代理。
- 查看故障信息：打开日志区域，先检查核心是否启动，再看端口占用、配置解析和连接握手信息。
结论:对照命令名称，不要机械照搬旧截图
Avalonia 与 WPF 的菜单位置可能不同，但“订阅、参数设置、路由、系统代理、日志”五类任务保持稳定。迁移时按任务名称查找，比按截图坐标操作更可靠。
核心功能覆盖是否完全相同
界面框架不负责定义 VMess、VLESS、路由分流或 TLS 等协议能力。真正建立连接的是客户端调用的代理核心，v2rayN 则负责生成配置、启动核心并展示状态。因此，判断某个节点能否使用时，需要同时检查 v2rayN 版本、所选核心、服务器参数和运行平台，不能只看界面属于 Avalonia 还是 WPF。
订阅导入、手动添加服务器、测试延迟、切换活动配置、查看日志和设置系统代理属于两条路线都要覆盖的基础功能。不过，新功能可能先在一条路线完成界面适配，复杂设置的控件名称也可能暂时不同。尤其是需要管理员权限、虚拟网络接口或系统级启动项的功能，会受操作系统权限模型影响，不能用 Windows 上的结果直接推断 macOS 或 Linux。
| 功能 | 两版关系 | 核对重点 |
|---|---|---|
| VMess 与 VLESS 配置 | 均由所选核心处理 | 地址、端口、传输层、TLS 与 SNI 参数 |
| 订阅更新 | 均可管理订阅分组 | 订阅地址、更新方式、分组筛选结果 |
| 路由分流 | 均可生成路由配置 | 规则顺序、匹配范围、最终出站 |
| 系统代理 | 目标相同，实现依赖系统 | 代理模式、本地端口、系统权限 |
| 开机启动与通知区域 | 操作方式存在平台差异 | 系统授权、桌面环境、后台运行状态 |
端口和局域网访问需要单独确认
- 打开「设置」→「参数设置」，记录当前本地代理端口。常见配置使用 10808，但旧备份也可能保留 10809 或自定义端口。
- 检查监听地址。127.0.0.1 只供本机使用；需要让局域网设备连接时，还要明确启用允许局域网访问，并配置操作系统防火墙。
- 检查浏览器、下载工具或开发工具中写死的代理端口。客户端端口改变后，这些独立配置不会自动同步。
- 启动核心后查看日志，确认没有“端口已被占用”一类错误，再切换系统代理并访问目标站点测试。
结论:界面相同不代表系统行为完全相同
订阅和路由可以迁移，但系统代理、后台运行、权限请求与防火墙规则需要在每台设备上重新确认。跨平台迁移应把“配置数据”和“系统集成”分成两组处理。
Windows、macOS、Linux 应该怎么选
Windows 用户拥有两种选择。如果是第一次安装、希望后续界面路线与其他桌面系统保持一致，优先尝试 Avalonia 桌面版。如果已经长期使用 WPF 版，现有订阅、路由和托盘操作都稳定，也没有跨平台需求，继续使用 WPF 版可以减少重新熟悉菜单和窗口行为的成本。
macOS 与 Linux 用户应选择 Avalonia 桌面版，因为 WPF 版依赖 Windows 桌面运行环境。下载时还要匹配处理器架构，并阅读对应平台的启动与授权说明。Linux 的通知区域、开机启动和系统代理表现可能受桌面环境影响；macOS 首次运行时则需要完成系统要求的应用授权。
- Windows 新用户：先选 Avalonia 桌面版，导入订阅后完成延迟测试、系统代理和路由验证；如果特定 Windows 工作流不适配，再比较 WPF 版。
- Windows 旧用户：稳定优先时保留 WPF 版；准备迁移前先导出配置，并记录参数设置中的本地端口。
- macOS 用户：选择 Avalonia 桌面版，按设备处理器架构下载，并在首次启动后检查系统代理是否实际写入。
- Linux 用户：选择 Avalonia 桌面版，除客户端配置外，还要检查桌面环境的通知区域支持、文件执行权限和代理设置入口。
按需求做最终判断
| 使用需求 | 建议版本 | 理由 |
|---|---|---|
| 三种桌面系统采用相近流程 | Avalonia 桌面版 | 界面逻辑跨平台，切换设备时更容易定位功能 |
| Windows 上延续旧操作习惯 | WPF 版 | 传统菜单、窗口与通知区域流程更熟悉 |
| 第一次安装 v2rayN | 优先 Avalonia 桌面版 | 直接进入跨平台路线，减少后续重新适应 |
| 已有复杂 Windows 配置 | 先保留 WPF 版并并行测试 | 验证订阅、路由、端口和系统代理后再迁移 |
从 WPF 版迁移到 Avalonia 桌面版的检查步骤
迁移的重点不是重新添加每一条服务器，而是保留配置数据并避免两个程序同时修改系统代理。开始前先关闭自动启动和系统代理，记录当前活动服务器、订阅分组、路由方案、本地端口与核心选择。复杂的自定义规则应单独留存，便于迁移后逐项核对。
如果两个版本需要短期并行测试，不要让它们同时使用 10808 等同一个监听端口。端口冲突会导致后启动的核心失败，而界面仍可能停留在已选择服务器的状态。测试时一次只启动一个版本，或把测试版本设置为不同端口，并明确浏览器当前连接的是哪一个端口。
- 停止旧版连接：在 WPF 版中关闭系统代理并退出核心，确认通知区域中没有残留运行实例。
- 整理配置：导出可用配置，记录订阅分组名称、路由规则、本地端口和局域网访问状态。
- 安装匹配版本：根据 Windows、macOS 或 Linux 以及处理器架构选择 Avalonia 桌面版。
- 恢复订阅与服务器：先导入配置，再更新订阅，检查服务器数量和分组是否符合预期。
- 恢复参数：进入「设置」→「参数设置」，核对 127.0.0.1、10808 等监听参数，不要假定导入过程覆盖全部程序设置。
- 验证路由：选择原先使用的路由方案，分别测试直连地址和需要代理的地址，确认规则走向正确。
- 最后启用系统代理：确认核心日志正常、端口没有冲突后，再开启系统代理并验证常用应用。
常见选择与迁移问题
下面几类问题通常不是协议本身故障，而是版本选错、端口冲突或系统代理状态没有同步。按现象检查，比反复删除订阅更容易定位原因。
Windows 上必须改用 Avalonia 桌面版吗?
不需要强制迁移。WPF 版运行稳定且满足现有需求时可以继续使用；需要跨平台一致性或准备采用新界面路线时，再按迁移清单测试 Avalonia 桌面版。
两个版本能同时安装吗?
可以保留两套程序用于比较，但不要同时启动核心或同时接管系统代理。分别检查「设置」→「参数设置」中的端口，避免两个实例都监听 10808。
导入订阅后服务器列表为空怎么办?
先确认订阅地址完整，再执行更新订阅并查看日志。若使用了分组筛选，清除关键词过滤后重新检查；仍为空时再确认订阅返回格式是否能被当前版本识别。
迁移后显示已连接但网页打不开?
先检查核心日志和系统代理状态，再核对本地端口。浏览器若固定使用 127.0.0.1:10808，而新版本改用了其他端口，就会出现界面已连接但应用无法访问的情况。
Avalonia 版和 WPF 版的节点速度会不同吗?
界面框架通常不是主要速度变量。应保持同一服务器、同一核心、同一协议参数和同一路由规则进行比较，并优先检查网络质量、服务器负载与传输配置。
概括来说，macOS 与 Linux 直接选择 Avalonia 桌面版；Windows 新用户优先从 Avalonia 桌面版开始，长期使用旧界面且工作流稳定的 Windows 用户可以继续使用 WPF 版。无论选择哪条路线，都应以订阅更新、核心启动、路由结果、本地端口和系统代理五项实际验证为准。