本文目录
节点看起来可用,自定义 DoH 却解析失败;换一个 DNS 又正常。先保留当前配置和第一条错误,不要同时换节点、改规则或关闭证书校验。
先确认是原生 Mac 的目标 DoH 查询失败
本文面向已在原生 Stash Mac 使用自有 YAML、知道当前活动配置并能保留可恢复副本的用户,处理仅支持 HTTP/1.1 的 DoH 上游兼容问题。
官方 Mac 更新源在 5.0.0(build 607)说明:服务不支持 HTTP/2 时改用 HTTP/1.1。它不是所有 DNS 失败的统一修复,也不能用其他平台的版本号代替实际 Mac 应用版本。
先从上游提供方的协议说明或服务端连接记录核对是否仅支持 HTTP/1.1。浏览器能打开 DoH 地址,只能说明这次浏览器访问的结果,不能证明 Stash 已成功发出 DNS 查询,也不能据此确定上游只支持某个 HTTP 版本。
先按失败阶段判断
| 看到的现象 | 应先核对什么 |
|---|---|
| 同一个自定义 DoH 失败,其他已知可用上游正常 | 继续检查目标上游协议与实际查询路径 |
| 节点域名本身无法解析 | 另查 proxy-server-nameserver 和启动解析链路 |
| 连接超时或证书校验失败 | 核对该上游的网络、地址和证书,不直接认定 HTTP/1.1 兼容问题 |
| 网页仍能打开,但看不到新 DNS 查询 | 缓存可能掩盖结果,不能据此宣布目标上游正常 |
保留原配置,在副本核对实际 DNS 路径
先另存正在使用的完整 YAML、自己的覆写和原节点选择,保留可重新启用的原配置。不要直接改唯一的托管配置或依赖尚未确认可恢复的云端状态;测试使用自己维护的副本。
Stash 的 nameserver 配置多个上游时会并发查询并采用最快响应的结果。另一个上游成功,可能掩盖目标 DoH 仍然失败;nameserver-policy 和 fallback 也会改变实际使用的解析服务器。
启用的覆写可能重新合入其他上游:数组默认以前插方式合并,先核对最终实际 nameserver,不能只看原 YAML 文本。
如需对照,在副本的现有 dns 块内,让 nameserver 暂时只保留原来那个目标 DoH;选择不会被 nameserver-policy 或 fallback 改道的测试域名,确认启用的是这份副本。无法确认实际路径时先停止修改,不能把混合结果当作单一上游验证。
记录原来的 follow-rule。默认 DNS 请求不跟随代理规则;开启后还要核对 DNS 上游的连接规则与启动解析,避免递归。proxy-server-nameserver 用于代理服务器域名,有独立查询链路,不能把它的成功当作普通目标域名已由 nameserver 解析。
本轮对照只改变必要的上游列表,不同时切换 follow-rule、节点或接管方式,也不把强制使用其他 HTTP 传输方式当作这项修复。不要关闭 TLS 证书验证来换取看似成功的结果。
更新原生 Mac 应用,保留同一个 DoH 上游
用同一份副本做前后对照
记录应用版本和原始失败
查看实际运行的原生 Stash Mac 版本与 build,保存目标 DoH 地址、相关 DNS 设置和脱敏错误。不要仅凭商店页面、订阅名称或另一个设备的版本判断。
正常退出并更新原生应用
先确认当前系统与许可适用于目标版本。在允许中断当前网络时正常停止并退出应用,从原生 Mac 官方更新渠道取得 5.0.0(607)这项修复;不能更新时先按下方方法恢复工作。保留原数据和配置,不安装来源不明的旧包,不用更换内核文件代替完整应用更新。
重新选中原测试配置
重开后核对实际版本与 build,选中保存好的测试副本,再按原方式启动。目标 DoH、节点和规则保持一致;若配置校验或应用启动失败,先处理该阶段错误。
不能更新时先恢复工作
先切回原配置,使用自己此前验证可用的加密 DNS 上游。保留失败记录与测试副本,等可更新时再做同一对照;临时换上游不代表兼容问题已经修复。
本文核对的是 5.0.0(607)的官方修复。若以后使用另一个版本,应核对其发布渠道和同项修复证据;不需要为了版本号相同而降级,也不承诺官方渠道能够安装任意历史版本。
确认产生了新查询,再验证实际访问
Stash 会缓存 DNS 结果;缓存过期后也可能先沿用旧结果并在后台刷新。旧网页仍能打开、一次延迟测试成功,或只等了一段时间,都不能单独证明目标 DoH 已经恢复。
在自己的测试域名和允许的日志范围内,确认确实产生了新的 DNS 查询,且使用的是目标 DoH;有服务端权限时可结合该上游的请求记录。无法确认新查询或实际上游时,把这一项记为尚未验证,不编造成功结果。随后重新发起需要该域名的新连接,确认实际网页或业务能访问。
完成本题的验证清单
- 实际运行的是包含修复的原生 Stash Mac,已核对版本与 build。
- 当前测试配置、目标 DoH 和原节点明确,测试域名没有被其他 DNS 路径改道。
- 确认发生了新的目标上游查询,而不是仅复用了已有缓存。
- 原来的相关解析错误不再出现,依赖该域名的新业务连接正常。
- 恢复需要的正常配置后再次核对,原配置与可用上游仍然可以回退。
本站依据官方 Mac 更新源与 DNS 文档给出判断和操作建议,没有在你的网络或真实 Stash 客户端复现故障。网站的五语言、源码与浏览器检查不等于设备上的 DoH 或业务连接测试。
仍然失败时恢复原配置,按首条错误继续排查
更新后目标 DoH 仍超时或证书报错
恢复原配置与已知可用的加密 DNS;核对目标地址、可达性、证书和提供方状态。不要把所有网络错误继续归为协议兼容,也不要关闭证书验证。
换配置后节点域名也解析不了
先切回原配置,核对 proxy-server-nameserver、DNS 上游域名的启动解析和原 follow-rule。恢复原有可用链路,不同时追加更多 DNS 或路由修改。
测试成功,但恢复正常配置又失败
逐项核对 nameserver-policy、fallback 和覆写后的实际设置;保留单上游测试与原配置对照。另一上游成功或缓存命中不能证明目标 DoH 一直正常。
应用无法启动或配置校验失败
先恢复原可用配置并停止叠加修改;保存应用版本、校验错误和操作记录,按对应阶段求助。不要删除唯一的数据目录或依赖不可确认的旧版本回退。
求助时提供 macOS、Stash Mac 版本与 build、上游协议依据、脱敏的 DNS 片段、首条错误及新查询验证结果。隐藏带令牌的 DoH URL、订阅地址与私有域名;保留原始完整记录供自己恢复使用。
