· 故障排查 · 约 8 分钟

V2Ray 运行日志怎么看:常见报错含义与逐项定位方法

教你打开客户端日志、调整日志级别,并逐条解读握手失败、连接超时、端口占用、时间不同步等典型报错,配一套由近及远的定位顺序。

本文速览

适合遇到核心启动失败、代理一开就超时,或只有个别网站打不开的读者。先抓取一次失败请求的日志,再按本地监听、规则分流、节点解析、远端连接和协议握手的顺序定位。每次只改一项设置,用同一个网址复测,避免把偶然恢复当成修复。

打开客户端日志,记录一次失败

客户端日志和核心日志回答的是不同问题。前者能告诉你订阅下载是否成功、配置是否加载;后者更适合判断本地端口、出站连接和握手出了什么问题。即使订阅更新成功,也只能说明订阅地址这次可访问,不代表其中的节点都能连通。

  1. 打开日志

    桌面端以 v2rayN 7.x 为例,打开主窗口,查看节点列表下方的信息区。Android 上打开 v2rayNG 或 v2flyNG,点左上角「☰」,选择「日志」(部分构建显示为「Logcat」)。记录客户端版本和日志启动行里的核心版本;v2rayNG 使用 Xray,v2flyNG 使用 V2Fly 核心,报错措辞不一定相同。

  2. 调到信息级

    v2rayN 从「设置」→「参数设置」进入 Core 基础设置,找「日志等级」;Android 端从「☰」→「设置」查找日志级别选项。界面名称可能随构建变化。先选 info,保存后重启连接;只有缺少上下文时才短时改用 debug。界面未提供该选项时,先用已有日志排查。

  3. 复现一次

    记下点击连接的时间,等核心启动后,用同一个应用打开同一个失败网址一次。不要同时刷新测速、更新订阅或切换节点。若还没打开网页就报错,先保留启动阶段的日志,不必继续发请求。

  4. 保留上下文

    复制失败行前后各约 5 行。若日志带连接编号,只把同编号的记录连起来读,避免将后台应用的报错算到这次测试上。排查结束后恢复原日志级别,分享前遮盖订阅地址、账号标识、节点地址和访问域名。

定位失败发生在哪一段

应用请求本地入口路由匹配出站连接协议握手

先确认请求有没有进入核心,再看它走了什么出站。日志中的 accepted 通常只说明核心收到了请求;如果后面走的是直连出站,就不该期待看到节点握手。若日志没有请求记录,先确认当前级别会记录连接,再检查系统代理、TUN 或 Android 的应用分流范围。

常见报错原文、含义与处理方法

下面列的是可搜索的报错片段,不是某个版本的完整日志。操作系统、核心版本和传输方式不同,前后缀可能有变化。

bind: address already in use

原因:核心要监听的地址和端口已被占用。处理:确认占用程序后退出重复运行的实例,或为当前客户端换一个确认空闲的端口,并同步更新手动填写过代理端口的应用。

connect: connection refused

原因:连接被明确拒绝,常见于目标端口没有监听。处理:如果目标是 127.0.0.1,核对核心是否启动、应用端口是否写对;如果目标是节点地址,核对订阅里的节点端口,再向提供方确认服务状态。

i/o timeout

原因:某次网络读写或连接操作未在期限内完成,单凭这几个字不能确定是节点不可达。处理:先看同一行是 lookup、dial tcp 还是读写超时,再保持节点不变,换一个已知可用的网络复测。

no such host

原因:这次域名查询未能得到可用记录。处理:找出失败的域名,若是节点域名,先用订阅原值核对拼写;若是访问域名,先确认负责解析的是系统、核心还是远端,再检查对应的 DNS 设置。

remote error: tls: handshake failure

原因:对端拒绝了 TLS 握手,这条日志本身不说明拒绝的具体原因。处理:用订阅原值核对节点端口、传输方式、TLS 开关和服务器名称,仍失败时把握手时间与脱敏日志交给节点提供方核对。

x509: certificate has expired or is not yet valid

原因:按本机时钟判断,证书不在有效期内,可能是系统时间错误,也可能是证书确实过期。处理:先同步系统时间;时间正确后仍失败,请提供方检查证书,不要关闭证书验证。

核对本地端口与系统时间

假设日志显示核心尝试监听 127.0.0.1:10808,但绑定失败。在 Windows 的 PowerShell 查询该端口的监听进程。这里的 10808 只是示例,实际应替换成日志里的端口。若报错涉及 UDP,则不能用这条 TCP 查询排除占用。

Get-NetTCPConnection -LocalPort 10808 -State Listen |
  Select-Object LocalAddress, LocalPort, OwningProcess

在任务管理器的「详细信息」页按 OwningProcess 返回的进程 ID 找程序,不要直接结束不认识的进程。如果决定更换端口,例如改用已确认空闲的 10818,保存后重启核心,并核对应用填写的代理类型和端口。HTTP 和 SOCKS 入口分开时,要分别对应;端口正在监听也不代表两种入口可以互换。

按故障范围选择复测方式

日志显示已接收请求,为什么网页还是打不开?

继续往下找同一次请求的出站标签。如果走的是直连,但预期应该代理,先核对当前路由模式和匹配到的规则。如果走的是代理,再检查对应的拨号或握手报错。用同一个网址复测,不要同时更改分流模式和节点。

只有一个节点超时,要不要重装客户端?

先不重装。保持设备、网络、网址和路由模式不变,只换同协议的一个已知可用节点。如果对照节点正常,优先核对故障节点的地址、端口和传输参数;如果两者都超时,再检查当前网络和本地配置。

桌面能用,手机点连接后为什么没访问日志?

先确认 Android 已批准当前客户端的 VPN 连接,并检查是否有另一项 VPN 正在运行。如果开了分应用代理,核对测试浏览器是否被排除,或是否未加入仅代理名单。复测时保留同一节点,以免把应用接管问题和节点故障混在一起。

刚更新订阅就报错,应该看哪一段?

先看订阅请求是否有明确的下载或解析失败。若更新成功,确认当前启用的是新分组里的节点,再断开重连并看核心启动行。如果核心能启动、只有新节点握手失败,把更新前后的传输方式与 TLS 设置逐项对照,不要把旧参数整套套回去。

客户端下载