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 和密码在截图中都要隐藏。
内核、系统代理和路由是三项设置
内核决定能处理哪些协议和参数。使用已有节点时先保留兼容的默认内核，不把 Xray 与 sing-box 当作所有参数完全一致的替换品。若导入的是完整自定义配置，尤其要核对本地监听端口和配置自己定义的路由。
系统代理负责把遵循系统设置的应用流量送进本地入口；路由负责决定进入内核后从哪里出站。日常浏览器使用可以先选择自动配置系统代理，再选择符合需求的路由规则。清除系统代理、不改变系统代理和 PAC 的行为不同，具体见 官方系统代理与路由说明。
命令行或特殊应用未必遵循系统代理，可单独指定代理入口；需要 TUN 时再按当前内核与权限要求启用。配置过多个客户端的电脑，只保留一个应用管理系统代理，避免端口和开关状态互相覆盖。
通过实际端口与目标请求验证连接
- 在设置中读取“本地混合监听端口”，确认活动配置启动时没有 Core 错误。普通混合入口可处理 HTTP 与 SOCKS 请求。
- 测试节点连接，然后访问你真正需要的网页；观察主界面信息栏中的请求与错误。
- 用 首页命令生成工具 填写实际端口，执行显式 HTTP 或 SOCKS 请求。Windows PowerShell 使用
curl.exe。 - 分别检查直连目标与代理目标；退出前清除系统代理，再确认普通网络恢复。
完整自定义配置的监听端口可能与界面默认值不同。显式请求连不上本地端口时，先检查内核是否运行和端口是否一致；本地入口正常但远端失败，再查 DNS、节点握手和路由。不要把 TCP 延迟、真连接测试和实际下载吞吐量当成同一项指标。
运行 Core 失败与系统代理无效怎么查
- 运行 Core 失败：查看主界面内核日志，检查缺失文件、配置不兼容与端口占用；界面能打开并不能证明内核已启动。
- 更新订阅没有节点：核对返回格式、分组是否启用更新以及当前网络能否取回配置。先用独立分组排除合并或过滤造成的差异。
- 显式代理可用、浏览器失败：检查系统代理和应用独立设置。macOS 自动设置失败时，查看界面日志中系统代理脚本的错误。
- 完整自定义配置不能正常接管：核对文件内监听地址、Socks 端口与路由，客户端未必能自动推断所有配置入口。
- TUN 后出现异常：先关闭 TUN，恢复系统代理基线，再检查权限、虚拟网卡与内核版本。
官方 FAQ 区分界面日志与内核日志。反馈时提供两者中对应的错误、版本和复现步骤，日志内的凭据先脱敏。
先备份 guiConfigs，再更新客户端和内核
使用“备份和还原”保存配置；官方说明其对象是 guiConfigs。非 Windows 系统备份时把扩展名设为 ZIP，恢复时选择 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，不能只保存主程序文件。
官方来源与核对
本文依据以下官方项目与文档整理，资料核对日期为 2026.10.02。安装包、界面和配置字段会随版本变化，可通过原始资料确认当前要求。