Windows
v2rayN 首推v2rayN 提供桌面版与经典 WPF 版。桌面版采用跨平台界面,适合希望在不同电脑上保持相近操作习惯的用户;WPF 版保留经典 Windows 交互,适合已有使用习惯的环境。选择时先看系统兼容要求,不必为了界面名称同时安装两套。
安装后先检查本地监听端口是否被其他程序占用,再导入连接资料。若浏览器曾手动填写代理,应确认它是否仍覆盖系统设置。两套界面的菜单位置可能不同,排错时以实际的代理模式、内核状态与日志内容为准,而不是只比较窗口外观。
工作台议程 / CLIENT SETTINGS
先区分流量怎样进入客户端,再决定连接怎样离开客户端。
客户端界面里的开关并不都对应配置文件中的同名字段。系统代理负责向应用提供入口,路由规则负责选择出站,订阅分组负责整理连接资料;内核则执行生成后的配置。把这几层分开看,遇到“已经启动却无法连接”时,就能按入口、规则、出站的顺序检查,而不是同时改动所有选项。下面五项是首次配置时最常用的工作台设置。
"listen": "127.0.0.1"
系统代理适合先用浏览器验证连接。选择自动配置后,遵循系统代理设置的应用会把请求交给本地入站;自行管理网络连接的应用仍可能直连。上面的监听地址属于内核入站配置,并不是系统代理开关本身。与逐个应用手动填写代理相比,这种入口便于统一启停,但不能代替路由分流。先核对实际监听端口,再测试网页;退出前清除系统代理,可避免应用继续访问已经停止的本地服务。
在配置参考里查看 →"routing": { "domainStrategy": "IPIfNonMatch" }
路由分流决定请求进入内核后交给哪个出站。规则按顺序匹配,命中后通常不再继续向下查找,因此具体域名规则应放在宽泛规则之前。示例策略会在域名规则未匹配时尝试解析地址,再进行相应的 IP 匹配;它并不意味着所有域名都会预先解析。与单一全局模式相比,分流能为不同目标保留不同路径,但也需要检查 DNS 与规则资源。调整后重新加载配置,并用同一目标复测,才能判断变化来源。
在配置参考里查看 →"outbounds": [ { "tag": "proxy" } ]
订阅分组用于在客户端中保存订阅地址、更新选项和来源标记,不是内核 JSON 的顶层字段。上面仅展示生成配置中的出站标签片段,不是完整可运行配置。与反复导入单条链接相比,分组更便于更新和定位来源,但更新也可能覆盖来源中的连接资料。建议将手动编辑的条目与订阅条目分开管理,更新后检查当前选择是否仍然有效。订阅地址可能携带访问凭据,截图或分享日志前应先移除相关内容。
在配置参考里查看 →"dns": { "servers": [ "localhost" ] }
Tun 模式通过虚拟网络接口接入流量,适合不读取系统代理设置的应用。它涉及系统路由、权限和 DNS 接管,不能仅凭一个开启状态判断是否工作。示例是 DNS 配置片段,并不是通用 Tun 开关,也不代表开启 Tun 后就应照抄。与系统代理相比,这种方式接入范围更广,但更容易与其他网络工具产生路由冲突。建议先在系统代理模式下确认出站可用,再按所用内核的要求启用,并保留关闭后恢复网络的操作路径。
在配置参考里查看 →"protocol": "vless"
多内核切换是客户端管理执行程序的能力,不存在一个适用于所有内核的统一顶层切换字段。示例只表示出站协议名称,能否使用还要同时核对传输、安全设置和内核实现。与只绑定单一内核的界面相比,多内核配置便于适配不同连接资料,也增加了排错时需要确认的变量。切换前记录当前内核与路由设置,切换后阅读启动日志;不要把协议名称相同理解为全部参数都兼容,也不要直接混用不同内核的整份配置。
在配置参考里查看 →安装包入口 / PLATFORM SELECTION
桌面使用 v2rayN,安卓优先了解 v2rayNG。
先确认操作系统与处理器架构,再选择安装包。客户端名称、界面类型和内核名称分别描述不同层次:界面负责配置管理,内核负责连接处理,安装包格式则决定系统如何安装。下载页集中列出各平台入口与适用说明;首次使用可以先保留默认设置,把导入、启动和浏览器验证这一条路径走通,再逐项增加分流或虚拟网卡配置。
v2rayN 提供桌面版与经典 WPF 版。桌面版采用跨平台界面,适合希望在不同电脑上保持相近操作习惯的用户;WPF 版保留经典 Windows 交互,适合已有使用习惯的环境。选择时先看系统兼容要求,不必为了界面名称同时安装两套。
安装后先检查本地监听端口是否被其他程序占用,再导入连接资料。若浏览器曾手动填写代理,应确认它是否仍覆盖系统设置。两套界面的菜单位置可能不同,排错时以实际的代理模式、内核状态与日志内容为准,而不是只比较窗口外观。
按电脑芯片选择 Apple Silicon 或 Intel 安装入口。在系统的“关于本机”中查看芯片或处理器信息,比根据购买年份推测更可靠。v2rayN 的桌面界面承担订阅和配置管理,系统代理授权、网络权限及内核运行仍需要分别确认。
首次打开时按照系统提示处理应用权限,不建议为了完成一次安装而长期降低系统安全设置。若连接只能在部分应用中生效,先查看这些应用是否读取系统代理;需要更广的流量接入范围时,再阅读 Tun 模式与系统路由的说明。
安卓优先选择使用 Xray 内核的 v2rayNG,使用 V2Fly 内核的 v2flyNG 作为备选。多数较新的设备适合 arm64 安装包;无法确认架构时,可查看下载页中的通用版说明。两款应用分别管理自己的资料,导入到其中一款不会自动同步到另一款。
启动连接时需要确认系统 VPN 授权,它表示允许应用建立本地虚拟网络接口,不等于已经连接到可用服务。后台频繁中断时,应检查电池优化和后台运行限制;部分应用需要绕行时,再设置分应用代理,并核对列表采用的是包含还是排除逻辑。
根据发行版的软件包体系选择 deb 或 rpm,再核对处理器是 x64 还是 arm64。图形桌面使用 v2rayN 时,还要留意桌面环境如何保存系统代理;同一台电脑上的浏览器、终端工具与后台服务,不一定读取同一组代理设置。
开始配置时可先让一个支持手动代理的应用连接本地入站,以便把桌面设置问题与内核连接问题分开。需要 Tun 时再处理虚拟接口权限和路由冲突。更换网络管理工具后,如果出现间歇断连,应同时检查 DNS 去向与默认路由是否发生变化。
快速上手 / FIRST CONNECTION
导入资料、选择入口、验证连接,每次只改变一层设置。
STEP 01 / IMPORT
客户端安装完成后,还需要准备有权使用的连接资料。订阅地址是用来获取一组条目的入口,单条分享链接则描述一个连接,两者不能当成普通网页地址随意混用。在订阅分组中添加地址并更新,或从剪贴板导入单条链接;完成后检查服务器地址、端口、协议及传输设置是否与来源一致。
不要把订阅链接贴到公开讨论区,也不要在求助截图中保留完整访问参数。导入后列表有内容,只能说明资料已被解析,并不代表服务端当前可用。若出现空列表,先核对复制内容是否完整、订阅是否需要更新,再处理代理模式,避免把资料获取失败误判成网络分流问题。
阅读导入步骤 →STEP 02 / MODE
选择准备使用的连接条目,启动内核,再启用适合当前应用的代理入口。首次验证可以从系统代理开始,让遵循系统设置的浏览器接入本地服务。路由模式决定请求接入后的处理方向,系统代理决定应用怎样交出请求,这两个选项解决的问题不同,不能用切换路由来弥补应用没有接入代理。
先保持默认路由和 DNS 设置,不急于开启 Tun 或导入大量自定义规则。如果电脑同时运行其他代理、VPN 或网络接管工具,先确认它们是否争用系统代理、监听端口或默认路由。需要对照配置文件时,重点查看入站地址与端口、出站标签,以及路由规则引用的标签是否一致。
对照路由配置 →STEP 03 / VERIFY
使用同一个浏览器、同一个测试目标进行访问,随后查看客户端日志是否出现对应请求。端口测试成功只表示某个连接环节可以建立,不等于完整代理链路已经可用;实际访问还涉及协议、安全协商、DNS 和路由。测试失败时,先读日志中的首个明确错误,再决定检查资料、服务端还是本地入口。
如果只有某个应用失败,优先比较应用的代理设置;如果所有请求都失败,再检查内核是否启动以及当前条目是否有效。修改一项后重复原来的测试,保留可工作的基线。准备提交排错信息时,可记录系统、客户端界面类型、所选内核及错误片段,但应移除订阅地址、用户标识和认证信息。
查看故障排查问题 →开源生态 / PROJECT V
客户端是操作界面,内核是连接引擎,协议是双方约定。
搜索“V2Ray 官网”时,容易把项目文档、内核发布和客户端下载页面混在一起。本站整理图形客户端的下载入口与中文使用说明,不作为协议或内核项目的官方发布主体。理解各项目的职责,有助于选对资料:安装问题看客户端说明,字段行为看对应内核文档,连接参数则以服务提供方给出的配置为依据。
Project V 生态中的 V2Ray 以入站、出站和路由等模块组织连接处理。入站接收本地或其他程序送来的请求,出站描述请求如何继续传输,路由把两者连接起来。这个结构解释了为什么“选择一个服务器”并不等于全部配置:还需要有可以接收应用流量的入口,以及把请求送往正确出站的规则。图形客户端把常用操作集中到窗口中,降低编辑门槛,但底层仍然遵循明确的配置关系。
阅读 JSON 时,可以先找出各模块的标签与引用,再查看协议参数。没有出现语法错误,也不代表路径符合预期;例如规则引用了错误的出站标签,或应用根本没有连接到本地入站,都可能表现为无法访问。配置参考按模块说明字段用途,适合在完成基本连接后逐段阅读,而不是一次替换整份正在工作的配置。
V2Fly 社区延续 V2Ray 的开源开发与维护;Xray 从相关代码基础发展为独立演进的内核项目,在协议、安全与传输能力上形成了自己的实现。两者共享部分概念和配置习惯,但并不是换一个程序名称就能完全互换。某条连接需要什么内核,应同时查看协议、传输方式和安全选项,不能只根据“V2Ray”这一类称作判断。
例如,看到 VLESS 协议名称时,还应继续确认是否搭配特定安全机制,以及所选客户端能否为当前内核正确生成对应参数。内核支持某项功能,不代表每种客户端界面都已经提供同样的编辑入口。遇到导入成功却启动失败的情况,先比较生成配置与内核要求,再决定调整条目或切换内核,通常比不断重新导入更有效。
v2rayN 面向桌面环境,提供连接资料管理、系统代理、路由及多内核配置入口;v2rayNG 面向安卓,主要结合 Xray 内核提供连接与本地 VPN 接入;v2flyNG 面向安卓,作为 V2Fly 内核路线的备选。三者均以开源项目形式维护,但客户端代码与所调用内核是不同的软件组件,各自的发布节奏、配置支持和许可范围需要分别理解。
v2rayN 与 v2rayNG 客户端采用 GPL 系列开源许可,V2Fly 与 Xray 内核采用 MPL 系列开源许可;具体适用范围以对应项目随附的许可文本为准。开源意味着代码与许可条件可以被审阅,不意味着任意订阅来源都可信。客户端也不附带可替代服务端的连接资源,实际可用性仍取决于连接资料、网络条件与服务端设置。
客户端更新可能调整界面、导入行为或配置生成方式,内核更新可能改变协议支持与字段行为,规则资源更新则可能改变目标匹配结果。它们影响的层次不同,因此不宜用“全部更新过了”代替排查记录。更新前保留可用配置与必要设置,更新后先复测原有连接,再启用新增功能;遇到行为差异时,逐层比较才容易定位原因。
同样,订阅更新只是从来源刷新连接资料,并不必然更新客户端程序、内核或本地自定义规则。分享问题时说明更新了哪一层,会比笼统描述“更新后失效”更有帮助。对于已有稳定工作配置的环境,可以先阅读变更说明,确认是否涉及当前协议和系统,再安排更新与验证,避免把多个变化叠加在一次测试中。
近期文档 / READING NOTES
基础连接建立后,再按实际需求补充知识。界面差异影响安装包选择,规则顺序影响流量去向,路由器部署则涉及整个局域网的网关与 DNS。以下文章分别展开这些问题,便于从单机配置继续阅读到更具体的应用环境。
对比两套界面的系统支持与操作差异,结合已有使用习惯和安装环境选择桌面版或经典 WPF 版,区分界面框架变化与内核功能支持。
阅读文章 →辨认域名、完整域名、正则和资源集合的匹配边界,理解规则从上到下的优先级,以及域名解析策略怎样影响后续 IP 匹配。
阅读文章 →从网关指向、透明代理与 DNS 接管理解部署架构,说明为什么单机客户端已经可用,并不代表旁路由上的所有设备都会自动经过相同路径。
阅读文章 →