11notes/adguard-sync

!https://raw.githubusercontent.com/11notes/static/refs/heads/master/img/banner/README.png

ADGUARD-SYNC

!size!https://raw.githubusercontent.com/11notes/static/refs/heads/master/img/markdown/transparent5x2px.png!pulls!https://raw.githubusercontent.com/11notes/static/refs/heads/master/img/markdown/transparent5x2px.png%5B](https://github.com/11notes/docker-adguard-sync/issues)!https://raw.githubusercontent.com/11notes/static/refs/heads/master/img/markdown/transparent5x2px.png!swiss_made

简介 📢

同步AdGuard Home配置到副本实例

!https://github.com/11notes/docker-adguard-sync/blob/master/img/API.png?raw=true

概述 📖

此镜像能做什么？ 若您希望高可用运行https://github.com/11notes/docker-adguard%EF%BC%8C%E9%9C%80%E8%A6%81%E5%90%8C%E6%AD%A5%E4%B8%A4%E4%B8%AA%E6%88%96%E5%A4%9A%E4%B8%AA%E5%AE%9E%E4%BE%8B%E9%97%B4%E7%9A%84%E9%85%8D%E7%BD%AE%E3%80%82https://github.com/bakito/adguardhome-sync%E9%80%9A%E8%BF%87%E5%B0%86%E4%B8%BB%E5%AE%9E%E4%BE%8B%E7%9A%84%E6%89%80%E6%9C%89%E8%AE%BE%E7%BD%AE%E5%A4%8D%E5%88%B6%E5%88%B0%E5%A4%9A%E4%B8%AA%E4%BB%8E%E5%AE%9E%E4%BE%8B%E8%A7%A3%E5%86%B3%E6%AD%A4%E9%97%AE%E9%A2%98%E3%80%82%E6%9C%AC%E9%95%9C%E5%83%8F%E6%8F%90%E4%BE%9B%E8%AF%A5%E5%8A%9F%E8%83%BD%EF%BC%8C%E4%B8%94%E4%BB%A5https://github.com/11notes/RTFM/blob/main/linux/container/image/rootless.md%E5%92%8Chttps://github.com/11notes/RTFM/blob/main/linux/container/image/distroless.md%E6%96%B9%E5%BC%8F%E8%BF%90%E8%A1%8C%E3%80%82

核心优势 💶

为何选择此镜像而非其他现有镜像？ 原因如下：

• 以https://github.com/11notes/RTFM/blob/main/linux/container/image/rootless.md%E6%96%B9%E5%BC%8F%E8%BF%90%E8%A1%8C%EF%BC%8C%E7%94%A8%E6%88%B7ID/%E7%BB%84ID%E4%B8%BA1000:1000
• 基于https://github.com/11notes/RTFM/blob/main/linux/container/image/distroless.md%EF%BC%8C%E4%B8%8D%E5%90%ABshell
• 通过CI/CD自动更新至最新版本
• 包含健康检查
• 以只读模式运行
• 发布前后自动扫描漏洞（CVE）
• 通过安全且固定的CI/CD流程构建
• 镜像体积极小

若您重视安全性、简洁性和极致优化，此镜像可能适合您。

对比 🏁

以下是本镜像与最常用或原始镜像的对比：

默认配置 📑

yaml
cron: "*/15 * * * *"
runOnStart: true
continueOnError: false

origin:
  url: http://adguard-master:3000
  username: admin
  password: adguard

replicas:
  - url: http://adguard-slave:3000
    username: admin
    password: adguard

api:
  port: 3000
  username: admin
  password: adguard
  darkMode: true
  metrics:
    enabled: true
    scrapeInterval: 10s
    queryLogLimit: 10000

features:
  generalSettings: true
  queryLogConfig: true
  statsConfig: true
  clientSettings: true
  services: true
  filters: true
  dhcp:
    serverConfig: true
    staticLeases: true
  dns:
    serverConfig: true
    accessLists: true
    rewrites: true

卷 📁

• /adguard-sync/etc - 配置文件目录

编排示例 ✂️

yaml
name: "adguard-sync"
services:
  adguard-sync:
    depends_on:
      adguard-master:
        condition: "service_healthy"
        restart: true
      adguard-slave:
        condition: "service_healthy"
        restart: true
    image: "11notes/adguard-sync:0.9.0"
    read_only: true
    security_opt:
      no-new-privileges: true
    environment:
      TZ: "Europe/Zurich"
    volumes:
      - "adguard-sync.etc:/adguard-sync/etc"
    ports:
      - "3000:3000/tcp"
    networks:
      frontend:
    restart: "always"

  adguard-master:
    image: "11notes/adguard:0.107.63"
    environment:
      TZ: "Europe/Zurich"
    ports:
      - "1053:53/udp"
      - "1053:53/tcp"
      - "3001:3000/tcp"
    networks:
      frontend:
    restart: "always"

  adguard-slave:
    image: "11notes/adguard:0.107.63"
    environment:
      TZ: "Europe/Zurich"
    ports:
      - "2053:53/udp"
      - "2053:53/tcp"
      - "3002:3000/tcp"
    networks:
      frontend:
    restart: "always"

volumes:
 adguard-sync.etc:

networks:
  frontend:

如需修改此容器镜像的默认UID/GID，请参考https://github.com/11notes/RTFM/blob/main/linux/container/image/11notes/how-to.changeUIDGID.md#change-uidgid-the-correct-way%E3%80%82

默认设置 🗃️

环境变量 📝

主要标签 🏷️

以下是镜像的主要标签。另有基于每个提交及其短SHA256值的标签。

• https://hub.docker.com/r/11notes/adguard-sync/tags?name=0.9.0
• https://hub.docker.com/r/11notes/adguard-sync/tags?name=0.9.0-unraid
• https://hub.docker.com/r/11notes/adguard-sync/tags?name=0.9.0-nobody

没有latest标签，如何处理更新？

个人认为:latest标签是不良习惯，不应使用。许多开发者在新版本中引入破坏性变更，会影响使用:latest的用户。若不想手动更新标签至最新语义化版本，可使用语义化版本的短版本。例如，使用:0或:0.9而非:0.9.0。这些标签会随新版本更新，效果类似:latest但固定在主版本或次版本，理论上不会引入破坏性变更。

若仍需使用最新版本（含潜在风险），可使用:rolling标签，但请注意：此标签会即时获取应用的最新版本，无论是否存在破坏性变更或安全问题，风险自负！

镜像仓库 ☁️

docker pull 11notes/adguard-sync:0.9.0
docker pull ghcr.io/11notes/adguard-sync:0.9.0
docker pull quay.io/11notes/adguard-sync:0.9.0

UNRAID版本 🟠

本镜像默认支持unraid。只需在任意标签后添加**-unraid**，镜像将以99:100而非1000:1000运行。

NOBODY版本 👻

本镜像默认支持nobody用户。只需在任意标签后添加**-nobody**，镜像将以65534:65534而非1000:1000运行。

源代码 💾

• https://github.com/11notes/docker-adguard-sync

基础镜像 🏛️

此镜像不基于其他镜像，以https://hub.docker.com/_/scratch%E4%B8%BA%E5%9F%BA%E7%A1%80%E5%B1%82%E3%80%82%E5%8C%85%E5%90%AB%E4%BB%A5%E4%B8%8B%E7%B2%BE%E7%AE%80%E6%97%A0%E5%8F%91%E8%A1%8C%E7%89%88%E5%B1%82%EF%BC%9A

• https://github.com/11notes/docker-distroless/blob/master/arch.dockerfile - 包含用户、时区和根CA证书，无其他内容
• https://github.com/11notes/docker-distroless/blob/master/curl.dockerfile - 用于执行HTTP请求的工具

构建工具 🧰

• https://github.com/bakito/adguardhome-sync

通用提示 📌

• 使用反向代理（如Traefik、Nginx、HAproxy）终止TLS并保护端点
• 使用Let’s Encrypt DNS-01挑战获取服务的有效SSL证书

注意事项 ⚠️

• 本镜像默认配置中管理员账户使用默认密码。请务必设置自定义密码或提供自定义配置

ElevenNotes™️

本镜像仅供参考，使用风险自负。更新镜像版本前请务必备份数据。查看https://github.com/11notes/docker-adguard-sync/releases%E4%BA%86%E8%A7%A3%E7%A0%B4%E5%9D%8F%E6%80%A7%E5%8F%98%E6%9B%B4%E3%80%82%E4%BD%BF%E7%94%A8%E4%B8%AD%E9%81%87%E5%88%B0%E9%97%AE%E9%A2%98%E8%AF%B7%E6%8F%90%E4%BA%A4https://github.com/11notes/docker-adguard-sync/issues%E3%80%82%E5%A6%82%E6%9C%89%E7%96%91%E9%97%AE%E6%88%96%E5%BB%BA%E8%AE%AE%EF%BC%8C%E8%AF%B7%E5%88%9B%E5%BB%BAhttps://github.com/11notes/docker-adguard-sync/discussions%E8%80%8C%E9%9D%9Eissue%E3%80%82%E5%8F%AF%E5%9C%A8https://github.com/11notes?tab=repositories%E6%9F%A5%E7%9C%8B%E6%89%80%E6%9C%89%E5%85%B6%E4%BB%96%E4%BB%93%E5%BA%93%E3%80%82

创建于20.05.2026, 23:11:04 (CET)