102 lines
2.6 KiB
Markdown
102 lines
2.6 KiB
Markdown
---
|
|
title: AdGuardHome Sync
|
|
created: 2026-06-06
|
|
updated: 2026-06-06
|
|
type: app
|
|
tags: [catalogue, ad-block, sync, go]
|
|
confidence: high
|
|
contested: false
|
|
sources: [https://selfh.st/apps/?tag=Ad+Block, https://github.com/bakito/adguardhome-sync]
|
|
---
|
|
# 🔄 AdGuardHome Sync
|
|
|
|
> **Synchronisation de configuration entre plusieurs instances AdGuard Home**. Idéal pour les environnements multi-sites ou redondants.
|
|
|
|
## 📋 Informations Générales
|
|
|
|
| Champ | Valeur |
|
|
| :--- | :--- |
|
|
| **GitHub** | [bakito/adguardhome-sync](https://github.com/bakito/adguardhome-sync) |
|
|
| **License** | Apache-2.0 |
|
|
| **Langage** | Go |
|
|
| **Étoiles GitHub** | 2k ⭐ |
|
|
| **Dernière MAJ** | 2026-06-04 |
|
|
| **Catégorie** | [[cat-ad-block|Ad Block]] |
|
|
|
|
## 📝 Description
|
|
|
|
**AdGuardHome Sync** est un **outil complémentaire à [[app-adguard-home]]** qui synchronise :
|
|
|
|
- ✅ **Listes de blocage** (blocklists)
|
|
- ✅ **Règles de rewrite**
|
|
- ✅ **Clients et groupes**
|
|
- ✅ **Paramètres DNS**
|
|
- ✅ **Filtrage parental**
|
|
|
|
**Cas d'usage typique** : vous avez **plusieurs instances AdGuard Home** (maison, bureau, serveur VPN, parents) et vous voulez qu'elles partagent la même configuration. Sans cet outil, il faut mettre à jour chaque instance manuellement.
|
|
|
|
## 🚀 Installation
|
|
|
|
### Docker Compose
|
|
|
|
```yaml
|
|
# docker-compose.yml
|
|
version: '3.8'
|
|
services:
|
|
adguardhome-sync:
|
|
container_name: adguardhome-sync
|
|
image: ghcr.io/bakito/adguardhome-sync:latest
|
|
restart: unless-stopped
|
|
ports:
|
|
- "8080:8080" # Web UI
|
|
volumes:
|
|
- ./config.yml:/app/config.yml
|
|
depends_on:
|
|
- origin
|
|
- replicas
|
|
```
|
|
|
|
### Configuration (`config.yml`)
|
|
|
|
```yaml
|
|
origin:
|
|
url: http://adguard-main:3000
|
|
username: admin
|
|
password: ***replicas:
|
|
- name: Home
|
|
url: http://adguard-home:3000
|
|
username: admin
|
|
password: ***
|
|
- name: Office
|
|
url: http://adguard-office:3000
|
|
username: admin
|
|
password: ***
|
|
|
|
# Intervalle de sync (en minutes)
|
|
runOnStart: true
|
|
interval: 5m
|
|
```
|
|
|
|
## ⚙️ Configuration Initiale
|
|
|
|
1. Configurer l'instance **origin** (celle qui détient la config canonique)
|
|
2. Ajouter les **replicas** dans le config
|
|
3. Démarrer l'outil
|
|
4. Vérifier la sync via l'UI web : `http://IP:8080`
|
|
|
|
## 🔄 Alternatives
|
|
|
|
### Open Source
|
|
- **Bash scripts + cron** — DIY, fragile
|
|
- **Ansible/Puppet** — Plus lourd mais plus complet
|
|
|
|
### Quand l'utiliser ?
|
|
- ✅ Vous avez 2+ instances AdGuard Home
|
|
- ✅ Vous voulez une config uniforme
|
|
- ❌ Une seule instance → pas besoin
|
|
|
|
## Pages Liées
|
|
- [[cat-ad-block]] — Catégorie Ad Block
|
|
- [[app-adguard-home]] — Le serveur à synchroniser
|
|
- [[haute-disponibilite]] — Contexte HA
|