v2rayN 排查指引
v2rayN 是 Windows 上的多核心管理器：同一个界面可以驱动 Xray、sing-box 等不同核心，不同核心的日志格式与报错措辞并不相同。排查前先在设置里确认当前用的是哪个核心——对照日志时这决定了你该按哪套"方言"理解。
关键入口
- 主界面底部信息栏：实时滚动核心输出，双击可打开完整日志窗口；
- 日志文件：程序目录的
guiLogs与核心日志目录，崩溃类问题看文件比看窗口全； - 系统代理状态：主界面下方的系统代理模式指示（清除/自动配置/全局），与系统代理类故障直接相关。
常见报错与错误码对照
| 日志中的报错片段 | 对应错误码 | 排查文档 |
|---|---|---|
dial tcp: i/o timeout | TCP-001 | TCP 连接超时 |
actively refused / connection refused | TCP-002 | 连接被拒绝 |
connection was forcibly closed | TCP-003 | 连接被重置 |
tls: handshake failure / 超时 | TLS-002 / TLS-003 | 握手超时 / 握手中断 |
x509 证书类 | TLS-001 / TLS-004 | 证书校验失败 |
unexpected EOF | TLS-003 | 握手期间被断开 |
| 订阅更新失败提示 | SUB-001~004 | 订阅更新失败 |
| 端口被占用 / 启动失败 | PROXY-003 | 代理端口未监听 |
v2rayN 特有的注意点
- 端口体系：v2rayN 有多个本地端口（SOCKS、HTTP，版本不同默认值不同，常见 10808/10809），系统代理和第三方应用引用的端口要与设置页当前值一致——升级大版本后默认端口变过不止一次，老配置的引用是"升级后连不上"的高频原因；
- 多核心切换：切换核心类型后，部分协议字段的支持范围会变化，原本正常的节点可能解析失败；
- 以管理员运行：TUN 模式需要管理员权限，普通权限下 TUN 启动失败但界面可能不明显提示；
- 退出残留：任务栏强制结束进程会留下系统代理残留，恢复方法见对应文档。
通用取证流程
connproof tcp 127.0.0.1 --port 10808先确认本地端口监听正常，再对节点做分层检测：
connproof diagnose 节点域名 --port 节点端口两步的结果组合能把"客户端没起来"“配置错位"和"链路故障"清晰地分开。