⚙️ 配置

上游按下面的顺序解析，命中即用：

顺序	模式	条件
1	`subscription`	有「节点配置」或填了 `subscriptionUrl` —— 自包含，不需要本机 Clash，并且能选节点
2	`explicit`	填了 `proxyUrl`（`http://` / `socks5://`），或订阅拿不到节点时的兜底
3	`environment`	都没填，但 `$HTTPS_PROXY` / `$HTTP_PROXY` 有值（就是 `.env` 里那份）
4	`none`	都没有：境外目标直接报错并给出可操作提示，境内目标仍可直连下载

为什么订阅优先：订阅给的是一份可选节点的列表，proxyUrl 只是一条固定上游。两者都填时若让 proxyUrl 赢，就会出现"填了订阅却没反应、也没有节点可选"——这是 v0.3.1 及以前的实际行为，v0.4.0 起修正。

字段	默认	说明
`enabled`	`true`	总开关
`proxyUrl`	空	一条固定上游；两种情况下才生效：抓订阅时当代理用、以及订阅拿不到节点时兜底
`subscriptionUrl`	空	单条订阅地址（同「节点配置」的导入源）；优先级高于 `proxyUrl`
`fetchProxyUrl`	空	只用于抓订阅本身（订阅被墙时填，必须是 `http(s)://`）
`autoUpdateHours`	`24`	旧版单条订阅的自动更新间隔，也是新导入配置的默认间隔；`0` 关闭
`groupType`	`url-test`	`url-test` 自动最快 / `select` 手动 / `fallback` 失败切换
`preferredNode`	空	按名字固定一个节点
`latencyTestUrl` / `latencyTimeoutMs`	gstatic 204 / `3000`	节点健康检查 URL 与超时
`domesticDirect`	`true`	关掉则所有下载都走代理（AI 平台仍直连）
`protectAiPlatforms`	`true`	国内 AI 平台域名强制直连，最高优先级
`extraDirectDomains`	`[]`	追加强制直连的域名（支持完整 URL 与 `*.x.com`）
`guardShellDownloads`	`true`	拦住没走代理的境外 shell 下载，提示改用 `dsh_run_proxied`
`extraRules` / `excludeRules`	`[]`	追加 / 剔除规则行
`downloadDir`	空	空 = `$DSH_HOME/downloads`
`maxDownloadMb`	`512`	单文件大小上限
`downloadTimeoutS`	`600`	单次下载总超时
`stallTimeoutS`	`30`	无数据停滞多久判定卡死
`threads`	`4`	多线程下载的分片连接数；`1` = 单连接。服务端不支持 `Range`、响应不可信、或文件 .yaml`（每份配置正文），以及旧版单条订阅的` subscription.yaml`缓存与选中节点的`state.json`。

@having5548/dsh-downloader

安装

说明文档

⚙️ 配置