Initial vault setup
This commit is contained in:
@@ -0,0 +1,101 @@
|
||||
---
|
||||
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
|
||||
Reference in New Issue
Block a user