Formato dei file Vylos
Usa il formato .vylos per abbinare una configurazione WireGuard standard alle impostazioni Vylos di Split DNS, Su richiesta e interruttore di emergenza.
| settings.conf | No | Sezioni Vylos [SplitDNS], [OnDemandRule] e [Routing] in testo UTF-8 in stile INI. |
Struttura dell’archivio
Un file .vylos è un archivio ZIP che contiene un file obbligatorio e uno facoltativo:
| Voce dell’archivio | Obbligatoria | Contenuto |
|---|---|---|
wireguard.conf | Sì | Sezioni WireGuard [Interface] e [Peer] non modificate, come testo UTF-8. |
settings.conf | No | Sezioni Vylos [SplitDNS] e [OnDemandRule], come testo UTF-8 in stile INI. |
Vylos rifiuta un archivio senza wireguard.conf o con una delle due voci codificata in un formato diverso da UTF-8. Un archivio privo di settings.conf si comporta come la configurazione WireGuard che contiene.
L’estensione non modifica la sintassi di configurazione WireGuard. Puoi estrarre wireguard.conf e usarlo con un altro client compatibile con WireGuard, mentre le impostazioni specifiche di Vylos restano isolate in settings.conf.
wireguard.conf
La voce obbligatoria usa gli stessi campi wg-quick accettati da Vylos per la normale importazione di un file .conf. Sono valide anche zero sezioni [Peer] e un tunnel può contenere più peer.
[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
Sostituisci le chiavi e l’endpoint di esempio con i valori forniti dal server WireGuard. Consulta la documentazione di wg-quick del progetto WireGuard per il formato di configurazione sottostante.
settings.conf
I nomi di sezioni e chiavi non distinguono tra maiuscole e minuscole. Le righe vuote e il testo dopo # vengono ignorati; sezioni o chiavi sconosciute, righe non valide, azioni non supportate e tipi di interfaccia non supportati fanno invece fallire l’importazione.
DNS suddiviso
Usa una sezione [SplitDNS] con una o entrambe le chiavi supportate:
| Chiave | Valore |
|---|---|
Domains | Domini separati da virgole le cui query DNS usano i server DNS del tunnel. |
SearchDomains | Suffissi separati da virgole usati per riprovare le ricerche di nomi host senza dominio. |
Le etichette dei domini possono contenere lettere, numeri e trattini interni. Vylos accetta anche un carattere jolly iniziale facoltativo, come *.example.com, e un punto finale per i nomi completi.
Vylos normalizza i domini di corrispondenza del DNS suddiviso prima di applicarli alla rete Apple. Le voci di dominio non valide vengono ignorate invece di essere aggiunte all’elenco dei domini del tunnel.
Regole su richiesta
Aggiungi una sezione [OnDemandRule] per ogni condizione di rete. Più sezioni usano una logica OR, quindi qualsiasi regola corrispondente può attivare il tunnel.
| Chiave | Obbligatoria | Valori accettati |
|---|---|---|
InterfaceType | Sì | cellular, ethernet o wifi. |
Action | No | connect; anche un valore omesso usa connect per impostazione predefinita. |
SSIDs | No | Per il Wi-Fi, un elenco di inclusione separato da virgole oppure un elenco in cui ogni voce inizia con ! per la modalità Eccetto. Omettilo per qualsiasi rete Wi-Fi. |
Non mescolare nella stessa regola SSID inclusi e SSID con prefisso !. Le regole cellulari si applicano su iOS, quelle Ethernet su macOS e quelle Wi-Fi su tutte le piattaforme supportate da Vylos.
Vylos conserva i valori delle regole specifici di altre piattaforme quando importa e riesporta il tunnel. In questo modo un file portabile mantiene il comportamento previsto su iOS, macOS e visionOS.
Interruttore di emergenza
Aggiungi una sezione [Routing] per bloccare la maggior parte del traffico di rete quando un tunnel Su richiesta predisposto non è disponibile:
[Routing]
KillSwitch = true
KillSwitch accetta true o false. Il valore true richiede almeno una sezione [OnDemandRule]; Vylos rifiuta un file che attiva l’interruttore senza una regola di attivazione automatica.
Questa impostazione non riscrive la configurazione WireGuard. Gli AllowedIPs combinati di tutti i peer continuano a determinare quali destinazioni hanno un percorso attraverso la VPN. L’app mostra Protezione tunnel completo, Accesso alla rete limitato o Nessun percorso in uscita in base ai percorsi effettivi e avvisa se un server DNS non rientra in nessun percorso.
Un normale file .conf non può memorizzare la scelta dell’interruttore. Usa .vylos quando le impostazioni Su richiesta e dell’interruttore devono accompagnare il tunnel.
Esempio completo
Il file settings.conf dell’archivio può combinare entrambe le famiglie di funzioni:
[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
Questa configurazione si connette su rete cellulare e su ogni rete Wi-Fi tranne le due reti domestiche indicate. I nomi DNS aziendali e interni corrispondenti vengono instradati nel tunnel.
Consulta Configurare il DNS suddiviso e Configurare la VPN su richiesta per sapere come si comportano queste impostazioni nell’app.
Blocca inoltre la maggior parte del traffico rimanente se il tunnel predisposto non è disponibile.
Importazione, esportazione e codici QR
Vylos importa direttamente i file .vylos e può includerli in un archivio .zip in batch. Quando scegli Configurazione completa o Entrambi, l’esportazione Vylos produce un archivio .vylos per ogni tunnel.
Su iOS, un codice QR può contenere un archivio .vylos codificato in Base64 fino a 16 KB. Base64 è solo una codifica e non cifra la chiave privata contenuta in wireguard.conf.
Il limite generale per l’importazione è di 2 MB. I file esportati contengono chiavi private, quindi conservali e condividili come credenziali sensibili.