v2rayN中文网 v2rayN 客户端下载与配置教程

围绕订阅管理、路由分流与系统代理,按平台选择客户端,再逐项完成配置。

桌面:v2rayN 安卓:v2rayNG / v2flyNG 内核生态:Xray · V2Fly · sing-box

CONFIGURATION LAYERS

订阅、路由与内核设置

图形客户端负责整理配置,内核负责处理连接。把订阅来源、流量入口和出站规则分开检查,比同时修改多处设置更容易定位问题。

按来源管理订阅,不覆盖手动配置

订阅地址用于获取一组服务器配置,不等于单个服务器地址。在 v2rayN 中新建订阅分组,填写便于识别的备注,再粘贴完整地址并执行更新。不同来源分别建组,后续才能独立刷新、停用或排查。与逐条手工填写服务器参数相比,订阅更适合持续维护一批配置,但更新也可能移除来源已删除的条目。需要长期保留的手动配置应单独管理。遇到更新失败,先核对日志中的请求错误,再判断是否需要通过已有代理更新。

订阅分组设置
备注按来源命名
订阅地址填写完整链接
订阅更新
启用更新按分组设置
更新结果在日志中核对

按无法上网、订阅失败与 DNS 异常查阅排查手册 →

CLIENT DOWNLOADS

按操作系统选择客户端

桌面端选择 v2rayN;安卓端优先了解 v2rayNG,需要 V2Fly 内核时再考虑 v2flyNG。安装包架构与配置协议是两件事,先选对设备架构,再检查订阅兼容性。

Windows

v2rayN · Desktop / WPF

Windows 用户可在桌面版与经典 WPF 版之间选择。桌面版采用新一代跨平台界面,WPF 版保留经典桌面操作方式。两者都应先核对系统要求,再按自己的使用习惯选择;不需要为了导入同一份订阅同时运行两个实例。

已有配置时,先备份订阅分组、路由与个人设置,再更换客户端。安装后检查本地监听端口和托盘中的系统代理状态,避免浏览器仍指向旧实例。系统代理只影响遵循该设置的应用;单独配置过代理的程序,需要在程序内部核对入口。出现端口占用时应先关闭旧实例,而不是连续改动多个端口。

macOS

v2rayN · Apple Silicon / Intel

macOS 用户先在“关于本机”中确认芯片类型,再选择 Apple Silicon 或 Intel 安装包。把应用移入应用程序文件夹后再启动,方便后续管理。系统弹出安全提示时,应先确认文件来源和提示内容,再到“隐私与安全性”中处理对应的打开授权。

首次配置不要一次开启所有接管方式。先导入订阅、选择服务器,再设置系统代理并用浏览器验证。若浏览器可访问而其他应用失败,检查应用是否使用独立代理或忽略系统设置;若所有请求都失败,再查看内核日志和网络权限。退出客户端前清除不再使用的代理设置,可减少下次启动时入口状态不一致的问题。

Android

v2rayNG · Xray / v2flyNG · V2Fly

安卓端优先选择使用 Xray 内核的 v2rayNG;需要使用 V2Fly 内核配置时,可了解 v2flyNG。主流较新设备通常选择 arm64,无法确认设备架构时再查看通用安装包。两款应用是独立客户端,安装其中一款不会自动共享另一款的订阅与路由设置。

导入配置后,首次连接需要确认系统的 VPN 授权。连接状态表示本地接管已建立,并不等于远端服务器一定可用。后台容易断连时,检查电池优化、后台运行和省电策略;按应用分流时,还要确认目标应用是否包含在接管范围内。不要让多个同类 VPN 连接同时争用系统入口,排查时先保留一个活动连接。

Linux

v2rayN · deb / rpm

Linux 桌面用户按发行版的软件包体系选择 deb 或 rpm,再核对处理器是 x64 还是 arm64。包格式相同不代表所有发行版的依赖环境都相同,安装时仍应阅读包管理器给出的依赖提示。桌面快捷方式、托盘支持与系统代理入口,也可能随桌面环境而变化。

完成安装后,先手动启动并确认订阅更新和浏览器访问正常,再添加登录后自启动。图形桌面的系统代理通常不会自动传递给终端工具,终端或开发工具需要单独检查其代理设置。若窗口已打开但连接无法建立,优先查看内核是否启动成功、监听端口是否可用,以及配置目录是否具备正常读写权限,不要直接以提高运行权限代替排查。

查看全部客户端 →比较三款客户端的适用场景 →

FIRST CONFIGURATION

从订阅导入到连接验证

初次配置先建立一条可验证的连接,再增加自定义路由与其他接管方式。每次只修改一个环节,保留能够回退的设置。

STEP 01 / IMPORT

导入订阅,核对服务器条目

准备由配置提供方交付的完整订阅地址。在 v2rayN 的订阅分组设置中新增分组,填写备注与地址,保存后执行更新。若拿到的是单条分享链接,应使用对应的导入入口,不要把单条链接误填成订阅地址。安卓端在 v2rayNG 的订阅设置中完成同类操作,具体菜单名称以当前界面为准。

更新完成后,检查分组中是否出现预期的配置,再选择一个条目作为当前服务器。订阅只分发连接参数,并不附带服务器服务;免费客户端与订阅服务应分别理解。地址中可能包含访问凭据,不应贴到公开评论或截图中。若分组为空,先看更新日志,确认是请求失败、返回内容无法识别,还是来源本身没有可用条目。

STEP 02 / ROUTE

选择路由,设置应用流量入口

桌面端先选择适合当前网络的路由预设,再启用自动配置系统代理。路由预设控制进入内核后的请求如何出站,系统代理决定哪些应用把请求交给本地监听,两者不能互相替代。需要访问局域网设备时,应核对私有地址规则,避免把本地访问误送到代理出站。

初次配置可以先用遵循系统代理的浏览器验证,不必同时启用更多接管方式。安卓端则需要确认 VPN 授权,并检查按应用代理的范围。已有浏览器代理扩展、其他代理客户端或网络过滤工具时,应逐项检查是否发生入口冲突。暂时保留最少的活动配置,确认可用后再逐步恢复日常设置,比同时切换多个模式更容易找到差异。

STEP 03 / VERIFY

验证网页、DNS 与退出状态

连接后先打开常用网页,再访问一个应当直连的站点或局域网服务,分别验证代理路径和直连路径。不要仅凭托盘图标、连接按钮或一次测试结果判断全部功能正常。若只有特定域名失败,查看该请求命中的路由、解析服务器与解析结果;若所有站点都失败,先回到系统代理、本地监听和内核启动状态。

记录能够复现问题的应用、域名和发生时间,再对照日志中的错误。排查顺序保持从入口到出站:应用设置、本地端口、当前服务器、路由、DNS。每完成一次修改就重复同一项测试,避免结果无法比较。结束使用时清除系统代理或关闭对应接管方式,再退出客户端;如果退出后网页打不开,首先检查系统是否仍保留指向本地的代理地址。

PROJECT V / CORE / CLIENT

Project V 生态与客户端分工

客户端名称、内核名称和协议名称经常同时出现,但它们负责的事情不同。理解这三层关系,才能判断某项设置应在图形界面修改,还是需要查阅对应内核的配置说明。

Project V、V2Fly 与 Xray

Project V 是围绕代理通信与网络配置形成的开源项目生态,V2Ray 是其中广为使用的核心项目。V2Fly 延续相关社区维护,Xray 从这一技术谱系发展出独立的实现与扩展。它们具有部分共同概念,但支持能力、字段含义和更新节奏并不完全相同。看到一份标为 V2Ray 的教程时,仍需确认示例面向的具体内核,不能仅凭名称相近就直接套用。

VMess、VLESS、Trojan 属于连接协议层面的概念,传输方式与安全层又是另外的配置维度。协议被客户端列出,不代表任意字段组合都能工作;客户端是否能够导入、内核是否支持,以及服务端参数是否匹配,都需要分别满足。排查握手或配置加载错误时,保留原始参数含义比反复切换协议名称更重要。

三款开源客户端的边界

v2rayN 面向桌面环境,提供订阅、服务器、路由和系统代理的图形管理入口,并支持对接 Xray、sing-box 等内核。v2rayNG 面向安卓设备,使用 Xray 内核处理连接;v2flyNG 同样面向安卓设备,提供基于 V2Fly 内核的另一种选择。三款客户端均为开源项目,但不是同一应用在不同设备上的简单改名,界面操作、导入支持和后台行为存在区别。

客户端负责把用户设置组织成内核能够理解的配置,内核负责协议处理、路由与实际连接。sing-box 有自身的配置结构,不应把 Xray JSON 原样当成它的配置使用。选择客户端时,先看操作系统与当前配置需求,再看界面和维护习惯。频繁更换客户端不能解决订阅源失效或服务端参数不一致的问题。

开源协议与配置来源

开源意味着项目代码按相应许可证公开,使用、修改与再分发仍需遵守各自的许可条件。客户端、内核及其依赖可能采用不同许可证,具体应阅读对应项目随附的许可文件。代码公开不意味着所有分发文件、订阅来源和网络环境都具有相同的可信度,也不意味着所有配置默认适合当前设备。使用者仍需了解安装来源与配置内容。

这三款客户端可免费使用,但运行客户端与取得远端服务是独立事项。订阅地址中可能含有账户标识,服务器配置也可能包含认证信息。分享排查日志前,应移除订阅地址中的敏感参数、认证字段和个人访问记录。文档中的配置片段只用于解释结构,不能替代由服务提供方交付的有效连接参数。

社区维护与更新顺序

客户端与内核由各自社区持续维护,界面调整、协议支持和配置兼容性可能分别变化。更新前先阅读变更说明,备份订阅分组、自定义路由和必要的个人设置。更新后先确认客户端能正常启动,再验证内核加载、订阅更新、常用网页和局域网访问。不要把软件更新、订阅刷新与路由重写合并成一次操作,否则出现问题时很难区分原因。

当前配置稳定可用时,可以围绕实际需求安排更新,而不是只比较名称或发布时间。遇到教程中的菜单与界面不同,先按设置对象查找对应功能,再核对客户端与内核的文档。本站提供下载选择和中文配置说明,不提供订阅账户或远端服务器;连接可用性仍取决于本地网络、服务器状态以及双方参数是否一致。

查看 v2rayN、v2rayNG 与 v2flyNG 的横向评测 →

CONFIGURATION NOTES

近期配置与排查文章

从具体症状进入文档。先确认请求经过哪个入口,再沿解析、规则和出站逐层检查,不把单个错误笼统归结为客户端问题。

进阶配置

V2Ray DNS 设置详解:境内外分流解析与防污染配置

讲解 V2Ray dns 模块的 servers、domains 与 expectIPs 写法,说明境内域名走本地解析、境外域名走远端解析的分流思路,以及防污染的实用配置。

重点区分“域名交给谁解析”与“连接经哪个出站发出”。域名规则、解析结果筛选和 IP 路由并非同一环节。修改前先记录当前解析路径,再用同一域名复测,避免仅更换解析服务器却没有改变实际请求路径。

阅读文章 →
故障排查

v2rayN 显示已连接却打不开网页:逐项排查清单

代理已开启但网页加载失败时,按系统代理状态、端口占用、节点可用性、时间同步、路由模式与 DNS 的顺序逐项核对,定位问题所在。

连接图标只能说明部分本地状态。文章从应用是否把请求交给客户端开始,逐步排除监听、远端连接与解析问题,并说明每一步应观察的结果。保留同一个测试目标,能更清楚地判断一次设置变更是否真正生效。

阅读文章 →
进阶配置

V2Ray 配置文件 JSON 结构拆解:inbounds、outbounds 与 routing 各段含义

逐段解读 V2Ray 配置 JSON:log、inbounds 本地监听、outbounds 出站与 freedom/blackhole、routing 规则匹配顺序,配合可对照的示例片段。

适合已经使用图形客户端、希望进一步理解生成配置的用户。先建立入站接收、路由匹配、出站处理的完整关系,再阅读具体字段。尤其注意 tag 引用与规则先后顺序,避免语法有效却没有命中预期出站。

阅读文章 →

查看全部文章 →