AdGuard Home
Macro Deck 自带开启、关闭或暂停 AdGuard Home 防护，并在面板上显示其统计信息。
四种尺寸的 AdGuard Home 组件，显示防护已开启，并带有暂停防护的按钮
- 暂停防护 5 分钟至 24 小时，或自定义时长
- 用显示当前状态的按键切换防护和过滤
- 带暂停按钮和 DNS 统计信息的组件
- 提供查询数、拦截比例和响应时间的变量
- 可添加任意数量的 AdGuard Home 服务器
AdGuard Home 集成将 Macro Deck 连接到 AdGuard Home 的 Web 界面，因此适用于所有能在浏览器中打开的 AdGuard Home：无论是在路由器、Raspberry Pi、家庭服务器还是 VPS 上。可以添加任意数量的服务器，例如家里一台、办公室一台，并在每个动作和组件中选择服务器。
可以做什么
- 开启或关闭防护、切换防护，或者暂时停用 5、15 或 30 分钟，1、2、8 或 24 小时，或者最长 7 天的自定义时长。之后 AdGuard Home 会自动重新开启防护。
- 开启或关闭基于过滤列表的拦截，而不改变其他防护设置，并下载每个过滤列表的最新版本。
- 添加 AdGuard Home 组件，显示带暂停按钮的防护状态、统计信息，或两者兼有。
- 使用变量在任意按键上显示 DNS 查询数、拦截比例或平均响应时间。
一些示例设置：
- 一个 暂停广告 按键，使用 暂时停用防护 15 分钟，用于在拦截下无法正常工作的网站。
- 一个使用 切换防护 的按键，在防护开启时亮起。
- 一个视图为 控制与统计信息 的 AdGuard Home 组件，显示防护状态、暂停按钮和已拦截的查询数。
运行方式
Macro Deck 每 5 秒向每台服务器查询一次状态，每 30 秒查询一次统计信息。同一台服务器的所有组件和变量共用这些结果，因此添加组件不会增加请求。执行动作后会立即重新读取状态。当服务器无法访问或拒绝登录时，它的 adguard_home_<instance>_is_reachable 变量为 false，其他变量显示为不可用，组件也会提示这一点，而不是显示旧数据。Macro Deck 每 30 秒重试一次，服务器恢复后会自动更新。
准备工作
- Macro Deck 能够访问其 Web 界面的 AdGuard Home，例如
http://192.168.1.2:3000。 - 如果 AdGuard Home 需要登录：登录 AdGuard Home 所用的用户名和密码。
- 对于
https://地址：电脑信任的证书，或者 接受自签名证书 选项。
设置步骤
第 1 步: 找到 AdGuard Home 的地址
在浏览器中打开 AdGuard Home 的 Web 界面，记下包含端口的地址，例如
http://192.168.1.2:3000。如果 AdGuard Home 位于反向代理之后的某个路径下，也要记下该路径。第 2 步: 打开 AdGuard Home 集成
在 Macro Deck 中，点击侧边栏中的 集成，然后点击 AdGuard Home。在 概览 选项卡的 配置 部分中点击 添加配置。打开右上角的开关也会打开同一个对话框，完成设置后集成即会启用。
第 3 步: 输入服务器信息
在 连接到 AdGuard Home 对话框中输入：
- 配置名称：服务器在动作和组件中显示的名称，例如
Home。 - 地址：Web 界面的地址，包含端口。
- 用户名 和 密码：登录 AdGuard Home 所用的账户。如果 AdGuard Home 不需要登录，两项都留空。
- 接受自签名证书：仅用于证书不受电脑信任的
https://地址。
点击 继续。Macro Deck 会先检查连接，再保存配置。
- 配置名称：服务器在动作和组件中显示的名称，例如
第 4 步: 为按键添加动作
在 面板 页面上点击一个按键。面板必须处于解锁状态：右上角显示 锁定 按钮时，面板即为解锁状态。编辑器打开时已选中 短按。点击 + 添加动作，在 添加动作 对话框左侧选择 AdGuard Home，选择 暂时停用防护，在 实例 中选择服务器，然后选择 时长。
第 5 步: 按下按键
在面板上按下该按键。AdGuard Home 会暂停防护，并在时间到后自动重新开启。
第 6 步: 添加组件
如需一眼看清状态，可将 AdGuard Home 组件添加到文件夹。在其设置中选择 实例、视图（防护控制、统计信息 或 控制与统计信息）、要显示的 暂停按钮 和 统计信息。
动作8
可以放在按键上，也可以在流程中运行。
- 启用防护
- 开启防护，同时结束暂停。
- 停用防护
- 关闭防护，直到再次开启。
- 切换防护
- 防护关闭时开启，开启时关闭。防护开启期间按键会亮起。
- 暂时停用防护
- 在设定时间内关闭防护，最长 7 天。之后 AdGuard Home 会自动重新开启。
- 启用过滤
- 开启基于过滤列表的拦截。
- 停用过滤
- 关闭基于过滤列表的拦截。其他防护保持不变。
- 切换过滤
- 基于过滤列表的拦截关闭时开启，开启时关闭。
- 更新过滤列表
- 下载每个拦截列表和允许列表的最新版本。
变量8
在按键和组件上显示这些值，或在条件中使用它们。
adguard_home_<instance>_is_reachable- Macro Deck 当前能否访问该服务器。
adguard_home_<instance>_protection_enabled- 防护是否开启。
adguard_home_<instance>_protection_disabled_until- 暂停结束的时间，ISO 8601 格式；没有暂停时为空。
adguard_home_<instance>_dns_queries,adguard_home_<instance>_blocked_queries- 所有 DNS 查询数，以及被过滤列表拦截的查询数。
adguard_home_<instance>_blocked_percentage- 被拦截的查询占全部查询的百分比。
adguard_home_<instance>_avg_processing_time- 平均响应时间，单位为毫秒。
adguard_home_<instance>_safebrowsing_blocked,adguard_home_<instance>_parental_blocked,adguard_home_<instance>_safesearch_enforced- 已拦截的恶意软件和钓鱼网站、已拦截的成人网站以及已强制安全搜索的次数。
adguard_home_<instance>_version- AdGuard Home 的版本。
组件1
从组件选择器中将它们添加到面板。
- AdGuard Home
- 显示一台服务器的防护状态和统计信息，并提供暂停防护或重新开启防护的按钮。
常见问题解答
可以控制多个 AdGuard Home 吗？
可以。为每台服务器添加一个配置。每个动作和组件都有 实例 字段，每台服务器也有自己的变量，变量以添加时的配置名称命名。
AdGuard Home 必须运行在同一台电脑上吗？
不必。Macro Deck 通过网络与 Web 界面通信，因此 AdGuard Home 可以运行在路由器、Raspberry Pi 或 VPS 上，只要 Macro Deck 能访问其地址即可。
动作为什么会失败？
当服务器无法访问、拒绝登录或不支持该请求时，动作会显示一条消息。登录被拒绝的服务器会在 集成 页面上显示需要重新设置。
统计信息涵盖哪个时间段？
即 AdGuard Home 保留统计信息的时间段，除非在 AdGuard Home 中更改过，否则为 24 小时。
密码存储在哪里？
密码加密存储在电脑上，绝不会发送到面板或浏览器。
“智能家居和网络”分类中的更多集成
Home Assistant
Macro Deck 自带在面板上开关灯光、运行场景和脚本，并显示 Home Assistant 的实时状态。
RSS 订阅源
Macro Deck 自带关注 RSS 和 Atom 订阅源，在组件中显示最新文章，并在有新文章时做出响应。
HTTP
Macro Deck 自带通过按键发送 HTTP 请求，并将响应中的值保存到变量中。
天气
Macro Deck 自带在面板上显示各个位置的当前天气和预报，无需 API 密钥。