V2Ray 新手十问：内核、客户端、订阅与连接失败一次讲清
集中解答初学者最常问的十个问题：内核与客户端的关系、三款客户端怎么选、订阅怎么导入、全局与分流的区别，以及连不上时先查什么。
适合已经安装客户端、但还不能区分系统代理与路由模式的用户。先厘清配置由谁提供、流量由谁接收，再按顺序验证导入与连接；把术语对应到界面设置后，后续排查才有明确的起点。
阅读新手问题 →CONFIGURATION INDEX
按设置项查配置手册
先确认连接能建立，再逐项调整分组、分流与接管方式。配置片段用于解释字段，不是可以直接覆盖的完整配置文件。
订阅分组：分开更新地址与过滤条件
打开“订阅分组设置”，为每个来源建立独立分组，再填写完整订阅地址。分组名称用于识别来源，过滤条件决定哪些服务器进入列表，两者不要混用。首次更新先保持过滤条件为空，确认能读到内容后再按名称筛选。若更新后列表为空，先检查链接是否失效、响应是否为订阅内容，再检查过滤表达式。相比直接导入一批分享链接，订阅分组保留更新入口，后续可以单独刷新一个来源。分享日志前移除订阅地址中的访问凭据。
v2rayN → 订阅分组设置
添加分组 → 填写订阅地址 → 保存
订阅分组 → 更新当前订阅（不通过代理）路由规则：先核对顺序，再核对出站
在“路由设置”中先确认当前启用的规则集，再添加域名或地址匹配条件。规则按顺序判断，先命中的条目决定出站；把宽泛规则放在前面，可能让后面的精确规则失去作用。检查 outboundTag 是否指向实际存在的出站，不要只看界面上的备注。下面的片段仅展示一条阻断规则，依赖相应的 geosite 资源和 block 出站。与全局代理相比，规则分流能分别处理直连、代理与阻断，但需要定期更新规则资源，并对目标域名逐项测试。
{
"type": "field",
"domain": ["geosite:category-ads-all"],
"outboundTag": "block"
}DNS 设置：区分查询路径与连接路径
先区分系统 DNS、内核 DNS 与应用自己的加密解析，三者不一定走同一条路径。“DNS 设置”中的服务器地址决定内核向谁查询，而路由规则和出站策略决定查询如何发出。排查时先保留一个可达的解析器，记录目标域名与报错，再逐步增加分域名解析。不要把更换 DNS 当作修复所有连接问题的方法。下面是 V2Ray 系配置的局部示例；使用其他内核时应核对字段定义。相比只改系统解析器，内核 DNS 能参与路由判断，但仍取决于入站是否拿到域名。
{
"dns": {
"servers": ["https://1.1.1.1/dns-query"]
}
}TUN 模式：检查权限与路由接管范围
先用系统代理验证服务器可用，再启用“TUN 模式”。TUN 通过虚拟网络接口接收流量，适合不读取系统代理的应用，但是否接管目标连接还要看路由、排除项和内核实现。开启前检查管理员权限，暂时停用其他占用相同网络能力的工具；开启后分别测试网页、域名解析与局域网资源。下面是 sing-box TUN 入站字段片段，不可直接填入 Xray 配置。与系统代理相比，TUN 的接管范围更广，也更容易暴露回环和路由冲突，出现异常应先关闭接管再定位。
{
"type": "tun",
"auto_route": true,
"strict_route": true
}多内核切换：按配置能力选择执行内核
客户端界面与执行连接的内核是两层组件。打开“Core 类型设置”前，先确认目标协议、传输方式以及当前客户端提供的内核选项。切换后检查启动日志，确认配置生成成功，而不是仅凭菜单选中状态判断生效。Xray、V2Fly 与其他兼容内核的字段并非完全通用，自定义配置尤其需要逐项核对。相比更换整个客户端，在同一界面中切换内核可以保留熟悉的管理流程，但订阅能导入不等于每个服务器都能运行。遇到不支持的字段，应核对文档而不是反复重装。
v2rayN → 参数设置 → Core 类型设置
核对协议对应的 Core 类型
保存 → 重启服务 → 查看启动日志PROJECT V / V2FLY / XRAY
区分开源内核与图形客户端
下载客户端解决安装与管理问题，选择内核决定配置能力，导入服务器参数才具备建立连接的条件。这三个环节需要分别确认。
理解 Project V 与内核家族
Project V 是围绕网络代理工具及其能力形成的项目体系，V2Ray 是其中的重要组成部分。V2Fly 社区延续了 V2Ray 核心的开发与维护；Xray 则从相关技术基础发展出自己的内核与功能演进路线。它们共享部分协议概念与配置习惯，但不是同一个程序的不同界面。查阅“V2Ray 内核区别”时，应把支持的协议、传输组合、配置字段与客户端集成方式放在一起判断。
内核负责读取配置、接收入站连接、匹配路由并建立出站。图形客户端负责把订阅与设置转换成内核可理解的配置，并提供启动、停止、日志与系统集成功能。客户端名称中带有相似字样，不代表内核完全一致；同一款客户端也可能调用多种内核。核对实际启动的内核与日志，比仅凭应用名称判断兼容性更可靠。
协议名称描述连接双方如何交换数据，传输方式描述数据通过什么通道承载，安全参数则影响握手与身份验证。导入分享链接后，客户端会解析这些字段，但不会替服务器补齐缺失的配置。遇到无法连接，先检查服务器地址、端口、时间和握手参数，再判断是否属于内核能力差异，避免把所有错误都归因于软件安装。
按设备选择三款开源客户端
v2rayN 面向桌面使用，提供订阅管理、路由设置与多内核调用等功能。桌面版采用跨平台界面，经典 WPF 版保留另一套桌面界面与操作习惯。选型时先看系统与架构，再看需要的界面功能，不必因为名称相同就把两种发行形式装在同一目录。升级或迁移前备份订阅分组、路由和自定义配置，避免覆盖后难以恢复原有设置。
v2rayNG 面向安卓设备，以 Xray 内核为主要连接能力来源，利用系统 VPN 接口接收应用流量。v2flyNG 则是使用 V2Fly 内核的备选客户端。两者的界面与导入操作可能相似，但内核支持范围需要分别核对。移动端选择时，应先确认服务器配置与内核兼容，再检查分应用代理、后台运行和电池策略，而不是把客户端名字当作连接结果的保证。
这三款客户端均有开源项目背景。开源意味着源代码和相应许可可供查阅，不意味着任意修改后的发行文件都具有相同来源。阅读项目许可时，应区分客户端与其集成内核：V2Ray 核心采用 MIT 许可，Xray 核心采用 MPL-2.0 许可，客户端自身还遵循各自项目的许可条件。需要修改或分发时，应分别确认适用条款。
分开管理软件更新、订阅更新与规则更新
软件更新改变客户端或内核的执行能力，订阅更新刷新服务器参数，规则资源更新则影响域名与地址的分类匹配。这三种更新不是同一件事。订阅失败时重装客户端，通常无法修复已失效的链接；某条路由不命中，也不一定是服务器故障，可能是分类资源、匹配顺序或目标域名识别出了问题。先定位更新对象，再选择对应入口。
设置自动订阅更新前，先手动验证完整流程。确认链接可以访问、内容格式能识别、分组过滤条件正确，再根据来源的实际变更频率设置间隔。更新是否通过代理，应依据当前网络能否访问该订阅地址决定。不要在连接本身不可用时，让更新过程依赖这条连接；也不要把连续刷新当作修复证书报错的办法，应先检查系统时间与具体错误信息。
调整内核或规则资源后，保留一组固定测试目标：一个预期直连的域名、一个预期代理的域名，以及确实需要访问的局域网资源。对照日志观察是否命中预期规则。先确认结果，再继续修改 DNS 或启用 TUN，能减少多个变量相互影响。导出配置和分享截图时，移除服务器身份信息、订阅凭据及其他与排查无关的私人内容。
按连接链路阅读手册与排查日志
系统代理只向愿意读取该设置的应用提供代理入口，不会强制所有程序都采用相同路径。路由规则则是在流量进入内核之后决定出站，因此“全局代理”与“所有应用都被接管”不是同一个概念。浏览器正常而其他程序异常时，先检查程序是否使用系统代理，或是否需要单独填写本地代理地址，再考虑 TUN 接管，避免在错误的层面反复修改规则。
DNS 问题也要区分发生位置。应用可能先用系统解析器取得地址，内核也可能在路由匹配或建立连接时进行解析。日志中看到地址，不代表原始域名一定已被保留；开启流量嗅探也不意味着任何连接都能恢复域名。需要按域名分流时，检查入站、解析路径和 sniffing 配置之间的关系。涉及 FakeDNS 的配置应连同接管范围一起阅读，不能只替换一个解析地址。
阅读错误日志时，先记录操作时间、目标与错误类型，再定位到解析、连接、握手或路由阶段。连接超时与证书错误需要不同处理，内核无法启动与某个目标无法访问也应分开。本站把完整操作放在快速上手，把组合配置放在进阶手册；需要先判断问题所属层级时，可从FAQ 分类找到检查顺序，再返回对应设置页。
TECHNICAL NOTES
客户端安装与故障排查笔记
把单个问题拆成可验证的步骤。阅读前记录客户端类型、系统环境与触发条件，避免把其他平台的处理方式直接套用。
v2rayNG 耗电过快怎么办：电池优化白名单与后台常驻策略
分析 v2rayNG 在安卓上耗电偏高的常见原因，涵盖分应用代理、日志级别、厂商后台限制，并给出电池优化白名单与 VPN 常驻的设置建议。
先区分连接持续工作带来的消耗与后台反复重启。保留必要的系统权限，检查是否把不需要代理的应用也纳入接管，再根据日志定位异常重连；不要只为保持后台就同时关闭所有系统电池管理。
阅读耗电排查步骤 →macOS 安装 v2rayN：无法验证开发者提示与网络权限处理步骤
处理 macOS 上首次打开 v2rayN 时的“无法验证开发者”拦截，以及系统代理授权、TUN 模式所需权限和登录项设置，按系统设置路径逐步说明。
把首次打开的安全提示与运行后的网络权限分开处理。先确认安装来源，再查看系统给出的具体选项；仅在确实需要 TUN 接管时授予相应权限，不要把放宽整机安全设置作为通用安装步骤。
阅读安装与权限说明 →CLIENT DOWNLOADS
按操作系统选择客户端
先确认系统与处理器架构，再进入对应平台选择安装包。客户端提供本地配置与连接界面，服务器参数或订阅需要另行准备；安装完成不等于已具备可用连接。
Windows
v2rayN · 桌面版 / 经典 WPF 版
桌面版采用跨平台界面；经典 WPF 版保留熟悉的桌面操作方式。下载前查看系统支持条件，按需要选择其中一种发行形式。不要把两版程序与配置文件混放，迁移前先备份订阅分组和自定义路由。
首次启动后先导入订阅，选择一个服务器，再设置“自动配置系统代理”。浏览器能连接后，再检查需要单独设置代理的应用。只有在确实需要更广的流量接管时才启用 TUN；局域网共享则需要额外核对监听地址、防火墙与访问范围。
前往下载macOS
v2rayN · Apple Silicon / Intel
打开“关于本机”查看芯片信息：Apple Silicon 选择 arm64，Intel 选择 x64。安装包架构应与设备对应。遇到首次打开提示时，先确认来源，再按系统设置中的明确选项处理，不要照搬其他系统的权限操作。
安装后分别检查系统代理、网络权限和登录项。关闭窗口不一定等于退出客户端，判断是否仍在运行应查看实际进程或菜单栏状态。需要结束使用时，先恢复系统代理再退出；如果只在 TUN 模式异常，优先检查授权和其他网络工具是否冲突。
前往下载Android
v2rayNG · Xray / v2flyNG · V2Fly
优先查看 v2rayNG；需要 V2Fly 内核时再查看 v2flyNG。较新的主流设备通常选择 arm64，无法确认架构时可查看通用版说明。安装前核对系统要求，导入后确认目标协议被所选客户端及其内核支持。
首次连接会请求系统 VPN 授权，这是接收应用流量的入口，不代表服务器已经验证通过。连接后检查分应用代理范围，再测试需要使用的应用。若锁屏后连接中断，检查电池优化与厂商后台策略；保留必要权限即可，不要同时启动多个争用 VPN 接口的工具。
前往下载Linux
v2rayN · deb / rpm
按发行版的软件包管理方式选择 deb 或 rpm，再区分 x64 与 arm64。安装完成后从桌面环境启动图形客户端，先使用普通用户完成订阅管理与基础连接验证，不要为了省略权限确认而长期用高权限运行整个桌面程序。
不同桌面环境对系统代理的读取方式存在差异。网页可用而某个程序无法连接时，先查看该程序是否读取系统设置，以及是否提供独立代理选项。启用 TUN 前再检查虚拟接口权限、路由与解析器配置，关闭接管后确认网络设置已经恢复，避免残留配置影响下一次测试。
前往下载