Ansibleロール: AdguardHome

説明

Ansibleを使ってAdGuardHomeサービスを展開し、管理します。

完全な設定情報はAdGuardHome Configをご覧ください。

Webパスワードのリセット

AdGuard HomeはパスワードをBCryptでエンコードされたハッシュとして保存します。

ロールのデフォルトパスワードは「admin」です。

パスワードを変更するには、以下を行ってください：

• AdGuard Homeを停止
• AdGuardHome.yamlを編集
• パスワードフィールドを見つける
• 新しい値に置き換える。htpasswdツールやオンラインBCrypt生成ツールを使用できます（多くのオンラインツールがあります）。
• AdGuard Homeを起動
• 新しいパスワードを使用してWebインターフェースにログインできるようになります。

htpasswdを使用した例:

htpasswd -bnBC 10 "" MY_NEW_PASS | tr -d ':'

WebUIでの設定

:bangbang:	WebUIでの設定が完了したら、設定をホスト変数に保存してください。

要件

• Ansible >= 2.9（古いバージョンでも動作する場合がありますが、保証はできません）

ロールの変数

上書きが可能なすべての変数はdefaults/main.ymlファイルと下の表に保存されています。

名前	デフォルト値	説明
proxy_env	{}	クライアント用のプロキシ環境変数
adguard_version	0.107.0	AdGuardHomeパッケージのバージョン。latestを受け入れます。
adguard_web_listen_address	0.0.0.0	adguard-homeがリッスンするアドレス
adguard_web_listen_port	3200	adguard-homeがリッスンするポート
adguard_config_dir	/etc/adguard	adguard-homeの設定ディレクトリのパス
adguard_db_dir	/var/lib/adguard	adguard-homeデータベースのパス
adguard_binary_install_dir	/usr/local/bin	バイナリのインストールディレクトリ
adguard_system_user	"{{ prometheus_user	default('adguard') }}"
adguard_system_group	"{{ prometheus_group	default('adguard') }}"
adguard_limit_nofile	8192	NoFileの制限
#adguard_http_proxy	http://proxy:3128	システムユニットの環境にプロキシを設定
#adguard_https_proxy	http://proxy:3128	システムユニットの環境にプロキシを設定
adguard_config	{}	AdGuardHomeの設定

例

---
adguard_config:
  bind_host: "{{ adguard_web_listen_address }}"
  bind_port: "{{ adguard_web_listen_port }}"
  beta_bind_port: 0
  users:
  - name: admin
    password: $2y$12$SMsrAS0r0FPvpBPDPJygD.GO7V7jeUd2GI2KN.l.rubeV6aKVauEy
  auth_attempts: 5
  block_auth_min: 15
  http_proxy: ""
  language: ""
  debug_pprof: false
  web_session_ttl: 720
  dns:
    bind_hosts:
    - "{{ adguard_web_listen_address }}"
    port: 53
    statistics_interval: 1
    querylog_enabled: true
    querylog_file_enabled: true
    querylog_interval: 2160h
    querylog_size_memory: 1000
    anonymize_client_ip: false
    protection_enabled: true
    blocking_mode: default
    parental_block_host: family-block.dns.adguard.com
    safebrowsing_block_host: standard-block.dns.adguard.com
    ratelimit: 20
    refuse_any: true
    upstream_dns:
    - https://dns10.quad9.net/dns-query
    bootstrap_dns:
    - 9.9.9.10
    - 149.112.112.10
    all_servers: false
    cache_size: 4194304
    filtering_enabled: true
    tls:
      enabled: false
  filters:
  - enabled: true
    url: https://adguardteam.github.io/AdGuardSDNSFilter/Filters/filter.txt
    name: AdGuard DNSフィルタ
    id: 1
  log_compress: false
  os:
    user: "{{ adguard_system_user }}"
  schema_version: 12

プレイブック

- hosts: all
  roles:
    - onkeldom.adguard_home

貢献

詳しくは貢献ガイドラインをご覧ください。

ライセンス

このプロジェクトはMITライセンスの下でライセンスされています。詳細はLICENSEをご覧ください。