Format de fichier Vylos
Utilisez le format .vylos pour associer une configuration WireGuard standard aux réglages Vylos de DNS fractionné, À la demande et de coupe-circuit.
| settings.conf | Non | Sections Vylos [SplitDNS], [OnDemandRule] et [Routing] en texte UTF-8 de type INI. |
Structure de l’archive
Un fichier .vylos est une archive ZIP qui contient un fichier obligatoire et un fichier facultatif :
| Entrée de l’archive | Obligatoire | Contenu |
|---|---|---|
wireguard.conf | Oui | Sections WireGuard [Interface] et [Peer] non modifiées, au format texte UTF-8. |
settings.conf | Non | Sections Vylos [SplitDNS] et [OnDemandRule], au format texte UTF-8 inspiré du format INI. |
Vylos refuse une archive sans wireguard.conf, ou dont l’une des entrées n’est pas encodée en UTF-8. Une archive sans settings.conf se comporte comme la configuration WireGuard qu’elle contient.
L’extension ne modifie pas la syntaxe de configuration WireGuard. Vous pouvez extraire wireguard.conf et l’utiliser avec un autre client compatible WireGuard, tandis que les réglages propres à Vylos restent isolés dans settings.conf.
wireguard.conf
L’entrée obligatoire utilise les mêmes champs wg-quick que ceux acceptés par Vylos pour l’importation d’un fichier .conf ordinaire. Une configuration sans section [Peer] est valide, et un tunnel peut contenir plusieurs pairs.
[Interface]
PrivateKey = AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA=
Address = 10.0.0.2/32
DNS = 10.0.0.1
[Peer]
PublicKey = BBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBB=
AllowedIPs = 0.0.0.0/0
Endpoint = vpn.example.com:51820
PersistentKeepalive = 25
Remplacez les clés et le point de terminaison d’exemple par les valeurs fournies par votre serveur WireGuard. Consultez la documentation wg-quick du projet WireGuard pour le format de configuration sous-jacent.
settings.conf
La casse des noms de sections et de clés n’est pas prise en compte. Les lignes vides et le texte situé après # sont ignorés. En revanche, une section ou une clé inconnue, une ligne incorrecte, une action non prise en charge ou un type d’interface non pris en charge fait échouer l’importation.
DNS scindé
Utilisez une section [SplitDNS] avec l’une des clés prises en charge, ou les deux :
| Clé | Valeur |
|---|---|
Domains | Domaines séparés par des virgules dont les requêtes DNS utilisent les serveurs DNS du tunnel. |
SearchDomains | Suffixes séparés par des virgules utilisés pour relancer la recherche d’un nom d’hôte sans domaine. |
Les libellés de domaine peuvent contenir des lettres, des chiffres et des traits d’union internes. Vylos accepte également un caractère générique initial facultatif tel que *.example.com, ainsi qu’un point final pour les noms complets.
Vylos normalise les domaines de correspondance du DNS scindé avant de les appliquer au réseau Apple. Les entrées de domaine incorrectes sont ignorées au lieu d’être ajoutées à la liste de domaines du tunnel.
Règles à la demande
Ajoutez une section [OnDemandRule] pour chaque condition réseau. Plusieurs sections utilisent une logique OU : toute règle correspondante peut activer le tunnel.
| Clé | Obligatoire | Valeurs acceptées |
|---|---|---|
InterfaceType | Oui | cellular, ethernet ou wifi. |
Action | Non | connect ; si la valeur est omise, connect est aussi utilisé par défaut. |
SSIDs | Non | Pour le Wi-Fi, une liste d’inclusion séparée par des virgules, ou une liste dont chaque entrée commence par ! pour le mode Sauf. Omettez-la pour faire correspondre tout réseau Wi-Fi. |
Ne mélangez pas de SSID inclus et de SSID précédés de ! dans une même règle. Les règles cellulaires s’appliquent à iOS, les règles Ethernet à macOS et les règles Wi-Fi à toutes les plateformes Vylos prises en charge.
Vylos conserve les valeurs de règles propres à d’autres plateformes lors de l’importation et de la réexportation du tunnel. Un fichier portable peut ainsi préserver son comportement prévu sous iOS, macOS et visionOS.
Coupe-circuit
Ajoutez une section [Routing] pour bloquer la majeure partie du trafic réseau lorsqu’un tunnel À la demande armé est indisponible :
[Routing]
KillSwitch = true
KillSwitch accepte true ou false. La valeur true exige au moins une section [OnDemandRule] ; Vylos refuse un fichier qui active le coupe-circuit sans règle d’activation automatique.
Ce réglage ne réécrit pas la configuration WireGuard. Les AllowedIPs combinées de tous les pairs déterminent toujours les destinations disposant d’une route par le VPN. L’app affiche Protection du tunnel complet, Accès réseau restreint ou Aucune route sortante selon les routes effectives, et avertit lorsqu’un serveur DNS se trouve hors de toutes les routes.
Un fichier .conf ordinaire ne peut pas stocker le choix du coupe-circuit. Utilisez .vylos lorsque les réglages À la demande et du coupe-circuit doivent accompagner le tunnel.
Exemple complet
Le fichier settings.conf de l’archive peut combiner les deux familles de fonctions :
[SplitDNS]
Domains = corp.example.com, *.internal.example.com
SearchDomains = example.com
[OnDemandRule]
InterfaceType = cellular
Action = connect
[OnDemandRule]
InterfaceType = wifi
Action = connect
SSIDs = !HomeWifi, !HomeWifi-5G
[Routing]
KillSwitch = true
Cette configuration se connecte sur le réseau cellulaire et sur tous les réseaux Wi-Fi sauf les deux réseaux domestiques nommés. Les noms DNS correspondants des domaines d’entreprise et internes sont acheminés par le tunnel.
Consultez Configurer le DNS scindé et Configurer le VPN à la demande pour comprendre le comportement de ces réglages dans l’app.
Elle bloque également la majeure partie du trafic restant si le tunnel armé devient indisponible.
Importation, exportation et codes QR
Vylos importe directement les fichiers .vylos et peut aussi les inclure dans une archive .zip par lot. Lorsque vous choisissez Configuration complète ou Les deux, l’exportation Vylos produit une archive .vylos par tunnel.
Sous iOS, un code QR peut contenir une archive .vylos encodée en Base64 d’une taille maximale de 16 Ko. Base64 est uniquement un encodage et ne chiffre pas la clé privée contenue dans wireguard.conf.
La limite générale d’importation est de 2 Mo. Les fichiers exportés contiennent des clés privées ; stockez-les et partagez-les donc comme des identifiants sensibles.