“突然不能用”描述的是感受,维护者很难据此定位问题。有效的故障材料应说明什么操作在什么环境失败,并附上那一小段相关日志。内容越完整不一定越有用;整天的日志往往夹杂大量无关请求和敏感资料。
先给一次失败划定时间窗
记录系统、客户端和核心版本、接管方式、目标任务及本地时间。关闭无关下载和页面,只重现一次问题,然后保存失败前后短时间内的记录。客户端界面日志与核心日志可能分开:前者能反映配置下载、权限和启动问题,后者更适合查看请求与出口。
以 Clash Verge Rev 为例,正式文档提供日志导出入口说明;导出只是收集方式,不代表文件已经脱敏。Clash Verge Rev:导出日志。日常不必长期打开最详细级别;临时提高日志等级后,应在排查结束恢复。
按失败阶段读,不凭一词下结论
配置解析错误先看字段与格式;本地监听失败先看端口与实例;解析失败看名称查询;连接超时再区分连接目标是节点还是最终网站。相同的 timeout 可能出现在不同阶段,不能直接翻译成“机场跑路”。认证拒绝也要确认来自订阅接口、节点还是目标平台。
假设记录显示核心已经启动,但浏览器失败时没有对应目标,材料应写“未观察到该请求进入核心”,而不是“节点无法连接”。假设记录有出口连接错误,就保留错误类别、目标端口类型和先后顺序,让别人能判断下一步需要查什么。
用替换表保持上下文
在副本中将订阅 token、密码、UUID、授权头、Cookie 和私钥完整替换。节点地址、访问域名、局域网地址与用户名目录按分享对象和排查需要缩减。需要保留关联时,用“节点甲”“目标乙”等固定代号,而不是每次随机遮盖,避免把同一对象看成多个对象。
截图还要检查窗口标题、地址栏、剪贴板提示、二维码和旁边其他窗口。分享前搜索常见凭据字段,并用纯文本方式重新打开导出文件。压缩包里可能同时带着配置,不能只检查其中一张截图就发出整个包。
用五句话提交问题
- 希望完成的具体任务。
- 实际观察到的失败与发生时间。
- 最少复现步骤和影响范围。
- 已做过的单变量对照及结果。
- 对应的脱敏日志片段与版本信息。
如果只有一个应用失败,应明确其他应用是否正常;如果只在某个网络发生,应记录切换网络后的结果。不要伪造测试、抹掉有意义的错误字段,或把猜测写成确定结论。凭据若已经公开,应按服务方支持的方式重置或撤销,删帖不能保证泄露内容从未被保存。