01 / BASICS
基础认知
先分清客户端、内核、订阅与代理模式各自负责的环节,后续排查才不会把界面问题和连接问题混在一起。
V2Ray、Xray 内核和 v2rayN 分别是什么?
V2Ray 通常指 Project V 相关的协议与工具生态,Xray 是该生态中的内核实现,负责协议处理、入站、出站、DNS 与路由。v2rayN 是桌面图形客户端,负责订阅管理、服务器选择和系统代理设置,并调用 Xray 等内核处理流量。排查问题时要区分界面设置与内核配置:订阅列表异常通常先检查客户端,协议或路由报错则继续查看内核日志。
Windows、macOS、Android 和 Linux 应该选择哪个客户端?
Windows、macOS 与 Linux 可优先使用 v2rayN,界面和订阅管理方式较为统一。Android 可选择使用 Xray 内核的 v2rayNG;需要 v2fly 内核时可选 v2flyNG。选择时先确认操作系统与处理器架构,再下载对应安装包。不同客户端的菜单位置有所区别,但基本流程都是导入订阅、更新服务器、选择节点、设置代理模式并验证连接。
V2Ray 订阅链接和单个节点配置有什么区别?
订阅链接通常由服务提供方生成,客户端访问该地址后可一次获取多条服务器配置,并在后续更新时同步增删变化。单个节点配置只描述一条连接,可以通过链接、二维码或手动字段导入。长期使用适合保存订阅并按需更新;临时测试单条配置时可直接导入节点。订阅地址属于敏感配置信息,不宜放入公开文档、截图或共享日志。
系统代理、路由模式和 TUN 模式有什么区别?
系统代理是把代理地址写入操作系统设置,主要接管遵循系统代理的应用。路由模式决定进入内核后的流量走 direct、proxy 还是 block,例如按 geosite 与 geoip 规则分流。TUN 模式通过虚拟网络接口接管更广范围的流量,适合不读取系统代理设置的程序。三者处于不同环节,可以组合使用;日常浏览通常先用系统代理,需要接管更多程序时再评估 TUN。
02 / INSTALLATION
安装配置
安装阶段重点确认平台、处理器架构和权限。订阅导入后还需要主动更新,服务器列表才会按返回内容生成。
怎样把订阅链接导入 v2rayN 或 v2rayNG?
先完整复制服务方提供的订阅地址。v2rayN 中进入订阅分组管理,新增分组并粘贴地址,保存后执行更新订阅;v2rayNG 中打开订阅分组或订阅设置,添加地址后执行更新。更新结束后返回服务器列表,选择一条配置再开启系统代理或连接。不要把订阅地址粘贴到单个服务器的地址栏,因为该位置需要的是服务器主机名而不是订阅入口。
订阅更新成功后为什么看不到服务器?
先确认当前显示的是刚更新的订阅分组,并清除服务器名称或地区关键字过滤条件。随后查看更新结果是否提示解析到有效配置;如果返回内容为空、格式不受支持或订阅已经失效,列表不会生成服务器。还可检查设备日期、时间和时区是否准确,再重新更新。多个分组并存时,应确认服务器列表没有停留在其他分组或仅显示已收藏项目。
Android 安装包的 arm64 与 universal 应该怎么选?
近年的主流 Android 手机通常使用 arm64 架构,优先选择 arm64 安装包,文件体积一般更小。无法确认架构、设备较旧,或 arm64 包提示不兼容时,再使用 universal 通用版。通用版包含多种处理器架构,兼容范围更宽,但功能并不会因此增加。已经安装客户端时,更新包还需要与现有应用的签名及来源一致,否则系统可能要求先卸载旧版本。
开启 TUN 模式时为什么提示权限不足?
TUN 模式需要创建虚拟网络接口并修改路由,因此会触发系统级权限请求。桌面端应从客户端内的 TUN 开关启动,并按提示授予管理员权限、网络扩展权限或相关辅助组件权限;不要只启动内核文件。授权后完全退出客户端再重新打开。如果依旧失败,检查安全软件是否阻止驱动或服务启动,并确认旧版 TUN 组件没有残留占用。
03 / USAGE
使用技巧
代理模式决定哪些程序把请求交给客户端,路由规则再决定流量使用哪个出站。调整时应一次只改一个变量。
日常使用应该选择哪种系统代理模式?
需要让浏览器和多数遵循系统设置的应用使用代理时,可选择自动配置系统代理。暂时停止使用时选择清除系统代理,让操作系统恢复普通网络路径。不改变系统代理适合已经手动配置代理或只使用 TUN 的场景。PAC 模式会按规则决定哪些请求交给代理,但具体覆盖范围受应用支持影响。切换后可打开系统网络设置,确认代理地址和端口是否同步变化。
全局模式与绕过大陆模式应该怎样选择?
全局模式通常把大部分已接管流量交给 proxy 出站,适合快速判断问题是否来自分流规则,但会增加不必要的代理流量。绕过大陆模式会让常见中国大陆域名与地址走 direct,其余流量按规则处理,更适合日常使用。若某个网站在绕过模式下异常,可先切到全局模式对照测试;全局正常时,再检查该域名命中的 geosite、geoip 或自定义规则。
多个订阅怎样分组管理,避免更新后混在一起?
每个订阅建立独立分组,并用来源或用途命名,不要把多条订阅地址反复写入同一分组。更新前先选中目标分组,更新后检查新增与删除记录,再按地区关键字或协议筛选服务器。需要保留手动配置时,可单独建立本地分组,避免订阅更新覆盖管理顺序。切换分组后还要重新确认当前活动服务器,因为列表变化不一定会自动替换已选择的节点。
自定义路由规则为什么没有按预期生效?
路由规则通常从上到下匹配,较宽泛的规则放在前面可能提前命中,导致后面的精确规则没有执行。检查域名规则使用的是 domain、full、keyword 还是 geosite,地址规则使用的是 ip、geoip 还是网段,并确认目标出站标签确实存在。修改后应重新载入配置或重启内核。排查时可暂时只保留一条目标规则,通过日志确认实际域名、地址与最终出站。
04 / TROUBLESHOOTING
故障排查
先判断故障发生在订阅获取、节点握手、系统代理还是路由解析。保留对应阶段的日志,比反复切换全部设置更有效。
订阅更新失败或提示网络错误怎么处理?
先在订阅设置中检查地址是否完整,尤其不要遗漏协议头、路径和参数。确认系统时间正确后,分别在关闭系统代理与启用可用节点的状态下尝试更新,用于判断订阅地址是否需要经过代理访问。如果服务方要求专用用户代理或更新方式,应按其说明设置。仍然失败时查看客户端日志中的 HTTP 状态与解析提示,并向订阅提供方确认地址是否过期。
节点测试一直超时应该按什么顺序排查?
先切换到同一订阅中的另一条服务器,判断是单节点故障还是全部配置不可用。随后检查设备能否正常访问普通网站、系统时间是否准确,以及服务器地址、端口、UUID、传输方式和 TLS 相关字段是否完整。测试方式也会影响结果,TCP 连通不代表协议握手一定成功。若所有节点同时超时,可更新订阅、重启网络和客户端,再查看内核日志中的连接阶段报错。
客户端显示已连接但网页仍然无法打开怎么办?
已连接只表示客户端或内核已经启动,不代表目标请求一定成功。先确认当前服务器已选中,并检查系统代理是否开启、代理端口是否与客户端监听端口一致。再用全局模式做一次对照测试:全局可用而分流不可用,重点检查路由与 DNS;全局也不可用,则切换节点并查看握手日志。浏览器启用了独立代理、扩展代理或安全 DNS 时,也应暂时恢复为跟随系统设置。
v2rayN 已设置系统代理但部分程序仍然直连怎么办?
部分程序不会读取操作系统代理设置,或者只在启动时读取一次。先完全退出该程序,在 v2rayN 选择自动配置系统代理后重新打开,并确认系统代理页面已经写入本地地址与端口。若程序提供自己的网络代理选项,应设置为跟随系统或手动填写客户端监听端口。仍然直连且需要接管该程序时,可评估启用 TUN 模式,并在启用后检查虚拟接口和路由表是否创建成功。