FAQ / 配置检修索引

V2Ray 常见问题

订阅导入、代理模式与连接故障

先找现象,再查对应层。地址、节点、流量入口、路由分别排查;一次只改一项,日志才有参考价值。点开问题即可查看操作说明。

v2rayN / v2rayNG 订阅 / routing / TUN

客户端 / 订阅 / 内核

基础认知

先分清软件与配置的职责,避免把订阅、节点和代理开关当成同一件事。

v2rayN、v2rayNG 与 v2flyNG 怎么选?

Windows、macOS 与 Linux 桌面优先选 v2rayN,它负责节点管理、订阅更新、路由选择以及系统代理设置。Android 优先选 v2rayNG,使用 Xray 内核;v2flyNG 是采用 V2Fly 内核的备选客户端。先按设备系统选软件,再核对服务提供方要求的协议与传输参数,不必为了同一条订阅安装全部客户端。客户端是本地配置工具,不会自动生成可用节点。下载完成后,还需要准备合法取得的订阅地址或分享链接;已有配置也应先备份,避免切换软件时遗漏自定义路由。

V2Ray 订阅链接与单节点分享链接有什么区别?

订阅链接通常是 HTTPS 地址,客户端请求它后得到一份节点清单,后续可以再次更新。vmess://、vless:// 等分享链接通常描述单个节点,包含服务器、端口、身份信息及传输设置。两者进入的菜单不同:订阅地址应保存到订阅分组,再执行更新;单节点链接用从剪贴板导入的入口。不要把普通网页地址当订阅,也不要把分享链接填进订阅地址栏。订阅链接可能带有账号凭据,应按密码对待,不能放进公开截图。节点清单能更新,不代表账号期限或额度也会随之刷新。

系统代理、全局路由与 TUN 是同一个开关吗?

不是。系统代理决定遵循系统代理设置的应用是否把请求交给客户端;路由规则决定已进入内核的请求从哪个出站发送;TUN 则通过虚拟网络接口接收符合接管条件的流量。全局路由不会强迫一个忽略系统代理的程序进入代理,也不会自动启用 TUN。排查时先确认应用流量是否进入客户端,再看路由是否命中代理出站。日常浏览可先使用系统代理配合绕过大陆的路由;确有应用不遵循系统代理时,再评估 TUN。不要同时改动这三层,否则很难判断是哪一层出了问题。

Project V、V2Fly 与 Xray 内核有什么关系?

Project V 是理解 V2Ray 生态的背景,V2Fly 延续 V2Ray 内核的社区维护,Xray 是从相关代码发展出的另一条内核路线。内核负责协议处理、传输、DNS 与路由,v2rayN、v2rayNG 等图形客户端负责生成配置和提供操作界面。协议名称相同,也不意味着所有新参数在不同内核中都能通用。导入后若提示不支持的字段,先核对客户端及内核能力,再核对服务端要求。不要只修改内核名称就认为兼容性已经解决;传输方式、安全设置与相关扩展仍需成套匹配。

架构 / subscription / 授权

安装配置

安装包先对系统架构,订阅再对导入入口,权限最后按功能需求处理。

Android 安装包选 arm64 还是 universal?

使用 64 位 ARM 系统的手机通常选 arm64,主流较新的 Android 设备多属这一类。universal 包含多种处理器架构,体积通常更大,适合架构不明确时作为备选。处理器具备 64 位能力,不保证厂商安装的系统也是 64 位,所以不能只凭购买年份判断。若 arm64 包提示与设备不兼容,先查看系统与处理器信息,再尝试通用版。覆盖安装还受到应用签名、系统版本及已有版本影响;出现安装失败时先记录完整提示,不要立刻删除旧应用。需要重新安装时,先导出配置或保存订阅地址。

v2rayN 与 v2rayNG 怎样导入订阅?

v2rayN 中先打开「订阅分组设置」,新增分组,填写备注与订阅地址并保存,再从「订阅分组」菜单执行更新;更新入口可能区分通过代理或不通过代理。v2rayNG 中打开「订阅分组设置」,添加分组和地址,返回主界面后执行「更新订阅」。不同版本的菜单排布会有变化,但流程始终是保存地址、更新清单、选择节点。导入单条分享链接则使用「从剪贴板导入」或对应的导入入口,不需要新建订阅分组。完成后检查节点的服务器和传输类型;订阅备注只是标签,不能用来判断配置是否有效。

v2rayNG 首次连接为什么需要 VPN 授权?

v2rayNG 的 VPN 模式通过 Android 的 VPN 接口接收流量,首次启动连接时系统会弹出连接请求,需要确认授权才能建立该接口。这个授权不等于订阅登录,也不表示节点已经连通。若确认后仍立即停止,先关闭其他正在使用 VPN 接口的应用,再重新连接;同一用户环境通常不能同时运行两个此类连接。若只有部分应用不走代理,检查「分应用代理」及其允许或排除模式。后台容易断开时,再检查系统对 v2rayNG 的电池与后台运行限制,修改后观察实际表现,不必一次放开所有系统权限。

v2rayN 的 TUN 模式提示权限不足怎么处理?

TUN 涉及创建虚拟网络接口及调整路由,通常需要比普通系统代理更高的权限。Windows 上可先退出客户端,再按当前版本要求以管理员权限启动;macOS 与 Linux 应遵循客户端显示的授权或服务安装提示,不要把 Windows 的操作照搬过去。启动后查看日志,确认虚拟接口与路由是否成功建立。若报错指向接口占用,先停止其他接管流量的程序。没有接管需求时可关闭 TUN,先用系统代理验证节点。不要通过关闭系统防护或给整个配置目录任意写入权限来绕过错误,权限应只覆盖必要操作。

routing / mux / 配置备份

使用技巧

规则决定流向,应用决定入口。调整前保留原配置,调整后用相同目标复测。

绕过局域网及大陆地址的路由应该怎样理解?

该路由通常让局域网及规则识别的大陆目标直连,其他目标按代理规则处理,适合同时访问本地服务与外部网站的场景。它依赖域名、IP 数据和规则顺序,不是根据网页显示的语言判断流向。内核按规则顺序匹配,前面的规则可能先决定出站;自定义规则放错位置,会使后面的规则不起作用。若某个网站走向异常,先查日志里的目标与出站,再检查自定义域名规则、DNS 和规则数据。局域网打印机或内网服务访问失败时,优先核对私有地址的直连规则,不必先把所有流量改成全局代理。

v2rayN 设置了系统代理,为什么某些程序仍然直连?

系统代理只对读取并遵循该设置的应用生效。部分程序使用独立代理选项,部分命令行工具读取环境变量,还有程序完全忽略系统代理。先用浏览器验证当前节点,再打开目标程序的网络设置,确认它是否使用系统代理。若需手动填地址,填写客户端实际监听的本地地址与端口,并区分 HTTP 和 SOCKS,不能把一种协议的端口随手填进另一种协议栏。端口以当前客户端配置为准,不要套用旧教程。设置正确仍不进入客户端时,可评估 TUN;验证后恢复临时设置,避免下次启动出现两套代理互相叠加。

Mux 多路复用和 Sniffing 嗅探需要一直开启吗?

Mux 用于复用连接,效果与协议、服务端及网络条件有关,不是通用的加速按钮。部分配置组合不适合启用,遇到连接中断或特定网站异常时,可以先关闭它做对照。Sniffing 会从支持识别的流量中提取目标信息,帮助域名路由判断,但也需要与客户端生成的路由及 DNS 配置配合。没有明确需求时先使用客户端默认值,再根据问题单独调整。每次只改一项,重启连接后用同一网站复测并记录日志。不要在节点不可用时同时打开 Mux、嗅探和 TUN,三个开关一起动,检修台就变成猜谜台。

更换客户端或求助前,哪些配置应该备份和隐藏?

更换客户端前保存订阅地址、手工添加的节点、自定义路由、DNS 和分应用代理设置;导出文件可能含连接凭据,应放在受控位置。订阅导入成功不代表自定义规则已经迁移,迁移后需要逐项检查。向他人求助时,只提供系统、客户端名称、错误发生步骤以及处理过敏感信息的日志。订阅 token、UUID、密码、私钥和完整分享链接都应隐藏,截图也要检查二维码与剪贴板预览。已经公开的订阅凭据应在服务提供方处重置;单纯撤回图片不保证旧地址失效。保留报错类型和时间即可帮助定位,不需要暴露整份配置。

解析 / 更新 / 连接日志

故障排查

区分“拿不到配置”和“配置不能连接”。错误发生在哪一步,就从哪一步查起。

订阅导入失败或提示无法解析,应该先检查什么?

先分清失败发生在保存地址、下载内容还是解析节点阶段。检查粘贴内容是否带有首尾空格、换行、中文标点,是否误用了账号管理页地址。订阅地址返回的应是客户端支持的节点内容,而不是登录页面或网页错误提示;能在浏览器打开,并不能证明格式正确。向服务提供方确认该地址适用于 v2rayN 或 v2rayNG,以及账号是否有效。若日志提示不支持的协议或字段,核对客户端版本与所用内核。不要为了通过解析随意删除安全参数。单条分享链接应走剪贴板导入,订阅地址应走订阅分组,两种入口用反也会报错。

原来可用的订阅为什么更新失败?

更新失败可能来自地址失效、账号到期、订阅服务器异常、DNS 解析失败或当前网络无法访问订阅服务。v2rayN 若提供通过代理与不通过代理两种更新方式,可先用已知可用的节点尝试通过代理更新,再对照不通过代理的结果;当前节点本身失效时,通过代理更新也可能失败。v2rayNG 则应按版本提供的订阅更新设置排查。出现 TLS 相关错误时核对设备时间与服务器证书,不要直接关闭证书验证。保留现有清单后再重试,避免先删除分组导致失去可用配置。地址被服务方重置时,应替换旧地址,而不是反复点更新。

节点测试超时,怎样判断是网络还是配置问题?

先确认本机能正常访问普通网站,再检查节点服务器地址、端口和设备时间。测试方式也有区别:TCP 连接成功只说明端口可连接,真实连接测试还涉及协议握手、DNS 及测试目标,不能把两者当同一个结论。选一个确认仍有效的节点做对照,并在允许的情况下切换网络测试。仅一个节点失败时重点查服务状态和该节点参数;全部节点失败时重点查本地网络、DNS、防火墙与客户端日志。握手错误应核对 UUID、TLS、serverName 及传输参数。重启只能清理部分临时状态,不能修复过期账号或错误配置。

客户端显示已连接,却无法上网怎么办?

已连接通常只表示本地服务或 VPN 接口已经启动,并不能证明远端节点可用。先测试所选节点,再确认桌面应用已使用系统代理,Android 已授权 VPN 且目标应用没有被分应用规则排除。随后查看日志:没有目标请求,先查流量入口;有请求但出站报错,查节点及握手参数;只有域名访问失败,查 DNS;仅个别网站失败,查路由及目标服务。可暂时使用较简单的路由做对照,验证后恢复原设置。停止其他代理工具,避免端口或虚拟接口冲突。每轮只改变一个条件并复测同一目标,比连续切换全部开关更容易定位。