Windows
v2rayN桌面端优先选择 v2rayN。跨平台桌面版与经典 WPF 版使用不同的界面技术，运行环境要求也应分别确认。初次安装先看下载页的说明，再按系统架构选择；已有配置的用户应在升级前备份订阅分组、自定义路由和 DNS 设置。
启动后先确认内核能够正常运行，再导入订阅并设置活动服务器。浏览器未跟随系统代理时，优先检查浏览器扩展、独立代理设置与客户端的系统代理状态。终端通常需要单独指定代理，不应因为浏览器已连通就推断所有桌面应用都已接入。
前往下载配置问答
从当前遇到的问题开始
先区分订阅、客户端与内核，再修改对应设置。客户端里的“已连接”通常只说明本地代理已启动；网站能否访问，还要看节点参数、应用代理方式、DNS 和路由是否配合。下面按常见操作拆解，示例字段以 Xray 风格配置说明，其他内核应以其实际配置格式为准。
哪些设置需要先确认？
分组备注
日常使用订阅地址粘贴完整链接
保存后操作更新当前订阅
连接前确认选择活动服务器
先建立订阅分组，再粘贴完整链接并更新。订阅地址负责获取服务器列表，不等于某一台服务器的分享链接；导入类型选错时，常见表现是更新后列表为空。保存后确认当前分组，再选择一条服务器作为活动项。若更新失败，先检查链接是否失效、返回内容是否为登录页面，以及客户端能否获取该地址。分享截图时遮住完整订阅链接，避免把访问凭据一并公开。
{
"type": "field",
"domain": ["geosite:cn"],
"outboundTag": "direct"
}先确定哪些目标需要直连，再把具体规则放在宽泛规则之前。路由通常按顺序匹配，先命中的规则决定出站；仅把一条直连规则加到末尾，可能无法覆盖前面的代理规则。示例中的 direct 必须对应实际存在的出站标签，geosite 数据文件也要能被内核读取。保存后重新加载配置，用新建连接观察日志。相比反复切换全局模式，明确规则命中原因更便于保留可维护的配置。
应用侧浏览器安全 DNS
系统侧网卡与缓存
内核侧
dns / routing连接目标域名或已解析 IP
先确认域名由谁解析，再选择 DNS 服务器。浏览器、操作系统和代理内核可能各有一条查询路径，修改其中一处不代表所有应用都会使用它。遇到域名打不开但 IP 可达的情况，应结合日志检查解析失败、结果不合预期或查询路径不通。域名策略影响路由阶段是否尝试解析，并不等于所有查询都经过代理。每次只改一个设置并清理相关缓存，比同时更换多组服务器更容易定位问题。
遵循系统代理的应用先用系统代理
忽略代理设置的应用评估 TUN 接管
启用前检查权限与路由冲突
启用后检查本地网络与 DNS
应用不遵循系统代理时，再评估 TUN。它通过虚拟网络接口接入流量，和浏览器读取系统代理设置不是同一层机制。启用前先确认普通代理连接正常，并检查客户端所需权限、虚拟网卡支持及其他网络工具的冲突。启用后要测试本地设备、局域网服务和 DNS 是否仍可访问。TUN 不会修复错误的服务器参数，也不保证每个应用都能正常工作；遇到异常应先关闭它，回到已验证的基础连接排查。
本机状态时间与基础网络
订阅内容更新并核对活动项
内核日志读取首个有效错误
远端参数地址、端口、传输、TLS
先确认本机网络与时间，再检查订阅和日志。超时只是连接未在规定时间内完成，不能直接归因为某一种故障。先更新订阅并确认活动服务器，随后核对地址、端口、传输方式和 TLS 参数是否成套匹配。日志中的解析失败、连接拒绝与握手错误指向不同环节，应分别处理。若多台设备在同一网络都出现相同问题，再进一步确认服务端状态；不要靠反复重装客户端替代对错误信息的判断。
哪些设置需要先确认？
订阅链接怎么导入？
新建分组粘贴完整链接
保存并更新选择活动服务器
先建立订阅分组，再粘贴完整链接并更新。订阅地址负责获取服务器列表，不等于某一台服务器的分享链接；导入类型选错时，常见表现是更新后列表为空。保存后确认当前分组，再选择一条服务器作为活动项。若更新失败，先检查链接是否失效、返回内容是否为登录页面，以及客户端能否获取该地址。分享截图时遮住完整订阅链接，避免把访问凭据一并公开。
规则分流怎么设？
{
"type": "field",
"domain": ["geosite:cn"],
"outboundTag": "direct"
}先确定哪些目标需要直连，再把具体规则放在宽泛规则之前。路由通常按顺序匹配，先命中的规则决定出站；仅把一条直连规则加到末尾，可能无法覆盖前面的代理规则。示例中的 direct 必须对应实际存在的出站标签，geosite 数据文件也要能被内核读取。保存后重新加载配置，用新建连接观察日志。相比反复切换全局模式，明确规则命中原因更便于保留可维护的配置。
DNS 应该从哪里查？
依次确认浏览器 → 系统 → 内核
观察日志查询路径与解析结果
先确认域名由谁解析，再选择 DNS 服务器。浏览器、操作系统和代理内核可能各有一条查询路径，修改其中一处不代表所有应用都会使用它。遇到域名打不开但 IP 可达的情况，应结合日志检查解析失败、结果不合预期或查询路径不通。域名策略影响路由阶段是否尝试解析，并不等于所有查询都经过代理。每次只改一个设置并清理相关缓存，比同时更换多组服务器更容易定位问题。
什么时候需要 TUN？
系统代理有效先保留基础连接
应用忽略代理评估 TUN 接管
应用不遵循系统代理时，再评估 TUN。它通过虚拟网络接口接入流量，和浏览器读取系统代理设置不是同一层机制。启用前先确认普通代理连接正常，并检查客户端所需权限、虚拟网卡支持及其他网络工具的冲突。启用后要测试本地设备、局域网服务和 DNS 是否仍可访问。TUN 不会修复错误的服务器参数，也不保证每个应用都能正常工作；遇到异常应先关闭它，回到已验证的基础连接排查。
节点超时先排查什么？
本地网络、时间、活动服务器
远端地址、端口、传输、TLS
先确认本机网络与时间，再检查订阅和日志。超时只是连接未在规定时间内完成，不能直接归因为某一种故障。先更新订阅并确认活动服务器，随后核对地址、端口、传输方式和 TLS 参数是否成套匹配。日志中的解析失败、连接拒绝与握手错误指向不同环节，应分别处理。若多台设备在同一网络都出现相同问题，再进一步确认服务端状态；不要靠反复重装客户端替代对错误信息的判断。
如何使用这些示例？先记录当前能工作的配置，再按单个问题逐项修改。路由窗口是设置关系示意，不是可直接导入的完整配置；其中的出站标签需要与客户端生成的出站一致，规则库也需要实际存在。修改后用新的连接验证，避免把已有长连接继续使用旧路径误判为设置未生效。
如果界面文字与教程不同，先找对应功能，而不是照着菜单位置机械操作。桌面客户端与移动客户端的订阅管理、日志入口和代理接入方式并不完全一致。首次使用建议先完成一条普通连接，再增加分流与 DNS 调整；这样出现问题时，能够明确是服务器连接、应用接入还是附加规则发生了变化。
平台选择
V2Ray 客户端下载入口
桌面设备先看 v2rayN，安卓设备先看 v2rayNG；需要 V2Fly 内核兼容路径时，再考虑 v2flyNG。客户端负责本地配置与连接管理，订阅和服务器访问参数需要另行准备。先确认操作系统、处理器架构和所需协议，再进入对应平台选择安装包，不要仅凭文件名里出现熟悉的客户端名称就安装。
macOS
v2rayN先在系统“关于本机”中确认芯片，再选择 Apple Silicon 或 Intel 对应的安装入口。v2rayN 的跨平台界面保留订阅、服务器与路由管理的主要工作流程，但系统代理授权、网络权限和窗口位置不必与其他桌面系统完全相同。
首次打开若遇到系统提示，应先核对下载来源和包类型，并按系统提供的应用打开流程处理，不要直接关闭整套系统安全机制。连接后分别测试浏览器和实际工作应用；需要 TUN 时再按客户端说明授予必要权限，并检查本地网络访问是否受到影响。
前往下载Android
v2rayNG 优先安卓端先看采用 Xray 内核的 v2rayNG，采用 V2Fly 内核的 v2flyNG 作为备选。多数较新的设备可选择 arm64 包；不确定架构时先查设备信息，再考虑通用包。包的架构决定能否安装，协议与内核能力则决定导入的服务器能否实际使用。
启动代理时通常会出现系统 VPN 连接授权，这是移动端接入应用流量的方式，不代表客户端自动提供远端服务器。若已有其他使用同类接口的网络工具，需要留意连接冲突。后台断连时还应检查省电策略和后台活动限制，先区分系统暂停应用与服务器连接失败。
前往下载Linux
v2rayNLinux 桌面可使用 v2rayN，先按发行版的包管理体系选择 deb 或 rpm，再区分 x64 与 arm64。安装成功不等于桌面环境会自动读取系统代理；不同桌面、浏览器和终端对代理设置的处理存在差异，需要按实际使用的软件分别验证。
若客户端能够启动但应用无法连通，先确认本地监听端口、代理类型和应用设置，再检查系统代理接入。只有确实需要接管未遵循代理的流量时才评估 TUN，并按客户端要求处理权限。服务器上的纯命令行环境与图形桌面不是同一种安装场景，本页入口以桌面客户端为主。
前往下载下载前还需要确认什么？
安装客户端后就能连接吗？还需要有效的服务器配置或订阅。客户端是管理与接入工具，不能凭空生成可用的远端服务；已有订阅应先确认其有效期和支持的协议。查看首次连接步骤 →
桌面与手机配置可以直接互换吗？常见分享链接可能可以分别导入，但客户端自己的备份文件、路由模板和内核配置并不保证兼容。迁移时先导入服务器，再单独核对规则。查看客户端差异 →
生态与维护
Project V、V2Fly 与 Xray 的关系
先分清内核与客户端，才能理解功能支持。内核执行协议、路由和 DNS 等网络逻辑；客户端负责把订阅、服务器和设置组织为可运行的配置。相同的界面名称，不一定意味着底层使用相同内核；同一份服务器参数，也不一定能交给任意内核直接运行。
Project V 是什么背景？
Project V 是围绕网络代理与通信工具形成的开源项目背景，V2Ray 是其中广为人知的核心软件。随着开发与维护路线演进，V2Fly 延续 V2Ray 相关开发，Xray 则从相关代码基础发展出自己的实现与功能路线。因此，日常搜索中的“V2Ray”有时泛指整个使用场景，有时特指某一内核；查配置语法时应使用更明确的名称。
这种关系不是安装一个软件就同时拥有全部功能。图形客户端可以封装不同的内核调用方式，而内核各自决定支持哪些协议、传输和配置字段。遇到“服务器能导入但无法启动”，应先看实际选用的内核与启动日志，再判断是不是某个字段无法识别，而不是只依据客户端名称推断兼容性。
V2Fly 与 Xray 怎么选？
先按服务器提供的协议与传输要求选择，再考虑已有配置的迁移成本。两者共享部分概念和历史基础，但功能路线与配置支持并不完全一致。包含 REALITY、特定 flow 等参数的配置，应确认对应内核的实际支持情况，不能只把文件换个名称或复制到另一个客户端里就认为完成了转换。
对普通使用者而言，订阅提供的完整参数通常比抽象的内核性能比较更重要。地址、端口、认证信息、传输方式和 TLS 选项要成套匹配；漏掉一个字段就可能导致握手失败。没有同一环境下的可重复测试，不宜把某次连接快慢归结为内核本身。先保持可用，再针对明确问题调整，结论更可靠。
三款客户端分别负责什么？
v2rayN 面向桌面系统，提供订阅管理、服务器选择及相关代理设置界面；v2rayNG 面向安卓设备，采用 Xray 内核；v2flyNG 同样面向安卓设备，采用 V2Fly 内核。三者都是开源客户端项目，但不是由本站开发，也不能把其中一款的功能说明直接套到另外两款上。桌面环境先看 v2rayN，移动环境再按协议需求选择。
开源意味着代码及相应许可条件可供了解和审阅，不等于远端服务器也由同一项目提供。客户端项目、内核项目、订阅服务是不同环节。本站整理下载入口与中文操作说明，帮助判断这些环节的关系；服务器的授权、可用性及使用范围，仍需结合服务提供方的信息确认。
开源协议与更新如何理解？
开源许可证规定代码使用、修改与再分发的条件，不应把“代码可见”理解为可以忽略许可。V2Fly 相关内核和 Xray 的核心代码采用 MPL 2.0，具体文件、依赖以及图形客户端仍应分别查看各自的许可声明。客户端、内核和附带组件可以采用不同许可证，发行包中的声明才是核对具体使用条件的依据。
更新也有不同层次：客户端更新涉及界面与配置生成逻辑，内核更新涉及网络实现，规则数据更新影响域名或 IP 分类，订阅更新则获取服务端提供的服务器列表。它们不会必然同步发生。变更前保留备份，更新后查看日志并测试常用应用；若问题只在更新后出现，应记录发生变化的组件，避免一次性重置所有设置而失去线索。
Project VV2FlyXray开源客户端
关于本站与内容范围 →
近期文章
连接排障与进阶原理
配置问题先从现象入手，原理问题再回到协议与内核。下面三篇按最近发布日期排列：节点超时适合逐项排除连接链路，系统代理问题需要分开检查浏览器与终端，REALITY 与 Vision 则用于理解服务端参数为何不能随意省略。阅读时保留自己的日志上下文，不要把不同错误当成同一个问题处理。
V2Ray 节点超时连不上：从本地到服务端的排查顺序
按本机时间、订阅更新、内核日志、传输与 TLS 参数、服务端状态的顺序逐项排查节点超时，附 v2rayN 与 v2rayNG 中对应的查看位置。
查看超时排查步骤 →v2rayN 系统代理不生效：浏览器与命令行终端分开排查
浏览器不走代理多与插件和 PAC 有关，终端不走代理则要手动设置环境变量。按两条线分别检查，并说明 TUN 模式何时值得评估。
区分应用代理路径 →REALITY 与 XTLS Vision 原理科普：少一层加密为什么更快
拆解 TLS 套 TLS 的重复加密开销，解释 Vision 如何优化数据传输、REALITY 如何改变证书部署方式，并说明 flow 与公钥字段的含义及适用条件。
理解协议与传输参数 →