Skip to main content

Vue d'ensemble

Qu'est-ce que AdGuard DNS CLI ?​

Un client DNS léger multiplateforme pour AdGuard DNS. Il fonctionne comme un serveur DNS qui transmet les requêtes DNS aux résolveurs en amont correspondants.

Démarrage rapide​

Systèmes d'exploitation pris en charge :

  • Linux
  • macOS
  • Windows

Les architectures de CPU prises en charge :

  • ARM 64 bits
  • AMD64
  • i386

Premiers pas​

Systèmes d'exploitation de type Unix​

  1. Téléchargez et décompressez l'archive .tar.gz ou .zip depuis la page de publications.

    ::caution

    Sous macOS, il est crucial que les daemons installés globalement soient la propriété de root (voir la documentation launchd), donc l'exécutable adguarddns-cli doit être placé dans le répertoire /Applications/ ou son sous-répertoire.

    :::

  2. Installez-le en tant que service en exécutant :

    ./adguarddns-cli -s install -v

  3. Modifiez le fichier de configuration config.yaml.

  4. Démarrez le service :

    ./adguarddns-cli -s start -v

Pour vérifier que ça fonctionne, utilisez n'importe quel utilitaire de vérification DNS. Par exemple, en utilisant nslookup :

nslookup -debug 'www.example.com' '127.0.0.1'

Windows​

Il suffit de télécharger et d'installer en utilisant l'installateur MSI de la page de publications.

Pour vérifier que ça fonctionne, utilisez n'importe quel utilitaire de vérification DNS. Par exemple, en utilisant nslookup.exe :

nslookup -debug "www.example.com" "127.0.0.1"

Options de ligne de commande​

Chaque option remplace la valeur correspondante fournie par le fichier de configuration et l'environnement.

Aide​

L'option -h fait en sorte que le client DNS AdGuard CLI affiche un message d'aide sur la sortie standard et quitte avec un code d'état de succès.

Service​

L'option -s <value> spécifie l'action du service OS. Les valeurs possibles sont :

  • installer: installe AdGuard DNS CLI comme un service
  • restart : redémarre le service AdGuard DNS CLI en cours d'exécution
  • start : démarre le service AdGuard DNS CLI installé
  • 'status' : affiche l’état du service ADGuard DNS CLI installé
  • stop : arrête AdGuard DNS CLI en cours d'exécution
  • uninstall : désinstalle le service AdGuard DNS CLI

Verbose​

L'option -v active la sortie de journal détaillée.

Version​

L'option --version permet à AdGuard DNS CLI d'afficher la version de l'application sur la sortie standard et de sortir avec un code de statut de réussite.

Configuration​

Fichier​

Le fichier de configuration YAML est décrit dans son propre article, et il existe également un exemple de fichier de configuration config.dist.yaml. Certains paramètres de configuration peuvent également être remplacés à l'aide de l'environnement.

Codes de sortie​

Il existe plusieurs codes de sortie différents qui peuvent apparaître dans différentes conditions d'erreur :

  • 0 : Terminé et sorti avec succès, sans erreurs.

  • 1: Erreur interne, très probablement une mauvaise configuration.

  • 2: Mauvais argument ou valeur de ligne de commande.