AdGuard Home
隨附於 Macro Deck開啟、關閉或暫停 AdGuard Home 防護，並在面板上顯示統計資料。
四種尺寸的 AdGuard Home 小工具，顯示防護已開啟，並附有暫停防護的按鈕
- 暫停防護 5 分鐘到 24 小時，或自訂時間
- 用會顯示狀態的按鈕切換防護和過濾
- 附暫停按鈕和 DNS 統計資料的小工具
- 查詢數、封鎖比例和回應時間變數
- 可加入任意數量的 AdGuard Home 伺服器
AdGuard Home 整合會將 Macro Deck 連線到 AdGuard Home 的網頁介面，因此適用於所有能在瀏覽器中開啟的 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 能連到其網頁介面的 AdGuard Home，例如
http://192.168.1.2:3000。 - 如果 AdGuard Home 要求登入，需準備登入用的使用者名稱和密碼。
- 使用
https://位址時：電腦信任的憑證，或 接受自我簽署憑證 選項。
開始設定
步驟 1: 找出 AdGuard Home 的位址
在瀏覽器中開啟 AdGuard Home 網頁介面，記下含連接埠的位址，例如
http://192.168.1.2:3000。如果 AdGuard Home 位於反向代理後方的某個路徑下，也請記下該路徑。步驟 2: 開啟 AdGuard Home 整合
在 Macro Deck 的側邊欄中按一下 整合，然後按一下 AdGuard Home。在 概覽 分頁的 設定 區段中按一下 新增設定。開啟右上角的開關也會開啟相同的對話方塊，設定完成後此整合就會啟用。
步驟 3: 輸入伺服器詳細資料
在 連線到 AdGuard Home 對話方塊中輸入：
- 設定名稱：伺服器在動作和小工具中顯示的名稱，例如
Home。 - 位址：網頁介面的位址，包含連接埠。
- 使用者名稱 和 密碼：登入 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 會透過網路與網頁介面通訊，因此只要 Macro Deck 能連到其位址，AdGuard Home 就可以在路由器、Raspberry Pi 或 VPS 上執行。
為什麼動作失敗？
當伺服器無法連線、拒絕登入或不支援該請求時，動作會顯示訊息。登入遭拒的伺服器會在 整合 頁面上顯示需要重新設定。
統計資料涵蓋哪段時間？
涵蓋 AdGuard Home 保留統計資料的時間長度，除非在 AdGuard Home 中變更過，否則為 24 小時。
密碼儲存在哪裡？
密碼會加密儲存在電腦上，絕不會傳送到面板或瀏覽器。
更多「智慧家庭和網路」整合
Home Assistant
隨附於 Macro Deck切換燈光、執行場景和指令碼，並在面板上顯示 Home Assistant 的即時狀態。
RSS 訂閱來源
隨附於 Macro Deck追蹤 RSS 和 Atom 訂閱來源，在小工具中顯示最新文章，並在有新文章時做出回應。
HTTP
隨附於 Macro Deck從按鈕傳送 HTTP 請求，並將回應中的值儲存到變數。
天氣
隨附於 Macro Deck在面板上顯示各個地點的目前天氣和預報，不需要 API 金鑰。