用户需登录云解析DNS产品控制台，点击左侧导航栏中的公共DNS，在公共DNS页面点击更多页签下点击产品接入栏的查看详情按钮。

在产品接入页面下载并安装SDK就能进行快速接入，现已支持iOS和安卓的接入。

Android SDK开发指南请参考：Android SDK开发指南

iOS SDK开发指南请参考：iOS SDK开发指南

对于企业用户，我们支持DoH JSON API的调用：

DoH JSON API的URL接口（提供TLS和非TLS API）

https://dns.alidns.com/resolve?

https://alidns_ip/resolve?

http://dns.alidns.com/resolve?

http://alidns_ip/resolve?

其中alidns_ip是dns.alidns.com的A记录，可以是以下两个地址之一 ：223.5.5.5，223.6.6.6。

请求方式：GET

请求参数，参考下表：

参数

类型

描述

实例

使用方法和默认值

name

string

请求域名

name=www.taobao.com

必选，无默认值

type

number

请求类型

type=1

可选，1

edns_client_subnet

IP

ECS IP

edns_client_subnet=1.2.XX.XX/24

DNS代理使用，普通客户端不适用

short

boolean

是否开启简洁模式

short=true or short=1

可选，默认关闭

uid

string

用户ID，即控制台上的Account ID

uid=6666

可选

关于edns_client_subnet参数：

edns_client_subnet是为了支持DNS ECS功能（RFC7871），将用户的子网信息传递给权威DNS，做更精确的DNS解析和流量调度。其中掩码越长地址信息越精确，掩码越短用户隐私效果越好。建议使用“/24”掩码长度

注：该参数是特地为DNS代理（proxy）使用DoH JSON API场景设计，即用户发送DNS查询给DNS代理，DNS代理通过该参数携带用户的子网信息传递给阿里公共DNS，最后传递到权威DNS服务器。

例如edns_client_subnet=1.2.XX.XX/24，权威服务器会收到基于1.2.XX.XX/24地址前缀信息来帮助用户选择DNS链路。

关于type参数支持类型：

记录类型

ID

意义

示例（以 taobao.com，www.taobao.com为例）

A

1

IPv4地址

101.37.XX.XX

NS

2

NS记录

ns1.taobao.com

CNAME

5

域名CNAME记录

www.taobao.com.danuoyi.tbcache.com

SOA

6

ZONE的SOA记录

ns4.taobao.com. hostmaster.alibabadns.com. 2018011109 3600 1200 3600 360

TXT

16

TXT记录

"v=spf1 include:spf1.staff.mail.aliyun.com -all"

AAAA

28

IPv6地址

240e:e1:XXXX:1:3::3fa

请求示例：

http://dns.alidns.com/resolve?name=www.taobao.com.&type=1

返回示例：

{ "Status": 0, "TC": false, "RD": true, "RA": true, "AD": false, "CD": false, "Question": { // 请求段 "name": "www.taobao.com.", "type": 1 }, "Answer": [ // 应答段 { "name": "www.taobao.com.", "TTL": 45, "type": 5, "data": "www.taobao.com.danuoyi.tbcache.com." }, { "name": "www.taobao.com.danuoyi.tbcache.com.", "TTL": 45, "type": 1, "data": "47.246.XX.XX" }, { "name": "www.taobao.com.danuoyi.tbcache.com.", "TTL": 45, "type": 1, "data": "47.246.XX.XX" } ] //"Authority" 为权威段, 如果有数据，需要与Answer字段一致 //"Additional" 为附加段, 如果有数据，需要与Answer字段一致 // 可配置"edns_client_subnet":"1.2.XX.XX/24" }

用户可以在客户端应用或手机应用中调用DoH和DoH JSON API解析DNS。

公共DNS支持在安卓手机、浏览器上配置DoT/DoH服务，以下是配置教程。

获取user_id

登录公共DNS控制台，在概览页下方的Account ID即为此处定义的user_id。

如下图所示，本示例中的user_id即为9999。

终端设备配置DoT解析服务器

终端设备配置DoT的解析服务器是：

dns.alidns.com

alidns_ip

user_id.alidns.com

第三种服务器中的user_id即为Account ID（本示例为：9999），即为：9999.alidns.com。

接下来，将以安卓手机（Mi 10S）为例，介绍如何配置DoT解析服务器。

进入设置界面，点击【连接与共享】；

点击【私人DNS】；

选择【私人DNS提供商主机名】并填写阿里云公共DNS服务器名称。

获取user_id

登录公共DNS控制台，在概览页下方的Account ID即为此处定义的user_id。

如下图所示，本示例中的user_id即为9999。

DoH接口有如下三种，现按照第三种接口的配置进行演示：

https://dns.alidns.com/dns-query

https://alidns_ip/dns-query

https://user_id.alidns.com/dns-query，

如果使用user_id方式，请提前到云解析DNS产品控制台，在左侧导航栏选择公共DNS，在更多页签下点击产品接入栏中的查看详情。

在产品接入界面，将DoT/DoH接入栏中的接入状态按钮打开。

第三种接口中的user_id即为第一步中获取的Account ID（本示例为：9999），即为：https://9999.alidns.com/dns-query

配置DoH

第一步：从 Firefox 菜单栏中点击 【选项】设置。

第二步：搜索框中输入“DNS”，点击【网络设置】中的【设置】按钮。

第三步：在设置页面的底部，找到并勾选“启用基于HTTPS的DNS”，选择“自定义”的提供商，并输入接口地址：https://9999.alidns.com/dns-query，点击【确定】。

第一步：打开Chrome浏览器，从 Chrome 菜单栏中点击 【设置】选项。

第二步：在搜索框中输入“DNS”，在下方的检索结果中，点击【安全】右侧的展开箭头。

第三步：页面下拉到最下方，在【高级】选项中，开通“使用安全DNS”功能，并在【使用】-【自定义】框中输入“https://9999.alidns.com/dns-query”即可完成配置。

备注：

DoT接口的详细说明，请参考：DNS over TLS （DoT）

DoH接口的详细说明，请参考：DNS over HTTPs(DoH)