Windows
v2rayN 提供桌面版与经典 WPF 版。桌面版采用跨平台界面，WPF 版保留经典操作方式；先看系统要求，再按使用习惯选择。
前往下载 →CLIENT SELECTION
客户端下载与平台选择
先确认操作系统与处理器架构，再选择安装包。桌面使用 v2rayN，安卓优先选择 v2rayNG；已有 V2Fly 配置时，可了解 v2flyNG。客户端负责管理配置，实际连接仍需要有效的服务器信息。
macOS
选择 v2rayN 桌面版。先在“关于本机”确认芯片类型，Apple Silicon 与 Intel 分别对应不同安装包，不按设备外观判断。
前往下载 →Android
首推采用 Xray 内核的 v2rayNG，v2flyNG 作为 V2Fly 内核备选。通常先看 arm64 安装包，架构不确定时再查看通用版说明。
前往下载 →Linux
使用 v2rayN 桌面版，按发行版选择 deb 或 rpm，再区分 x64 与 arm64。安装格式和处理器架构是两项独立条件，都要对应。
前往下载 →安装包只决定客户端能否在当前设备运行，并不决定服务器使用哪种协议。已有订阅时，先确认订阅说明要求的内核与协议，再处理安装包选择。不要把另一种桌面架构的安装失败，误认为订阅失效。
查看全部客户端 →CONFIGURATION WORKSPACE
客户端功能与配置层次
订阅决定服务器来源，路由决定流量去向，内核决定配置能否执行。先分清这些层次，再调整具体设置。下方片段用于解释字段，不是可以直接覆盖现有配置的完整文件；图形界面的菜单名称可能随客户端调整。
订阅导入与分组管理
订阅链接用于获取服务器配置，不等于单个服务器的分享链接。在客户端中按来源新建分组，填入订阅地址后执行更新，再检查返回结果。相较于逐条手工添加，订阅便于集中维护连接参数；但本地修改的条目可能在下次更新时被重建。建议用清楚的分组备注区分来源，先完成一次手动更新，再设置自动更新。订阅内容包含连接凭据，排查问题时应隐藏完整地址，不要把它放进公开截图。
local-inbounds.json
{
"inbounds": [
{
"tag": "socks-in",
"listen": "127.0.0.1",
"port": 10808,
"protocol": "socks",
"settings": { "udp": true }
},
{
"tag": "http-in",
"listen": "127.0.0.1",
"port": 10809,
"protocol": "http",
"settings": {}
}
]
}订阅由客户端管理，不是通用内核字段。此处展示导入配置后可使用的本地入站结构，端口需与实际设置一致。
查看订阅导入步骤 →路由规则与匹配顺序
路由规则按顺序匹配，命中后交给指定出站。先放局域网与特定域名规则，再放范围较大的规则，最后处理其余流量。与只切换全局模式相比，分流可以分别安排直连、代理和拦截，减少互相影响。配置时先确认出站标签真实存在，再检查域名规则集与地址规则集是否可用。同一条规则里不同条件通常需要同时满足，不要把希望分别命中的条件误写在一起。调整后用日志确认命中的规则。
routing.json
{
"routing": {
"domainStrategy": "IPIfNonMatch",
"rules": [
{
"type": "field",
"ip": ["geoip:private"],
"outboundTag": "direct"
},
{
"type": "field",
"domain": ["geosite:cn"],
"outboundTag": "direct"
},
{
"type": "field",
"network": "tcp,udp",
"outboundTag": "proxy"
}
]
}
}片段依赖已有的 direct、proxy 出站与对应规则数据。兜底规则必须放在具体规则之后。
查看路由分流手册 →Xray 与 V2Fly 配置兼容性
内核负责协议处理与连接执行，客户端负责界面和配置管理。选择内核要看服务器协议及传输要求，而不是只看名称。使用 REALITY 与 XTLS Vision 时，需要支持相应功能的 Xray 配置链路；已有 V2Fly 配置则应核对目标内核的字段说明。两者共享部分配置概念，但不能据此认定所有字段可以互换。切换前保存原配置，切换后检查启动日志和实际连接，避免把字段不兼容误判为服务器故障。
outbound-tags.json
{
"outbounds": [
{
"tag": "direct",
"protocol": "freedom",
"settings": {}
},
{
"tag": "block",
"protocol": "blackhole",
"settings": {}
}
]
}这是两类内核常见的基础出站结构，不是内核切换指令，也不包含代理服务器出站。
阅读内核差异对照 →系统代理与虚拟网卡
系统代理适合遵循系统代理设置的应用；Tun 模式通过虚拟网卡接管流量，可覆盖部分不读取系统代理的程序。它不是路由规则的替代品，接管后的流量仍需决定直连或代理。启用前先确认普通代理连接可用，再授予所需权限，并检查是否有其他虚拟网卡或代理程序同时运行。安卓客户端通常通过系统 VPN 接口建立接管通道，与桌面的实现不能直接等同。出现异常时先关闭接管，恢复基础连接后再逐项排查。
routing-by-inbound.json
{
"routing": {
"rules": [
{
"type": "field",
"inboundTag": ["socks-in", "http-in"],
"network": "tcp,udp",
"outboundTag": "proxy"
}
]
}
}片段说明接管层与路由层的区别，不用于创建虚拟网卡。Tun 的具体配置由客户端及其配套组件决定。
了解代理模式选择 →DNS 解析与出站配合
域名解析把域名转换成地址，解析路径与连接路径需要一起考虑。直连域名可使用当前网络可达的解析服务，代理域名则需检查远程解析路径是否畅通。不要只替换一个 DNS 地址，就认定所有应用都采用了相同解析方式；浏览器安全 DNS、系统缓存与客户端内置 DNS 可能分别生效。建议先保留可工作的基础设置，再分开测试域名解析和目标连接。使用加密解析时，还要留意解析服务器自身域名的首次解析问题。
dns.json
{
"dns": {
"servers": [
{
"address": "223.5.5.5",
"domains": ["geosite:cn"]
},
"https://1.1.1.1/dns-query"
]
}
}解析服务地址只是示例。该片段不单独规定 DNS 请求的出站路径，需结合路由及当前内核行为检查。
查看 DNS 配置说明 →FIRST CONNECTION
首次配置的三个步骤
先建立一条能够验证的基础连接，再增加分流与接管设置。桌面主要使用 v2rayN，安卓主要使用 v2rayNG；两类界面的按钮位置不同，但导入、选择、连接与验证的顺序一致。
STEP 01
导入订阅并更新
在订阅管理中建立分组，粘贴完整订阅地址，保存后手动更新。若得到的是单条分享链接，应使用剪贴板导入或对应的分享导入功能，而不是填入订阅地址栏。
更新完成后，先看列表是否出现可选配置，再检查协议类型、端口与传输字段是否完整。列表为空时优先检查地址是否复制完整、订阅是否有效，以及当前网络能否访问订阅服务。反复重装客户端通常不能修复来源地址的问题。
STEP 02
选择配置与代理模式
选中需要使用的服务器配置，并确认其协议由当前内核支持。桌面初次使用可先启用系统代理，再选择适合当前需求的路由模式；安卓按系统提示授予 VPN 连接权限。
系统代理开关决定哪些应用会把请求交给客户端，路由模式决定客户端收到请求后如何转发，两者不能互相替代。先使用容易理解的默认设置，确认连接成立后，再添加自己的域名规则，避免同时调整多个选项而失去排查依据。
STEP 03
连接验证与退出恢复
启动连接后，分别访问一个预期直连的站点和一个预期代理的站点，结合客户端日志判断实际出站。单次连通测试只能说明某项测试通过，不能代表浏览器、下载程序与其他应用都使用相同路径。
若浏览器可用而其他应用失败，先检查该应用是否遵循系统代理。停止使用时，先关闭系统代理或虚拟网卡接管，再退出客户端；若退出后网络异常，应检查系统代理是否仍指向已经停止的本地端口，而不是立即修改全部网络设置。
首次排查顺序：来源 → 配置 → 接管 → 路由
查看完整教程 →
订阅更新失败、内核启动失败和应用连接失败属于不同阶段。记录出现问题的阶段，只修改与该阶段相关的一项设置，再重复同一个测试。这样可以保留有效配置，也能避免把 DNS、权限与服务器参数的问题混在一起。
PROJECT V ECOSYSTEM
开源生态与内核边界
V2Ray 是常见的生态称呼，不是一款界面完全相同的应用。理解客户端、内核与协议之间的关系，才能判断应该换安装包、改配置，还是检查服务器端要求。
Project V 与内核家族
Project V 以模块化网络代理工具为核心，配置通常涉及入站、出站、路由与 DNS 等部分。V2Fly 延续 V2Ray 相关内核的社区开发，Xray 则从相关代码基础发展出自己的协议与传输特性。两条路线有共同背景，也有各自的配置演进，不能把它们当成始终一致的可执行程序。
实际选型应从服务器要求出发：先确认协议，再确认传输方式与安全层，最后核对内核支持。比如 VLESS、REALITY 与 Vision 分别涉及不同配置概念，不能只看到其中一个名称，就推断整套连接已经兼容。客户端能够显示某个选项，也不代表服务器已经启用对应能力。
内核名称同样不是速度排名。连接表现还受服务器线路、目标站点、解析结果与本地网络影响。遇到问题时保留原有可用方案，用相同条件对比配置变化，比直接更换全部组件更容易得出可靠结论。
图形客户端与连接执行
v2rayN 提供桌面的配置管理界面，把服务器资料、订阅分组和路由选项组织起来，再交由配套内核执行。v2rayNG 面向安卓，采用 Xray 内核；v2flyNG 面向安卓，采用 V2Fly 内核。三款客户端都是开源项目，但界面功能、内核组合和平台集成方式并不完全相同。
桌面界面的跨平台覆盖，不代表系统权限与网络接管方式完全一致。不同系统的代理设置、虚拟网卡权限和软件包格式需要分别处理。配置迁移时，优先迁移明确的服务器参数或订阅来源，再核对本地端口、文件路径与系统相关选项。
客户端也不等于服务器服务。安装完成后仍需导入有效资料，订阅有效期、服务器连通性与客户端自身运行状态应分开判断。本站围绕客户端安装与配置组织文档，下载入口与入门步骤分别集中在对应页面。
开源协议与使用边界
开源意味着源代码按许可条件开放，便于社区阅读、研究和参与维护。V2Fly 内核采用 MIT 许可，Xray-core 采用 MPL 2.0 许可；图形客户端及其依赖仍有各自的许可要求。使用、修改或再分发时，应分别阅读目标项目与依赖组件的许可文本，不能用一个生态名称概括所有授权条件。
开源属性和服务器服务费用也是两件事。客户端可以免费使用，外部服务的计费方式、连接限制与使用期限则由服务提供方决定。不要因为客户端安装成功，就推断订阅一定可用，也不要把订阅服务的限制误认为客户端的功能限制。
连接资料属于敏感配置。分享日志时，应删除订阅完整地址、用户标识与认证内容，保留错误类型、涉及的配置层和可复现步骤即可。把问题描述清楚，比公开整份配置更有助于定位原因。
客户端更新与配置维护
界面更新、内核更新、规则数据更新和订阅更新是四类不同操作。界面更新可能改变菜单与默认行为；内核更新涉及协议实现及字段兼容性；规则数据更新会影响域名或地址集合；订阅更新则重新获取服务器资料。判断问题时，应先回想最近变动的是哪一层。
更新前保存订阅分组、必要的自定义规则及可用设置，更新后先验证原有基础连接，再启用新增功能。自动生成的运行配置可能在重启或保存时被覆盖，因此长期规则应尽量通过客户端提供的持久化设置入口管理，而不是只修改临时生成的文件。
配置维护建议保留一份简短记录：当前使用的内核家族、代理接管方式、DNS 策略以及自定义出站标签。记录不需要包含连接凭据，却能帮助区分“设置被覆盖”“规则未命中”和“服务器不可达”，也方便按照进阶手册逐章调整。
配置阅读顺序
先看入站如何接收应用请求，再看路由如何选择出站，最后检查出站的协议和解析路径。阅读示例时要区分完整配置与局部片段；只复制一段路由规则而没有对应出站标签，不能形成可执行的连接配置。
进入协议与进阶配置 →CONFIGURATION NOTES
配置专题与客户端选择
完成第一次连接后，再按遇到的问题深入阅读。模式选择、桌面界面差异和服务器配置选择分别对应不同决策，适合拆开理解，不需要在初次安装时同时掌握全部细节。
v2rayN 系统代理与路由模式详解：全局、绕过大陆、Tun 各适合什么场景
厘清系统代理开关与路由模式是两层设置，逐一说明全局与绕过大陆的分流逻辑，以及何时需要改用 Tun 模式接管全部流量。
适合解决“浏览器已经可用，其他应用却没有变化”这一类问题。先判断流量有没有进入客户端，再判断进入后匹配了哪条规则，避免只反复切换模式名称。
阅读文章 →v2rayN 桌面版（Avalonia）与 WPF 版区别：界面框架、平台覆盖与选择建议
对比两种界面框架构建的 v2rayN 在不同桌面系统上的可用性、外观与依赖差异，按系统给出下载哪个版本的建议。
适合下载前确认安装入口。界面框架影响操作体验与平台覆盖，但不应该被直接理解为协议名称；选择界面后，仍需检查配套内核和目标服务器的要求。
阅读文章 →V2Ray 节点怎么挑：延迟测试、流量倍率、地区与协议类型四步判断
解释客户端测延迟的含义与局限，说明倍率如何折算流量，并按用途给出地区与协议类型的选择顺序，帮助新手减少试错。
适合已经导入订阅、但不确定如何选择配置的阶段。测试结果只反映特定测试条件，应结合实际目标站点、连接稳定性和服务说明判断，而不是只依赖单项结果。
阅读文章 →专题文章用于解释某一个配置决策，连续操作步骤仍以入门指南为起点。需要管理多组订阅、自定义出站或更复杂的解析策略时，再转入进阶配置手册，逐项验证后保存设置。
查看全部文章 →