2025.3.4
首页 ▸ Integrations ▸

AdGuard Home

AdGuard Home 是一个支持广告、跟踪器和成人内容拦截的全网 DNS 服务器。AdGuard 集成允许您在 Home Assistant 中控制和监控您的 AdGuard Home 实例。

配置

要将 AdGuard Home 服务 添加到您的 Home Assistant 实例中，请使用此 My 按钮：

手动配置步骤

如果上述 My 按钮不起作用，您也可以手动执行以下步骤：

传感器

此集成为 AdGuard Home 提供以下信息的 sensors传感器返回有关事物的信息，例如水箱中的水位。 [Learn more]：

  • DNS 查询数量。
  • 被拦截的 DNS 查询数量。
  • 被拦截的 DNS 查询比例（%）。
  • 被安全浏览拦截的请求数量。
  • 强制安全搜索的次数。
  • 被家长控制拦截的请求数量。
  • 加载的活动过滤规则总数。
  • AdGuard DNS 服务器的平均响应时间（毫秒）。

开关

此集成将创建多个开关：

  • AdGuard 保护（主开关）。
  • 过滤。
  • 安全浏览。
  • 家长控制。
  • 安全搜索。
  • 查询日志。

这些开关使您可以轻松地进行自动化。例如，可以编写一个自动化，在孩子的就寝时间后关闭安全搜索。

“AdGuard 保护”开关是一个主开关。它将关闭并绕过所有 AdGuard 功能，无论它们是否已开启。

Important

关闭查询日志将导致所有传感器不再接收更新。AdGuard 依赖查询日志提供统计信息。

操作

这些 actions动作在 Home Assistant 的多个地方使用。作为脚本或自动化的一部分，动作定义了触发器被激活后将发生的事情。在脚本中，动作被称为序列。 [Learn more] 允许管理 AdGuard Home 中的过滤器订阅。在自动化中使用这些操作可能有助于在特定时间阻止某些站点/域名。

例如，您可以创建一个自定义过滤列表，在白天阻止社交媒体网站，并在晚上解除阻止。

操作 add_url

向 AdGuard Home 添加新的过滤器订阅。

数据属性 可选 描述
name 否 过滤器订阅的名称。
url 否 包含过滤规则的过滤器订阅 URL。

操作 remove_url

从 AdGuard Home 中移除过滤器订阅。

数据属性 可选 描述
url 否 要移除的过滤器订阅 URL。

操作 enable_url

启用 AdGuard Home 中的过滤器订阅。

数据属性 可选 描述
url 否 要启用的过滤器订阅 URL。

操作 disable_url

禁用 AdGuard Home 中的过滤器订阅。

数据属性 可选 描述
url 否 要禁用的过滤器订阅 URL。

操作 refresh

刷新 AdGuard Home 中的所有过滤器订阅。

数据属性 可选 描述
force 是 强制更新（绕过 AdGuard Home 的限制）。

默认情况下，force 设置为 false。强制更新会绕过 AdGuard Home 的限制逻辑，因此请谨慎使用。