接口地址
- 标准 DoH:
/dns-query - JSON 解析:
/resolve
DNS_API_KEY 可选鉴权
默认情况下,DNS 接口是公开的;当配置了 DNS_API_KEY 后,访问路径需要增加一个 key 前缀。
例如:
/test-key/dns-query?dns=AAABAAABAAAAAAAAA2RucwdleGFtcGxlA2NvbQAAAQAB/test-key/resolve?name=example.com&type=A
注意:路径中的 key 可能会出现在日志、浏览器历史或代理记录中,请使用高强度且 URL-safe 的随机值,并优先通过 Cloudflare secret 配置。
标准 DoH
/dns-query 实现标准 DNS over HTTPS 接口,支持 RFC 8484 风格的 GET 与 POST。
GET
使用dns 参数传入 base64url 编码后的 DNS wire message
-
/dns-query?dns=AAABAAABAAAAAAAAA2RucwdleGFtcGxlA2NvbQAAAQAB -
/<DNS_API_KEY>/dns-query?dns=AAABAAABAAAAAAAAA2RucwdleGFtcGxlA2NvbQAAAQAB
POST
请求与响应的Content-Type 均为 application/dns-message
JSON 解析
/resolve 用于直接获取可读 JSON 结果,默认查询类型为 A,支持
type、cd、do 参数。
-
/resolve?name=example.com&type=A -
/resolve?name=cloudflare.com&type=AAAA -
/resolve?name=example.com&type=MX&do=1 -
/<DNS_API_KEY>/resolve?name=example.com&type=A