Windows
v2rayN · Desktop / WPF桌面版使用跨平台界面，经典 WPF 版保留熟悉的操作布局。首次安装可先选桌面版；已有经典配置的用户，可按界面习惯与兼容需求选择。两种界面都应先完成订阅导入，再设置系统代理与路由。
安装前确认系统架构及运行要求。使用独立目录保存程序与配置，避免在临时目录中运行。更换界面或更新程序前，先通过客户端导出需要保留的配置，并确认本地端口没有被其他软件占用。
前往下载配置入口 / CLIENT CONTROLS
v2rayN 功能与设置
先区分应用入口、内核处理和远端连接。订阅管理负责整理服务器参数，系统代理负责引导应用流量，路由规则负责选择出口；三者分开检查，才能定位连接问题。
v2rayN · 功能
按分组更新服务器参数
订阅地址用于批量获取服务器配置，不等于单个服务器的分享链接。在订阅分组中新增分组，填写名称与地址，保存后执行更新，再到该分组检查列表。与逐条手填相比，订阅可集中同步地址、端口和传输设置。更新失败时先确认地址仍有效，再检查更新操作使用直连还是代理。订阅地址可能包含访问凭据，应保存在可信位置；向他人展示界面时隐藏完整地址，也不要发送包含凭据的截图。
订阅分组 → 订阅分组设置
新增分组 → 填写订阅地址 → 保存
更新订阅 → 检查服务器列表按域名与 IP 选择出口
路由分流在流量进入内核后生效，可按域名、目标 IP 或端口匹配直连、代理等出口。先使用客户端提供的预设，再根据实际访问需求补充规则，比一次加入大量自定义条目更便于排查。规则通常按顺序匹配，应把更具体的条件放在宽泛条件之前。域名策略设为 IPIfNonMatch 时，域名规则未命中才尝试解析 IP 继续匹配；它不是所有请求强制解析的开关。下面是规则字段片段，出口标签需与实际配置一致。
{
"domainStrategy": "IPIfNonMatch",
"rules": [
{
"type": "field",
"domain": ["geosite:cn"],
"outboundTag": "direct"
}
]
}让应用连接本地代理端口
自动配置系统代理会修改系统提供的代理入口，遵循该设置的应用才会将请求交给客户端。它与路由中的全局或绕过大陆不是同一个选项：前者决定流量是否进入，后者决定进入以后如何转发。浏览器可以访问而其他软件失败时，先检查软件是否读取系统代理，或是否具有独立代理设置。手动填写代理时，应核对协议、本机地址和实际监听端口，不能直接套用其他教程中的端口。退出客户端前清除系统代理，可避免留下失效入口。
系统代理：自动配置系统代理
本机地址：127.0.0.1
端口：以参数设置中的监听端口为准
路由：单独选择所需规则通过虚拟网络接口接入流量
TUN 模式通过虚拟网络接口接入流量，适合不能使用普通系统代理的应用。相比修改单个软件的代理设置，它涉及系统路由、权限和 DNS，首次启用前应先用系统代理验证服务器可用。桌面环境可能需要提升权限，具体行为取决于客户端、内核与操作系统。启用后如果出现域名打不开或局域网设备无法访问，应分别检查 DNS 与直连规则，并暂时停用其他会修改网络路由的软件。不要同时更换服务器和整套路由，以免丢失判断依据。
先验证：系统代理下可以访问目标站点
再启用：TUN 模式与所需系统权限
后检查：DNS、局域网访问、路由规则按协议参数选择内核
图形客户端负责编辑与管理配置，内核负责实际的协议处理、连接建立和路由执行。v2rayN 可以管理不同内核，但可选范围及设置入口以当前安装的客户端为准。切换前先确认服务器使用的协议、传输方式及安全参数，不能仅凭协议名称判断兼容性。包含 REALITY 或 XTLS Vision 的配置，应核对对应 Xray 功能要求。切换后重新启动连接并查看日志；不支持的字段通常需要调整内核或配置，而不是反复修改本地监听端口。
客户端：配置编辑与订阅管理
内核：协议处理与流量转发
选择依据：协议 + 传输 + 安全参数从剪贴板导入单条配置
分享链接把单个服务器的连接参数编码为文本，可通过客户端的剪贴板导入入口添加。先复制完整链接，避免带入聊天文字、引号或换行，再执行导入并检查类型、地址、端口与传输层安全。它与订阅的区别是后续通常不会随分组更新，服务端参数变化时需要重新导入。VMess、VLESS、Trojan 与 Shadowsocks 的分享格式不同，部分扩展字段还受内核支持范围影响。导入成功只表示解析通过，仍需进行真实连接测试，才能确认配置可用。
vmess://
vless://
trojan://
ss://选择功能查看配置要点 · 键帽为列表索引，不注册全局快捷键
先验证连接，再增加规则
首次配置只保留一个可用服务器和一套预设路由。浏览器能够完成实际请求以后，再调整分流、DNS 或 TUN。每次只更改一个设置，并记录更改前的值；出现异常时就能回退到已验证的状态。
测速结果只用于辅助判断
延迟测试、真实连接测试和下载速度测试衡量的对象不同。一个延迟数字不能证明目标网站、域名解析与应用代理设置都正常。比较服务器时使用相同测试方式，并结合实际访问结果，不要混用不同测试得到的排序。
客户端选择 / PLATFORMS
按操作系统下载客户端
桌面使用 v2rayN；Android 优先选择 v2rayNG，需要 V2Fly 内核时再考虑 v2flyNG。先确定设备架构与安装格式，再查看具体下载入口。版本信息统一放在下载页的客户端卡片中。
macOS
v2rayN · Apple Silicon / Intel在系统的“关于本机”中查看芯片信息，Apple Silicon 选择 arm64，Intel 选择 x64。架构选择影响程序能否正常运行，不取决于订阅使用 VMess 还是 VLESS，也不由服务器所在位置决定。
首次启动时按系统提示处理应用权限。先验证常规代理连接，再按需启用需要额外权限的网络功能。如果启动失败，先检查安装格式与芯片是否一致，再处理运行权限，避免把启动问题当成订阅故障。
前往下载Android
v2rayNG / v2flyNGv2rayNG 使用 Xray 内核，作为 Android 首选；v2flyNG 使用 V2Fly 内核，作为兼容需求下的备选。主流 arm64 设备选择对应安装入口，架构不确定时可查看下载页的通用版说明，不应仅凭手机品牌判断。
导入后选中服务器，启动连接时按系统提示授权 VPN 连接。持续运行还受电池优化与后台限制影响。若切换到后台后中断，先核对系统的后台运行设置，并确认没有其他应用占用同一 VPN 连接。
前往下载Linux
v2rayN · deb / rpm按发行版的软件包体系选择 deb 或 rpm，再区分 x64 与 arm64。图形客户端适用于桌面环境，安装成功后仍需核对桌面会话的代理设置；不同应用是否读取系统代理，取决于应用自身实现与运行环境。
优先通过图形软件安装工具处理软件包与依赖。使用 TUN 前检查系统权限及现有网络管理工具，避免多套规则同时接管流量。普通代理能访问而 TUN 失败时，应先查本地权限和路由，不急于更换订阅。
前往下载初次配置 / QUICK START
订阅导入到连接验证
客户端与服务器配置是两部分。安装程序只完成本地工具准备，连接还需要有效的服务器参数。已有订阅时按以下顺序操作；只有单条分享链接时，从剪贴板导入后直接进入第二步。
-
新增订阅分组并更新
打开订阅分组设置，新增分组并粘贴完整地址，保存后执行更新。检查列表是否出现服务器，确认类型、端口和安全设置均已解析。订阅地址用于获取配置，不能直接填进服务器地址栏；从网页复制时留意首尾空格与被截断的内容。
如果更新失败，先判断是地址不可达、访问凭据过期，还是客户端无法解析返回内容。先保留现有配置，不要连续删除分组重试。订阅转换会让转换服务接触原始配置，只有明确需要转换格式时才使用可信服务。
-
选中服务器，分别设置代理与路由
在服务器列表中选择一项作为活动服务器。桌面端启用自动配置系统代理，再选择适合使用场景的路由预设；Android 端启动连接并完成系统授权。系统代理与全局路由属于不同层次，选择全局不会自动让所有应用使用本地代理。
首次使用先保持其他参数不变。需要局域网共享时再调整监听地址和访问控制；仅在本机使用时保留本地监听。暂时不要同时启用多套网络接管功能，先建立一个可以重复验证的基础连接。
-
验证访问，并按日志定位异常
使用真实连接测试，再从目标应用打开需要访问的网站。分别检查域名解析、连接建立和应用代理入口。延迟测试成功但网页失败时，应查看是否存在 TLS 参数错误、DNS 异常，或应用绕过了系统代理，而不是只重复测速。
需要进一步排查时，记录测试时间、所选服务器与错误摘要。分享日志前移除订阅地址、用户标识和认证信息。连接恢复以后再逐项增加分流规则，日常退出前清除系统代理，避免应用继续指向已关闭的监听端口。
内核与客户端 / OPEN SOURCE
Project V、V2Fly 与 Xray
V2Ray 不是某一个固定界面的应用名称。理解项目、内核与图形客户端的分工，可以减少选包、导入和更新时的混淆，也能判断一个设置应在客户端里调整，还是需要服务器端配合。
项目背景与内核分支
Project V 是围绕网络代理工具形成的开源生态，V2Ray 是其中的重要项目。V2Fly 社区延续 V2Ray 的开发与维护，Xray 则从相关技术基础发展出独立的内核路线。二者有共同背景，但协议扩展、配置字段及功能演进并不完全一致，不能把名称相近理解为任意配置都能互换。
VMess、VLESS、Trojan 与 Shadowsocks 描述协议层面的选择，REALITY 属于安全机制，XTLS Vision 则涉及特定流控与转发处理。服务器配置常常同时包含协议、传输、安全及流控字段。判断是否可用时，需要核对整组参数与内核支持情况，而不是只看到一个协议名就认为兼容。
图形界面与协议执行分工
v2rayN、v2rayNG 与 v2flyNG 都是开源图形客户端。客户端提供服务器列表、订阅更新、设置编辑与启动控制，内核读取生成的配置并执行连接。桌面端选择 v2rayN，Android 端根据 Xray 或 V2Fly 的兼容需求选择客户端；选择时以功能需求和设备环境为依据，而不是把不同名称理解为不同等级的服务。
开源表示可以依照项目许可证查看、使用和修改相关代码。V2Fly 与 Xray 内核采用 MPL 2.0，图形客户端也有各自的许可证与分发条件。开源属性有助于理解实现与社区协作方式，但不能代替对订阅来源、服务器权限、配置内容和设备环境的判断。客户端本身不等于服务器订阅。
客户端与内核分别维护
图形界面更新可能涉及订阅解析、交互布局和系统适配；内核更新则可能涉及协议行为、路由和连接处理。两类更新解决的问题不同。遇到新字段不被识别时，应先确认内核能力；遇到界面打不开或菜单操作异常时，应优先检查客户端运行环境，不必先修改服务器配置。
更新前导出必要设置，并记录当前的监听端口、路由选择与 DNS 设置。更新完成后，用原有服务器和目标应用重复测试，再逐项恢复自定义配置。若连接行为发生变化，优先比较同一设置在更新前后的结果。需要系统学习时，可按完整手册从核心概念、安装和订阅逐章推进到 TUN 与日常维护。
阅读完整手册配置笔记 / RECENT NOTES
V2Ray 使用与排查笔记
从常见问题回到对应设置：安装问题先查运行条件，连接问题先查入口与参数，客户端选择则按平台和内核需求比较。以下三篇按发布时间倒序排列。
V2Ray 新手常见问题十问：订阅更新、延迟测试与连接失败速查
用十个短问答集中回答新手最常遇到的疑问：订阅为何更新失败、延迟测试怎么看、系统代理不生效、浏览器打不开网页等，附排查顺序。
阅读笔记v2rayN 首次安装设置指南：Windows 与 macOS 初次运行常见坑
覆盖解压位置、运行环境、首次启动权限、内核切换与本地端口设置，汇总 Windows 与 macOS 首次运行 v2rayN 时最容易卡住的几个环节。
阅读笔记v2rayN、v2rayNG、v2flyNG 怎么选：三款 V2Ray 客户端功能对比
按平台、内核、订阅管理、路由与 TUN 支持五个维度横向对比三款客户端，给出桌面首选 v2rayN、安卓在 v2rayNG 与 v2flyNG 间取舍的建议。
阅读笔记