这个项目能做什么

AdGuardHome sync 是一款用于保持多个 AdGuard Home 实例配置一致的工具。它可将指定源实例的设置复制到一个或多个副本实例,帮助在不同设备或位置间维持一致的 DNS 过滤、重写规则、客户端设置及其他配置。 该项目支持同步常规设置、过滤器(黑名单、白名单、用户规则)、DNS 重写、服务、客户端、DNS 配置、DHCP 配置以及 Web 界面主题。各项功能可全局或按副本启用或禁用。若启用 autoSetup 选项,可自动设置新的副本实例。 配置可通过环境变量或 YAML 文件进行,支持基于 cron 的调度、单次运行以及作为守护进程运行。认证可使用用户名/密码或 cookie,适用于不支持基本认证的环境(例如某些内置 AdGuard Home 的路由器)。项目还包含可选 API,支持指标和 TLS 配置。 部署方式包括独立二进制文件、Homebrew、Docker、Docker Compose、Linux 上的 systemd 服务、Windows 批处理脚本以及 Easypanel 模板。README 还记录了与 GL.iNet 路由器及 Home Assistant 的 AdGuard Home 插件的集成。