Script de Mise à Jour DDNS (Dynamic DNS) pour Online.net et Scaleway

Objectif

Le script vise à automatiser la mise à jour des enregistrements DNS pour un sous-domaine spécifié chez le fournisseur de services en ligne Online.net. Cela est particulièrement utile dans les scénarios où l'adresse IP de l'hôte change régulièrement.

⚠️ Les adresses IPv6 ne sont pas encore entièrement prises en charge. Assurez-vous que vos configurations et attentes sont alignées avec cette limitation. ⚠️

Fonctionnalités

1. Compatibilité Fournisseur: Le script est conçu pour fonctionner avec les API de Online.net

2. Utilisation de cURL: Le script utilise cURL pour effectuer des requêtes HTTP pour connaitre la ip du dns.

3. Configuration Facile: Les utilisateurs peuvent configurer facilement leurs informations d'identification, le sous-domaine à mettre à jour, etc., en modifiant les variables dans le script.

4. Log de l'Activité: Le script enregistre les événements importants dans un fichier journal pour permettre un suivi et un dépannage faciles.

Configuration

Avant d'utiliser le script, les utilisateurs doivent configurer les paramètres spécifiques à leur environnement. Les paramètres typiques incluent :

• Informations d'identification API pour Online.net
• Nom de domaine racine.
• Sous-domaine à mettre à jour.
• Chemin du fichier journal.

Documentation API Online.net

Pour obtenir les informations d'identification API nécessaires, veuillez suivre les étapes ci-dessous :

1. Accédez à la page d'accès à l'API d'Online.net : https://console.online.net/fr/api/access.

2. Connectez-vous à votre compte Online.net.

3. Sur la page d'accès à l'API, vous trouverez les informations nécessaires, notamment votre "Clé d'accès" (API Key).

4. Copiez votre "Clé d'accès" et utilisez-la pour configurer la variable correspondante dans le script ddns_update.php.

Assurez-vous de consulter la documentation complète pour obtenir des détails sur l'utilisation de l'API Online.net : Doc API Online..

Remarques

Le script est fourni tel quel et doit être adapté aux besoins spécifiques de l'utilisateur. Veillez à ne pas stocker les informations d'identification d'API de manière non sécurisée. Assurez-vous que le serveur exécutant le script a accès à Internet pour effectuer des requêtes vers les API des fournisseurs.

Comment Utiliser image docker avec Docker Compose (recommandé, DockerHub)

version: '3'
services:
  ddns:
    image: vincentberry/ddns-online-scaleway
    environment:
      - ONLINE_TOKEN=MonTokenOniline.Net
      - DOMAINS=exemple.fr,exemple-2.fr
      - SUBDOMAINS=@,*
      - TYPES=A
      - CHECK_PUBLIC_IPv4=true #optional
      - LOG_LEVEL=INFO #optional
    restart: unless-stopped

Les logs sont stocké dans le docker /usr/src/app/log Des DNS si besoin pour le ping peut être spécifié

version: '3'
services:
  ddns:
    image: vincentberry/ddns-online-scaleway
   volumes:
        - /MonDossier/log:/usr/src/app/log
    environment:
      - ONLINE_TOKEN=MonTokenOniline.Net
      - DOMAINS=exemple.fr,exemple-2.fr
      - SUBDOMAINS=@,*
      - TYPES=A
      - CHECK_PUBLIC_IPv4=true #optional
      - CHECK_PUBLIC_IP6=true #optional
      - LOG_LEVEL=INFO #optional
    dns:
      -8.8.8.8
      -2001:4860:4860::8888
    restart: unless-stopped

Comment Utiliser le Script avec Docker Compose (sans dockerhub)

1. Téléchargement du Script: Téléchargez le script ddns_update.php depuis le référentiel GitHub.

2. Configuration: Ouvrez le script dans un éditeur de texte et configurez les variables au début du script selon vos besoins (informations d'identification, sous-domaine, etc.).

version: '3'
services:
  ddns:
    image: php:7.4-cli
    volumes:
      - /docker/ddns/script:/usr/src/app
      - /docker/ddns/log:/usr/src/app/log
    working_dir: /script
    environment:
      - ONLINE_TOKEN=MonTokenOniline.Net
      - DOMAINS=exemple.fr,exemple-2.fr
      - SUBDOMAINS=@,*
      - TYPES=A
      - CHECK_PUBLIC_IPv4=true #optional
      - CHECK_PUBLIC_IP6=true #optional
      - LOG_LEVEL=INFO #optional
    dns:
      -8.8.8.8
      -2001:4860:4860::8888
    command: ["php", "/usr/src/app/ddns_update.php"]
    restart: unless-stopped

php ddns_update.php

Variable	Type	Description
ONLINE_TOKEN	string	Remplacez "MonTokenOniline.Net" par votre clé API Online.net. Obtenez cette clé depuis la console Online.net.
DOMAINS	string	Indiquez la liste de vos domaines séparés par des virgules. Par exemple, exemple.fr,exemple-2.fr.
SUBDOMAINS	string	Spécifiez les sous-domaines séparés par des virgules que vous souhaitez mettre à jour. Utilisez @ pour le domaine principal et * pour tous les sous-domaines. Par default: *,@
TYPES	A or AAAA or A,AAAA	Indiquez le type d'enregistrement DNS à mettre à jour. Par exemple, A (par défaut) pour un enregistrement de type Adresse IPv4. Par default: A,AAAA
CHECK_PUBLIC_IPv4	boolean	Optionnel Si défini à true, vérifie que l'adresse IP récupérée est une adresse publique. Sinon, cette vérification est ignorée. Par default: true
CHECK_PUBLIC_IPv6	boolean	Optionnel Si défini à true, vérifie que l'adresse IP récupérée est une adresse publique. Sinon, cette vérification est ignorée. Par default: true
LOG_PATH	string	Optionnel Le chemin du répertoire pour les logs. Si vous souhaitez les stocker dans un volume, spécifiez le chemin ici (par exemple, /log).
LOG_LEVEL	string	Optionnel Définit le niveau de log pour l'application. Les valeurs possibles sont : DEBUG, INFO, ERROR, FATAL. La valeur par défaut est DEBUG.
LOOP_INTERVAL	int	Optionnel La durée (en secondes) entre chaque itération de la boucle principale. Cela définit combien de temps le script attend avant de répéter ses vérifications. La valeur par défaut est 300 secondes (5 minutes).

Niveaux de log

Les niveaux de log disponibles dans l'application sont les suivants :

Niveau	Description
DEBUG	Informations détaillées pour le débogage.
INFO	Informations générales sur l'exécution du programme.
ERROR	Messages d'erreur signalant des problèmes à résoudre.
FATAL	Erreurs critiques entraînant l'arrêt de l'application.

Ce README a été créé avec le soutien d'une intelligence artificielle pour fournir des informations claires et utiles.