查看文档目录

DoH 服务

DoH 服务:让节点按 RFC 8484 用 HTTPS 回答平台网站域名的 DNS 查询,配置主机名、节点范围、解析范围、限速、鉴权和上游。

作用

节点按 RFC 8484 提供 DNS over HTTPS(路径 /dns-query),回答平台上网站域名和平台 CNAME 域名的查询,答案与平台调度一致。客户端把它配置成 DoH 服务器即可使用。

使用场景

  • 客户端或应用要通过加密通道解析你的网站域名,避免被本地 DNS 劫持。
  • 想让解析结果和平台调度保持一致,并按客户端所在网络返回就近线路。

在哪里配置

控制台:系统,DoH 服务。保存后节点在重新发布后生效;页面顶部显示范围内有多少节点,其中多少个节点版本支持 DoH。未开启时节点不加载 DoH 模块。

配置项

区块配置项默认值说明
服务与地址开启 DoH 服务关闭总开关
DoH 主机名无平台上一个网站的主域名,使用该网站已绑定的证书;承载该网站的节点才提供 DoH
端口443必须是该网站已有的 HTTPS 端口
节点范围范围全部节点全部节点、指定线路组、指定节点
解析范围自动包含无需设置本节点承载的网站域名(含通配)和平台 CNAME 域名
追加平台域名空该域名及其子域名一并纳入
接受的查询类型A、AAAA、CNAME、HTTPS可加 SVCB、TXT;ANY、AXFR 等查询始终拒绝
防护每个客户端 IP 每秒查询数20上限 10000
突发上限40
单个响应上限4096 字节512 到 65535
鉴权不鉴权不鉴权、路径令牌、Bearer 令牌
上游上游地址223.5.5.5、119.29.29.291 到 4 个,IP 或 IP:端口,按顺序尝试
向上游带客户端子网(ECS /24)开启让上游按客户端所在网络返回调度结果
查询日志记录方式采样,比例 1%不记录、采样、全部;采样时填比例 1% 到 100%

选了鉴权后保存会自动生成令牌,令牌只显示一次;勾选“保存时重新生成令牌”会让旧令牌失效。页面顶部的“服务地址”就是要填给客户端的完整地址。查询日志写在节点本地日志目录的 doh.jsonl,随节点日志一起轮转。

常见问题

页面提示没有节点版本支持 DoH

先升级范围内的节点。

保存时提示找不到网站或主域名重复

DoH 主机名必须正好对应平台上唯一的一个网站主域名。

查询别的域名返回什么

返回 REFUSED,不会转发给上游。

适合把需要 DoH 的网站放在哪

节点只回答自己承载的网站,建议需要 DoH 的网站与 DoH 主机名所在网站放在同一线路组。

怎么查看查询记录

查询日志目前在节点本地的 doh.jsonl 里,控制台暂不查询。