先选一种清楚的来源组织方式
顶层proxies可直接写节点定义;proxy-providers管理一组节点内容的来源。来源可以是http远程文件、file本地文件或inline内联payload,具体选择取决于维护方式。三者不等于不同的代理协议,也不等于代理组。节点来源手记对比了字段层级。
| 来源类型 | 主要字段 | 常见检查点 |
|---|---|---|
| http | url、path、interval | 地址可访问,响应内容符合格式,缓存路径独立 |
| file | path | 文件存在,路径可读取,载荷结构正确 |
| inline | payload | 节点对象有效,与主配置一同维护 |
从提供者到代理组
YAML · 演示片段,不用于真实连接
proxy-providers:
archive_local:
type: file
path: ./providers/archive.yaml
proxy-groups:
- name: "节点选择"
type: select
use:
- archive_local这是关系演示,运行前仍需准备有效的本地提供者文件。use引用提供者名称;组内proxies则按名称引用节点或其他策略。如何手动选择、检测选择或顺序回退,见三种代理组的差别。
节点名称要能区分来源,避免冲突。filter和exclude-filter等筛选可能改变组内候选,不要因为远端新增节点就假定它一定会出现。提供者名称与路径分别保持唯一,改名后同步引用。
URL有效,不代表内容兼容
有的订阅返回完整配置,有的返回提供者YAML,也有其他编码格式。读取方式必须与实际格式相符,不能将文件改名就当作转换。遇到登录页、认证失败或远端错误响应,先检查内容类型和解析错误。
http提供者的interval以秒计,控制内容更新,和节点健康检查不是同一个间隔。本地路径默认受核心HomeDir范围约束,应结合工作目录核对;先检查权限和路径,不要急着放宽安全限制。
更新后沿着状态链核对
先确认远端内容变化,再检查下载结果、本地缓存与解析出的候选。最后核对当前组use引用和活动配置。订阅更新排查说明了缓存未变、写入失败和候选未刷新等不同情况。
私人订阅URL可能包含Token,日志和截图对外分享前去除凭据。备份也应妥善保存;主文件字段不确定时,返回配置入门先确认层级。
