Windows
v2rayN 提供桌面版与经典 WPF 版入口。新一代跨平台界面与经典界面的菜单布局有所不同,导入订阅、选择服务器和设置系统代理的基本顺序相同。
先在系统设置中确认设备类型,再按下载页的适用说明选择。安装后保留配置位置,不要把不同界面的程序文件直接叠放到同一目录,以免后续排查时难以区分来源。
前往下载选择开源客户端,按中文步骤完成订阅导入与路由分流设置。
客户端设置示意 · 连接按钮打开入门指南
桌面使用 v2rayN,Android 优先了解 v2rayNG。先确认设备架构,再到下载页选择安装包,避免把客户端名称与内核名称混在一起。
v2rayN 提供桌面版与经典 WPF 版入口。新一代跨平台界面与经典界面的菜单布局有所不同,导入订阅、选择服务器和设置系统代理的基本顺序相同。
先在系统设置中确认设备类型,再按下载页的适用说明选择。安装后保留配置位置,不要把不同界面的程序文件直接叠放到同一目录,以免后续排查时难以区分来源。
前往下载v2rayN 按 Apple Silicon 与 Intel 芯片提供对应入口。在系统的“关于本机”中查看芯片信息,芯片架构与安装包架构应保持一致。
首次打开时按系统提示处理应用权限。启动客户端后,分别检查订阅内容与系统代理设置;浏览器能否使用代理,还取决于浏览器自身是否遵循系统设置。
前往下载v2rayNG 使用 Xray 内核,v2flyNG 提供 V2Fly 内核的备选路径。大多数较新的手机可先查看 arm64 安装包,设备架构不明确时再阅读通用版说明。
导入配置后,首次启动需要确认系统 VPN 授权。已有其他使用同类系统接口的应用运行时,应先检查是否冲突;后台连接中断则需要结合电池管理与后台运行权限排查。
前往下载v2rayN 提供 deb 与 rpm 软件包。先确认发行版的软件包体系,再核对处理器架构;桌面环境、系统依赖与应用自身的代理选项也会影响实际使用方式。
图形界面应用与终端程序可能使用不同的代理来源。完成客户端配置后,先验证一个遵循系统代理的应用,再单独设置需要代理的终端工具,不要只凭托盘图标判断流量路径。
前往下载客户端负责把配置转成可执行的连接设置。沿五个章节查看关键项,先弄清每一层的职责,再修改对应选项。
订阅地址用于获取一组服务器配置,不等同于某一条服务器分享链接。在 v2rayN 的订阅分组中添加地址并保存,再执行更新,检查列表是否出现可用条目。多个来源分别建组,便于更新与筛选。订阅内容可能包含访问凭据,不要发布到公开页面。更新后仍需选择活动服务器,并确认系统代理与路由设置。相比逐条手工填写,订阅更适合集中维护;能否成功解析仍取决于客户端支持的订阅格式。
系统代理决定应用是否把请求交给客户端,路由规则决定进入内核的请求如何出站。两层设置不能相互替代。开始时可先使用客户端提供的预设,再按域名、地址或应用需求细化规则。右侧示例只展示私有地址直连规则,使用前需要存在对应的直连出站标签。规则通常按顺序匹配,具体行为以所用内核为准。排查时先确认请求已经进入客户端,再检查命中的规则,避免反复切换模式却没有找到问题所在。
{
"routing": {
"rules": [
{
"type": "field",
"ip": ["geoip:private"],
"outboundTag": "direct"
}
]
}
}
图形客户端管理服务器、订阅与界面设置,内核执行连接、传输与路由。v2rayN 可管理多种内核,具体可选项以客户端提供的功能为准;v2rayNG 以 Xray 为基础,v2flyNG 对应 V2Fly。协议名称相同,也不代表所有扩展参数都能互换。导入配置遇到不支持字段时,先核对服务端要求与当前内核能力,再考虑切换。相比只按软件名称选择,按协议和传输参数判断更容易定位兼容性问题。
本地端口是应用访问代理内核的入口,不是远程服务器端口。仅供本机使用时,监听地址应设为回环地址,应用中填写的协议与端口也要和客户端一致。右侧是 SOCKS 入站片段,不是一份可直接连接远程服务器的完整配置。端口被占用时,先查清占用来源,再修改监听端口;浏览器扩展与终端工具的代理地址需要同步调整。不要仅为了让另一台设备接入,就在不了解访问控制的情况下扩大监听范围。
{
"inbounds": [
{
"tag": "local-socks",
"listen": "127.0.0.1",
"port": 10808,
"protocol": "socks",
"settings": {
"auth": "noauth",
"udp": true
}
}
]
}
跨设备迁移时,优先使用客户端支持的订阅或分享格式,不要直接覆盖整份应用数据。不同系统的代理接管方式、文件路径与权限不同,即使服务器参数一致,也需要重新确认本地监听与路由选项。桌面端先检查系统代理,移动端先确认连接授权与后台运行条件。迁移后用同一目标分别测试域名解析和实际请求,再判断差异来自配置还是运行环境。统一服务器来源有助于管理,但不意味着所有平台的界面和功能完全相同。
订阅导入解决的是服务器参数从哪里来,路由分流解决的是请求向哪里去,本地监听解决的是应用如何接入。这三类问题应分开记录。遇到连接异常时,先说明发生在哪一层,再查看对应设置,比同时更改多个开关更容易得到可复现的结果。
配置文件中的 inbounds 定义入站,outbounds 定义出站,routing 负责匹配与分配。DNS 和策略项又会影响解析与连接行为。界面生成的配置可能随内核不同而变化,示例片段不能直接拼成通用配置。需要逐字段阅读时,可继续查看V2Ray 配置大全。
安装客户端只是准备工作。还需要有效的服务器配置,以及与应用行为一致的代理设置。按顺序完成一次验证,再添加自动更新或自定义规则。
从可信来源取得订阅地址,在订阅分组中添加并更新。更新结束后检查服务器条目的协议类型与分组归属,再选择一个活动服务器。单条分享链接应使用对应的导入入口,不要误填为订阅地址。
如果列表为空,先看客户端提示,检查复制时是否带入多余空格、地址是否完整、订阅是否仍有效。此时还没有进入连接阶段,切换路由模式通常不能修复订阅格式错误。
桌面端检查系统代理选项,并选择适合当前需求的路由预设。Android 按系统提示授权连接。确认本地端口能正常监听后,再进行访问测试;启动报错时先读取日志中的首个具体错误。
“全局”通常描述路由处理范围,不代表所有应用都会自动进入客户端。某些应用使用独立代理设置,终端工具也可能依赖环境变量。接入方式与分流方式要分别确认。
用实际需要使用的应用打开一个目标页面,再结合客户端日志判断请求是否进入内核。测试延迟只反映某种探测结果,不能替代页面加载、下载或长连接等实际场景的检查。
确认可用后记录客户端、内核、本地端口与路由模式。后续调整一次只改一个因素,并保留原设置。测试完成后,若不再使用客户端,应同步检查系统代理是否恢复到预期状态。
区分项目、内核和图形客户端,才能判断一项功能应该在哪里查找。开源说明实现与许可方式,实际兼容性仍需要结合配置和运行环境确认。
理解 V2Ray 的模块化代理设计
执行协议、传输、解析与路由
管理订阅、服务器与应用设置
Project V 是理解 V2Ray 生态的起点。其配置思路把本地接入、远程连接与路由处理拆成不同模块,便于针对需求组合。V2Fly 社区延续了 V2Ray 的相关开发与维护,Xray 则从同一技术谱系发展出自己的实现。两者有共同背景,也有各自的功能演进方向,不能仅凭相近的配置外观判断可以直接替换。
对使用者而言,先认识入站、出站和路由三层关系,比记住全部字段更有帮助。协议是连接双方使用的约定,传输是承载连接的方式,TLS 等设置又属于另一层参数。排查时逐层核对,能避免把域名解析失败误判为协议不兼容,也能减少无效的内核切换。
v2rayN、v2rayNG 与 v2flyNG 都是开源图形客户端。v2rayN 面向桌面环境组织订阅、服务器与内核设置;v2rayNG 在 Android 上使用 Xray 内核;v2flyNG 为 Android 提供基于 V2Fly 的另一种选择。客户端界面中的选项由客户端实现,最终可用的协议与扩展能力还取决于内核。
开源项目通过各自的许可证约定使用、修改与再分发条件。客户端、内核与随附组件不一定使用相同许可证,需要分别阅读相应说明。查看项目背景有助于理解组件来源,但软件许可不等同于服务器服务条款,也不代表任何外部订阅的质量保证。
客户端更新可能调整菜单、配置存储方式或内核管理逻辑,内核更新则可能改变字段支持与默认行为。更新前先备份可用配置,记录当前路由与本地端口。使用自定义配置时,尤其需要关注字段变更,不要只确认程序能够打开就认为迁移已经完成。
更新后用同一应用、同一目标和同一路由模式做对照测试。如果出现差异,先检查日志与生成配置,再判断是否需要回退。订阅更新与客户端更新是两件不同的事:前者更新服务器列表,后者更新软件能力。保持这一区分,能够更准确地描述问题。
本站整理客户端入口、操作流程与配置参考,不提供服务器订阅。文档中的本地地址用于说明监听关系,JSON 片段用于解释结构,不含可直接使用的远程连接参数。实际部署时,应以当前客户端界面、内核文档和配置提供方要求为准。
使用网络工具时,应遵守所在地区的适用法律与网络服务规则。需要进一步了解字段含义时阅读配置大全,需要决定客户端时阅读客户端对比,项目背景与内容范围见关于页面。
从具体症状进入文章。节点选择、分组管理和应用代理分别对应不同的检查路径,先确定问题范围,再执行操作。
浏览器走了代理而终端没走,或者两边都不通?按浏览器扩展、系统设置、环境变量三条线分别定位原因。
阅读文章 →从实测延迟、流量倍率、出口地区和 VMess/VLESS/Trojan 协议类型四个维度拆解节点选择,避开只看单一数字的误区。
阅读文章 →同时使用多个服务商订阅时,用订阅分组隔离来源,配合过滤规则剔除说明性条目,让服务器列表保持清爽可控。
阅读文章 →