adguardhome-sync 是个用来同步 AdGuard Home 配置的工具,主要帮多台 AdGuard Home 实例解决配置不一致的麻烦。
AdGuard Home 是很多人常用的本地广告过滤工具,但要是家里或小团队里有好几台设备跑着它(比如主路由、旁路由,或者备用服务器),手动挨个改配置特别费劲——改个过滤器列表、加个客户端规则,每台都得重复操作,还容易出错。这工具就是干这个的:把一台「主实例」的配置自动同步到其他「从实例」,省得手动折腾。
它能同步的东西还挺全,像常用的广告过滤规则列表(包括自定义规则和第三方规则)、客户端设备的分组与权限设置、DNS 服务器地址(比如 upstream DNS 和备用 DNS),还有白名单/黑名单里的域名、IP 过滤规则这些,基本覆盖了日常配置的大部分内容。同步方式也灵活,既支持定时自动同步(比如每 5 分钟查一次主实例有没有更新),也能手动触发同步,临时改完配置想立刻同步时用得上。
用起来也简单,适合哪些人呢?比如家里有好几台路由都跑 AdGuard Home 的,主路由改了规则,旁路由和备用路由能自动跟上;或者小工作室用主备服务器的,主服务器配置变了,备用机不用手动改,减少运维时间。
部署也方便,它是个容器镜像(放在 ghcr.io 这个容器仓库里),用 Docker 就能跑。启动前填几个参数:主实例的地址(比如 [***] AdGuard Home 的用户名密码(如果开了认证的话),保存配置文件后,一条 Docker 命令就能启动。遇到配置冲突时(比如主从实例都改了同一个规则),它默认以主实例的设置为准,避免两边配置打架。
这工具本身很轻量,跑起来占不了多少资源,而且代码是开源的(在 GitHub 上能找到项目),有技术能力的话还能自己改改功能。对个人用户和小团队来说,算是个实用的小工具,不用再为多设备配置头疼了。
请登录使用轩辕镜像享受快速拉取体验,支持国内访问优化,速度提升
docker pull ghcr.io/bakito/adguardhome-sync:alpine-mainmanifest unknown 错误
TLS 证书验证失败
DNS 解析超时
410 错误:版本过低
402 错误:流量耗尽
身份认证失败错误
429 限流错误
凭证保存错误
来自真实用户的反馈,见证轩辕镜像的优质服务