v2rayN Desktop(Avalonia)与 WPF 版区别:Windows、macOS、Linux 该装哪个包

Desktop 与 WPF：区别在界面层，不在订阅格式

Avalonia 是跨平台桌面界面框架，WPF 是面向 Windows 的桌面界面框架。v2rayN Desktop 使用 Avalonia 构建界面，能够面向 Windows、macOS、Linux 提供对应程序；WPF 版面向 Windows。跨平台指项目可以发布不同系统的构建，并不是一个安装包可以在三个系统直接运行。

v2rayN 负责订阅分组、节点选择、路由设置和核心进程管理。实际建立代理连接的是所选核心。VMess、VLESS 等协议能否使用，要看核心版本、节点传输参数和服务端配置，而不是看窗口由 Avalonia 还是 WPF 绘制。换界面不能修复过期订阅，也不会自动给不兼容的核心增加协议能力。

Windows、macOS、Linux 的安装包选择

下载时分清三个维度：系统、处理器架构、打包方式。文件名中的 x64 通常对应 Intel 或 AMD 的 64 位桌面处理器，arm64 对应 ARM 64 位处理器；两者都属于 64 位，不能因为位数相同就互换。是否随包携带运行时，则是另一项独立信息，应按下载页说明确认。

下面的“推荐”限定为需要在多个桌面系统使用相近界面的场景，不代表 Desktop 在所有 Windows 设备上都比 WPF 更适合。具体架构和包类型，以下载中心当次提供的条目为准。

• Windows：打开系统「设置」→「系统」→「系统信息」，查看“系统类型”。先确认 x64 或 ARM64，再选择 Desktop 或 WPF 的匹配条目。
• macOS：在苹果菜单的「关于本机」查看“芯片”或“处理器”。Apple 芯片优先选择 arm64 构建，Intel 设备选择 x64 构建，不要下载 Windows 包。
• Linux：先确认架构，再根据发行版和桌面环境选择提供的包类型。不要仅根据压缩文件能解开，就判断程序及其依赖已经可运行。

macOS 与 Linux 可在终端查看架构。下面的命令只读取系统信息，不会修改网络设置：

uname -m

输出 x86_64 通常对应 x64；输出 arm64 或 aarch64 对应 ARM 64 位。Linux 是否具备所需图形库、运行时及适配的系统库，还需要结合包说明判断，架构匹配只是第一步。

界面、托盘与后台运行要分别测试

Desktop 与 WPF 在字体渲染、列表密度、缩放、菜单位置和快捷键反馈上可能有差异。高分辨率屏幕出现文字过大或弹窗超出屏幕时，先检查系统缩放与多显示器缩放是否一致，再判断是否属于客户端界面问题。不要先删除订阅或路由配置。

关闭窗口也不必然等于退出程序。是否最小化到托盘、是否仍有核心进程运行，取决于客户端选项和当前系统的托盘支持。Linux 桌面环境的状态图标支持尤其不一致：看不到图标，不足以证明核心已停止。

1. 首次启动保留主窗口：完成节点选择，观察日志是否报告核心启动成功；若失败，先记录错误信息。
2. 检查窗口关闭行为：点击窗口关闭按钮后，查看任务管理器或系统进程工具，确认客户端是否仍在运行。
3. 检查托盘入口：Windows 查看隐藏的通知区域图标；macOS 查看菜单栏；Linux 检查桌面环境是否提供状态图标支持。
4. 验证正常退出：优先从应用菜单或托盘菜单退出，随后检查系统代理是否恢复到预期状态，不要仅靠强制结束进程完成日常退出。

从 WPF 迁移到 Desktop：订阅与系统设置分开处理

迁移前先备份原有数据。备份范围包括订阅地址、分组信息、自定义路由和必要的参数记录；这些内容可能包含访问凭据，应保存在受控位置。不要直接把旧目录中的全部配置文件覆盖到另一种构建或另一版本的数据目录，内部结构与路径未必兼容。

订阅更新得到的是服务方提供的节点内容，并不意味着旧客户端的所有本地设置也会同步。分组更新间隔、自定义规则、快捷键和窗口行为应逐项核对。跨系统迁移时，原来的绝对路径尤其不能直接照搬。

如果同一设备上保留两套程序，日常只运行其中一套。两个进程同时申请系统代理、监听同一端口或创建虚拟网卡，会让错误来源变得混乱。测试结束后应明确保留哪个实例，并核对自启动设置，防止重启后旧实例再次接管。

安装后先测本地入口，再查系统代理与 TUN

“界面能打开”和“代理能使用”是两次不同的验证。前者说明图形程序至少已启动；后者还要求核心可执行文件、节点参数、本地入站和路由设置共同正常。提示缺少运行时时，按包说明补齐依赖或改选适合的包；核心启动失败则应读取核心日志，不能直接归因于 Avalonia。

1. 确认核心状态：查看启动日志，先排除核心缺失、执行权限不足和端口占用。Linux 上还要留意程序所在位置是否允许执行文件。
2. 确认本地入口：打开「设置」→「参数设置」，核对实际监听地址、端口和入口类型。不同版本的子项布局可能调整，应以界面显示值为准。
3. 单独测试代理：使用明确指定代理地址的请求，排除应用是否读取系统代理设置带来的干扰。
4. 验证系统代理：本地入口正常后，再让浏览器读取系统代理。系统代理不会强制所有程序都使用代理。
5. 最后验证 TUN：确有接管非代理感知程序的需要时再启用，核对系统授权、路由和 DNS。TUN 接管流量不等于所有目标都走代理出口。

下面以本机已经确认监听的 SOCKS 入口 127.0.0.1:10808 为例。这是测试示例，不保证是当前安装的默认端口；若界面显示其他端口，必须替换。Windows 终端中使用 curl.exe 可明确调用 curl 程序；macOS、Linux 中使用 curl。

curl --proxy socks5h://127.0.0.1:10808 --head --connect-timeout 10 https://example.com/

socks5h 将域名交给代理端处理，--connect-timeout 10 把连接阶段超时设为 10 秒。该请求只能帮助验证当前路径是否能到达目标，不能单凭一次响应判断所有路由与 DNS 都正确。若立即提示无法连接本地端口，先查监听状态；若连接后超时，再查节点、出口与目标连通性。

选包与迁移常见问题