AdGuard Home
Macro Deck에 포함AdGuard Home 보호를 켜거나 끄거나 일시 중지하고, 통계를 덱에 표시하세요.
보호가 켜져 있음을 보여 주고 일시 중지 버튼이 있는 네 가지 크기의 AdGuard Home 위젯
- 보호를 5분부터 24시간까지 또는 원하는 시간만큼 일시 중지
- 상태를 보여 주는 버튼으로 보호와 필터링 전환
- 일시 중지 버튼과 DNS 통계가 있는 위젯
- 쿼리, 차단 비율, 응답 시간에 대한 변수
- AdGuard Home 서버를 원하는 만큼 추가
AdGuard Home 연동은 Macro Deck을 AdGuard Home의 웹 인터페이스에 연결하므로, 라우터, Raspberry Pi, 홈 서버, VPS 등 브라우저에서 열 수 있는 모든 AdGuard Home에서 동작합니다. 집에 하나, 사무실에 하나처럼 서버를 원하는 만큼 추가하고, 모든 액션과 위젯에서 서버를 고를 수 있습니다.
할 수 있는 일
- 보호를 켜거나 끄거나 전환하고, 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 키 없이 원하는 위치의 현재 날씨와 예보를 덱에 표시하세요.