AdGuard Home
Macro Deck に同梱AdGuard Home の保護をオン、オフ、一時停止し、その統計をデッキに表示します。
保護がオンであることを示し、一時停止するボタンを備えた 4 つのサイズの AdGuard Home ウィジェット
- 5 分から 24 時間、または任意の時間だけ保護を一時停止
- 状態を表示するボタンで保護とフィルタリングを切り替え
- 一時停止ボタンと DNS 統計を表示するウィジェット
- クエリ数、ブロックの割合、応答時間の変数
- AdGuard Home サーバーをいくつでも追加可能
AdGuard Home 連携は Macro Deck を AdGuard Home の Web インターフェースに接続します。そのため、ルーター、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 から Web インターフェースに接続できる AdGuard Home (例:
http://192.168.1.2:3000)。 - 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 を操作できますか？
はい。サーバーごとに設定を 1 つ追加します。すべてのアクションとウィジェットに インスタンス 欄があり、各サーバーには追加したときの設定名にちなんだ専用の変数が作られます。
AdGuard Home は同じコンピューターで動いている必要がありますか？
いいえ。Macro Deck はネットワーク経由で Web インターフェースと通信するため、Macro Deck がそのアドレスに接続できれば、AdGuard Home はルーター、Raspberry Pi、VPS のどれで動いていてもかまいません。
アクションが失敗するのはなぜですか？
サーバーに接続できない場合、サインインが拒否された場合、リクエストに対応していない場合は、アクションがメッセージを表示します。サインインが拒否されたサーバーは、連携 ページに再設定が必要と表示されます。
統計はどの期間を対象にしていますか？
AdGuard Home が統計を保持する期間です。AdGuard Home で変更していなければ 24 時間です。
パスワードはどこに保存されますか？
パスワードはコンピューター上に暗号化して保存され、デッキやブラウザに送られることはありません。
スマートホームと Webのその他の連携
Home Assistant
Macro Deck に同梱Home Assistant のライトの切り替え、シーンやスクリプトの実行を行い、ライブの状態をデッキに表示します。
RSS フィード
Macro Deck に同梱RSS フィードや Atom フィードをフォローし、最新の記事をウィジェットに表示して、新しい記事が届いたときに反応します。
HTTP
Macro Deck に同梱ボタンから HTTP リクエストを送信し、応答の値を変数に保存します。
天気
Macro Deck に同梱API キーなしで、登録した場所の現在の天気と予報をデッキに表示します。