客户端使用参考 / FAQ
V2Ray 常见问题:订阅、代理与连接排查
按操作阶段查找 v2rayN、v2rayNG 与 v2flyNG 的设置方法。遇到连接问题时,先核对客户端与服务器配置,再检查系统代理、路由和日志。
先分清客户端、内核与配置
选择设备对应的客户端,并确认导入的是订阅还是单个服务器链接。
v2rayN、v2rayNG 和 v2flyNG 分别用于什么设备?
v2rayN 是 Windows、macOS 和 Linux 的桌面客户端;v2rayNG 与 v2flyNG 用于 Android。v2rayNG 通常搭配 Xray 内核,v2flyNG 搭配 V2Fly 内核。先按设备选择客户端,再确认订阅或服务器配置所需的协议是否受到对应内核支持。
V2Ray 客户端和 Xray 内核有什么区别?
客户端提供导入订阅、选择服务器、设置路由和查看日志等图形界面;内核负责读取配置并处理连接。Xray 与 V2Fly 属于相关的开源内核家族,但功能和配置支持范围并不完全相同。遇到协议选项缺失时,应先检查客户端选用的内核及其支持范围。
订阅链接和单个服务器链接有什么区别?
订阅链接通常由服务提供方维护,客户端获取后可生成一个服务器列表,之后还能手动或定期更新。单个服务器链接只描述一项连接配置,导入后不会自动取得订阅中的其他服务器。添加时先确认拿到的是哪一类链接,再选对应的导入入口。
VMess、VLESS、Trojan 和 REALITY 应该怎样理解?
VMess、VLESS 和 Trojan 是客户端中可选择的协议类型;REALITY 通常是与特定传输及安全配置配合使用的选项,并非所有协议都能直接套用。导入已有配置时,以提供方给出的协议、传输方式和安全参数为准,不要只改协议名称来尝试连接。
路由模式与系统代理是一回事吗?
不是。系统代理决定遵循操作系统代理设置的程序是否把流量交给客户端;路由模式决定客户端收到流量后如何按域名、地址或规则处理。先让目标程序确实使用客户端,再检查路由规则。仅切换路由模式不能使原本不读取系统代理的程序自动接入。
安装包、订阅导入与权限
完成客户端安装后,按链接类型导入配置,并处理操作系统的授权提示。
Android 安装包的 arm64 与 universal 怎么选?
2015 年后的主流 Android 手机通常可先选择 arm64。无法确认处理器架构,或 arm64 包提示设备不兼容时,改选 universal 通用版。两种包是同一客户端的不同架构入口,不必同时安装;如需更换,先保留订阅链接或导出已有配置。
v2rayN 如何导入 V2Ray 订阅链接?
打开 v2rayN 的「订阅分组」,新增分组并填入订阅地址,保存后执行「更新订阅」。返回服务器列表,选择刚导入的分组和所需服务器。订阅地址应是完整链接;如果剪贴板中只有单个服务器链接,应使用导入服务器链接的入口,而不是订阅分组。
macOS 上打开客户端后为什么浏览器还没有使用代理?
启动客户端和启用系统代理是两个步骤。先选择服务器,再从客户端菜单选择「自动配置系统代理」,随后在 macOS 的网络代理设置中确认配置已生效。若浏览器装有独立代理扩展,暂时停用扩展后再测试,以免它覆盖系统设置。
v2rayNG 导入订阅后还需要做什么?
先检查订阅中是否出现服务器配置,再选择一项配置并点击连接按钮。首次连接时,Android 可能要求确认 VPN 连接权限,按系统提示授权。连接图标变化只表示客户端已启动;仍需用实际网页测试,并在异常时查看客户端日志与所选服务器参数。
启用 TUN 时提示权限不足怎么办?
TUN 需要在系统中创建虚拟网络接口,因此可能要求额外权限。先阅读客户端给出的权限提示,按当前系统的安装说明完成授权,再重新启动 TUN;不要仅靠反复切换开关。暂时不需要接管不遵循系统代理的程序时,可先关闭 TUN,使用系统代理完成基础连接测试。
模式切换与日常管理
区分流量入口与路由选择,减少切换服务器时的重复设置。
全局模式、规则模式与直连模式如何选择?
全局模式将客户端接收到的流量交给所选代理出口;规则模式根据域名和地址规则决定走向;直连模式则不经代理出口。初次排查可短暂切到全局模式,区分连接故障和规则匹配问题。确认连接正常后,再按实际需求恢复规则模式并检查命中的规则。
切换服务器后需要重新设置系统代理吗?
通常不需要。客户端保持运行且系统代理仍指向它的本地监听端口时,切换服务器会改变客户端使用的出口。若此前执行过「清除系统代理」,则需要重新选择「自动配置系统代理」。切换后若网页没有恢复,检查新服务器配置及日志,而不是只重复开关代理。
终端命令为什么没有跟随系统代理?
不少命令行程序不读取 macOS 或 Windows 的系统代理设置,而是读取各自的配置或代理环境变量。先在客户端设置中查看本地 HTTP 或 SOCKS 监听地址和端口,再按所用命令行工具的说明单独配置。不要把服务器远端端口误填为本地代理端口。
订阅分组较多时怎样避免选错服务器?
为每个订阅分组设置清楚的别名,并在更新后先确认当前选中的分组,再选择服务器。过滤关键词适合缩小列表,但不会修改服务器本身的连接参数。若同名条目出现在多个分组中,应查看分组归属及配置详情,不要只依据列表显示名称判断。
从订阅、连接到 DNS 逐项检查
一次只改动一项设置,并对照本次操作产生的日志。
订阅导入失败或更新后列表为空怎么办?
先确认订阅地址完整、仍有效,并检查是否误将单个服务器链接填入订阅分组。手动执行「更新订阅」后查看日志:请求失败先检查地址与网络,解析失败则向订阅提供方确认内容格式。更新前已有的分组不要急于删除,先核对当前分组与过滤条件。
服务器连接超时应先检查哪些设置?
先确认设备本身可以正常访问网络,再核对服务器地址、端口、协议、传输方式和传输层安全参数是否与提供的配置一致。地址无法解析、端口不可达或服务端暂时不可用都可能表现为超时。查看客户端日志的具体错误,不要把超时直接归因于路由模式。
客户端显示已连接,但网页仍无法打开怎么办?
先确认浏览器是否使用系统代理,以及客户端是否选中了可用服务器。随后短暂切换全局模式测试:若全局模式可用,重点检查路由规则;若仍不可用,查看日志中的连接与 DNS 错误。浏览器扩展、旧的代理设置也可能覆盖客户端当前配置,排查时逐项停用。
系统代理已开启却没有生效怎么办?
在客户端菜单确认「自动配置系统代理」已启用,再到操作系统网络设置中检查代理地址和端口是否指向客户端当前的本地监听端口。重启相关浏览器后测试;若只有某个程序无效,检查它是否有独立代理设置。终端程序还可能需要单独配置。
Xray 内核启动失败如何看日志?
打开 v2rayN 的日志窗口,找到本次启动最先出现的错误行。提示端口占用时检查本地监听端口;提示字段或配置解析错误时核对服务器参数;提示功能不支持时检查当前内核选择。修改一项后重新启动并对照新日志,避免同时改动多处导致原因难以判断。
部分网站能打开,部分网站解析失败怎么办?
先用同一浏览器分别测试不同域名,排除单个网站自身故障。若日志出现 DNS 解析错误,检查客户端 DNS 设置、系统 DNS 与路由规则是否把目标域名交给预期的解析路径。暂时使用全局模式测试可帮助定位规则问题;确认原因后再调整具体规则。