Windows
选择 v2rayN。下载页提供桌面版与经典 WPF 版:桌面版使用跨平台界面,WPF 版保留经典操作布局。先选熟悉的界面,再根据包内说明完成安装或解压。把程序放在可写入的固定目录,避免在压缩包预览窗口中直接启动,否则配置保存与更新可能受影响。
首次运行后先导入一条可用配置,确认内核启动,再启用系统代理。如果提示端口被占用,检查是否同时运行了另一份客户端。安装与更新前保留配置备份,切换界面版本时也先确认原有订阅分组和路由设置是否完整。
前往下载设置入口 / CLIENT SETTINGS
先导入配置,再决定哪些流量进入客户端,最后调整流量的出站路径。这三件事分别对应订阅管理、代理模式和路由规则,不要把其中一个设置当成全部。
订阅地址用于批量获取服务器配置,分享链接通常只描述一条配置。在 v2rayN 的「订阅分组」中添加地址、填写便于辨认的备注,保存后执行「更新全部订阅」。如果拿到的是分享链接,复制后可从剪贴板导入。列表为空时先看更新日志,不要连续创建相同分组。与逐条手动填写相比,订阅能保留分组并集中更新;右侧是导入后使用的本地入站片段,不是订阅地址的格式。
查看订阅导入步骤 →{
"inbounds": [
{
"listen": "127.0.0.1",
"port": 10808,
"protocol": "socks",
"settings": {
"auth": "noauth",
"udp": true
}
}
]
}
需要浏览器使用本地代理时,在 v2rayN 选择「自动配置系统代理」。选择「清除系统代理」会移除系统中的代理设置;「不改变系统代理」则保留当前状态,不代表关闭内核。某些应用有独立的网络设置,需要在应用内填写本地地址与端口。与 TUN 接管方式不同,系统代理不会让每个应用自动进入代理。右侧展示 HTTP 入站片段,实际端口以客户端设置和启动日志为准,不要只凭示意值填写。
区分系统代理与内核运行状态 →{
"inbounds": [
{
"listen": "127.0.0.1",
"port": 10809,
"protocol": "http",
"settings": {}
}
]
}
先使用客户端提供的路由预设,再按具体需求添加规则。例如「绕过大陆(Whitelist)」用于让匹配的中国大陆目标走直连,其他连接按该预设的出站策略处理。自定义规则从上到下匹配,前面的宽泛条件可能遮住后面的精确条件。与系统代理相比,路由只处理已经进入内核的连接,不负责接管应用流量。右侧片段引用了 direct 出站标签及 geosite、geoip 数据,使用前需要确认对应出站和规则文件存在。
查看路由规则与匹配顺序 →{
"routing": {
"domainStrategy": "IPIfNonMatch",
"rules": [
{
"type": "field",
"domain": ["geosite:cn"],
"outboundTag": "direct"
},
{
"type": "field",
"ip": ["geoip:private", "geoip:cn"],
"outboundTag": "direct"
}
]
}
}
先确认普通代理可以连接,再开启「启用 Tun」。TUN 通过虚拟网络接口接管流量,通常需要系统权限,还会涉及路由与 DNS 设置;它不是给失效服务器增加连通性的开关。与只设置系统代理相比,TUN 可覆盖更多应用,但也更容易与其他虚拟网卡或网络工具产生冲突。启用后先测试浏览器,再测试目标应用。右侧是 sing-box 的 DNS 片段示意,并非完整 TUN 配置,实际生成格式取决于客户端采用的内核。
查看 TUN 的权限与排错顺序 →{
"dns": {
"servers": [
{
"type": "udp",
"tag": "dns-direct",
"server": "223.5.5.5",
"server_port": 53
}
],
"final": "dns-direct",
"strategy": "prefer_ipv4"
}
}
开启「允许来自局域网的连接」后,在另一台设备中填写电脑的局域网地址和实际监听端口,不要填写另一台设备自己的回环地址。电脑与设备需要处于可互通的网络,防火墙也要允许相应入站连接。与只监听本机相比,共享会扩大代理入口的访问范围,应仅在可信网络使用,并限制来源地址。右侧展示监听全部 IPv4 接口的 SOCKS 入站片段;访客网络隔离、电脑休眠和地址变化都会导致共享中断。
查看局域网共享与防火墙设置 →{
"inbounds": [
{
"listen": "0.0.0.0",
"port": 10808,
"protocol": "socks",
"settings": {
"auth": "noauth",
"udp": true
}
}
]
}
配置窗只展示相关字段,不能直接替代完整配置。图形客户端会组合入站、出站、路由和 DNS;刚开始使用时,优先在设置界面修改,每次只改一项,并记录修改前的值。
安装入口 / PLATFORMS
桌面设备优先选择 v2rayN,安卓设备优先选择 v2rayNG,需要 V2Fly 内核时再考虑 v2flyNG。先确定操作系统与处理器,再选择安装格式;不要仅凭文件名中的客户端名称判断安装包是否适用。
选择 v2rayN。下载页提供桌面版与经典 WPF 版:桌面版使用跨平台界面,WPF 版保留经典操作布局。先选熟悉的界面,再根据包内说明完成安装或解压。把程序放在可写入的固定目录,避免在压缩包预览窗口中直接启动,否则配置保存与更新可能受影响。
首次运行后先导入一条可用配置,确认内核启动,再启用系统代理。如果提示端口被占用,检查是否同时运行了另一份客户端。安装与更新前保留配置备份,切换界面版本时也先确认原有订阅分组和路由设置是否完整。
前往下载选择 v2rayN,并按芯片区分 Apple Silicon 与 Intel 安装包。可以在系统的「关于本机」中查看芯片或处理器信息,不能只根据电脑的购买年份推断。安装完成后从应用程序目录启动,遇到系统安全提示时先阅读具体原因,再按系统提供的方式处理。
系统代理与 TUN 的权限要求不同。先让浏览器通过系统代理完成访问,再评估是否需要 TUN。电脑从睡眠恢复、切换无线网络或使用其他网络工具后,如果访问异常,先检查系统代理地址和内核运行状态,不要立即删除订阅重装。
前往下载首选采用 Xray 内核的 v2rayNG;需要 V2Fly 内核时,下载页另有 v2flyNG 作为备选。现代主流设备通常选择 arm64,不能确定处理器架构时查看设备信息或选择通用版。两款应用的配置兼容性取决于内核,不应把某个客户端能导入等同于另一个客户端也能运行。
导入订阅后选择配置,再点击连接并确认系统的 VPN 授权。需要后台持续连接时,检查电池优化和后台活动限制。若应用切到后台后断开,先检查系统是否结束了进程;若前台也无法访问,再查看连接日志与订阅更新结果。
前往下载选择 v2rayN,再按发行版选择 deb 或 rpm,按处理器选择 x64 或 arm64。安装格式与处理器架构是两项独立条件,不能相互替代。使用发行版提供的图形软件安装器完成安装;若依赖不满足,先处理安装器给出的具体提示,再尝试启动客户端。
不同桌面环境对系统代理的读取方式可能不同,有些应用仍需单独配置 SOCKS 或 HTTP 入口。先在一个明确遵循代理设置的应用中测试,再扩展到其他应用。启用 TUN 前检查权限与已有虚拟网络接口,排错时先回到普通代理状态,减少同时变化的设置项。
前往下载查看全部客户端 →安装包入口与适用说明集中在下载中心。
操作顺序 / QUICK START
首次配置先使用默认路由与普通代理,暂时保留 TUN 和局域网共享的关闭状态。让基本连接成立后再增加功能,出现问题时更容易定位到具体环节。
在 v2rayN 打开「订阅分组」,添加订阅地址和备注,保存后执行更新。安卓端 v2rayNG 可从「订阅分组设置」管理地址,再回到主界面更新订阅。复制地址时检查是否夹带空格、换行或说明文字;分享链接应走剪贴板导入,不要当作订阅地址填写。
更新完成后应能在列表中看到导入的配置。如果列表仍为空,查看日志区分地址访问失败、内容为空和格式不受支持。订阅链接可能包含访问凭据,不要把完整地址发到公开讨论区。客户端只负责读取配置,并不自动提供订阅服务。
在列表中选择要使用的服务器配置,让客户端启动对应内核。桌面端需要浏览器使用代理时,选择「自动配置系统代理」;安卓端点击连接,按系统提示允许创建 VPN 连接。首次测试保持一条明确的使用路径,不要同时开启多个承担相同接管功能的工具。
此时先使用路由预设,不要直接粘贴整份网上配置。系统代理决定应用是否把请求交给本地端口,路由决定内核收到请求后如何选择出站。应用没有遵循系统代理时,反复更换路由规则通常不能解决接管问题,需要检查应用自身的网络设置。
用浏览器访问日常需要的页面,确认能打开内容,而不只看连接图标或测试结果。内核测试成功只能说明特定测试路径可用,不能代表所有应用和域名都正常。随后检查另一类目标是否按预期直连,确认分流策略没有把本地服务误送到代理出站。
遇到异常,按「内核是否启动 → 应用是否进入代理 → 路由是否命中 → DNS 是否正常」的顺序排查。连接超时、证书错误与域名解析失败对应的原因不同,应保留相关错误信息。需要分享日志时,先移除订阅地址、服务器认证信息和个人路径。
项目关系 / OPEN SOURCE
客户端是操作界面,内核负责协议连接与流量处理。选型时把这两层分开看,才能判断一个设置到底由哪个项目提供,以及为什么同一份分享链接在不同客户端中的表现可能不同。
Project V 是围绕网络代理工具形成的开源生态,V2Ray 是其中的重要组成。V2Fly 社区延续了 V2Ray 内核的开发与维护,Xray 则是从 V2Ray 演进出的另一条内核分支。两者共享部分概念与配置结构,但后续支持的协议特性、传输方式和字段会发生变化,不能把名称相近理解成配置完全一致。
VMess、VLESS 等是协议名称,WebSocket、gRPC 等属于传输方式,TLS 则涉及连接的传输安全设置。导入一条配置时,这些参数要与服务端对应。协议名称正确,并不意味着传输路径、服务器名称和端口也正确;排错时应按字段检查,而不是把所有选项同时改动。
v2rayN 提供桌面端的订阅分组、服务器选择、系统代理和路由管理界面,并将设置交给相应内核执行。v2rayNG 是安卓端采用 Xray 内核的开源客户端,v2flyNG 则提供基于 V2Fly 内核的另一种选择。三款客户端均为开源项目,界面、打包与维护节奏各自独立,功能是否可用还取决于实际使用的内核能力。
选择时先看平台,再看已有配置依赖的协议与传输特性。桌面端优先从 v2rayN 开始;安卓端优先考虑 v2rayNG,需要 V2Fly 兼容行为时再评估 v2flyNG。不要仅因内核名称不同就认定连接速度存在固定差距,服务器线路、网络环境与配置通常更直接地影响访问结果。
开源意味着代码按相应许可证公开,允许的使用、修改与再分发条件由各项目许可证规定。V2Fly 的 V2Ray 内核与 Xray 内核采用 MPL 2.0,客户端及其依赖还可能采用其他许可。普通使用者主要关注功能与维护说明;如果要修改、打包或分发软件,应分别阅读客户端、内核及附带组件的许可文件。
公开代码便于社区讨论实现、提交问题和审阅改动,但它不能代替使用者对配置来源的判断。订阅提供方、服务器运营方和图形客户端承担不同角色。导入前应知道配置来自哪里,使用时也应了解连接将经过哪个服务器,不要把客户端的开源属性等同于第三方服务的信誉。
客户端更新可能调整菜单、配置生成方式、内核组件和规则数据。更新前备份订阅分组、路由与必要的自定义设置,并记录当前能正常使用的组合。更新后先测试既有配置,再尝试新增功能;如果基本连接失效,优先比较日志和设置变化,而不是重复导入同一批订阅。
订阅更新、客户端更新、内核更新与规则数据更新是不同操作。订阅更新用于刷新服务器配置,不会自动解决所有客户端兼容问题;路由数据过旧也不一定需要重装应用。日常维护时先确定需要更新的是哪一层,再使用对应入口,避免在尚未定位问题前扩大变动范围。
专题阅读 / ARTICLES
完成基本连接后,再按使用场景查阅专题。需要给其他设备共享入口时看局域网设置;导入失败时先辨认订阅格式;比较协议时关注实际配置要求,而不是只看名称。
从电脑的局域网地址、实际监听端口和防火墙入站规则入手,说明其他设备如何填写代理。并区分同网段可见、网络隔离与应用不支持手动代理几种情况,避免只打开共享开关却漏掉访问条件。
阅读文章 →从协议自身的加密、外层安全传输与时间要求解释差异。导入配置时应保留服务端给出的参数,不能仅把协议名称换成另一种就完成迁移;文章也说明为什么客户端的内核支持范围需要一起检查。
阅读文章 →辨认订阅内容、单条分享链接与完整内核配置的边界,了解编码还原和客户端导出各自能保留哪些信息。遇到格式不支持时,先确定输入类型,再选择导入入口,避免把完整配置直接贴进订阅地址栏。
阅读文章 →