一步步教你配置阿里云公共DNS：适用于所有平台

企业用户

1.1 SDK接入

用户只需登录控制台，在SDK下载页面下载并安装SDK就能进行快速接入，现已支持iOS和安卓的接入，后续我们将提供更丰富的SDK。

• Android SDK开发指南
• iOS SDK开发指南

1.2 DoH JSON API接入

对于企业用户，我们支持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

请求参数参考下表：

关于 edns_client_subnet 参数：
该参数是为了支持DNS ECS功能（RFC7871），将用户的子网信息传递给权威DNS，做更精确的DNS解析和流量调度。建议使用“/24”掩码长度。

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

关于 type 参数支持类型：

请求示例：

返回示例：

1.3 DoT/DoH配置

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

DoT配置

Android配置

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

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

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

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

注意: 第三种服务器中的user_id即为第一步中获取的Account ID（本示例为：9999），即为：9999.alidns.com。

如下图所示，安卓手机配置示意图：

DoH配置

Firefox

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

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

DoH接口有如下三种：

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

2. 配置DoH：
3. 从 Firefox 菜单栏中点击 【选项】设置。
   
4. 搜索框中输入“DNS”，点击【网络设置】中的【设置】按钮。
   
5. 在设置页面的底部，找到并勾选“启用基于HTTPS的DNS”，选择“自定义”的提供商，并输入接口地址：https://9999.alidns.com/dns-query，点击【确定】。
   

Chrome

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

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

DoH接口有如下三种：

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

2. 配置DoH：
3. 打开Chrome浏览器，从菜单栏中点击 【设置】选项。
   
4. 在搜索框中输入“DNS”，在下方的检索结果中，点击【安全】右侧的展开箭头。
   
5. 页面下拉到最下方，在【高级】选项中，开通“使用安全DNS”功能，并在【使用】-【自定义】框中输入“https://9999.alidns.com/dns-query”即可完成配置。
   

备注:

• DoT接口的详细说明，请参考：DNS over TLS（DoT）
• DoH接口的详细说明，请参考：DNS over HTTPs(DoH)

普通用户

2.1 Windows配置

Windows 10

1. 打开Windows 10系统控制面板，点击右上角的以图标方式显示，点击“网络和共享中心”选项。
   
2. 点击网络和共享中心左侧的“更改适配器设置”链接。
   
3. 选中正在联网的网络连接（如WIFI连接），右键选择“属性”。
   
4. 针对IPv4和IPv6的操作不同：
   • IPv4——选中“Internet 协议版本 4 (TCP/IPv4)”，然后点击“属性”。
   • IPv6——选中“Internet 协议版本 6 (TCP/IPv6)”，然后点击“属性”。
     
5. 选择“使用指定的DNS”：
   • IPv4——输入DNS服务器地址：223.5.5.5 和 223.6.6.6，确定退出即设置完成。
   • IPv6——输入DNS服务器地址：2400:3200::1 和 2400:3200:baba::1，确定退出即设置完成。
     
     
6. 验证：打开CMD命令提示符，通过nslookup alidns.com命令进行验证，若最终解析结果是配置的IPV4公共DNS（223.5.5.5或223.6.6.6）或IPV6公共DNS（2400:3200::1或2400:3200:baba::1）返回的，则说明配置成功。
   
   

Windows 8

1. 打开Windows 8系统控制面板，点击右上角的以图标方式显示，点击“网络和共享中心”选项。
   
2. 点击网络和共享中心左侧的“更改适配器设置”链接。
   
3. 选中正在联网的网络连接，右键选择“属性”。
   
4. 针对IPv4和IPv6的操作不同：
   • IPv4——选中“Internet 协议版本 4 (TCP/IPv4)”，然后点击“属性”。
   • IPv6——选中“Internet 协议版本 6 (TCP/IPv6)”，然后点击“属性”。
     
5. 选择“使用指定的DNS”：
   • IPv4——输入DNS服务器地址：223.5.5.5 和 223.6.6.6，确定退出即设置完成。
   • IPv6——输入DNS服务器地址：2400:3200::1 和 2400:3200:baba::1，确定退出即设置完成。
     
     

Windows 7

1. 通过单击「开始」按钮，然后单击“控制面板”，打开“网络连接”。 在搜索框中，键入适配器，然后在“网络和共享中心”下，单击“查看网络连接”。
2. 右键单击要更改的连接，然后单击“属性”。 需要管理员权限 如果系统提示您输入管理员密码或进行确认，请键入该密码或提供确认。
3. 针对IPv4和IPv6的操作不同：
   • IPv4——在“此连接使用下列项目”下，“Internet 协议版本 4 (TCP/IPv4)”，然后单击“属性”。
   • IPv6——在“此连接使用下列项目”下，“Internet 协议版本 6 (TCP/IPv6)”，然后单击“属性”。
     
4. 单击“使用下面的 DNS 服务器地址”，然后在“首选 DNS 服务器”和“备用 DNS 服务器”框中，键入主 DNS 服务器和辅助 DNS 服务器的地址：
   • IPv4地址：223.5.5.5和223.6.6.6
   • IPv6地址：2400:3200::1 和 2400:3200:baba::1
     

2.2 Linux配置

快速设置

1. 您必须是管理员root或者具有管理员权限。
2. 编辑 /etc/resolv.conf 文件：sudo vim /etc/resolv.conf
3. 加入：（此处IPv4和IPv6略有不同）
   • IPv4：nameserver 223.5.5.5
   • IPv4：nameserver 223.6.6.6
   • IPv6：nameserver 2400:3200::1
   • IPv6：nameserver 2400:3200:baba::1
4. 保存退出，然后使用dig验证：
   • IPv4：dig www.taobao.com +short 若出现结果则表示正常。
   • IPv6：dig alidns.com 若返回结果的server为阿里公共DNS（2400:3200::1或2400:3200:baba::1）则配置成功。
     

Ubuntu系统设置脚本

1. 打开终端，在终端输入下面的命令设置DNS：

   wget http://www.alidns.com/public/soft/SetAliDNS.sh -O SetAliDNS.sh && chmod +x SetAliDNS.sh && sudo ./SetAliDNS.sh

2. 设置后如何取消阿里公共DNS：

   sudo ./SetAliDNS.sh restore

2.3 Mac OS配置

快速设置

1. 选取苹果菜单 > “系统偏好设置”：
   
2. 找到网络图标，点击进入：
   
3. 从列表中选择想要使用的网络连接服务（例如WIFI或以太网），然后点按“高级”：
   
4. 针对IPv4和IPv6的操作不同：
   • IPv4——找到DNS的标签，然后点击左下角“+”，将223.5.5.5和223.6.6.6补充上去，点击“好”。
   • IPv6——找到DNS的标签，然后点击左下角“+”，将2400:3200::1和2400:3200:baba::1补充上去，点击“好”。
     
     
5. 返回到上一级，点击“应用”：
   
6. 验证：
   • IPv4——在浏览器中测试打开 http://www.taobao.com 是否正常。
   • IPv6——验证，dig alidns.com 若返回结果的server为阿里公共DNS（2400:3200::1或2400:3200:baba::1）则配置成功。
     

2.4 Firefox配置

1. 从 Firefox 菜单栏中点击 【选项】设置：
   
2. 搜索框中输入“DNS”，点击【网络设置】中的【设置】按钮：
   
3. 在设置页面的底部，找到并勾选“启用基于HTTPS的DNS”，选择“自定义”的提供商，并输入接口地址： https://dns.alidns.com/dns-query，点击【确定】：
   

2.5 Chrome配置

1. 打开Chrome浏览器，从菜单栏中点击 【设置】选项：
   
2. 在搜索框中输入“DNS”，在下方的检索结果中，点击【安全】右侧的展开箭头：
   
3. 页面下拉到最下方，在【高级】选项中，开通“使用安全DNS”功能，并在【使用】-【自定义】框中输入“https://dns.alidns.com/dns-query”即可完成配置：
   

2.6 Android配置