V2Ray 常见问题
与故障排查

先按设备选择图形客户端，再了解内核。V2Ray 通常指 Project V 代理生态中的核心项目；V2Fly 是其社区延续，Xray 是相关内核项目。v2rayN 是用于 Windows、macOS、Linux 的桌面客户端，负责管理配置、调用内核及设置代理；v2rayNG 是采用 Xray 内核的 Android 客户端。客户端界面与内核不是同一层，界面能启动不代表内核已经运行。排查时应分别确认配置已导入、内核已启动，以及应用流量已进入代理。

需要。先准备有权使用的服务器配置或订阅链接，再导入客户端。客户端提供配置管理与流量转发能力，本身不附带可连接的远端服务。订阅通常把多个服务器配置集中在一个地址中，更新后由客户端生成条目；单条分享链接则通常只描述一个配置。不要把服务商登录页面地址当成订阅，也不要将订阅发到公开讨论区。订阅可能含访问凭据，截图、日志及求助材料都应遮去链接、用户标识与认证内容。

先区分流量如何进入客户端，再判断进入后走哪条出站。系统代理向系统登记代理地址，仅对遵循该设置的应用有效；全局路由通常表示把已进入内核的流量交给代理出站，并不等于接管设备上的所有程序。TUN 通过虚拟网络接口接收符合接管范围的流量，更适合不读取系统代理的应用，但涉及权限、路由及 DNS。首次配置建议先用系统代理验证，再按需要测试 TUN，避免同时改变入口方式和路由规则。

先用实际目标网站或应用复现，再比较不同服务器。延迟测试只反映特定探测方式与目标下的响应时间，不等于持续带宽，也不能直接代表所有网站的可用性。网页加载还受 DNS、传输丢包、远端出口、目标服务及本地网络影响。比较时保持网络、路由模式和测试目标一致，每次只更换一个服务器。若小页面正常而大文件慢，重点查看带宽与丢包；若仅一个网站异常，优先检查该域名的分流结果与目标服务状态。

先查设备处理器与系统支持的应用架构。多数较新的 Android 手机可选 arm64，安装包通常更小；不确定架构时可选 universal，它包含多种架构所需内容，因此体积更大。处理器支持 64 位不一定代表系统允许安装 64 位应用，较旧设备尤其需要确认。如果提示安装包不兼容，先检查架构、系统版本和存储空间，再考虑换包。更新已有客户端时，还要留意包名与签名是否一致；需要卸载重装前，应先备份可导出的配置。

Windows 用户可先按下载页的系统要求选择桌面版；它采用跨平台界面，适合从统一的桌面操作流程开始。习惯经典界面的用户可选择 WPF 版，并确认所需运行环境已经安装。两者的菜单位置和设置名称可能不同，不要仅凭旧教程的截图判断功能缺失。升级或换版前先退出正在运行的客户端，备份配置，并使用独立目录测试，避免两个实例争用本地端口。macOS 与 Linux 用户应选择对应平台的桌面安装包。

先确认复制的是完整订阅地址，去掉首尾空格与换行，并检查链接是否过期、被重置或需要重新授权。接着确认客户端支持该订阅格式；下载到登录页面、错误页面或其他客户端专用配置时，通常无法解析出服务器。若更新请求需要已有代理才能访问，应先选一个可用配置，再使用经代理更新的选项。排查时保留原分组，新建测试分组进行导入，避免覆盖有效配置。日志只需核对错误类型，分享前必须遮去完整订阅地址。

先关闭 TUN，确认普通系统代理能够连接，再单独处理权限。Windows 上按客户端提示安装或启动所需服务，必要时使用管理员权限；macOS 与 Linux 应按对应版本说明完成系统授权或特权服务配置，不要直接套用其他平台的命令。Android 客户端使用系统 VPN 授权，首次连接需要确认授权提示。已有 VPN 或其他虚拟网络工具可能发生冲突，应先退出后复测。权限处理完成后重新启用，检查日志是否创建接口及路由，而不只看开关状态。

先选择可用服务器，启用自动配置系统代理，再查看系统设置中的代理地址和端口是否与客户端监听一致。用遵循系统代理的浏览器打开测试页面，同时观察客户端日志或连接记录是否出现对应请求。需要更明确的验证时，可让命令行工具显式使用本地代理端口，再与不使用代理的结果对照；两种测试验证的入口不同。浏览器扩展、自带代理设置和缓存都可能影响判断。出口地址变化只能作为辅助证据，最好同时核对请求记录和路由结果。

先用默认路由分流建立稳定基线，确认常用网站、局域网设备与工作应用都能正常访问。分流按域名、地址和规则顺序选择直连或代理，适合日常混合访问；全局路由更适合短时间判断某个故障是否由分流规则造成。如果全局正常而分流异常，应检查目标域名命中的规则、DNS 结果及规则资源是否可用，而不是长期依赖全局掩盖问题。测试结束后恢复原设置，并留意内网服务是否被错误交给远端出口，避免影响打印、文件共享或企业网络。

按订阅来源建立独立分组，为分组使用容易辨认的名称，不要把同一订阅重复导入多个位置。更新前记录当前使用的条目及关键参数，更新后重新确认选中项仍然有效，因为服务端可能删除、改名或调整配置。手动添加的配置尽量放在独立分组，以免被订阅更新替换。定期清理失效分组，但不要频繁重置全部配置。使用自动更新时，确认更新入口在当前网络下可达，并在出现异常后先检查更新时间和日志，再决定是否重新导入。

先备份现有设置，记录当前内核与一个已验证可用的配置，再检查目标内核是否支持该配置的协议、传输方式和安全参数。客户端提供切换选项，不代表所有配置都能原样通用，尤其要注意扩展字段、DNS 配置及 TUN 实现的差异。切换后先使用简单路由与单个服务器验证，确认连接正常后再恢复自定义规则。若出现未知字段或启动失败，应回到原内核对照日志，不要连续删除参数试错。客户端与内核更新也应分开验证，便于定位变更来源。

按本地、订阅、服务器、系统四层检查。先确认设备时间准确、网络可用，且内核启动后本地端口确实在监听；再更新订阅，排除旧地址、过期凭据及导入不完整。随后核对服务器地址、端口、传输与安全参数，并用同一网络下另一个已知可用的配置对照。最后检查防火墙、其他代理工具和虚拟网络的冲突。一次超时不能证明远端失效，重复测试应保持目标与条件一致。记录首次出现错误的时间和日志类型，比反复重装更有助于定位。

先查看内核日志，确认远端连接实际成功，而不是仅开启了本地代理或 VPN 接口。随后检查浏览器请求是否进入客户端：没有请求时，核对系统代理、浏览器独立设置及本地端口；已有请求但失败时，再检查路由、DNS 与服务器可用性。若只有域名访问失败，优先观察解析错误；若局域网和所有网站同时异常，应停用 TUN 后复测，检查路由冲突。先保留一个代理入口和一个客户端运行，排除其他工具干扰，不要同时改 DNS、端口和路由模式。

先保留旧配置，不要清空列表。已有服务器可用，只能说明代理连接正常，不代表订阅地址仍然有效。检查订阅是否被重置、到期或触发请求限制，并核对设备时间和证书错误。若直连更新失败，可在选中可用服务器后尝试经代理更新；若经代理失败，也应对照直连，避免更新请求形成依赖。服务端返回登录页面或格式改变时，需要重新获取兼容链接。不要短时间连续刷新；记录状态码与错误摘要，联系订阅提供方时遮去认证信息。

端口被占用时，先查看是否启动了第二个客户端实例，再用系统网络工具找出占用该监听端口的进程。确认用途后关闭冲突程序，或在参数设置中改用空闲端口，并同步修改手动配置的浏览器及其他应用代理。不要结束来源不明的系统进程。若客户端退出后无法直连，先到系统代理设置关闭残留的手动代理或自动配置地址，再检查 TUN 与其他 VPN 是否仍在运行。恢复网络后重新启动一个客户端验证，后续尽量先清除系统代理，再正常退出。