From 7d9300df181aee237953ab8d70486f935c6d07b8 Mon Sep 17 00:00:00 2001 From: Gilles Grandou Date: Sun, 4 Mar 2018 19:29:32 +0100 Subject: [PATCH] update README --- README | 111 +++++++++++++++++++++++++++++++-------------------------- 1 file changed, 61 insertions(+), 50 deletions(-) diff --git a/README b/README index fb6b4f4..525ff54 100644 --- a/README +++ b/README @@ -20,20 +20,20 @@ les machines de votre reseau: * la livebox elle-même: - $ host livebox.home.chezmoi.fr - livebox.home.chezmoi.fr has address 1.2.3.4 - livebox.home.chezmoi.fr has IPv6 address pppp:pppp:pppp:pppp:aaaa:aaaa:aaaa:aaaa + $ host livebox.home.chezmoi.fr + livebox.home.chezmoi.fr has address 1.2.3.4 + livebox.home.chezmoi.fr has IPv6 address pppp:pppp:pppp:pppp:aaaa:aaaa:aaaa:aaaa * une machine visible en IPv6: - $ host machine1.home.chezmoi.fr - machine1.home.chezmoi.fr has IPv6 address pppp:pppp:pppp:pppp:bbbb:bbbb:bbbb:bbbb + $ host machine1.home.chezmoi.fr + machine1.home.chezmoi.fr has IPv6 address pppp:pppp:pppp:pppp:bbbb:bbbb:bbbb:bbbb * une machine avec une redirection IPv4: - $ host machine2.home.chezmoi.fr - machine2.home.chezmoi.fr has address 1.2.3.4 - machine2.home.chezmoi.fr has IPv6 address pppp:pppp:pppp:pppp:cccc:cccc:cccc:cccc + $ host machine2.home.chezmoi.fr + machine2.home.chezmoi.fr has address 1.2.3.4 + machine2.home.chezmoi.fr has IPv6 address pppp:pppp:pppp:pppp:cccc:cccc:cccc:cccc Les enregistrements DNS sont configurés avec un TTL de 60s, donc un changement d'adresse est au pire visible en 2 minutes (parfois plus, si vous utilisez des @@ -43,7 +43,7 @@ serveurs qui forcent des mises en cache avec des durées minimales supérieures) Installation ------------ -$ git clone $URL +$ git clone https://framagit.org/ggrandou/dyndomain.git $ cd dyndomain $ git submodule init sysbus @@ -62,7 +62,7 @@ $ ./sysbus/sysbus.py -password LIVEBOXADMINPASSWORD -config password = LIVEBOXADMINPASSWORD model = lb4 -check that configuration is correct: +Verifier que la configuration est correcte: $ ./sysbus/sysbus.py SoftwareVersion : XG40_sip-fr-3.2.18.1_7.21.3.1 UpTime : 2 days, 10:10:12 (NumberOfReboots: 21) @@ -77,68 +77,79 @@ $ ./sysbus/sysbus.py Setup - OVH ----------- -I assume you already have: -- an OVH account NN1234-OVH -- a domain handled by OVH +Il vous faut: +- un compte chez OVH (nic-handle de la forme NN1234-OVH) +- un domaine herbergé chez OVH -* create ovh.conf file: +* Création du fichier ovh.conf: - $ cp ovh-sample.conf ovh.conf + $ cp ovh-sample.conf ovh.conf -* Create Application Token: +* Création de l'Application Token: - visit https://eu.api.ovh.com/createApp/ - fill fields: - - account id: your ovh account - - password - - Application Name: dyndomain or whatever you want - - Application Description: whatever you want - write down application key and application secret into ovh.conf file + visitez la page https://eu.api.ovh.com/createApp/ + remplir les champs: + - account id: votre compte OVH + - password + - Application Name: dyndomain ou ce que vous voulez + - Application Description: ce que vous voulez + remplissez les champs Application Key et Application Secret dans le + fichier ovh.conf -* Create Consumer Token: +* Création du Consumer Token: - edit register_ovh_account script with your own domain (in place of example.com) - $ ./register_ovh_account - visit printed url and authenticate yourself with your OVH account - write down consumer key into ovh.conf file + Editez le fichier register_ovh_account avec votre propre domaine + (à la place de example.com) + $ ./register_ovh_account + Visitez l'URL affichée et authentifiez-vous avec votre compte OVH. + Enregistrer la Consumer Key dans le fichier ovh.conf -Setup - Home configuration --------------------------- +Setup - Réseau local +-------------------- -* create home.conf file: +* Création du fichier home.conf: - $ cp home-sample.conf home.conf - -* setup [zone]: + $ cp home-sample.conf home.conf - domain: your own domain - subdomain: whatever your want, typically home: - all hosts will be something like mypc1.home.domain.ext +* configuration [zone]: -* setup [Hosts]: + domain: votre propre domaine + subdomain: ce que vous voulez, typiquement "home" - list here all machines you want to add in your domain with an IPv6 record + Toutes les machines seront nommées avec un nom du type + mypc1.home.domain.ext -* setup [NatHosts]: +* configuration [Hosts]: - list here all machines you want to add in your domain with the WAN IPv4 record - In order to be useful you need to have an IPv4 redirection rule in your livebox - for these hosts + Listez ici toutes les machines auquelles vous voulez ajouter un + enregistrement IPv6. -* setup [Mail]: +* configuration [NatHosts]: - all updates will be sent to this mail address + Listez ici toutes les machines auquelles vous voulez ajouter un + enregistrement IPv4. + Comme l'adresse IPv4 est l'adresse WAN (de la livebox), pour que + ce soit utile, il faut que vous ayez ajourter une règle de redirection + pour ces machines sur votre interface Livebox + +* configuration [Mail]: + + Chaque mise à jour génerera un mail qui sera envoyé à cette adresse. -Usage ------ +Utilisation +----------- -* test everything is correct: +* Pour tester que tout est correct: - $ ./dyndomain + $ ./dyndomain -* setup a crontab entry to launch it every minute + la zone dns doit être mise à jour pour votre domaines avec les machines + enregistrées, et vous devrier recevoir un mail notifiant la mise à jour. + +* Vous pouvez alors appeler ce script toutes les minutes avec une entrée + crontab.