适合遇到内核启动失败、节点测试超时或浏览器无响应的 v2rayN 用户。先确认本地监听是否建立,再按地址解析、远端连接、握手和路由的顺序定位。每轮只做一次测试、只改一项配置,用同一条请求验证改动是否生效。
日志级别与行格式
v2rayN 界面消息和内核日志不是同一层。界面显示启动内核,只说明客户端发起了启动操作;内核随后仍可能因配置解析失败而退出。订阅更新失败则可能发生在客户端获取订阅的阶段,不能直接当成当前节点的握手错误。
| 线索 | 读法 |
|---|---|
| 时间与请求编号 | 先找与测试时刻一致的日志;存在请求编号时,优先跟踪同一编号,避免把后台请求混进来。 |
error / warning | 检查失败和异常。出现告警不等于内核已退出,要看后续是否继续监听或处理请求。 |
info / debug | 用于查看更多处理过程。短时开启以捕获问题,取证后恢复原级别,避免积累大量访问记录。 |
accepted | 访问日志出现这类记录,说明内核接收了请求,不代表远端响应已返回。 |
错误链里的 > 常把外层操作和底层原因串在一起。看到“连接失败”先不要停,继续找后面的 lookup、dial tcp、x509 或文件路径。同一条错误可能被多个组件转报;优先处理带具体地址、端口或文件名的那一段。
按一次请求采集日志
记下当前配置
记录选中节点、实际内核、系统代理状态与 TUN 状态。桌面端可从「设置」→「参数设置」查看本地监听相关选项;菜单译名随版本变化时,以配置页所示端口和启动日志为准。
核对日志级别
在「设置」→「参数设置」中查看当前版本提供的日志选项;若有内核日志级别,优先临时选
info。对于自定义 Xray 配置,相关字段为log.loglevel。不要直接修改客户端下次启动会重新生成的配置。只发一次请求
确认内核仍在运行后,用浏览器打开一个已知正常的测试页面,记下操作时间。先暂停批量测速,避免同时生成多条连接。问题只出现在订阅更新时,则只执行一次更新,不同时发起网页测试。
提取首个原因
保留启动行、失败行和相邻的错误链。对外分享前遮去订阅地址、节点地址、身份字段和访问目标,保留错误关键字、端口类别及时间顺序。调整后重新执行同一操作,确认旧错误消失且实际请求成功。
端口占用与本地代理入口
先查报错地址,不只看端口号
若日志写的是 listen tcp 127.0.0.1:10808,先查本机监听进程;若写的是 dial tcp 加远端地址,则核对节点端口与连通性。改本地代理端口不会修复远端连接问题。
在 Windows PowerShell 中查询指定端口的监听进程。下面的端口仅用于演示,执行前替换成日志给出的本地端口。
Get-NetTCPConnection -State Listen -LocalPort 10808 |
Select-Object LocalAddress, LocalPort, OwningProcess
在任务管理器的「详细信息」页按 PID 核对进程。若是重复运行的客户端,先正常退出多余实例;若端口属于仍需运行的应用,在 v2rayN 中换用空闲端口,并同步调整手动填写代理地址的应用。重启内核后,同时确认新端口已监听、应用使用的是同一个端口和对应的代理类型。
连接超时、握手失败与规则文件缺失
下列关键字可能出现在完整错误链的不同位置,具体前缀及标点会随内核和平台变化。先确认报错描述的是哪一个操作,再考虑改配置。
报错:i/o timeout
原因:某次读写或连接等待超时,单凭这段文字不能确定故障位置。
解法:若前面是 dial tcp,先核对远端地址与端口;若前面是 lookup,先检查域名解析及 DNS 路径。
报错:connection refused
原因:连接被拒绝,常见于对端没有在该端口监听,也可能是中间设备主动拒绝。
解法:先区分目标是回环地址还是节点地址,再分别检查本地监听或向服务提供方确认远端服务端口。
报错:x509: certificate signed by unknown authority
原因:TLS 客户端无法把对端证书链验证到受信任的根证书。
解法:确认连接的是预期服务,由服务维护方检查证书链;使用组织内部证书时按管理员提供的流程配置信任,不要关闭证书验证。
报错:address already in use
原因:绑定的本地地址和端口与已有监听冲突。
解法:按报错端口查监听进程,退出确认多余的实例,或修改本地入站端口并同步应用代理设置。
报错:failed to load geoip
原因:内核未能加载配置引用的 IP 规则数据,可能是文件打不开,也可能是指定分类无法从数据中读取。
解法:看内层错误给出的路径与分类名;若系统提示找不到文件,检查实际资源目录并恢复与规则配置配套的数据文件,若提示分类不存在,则核对规则引用。
geoip.dat 用于 IP 分类,geosite.dat 用于域名分类。自定义配置还可能引用其他数据文件。客户端目录里有同名文件,并不证明正在运行的内核从该目录读取;以错误链中的路径为准。若日志出现权限错误,检查运行账户能否读取文件,而不是重复下载。若加载规则时内核已退出,应先修复启动问题,再测节点。
TCP 已建立但 TLS 握手失败时,再核对节点配置中的传输安全类型、serverName 与服务端要求是否一致。证书有效期错误还要检查系统日期和时间同步。端口连通只说明 TCP 能建立,不能证明 TLS、节点认证或应用请求成功;不要用一次端口探测替代实际访问测试。
常见日志疑问
节点测试有延迟,为什么网页还是打不开?
先确认测试使用的节点与当前活动节点一致。再打开一个页面,找同一时刻的内核访问记录。有记录时核对路由和出站错误;没有记录时先确认访问日志已启用,再检查浏览器是否遵循系统代理,或是否保留了旧的手动代理端口。
只有更新订阅时超时,该查节点吗?
先看超时对应的是订阅请求还是节点连接。记录一次手动更新的时间,检查订阅分组内的地址、更新时选择的连接方式,以及该方式当前能否工作。现有节点仍可用时,不要为了修复更新而先删除整个订阅分组。
日志有 accepted,怎么判断是不是走错出站?
查同一请求后续显示的出站标签;若当前日志未显示标签,可短时提高级别。对照实际生效配置中规则的匹配顺序,检查 routing.rules 的 outboundTag 是否引用预期的 outbounds 标签。不要仅凭接收记录判断分流结果。
开启 TUN 才出问题,应该从哪一行看?
先保存失败现场,再关闭 TUN,用同一节点通过系统代理测试同一页面。如果只有 TUN 失败,回看启用时最早出现的虚拟网卡、权限、路由或 DNS 错误。先区分虚拟网卡未建立和已建立但请求未正确转发,再决定查哪项设置。