Формат файла Vylos
Формат .vylos переносит стандартную конфигурацию WireGuard вместе с параметрами Vylos для раздельной DNS, подключения по запросу и аварийного выключателя.
| settings.conf | Нет | Разделы Vylos [SplitDNS], [OnDemandRule] и [Routing] в виде текста UTF-8 в стиле INI. |
Структура архива
Файл .vylos представляет собой ZIP-архив с одним обязательным и одним необязательным файлом:
| Элемент архива | Обязателен | Содержимое |
|---|---|---|
wireguard.conf | Да | Неизменённые разделы WireGuard [Interface] и [Peer] в виде текста UTF-8. |
settings.conf | Нет | Разделы Vylos [SplitDNS] и [OnDemandRule] в виде INI-подобного текста UTF-8. |
Vylos отклонит архив, если в нём нет wireguard.conf или если какой-либо элемент не является текстом UTF-8. Архив без settings.conf работает так же, как содержащаяся в нём конфигурация WireGuard.
Расширение файла не меняет синтаксис WireGuard. Файл wireguard.conf можно извлечь и использовать в другом совместимом клиенте WireGuard, а настройки Vylos останутся отдельно в settings.conf.
wireguard.conf
Обязательный элемент использует те же поля wg-quick, которые Vylos принимает при обычном импорте .conf. Конфигурация без разделов [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
Замените примерные ключи и конечную точку значениями от вашего сервера WireGuard. Базовый формат описан в документации wg-quick проекта WireGuard.
settings.conf
Регистр имён разделов и ключей не учитывается. Пустые строки и текст после # игнорируются. Неизвестный раздел или ключ, неверно оформленная строка, неподдерживаемое действие или тип интерфейса приводят к ошибке импорта.
Раздельный DNS
Добавьте один раздел [SplitDNS] и один или оба ключа:
| Ключ | Значение |
|---|---|
Domains | Домены через запятую, DNS-запросы которых используют DNS-серверы туннеля. |
SearchDomains | Суффиксы через запятую для повторных запросов имени узла без доменной части. |
Метки домена могут содержать буквы, цифры и дефисы внутри метки. Vylos также принимает необязательный начальный шаблон, например *.example.com, и конечную точку для полного доменного имени.
Перед применением к сети Apple Vylos нормализует домены раздельного DNS. Недопустимые записи игнорируются и не добавляются в список доменов туннеля.
Правила по требованию
Добавьте раздел [OnDemandRule] для каждого сетевого условия. Несколько разделов работают по логике «или», поэтому любое совпавшее правило может включить туннель.
| Ключ | Обязателен | Допустимые значения |
|---|---|---|
InterfaceType | Да | cellular, ethernet или wifi. |
Action | Нет | connect; при отсутствии также используется connect. |
SSIDs | Нет | Для Wi-Fi: список включения через запятую или список исключения, где каждый элемент начинается с !. При отсутствии совпадают все сети Wi-Fi. |
Не смешивайте обычные SSID и SSID с ! в одном правиле. Сотовые правила применяются в iOS, Ethernet — в macOS, а Wi-Fi — на всех поддерживаемых Vylos платформах.
При импорте и повторном экспорте Vylos сохраняет значения правил, не поддерживаемые текущей платформой. Поэтому один переносимый файл может содержать нужное поведение для iOS, macOS и visionOS.
Аварийный выключатель
Добавьте раздел [Routing], чтобы блокировать большую часть сетевого трафика, когда активированный туннель по запросу недоступен:
[Routing]
KillSwitch = true
KillSwitch принимает true или false. Значение true требует хотя бы одного раздела [OnDemandRule]; Vylos отклоняет файл, который включает аварийный выключатель без правила автоматической активации.
Этот параметр не изменяет конфигурацию WireGuard. Совокупные AllowedIPs всех пиров по-прежнему определяют адреса, имеющие маршрут через VPN. Приложение показывает Полная защита туннеля, Ограниченный доступ к сети или Нет исходящих маршрутов в зависимости от фактических маршрутов и предупреждает, если DNS-сервер не входит ни в один маршрут.
Обычный файл .conf не может хранить выбор аварийного выключателя. Используйте .vylos, если параметры подключения по запросу и выключателя должны переноситься вместе с туннелем.
Полный пример
Файл settings.conf в архиве может содержать оба типа функций:
[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
Эта конфигурация подключает туннель в сотовой сети и во всех сетях Wi-Fi, кроме двух указанных домашних сетей. Совпавшие корпоративные и внутренние имена DNS направляются через туннель.
Поведение настроек в приложении описано в разделах Настройка раздельного DNS и Подключения по требованию.
Она также блокирует большую часть остального трафика, если активированный туннель станет недоступен.
Импорт, экспорт и QR-коды
Vylos может импортировать файлы .vylos напрямую или из группового архива .zip. При выборе Полная конфигурация или Оба варианта Vylos экспортирует каждый туннель как архив .vylos.
В iOS QR-код может содержать архив .vylos размером до 16 КБ, закодированный в Base64. Base64 — только кодирование; оно не шифрует закрытый ключ в wireguard.conf.
Обычный импорт файла ограничен 2 МБ. Экспортированные файлы содержат закрытые ключи, поэтому храните и передавайте их как конфиденциальные учётные данные.