Différences

Ci-dessous, les différences entre deux révisions de la page.

--- syncthing [Le 06/09/2016, 05:32]
zarmu
+++ syncthing [Le 15/05/2025, 19:30] (Version actuelle)
krodelabestiole [Installation] réécriture complète
@@ Ligne 1: / Ligne 1: @@
-{{tag>Xenial synchronisation BROUILLON}}
+{{tag>Xenial Bionic synchronisation}}
-Syncthing est un logiciel open source. Il permet de synchroniser les répertoires de plusieurs machines à travers Internet au moyen d'une connexion P2P sécurisée. Ils fonctionnent sur diverses plateformes en plus de Linux, dont Windows, OS-X, Android... Ce qui permet de créer son propre cloud sans passer par des serveurs hébergés par des tiers !
+{{ :syncthing.png?220|}}
-<note important>Ce logiciel etant en cours de developpement, il est fortement conseillé de faire une copie de sauvegarde des répertoires que vous souhaitez synchroniser avant de paramétrer Syncthing.</note>
+====== Syncthing ======
+Syncthing est un logiciel open source. Il permet de synchroniser les répertoires de plusieurs machines à travers Internet au moyen d'une connexion P2P sécurisée. Il fonctionne sur diverses plateformes en plus de Linux, dont Windows, OS-X, Android... Ce qui permet de créer son propre cloud sans passer par des serveurs hébergés par des tiers !
 ===== Installation =====
-  * ajouter la clé PGP :
-<code>curl -s https://syncthing.net/release-key.txt | sudo apt-key add - </code>
-  * Ajoutez à vos sources la source "release"
+Il existe plusieurs méthodes //au choix// pour installer **Syncthing** :
-<code>echo "deb http://apt.syncthing.net/ syncthing release" | sudo tee /etc/apt/sources.list.d/syncthing.list</code>
+  * version [[deb]] en [[#dépôts officiels APT]] d'Ubuntu. Il suffit pour en profiter d'[[:tutoriel:comment_installer_un_paquet|installer le paquet]] ''[[apt>syncthing]]''.
+  * divers paquets [[:Flatpak]] non-officiels sur [[https://flathub.org/apps/search?q=syncthing|Flathub]]
+  * divers paquets [[:snap]] non-officiels sur [[https://snapcraft.io/store?q=syncthing|Snapcraft]]
+  * un [[#PPA]] officiel
+<note tip>
+Vous trouverez aussi des informations concernant le téléchargement et l'installation de **Syncthing** en anglais sur son [[https://syncthing.net/downloads/|site officiel]].
+</note>
+==== PPA ====
+<note>
+Ce [[:PPA]] est proposé par les développeurs de **Syncthing**, mais il n'est pas strictement nécessaire, et peut poser les [[:ppa#presentation_des_depots_logiciels|problèmes]] habituels inhérents aux PPAs.
+</note>
+La procédure pour installer ce [[:PPA]] sur Ubuntu est décrite en anglais sur la [[https://apt.syncthing.net/|documentation officielle]].
+  * Ajouter la clé PGP :<code>sudo mkdir -p /etc/apt/keyrings
+sudo curl -L -o /etc/apt/keyrings/syncthing-archive-keyring.gpg https://syncthing.net/release-key.gpg</code>
+  * Ajouter la source ''stable''<code>echo "deb [signed-by=/etc/apt/keyrings/syncthing-archive-keyring.gpg] https://apt.syncthing.net/ syncthing stable" | sudo tee /etc/apt/sources.list.d/syncthing.list</code>
+  * [[:tutoriel:comment_modifier_sources_maj#recharger_la_liste_des_paquets|Recharger la liste des paquets]]
+  * [[:tutoriel:comment_installer_un_paquet|Installer le paquet]] ''[[apt>syncthing]]''.
+===== Démarrage automatique =====
+Depuis Ubuntu 18.04, les fichiers de config pour lancer Syncthing en tant que service Systemd sont inclus dans les paquets. Pour que le service soit lancé automatiquement pour l'utilisateur Toto, il suffit de taper dans une console :
+<code>sudo systemctl enable syncthing@toto.service
+sudo systemctl start syncthing@toto.service</code>
-  * Puis rechargez vos sources et installez
-<code>sudo apt-get update
-sudo apt-get install syncthing</code>
-===== Demarrage automatique =====
-Actuellement (septembre 2016), les paquages n'incluent pas les fichiers de config pour demarrer Syncthing automatiquement comme un service. Voici donc comment le configurer avec [[Systemd]] sous Ubuntu 16.04.
-Pour cela, commençons par crer le fichier syncthing@.service dans /etc/systemd/system/
-<code>gksudo gedit /etc/systemd/system/syncthing@.service</code>
+Auparavant, il fallait créer les fichiers de configuration manuellement.\\
+Pour cela, commençons par [[:tutoriel:comment_modifier_un_fichier|créer le fichier]] syncthing@.service dans **/etc/systemd/system/**
 Et copiez y les infos suivantes :
@@ Ligne 50: / Ligne 72: @@
 ===== Utilisation =====
+==== Premiers pas ====
-Lancez l'application via le [[:unity#tableau_de_bord_dash|tableau de bord]] (Unity) ou via le [[:terminal]] (toutes versions d'Ubuntu) avec la [[:commande_shell|commande]] suivante :
+Si vous avez correctement configuré le service Syncthing, vous devez y accéder dans votre navigateur web sur le port par défaut 8384 en entrant l'adresse localhost:8384.
-<code>machin-chose</code>
+Sinon, lancez Syncthing en tapant la commande suivante dans un terminal :
+<code>syncthing</code>
+Vous obtenez alors une fenêtre proche de celle ci :
+{{ :syncthing_uxenial_01.png?direct&400 |}}
+Sur la partie gauche de la fenêtre intitulée **partage**, vous trouverez la liste des répertoires partagés et leur statut (actuellement aucun). Sur la partie de droite, vous trouverez les informations relative à votre cluster de machines synchronisées (actuellement, il n'y a que la machine locale intitulée Zbox)\\
+Syncthing ayant pour but de synchroniser des répertoires entre plusieurs machines, il vous faut au moins une autre machine sur laquelle est installée Syncthing.
+<note important>Syncthing n'est pas capable de synchroniser des répertoires sur la même machine</note>
+<note tip>Afin de faciliter la configuration de vos diverses machines, je recommande de créer des accès à distance pour travailler depuis une seule machine. Voir la section suivante pour plus d'infos à ce sujet</note>
+==== Ajout d'une machine ====
+Supposons que vous souhaitiez synchroniser des répertoires entre deux machines (ou appareils selon la terminologie de Syncthing) nommées A et B. A doit connaître l’existence de B et inversement. Pour cela, Syncthing identifie les machines à l'aide d'un identifiant unique crée lors de la première utilisation sur une nouvelle machine. Pour connaître l'identifiant de la machine A, il faut aller sur la page //Afficher mon ID// du menu //Actions//. On obtient alors la page suivante :
+{{ :syncthing_uxenial_02.png?direct&400 |}}
+Copiez l’identifiant  apparu et faites-le parvenir par un moyen ou un autre à la machine B (par e-mail par exemple)
+<note>Il n'est pas nécessaire de conserver secrètement cet identifiant : c'est une clé publique</note>
+Aller alors sur votre machine B et cliquez sur le bouton en bas à droite //**+** Ajouter un appareil distant//. Dans la fenêtre qui s'affiche, collez l'identifiant de la machine A, donnez lui un nom intelligible et enregistrez.
+{{ :syncthing_uxenial_03.png?direct&400 |}}
+Après un petit temps d'attente, le statut de la machine A apparaissant dans le GUI de la machine B devrait passer de //Déconnecté// à //non utilisé//
+<note tip>Sur les anciennes version (antérieure à la V0.14.15 que j'utilise actuellement), il était nécessaire de redémarrer Syncthing pour que l'ajout de machines soit pris en compte. Pour cela, il suffit de cliquer sur le bouton //Redémarrer// du menu //Actions// </note>
+Procédez de même de la machine B sur la machine A pour que les 2 machines se connaissent.
+<note tip>Normalement, cette étape devrait être facilitée : sur la machine A, vous devriez trouver un message indiquant qu'elle reçoit une demande de connexion de la machine B. Accepter la demande revient à ajouter la machine B à la liste des machines connectées à la machine A.</note>
+==== Synchronisation de répertoires ====
+Il faut désormais indiquer à Syncthing les répertoires qui doivent être synchronisés. Pour cela, il faut cliquer sur le bouton //**+** Ajouter un partage// dans la zone de gauche du GUI et renseigner les diverses informations de la page.
+  * **Étiquette du partage** Étiquette optionnelle pour le partage. Peut être différente sur chaque appareil.
+  * **ID du partage** Identifiant unique du partage. Doit être le même sur l'ensemble des appareils concernés. N’hésitez pas à remplacer celui proposé d'office par Syncthing par un nom intelligible.
+  * **Chemin racine du partage** Chemin vers le répertoire dans l'appareil local.
+  * **Synchroniser avec des appareils** Cliquez sur le nom des machines sur lesquelles ce répertoire sera synchronisé.
+  * **Configuration avancée** Cliquez pour accéder aux paramètres suivants :
+    * **Type de partage** Choisissez //Normal// pour de la synchronisation bidirectionnelle ou //Maître// pour de la synchronisation unidirectionnelle dans laquelle le répertoire de la machine locale est la source. Voir la page [[synchronisation]] pour plus d'information à ce sujet.
+    * **Ignorer les permissions** Cliquez ici si l'un de vos partage ce trouve sur une machine Windows ne gerant pas les permissions comme sur Linux
+Procédez de même sur vos autres machines ou attendez de recevoir et acceptez l'invitation au partage de la première machine configurée sur les autres.\\
+La synchronisation de vos répertoires entre vos diverses machines devrait commencer.
 ===== Contrôle à distance =====
-Pour supprimer cette application, il suffit de [[:tutoriel:comment_supprimer_un_paquet|supprimer son paquet]]. Selon la méthode choisie, la configuration globale de l'application est conservée ou supprimée. Les journaux du système, et les fichiers de préférence des utilisateurs dans leurs dossiers personnels sont toujours conservés.
+Si vous souhaitez accéder à la console d'administration de Syncthing depuis une autre machine, vous pouvez utiliser 2 méthodes :
+==== Par SSH en port forwarding ====
+Si vous n'avez pas modifié le port standard de syncthing de votre serveur 192.168.0.20, vous vous y connectez en local sur le port 8384. Sur la machine client depuis laquelle vous souhaitez vous connecter à distance, nous allons rediriger le GUI sur le port 9090 :
+<code>ssh -L 9090:127.0.0.1:8384 Toto@192.168.0.20</code>
+Entrez maintenant l'adresse //localhost:9090// dans votre navigateur préféré et vous vous retrouverez sur la console d'administration de votre serveur 192.168.0.20
+==== En modifiant les paramétres dans le GUI ====
+Dans la page **Configuration** , il suffit de remplacer l'adresse du GUI //127.0.0.1:8384// par //0.0.0.0:8384//
+<note warning> Avec cette méthode, il est impératif de mettre en place un Mot de passe et d'activer l'HTTPS pour le GUI (sur la page Configuration du GUI) pour éviter un évident trou de sécurité.</note>
 ===== Désinstallation =====
@@ Ligne 64: / Ligne 137: @@
 ===== Voir aussi =====
-  * **(en)** [[Site officiel du logiciel]]
+  * **(en)** [[https://syncthing.net/|Site officiel du logiciel]]
-  * **(fr)** [[Site de la communauté francophone du logiciel Bidule]]
+  * **(fr)** [[https://djan-gicquel.fr/IMG/pdf/syncthing-utilisation.pdf|Présentation de l'utilisation de Synthing en image]]
-  * [[http://forum.ubuntu-fr.org/viewtopic.php?id=64840|Discussion « J'ai un soucis avec le logiciel Bidule »]] sur le forum Ubuntu-fr
 ----
-//Contributeurs principaux : [[utilisateurs:votre_identifiant|votre nom ou pseudonyme]], [[utilisateurs:autre_identifiant|nom ou pseudo autre]].//
+//Contributeurs principaux : [[utilisateurs:zarmu|zarmu]].//
-//Basé sur [[http://www.document_source.com|« Titre original de l'article »]] par Auteur Original.//
+//Basé sur [[https://docs.syncthing.net|« Documentation officielle de Syncthing »]].//