Syncthing - Guide de configurationlle
Syncthing est un logiciel open source de synchronisation de fichiers peer-to-peer. Il permet de synchroniser des dossiers entre plusieurs appareils sans passer par un service cloud tiers.
Fonctionnement
┌──────────────┐ ┌──────────────┐
│ Machine A │ ←──── Sync ─────→ │ Machine B │
│ │ │ │
│ Dossier/ │ │ Dossier/ │
│ ├─ file1 │ │ ├─ file1 │
│ └─ file2 │ │ └─ file2 │
└──────────────┘ └──────────────┘
Principe : Les modifications effectuées sur un appareil sont automatiquement répliquées sur les autres appareils connectés.
Caractéristiques :
- Open source
- Décentralisé (pas de serveur central)
- Chiffrement des échanges
- Détection automatique des modifications
Limitations importantes
Syncthing synchronise des fichiers mais ne gère pas l'édition collaborative simultanée.
Cas d'usage appropriés :
- Synchronisation de dossiers de travail
- Backup entre plusieurs machines
- Travail en alternance sur différents appareils
Cas problématiques :
- Édition simultanée du même fichier par plusieurs utilisateurs
- Collaboration temps réel sur documents
Comportement en cas de conflit :
Machine A modifie fichier.txt à 10h00
Machine B modifie fichier.txt à 10h00
→ Syncthing crée : fichier.txt et fichier.sync-conflict-2025-11-01.txt
La résolution des conflits doit être effectuée manuellement.
Prérequis
- Deux machines (Windows, Linux ou macOS)
- Connexion Internet sur les deux machines
- Droits d'administration pour l'installation
Installation
Windows
Méthode 1 : Archive officielle
- Télécharger depuis https://syncthing.net
- Section "Download" → "Windows"
- Télécharger
syncthing-windows-amd64-vX.X.X.zip - Extraire l'archive
- Exécuter
syncthing.exe - Le navigateur s'ouvre automatiquement sur http://127.0.0.1:8384
Méthode 2 : Installateur (recommandé)
- Accéder à https://github.com/Bill-Stewart/SyncthingWindowsSetup
- Section "Releases" → Télécharger le fichier
.exe - Exécuter l'installateur
- Syncthing démarre automatiquement au démarrage du système
- Icône disponible dans la zone de notification
Linux
sudo apt update
sudo apt install syncthing -y
syncthing
Interface accessible sur http://127.0.0.1:8384
macOS
brew install syncthing
syncthing
Interface accessible sur http://127.0.0.1:8384
Configuration
Schéma de configuration
ÉTAPE 1 : Connexion des appareils
┌─────────────┐ ┌─────────────┐
│ Machine A │ │ Machine B │
│ │ │ │
│ ID: ABC123 │──────────→│ Ajoute ABC │
│ │←──────────│ ID: XYZ789 │
│ Accepte XYZ │ │ │
└─────────────┘ └─────────────┘
ÉTAPE 2 : Partage du dossier
┌─────────────┐ ┌─────────────┐
│ Machine B │ │ Machine A │
│ │ │ │
│ Partage │──────────→│ Notification│
│ dossier │ │ reçue │
│ │ │ │
│ │ │ Acceptation │
│ │ │ + choix │
│ │ │ destination │
└─────────────┘ └─────────────┘
RÉSULTAT :
┌─────────────┐ ┌─────────────┐
│ Machine B │ ←─ Sync ─→│ Machine A │
│ │ │ │
│ Projet/ │ │ Projet/ │
│ ├─index.html │ ├─index.html
│ └─style.css │ └─style.css
└─────────────┘ └─────────────┘
Procédure de configuration
Étape 1 : Connexion des appareils
Sur la machine source (qui contient les fichiers)
-
Ouvrir l'interface Syncthing
- Cliquer sur l'icône dans la barre des tâches
- Ou accéder à http://127.0.0.1:8384
-
Récupérer l'identifiant de l'appareil
- Menu "Actions" → "Afficher l'ID"
- Un QR code et un identifiant alphanumérique s'affichent
- Copier l'identifiant (format : XXXXXXX-XXXXXXX-XXXXXXX-...)
Sur la machine destination
-
Ajouter l'appareil distant
- Bouton "Ajouter un appareil distant" (en bas à droite)
- Champ "ID de l'appareil" : Coller l'identifiant copié
- Champ "Nom de l'appareil" : Définir un nom descriptif
- Bouton "Enregistrer"
-
Accepter la connexion (retour sur machine source)
- Une notification apparaît : "Nouvel appareil souhaite se connecter"
- Bouton "Ajouter l'appareil"
- Définir un nom pour l'appareil distant
- Bouton "Enregistrer"
Résultat : Les deux appareils sont maintenant connectés.
Étape 2 : Configuration du partage
Sur la machine source
-
Créer un nouveau partage
- Bouton "Ajouter un dossier" (en bas à droite)
-
Configuration générale
- Onglet "Général"
- Champ "Nom du partage" : Définir un nom descriptif
- Champ "Chemin du dossier" : Sélectionner le dossier à synchroniser
- Exemple :
C:\Users\Username\Documents\Projet
-
Configuration du partage
- Onglet "Partage"
- Cocher la case correspondant à l'appareil distant
- Bouton "Enregistrer"
Sur la machine destination
- Accepter le partage
- Notification : "Nouveau dossier partagé"
- Bouton "Ajouter"
- Champ "Chemin du dossier" : Définir le chemin de destination
- Exemple :
C:\Sync\Projet - Bouton "Enregistrer"
La synchronisation démarre automatiquement.
Vérification
Interface de contrôle
Éléments à vérifier dans l'interface :
Cet appareil
État : Synchronisé
Stockage local : X fichiers, Y Mo
Autres appareils
Nom : [Appareil distant]
État : Connecté
Dernière synchronisation : Il y a quelques secondes
Partages
Nom : [Nom du dossier]
État : Synchronisé (100%)
Taille : X fichiers, Y Mo
Test de fonctionnement
- Sur la machine source : Créer un fichier test dans le dossier partagé
- Sur la machine destination : Vérifier l'apparition du fichier
- Délai de synchronisation : Quelques secondes maximum
Utilisation
Bonnes pratiques
Scénarios sans conflit
Cas 1 : Édition alternée
Jour 1 : Machine A modifie fichier1.txt
Jour 2 : Machine B modifie fichier2.txt
→ Aucun conflit
Cas 2 : Fichiers différents
Machine A édite fichierA.txt
Machine B édite fichierB.txt (simultané)
→ Aucun conflit
Scénarios avec conflit
Cas 3 : Édition simultanée
10h00 : Machine A modifie document.txt
10h00 : Machine B modifie document.txt
→ Conflit détecté
→ Création de : document.txt + document.sync-conflict-[date].txt
→ Fusion manuelle requise
Recommandations
- Communiquer avant l'édition de fichiers partagés
- Travailler sur des fichiers distincts quand possible
- Créer une copie de backup avant la première synchronisation
Options avancées
Exclusion de fichiers
Onglet "Ignorer les motifs" dans la configuration du dossier :
*.tmp
*.log
node_modules/
.git/
Thumbs.db
.DS_Store
Mode de synchronisation
Temps réel (par défaut)
- Synchronisation immédiate des modifications
- Recommandé pour la majorité des cas
Intervalle
- Synchronisation toutes les X secondes
- Configuration : Paramètres du dossier
Limitation de bande passante
Options :
- Limite d'upload (Ko/s)
- Limite de download (Ko/s)
Versioning
Permet de conserver les anciennes versions des fichiers.
Configuration :
- Paramètres du dossier → Onglet "Versions de fichiers"
- Type : "Versionnage simple"
- Définir le nombre de versions à conserver
Dépannage
Appareils non connectés
Causes possibles :
- Un ou plusieurs appareils éteints
- Absence de connexion Internet
- Pare-feu bloquant les connexions
Vérifications :
- État des appareils (allumés et connectés)
- Connectivité réseau
- Configuration du pare-feu Windows/Linux
Synchronisation bloquée
Vérifications :
- Consulter les messages d'erreur dans l'interface
- Vérifier l'espace disque disponible
- S'assurer qu'aucun fichier n'est verrouillé par une application
Gestion des conflits
Procédure :
- Identifier les fichiers avec l'extension
.sync-conflict-[date] - Comparer les deux versions
- Conserver la version correcte
- Supprimer le fichier de conflit
Sécurité
Backup préventif
Avant la première synchronisation :
# Windows
xcopy /E /I C:\DossierSource C:\Backup-[date]
# Linux/macOS
cp -r /chemin/source /chemin/backup-[date]
Gestion multi-dossiers
Syncthing permet la synchronisation de plusieurs dossiers indépendants.
Procédure :
- Répéter la création de partage pour chaque dossier
- Chaque dossier possède sa propre configuration
- Les dossiers peuvent être partagés avec des appareils différents
Résumé de la procédure
- Installation de Syncthing sur les deux machines
- Récupération de l'ID de chaque appareil
- Ajout mutuel des appareils
- Création et partage du dossier depuis la machine source
- Acceptation du partage sur la machine destination
- Vérification de la synchronisation