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 секунд и сам обновляется, когда сервер возвращается.
Что понадобится
- AdGuard Home, веб-интерфейс которого доступен для Macro Deck, например
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 общается с веб-интерфейсом по сети, поэтому AdGuard Home может работать на роутере, Raspberry Pi или VPS, если Macro Deck может достучаться до его адреса.
Почему действие не выполняется?
Действие показывает сообщение, если сервер недоступен, отклоняет вход или не поддерживает запрос. Сервер, который отклоняет вход, на странице Интеграции показывает, что его нужно настроить заново.
За какой период показывается статистика?
За период, в течение которого AdGuard Home хранит статистику: 24 часа, если вы не меняли это в AdGuard Home.
Где хранится мой пароль?
Пароль хранится в зашифрованном виде на вашем компьютере и никогда не отправляется на панель или в браузер.
Ещё в группе «Умный дом и веб»
Home Assistant
Входит в Macro DeckВключайте свет, запускайте сцены и скрипты и показывайте на панели живые состояния из Home Assistant.
RSS-ленты
Входит в Macro DeckСледите за лентами RSS и Atom, показывайте их новейшие статьи в виджетах и реагируйте на появление новых статей.
HTTP
Входит в Macro DeckОтправляйте HTTP-запросы одной кнопкой и сохраняйте значения из ответа в переменные.
Погода
Входит в Macro DeckПоказывайте на панели текущую погоду и прогноз для своих мест без ключа API.