Skip to main content

Format de fitxer de Vylos

Utilitzeu el format .vylos per combinar una configuració estàndard de WireGuard amb els ajustos de DNS dividit, Sota demanda i interruptor d’emergència de Vylos. | settings.conf | No | Seccions [SplitDNS], [OnDemandRule] i [Routing] de Vylos en text UTF-8 d’estil INI. |

Estructura de l’arxiu

Un fitxer .vylos és un arxiu ZIP que conté un fitxer obligatori i un d’opcional:

Entrada de l’arxiuObligatòriaContingut
wireguard.confSíSeccions [Interface] i [Peer] de WireGuard sense modificar, com a text UTF-8.
settings.confNoSeccions [SplitDNS] i [OnDemandRule] de Vylos, com a text UTF-8 amb estil INI.

Vylos rebutja els arxius que no contenen wireguard.conf o que inclouen qualsevol de les dues entrades amb una codificació que no sigui UTF-8. Un arxiu sense settings.conf es comporta com la configuració de WireGuard que conté.

L’extensió no modifica la sintaxi de configuració de WireGuard. Pots extreure wireguard.conf i utilitzar-lo amb un altre client compatible amb WireGuard, mentre la configuració específica de Vylos es manté aïllada a settings.conf.

wireguard.conf

L’entrada obligatòria utilitza els mateixos camps de wg-quick que Vylos accepta en una importació .conf normal. És vàlid no incloure cap secció [Peer], i un túnel pot contenir diversos parells.

ini
[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

Substitueix les claus i l’endpoint d’exemple pels valors proporcionats pel servidor WireGuard. Consulta la documentació de wg-quick del projecte WireGuard per conèixer el format de configuració subjacent.

settings.conf

Els noms de les seccions i les claus no distingeixen entre majúscules i minúscules. S’ignoren les línies en blanc i el text posterior a #; les seccions o claus desconegudes, les línies mal formades, les accions no compatibles i els tipus d’interfície no compatibles fan fallar la importació.

DNS dividit

Utilitza una secció [SplitDNS] amb una de les claus compatibles o amb totes dues:

ClauValor
DomainsDominis separats per comes les consultes DNS dels quals utilitzen els servidors DNS del túnel.
SearchDomainsSufixos separats per comes que s’utilitzen per repetir cerques de noms de host sense domini.

Les etiquetes de domini poden contenir lletres, dígits i guionets interiors. Vylos també accepta un comodí inicial opcional com *.example.com i un punt final per als noms complets.

Vylos normalitza els dominis de coincidència del DNS dividit abans d’aplicar-los a la xarxa d’Apple. Les entrades de domini no vàlides s’ignoren en lloc d’afegir-se a la llista de dominis del túnel.

Regles sota demanda

Afegeix una secció [OnDemandRule] per a cada condició de xarxa. Diverses seccions utilitzen una lògica O, de manera que qualsevol regla coincident pot activar el túnel.

ClauObligatòriaValors acceptats
InterfaceTypeSícellular, ethernet o wifi.
ActionNoconnect; si s’omet, també s’utilitza connect per defecte.
SSIDsNoPer a Wi-Fi, una llista d’inclusió separada per comes o una llista on totes les entrades comencen per ! per al mode Excepte. Omet-la per aplicar-la a qualsevol xarxa Wi-Fi.

No barregis SSID inclosos i SSID amb el prefix ! a la mateixa regla. Les regles de dades mòbils s’apliquen a l’iOS, les d’Ethernet al macOS i les de Wi-Fi a totes les plataformes compatibles amb Vylos.

Vylos conserva els valors de regles específics d’altres plataformes quan importa i torna a exportar el túnel. Això permet que un fitxer portable mantingui el comportament previst a l’iOS, el macOS i el visionOS.

Interruptor d’emergència

Afegiu una secció [Routing] per bloquejar la major part del trànsit de xarxa quan un túnel Sota demanda armat no estigui disponible:

ini
[Routing]
KillSwitch = true

KillSwitch accepta true o false. El valor true requereix almenys una secció [OnDemandRule]; Vylos rebutja un fitxer que activi l’interruptor sense una regla d’activació automàtica.

Aquest ajust no reescriu la configuració de WireGuard. Els AllowedIPs combinats de tots els parells continuen determinant les destinacions que tenen una ruta per la VPN. L’app mostra Protecció de túnel complet, Accés restringit a la xarxa o Sense rutes de sortida segons les rutes efectives, i avisa si un servidor DNS queda fora de totes les rutes.

Un fitxer .conf normal no té cap lloc on desar l’interruptor d’emergència. Utilitzeu .vylos quan els ajustos Sota demanda i l’interruptor hagin de viatjar amb el túnel.

Exemple complet

El fitxer settings.conf de l’arxiu pot combinar les dues famílies de funcions:

ini
[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

Aquesta configuració es connecta amb dades mòbils i a totes les xarxes Wi-Fi excepte les dues xarxes domèstiques indicades. Els noms DNS corporatius i interns coincidents s’encaminen pel túnel.

Consulta Configurar el DNS dividit i Configurar la connexió sota demanda per saber com es comporta aquesta configuració a l’app.

També bloqueja la major part del trànsit restant si el túnel armat deixa d’estar disponible.

Importació, exportació i codis QR

Vylos importa fitxers .vylos directament i també els pot incloure dins d’un arxiu .zip per lots. Quan tries Configuració completa o Tots dos, l’exportació de Vylos crea un arxiu .vylos per túnel.

A l’iOS, un codi QR pot contenir un arxiu .vylos codificat en Base64 de fins a 16 KB. Base64 és només una codificació i no xifra la clau privada que conté wireguard.conf.

El límit general d’importació és de 2 MB. Els fitxers exportats contenen claus privades; desa’ls i comparteix-los com a credencials sensibles.