添加订阅
订阅地址 https://example.com/sub?token=xxxx 确定订阅导入
先保存地址，再获取配置内容。
设置批注工作台
v2rayN 配置的五个入口
订阅负责提供配置，系统代理负责接入应用，路由负责选择出口。这几项各有作用，不必在初次启动时全部改动。先完成订阅更新与浏览器连接，再按具体应用的需求补充规则，可以减少同时修改多个设置带来的排查困难。
下面的窗口是静态设置示意，不是可直接操作的客户端。切换标签可查看设置用途；实际菜单名称与位置可能随客户端界面调整，操作时应结合所用客户端的设置页确认。
添加订阅
地址（URL）· 教学示例 https://example.com/sub?token=xxxx 确定订阅导入适合集中管理由服务提供方发布的配置。在「订阅分组设置」中添加分组名称与完整地址，保存后执行「更新全部订阅」，再从列表选择需要使用的配置。与逐条粘贴分享链接相比，订阅分组便于后续同步变更；但更新结果仍取决于地址是否有效、网络是否可达以及服务是否到期。地址中的令牌通常代表访问权限，不应放入公开截图，也不要提交给来源不明的转换页面。更新后列表为空时，先查看更新日志，不必反复重新安装客户端。
- 自动配置系统代理
- 清除系统代理
- 不改变系统代理
系统代理模式用于把遵循系统设置的应用指向本机代理端口。初次验证浏览器时，可选择「自动配置系统代理」；「清除系统代理」用于移除系统中的代理指向；「不改变系统代理」则保留已有设置，不等于自动关闭代理。与 TUN 接管网络流量的方式不同，系统代理是否生效取决于应用是否读取这些设置。终端、游戏或单独配置代理的浏览器可能需要另行设置。排查时先确认客户端内核正常运行，再检查应用自己的代理选项，避免把接入问题误判为配置不可用。
私有地址直连
geoip:private→direct
路由规则根据域名、地址或其他条件选择直连、代理或阻断出口。示例中的 geoip:private 用来匹配私有地址，direct 表示直连，有助于保留局域网设备的访问路径。与把所有目标送往同一出口相比，分流需要同时考虑规则顺序、域名解析和默认出口。建议先使用适合当前需求的预设，再补充少量明确规则；每次修改后分别访问一个目标网站与一个局域网服务。若只有某个网站异常，应优先检查它匹配到的规则，而不是立即修改全部 DNS 或切换所有配置。
流量接入
启用 Tun 模式
Tun 模式设置 →
TUN 模式通过虚拟网络接口接入流量，可用于处理不读取系统代理设置的应用。它与系统代理的差异在于接入层级，并不意味着每个目标都会走代理，最终出口仍由路由决定。桌面端启用前应确认相应权限，Windows 通常需要管理员权限；同时留意其他虚拟网络接口与网络工具。建议在普通系统代理已能连接后再尝试 TUN，避免同时排查两种接入方式。开启后若局域网访问或域名解析异常，先停用 TUN 对照测试，再检查私有地址规则与 DNS 设置。
Core 类型
- Xray
- V2Fly
客户端负责界面与配置管理，内核负责执行实际的网络连接。内核切换适用于处理协议、传输方式或特定设置的兼容性问题，而不是所有连接失败时都必须执行的步骤。Xray 与 V2Fly 属于相关但分别演进的项目，支持范围需结合实际发布说明判断；客户端中的可选项也受安装内容影响。切换前记录当前设置，确认目标内核能够处理现有配置，随后重新启动连接并查看日志。若错误来自订阅地址、系统代理或服务端状态，单纯更换内核通常不能消除根因。
安装包选择
按操作系统选择客户端
桌面系统使用 v2rayN，安卓设备优先查看 v2rayNG，需要 V2Fly 内核时再考虑 v2flyNG。先确认系统与处理器架构，再进入下载页选择对应包型。桌面安装包不能直接用于手机，订阅地址则需要由服务提供方确认是否适用于目标客户端。
下列入口均进入下载页的对应平台，不直接触发文件下载。下载页集中说明包型、安装条件和客户端差别，适合在更换设备或首次安装前核对。客户端可以免费使用，但它只是配置与连接工具，安装后仍需准备有效的配置或订阅。
Windows
桌面版采用跨平台界面，适合从统一的界面流程开始使用；经典 WPF 版保留熟悉的桌面操作布局。两种入口都以管理订阅、选择配置和调整路由为主要用途，应根据系统条件与操作习惯选择，而不是把两种界面误当作两项必须同时安装的组件。
安装前确认系统架构与下载页中的运行要求。日常浏览器接入可先使用系统代理；只有应用不遵循系统设置时，再评估 TUN。更换界面版本前先保留必要配置，尤其是订阅分组、个人路由和端口设置，避免覆盖已有的使用环境。
macOS
先在「关于本机」中查看芯片信息，再选择 Apple Silicon 或 Intel 对应入口。包型与处理器匹配是安装的第一步，不应仅凭设备外观或购买年份判断。启动后先完成订阅导入，选择配置，再检查系统网络设置中的代理是否已按预期写入。
若系统提示需要确认应用来源，应先核对取得安装文件的渠道，再按系统说明处理，不要为了启动客户端而关闭整体安全机制。系统代理与应用自己的代理设置也可能同时存在；出现只有某个浏览器异常时，优先核对浏览器扩展及其连接方式。
Android
v2rayNG 使用 Xray 内核，v2flyNG 使用 V2Fly 内核，选择时应关注配置所需的协议能力。多数较新的手机可优先查看 arm64 包；无法确认架构时，可结合设备信息与下载页说明选择通用包。两款客户端是不同应用，不是安装后自动互相补充的内核组件。
导入订阅并更新后，选择一项配置，再启动连接。首次连接通常需要确认系统的 VPN 连接授权。若离开应用后容易断开，可检查电池优化与后台运行限制；这类系统行为与订阅是否有效是两回事，应分别测试，不必反复删除已经成功导入的分组。
Linux
Ubuntu、Debian 等发行版通常选择 deb 包，Fedora 等发行版通常选择 rpm 包，并进一步核对处理器架构。这里提供的是图形桌面客户端入口，适合需要通过窗口管理订阅与路由的桌面环境。安装包格式与发行版匹配后，还需留意桌面环境和运行依赖。
系统代理能否影响目标应用，与桌面环境和应用读取代理设置的方式有关。浏览器已经可用而终端仍直连时，先检查终端工具自身的代理配置，不要直接判断安装失败。开机启动、登录后启动与需要权限的网络功能也应分开设置，避免启动顺序影响连接。
快速上手预览
从订阅导入到连接验证
首次配置可以保持简单：一份有效订阅、一个已选配置、一种明确的流量接入方式。先建立可复现的连接，再添加自动更新、个性化分流或 TUN。这样遇到问题时，能够判断是新设置产生影响，还是原本的连接条件已经变化。
查看完整教程 →-
添加分组，执行订阅更新
在桌面客户端的订阅分组设置中添加名称与地址，保存后更新订阅。安卓客户端可在订阅设置中完成相同的准备，再执行更新。订阅地址与单个配置分享链接用途不同，不应只根据链接看起来很长就判断导入入口。完成后检查列表是否出现配置，并确认没有更新失败提示。
如果地址能保存却取不到内容，先检查复制时是否多出空格、换行或漏掉参数，再查看服务状态与更新日志。不要在此阶段同时修改路由、DNS 和内核设置，否则很难确认真正生效的是哪一步。
-
选择配置，确定接入方式
从更新后的列表选择一个配置作为当前使用项。桌面端先启动内核并使用自动配置系统代理，安卓端启动连接并确认系统授权。系统代理与路由模式不是同一个选项：前者解决应用请求如何进入客户端，后者决定进入后的请求走哪个出口。
先保留已有的常规路由，不必为了首次测试逐条添加规则。若正在运行其他代理或虚拟网络工具，应先确认它们是否改写了相同的系统设置或占用了本机端口，再决定是否暂时退出对照测试。
-
分别验证网页与其他应用
打开一个明确需要经过所选出口访问的目标，同时检查普通网页与局域网服务是否仍能正常访问。客户端显示启动成功，只能说明本机进程已运行，不能单独证明远端连接成功。需要结合实际访问结果与日志判断，不要把一次测试结果当作所有应用都已接入的证明。
浏览器成功而终端失败时，重点检查终端是否读取系统代理；所有目标都失败时，回到内核日志和配置可用性；只有域名失败时，再看解析路径。验证稳定后再设置自动启动，并记录能够正常工作的接入方式。
客户端、内核与开源生态
Project V、V2Fly 与 Xray 的关系
理解客户端与内核的分工，有助于读懂安装说明和错误日志。界面上出现同一种协议名称，并不意味着不同客户端的所有选项完全一致；同样，安装了图形客户端，也不表示已经具备有效的远端服务。选择工具时，应把界面、协议能力和配置来源分别确认。
生态背景
Project V：代理协议与工具的背景
Project V 是理解 V2Ray 相关工具时常见的生态背景，围绕代理协议、传输方式、路由和配置形成了一系列工具。日常所说的「V2Ray 客户端」常泛指能够管理相关配置的图形应用，并不必然指向同一个安装程序。桌面端与安卓端的界面不同，但都需要把用户选择的配置交给实际执行连接的内核。
因此，订阅导入教程可以有相近的操作顺序，具体设置却应以目标客户端为准。遇到协议名称、传输方式与加密参数时，不应仅凭其他应用中的同名选项照填。先确认服务端要求，再核对客户端与内核是否支持对应组合，比尝试大量不相关的开关更有效。
内核家族
V2Fly 与 Xray：分别演进的实现
V2Fly 维护 V2Ray 相关实现，Xray 则是从相关技术基础发展而来的另一条内核路线。两者共享部分协议背景，但功能支持、设置字段和演进节奏并不完全相同。看到「使用 Xray 内核」或「使用 V2Fly 内核」时，应将其理解为连接执行层的差别，而不是界面风格或服务质量的保证。
是否需要切换内核，应由配置需求决定。例如，日志提示某个字段无法识别、传输组合不受支持时，才需要进一步核对兼容性；若只是系统代理没有写入或订阅更新超时，应先检查接入与网络路径。内核能够解析配置，也不代表服务端当前一定在线。
三款开源客户端
v2rayN、v2rayNG 与 v2flyNG 的分工
v2rayN 面向桌面环境，提供订阅、配置选择、系统代理与路由等管理入口；v2rayNG 面向安卓设备，使用 Xray 内核；v2flyNG 同样面向安卓设备，提供 V2Fly 内核路线的选择。三款客户端均以开源方式发布，实际适用性仍要结合设备、配置要求和所用发布内容判断。
开源协议说明的是软件使用、修改与分发的条件，不是订阅服务的套餐说明。客户端、内核及附带组件可能分别遵循各自许可证，涉及再分发或二次修改时，应阅读对应的许可证文本。普通使用者可以先关注系统要求与操作流程，无需为了导入订阅而学习构建或修改源码。
更新与配置维护
区分软件更新与订阅更新
软件更新用于调整界面、修复问题或更新功能支持；订阅更新用于重新获取服务提供方发布的配置。二者不是同一操作。订阅内容发生变更时，通常先更新对应分组；遇到明确的客户端兼容性问题时，再阅读发布说明并评估软件更新。不要把重新安装作为所有故障的第一步。
更新软件前，先保留个人路由、订阅分组与必要设置，留意敏感地址的存储位置。更新后按原来的接入方式重新验证浏览器、其他应用和局域网访问，再逐步恢复个性化选项。对版本差异、日志含义或常见设置仍有疑问，可继续查阅常见问题与按症状组织的故障排查指南。
配置专题
协议、系统代理与 DNS 排查
完成基础连接后，再按实际遇到的问题阅读专题。协议说明帮助辨认配置类型，系统代理排查区分浏览器和终端的接入方式，DNS 专题则关注域名解析请求的实际路径。每次调整后使用相同目标复测，才能判断设置变化是否有效。
V2Ray DNS 泄漏检测方法与 v2rayN 防泄漏配置实操
先用检测结果确认解析请求从哪里发出，再区分本地 DNS、远程 DNS 与 TUN 下的 DNS 劫持。调整后重新测试，避免只改一个选项就把所有解析结果视为预期行为。
VMess 和 VLESS 有什么区别：选节点前的一分钟协议科普
从协议职责、时间要求与传输搭配理解 VMess 和 VLESS。先学会辨认分享链接及配置字段，再判断客户端是否具备所需支持，不把协议名称直接等同于连接表现。
v2rayN 系统代理不生效排查：浏览器与终端分开定位
浏览器异常时检查系统代理、扩展与 PAC；终端异常时检查环境变量及工具自己的代理配置。通过分别验证接入路径，判断问题位于应用设置、本机端口还是远端连接。