跳转至主内容

更新日志

本文包含 AdGuard DNS API 的更新日志。

v1.10​

Released on December 12, 2024

Added a new DNS server setting — block_chrome_prefetch. It disables Private prefetch proxy in Chrome. When this feature is enabled, Chrome will sometimes prefetch links on the Google Search results page and other participating websites even before the user clicks them.

v1.9​

2024年7月11日发布

  • 新增自动设备连接功能：
    • 新增 DNS 服务设置 — auto_connect_devices_enabled，允许通过特定链接类型验证自动连接设备。
    • 设备中新增字段 — auto_device，表示设备已自动给连接。
  • 将 CategoryQueriesStats 中的 queries、AccountLimits 中的 used 以及 QueriesStats 中的 blocked 和 queries 由 int 替换为 long。

v1.8​

2024年4月20日发布

  • 新增对使用具有身份验证的 DNS-over-HTTPS 的支持：
    • 新增操作：重置设备的 DNS-over-HTTPS 密码。
    • 新增设备设置：detect_doh_auth_only。 禁用除具有身份验证的 DNS-over-HTTPS 以外的所有 DNS 连接。
    • DeviceDNSAddresses 新增字段：dns_over_https_with_auth_url。 用于指定使用具有身份验证的 DNS-over-HTTPS 连接时的 URL。

v1.7​

2024年3月11日发布

  • 添加 IPv4 专用地址功能：
    • 现在可在设备上使用专用 IPv4 地址配置 DNS 服务器。
    • 专用 IPv4 地址现在与它所连接的设备相关联，以便记录对该设备的查询。
  • 新增操作：
    • 列出所有可用的专用 IPv4 地址
    • 分配新的专用 IPv4 地址
    • 将可用的 IPv4 地址链接到设备
    • 取消 IPv4 地址与设备的连接
    • 查询与设备关联的专用地址信息
  • 已将新限制添加到账号限制中：
    • dedicated_ipv4：提供有关已分配的专用 IPv4 地址数量及其限制的信息。
  • 删除了 DNSServerSettings 中的弃用字段：
    • safebrowsing_enabled

v1.6​

2024年1月22日发布

  • 为 DNS 描述文件新增了「访问设置」部分（access_settings）。 用户可以通过自定义这些字段来保护您的 AdGuard DNS 服务器，使其免受未经授权的访问：

    • allowed_clients：在这里，您可以设置允许使用您 DNS 服务器的客户端。 此字段优先于 blocked_clients 字段。
    • blocked_clients：在这里，可以指定不允许哪些客户端使用您的 DNS 服务器。
    • blocked_domain_rules：在这里，可以指定不允许哪些域名访问您的 DNS 服务器，并可以使用通配符和 DNS 过滤规则定义这些域名。

  • 已将新限制添加到账号限制中：

    • access_rules 提供当前使用的 blocked_clients 和 blocked_domain_rules 的总和，以及访问规则的限制。
    • user_rules 显示已创建的用户规则数量，以及用户规则限制。

  • 新增设置：ip_log_enabled 用于记录客户端 IP 地址和域名。

  • 新增错误代码 FIELD_REACHED_LIMIT，用于指示字段值超过限制：

    • 访问设置中 blocked_clients 和 blocked_domain_rules 的总数。
    • 自定义用户规则设置中的 rules。

v1.5​

2023年6月16日发布

  • 添加新设置 block_nrd 并将所有安全相关设置分组到一处。

安全浏览设置模式更改前：​

变更前：

{
   "enabled": true
}

更改后：

{
   "enabled": true,
   "block_dangerous_domains": true,
   "block_nrd": false
}

现在，其中的 enabled 会控制组中的所有设置， block_dangerous_domains 是之前模型的 enabled 字段，block_nrd 是过滤新注册域名的设置。

保存服务器设置的模型变更​

变更前：

{
  "protection_enabled" : true,
  "safebrowsing_enabled" : true,
  ..
}

更改后：

{
  "protection_enabled" : true,
  "safebrowsing_settings" : {
     "enabled": true,
     "block_dangerous_domains": true,
     "block_nrd": false
  }
  ..
}

此处使用新字段 safebrowsing_settings 代替已弃用的 safebrowsing_enabled，其值存储在 block_dangerous_domains中。

v1.4​

2023年3月29日发布

  • 添加了用于阻止响应的可配置选项：默认 (0.0.0.0)、REFUSED、NXDOMAIN 或自定义 IP 地址。

v1.3​

2022年12月13日发布

  • 添加了获取账号限制的方法。

v1.2​

2022年10月14日发布

  • 新增 DNS 和 DNSCRYPT 协议类型。 弃用即将删除的 PLAIN_TCP、PLAIN_UDP、DNSCRYPT_TCP 和 DNSCRYPT_UDP。

v1.1​

2022年7月7日发布

  • 添加了按时间、域名、公司和设备检索统计数字的方法。
  • 添加了更新设备设置的方法。
  • 修复了必填字段定义。

v1.0​

2022年2月22日发布

  • 添加了身份验证。
  • 对设备和 DNS 服务器进行 CRUD 操作。
  • 查询日志
  • 下载 DoH 和 DoT .mobileconfig。
  • 过滤列表和网络服务。