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

讲解日志级别设置与日志结构,逐条拆解连接超时、端口占用、配置解析失败、TLS 握手错误等常见报错的含义与排查步骤。

本文速览

遇到 v2rayN 启动失败或网页打不开,先判断核心是否读入配置、是否建立本地监听,再检查出站连接。本文以 Windows 上使用 Xray 核心的 v2rayN 为例,说明怎样抓取一次故障的日志,以及怎样用地址、端口和报错上下文缩小排查范围。

v2rayN 在哪里看日志,日志级别怎么选

先看主窗口的「信息」区域,找到切换节点或启动核心附近的输出。设置日志级别时,可从「设置」→「参数设置」进入 Core 基础设置,找「日志等级」一项。不同版本的分组名可能略有差异;使用自定义配置时,还要确认实际载入的配置是否自行指定了日志输出位置和级别。

  1. 记录当前环境

    记下 v2rayN 版本、节点使用的核心类型和本地代理端口。先不要同时更新订阅、换节点和改端口,否则即使恢复连接,也无法确定哪项改动起了作用。

  2. 设为 info

    将核心日志级别临时设为 info,保存后重新启动当前核心。Xray 配置中对应字段是 log.loglevel。warning 和 error 记录的范围更窄,适合平时使用,不一定能显示请求经过的环节。

  3. 复现一次故障

    记下发起请求的时间,用原来报错的应用重试一次。若故障是在启动时发生的,就只重启核心,不必反复刷新网页。保留失败行以及前后几行,不要只复制窗口最后一句。

  4. 补录后恢复

    若 info 无法判断失败环节,再临时使用 debug 重试一次,随后恢复原级别。对外分享前,遮盖订阅地址、认证信息、私有域名及公网地址;保留报错关键词、端口和同一请求里的关联标识。

日志结构:区分本地入站、路由和远端出站

一段日志可能同时包含客户端提示、核心输出和测速结果。读核心输出时,先用时间对齐那一次操作,再看组件名与出错动作。某些核心日志会用 > 串起多层错误:左侧多是动作失败的概括,右侧往往有更具体的系统错误。只比较同一条错误链,别把相邻请求的日志拼成一个原因。

127.0.0.1
本机回环地址
10808
本地代理端口示例
443
远端 TLS 端口示例
日志片段能确定什么下一步看哪里
listen tcp 127.0.0.1:10808这段文字指向本地监听操作看同一行是否出现绑定失败,而不是测试服务器端口
accepted核心接到了该入站请求若后面显示入站到出站的标签,核对它是否走了预期的路由
dial tcp某个组件尝试建立 TCP 连接按日志里的目标地址和端口区分节点、直连目标或本地服务

判断:用同一请求核对路由

若浏览器报错时已有对应的 accepted,但出站标签显示命中了直连规则,先检查这条路由规则及其匹配顺序。此时重装客户端或频繁切换节点,不会改变该请求的出站选择。

核心启动失败:端口占用和配置解析错误

启动阶段报错时,浏览器的代理错误通常只是后续现象。先确认核心有没有成功读入配置,再看能否监听本地端口。两种失败都可能导致请求进不了核心,但处理办法不同。

报错:Only one usage of each socket address (protocol/network address/port) is normally permitted.

原因与解法:Windows 返回这条绑定错误,通常是因为该地址和端口不能再被当前进程占用。查看监听进程,确认是否为另一份客户端或残留核心;正常退出冲突程序,或调整本地端口并同步应用里的代理设置。

报错:invalid character '}' looking for beginning of object key string

原因与解法:解析器在等待下一个对象键时读到了右花括号,常见原因是最后一个字段后多了逗号。根据报错里的文件名、行列或偏移量检查实际载入的配置,先修正语法,再核对字段类型和核心支持情况。

如果错误里的监听端口是 10808,可以在 Windows PowerShell 查询。若日志显示其他端口,把命令中的数字替换成那个值。查不到监听记录时,先复核报错时间;产生冲突的进程可能已经退出。

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

OwningProcess 是进程 ID,可在任务管理器的「详细信息」页对照。若改了本地代理端口,重新应用 v2rayN 的系统代理设置,并检查手动填写过代理地址的应用。若是自动生成的配置解析失败,优先回到节点编辑界面更正来源;直接编辑临时配置,下一次启动时可能被覆盖。

连接超时、连接被拒绝和 TLS 握手失败

核心已接到请求时,下一步要确定是拨号失败,还是 TCP 已建立后在握手阶段失败。两者的检查对象不同:前者看实际连接地址和端口,后者看安全类型、服务名和证书等参数。

报错:i/o timeout

原因与解法:某次网络操作超过期限,但这几个字不能说明超时发生在哪一层。若前面是 dial tcp,先测试日志里的目标 TCP 端口;若错误发生在读取响应或握手时,则继续看同一条错误链的上下文。

报错:connection refused

原因与解法:连接遭到主动拒绝,常见于目标端口没有服务监听,或中间设备主动拒绝。确认地址是否属于本机;本机看监听进程,远端则核对节点端口并请服务管理方确认监听和放行情况。

报错:x509: certificate signed by unknown authority

原因与解法:普通 TLS 的证书验证无法把收到的证书链连到受信任的根。先确认连的是预期服务,再请服务管理方核对证书链;如果是组织管理的网络,向管理员核实信任链要求,不要用跳过验证来消除报错。

报错:remote error: tls: handshake failure

原因与解法:远端在握手时返回失败警报,单凭这一行无法判定是哪个参数不匹配。核对节点的安全类型、服务名和端口;如果配置用的是 REALITY,则按服务端提供的参数核对服务名、公钥与短 ID,不把普通 TLS 证书设置套用过去。

对使用 TCP 的节点,可在 PowerShell 单独测试服务器入口。按提示输入节点服务器地址和远端端口,不要输入订阅链接、TLS 服务名或本地代理端口。

$serverAddress = Read-Host '节点服务器地址'
$serverPort = [int](Read-Host '节点远端端口')
Test-NetConnection -ComputerName $serverAddress -Port $serverPort

日志排查常见问题

网页打不开,信息区却没有新日志?

先把日志临时调到 info 再试。仍找不到对应入站记录时,确认核心已监听,再核对 v2rayN 的系统代理状态和 Windows「设置」→「网络和 Internet」→「代理」。如果应用自己设了代理,检查它填写的地址、端口和代理协议是否与实际入站一致。

只看到 failed to find an available destination,能判断是 DNS 吗?

不能。这是尝试建立出站连接失败时的概括,不代表域名解析一定有问题。往后找具体一层:有 lookup 和 no such host 再查域名拼写与解析;已经出现目标 IP 和拨号超时,则先查到该 IP 与端口的连接。

节点能用,为什么订阅更新还是超时?

订阅更新访问的是订阅服务器,节点连通不等于订阅服务器可达。打开主界面「订阅分组」,对照「不通过代理」和「通过代理」的更新入口,先确认失败的是哪种方式。尝试通过代理更新前,先用当前节点验证网页能正常访问。分享更新日志时,移除订阅链接中的路径和查询参数。

日志偶尔出现 EOF,需要换节点吗?

先看网页请求是否真的失败。EOF 表示读到了流的末尾,单独出现时不能说明谁关了连接或为什么关闭。若同一操作总是在握手阶段触发 unexpected EOF,再核对远端端口和传输设置,并用同一测试请求复核。

下载客户端