Skip to main content

Formatul de fișier Vylos

Utilizați formatul .vylos pentru a transporta o configurație WireGuard standard împreună cu setările Vylos pentru DNS separat, La cerere și comutatorul de urgență. | settings.conf | Nu | Secțiunile Vylos [SplitDNS], [OnDemandRule] și [Routing] ca text UTF-8 în stil INI. |

Structura arhivei

Un fișier .vylos este o arhivă ZIP care conține un fișier obligatoriu și unul opțional:

Element al arhiveiObligatoriuConținut
wireguard.confDaSecțiunile WireGuard [Interface] și [Peer] nemodificate, în text UTF-8.
settings.confNuSecțiunile Vylos [SplitDNS] și [OnDemandRule], în text UTF-8 asemănător INI.

Vylos respinge arhiva dacă lipsește wireguard.conf sau dacă oricare element nu este text UTF-8. O arhivă fără settings.conf se comportă la fel ca configurația WireGuard pe care o conține.

Extensia fișierului nu schimbă sintaxa WireGuard. Puteți extrage wireguard.conf și îl puteți folosi într-un alt client compatibil WireGuard, în timp ce configurările specifice Vylos rămân separat în settings.conf.

wireguard.conf

Elementul obligatoriu folosește aceleași câmpuri wg-quick pe care Vylos le acceptă la un import .conf obișnuit. Este valid și fără nicio secțiune [Peer], iar un singur tunel poate conține mai mulți peeri.

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

Înlocuiți cheile și endpoint-ul din exemplu cu valorile furnizate de serverul WireGuard. Pentru formatul de bază, consultați documentația wg-quick a proiectului WireGuard.

settings.conf

Numele secțiunilor și cheilor nu țin cont de majuscule. Liniile goale și textul de după # sunt ignorate. O secțiune sau cheie necunoscută, o linie formatată incorect, o acțiune ori un tip de interfață neacceptat determină eșecul importului.

DNS separat

Adăugați o singură secțiune [SplitDNS] și una sau ambele chei:

CheieValoare
DomainsDomenii separate prin virgule ale căror interogări DNS folosesc serverele DNS ale tunelului.
SearchDomainsSufixe separate prin virgule folosite la repetarea interogărilor pentru nume de gazdă fără domeniu.

Etichetele de domeniu pot conține litere, cifre și cratime în interior. Vylos acceptă și un wildcard inițial opțional, precum *.example.com, și un punct final pentru un nume complet calificat.

Vylos normalizează domeniile DNS separat înainte de a le aplica rețelei Apple. Intrările nevalide sunt ignorate și nu ajung în lista domeniilor tunelului.

Reguli la cerere

Adăugați câte o secțiune [OnDemandRule] pentru fiecare condiție de rețea. Mai multe secțiuni folosesc logica „sau”, astfel încât orice regulă corespunzătoare poate activa tunelul.

CheieObligatorieValori acceptate
InterfaceTypeDacellular, ethernet sau wifi.
ActionNuconnect; dacă este omisă, valoarea implicită este tot connect.
SSIDsNuPentru Wi-Fi, o listă de includere separată prin virgule sau o listă de excludere în care fiecare element începe cu !. Dacă lipsește, corespunde tuturor rețelelor.

Nu combinați SSID-uri obișnuite cu SSID-uri care încep cu ! în aceeași regulă. Regulile celulare se aplică pe iOS, cele Ethernet pe macOS, iar cele Wi-Fi pe toate platformele acceptate de Vylos.

Vylos păstrează valorile regulilor neacceptate de platforma curentă atunci când importă și reexportă un tunel. Un singur fișier portabil poate astfel păstra comportamentul dorit pentru iOS, macOS și visionOS.

Comutator de urgență

Adăugați o secțiune [Routing] pentru a bloca majoritatea traficului de rețea atunci când un tunel La cerere armat nu este disponibil:

ini
[Routing]
KillSwitch = true

KillSwitch acceptă true sau false. Valoarea true necesită cel puțin o secțiune [OnDemandRule]; Vylos respinge un fișier care activează comutatorul fără o regulă de activare automată.

Setarea nu rescrie configurația WireGuard. AllowedIPs combinate ale tuturor partenerilor stabilesc în continuare ce destinații au o rută prin VPN. Aplicația afișează Protecție completă prin tunel, Acces restricționat la rețea sau Nicio rută de ieșire în funcție de rutele efective și avertizează dacă un server DNS nu se află în nicio rută.

Un fișier .conf obișnuit nu poate stoca alegerea comutatorului. Utilizați .vylos când setările La cerere și ale comutatorului trebuie să însoțească tunelul.

Exemplu complet

Fișierul settings.conf din arhivă poate conține ambele tipuri de funcții:

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

Această configurație conectează tunelul în rețeaua celulară și în toate rețelele Wi-Fi, cu excepția celor două rețele de acasă indicate. Numele DNS corporative și interne corespunzătoare sunt direcționate prin tunel.

Consultați Configurarea DNS separat și Configurarea conexiunilor la cerere pentru comportamentul acestor opțiuni în aplicație.

De asemenea, blochează majoritatea traficului rămas dacă tunelul armat devine indisponibil.

Import, export și coduri QR

Vylos poate importa fișiere .vylos direct sau dintr-o arhivă .zip în lot. Când selectați Configurație completă sau Ambele, Vylos exportă fiecare tunel ca arhivă .vylos.

Pe iOS, un cod QR poate conține o arhivă .vylos codificată Base64 de cel mult 16 KB. Base64 este doar o codificare și nu criptează cheia privată din wireguard.conf.

Limita obișnuită pentru importul unui fișier este 2 MB. Fișierele exportate conțin chei private, așadar păstrați-le și distribuiți-le ca date de autentificare sensibile.