阅读导航
遇到导入报错,应先留下原始提示和可恢复的配置。未取得文件与文件无法解析属于不同阶段;判断清楚以后,才能决定查来源、修文本结构还是调整客户端合并设置。
先区分获取失败与读取失败
记录响应状态、错误原话及位置提示。若拿到的是登录网页,应回查地址来源;若提示缩进或字段类型,则转向下载内容和内核兼容性检查。
由错误类型选择检查方向
| 错误线索 | 所在环节 | 处理起点 |
|---|---|---|
| 认证拒绝、路径失效或等待超时 | 尚未取得能加载的远程内容 | 核对凭据、接口路径和网络可达性 |
| 返回登录表单或账户提示 | 能访问地址,却没有取得配置文本 | 重新确认配置接口与普通网页的区别 |
| mapping values are not allowed | 层级关系或符号安排不正确 | 连同上层键及相邻项目一起检查 |
| unknown field、cannot unmarshal | 字段或取值类型超出当前内核支持范围 | 对照正在运行的内核说明 |
在受控环境识别返回内容
从本机开发工具读取响应头及文本开头,判断它更像配置、集合数据还是网页。登录表单、HTML 标记或账户错误提示,都不能当作可直接加载的 YAML。
接口路径与参数可能携带读取凭据。分享截图或日志前遮蔽敏感部分,无法判断时遮住整条地址;已经公开的地址应先撤销,再继续排错。
# 在自己控制的终端查看响应头
# 再查看返回文本的起始结构
# 对外只提供状态和已遮蔽的错误
# 不公开带认证参数的完整命令来源可能依据 User-Agent 输出不同格式。终端读取结果只能辅助比较,判断时应优先采用客户端更新过程中实际收到的内容。
把文本层级与字段兼容分开处理
冒号、引号、列表标记与缩进共同决定 YAML 层级。错误位置可能落在真正问题之后,因此应连同上层结构与前项结尾一起检查,不能只盯住提示位置。
名称中含特殊符号时应注意引号,同层项目也要采用一致缩进。先留存原件,在副本内逐项修改,重新解析以后再处理后续提示。
# proxy-groups 用来定义策略组
# proxies 在组内应保持列表形式
# DIRECT 可以作为列表中的项目
# 把整个列表写成普通字符串会改变数据类型通用解析工具只认识 YAML 结构,无法替代内核对字段、协议和引用关系的检查。结构通过而仍报未知字段或目标不存在时,应查内核支持范围及名称对应。
从启动日志或关于页面确认实际运行的内核,别只看客户端外壳。生成端与运行端可能支持不同字段,合并覆写也可能改变位置;升级或修改前先留下恢复途径。
先识别完整文件与集合数据
主配置承担端口、分组和分流设置;代理集合侧重出站条目;规则集合则按域名、地址网段或带类型的条件保存匹配数据。
集合文本即使语法成立,也未必包含独立运行所需的分组和规则。将集合入口当作完整配置,会出现缺项或没有预期分流的情况,应按主文件的引用机制接入。
完整运行文件也不能直接放进只接受集合列表的位置。先查看顶层键与来源给出的接入方式,再决定作为 Profile 载入还是由 provider 引用。
- 主运行配置
- 负责组织分组、规则与其他运行设置,可作为加载对象。
- 代理条目集合
- 通过 proxy-providers 供主配置引用。
- 匹配条件集合
- 由 RULE-SET 接入,内容结构须与声明的 behavior 对应。
检查副本及其合并产物
原始响应应留在自己控制的设备中,另存副本编辑。公开排错内容需再次遮蔽凭据,替代值不能回写运行文件。测试时采用当前内核的校验结果,并优先处理最先出现的错误。
原文件能加载而客户端失败时,应查看覆写、混入设置和脚本生成的最终结果。失效组名或重复顶层键可能在合并阶段被引入,不能直接认定远程文件损坏。
为什么只有合并结果找不到组?
旧条件或覆写可能还在引用已经删除的策略。
查最终文件内的名称对应,暂时关闭相关覆写,再比较加载结果。
收到网页内容能靠修缩进解决吗?
普通页面、过期登录与认证失败都可能让接口返回 HTML。
应重新取得正确的配置入口,再检查实际响应,修改网页缩进没有作用。
只有某个 Provider 失败怎么办?
问题可能出在来源地址、本地位置、内容声明或文件权限。
按集合类型追查对应字段,保留其余可用运行设置。
恢复工作状态并记下原因
无法加载时,先切回已知可用副本,或使用来源重新生成的配置。避免在唯一运行文件上连续手改,也不要让解析失败的版本自动载入。
把失败阶段、原始提示、运行版本和有效改动记录下来。再次更新后若故障重现,这些信息有助于区分来源变化、版本变化与本地合并问题。
