Remote Subscriptions

🔗 远程订阅与客户端拉取

本页解释远程 HTTP 订阅由谁下载。这个区别会影响访问成功率、筛选能力、隐私边界和出站代理设置。

处理方式概览

目标	生成方式	后续下载者
clash、clashr	proxy-providers	Mihomo/ClashR 客户端
quanx	server_remote	Quantumult X
surge	policy-path	Surge
surfboard	policy-path	Surfboard
loon	Remote Proxy	Loon
stash	Stash proxy-providers	Stash
其他目标	后端下载、解析、再输出	SubConverter-Extended

客户端拉取的优点和限制

优点：

• 客户端使用自己的网络环境和 User-Agent 更新订阅；
• 后端不需要保存或解析远程订阅正文；
• 客户端可以按自己的更新周期刷新远程资源。

限制：

• 客户端必须支持相应远程资源格式；
• 后端无法验证远程订阅正文是否真的适合客户端；
• 后端的 proxy_subscription 不控制客户端后续下载；
• 远程资源的筛选、重命名和覆写能力取决于客户端格式。

Mihomo Proxy Provider

默认 target=clash 远程订阅会生成：

proxy-providers:
  Provider_XXXXXX:
    type: http
    url: https://example.com/sub
    interval: 3600
    proxy: DIRECT
    path: ./providers/Provider_XXXXXX.yaml

proxy: DIRECT 和 interval 可以由单条订阅、请求参数或部署配置覆盖。详见特色参数与扩展语法。

list=true

target=clash&list=true

此时请求要求生成节点列表，远程订阅会由后端下载和解析，不再只是生成 Provider。它适合确实需要后端过滤或展开节点的场景，但也意味着：

• 后端必须能够访问订阅；
• proxy_subscription 开始影响下载；
• 后端会处理订阅正文；
• Mihomo Provider 的客户端自动更新优势不再适用。

Quantumult X

远程订阅生成 server_remote。支持：

• provider: 自定义资源标签；
• tag: 关联来源标签；
• interval: 指定更新间隔；
• 直接节点链接继续由兼容解析器处理。

proxy_direct: 不适用于 Quantumult X。

Surge

开启 remote_subscription.surge_policy_path 时，远程订阅生成 policy-path。支持正数 interval:。如果部署者关闭此选项，远程订阅会回到后端解析路径。

Surfboard

开启 remote_subscription.surfboard_policy_path 时，远程订阅生成 policy-path。当前扩展不允许为 Surfboard 指定 interval:，更新周期由客户端行为决定。

Loon

开启 remote_subscription.loon_remote_proxy 时，远程订阅生成 Remote Proxy。可以使用 provider: 自定义远程资源名称，但不接受 interval: 或 proxy_direct:。

Stash

Stash 使用独立模板和独立 Provider 生成器，不复用 Mihomo Provider 字段。

支持：

• provider: 自定义 Stash Provider 名称；
• 正数 interval:；
• provider_headers 选择当前请求中允许的请求头；
• include / exclude 生成 Stash 能表示的过滤条件。

不支持：

• provider_proxy_direct；
• 单条 proxy_direct:；
• 把任意未知 Clash Provider 字段直接复制到 Stash。

服务商返回内容仍需符合 Stash 能够读取的 Provider 格式。后端只生成引用，不保证任意 Base64 订阅都能由 Stash 直接解析。

服务端解析目标

其他目标会由后端下载订阅并使用兼容解析器转换。此时：

• proxy_subscription 决定后端下载策略；
• include、exclude、rename 等可以作用于已解析节点；
• 后端必须能够访问订阅；
• 订阅正文会进入后端进程内存；
• 目标生成器会过滤无法表示的节点。

Provider 前缀适用范围

前缀	Clash/ClashR	QuanX	Surge	Surfboard	Loon	Stash	其他目标
provider:	✓	✓	✓	✓	✓	✓	不作为远程资源名称
tag:	✓	✓	✓	✓	✓	✓	节点来源标签
interval:	✓	✓	正数	×	×	正数	×
proxy_direct:	✓	×	×	×	×	×	×

前缀只对远程订阅项生效。把 interval: 或 proxy_direct: 加到节点链接上会返回 HTTP 400。

隐私边界

“客户端拉取”表示后端不下载订阅正文，不表示后端完全看不到订阅 URL。URL 仍可能出现在：

• /sub 请求的查询参数；
• 浏览器历史；
• 反向代理或 CDN 请求日志；
• 生成配置的 Provider URL；
• 客户端本地配置。

敏感订阅应优先自行部署，并避免在入口代理日志中记录完整查询字符串。