AdGuard Home Sync 使用指南

AdGuard Home Sync 使用指南

adguardhome-sync🛡️ Synchronize AdGuard Home config to replicas项目地址:https://gitcode.com/gh_mirrors/ad/adguardhome-sync

---

项目介绍

🛡️ AdGuard Home Sync 是一个用于同步 AdGuard Home 配置到多个副本实例的工具。这个开源项目由 bakito 开发并维护，旨在帮助用户轻松管理他们的 AdGuard Home 实例配置，确保不同设备上的设置保持一致。支持跨平台部署，包括 x86-64 和 arm64 架构。

项目快速启动

Docker 快速部署

要迅速启动并运行 AdGuard Home Sync，您可以利用 Docker。下面是通过 Docker CLI 的简单步骤：

docker run -d \
--name=adguardhome-sync \
-p 8080:8080 \
-v /path/to/local/config:/config/adguardhome-sync.yaml \
--restart unless-stopped \
ghcr.io/bakito/adguardhome-sync:latest

如果您偏好 docker-compose，可以使用以下配置文件：

version: "2.1"
services:
  adguardhome-sync:
    image: ghcr.io/bakito/adguardhome-sync
    container_name: adguardhome-sync
    command: run --config /config/adguardhome-sync.yaml
    volumes:
      - /path/to/local/config/adguardhome-sync.yaml:/config/adguardhome-sync.yaml
    ports:
      - 8080:8080
    restart: unless-stopped

别忘了替换 /path/to/local/config/ 为您本地配置文件的实际路径。

环境变量设置

您可以通过环境变量来进一步定制您的 AdGuard Home Sync 实例，比如日志级别(LOG_LEVEL)和源 AdGuard Home 实例的 URL (ORIGIN_URL)。

environment:
  LOG_LEVEL: "info"
  ORIGIN_URL: "https://your.adguard.home:3000"

应用案例和最佳实践

多实例同步场景: 对于拥有多个家庭或办公网络的用户来说，通过 AdGuard Home Sync 可以确保所有网络中的广告拦截规则和配置保持一致。只需在主 AdGuard Home 实例上做出更改，即可自动推送到其他副本中，简化管理和维护流程。

定期自动同步: 利用 --cron 参数设置定时任务，例如每两小时同步一次，以自动化配置更新过程。

adguardhome-sync run --cron "0 */2 * * *"

典型生态项目

AdGuard Home Sync 与 AdGuard Home 密切相关，后者是一款基于DNS的广告拦截解决方案，可以在家庭网络层面提供全面的网络安全保护。结合使用时，AdGuard Home 提供核心的过滤服务，而 AdGuard Home Sync 确保这些服务的配置能够被一致地复制到可能存在的多个部署点，增强家庭网络管理的灵活性和一致性。

在构建高效且统一的家庭或企业级网络防护策略时，这种搭配成为了隐私保护和内容管理的重要组成部分，尤其适用于那些寻求集中配置管理的高级用户或组织。

---

通过以上步骤和说明，您可以轻松集成和利用 AdGuard Home Sync，实现多节点的配置同步，为网络管理带来便利和效率。

adguardhome-sync🛡️ Synchronize AdGuard Home config to replicas项目地址:https://gitcode.com/gh_mirrors/ad/adguardhome-sync