Format pliku Vylos
Format .vylos przenosi standardową konfigurację WireGuard razem z ustawieniami Vylos dotyczącymi podzielonego DNS, reguł Na żądanie i wyłącznika awaryjnego.
| settings.conf | Nie | Sekcje Vylos [SplitDNS], [OnDemandRule] i [Routing] w tekście UTF-8 w stylu INI. |
Struktura archiwum
Plik .vylos jest archiwum ZIP zawierającym jeden plik wymagany i jeden opcjonalny:
| Element archiwum | Wymagany | Zawartość |
|---|---|---|
wireguard.conf | Tak | Niezmienione sekcje WireGuard [Interface] i [Peer] zapisane jako tekst UTF-8. |
settings.conf | Nie | Sekcje Vylos [SplitDNS] i [OnDemandRule] w tekście UTF-8 o składni podobnej do INI. |
Vylos odrzuci archiwum bez pliku wireguard.conf lub takie, w którym którykolwiek element nie jest tekstem UTF-8. Archiwum bez settings.conf zachowuje się tak samo jak zawarta w nim konfiguracja WireGuard.
Rozszerzenie pliku nie zmienia składni WireGuard. Możesz wypakować wireguard.conf i użyć go w innym zgodnym kliencie WireGuard, podczas gdy ustawienia specyficzne dla Vylos pozostaną oddzielnie w settings.conf.
wireguard.conf
Wymagany element używa tych samych pól wg-quick, które Vylos przyjmuje przy zwykłym imporcie .conf. Konfiguracja bez sekcji [Peer] jest prawidłowa, a jeden tunel może zawierać wielu peerów.
[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
Zastąp przykładowe klucze i punkt końcowy wartościami otrzymanymi od serwera WireGuard. Podstawowy format opisuje dokumentacja wg-quick projektu WireGuard.
settings.conf
W nazwach sekcji i kluczy wielkość liter nie ma znaczenia. Puste wiersze i tekst po znaku # są ignorowane. Nieznana sekcja lub klucz, błędnie sformatowany wiersz, nieobsługiwana czynność albo typ interfejsu spowodują niepowodzenie importu.
Podzielony DNS
Dodaj jedną sekcję [SplitDNS] i jeden lub oba poniższe klucze:
| Klucz | Wartość |
|---|---|
Domains | Lista domen rozdzielonych przecinkami, których zapytania DNS używają serwerów DNS tunelu. |
SearchDomains | Lista przyrostków rozdzielonych przecinkami, używanych przy ponawianiu zapytań o nazwę hosta bez domeny. |
Etykiety domen mogą zawierać litery, cyfry i łączniki wewnątrz etykiety. Vylos akceptuje również opcjonalny początkowy symbol wieloznaczny, na przykład *.example.com, oraz końcową kropkę oznaczającą pełną nazwę domeny.
Przed zastosowaniem domen podzielonego DNS do sieci Apple Vylos je normalizuje. Nieprawidłowe wpisy są pomijane i nie trafiają na listę domen tunelu.
Reguły na żądanie
Dodaj sekcję [OnDemandRule] dla każdego warunku sieciowego. Wiele sekcji korzysta z logiki „lub”, więc dowolna pasująca reguła może uruchomić tunel.
| Klucz | Wymagany | Dozwolone wartości |
|---|---|---|
InterfaceType | Tak | cellular, ethernet lub wifi. |
Action | Nie | connect; po pominięciu również domyślnie używane jest connect. |
SSIDs | Nie | Dla Wi-Fi: lista włączająca rozdzielona przecinkami albo lista wykluczająca, w której każdy element zaczyna się od !. Pominięcie oznacza wszystkie sieci Wi-Fi. |
Nie łącz zwykłych identyfikatorów SSID z identyfikatorami zaczynającymi się od ! w jednej regule. Reguły komórkowe dotyczą iOS, ethernetowe macOS, a Wi-Fi wszystkich platform obsługiwanych przez Vylos.
Podczas importu i ponownego eksportu Vylos zachowuje wartości reguł nieobsługiwane przez bieżącą platformę. Jeden przenośny plik może więc przechowywać zamierzone zachowanie dla iOS, macOS i visionOS.
Wyłącznik awaryjny
Dodaj sekcję [Routing], aby blokować większość ruchu sieciowego, gdy uzbrojony tunel Na żądanie jest niedostępny:
[Routing]
KillSwitch = true
KillSwitch przyjmuje true lub false. Wartość true wymaga co najmniej jednej sekcji [OnDemandRule]; Vylos odrzuca plik, który włącza wyłącznik bez reguły automatycznej aktywacji.
To ustawienie nie zmienia konfiguracji WireGuard. Połączone AllowedIPs wszystkich peerów nadal określają, które cele mają trasę przez VPN. Aplikacja pokazuje Pełna ochrona tunelu, Ograniczony dostęp do sieci albo Brak tras wychodzących zależnie od efektywnych tras i ostrzega, gdy serwer DNS nie należy do żadnej z nich.
Zwykły plik .conf nie ma miejsca na wybór wyłącznika awaryjnego. Użyj .vylos, gdy ustawienia Na żądanie i wyłącznika mają być przenoszone wraz z tunelem.
Pełny przykład
Plik settings.conf w archiwum może zawierać oba rodzaje funkcji:
[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
Ta konfiguracja łączy tunel w sieci komórkowej oraz we wszystkich sieciach Wi-Fi poza dwiema wskazanymi sieciami domowymi. Pasujące firmowe i wewnętrzne nazwy DNS są kierowane przez tunel.
Zachowanie tych ustawień w aplikacji opisują strony Konfiguracja podzielonego DNS i Połączenia na żądanie.
Blokuje także większość pozostałego ruchu, jeśli uzbrojony tunel stanie się niedostępny.
Import, eksport i kody QR
Vylos może importować pliki .vylos bezpośrednio lub z grupowego archiwum .zip. Po wybraniu Pełna konfiguracja albo Oba Vylos eksportuje każdy tunel jako archiwum .vylos.
W iOS kod QR może zawierać archiwum .vylos zakodowane w Base64 o rozmiarze do 16 KB. Base64 jest tylko kodowaniem i nie szyfruje klucza prywatnego w wireguard.conf.
Limit zwykłego importu pliku wynosi 2 MB. Eksportowane pliki zawierają klucze prywatne, dlatego należy je przechowywać i udostępniać jak poufne dane uwierzytelniające.