V2Ray白话指南:
v2rayN 下载与配置说明

从开源客户端选择开始,把订阅导入与路由设置分开讲清。

图形客户端 v2rayN · v2rayNG · v2flyNG 内核家族 Xray / V2Fly 配置入口 订阅 / 分享链接
SETTINGS / 原文与白话

订阅、代理与路由,各管一段

导入成功不等于浏览器已经使用代理。先辨认设置项负责的环节,再调整参数,能少走很多重复操作。

订阅分组设置
别名:日常订阅
地址:https://example.com/sub?token=xxxx
启用更新:开启
白话说明

订阅是一份可更新的服务器配置清单,地址通常由服务提供方给出。把完整地址填入订阅分组,保存后执行更新,客户端才会读取其中的配置。它与单个服务器分享链接不同,也不是登录网页的地址。更新失败时,先检查链接是否完整、是否过期,再看获取订阅时使用的网络路径。不要反复删除已有分组,更不要把带有个人令牌的地址贴进公开截图。订阅只负责取得配置,后面的系统代理与路由仍需分别设置。

可以把整个过程理解成一条管道:订阅提供配置,客户端选定服务器,系统代理或虚拟网络接口接收应用请求,内核依据路由规则建立连接。任意一段没有完成,最终访问都可能失败。因此,看到服务器列表出现内容时,只能确认配置已经导入,不能直接推断整条链路可用。

首次配置建议保留默认参数,先完成最短路径的验证。不要同时改 DNS、路由、传输方式和网络接管模式,否则即使恢复连接,也很难知道是哪一项起作用。等基础连接稳定后,再按实际应用需求增加规则。陌生字段可以先到术语表查含义;明确的错误则交给帮助中心按现象排查。

CLIENTS / 按系统选择

四个平台的客户端下载入口

桌面选择 v2rayN,安卓优先了解 v2rayNG。先核对系统与处理器架构,再选择安装包;软件名称相近,安装包不能跨平台混用。

Windows

v2rayN 提供桌面版与经典 WPF 版。桌面版采用跨平台界面,WPF 版保留熟悉的 Windows 操作布局。新安装可以先了解桌面版;已有使用习惯时,再对照两种界面的菜单位置选择。导入订阅的基本思路一致,不需要为了换界面重新申请订阅。

安装前查看系统架构与安装说明。启动后先完成订阅更新,再选择服务器和系统代理。若退出客户端后浏览器仍提示代理连接失败,先查看系统代理是否已经恢复,不要直接把问题归到服务器。

前往下载

macOS

v2rayN 的 macOS 安装包按 Apple Silicon 与 Intel 芯片区分。可以在系统的“关于本机”中查看芯片或处理器信息,再选对应架构。安装包能够下载,并不代表系统已经允许应用启动,首次打开还可能需要处理系统安全提示。

系统代理与 TUN 需要的授权并不相同。先用常规代理方式确认订阅和服务器可用,再按需要授予额外网络权限。遇到启动拦截时,阅读具体提示,按照系统设置中的放行流程操作,不要随意关闭整套安全机制。

前往下载

Android

v2rayNG 使用 Xray 内核,是这里的安卓首推选择;v2flyNG 使用 V2Fly 内核,作为另一条配置路线。两者都提供 arm64 与通用安装包,较新的主流设备通常可先查看 arm64 选项,无法确定架构时再阅读下载页的选择说明。

首次连接出现系统 VPN 授权提示属于建立本地网络接口的步骤。允许后仍需选择有效的服务器配置。若锁屏后频繁断开,可检查系统对后台活动与电池使用的限制;不要把手机的省电策略误判为订阅失效。

前往下载

Linux

v2rayN 的 Linux 安装包按 deb、rpm 格式和处理器架构区分。先看发行版使用的软件包体系,再确认 x64 或 arm64。不要只因为文件能够打开就继续安装,包格式、架构和桌面环境的依赖都需要对应。

不同桌面环境对系统代理的读取方式可能不同,终端程序也不一定继承桌面代理设置。验证时先选一个明确遵循代理设置的应用,再逐步检查其他程序。若需要 TUN,继续查看平台指南中的权限与网络接管说明。

前往下载
查看全部客户端 →
QUICK START / 三步预览

从导入订阅到验证连接

客户端本身不附带可用的远端服务。开始前需要准备有效的订阅地址或分享链接,并确认它适用于所选客户端与内核。

  1. STEP 01 / 配置来源

    添加订阅分组,再执行更新

    在 v2rayN 中打开订阅分组设置,填写便于辨认的别名和完整订阅地址,保存后执行订阅更新。在 v2rayNG 中,通过订阅设置添加地址,再回到主界面更新订阅。粘贴前后留意空格、换行与截断,尤其不要把服务提供方的管理页面地址当成订阅地址。

    更新完成后检查是否出现预期的服务器配置。若列表仍为空,先看更新结果与日志;若已有旧配置,保留它作为对照。订阅令牌相当于访问配置的凭据,整理截图或寻求帮助时应隐藏完整地址,不要只遮住域名而留下查询参数。

  2. STEP 02 / 应用入口

    选定服务器,设置代理与路由

    桌面端先选定要使用的服务器,再设置自动配置系统代理,并从内置路由预设开始。安卓端选定配置后点击连接,按系统提示允许建立 VPN 接口。菜单名称会随界面调整,但“选配置”和“让应用请求进入客户端”始终是两件事,缺少后者时浏览器可能仍然直接连接。

    不要一开始就叠加多个网络接管方式。系统代理适合先验证常见浏览器,TUN 适合进一步处理不读取系统代理的应用,但会增加权限、DNS 与路由排查成本。局域网设备访问异常时,也应先检查绕过局域网的设置,而不是盲目换协议。

  3. STEP 03 / 逐项验证

    测试实际应用,再记录异常

    先访问一个日常使用、能够明确判断结果的网页,再测试目标应用。客户端内置的连通性测试只能说明测试条件下的结果,不能保证所有网站和应用都能正常工作。部分网站可能有自己的访问限制,单个网页失败不应直接推断整份订阅不可用。

    出现异常时记录时间、应用与错误现象,打开日志查同一时段的信息。先确认客户端仍在运行、本地入口正常,再检查 DNS、远端连接与握手。每次修改后重复相同测试,才能比较前后结果。完整步骤与平台差异放在教程中,首页只保留这条最短操作顺序。

查看完整教程 →
ECOSYSTEM / 客户端与内核

Project V、V2Fly 与 Xray 的关系

先区分项目、内核和图形客户端,再比较协议支持。名称之间有历史联系,但并不是同一个软件的三个皮肤。

Project V 是理解生态的起点

V2Ray 是 Project V 生态中的核心项目,围绕可配置的网络代理构建协议、传输与路由能力。用户日常操作的图形界面,通常是在这些能力之上提供服务器管理、订阅更新和设置入口。搜索“V2Ray 客户端”时,真正需要的往往是这样的图形程序,而不是直接编辑内核配置文件。

这一层区分很实用:界面里的一个勾选项可能影响客户端行为,也可能被转换为内核配置。订阅管理、窗口布局与系统代理开关主要属于客户端层;协议握手、出站连接和规则匹配则由相应内核执行。遇到问题时先确定属于哪一层,才能找到对应文档,避免拿另一款客户端的菜单名称逐字寻找。

V2Fly 与 Xray 是相关但独立的路线

V2Fly 社区延续 V2Ray 相关开发,Xray 则从相关代码基础发展为另一条内核路线。它们共享一部分概念与配置习惯,但功能演进、协议细节和字段支持并不完全同步。不能因为两边都能看到 VLESS,就认为任何相关配置都可以原样通用,更不能仅凭文件名判断兼容性。

选择内核时,应把服务端要求放在前面:协议是什么、使用哪种传输、是否需要特定安全机制、客户端能否完整导入这些字段。REALITY 等能力需要具体核对支持情况。若订阅已提供匹配客户端的导入方式,优先遵循其配置说明;不清楚的参数先查询协议与传输术语,不要根据名称猜测。

三款客户端都是开源图形工具

v2rayN 面向桌面使用,提供订阅管理、服务器选择及代理相关设置;v2rayNG 面向安卓,使用 Xray 内核;v2flyNG 同样面向安卓,使用 V2Fly 内核。它们的源代码按各自开源许可提供,具体使用和再分发条件以项目许可为准。开源描述的是代码与许可条件,不等同于远端服务的质量证明。

客户端可以免费获取,但订阅背后的远端服务是独立事项,服务提供方的账户、费用与可用范围不会因安装客户端而自动获得。订阅地址也不应交给不相关的网站代为解析。本站定位是客户端下载与配置说明,阅读教程时应始终区分“工具怎样工作”和“服务由谁提供”,两者的更新与故障来源并不相同。

界面、内核和规则文件分别更新

客户端更新通常涉及界面、导入逻辑与平台兼容;内核更新影响协议实现和运行行为;GeoIP、GeoSite 数据文件更新则改变部分路由规则依赖的数据。更新订阅只能刷新服务提供方给出的配置,不能替代这三类更新。路由异常时反复更新订阅,往往不会改变已经过期的规则数据。

调整前先保留可恢复的配置记录,更新后按原来的应用和网址重新验证。如果新界面的菜单位置变化,可以对照功能名称,而不是继续寻找旧截图的坐标。涉及较多平台差异时,阅读全平台指南;遇到明确报错时,先保存脱敏后的错误原文,再按照本地到远端的顺序定位。

READ NEXT / 资讯与操作说明

界面、权限与路由数据

基础连接完成后,再沿实际问题继续阅读。下面三篇分别对应找菜单、处理首次启动权限和维护分流数据,不需要一次改完所有设置。

v2rayN 主界面功能区速览:服务器列表、订阅分组、日志面板与设置入口

按区块走一遍 v2rayN 主窗口,说明服务器列表、订阅分组、底部日志、系统代理切换和参数设置分别管什么,新手看完即可找到常用操作。

v2rayN macOS 提示无法验证开发者:隐私与安全性放行及网络权限设置

针对 macOS 首次打开 v2rayN 被拦截的情况,讲清在隐私与安全性中放行、授予网络与系统代理权限的步骤,以及 TUN 模式需要的额外授权。

geoip.dat 与 geosite.dat 更新方法:路由规则数据文件用法详解

解释 GeoIP、GeoSite 两个数据文件在分流中的作用,演示在 v2rayN 和 v2rayNG 里更新规则文件,以及 geosite:cn 这类写法的含义。

查看全部文章 →