Windows
macOS
Linux选择桌面发布包
进入 v2rayN 官方稳定发布页，按平台、CPU 架构和包类型选择 Assets。64 对应常见 x64，ARM 设备选 arm64，不能根据“64 位”三个字混用架构。源码 ZIP 与签名文件不是应用包。
| 平台 | 选择原则 |
|---|---|
| Windows | 当前安装说明要求 Windows 10+。普通 ZIP 使用 WPF 界面，带 desktop 的 ZIP 使用 Avalonia 界面。 |
| Linux | DEB 面向 Debian/Ubuntu，RPM 面向对应发行版，ZIP 可解压运行；核对发行版和架构。 |
| macOS | 当前说明要求 macOS 13.6+；Intel 选 64，Apple 芯片选 arm64，DMG 或 ZIP 按需要选择。 |
系统版本与存储方式见 官方发布文件介绍。部分发布包包含常用内核；额外内核是否需要下载，取决于你实际使用的协议。
安装、解压和数据目录
- Windows 把官方 ZIP 完整解压到固定且可写的目录，再启动应用；不要直接在压缩包预览中运行，也不要只复制主程序。
- Linux 使用 DEB/RPM 时通过包管理器安装。ZIP 完整解压后，在程序所在目录执行
chmod +x v2rayN，再以普通用户运行./v2rayN。 - macOS 使用 DMG 安装到 Applications；官方说明当前未签名的包可能被系统拦截。确认是官方包后，按文档针对应用路径处理：
xattr -cr /Applications/v2rayN.app，不要扩大到其他目录。 - 首次打开先确认界面正常、内核文件存在，暂不启用复杂路由和开机自动 TUN。
便携 ZIP 的数据保存在自身目录，安装版的数据位置可能不同；排查与备份时使用客户端提供的“打开存储所在的位置”，避免误备份空的安装目录。
订阅分组与分享链接
- 已有订阅 URL 时新增订阅分组，填写可识别的名称和订阅地址，再执行更新订阅。
- 更新后检查该分组是否出现预期节点。地址能打开并不代表返回格式正确，网站首页或登录页不能当订阅内容。
- 只有单节点分享链接时，在非输入框区域使用“从剪贴板导入分享链接”；Windows 官方文档说明可使用
Ctrl+V。其他界面按对应功能入口操作。 - 从节点列表选择一个作为活动配置，确认内核启动；仅把条目导入列表还没有完成连接设置。
多个来源优先建独立分组。把多个地址合并进同组时，订阅类型应一致。支持格式与协议见 官方订阅说明，完整 Clash 文件与单节点分享链接不应混为一谈。订阅 URL、UUID 和密码在截图中都要隐藏。
内核、系统代理和路由
先确认活动配置由哪个内核运行。默认节点可保留兼容的内核；完整自定义配置则要检查文件自己的监听端口和路由，不能只看界面选项。
系统代理与路由
系统代理负责把遵循系统设置的应用流量送进本地入口；路由负责决定进入内核后从哪里出站。日常浏览器使用可以先选择自动配置系统代理，再选择符合需求的路由规则。清除系统代理、不改变系统代理和 PAC 的行为不同，具体见 官方系统代理与路由说明。
终端和其他应用
命令行或特殊应用未必遵循系统代理，可单独指定代理入口；需要 TUN 时再按当前内核与权限要求启用。配置过多个客户端的电脑，只保留一个应用管理系统代理，避免端口和开关状态互相覆盖。
检查监听端口与目标请求
- 在设置中读取“本地混合监听端口”，确认活动配置启动时没有 Core 错误。普通混合入口可处理 HTTP 与 SOCKS 请求。
- 测试节点连接，然后访问你真正需要的网页；观察主界面信息栏中的请求与错误。
- 用 首页命令生成工具 填写实际端口，执行显式 HTTP 或 SOCKS 请求。Windows PowerShell 使用
curl.exe。 - 分别检查直连目标与代理目标；退出前清除系统代理，再确认普通网络恢复。
完整自定义配置的监听端口可能与界面默认值不同。显式请求连不上本地端口时，先检查内核是否运行和端口是否一致；本地入口正常但远端失败，再查 DNS、节点握手和路由。不要把 TCP 延迟、真连接测试和实际下载吞吐量当成同一项指标。
Core 启动和系统代理报错
- 运行 Core 失败：查看主界面内核日志，检查缺失文件、配置不兼容与端口占用；界面能打开并不能证明内核已启动。
- 更新订阅没有节点：核对返回格式、分组是否启用更新以及当前网络能否取回配置。先用独立分组排除合并或过滤造成的差异。
- 显式代理可用、浏览器失败：检查系统代理和应用独立设置。macOS 自动设置失败时，查看界面日志中系统代理脚本的错误。
- 完整自定义配置不能正常接管：核对文件内监听地址、Socks 端口与路由，客户端未必能自动推断所有配置入口。
- TUN 后出现异常：先关闭 TUN，恢复系统代理基线，再检查权限、虚拟网卡与内核版本。
官方 FAQ 区分界面日志与内核日志。反馈时提供两者中对应的错误、版本和复现步骤，日志内的凭据先脱敏。
备份 guiConfigs 与升级
在“备份和还原”保存 guiConfigs；非 Windows 平台按官方说明使用 ZIP。便携版也可以完全退出后保存整个目录，留作升级前副本。
更新前记录客户端版本、内核版本、监听端口和活动路由。旧版 6.10–7.23.2 的内置更新存在官方文档已说明的安全问题，迁移时从官方 Releases 手动下载新包并保留备份。更新失败时不要短时间内反复点击，GitHub 接口可能暂时限流。
更新后分别检查客户端、内核和配置，重新做一次真实请求。配置目录保存了订阅与节点信息，不能作为普通附件公开；恢复成功后重新确认系统代理、端口与路由，而不是仅检查节点列表还在。细节见 官方界面功能说明。
常见问题
v2rayN 与 v2rayNG 是同一个安装包吗？
v2rayN 面向 Windows、Linux 和 macOS 桌面；v2rayNG 面向 Android。名称相近但安装包和权限机制不同，手机不能直接安装桌面的 ZIP、DEB 或 DMG。
Windows 包名带 desktop 是什么意思？
官方发布文件说明中，普通 Windows ZIP 使用 WPF 界面，带 desktop 的包使用 Avalonia 界面。两者仍要分别选择对应 CPU 架构，desktop 不是额外的代理协议。
备份安装目录，是否就保存了所有配置？
便携 ZIP 通常把数据放在自身目录，安装版可能存放在系统用户目录。使用“打开存储所在的位置”核对，再使用内置备份；官方备份对象是 guiConfigs，不能只保存主程序文件。
参考资料
下载、系统要求和配置字段以对应版本的官方说明为准。文中的流程图由 AFQKit 绘制。