AdGuard Home
Incluída no Macro DeckAtive, desative ou pause a proteção do AdGuard Home e mostre as estatísticas dele no seu deck.
Widgets AdGuard Home em quatro tamanhos mostrando que a proteção está ativada, com botões para pausá-la
- Pause a proteção de 5 minutos a 24 horas, ou por um tempo personalizado
- Alterne proteção e filtragem com botões que mostram o estado
- Um widget com botões de pausa e estatísticas de DNS
- Variáveis para consultas, parcela bloqueada e tempo de resposta
- Adicione quantos servidores AdGuard Home quiser
A integração AdGuard Home conecta o Macro Deck à interface web do AdGuard Home, então funciona com qualquer AdGuard Home que você consiga abrir em um navegador: no roteador, em um Raspberry Pi, em um servidor doméstico ou em uma VPS. É possível adicionar quantos servidores quiser, por exemplo um em casa e outro no escritório, e escolher o servidor em cada ação e widget.
O que dá para fazer
- Ative ou desative a proteção, alterne entre os dois estados ou desative-a temporariamente por 5, 15 ou 30 minutos, 1, 2, 8 ou 24 horas, ou por um tempo personalizado de até 7 dias. O AdGuard Home volta a ativá-la sozinho.
- Ative ou desative o bloqueio por listas de filtros sem mudar as outras configurações de proteção e baixe a versão mais recente de cada lista de filtros.
- Adicione o widget AdGuard Home para mostrar o status da proteção com botões de pausa, as estatísticas ou ambos.
- Use as variáveis para mostrar em qualquer botão o número de consultas DNS, a parcela bloqueada ou o tempo médio de resposta.
Alguns exemplos de uso:
- Um botão Pausar anúncios com Desativar proteção temporariamente por 15 minutos, para um site que não funciona com o bloqueio.
- Um botão com Alternar proteção que acende enquanto a proteção está ativada.
- Um widget AdGuard Home com Controles e estatísticas que mostra o status da proteção, botões de pausa e o número de consultas bloqueadas.
Como funciona
O Macro Deck pede a cada servidor o status a cada 5 segundos e as estatísticas a cada 30 segundos. Todos os widgets e variáveis de um servidor usam as mesmas respostas, então adicionar widgets não gera novas requisições. Depois de uma ação, o status é lido de novo na hora. Quando um servidor não pode ser alcançado ou recusa o login, a variável adguard_home_<instance>_is_reachable dele fica false, as outras variáveis ficam indisponíveis e o widget avisa isso em vez de mostrar números antigos. O Macro Deck tenta de novo a cada 30 segundos e se atualiza sozinho quando o servidor volta.
O que é necessário
- Um AdGuard Home cuja interface web o Macro Deck consiga alcançar, por exemplo
http://192.168.1.2:3000. - O nome de usuário e a senha usados para entrar no AdGuard Home, se ele pedir login.
- Para um endereço
https://: um certificado em que o computador confie, ou a opção Aceitar certificado autoassinado.
Configuração
Passo 1: Descubra o endereço do AdGuard Home
Abra a interface web do AdGuard Home em um navegador e anote o endereço com a porta, por exemplo
http://192.168.1.2:3000. Se o AdGuard Home estiver atrás de um proxy reverso em um caminho, anote também o caminho.Passo 2: Abra a integração AdGuard Home
No Macro Deck, clique em Integrações na barra lateral e depois em AdGuard Home. Na aba Visão geral, clique em Adicionar configuração na seção Configuração. Ativar a chave no canto superior direito abre a mesma caixa de diálogo, e a integração fica ativada assim que a configuração é concluída.
Passo 3: Informe os dados do servidor
Na caixa de diálogo Conectar ao AdGuard Home, informe:
- Nome da configuração: como o servidor aparece em ações e widgets, por exemplo
Home. - Endereço: o endereço da interface web, com a porta.
- Usuário e Senha: a conta usada para entrar no AdGuard Home. Deixe os dois vazios se o AdGuard Home não pedir login.
- Aceitar certificado autoassinado: só para um endereço
https://cujo certificado o computador não reconhece como confiável.
Clique em Continuar. O Macro Deck testa a conexão antes de salvar a configuração.
- Nome da configuração: como o servidor aparece em ações e widgets, por exemplo
Passo 4: Adicione uma ação a um botão
Na página Deck, clique em um botão. O deck precisa estar desbloqueado: se o botão Bloquear aparece no canto superior direito, ele está. O editor abre com Toque curto selecionado. Clique em + Adicionar ação, selecione AdGuard Home à esquerda da caixa de diálogo Adicionar ação, escolha Desativar proteção temporariamente, selecione o servidor em Instância e escolha uma Duração.
Passo 5: Pressione o botão
Pressione o botão no seu deck. O AdGuard Home pausa a proteção e volta a ativá-la sozinho quando o tempo acaba.
Passo 6: Adicione o widget
Para ver o status rapidamente, adicione o widget AdGuard Home a uma pasta. Nas configurações dele, escolha a Instância, a Visualização (Controles de proteção, Estatísticas ou Controles e estatísticas), os Botões de pausa e as Estatísticas a exibir.
Ações8
Coloque estas ações em um botão ou execute-as a partir de um fluxo.
- Ativar proteção
- Ativa a proteção e também encerra uma pausa.
- Desativar proteção
- Desativa a proteção até que ela seja ativada de novo.
- Alternar proteção
- Ativa a proteção quando está desativada e a desativa quando está ativada. O botão acende enquanto a proteção está ativada.
- Desativar proteção temporariamente
- Desativa a proteção por um tempo definido de até 7 dias. O AdGuard Home volta a ativá-la sozinho.
- Ativar filtragem
- Ativa o bloqueio por listas de filtros.
- Desativar filtragem
- Desativa o bloqueio por listas de filtros. O restante da proteção continua como está.
- Alternar filtragem
- Ativa o bloqueio por listas de filtros quando está desativado e o desativa quando está ativado.
- Atualizar listas de filtros
- Baixa a versão mais recente de cada lista de bloqueio e de permissão.
Variáveis8
Mostre estes valores em botões e widgets ou use-os em condições.
adguard_home_<instance>_is_reachable- Se o Macro Deck consegue alcançar o servidor no momento.
adguard_home_<instance>_protection_enabled- Se a proteção está ativada.
adguard_home_<instance>_protection_disabled_until- Quando uma pausa termina, como horário ISO 8601, ou vazio.
adguard_home_<instance>_dns_queries,adguard_home_<instance>_blocked_queries- Todas as consultas DNS e as bloqueadas por listas de filtros.
adguard_home_<instance>_blocked_percentage- As consultas bloqueadas como parcela de todas as consultas, em porcentagem.
adguard_home_<instance>_avg_processing_time- O tempo médio de resposta em milissegundos.
adguard_home_<instance>_safebrowsing_blocked,adguard_home_<instance>_parental_blocked,adguard_home_<instance>_safesearch_enforced- As contagens de malware e phishing bloqueados, de sites adultos bloqueados e de pesquisas seguras aplicadas.
adguard_home_<instance>_version- A versão do AdGuard Home.
Widgets1
Adicione estes widgets ao seu deck pelo seletor de widgets.
- AdGuard Home
- Mostra o status da proteção e as estatísticas de um servidor, com botões para pausar a proteção ou ativá-la de novo.
Perguntas frequentes
Posso controlar mais de um AdGuard Home?
Sim. Adicione uma configuração por servidor. Cada ação e widget tem um campo Instância, e cada servidor recebe variáveis próprias, com o nome de configuração que tinha quando foi adicionado.
O AdGuard Home precisa rodar no mesmo computador?
Não. O Macro Deck se comunica com a interface web pela rede, então o AdGuard Home pode rodar em um roteador, em um Raspberry Pi ou em uma VPS, desde que o Macro Deck consiga alcançar o endereço.
Por que uma ação falha?
A ação mostra uma mensagem quando o servidor não pode ser alcançado, recusa o login ou não aceita a requisição. Um servidor que recusa o login aparece na página Integrações como precisando ser configurado de novo.
Qual período as estatísticas cobrem?
O período pelo qual o AdGuard Home guarda as estatísticas, que é de 24 horas, a menos que você o tenha alterado no AdGuard Home.
Onde minha senha fica armazenada?
A senha fica armazenada criptografada no seu computador e nunca é enviada ao deck nem a um navegador.
Mais em Casa inteligente e web
Home Assistant
Incluída no Macro DeckAcione luzes, execute cenas e scripts e mostre no seu deck os estados ao vivo do seu Home Assistant.
Feeds RSS
Incluída no Macro DeckAcompanhe feeds RSS e Atom, mostre os artigos mais recentes em widgets e reaja quando chegam artigos novos.
HTTP
Incluída no Macro DeckEnvie requisições HTTP a partir de um botão e salve valores da resposta em variáveis.
Clima
Incluída no Macro DeckMostre no deck o clima atual e a previsão para os seus locais, sem chave de API.