Das Vylos-Dateiformat

Verwenden Sie das .vylos-Format, um eine Standard-WireGuard-Konfiguration zusammen mit den Vylos-Einstellungen für Split-DNS, On-Demand und den Notausschalter zu transportieren. | settings.conf | Nein | Vylos-Abschnitte [SplitDNS], [OnDemandRule] und [Routing] als INI-ähnlicher UTF-8-Text. |

Archivstruktur

Eine .vylos-Datei ist ein ZIP-Archiv mit einer erforderlichen und einer optionalen Datei:

Vylos lehnt ein Archiv ohne wireguard.conf sowie Einträge ab, die nicht als UTF-8-Text kodiert sind. Ein Archiv ohne settings.conf verhält sich wie die darin enthaltene WireGuard-Konfiguration.

Die Dateiendung verändert die WireGuard-Konfigurationssyntax nicht. Sie können wireguard.conf entpacken und mit einem anderen WireGuard-kompatiblen Client verwenden. Vylos-spezifische Einstellungen bleiben getrennt in settings.conf.

wireguard.conf

Der erforderliche Eintrag verwendet dieselben wg-quick-Felder, die Vylos beim normalen Import einer .conf-Datei akzeptiert. Null [Peer]-Abschnitte sind gültig; ein Tunnel kann auch mehrere Peers enthalten.

[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

Ersetzen Sie die Beispielschlüssel und den Endpunkt durch die Werte Ihres WireGuard-Servers. Das zugrunde liegende Konfigurationsformat ist in der wg-quick-Dokumentation des WireGuard-Projekts beschrieben.

settings.conf

Bei Abschnitts- und Schlüsselnamen wird nicht zwischen Groß- und Kleinschreibung unterschieden. Leerzeilen und Text nach # werden ignoriert. Unbekannte Abschnitte oder Schlüssel, fehlerhafte Zeilen sowie nicht unterstützte Aktionen oder Schnittstellentypen führen dagegen dazu, dass der Import fehlschlägt.

Split-DNS

Verwenden Sie einen [SplitDNS]-Abschnitt mit einem oder beiden unterstützten Schlüsseln:

Domainbezeichnungen dürfen Buchstaben, Ziffern und Bindestriche innerhalb der Bezeichnung enthalten. Vylos akzeptiert außerdem einen optionalen führenden Platzhalter wie *.example.com und einen abschließenden Punkt für vollständig qualifizierte Namen.

Vylos normalisiert Split-DNS-Match-Domains, bevor sie auf das Apple-Netzwerk angewendet werden. Ungültige Domaineinträge werden ignoriert und nicht zur Domainliste des Tunnels hinzugefügt.

On-Demand-Regeln

Fügen Sie für jede Netzwerkbedingung einen [OnDemandRule]-Abschnitt hinzu. Mehrere Abschnitte werden mit ODER verknüpft; jede passende Regel kann den Tunnel aktivieren.

Mischen Sie in einer Regel keine eingeschlossenen SSIDs mit SSIDs, denen ! vorangestellt ist. Mobilfunkregeln gelten unter iOS, Ethernet-Regeln unter macOS und WLAN-Regeln auf allen von Vylos unterstützten Plattformen.

Vylos behält plattformspezifische Regelwerte, die auf dem aktuellen Gerät nicht unterstützt werden, beim Import und erneuten Export bei. So kann eine portable Datei ihr vorgesehenes Verhalten unter iOS, macOS und visionOS bewahren.

Notausschalter

Fügen Sie einen Abschnitt [Routing] hinzu, um den meisten Netzwerkverkehr zu blockieren, wenn ein aktivierter On-Demand-Tunnel nicht verfügbar ist:

[Routing]
KillSwitch = true

KillSwitch akzeptiert true oder false. Der Wert true erfordert mindestens einen Abschnitt [OnDemandRule]; Vylos lehnt eine Datei ab, die den Notausschalter ohne automatische Aktivierungsregel einschaltet.

Diese Einstellung verändert die WireGuard-Konfiguration nicht. Die kombinierten AllowedIPs aller Peers bestimmen weiterhin, welche Ziele eine Route durch das VPN haben. Die App zeigt je nach effektiven Routen Vollständiger Tunnelschutz, Eingeschränkter Netzwerkzugriff oder Keine ausgehenden Routen an und warnt, wenn ein DNS-Server außerhalb aller Routen liegt.

Eine gewöhnliche .conf-Datei kann die Notausschalter-Auswahl nicht speichern. Verwenden Sie .vylos, wenn On-Demand- und Notausschalter-Einstellungen zusammen mit dem Tunnel übertragen werden sollen.

Vollständiges Beispiel

Die settings.conf des Archivs kann beide Funktionsbereiche kombinieren:

[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

Diese Konfiguration verbindet über Mobilfunk sowie über jedes WLAN außer den beiden genannten Heimnetzwerken. DNS-Namen der angegebenen Unternehmens- und internen Domains werden durch den Tunnel geleitet.

Unter Split-DNS einrichten und On-Demand einrichten erfahren Sie, wie sich diese Einstellungen in der App verhalten.

Außerdem blockiert sie den meisten übrigen Datenverkehr, wenn der aktivierte Tunnel nicht verfügbar ist.

Import, Export und QR-Codes

Vylos importiert .vylos-Dateien direkt und kann sie auch aus einem .zip-Stapelarchiv einlesen. Beim Export erstellt Vylos für jeden Tunnel ein .vylos-Archiv, wenn Sie Vollständige Konfiguration oder Beides wählen.

Unter iOS kann ein QR-Code ein Base64-kodiertes .vylos-Archiv mit einer Größe von bis zu 16 KB enthalten. Base64 ist lediglich eine Kodierung und verschlüsselt den in wireguard.conf enthaltenen privaten Schlüssel nicht.

Für allgemeine Dateiimporte gilt eine Obergrenze von 2 MB. Exportierte Dateien enthalten private Schlüssel und müssen daher wie vertrauliche Zugangsdaten gespeichert und weitergegeben werden.