Configuration

La plupart des fonctions de Chute sont pilotées par le fichier de configuration. Vous pouvez le modifier dans votre propre éditeur de texte, ou dans l'éditeur intégré de Chute iOS, de Chute tvOS, de Chute Mac (onglet Config de la fenêtre principale, ou Préférences... dans l'ancienne interface) ou de Chute Android. Chute Dashboard n'a pas d'éditeur de configuration — ce qu'il modifie, ce sont les règles du moteur en cours d'exécution, jamais le fichier.

Chute iOS peut synchroniser les fichiers de configuration via iCloud Drive, ce qui est une fonctionnalité sous licence. Chute Mac n'a pas de synchronisation iCloud propre : y partager un fichier revient à en choisir un qui se trouve dans iCloud Drive depuis le panneau d'import, et il est alors référencé là où il est.

Sections de configuration

Le fichier de configuration est organisé en sections nommées :

Remarque : les sections [Panel], [Ponte], [MTProto], [Keystore], [Port Forwarding], [Testing], [DHCP] et [Snell Server] sont reconnues afin qu'une configuration Surge ne provoque pas d'erreur (chacune consigne un avis dans le journal), et leurs lignes sont conservées telles quelles à l'enregistrement, mais elles n'ont aucun effet dans Chute.

Section DNS

Les clés [General] liées au DNS peuvent tout aussi bien être écrites dans une section de premier niveau [DNS]. Les lignes de cette section sont traitées clé par clé :

[DNS]
doh = https://dns.google/dns-query
hijack-dns = 8.8.8.8:53
*.example.com = server:1.1.1.1

Remarque : les deux formes de ligne étant acceptées ici, une section [DNS] peut mêler réglages de serveur DNS et redéfinitions par domaine. Ne répétez pas le même réglage dans [General] et [DNS] : une seconde ligne doh, par exemple, est signalée comme une configuration DoH en double.

Remarque : fallback-dns-server et encrypted-dns-skip-cert-verification sont également lus sous [DNS], bien qu'ils ne figurent pas dans la première ligne. Une clé qui n'est pas un réglage DNS n'est pas ignorée ici — elle est lue comme une redéfinition par domaine, si bien qu'une clé [General] mal placée telle que optimistic-dns = false devient silencieusement la correspondance optimistic-dns → false. Seule une ligne que l'analyseur de redéfinitions rejette lui aussi donne lieu à un avis. Voir DNS.

Inclure un autre fichier

Un profil peut inclure un autre fichier. Surge écrit #!include <path> ; Shadowrocket écrit include = <other.conf> au-dessus de la première section. Les deux sont lues, et le fichier inclus est inséré là où figure la directive : un fragment [Rule] atterrit donc dans la section qui le nomme.

#!include Rulesets/company.list

• Le chemin est résolu par rapport au répertoire du fichier qui le nomme et peut contenir un * — #!include Rulesets/*.list inclut tout un répertoire de fragments de règles, par ordre de nom.
• Les inclusions s'imbriquent jusqu'à 8 niveaux, et un fichier déjà inclus — le profil lui-même compris — ne l'est pas une seconde fois : un cycle ne peut donc pas s'emballer, et un profil qui s'inclut lui-même est simplement ignoré.
• Une inclusion n'est développée que si le profil a été chargé depuis un fichier. Remis au moteur sous forme de texte — c'est ainsi qu'une configuration passe habituellement dans le tunnel — il n'y a pas de répertoire de résolution : le profil est alors signalé comme incomplet plutôt que traité comme entier. La directive elle-même est conservée à l'enregistrement : elle est réécrite exactement telle qu'elle a été lue, et le contenu du fichier inclus n'est jamais écrit dans le profil.

Commentaire

Une ligne qui commence par #, ; ou // est un commentaire. Les trois mêmes marqueurs ouvrent aussi un commentaire en fin de ligne, mais seulement juste après une espace ou une tabulation, et jamais entre guillemets ("…" ou '…', \ échappant le caractère suivant). Le :// d'une URL, un chemin comme a//b et une valeur base64 sans guillemets qui contient par hasard // ou # restent donc entiers. Les commentaires et les lignes vides sont conservés à l'enregistrement de la configuration.

Les commentaires en fin de ligne fonctionnent autrement dans les sections de réécriture et sur les lignes ssid / subnet de [Proxy Group] :

Les lignes de directive — #!include, #!MANAGED-CONFIG, #!IOS-ONLY et semblables — sont lues comme des directives avant que tout cela ne s'applique. Les fichiers que télécharge un jeu de règles, un jeu de domaines ou un fournisseur de proxy ne sont pas des sections de configuration : seule une ligne entière peut y être un commentaire.