把内容、来源和选择分成三个层次
主配置的proxies保存逐项节点定义。proxy-providers声明一组节点内容的来源和读取方式;它并不决定所有请求最后走哪个出口。proxy-groups再把这些候选组织成可选择的策略。订阅与节点栏目以这三个层次组织资料,便于定位修改会影响哪一部分。
主配置中组内的proxies列表用于引用节点或策略名称,虽然字段拼写相同,其位置与主配置顶层proxies不同。阅读片段时要先看父级,不要仅搜索一个字段名就照抄。提供者名称应唯一,并尽量与代理组名称区分。
三种提供者,三种内容入口
| 类型 | 内容位置 | 维护要点 |
|---|---|---|
| http | 由远程URL取得 | 核对响应格式、更新间隔和本地缓存路径 |
| file | 读取本地文件 | 确认目录、权限和文件实际内容 |
| inline | 由payload内联给出 | 随主配置一起维护,无远程拉取步骤 |
远程链接可能返回完整配置、代理提供者YAML,也可能返回其他客户端的订阅格式。这些内容不能机械互换。提供者文件应符合其支持的节点载荷结构;返回登录页、错误页面或不支持的编码内容,即使HTTP成功也不等于节点已解析。
用稳定名称连接来源和代理组
proxy-providers:
source_local:
type: file
path: ./providers/source-local.yaml
proxy-groups:
- name: "来源选择"
type: select
use:
- source_local演示假定本地提供者文件已存在且内容有效。组内use引用source_local这个提供者名称,而不是文件路径或节点显示名。换用新来源时,改名后必须同步所有use引用;具体选择方式见代理组策略区别。
每个提供者使用独立路径,避免不同远程内容写入同一缓存文件。路径默认受核心HomeDir安全范围约束;先检查工作目录设置,不要直接扩大文件访问范围。相对路径应按实际核心目录解析,不能凭编辑器打开文件的位置推断。
来源变化前,建立一张核对表
为每个来源记录非敏感的标识、类型、维护责任与引用它的组。节点名发生变化时,手工按名字引用的配置更容易断开;过滤规则也可能让新节点全部被排除。查看过滤前后候选数量,确认名称冲突,而不是靠反复重建代理组尝试。
订阅URL常包含凭据,截图、日志与备份共享前应脱敏,不要上传完整地址到公开转换服务。出现旧节点持续显示时,应转入更新结果与缓存状态排查,分别判断远程内容、本地文件和活动配置。来源清楚之后,更新才有明确的检查对象。
让来源名称稳定、路径独立、组引用可追踪。以后更换节点内容时,就能把变化限制在对应资料层,而不必重写全部规则。


