Skip to content

Latest commit

 

History

History
393 lines (304 loc) · 60.9 KB

COMPATIBILITY.md

File metadata and controls

393 lines (304 loc) · 60.9 KB

Матрица совместимости (v0.4)

Обозначения: ✅ реализовано и проверено на платформе · 🧪 реализовано, ручная проверка на этой платформе ещё не завершена · 🗓 запланировано · ❌ невозможно / не поддерживается

Реальные подключения мейнтейнер проверяет вручную по руководству по ручному тестированию. Сопровождающий подтвердил ручную проверку сценариев Windows, отмеченных ✅, включая реальные подключения. Ограничения по архитектуре, драйверам и режимам указаны в строках матрицы. В таблицах без столбцов по платформам отметка 🧪 означает, что ручная проверка ещё не завершена. Mock-режим работает везде, где запускается интерфейс. В v0.4.0 выходят только десктопные сборки. Приложение для Android остаётся в планах.

Протоколы

Регистрация ссылок vless://, vmess://, trojan://, ss://, hy2://, hysteria2://, tuic:// и «Открыть с помощью» для .conf / .ovpn: Windows — ✅, Linux и macOS — 🧪. Везде требуется явное нажатие в настройках; чужие обработчики схем не заменяются, приложения для файлов по умолчанию сохраняются. Запрос передаётся работающему экземпляру и открывает предпросмотр без автоимпорта. Linux требует xdg-utils и desktop-file-utils; macOS создаёт пользовательский .app-обработчик. Подробности и ограничения MIME Linux — в руководстве по импорту.

Все столбцы macOS ниже относятся только к Apple Silicon (osx-arm64). Поддержка Intel прекращена: новые сборки и обновления для Intel Mac не выпускаются.

Протокол Движок Windows Linux macOS Android
VLESS (TCP/WS/gRPC/HTTPUpgrade, TLS, REALITY, Vision) sing-box ✅ 🧪 🧪 🗓
VLESS XHTTP Xray-core ✅ 🧪 🧪 🗓
VMess sing-box / Xray ✅ 🧪 🧪 🗓
Trojan sing-box / Xray ✅ 🧪 🧪 🗓
Shadowsocks (включая шифры 2022, плагины SIP003 через sing-box) sing-box / Xray ✅ 🧪 🧪 🗓
Hysteria 2 (obfs, смена портов) sing-box ✅ 🧪 🧪 🗓
TUIC v5 sing-box ✅ 🧪 🧪 🗓
AnyTLS, ShadowTLS (Shadowsocks через detour), SSH sing-box ✅ 🧪 🧪 🗓
NaiveProxy sing-box ✅ 🧪 🧪 🗓
SOCKS5 / HTTP(S) sing-box / Xray ✅ 🧪 🧪 🗓
WireGuard (в пространстве пользователя) endpoint sing-box ✅ 🧪 🧪 🗓
WireGuard (нативный туннель) wireguard.exe / wg-quick ✅ 🧪 🧪 🗓
AmneziaWG встроенный amneziawg-go 3.1.20260828 ✅ Wintun 🧪 userspace TUN 🧪 utun 🗓
OpenVPN openvpn ✅ 🧪 🧪 🗓
Cloudflare WARP регистрация в приложении (кнопка) + импорт профиля WireGuard ✅ 🧪 🧪 🗓

Для NaiveProxy на Windows и Linux используйте совместимую сборку sing-box с библиотекой libcronet рядом с исполняемым файлом; сторонняя сборка может не включать этот outbound. ShadowTLS импортируется как ссылка shadowtls:// с параметрами version, method и ss_password; пароль ShadowTLS передаётся в userinfo.

Режимы и инструменты

Функция Windows Linux macOS Android
Локальный прокси (SOCKS5 + HTTP; по умолчанию только 127.0.0.1, опция «Доступ из LAN» — на всех интерфейсах, только с логином и паролем, не сочетается с системным прокси) ✅ 🧪 🧪 🗓
Режим TUN (sing-box, нужны права администратора/root) ✅ 🧪 🧪 🗓 (VpnService)
Kill switch TUN (sing-box; отдельный TUN-процесс, без постоянных правил фаервола) ✅ 🧪 🧪 🗓
Системный прокси на время подключения ✅ 🧪 GNOME/KDE 🧪 ❌
Zapret ✅ x64: winws + WinDivert; ARM64 ❌ 🧪 x64/ARM64: nfqws + nftables 🧪 только Apple Silicon: tpws + PF, IPv4 TCP 80/443 🗓 отдельная задача #21
TgWsProxy (встроенный порт на C#, без Python) ✅ 🧪 🧪 🗓
Трей и меню сессий ✅ Avalonia TrayIcon 🧪 нужен StatusNotifierItem/AppIndicator 🧪 меню строки состояния ❌
Автозапуск при входе (по выбору) ✅ HKCU Run 🧪 XDG autostart 🧪 LaunchAgent ❌
Системные уведомления (отключаемые) ✅ Shell balloon 🧪 notify-send + демон уведомлений 🧪 osascript, разрешение ОС ❌
Статистика трафика в реальном времени sing-box ✅ (Clash API), TgWsProxy ✅ (встроенные счётчики), Xray-core 🧪 (gRPC StatsService), остальные 🗓 так же так же 🗓

Группы серверов

Режим sing-box Xray-core Остальные движки
Вручную 🧪 selector 🧪 balancer, явная цель ❌
По задержке 🧪 urltest, допуск задержки 🧪 leastPing + observatory, допуск через Routing API ❌
При сбое 🧪 selector, проверки через Clash API 🧪 balancer + observatory, переключение через Routing API ❌

На главной раскройте «Дополнительно», создайте группу и включите «Подключаться через группу серверов». Источник — ручной набор профилей или подписка: её состав определяется заново при подключении после обновления. Выберите движок, режим, начальный сервер, HTTP/HTTPS URL проверки, интервал 10–86400 секунд и допуск 0–65535 мс. Режим «При сбое» сохраняет живой сервер независимо от задержки остальных; «По задержке» меняет сервер только при улучшении сверх допуска. Для изменения ручного выбора отредактируйте группу и подключитесь заново. Изменения группы применяются при следующем подключении.

Главная показывает имя группы и сервер, подтверждённый API ядра. При отсутствии подтверждения выводится ожидание; при отказе всей группы трафик группы не переключается на прямое подключение. Явные правила прямого доступа сохраняются. Clash API доступен только на loopback с отдельным случайным Bearer-секретом; Xray gRPC API — только на loopback. У Xray допуск задержки и режим «При сбое» применяет контроллер BYDLO, используя результаты штатного observatory. Новые соединения используют выбранный сервер; существующие могут завершаться через прежний.

Поддерживаются только совместимые с выбранным ядром профили. Пользовательские JSON и ShadowTLS в группы пока не включаются; для WireGuard используется endpoint sing-box. Xray работает как локальный прокси, а в режиме TUN с kill switch — за TUN-фронтом sing-box. Если в подписке есть неподдерживаемый профиль или из ручной группы удалён сервер, исправьте состав группы перед подключением. Реальная сеть не проверялась автоматически: отметка 🧪 сохраняется на Windows, Linux и macOS.

Маршрутизация

Правило sing-box Xray-core
Прямые домены / CIDR, блокировки, приватные сети, mesh-диапазоны 🧪 🧪
Домены через туннель (ProxyDomains) 🧪 🧪
Режим «только выбранные домены» (ProxyOnlyListed) 🧪 (final: direct) 🧪 (catch-all network: tcp,udp → direct; проверка соединения всегда через прокси)
Приложения напрямую (DirectProcesses) 🧪 (только TUN) 🧪 (только Windows/Linux, по полю process Xray)
Режим TUN 🧪 🧪 (через TUN-фронт sing-box, нужен kill switch)

Права администратора

В «Настройки → Дополнительно» доступна необязательная привилегированная служба: Windows service, systemd на Linux и launchd на macOS. UI остаётся без повышенных прав, служба запускает комплектные TUN sing-box, Zapret, AmneziaWG и OpenVPN. Windows ✅ проверена сопровождающим. Ручная проверка Linux и macOS ещё не завершена (🧪). Пользовательские конфиги, плагины, цепочки и внешние наборы правил через службу не поддерживаются; OpenVPN принимает ограниченное безопасное подмножество директив и требует отдельно установленный DCO-драйвер на Windows. Нативный WireGuard через wg-quick/wireguard.exe остаётся в прежнем режиме повышения.

Без службы сохраняется прежнее поведение: кнопка «Перезапустить от администратора» на Windows (asInvoker до явного повышения), запуск с root на Linux/macOS. Установка и удаление службы требуют отдельного системного подтверждения администратора; в Mock Mode и при блокировке разработки эти действия запрещены.

На macOS нативные TCP-профили tpws автоматически используют базовые домены и общий встроенный список engines/bydlo-zapret-list.txt без дубликатов. Абсолютные пути делают список доступным независимо от рабочего каталога tpws; отдельные пользовательские списки и исключения сохраняются. Поддержка остаётся экспериментальной: IPv4 TCP 80/443, без QUIC; реальную сеть проверяет сопровождающий.

Импорт

Источник Статус
vless://, vmess://, trojan://, ss://, hysteria2:// / hy2://, tuic://, socks5://, http(s)://, wireguard:// ✅ (покрыто тестами)
anytls://, shadowtls://, naive+https://, naive+quic://, ssh:// ✅ (покрыто тестами)
Подписки в base64 и открытым текстом ✅
.conf WireGuard / AmneziaWG, .ovpn OpenVPN ✅; OpenVPN принимает ограниченное безопасное подмножество клиентских директив со встроенными сертификатами и ключами
QR-код из файла изображения ✅ (ZXing)
QR-код с камеры 🗓
Clash/Mihomo YAML (proxies) ✅; отдельные профили, без импорта групп
JSON-конфигурации sing-box / Xray 🧪; поддерживаемое подмножество встроенных настроек, слушатели задаёт BYDLO; внешние файлы и сторонний API отклоняются

Hysteria2: ссылки с port hopping принимают списки портов и диапазонов, в том числе без пароля и с IPv6. В Clash/Mihomo поле ports задаёт список вместо port. При генерации sing-box все выбранные порты попадают в server_ports как диапазоны начало:конец; одиночный порт — 8443:8443. Импорт, генерация и экспорт с повторным импортом покрыты изолированными тестами; проверку sing-box check и реального подключения выполняет сопровождающий.

Экспорт и передача сервера

Формат Статус
Ссылки и QR: VLESS, VMess, Trojan, Shadowsocks (SIP002), Hysteria2, TUIC, SOCKS5, HTTP(S) ✅; параметры и секреты проверены циклом импорт → экспорт → импорт
Ссылки и QR: AnyTLS, ShadowTLS, NaiveProxy, SSH ✅; ручное добавление через мастер пока недоступно
WireGuard / AmneziaWG .conf, OpenVPN .ovpn ✅; экспорт сохранённой конфигурации с ключами и встроенными сертификатами

Перед показом QR, копированием ссылки и записью файла требуется подтверждение предупреждения о данных доступа. Файлы экспортируются без шифрования. Внешние файлы, на которые ссылается конфигурация, передаются отдельно. Для слишком длинной ссылки, не помещающейся в QR, доступно копирование ссылки.

Получение движков

Ниже описан состав полного комплекта для каждой целевой платформы. CI на GitHub собирает все пять RID, зеркало на Gitea — только linux-x64 (см. BUILD.md). Наличие адаптера или упаковщика не подтверждает реальное подключение.

Движок Как BYDLO его получает
sing-box 1.14.4, Xray-core 26.10.31 Упаковываются для всех пяти десктопных платформ с проверкой SHA-256. Загрузка по запросу остаётся запасным путём.
Zapret: Flowseal 1.10.3 / bol-van 72.13 Встроен в релизы Windows x64, Linux x64/ARM64 и macOS, только Apple Silicon; CI проверяет SHA-256. Загрузка по запросу и папка пользователя — резервные варианты.
tg-ws-proxy 1.11.4 Ничего не скачивается: ядро перенесено на C# и встроено в BYDLO. Без HTTP/2 для медиа через Cloudflare (cf_h2), без Cloudflare Worker и PROXY protocol
AmneziaWG 3.1.20260828 Windows x64/ARM64 и Linux x64/ARM64: собственный процесс-хост upstream Go-библиотеки, без официального клиента и awg-quick. Windows: встроен подписанный Wintun 0.14.1. macOS Apple Silicon использует utun.
OpenVPN 2.7.9 Все пять платформ: консольный движок. Windows: DLL и подписанный DCO 2.8.14 извлечены из закреплённого официального MSI; установка DCO и выделенного адаптера — отдельная команда с согласием и правами администратора. Linux/macOS: сборка со статическим OpenSSL 3.6.5; Linux также со статическим libcap-ng 0.9.6.
Нативный WireGuard Официальный клиент, установленный пользователем; для userspace WireGuard доступен встроенный sing-box.

В Xray-core 26.10.31 MPTCP выключен по умолчанию: это исправление upstream снижает риск, связанный с уязвимостью ядра Linux. Генерируемые BYDLO слушатели SOCKS/HTTP не включают MPTCP. Проверка архивов, сборка и изолированные тесты не подтверждают реальное подключение; его проверяет мейнтейнер вручную.

В sing-box 1.14.4 исправлены удержание закрытых TCP-сессий и TUN flow table, цикл соединений на Windows, VLESS Vision и WireGuard на Darwin и Windows ARM64. Группы selector и urltest теперь отклоняют повторяющиеся теги участников, а нереализованное действие правила direct удалено. BYDLO не использует ни то, ни другое: трафик направляется через outbound, а импорт пользовательского JSON отклоняет дубликаты участников до сохранения профиля. Возможности upstream GUI, Android и серверных сборок (например, tailscale, usbip, snell, openvpn-сервер) BYDLO не заявляет.

Для AmneziaWG нужны права администратора/root; Linux использует /dev/net/tun, ip и, при DNS в профиле, resolvectl с systemd-resolved. На Linux без systemd-resolved настройка DNS этим адаптером пока не поддерживается. Маршруты по умолчанию добавляются как две половины /1, исходные default routes сохраняются; маршрут к каждому серверу закрепляется до включения туннеля. Изменения привязаны к отдельному bydlo-awg и журналу восстановления. Хуки PreUp/PostUp/PreDown/PostDown, Table, SaveConfig и DNS-домены в .conf отклоняются. Адаптер распознаёт параметры закреплённого amneziawg-go/v3 v3.1.20260828: Jc/Jmin/Jmax, S1–S4, H1–H4, I1–I5, а также AWG3 HeaderProtectionKey, ContentPaddingAddition, RekeyAfterTime, RekeyTimeout, RejectAfterTime, KeepaliveTimeout, MaxHandshakeAttempts, RandomTrailers, DisableCookies. Имена AWG3 явно преобразуются в UAPI с подчёркиваниями. HeaderProtectionKey — 32-байтный base64-ключ в .conf, hex в UAPI; он хранится только среди секретов и маскируется в логах. Для ненулевого ключа все S1–S4 должны быть не меньше 12 (и не больше 65535), как требует upstream. Новые числовые параметры принимают одно беззнаковое 32-битное число или диапазон min-max; для двух флагов допустимы true/false, t/f, on/off, 1/0 без учёта регистра. Проверки парсинга и преобразования изолированные; реальное подключение с новыми параметрами остаётся ручной проверкой сопровождающего, отметки поддержки платформ не меняются. На macOS AmneziaWG использует отдельный utun, временные маршруты и DNS активных сетевых служб. Журнал нужен для восстановления после сбоя. Реальное подключение проверяется владельцем вручную. Хост сообщает выделенное имя utunN через WG_TUN_NAME_FILE; при отсутствии файла запуск прерывается с очисткой. Маршруты IPv4/IPv6 по умолчанию разделяются на два /1, исходные default routes не заменяются. При восстановлении DNS и маршруты к серверу меняются только если они всё ещё соответствуют записанным настройкам BYDLO. Неудачное восстановление сохраняет журнал amnezia-macos-network.json; повторите отключение для новой попытки. До повторной очистки после ошибки подготовки блокировка журнала остаётся у текущей сессии.

OpenVPN 2.7 не поддерживает Wintun. BYDLO использует DCO; TAP-профили и несовместимые с DCO параметры на Windows не поддерживаются этой встроенной конфигурацией. Драйвер и адаптер остаются установленными после выхода; для удаления используется диспетчер устройств Windows. Установка не выполняется при подключении, в Mock Mode или safety lock. Unix-сборка отключает LZO/LZ4, PKCS#11, плагины и DCO: OpenSSL и libcap-ng не нужно доустанавливать, но libc и системные инструменты настройки сети остаются зависимостями ОС. Автоматическое применение pushed DNS для OpenVPN на Unix пока не реализовано; используйте настроенный системный DNS. Сопровождающий проверил нативные подключения AmneziaWG/OpenVPN и установку DCO на Windows вручную. Автоматические тесты используют фейки.

При импорте и перед каждым запуском OpenVPN (напрямую или через службу) действует общая проверка безопасного подмножества директив. Внешние обработчики, плагины, загрузка модулей, вложенные config, управляющие сокеты и произвольные файлы вывода запрещены. Сертификаты и ключи должны быть встроены в .ovpn; внешний auth-user-pass запрещён — файл учётных данных создаёт само приложение. Ранее сохранённые профили также проверяются перед запуском; небезопасный конфиг отклоняется до записи рабочего .ovpn и запуска процесса.

OpenVPN 2.7.9: применимость исправлений безопасности

Закреплены официальные Windows MSI 2.7.9-I001 (amd64 и arm64) и исходный архив openvpn-2.7.9.tar.gz. До внесения в lock-файлы проверены подписи Authenticode (OpenVPN Inc., отпечаток 32BF9F103192726DAA416FEF348066E5F2D831CF) и GPG-подпись релиза ключом OpenVPN Security Mailing List (F554A3687412CFFEBDEFE0A312F5F7B42F2B01E7) для всех трёх артефактов, а также их SHA-256; суммы записаны в engines/bundle-inputs.lock.json. Состав файлов MSI совпадает с 2.7.8-I002: OpenSSL остаётся 3.6.5 (переход на 4.x попутно не выполняется), ovpn-dco 2.8.14 побайтово тот же, libpkcs11-helper 1.31 и license.txt не изменились.

Применимость исправлений 2.7.9 к BYDLO:

  • Поиск DLL плагинов в Windows срабатывает только при --plugin, а OpenVpnConfigPolicy отклоняет эту директиву при импорте и перед каждым запуском — путь недостижим.
  • Интерактивная служба openvpnserv (повышенные права, фильтрация окружения, CVE-2026-121720): BYDLO поставляет только консольный движок и не устанавливает эту службу — неприменимо.
  • Кавычки в командной строке (CVE-2026-115342): часть, относящаяся к openvpnserv, неприменима; консольный openvpn.exe разбирает аргументы через CommandLineToArgvW. BYDLO передаёт аргументы отдельными элементами ProcessStartInfo.ArgumentList без промежуточной оболочки, поэтому пути с пробелами и кавычками не склеиваются в одну строку.
  • Относятся к поставляемому консольному движку: разбор длинного имени пользователя в --auth-user-pass (upstream #1140), очистка ключевого материала (secure_memzero в crypto_epoch и для данных PEM-ключей), перезагрузка CRL, tls_crypt, устранение утечек TUN-адаптера в Windows.

Новые сетевые службы и драйверы при разработке не устанавливаются. Установка DCO остаётся отдельной командой с явным согласием и правами администратора; реальное подключение проверяет сопровождающий вручную.

Цепочки прокси (relay)

Цепочка — упорядоченный список сохранённых серверов: трафик входит в первый и выходит из последнего. Сборка — только на движках с поддержкой relay: sing-box соединяет outbound'ы через detour, Xray — через proxySettings. Нативные WireGuard / AmneziaWG / OpenVPN, Zapret и TgWsProxy в цепочке не участвуют: выбор такого звена или движка завершается NotImplemented (error.chain.engine), приложение честно сообщает об этом.

Функция sing-box Xray-core
Цепочка из 2–5 звеньев 🧪 (detour между outbound/endpoint) 🧪 (proxySettings между outbound; выходной — первый outbound по умолчанию)
WARP как звено цепочки 🧪 (endpoint с detour, включая reserved) ❌ (Xray не поддерживает WireGuard-звено)
Проверка соединения цепочки целиком 🧪 (сквозная проверка через локальный прокси) 🧪 (так же)

При сохранении отклоняются: меньше двух звеньев, больше пяти, несуществующие серверы, повторы (защита от петель) и принудительный движок вне sing-box/Xray. Удаление сервера отцепляет его от цепочек; цепочки короче двух звеньев удаляются. Цепочки входят в зашифрованный бэкап; устаревшие (со ссылкой на отсутствующие серверы) при восстановлении пропускаются.

Cloudflare WARP (итог исследования и реализация)

WARP основан на WireGuard. Регистрация выполняется через неофициальный клиентский API Cloudflare https://api.cloudflareclient.com/<версия>/reg — те же endpoints, что использует wgcf (MIT; код wgcf в BYDLO не копируется, арифметика X25519 реализована самостоятельно по RFC 7748).

Итог исследования (закрывает исследовательскую часть задачи):

  • API недокументирован и версионируется (v0a…); BYDLO закрепляет проверенную версию и не угадывает новые. Заголовки клиента (User-Agent, CF-Client-Version) обязательны, иначе сервер отвечает 403.
  • Регистрация подтверждает Terms of Service Cloudflare меткой времени; официальный клиент и wgcf не аффилированы с BYDLO.
  • Лицензия wgcf (MIT) допускает повторную реализацию протокола; упоминание и ссылка сохранены в THIRD_PARTY_NOTICES.md.
  • Стабильность не гарантирована Cloudflare: регистрация — только по явному нажатию, автоматических попыток и фоновых вызовов нет; сбои показываются локализованной ошибкой.

Реализация:

Функция Windows Linux macOS Android
Регистрация WARP по кнопке («Серверы» → Cloudflare WARP) ✅ 🧪 🧪 🗓
Подключение WARP-профиля (WireGuard через sing-box, ключи в ISecretStore) ✅ 🧪 🧪 🗓
WARP как звено цепочки ✅ (см. выше) 🧪 🧪 🗓

Сгенерированный профиль — обычный сервер WireGuard (engage.cloudflareclient.com:2408, reserved из client_id, если сервер его вернул): его можно подключать, включать в цепочки и бэкапить как любой другой. Account id, токен и лицензия хранятся в ISecretStore и никогда не попадают в журнал (LogRedactor). Клиент API покрыт модульными тестами с фейковым HTTP; живую регистрацию проверяет мейнтейнер вручную.

Ограничения Zapret

  • Windows ARM64: в закреплённом Flowseal-архиве есть только x64 WinDivert. Эмуляция x64 не заменяет ARM64 kernel driver; BYDLO честно возвращает NotImplemented.
  • Linux: нужен root, установленный nft и поддержка NFQUEUE в ядре. Используется только nftables; fallback на iptables отсутствует. Очередь 21770 и метка 0x40000000 зарезервированы для BYDLO.
  • macOS: нужен root, свободный TCP-порт 21771, активные стандартные com.apple/* filter/rdr anchors. BYDLO не переписывает pf.conf. Только локальный IPv4 TCP 80/443; UDP/QUIC, IPv6, трафик root и игровой фильтр не поддерживаются. Игровой фильтр из резервной копии Windows/Linux игнорируется при запуске на macOS; сохранённое значение остаётся доступным при переносе обратно.
  • Нативные пресеты BYDLO используют публичные опции upstream; они не копируются из проектов без лицензии и не эквивалентны всем стратегиям Flowseal.
  • Пользовательские списки находятся в <data>/zapret/lists/. Приоритет установки: встроенная исправная копия → управляемая → папка пользователя. При обновлении приложения пользовательские списки не перезаписываются.
  • При сборке Windows x64 BYDLO добавляет домены из engines/bydlo-zapret-list.txt в lists/list-general.txt распакованного Flowseal после проверки SHA-256 исходного архива. Стратегии используют итоговый список при включении Zapret. Пользовательские списки и исключения остаются отдельными. Это относится к комплекту в релизе BYDLO.
  • Работоспособность обхода в конкретной сети проверяет мейнтейнер вручную.

Kill switch

Опция выключена по умолчанию. В Настройки → Дополнительно прочитайте предупреждение, подтвердите его и включите «Блокировать интернет при отключении VPN». Опция применяется при следующем подключении TUN через sing-box. Для других движков подключение TUN с этой опцией отклоняется; режим локального прокси не меняется.

Отдельный процесс sing-box держит auto_route + strict_route и передаёт интернет-трафик в локальный SOCKS5-порт транспортного процесса. При падении транспорта и во время его перезапуска TUN остаётся активным; прямого резервного выхода в интернет нет. После исчерпания попыток переподключения блокировка сохраняется до явного отключения. LAN (IPv4, IPv6 link-local и ULA) и mesh-диапазоны исключаются согласно настройкам маршрутизации. Прямые домены, CIDR, процессы и режим «только выбранные домены» при этом игнорируются.

Удалённый DNS сохраняет выбранный транспорт (UDP, TCP, HTTPS, TLS или QUIC) и работает только через прокси. Адрес DNS-сервера должен быть IP-адресом: системный DNS, доменное имя с отдельным bootstrap-разрешением и направление «напрямую» отклоняются явной ошибкой до запуска процессов. В DNS-конфиге TUN нет прямого или системного резервного сервера. Раздельные правила DNS в TUN не применяются; все его запросы идут на удалённый DNS. Транспортный процесс сохраняет адреса, транспорты и направления DNS для своих запросов.

Кнопка «Выключить kill switch и отключиться» доступна в настройках без раскрытия дополнительных параметров. Обычное отключение и закрытие окна также останавливают TUN. После сбоя BYDLO следующий запуск пытается завершить только оставшийся TUN-процесс из журнала BYDLO с проверкой PID, имени образа и времени запуска. Если не хватает прав, нужен перезапуск с прежними правами и эта же кнопка либо очистка оставшихся процессов. Чужие VPN и mesh-клиенты не затрагиваются. Mock-режим и safety lock запрещают такую очистку.

Ограничение: защита действует, пока жив отдельный TUN-процесс. Его собственный сбой, принудительное завершение или изменение маршрутов сторонним ПО может открыть прямой доступ. Это не постоянная блокировка на уровне ОС. Сетевое поведение и снятие маршрутов после аварии требуют ручной проверки на каждой ОС; агенты и CI её не выполняют.

Схема: TUN / strict_route, SOCKS outbound.

Автоподбор Zapret доступен в «Инструменты → Zapret»: Windows — аргументы winws из найденных BAT, Linux/macOS — нативные пресеты. Стандартные HTTP/TLS-проверки Test Zapret 1.10.3 перенесены в BYDLO; интерактивный скрипт не запускается. Проверка только по явному действию пользователя, с правами администратора/root, curl и возможностью отмены. Область измерений и ограничения: автоподбор в TESTING.md.

Готовые режимы маршрутизации

На главной можно выбрать режим, а на странице «Маршрутизация» — страну и загрузить закреплённые наборы правил. Режим «Только сайты, заблокированные в России» использует список RunetFreedom. Режим «Всё, кроме местных сайтов» использует домены и IP-диапазоны SagerNet для России или Китая. Ручные исключения и блокировки применяются перед наборами. Настройки вступают в силу при следующем подключении.

Региональные режимы доступны в sing-box. При включённой аварийной блокировке TUN выберите обычный режим. BYDLO сверяет SHA-256 наборов при загрузке и перед подключением.

В разделе «Дополнительно» можно добавить упорядоченные правила, поменять их местами и импортировать или экспортировать JSON. Для sing-box указывайте тег закреплённого набора, например geosite-ru или geoip-cn. Для Xray указывайте код из geo-файла, например category-ru или cn. Кнопка загрузки на той же странице проверяет нужные geo-файлы до обновления кеша.

В «Дополнительно → Источники наборов правил» показаны встроенные источники и редактор своих источников: тег, закреплённый HTTPS-адрес, SHA-256 и предел размера (до 64 МиБ). Для sing-box источник содержит бинарный .srs; его тег используется в условии Geosite или GeoIP и в DNS-правилах. Имена geosite.dat и geoip.dat предназначены для замены соответствующих geo-файлов Xray. Встроенные теги sing-box менять нельзя. URL и хеш обновляются вручную; фоновой загрузки нет.

Загрузка выполняется только кнопкой. До публикации файла проверяются предел размера и SHA-256; ошибка, отмена или обрыв сохраняют предыдущий проверенный файл. Подключение читает только кеш и повторно проверяет размер и хеш, без автоматической загрузки. Изменение источника на новый хеш требует загрузки новой версии до переподключения. Отдельные файлы обновляются независимо. Уже запущенное подключение продолжает использовать прежнюю конфигурацию.

Экспорт JSON содержит Rules и Sources; порядок правил сохраняется. Импорт принимает также прежний JSON-массив правил, проверяет данные целиком до изменения редактора и не загружает источники. После импорта нажмите «Сохранить». Размер импортируемого файла ограничен 1 МиБ. Полная резервная копия также сохраняет источники; при объединении одноимённых источников приоритет у текущих настроек.

Общие geo-условия переводятся между движками: Geosite cn / geosite-cn, category-ru / geosite-ru; GeoIP cn / geoip-cn, ru / geoip-ru. Произвольный .srs и blocked-ru не переводятся в geo-файл Xray и возвращают NotImplemented; неизвестный sing-box набор также недоступен, пока для него не добавлен источник. Регистрация источника не преобразует форматы geo-файлов.

Условия: точный домен, суффикс, ключевое слово, Geosite, GeoIP, CIDR, процесс и порт; действия: через VPN, напрямую, блокировка. Порядок пользовательских правил сохраняется в обоих движках; служебные правила DNS, проверок подключения и сохранения локальных/mesh-сетей имеют приоритет. Правила по процессу доступны в sing-box только в TUN, в Xray — на Windows/Linux; неподдерживаемый вариант возвращает NotImplemented. В режиме привилегированного помощника внешние наборы правил по-прежнему недоступны.

DNS в профиле подключения

На странице «Маршрутизация» можно настроить транспорт и направление запросов для двух DNS-серверов. Для выбора сервера по домену укажите суффиксы. В sing-box можно также указать теги загруженных наборов правил. FakeIP включается отдельно и работает в sing-box в режиме TUN. Исключения FakeIP получают обычные DNS-ответы.

Транспорт DNS sing-box Xray
Системный Резолвер ОС Резолвер ОС
UDP Напрямую или через VPN Напрямую или через VPN, адрес сервера — IP
TCP, DoH Напрямую или через VPN Напрямую или через VPN
DoT Напрямую или через VPN NotImplemented
DoQ Напрямую или через VPN Только напрямую; через VPN — NotImplemented
DNS по суффиксам доменов Да Да
DNS по наборам правил Загруженные .srs NotImplemented
FakeIP Только TUN, выключен по умолчанию Нет; TUN — NotImplemented

Для DoT, DoQ через VPN и DNS-правил с наборами используйте sing-box: Xray сообщает об ограничении до подготовки процесса. В автоматически создаваемом конфиге Xray DNS задаётся и с настройками по умолчанию: DoH 1.1.1.1 через прокси. Служебные правила направления DNS имеют приоритет над пользовательскими правилами и режимом «только выбранные домены».

Адрес сервера вводится как IP или имя хоста без схемы URL; транспорт выбирается отдельно. Системный DNS и значение local используют резолвер ОС независимо от флажка «Запрашивать через VPN». Для имён DNS-серверов sing-box использует системный bootstrap-резолвер. Прямой сервер Xray используется при наличии доменных правил для него. Настройки этого раздела не меняют DNS сетевых интерфейсов ОС и не запускают отдельную системную DNS-службу. Явные DNS-правила по доменам и наборам имеют приоритет над FakeIP; остальные запросы A/AAAA в TUN получают синтетические адреса, а исключения FakeIP — обычные ответы.

В «Настройки → Дополнительно → Активные соединения» можно раскрыть список соединений sing-box, найти соединение по домену, процессу, правилу или исходящему подключению и закрыть его. Список обновляется раз в две секунды только пока открыт этот раздел. Для Xray и остальных движков выводится сообщение о недоступности. Clash API слушает только 127.0.0.1, с отдельным случайным секретом на каждое подключение. Из строки с доменным именем можно открыть редактор правил с заполненным условием. В режиме имитации показываются синтетические данные.

В списке подключений можно вручную запустить тест скорости для профилей sing-box и Xray на Windows, Linux и macOS. Укажите HTTPS-адрес тестового файла без учётных данных. BYDLO использует временные прокси на loopback, проверяет до двух профилей одновременно и читает до 4 МиБ на профиль. На запуск движка отведено до 12 секунд, на запрос и загрузку — ещё до 12 секунд. Если время загрузки истекло после получения части файла, скорость рассчитывается по полученным байтам. Ответ запрашивается без сжатия и с запретом кеширования; перенаправления не выполняются. Это короткая оценка скорости загрузки, а не гарантия пропускной способности.

Перед запуском показано предупреждение о расходе трафика. Результат отображается в строке сервера; доступна сортировка по убыванию скорости. Ошибки и неподдерживаемые профили отображаются как «—». Произвольные JSON-конфиги исключены: их правила могут направлять запрос напрямую или через несколько серверов. Профили других движков (например, OpenVPN и AmneziaWG), цепочки и инструменты Zapret / Telegram этим тестом не измеряются. WireGuard измеряется только через локальный прокси sing-box, если он выбран для профиля.

При отмене временные движки останавливаются независимо от отменённого токена. Ошибка очистки сообщается пользователю; менеджер сохраняет движок и рабочие файлы для повторной очистки при завершении работы. В Mock Mode и под блокировкой разработки замер отключён с пояснением в интерфейсе. Реальные сетевые проверки выполняет только сопровождающий вручную.

В редакторе профиля можно переопределить общие настройки фрагментации TLS, padding и мультиплексирования. sing-box поддерживает фрагментацию ClientHello или записей TLS и padding внутри mux. Для фрагментации ClientHello sing-box использует верхнюю границу интервала как резервную задержку, а размер определяет сам. Xray поддерживает размер и интервал фрагментации ClientHello, padding для XHTTP и XUDP. Мультиплексирование с Vision отклоняется.

В macOS секреты сохраняются в Keychain, в Linux — в Secret Service через libsecret. При первом чтении старые записи переносятся из зашифрованных файлов. Если системное хранилище недоступно, локальные записи продолжают работать, а в настройках появляется предупреждение. Для доступа к уже перенесённой записи нужно разблокировать системное хранилище. Резервная копия использует то же хранилище через общий интерфейс.

Файловая копия заменяется служебной отметкой только после успешной записи и проверки чтения из системного хранилища. Если перенесённый секрет удалён из Keychain / Secret Service, приложение сообщает об этом и предлагает восстановить резервную копию или повторить импорт. Резервное копирование при недоступных перенесённых секретах завершается ошибкой, чтобы не создать неполную копию без предупреждения. Разные каталоги данных используют отдельные записи системного хранилища. В Linux нужны libsecret-1.so.0 и работающий Secret Service в пользовательской D-Bus-сессии; при их отсутствии новые и ещё не перенесённые секреты остаются в зашифрованных файлах. В безопасном режиме разработки и при принудительном --mock системное хранилище не используется.

Выбор хранилища, миграция существующих AES-файлов, недоступность и отмена операций, удаление и резервное копирование проверяются изолированными тестами с фейками. Реальная работа Keychain и Secret Service требует ручной проверки на соответствующих ОС.

При локальном подключении BYDLO может настроить системный HTTP/HTTPS-прокси в Windows, GNOME, KDE и macOS. В GNOME и KDE нужны штатные инструменты рабочего стола. В macOS используются активные сетевые службы. Linux и macOS сохраняют предыдущие параметры в журнале и восстанавливают их при отключении или после сбоя. Настройки, изменённые другим приложением во время подключения, сохраняются. Если движок падает без автопереподключения или попытки исчерпаны, BYDLO очищает системный прокси, чтобы не оставлять браузеры на мёртвом порту; ошибка подключения видна в интерфейсе. Если сам системный прокси не настроился, подключение останавливается с честной ошибкой вместо состояния «подключено» без прокси.

Для GNOME нужен gsettings, для KDE — согласованная пара kreadconfig5/kwriteconfig5 или kreadconfig6/kwriteconfig6. Если другое приложение меняет адрес или порт прокси, откат сохраняет и связанный режим включения; в GNOME также сохраняется аутентификация этого HTTP-прокси. В macOS используются scutil и networksetup; прежний прокси с аутентификацией отклоняется до изменений, поскольку пароль нельзя получить для безопасного восстановления. Команды, частичная установка, повторный откат и запрет операций в safe-dev/Mock Mode проверены изолированными тестами. Реальную работу на Linux/macOS мейнтейнер проверяет вручную; отметка 🧪 сохраняется.

Clash/Mihomo YAML импортируется как список отдельных профилей VLESS, VMess, Trojan, Shadowsocks, Hysteria2 и TUIC. Предпросмотр показывает номера пропущенных записей. В пользовательских JSON sing-box и Xray BYDLO сохраняет исходящие подключения и поддерживаемые встроенные правила. Слушатели, режим TUN и служебный API задаёт BYDLO. Настройки с внешними файлами и пользовательским API отклоняются. JSON с учётными данными хранится в хранилище секретов.

Для Clash сохраняются списки HTTP/H2-хостов и ограничения скорости Hysteria2 (up / down, целые Мбит/с или 50 Mbps); hy2 распознаётся как Hysteria2. JSON проверяется до предпросмотра: обязательные адреса, числовые порты 1–65535, учётные данные и форма основных параметров исходящих подключений. Это проверка поддерживаемого подмножества, а не полная схема всех версий движков. TUN пользовательского JSON поддерживает sing-box; Xray использует локальный прокси.

Публичные списки igareck, проверенный микс 0xRadikal и VLESS-список MatinGhanbari доступны в мастере «Добавить сервер». BYDLO запрашивает список при выборе источника, пробует зеркала по очереди и показывает распознанные и пропущенные записи. В предпросмотре серверы выбираются по одному: сохраняется только отмеченное. По кнопке проверяется задержка каждого сервера предпросмотра, недоступные помечаются, список сортируется по задержке. Повторяющиеся параметры подключения и учётные данные в пределах одного списка объединяются. После подтверждения сохраняется подписка с адресом ответившего зеркала. Состав списков меняется. Публичными серверами управляют сторонние владельцы.

При обновлении подписки совпавшие узлы сохраняют ID, имя, избранное, выбор движка и локальные параметры. Изменения поставщика применяются к параметрам, которые пользователь не переопределял. При первом обновлении старых подписок без исходного снимка BYDLO сохраняет текущие параметры узлов. BYDLO сопоставляет протокол, адрес, порт и учётные данные. Для нескольких узлов с одинаковыми данными учитываются параметры подключения. Исчезнувшие из списка узлы остаются, если они в избранном или в цепочке. Если сохранённый адрес публичного списка недоступен, BYDLO пробует другие зеркала того же источника.

На Linux нативные TCP- и QUIC-профили Zapret автоматически используют базовые домены и общий встроенный список engines/bydlo-zapret-list.txt без дубликатов. Пользовательские домены и исключения остаются отдельными файлами. Для nfqws создаётся читаемый процессом снимок списков в рабочем каталоге сессии; реальная сеть проверяется вручную.