RichPear HOME DOCS Začít

Integrace RichPear Home

AdGuard Home

Integrace AdGuard Home přidává do RichPear Home monitoring a ovládání lokální instance AdGuard Home. Uvidíte DNS statistiky, zapnete nebo vypnete ochranné funkce a můžete spravovat filtrační seznamy z automatizací.

Začít nastaveníZpět na audit
Doména
adguard
Kategorie
Síť, senzory, spínače, aktualizace
Komunikace
local-polling
Nastavení
Průvodce v UI
01

Připravte běžící AdGuard Home

AdGuard Home musí být nainstalovaný a spuštěný ve vaší síti. RichPear Home se k němu připojuje lokálně přes webové/API rozhraní, proto potřebujete IP adresu nebo hostname instance, port a přístup s oprávněním správce.

Výchozí port webového rozhraní AdGuard Home je 3000. Pokud používáte HTTPS, připravte také informaci, jestli má RichPear Home ověřovat TLS certifikát.

Kontrola před přidáním

  1. AdGuard Home je dostupný například na http://IP-ADRESA:3000.
  2. RichPear Home je ve stejné síti nebo má povolený přístup na port AdGuard Home.
  3. Znáte administrátorské jméno a heslo, pokud je v AdGuard Home zapnuté přihlášení.
  4. Víte, jestli se má používat HTTP nebo HTTPS a jestli má být zapnuté ověření certifikátu.
02

Přidejte službu v RichPear Home

Otevřete Nastavení → Zařízení a služby → Přidat integraci, vyhledejte AdGuard Home a vyplňte připojovací údaje. Průvodce požaduje host, port, volbu SSL, volbu ověření SSL certifikátu a podle nastavení AdGuard Home také uživatelské jméno a heslo.

Pokud provozujete AdGuard Home jako aplikaci v RichPear Home OS, může se konfigurace nabídnout automaticky k potvrzení. U samostatné Docker nebo serverové instalace zadejte host a port ručně.

Průvodce AdGuard Home v českém RichPear Home požaduje host, port a volby SSL připojení.

Doporučené hodnoty pro lokální síť

Host: 192.168.1.100 nebo adguard.local
Port: 3000
SSL: vypnuto pro běžné http:// připojení
Ověřit SSL certifikát: zapnout jen u platného HTTPS certifikátu
03

Zkontrolujte senzory, spínače a aktualizaci

Po úspěšném přidání otevřete detail integrace a zkontrolujte vytvořené entity. Senzory ukazují DNS dotazy, zablokované dotazy, poměr blokování, blokování přes Safe browsing, vynucené Safe search, zásahy rodičovské kontroly, počet pravidel a průměrnou dobu zpracování DNS v milisekundách.

Spínače ovládají hlavní ochranu AdGuard Home, filtrování, Safe browsing, rodičovskou kontrolu, Safe search a Query log. Hlavní spínač ochrany funguje jako master přepínač pro ochranné funkce.

Důležité chování

  1. Vypnutí Query log zastaví aktualizaci senzorů, protože AdGuard Home z logu bere statistiky.
  2. Entita update umí zkontrolovat a spustit aktualizaci AdGuard Home, pokud ji konkrétní instalace podporuje.
  3. U Docker instalací AdGuard Home RichPear Home neposkytuje update entitu pro samotný software AdGuard Home.
  4. U aplikace AdGuard Home v RichPear Home OS řeší aktualizaci aplikace Supervisor.
04

Použijte akce pro filtrační seznamy

Integrace přidává doménové akce pro správu DNS blocklistů. Akce pracují se stejnými URL, které vidíte v AdGuard Home v části Filters → DNS blocklists.

U akcí enable_url, disable_url a remove_url musí URL přesně odpovídat existujícímu filtračnímu seznamu. Pokud neodpovídá, akce skončí chybou, že URL filtru nebyla nalezena.

Dostupné akce

  1. adguard.add_url, přidá nový filtrační seznam, vyžaduje name a url.
  2. adguard.remove_url, odebere filtrační seznam podle url.
  3. adguard.enable_url, zapne existující filtrační seznam podle url.
  4. adguard.disable_url, vypne existující filtrační seznam podle url.
  5. adguard.refresh, obnoví filtrační seznamy; volitelné force obejde omezení AdGuard Home pro časté aktualizace.
05

Zapojte AdGuard do automatizací

Spínače můžete používat stejně jako jiné entity typu switch. Typický scénář je přísnější filtrování pro hosty nebo časově omezené blokování vybraných seznamů.

Následující příklad zapne přísnější ochranu pro hostovskou síť. Názvy entit upravte podle skutečných entit ve vaší instalaci.

Příklad automatizace

alias: Zapnout přísné filtrování pro hosty
triggers:
  - trigger: state
    entity_id: group.hostovska_zarizeni
    to: "home"
actions:
  - action: switch.turn_on
    target:
      entity_id:
        - switch.adguard_parental_control
        - switch.adguard_safe_browsing
        - switch.adguard_safe_search
06

Řešení problémů

Pokud RichPear Home hlásí, že se k AdGuard Home nemůže připojit, nejdřív otevřete webové rozhraní AdGuard Home z prohlížeče a ověřte, že služba běží. Potom zkontrolujte port, firewall, volbu SSL a administrátorské přihlašovací údaje.

Pokud jsou senzory nedostupné, zapněte v AdGuard Home Query log, ověřte, že AdGuard zpracovává DNS dotazy, a ujistěte se, že alespoň jedno zařízení v síti používá AdGuard Home jako DNS server.

Rychlá diagnostika

  1. Web AdGuard Home se otevře na http://IP-ADRESA:3000 nebo na vaší vlastní adrese.
  2. RichPear Home má síťovou cestu k hostu a portu AdGuard Home.
  3. SSL je zapnuté jen tehdy, když AdGuard Home skutečně běží přes HTTPS.
  4. U vlastního certifikátu vypněte ověření SSL jen v případě, že rozumíte dopadům.
  5. URL filtračního seznamu v automatizaci přesně odpovídá URL v AdGuard Home.
07

Odebrání integrace

Otevřete Nastavení → Zařízení a služby, vyberte integraci AdGuard Home, otevřete konkrétní instanci a v nabídce se třemi tečkami zvolte odstranění. AdGuard Home jako služba tím zůstane běžet se svou aktuální konfigurací.

Po odebrání zkontrolujte automatizace, skripty a dashboardy, které používaly senzory, spínače nebo akce domény adguard.

Odebrání integrace nemění DNS nastavení klientů v síti. Pokud zařízení dál používají AdGuard Home jako DNS server, budou jeho pravidla platit i bez integrace v RichPear Home.
URL

Lokální adresa systému

RichPear Home se v domácí síti běžně otevírá na http://rphome.local:8123. Pokud tato adresa v dané síti neodpoví, použijte http://IP-ADRESA:8123.