VPN — руководство пользователя | YoBench
Как пользоваться модулем «VPN» в YoBench: VLESS+Reality через sing-box, режимы TUN и прокси, импорт подписок, метрики, обход маршрутизации.
Что такое модуль «VPN»
Встроенный VLESS+Reality VPN-клиент на основе sing-box. Поддерживает два режима: TUN (системный туннель — весь трафик ОС идёт через VPN) и прокси (только приложения, которые сами умеют ходить через локальный SOCKS-прокси). Подходит для обхода блокировок и приватного доступа в сеть.
Что вы получаете:
- VLESS+Reality через sing-box — со встроенным
xtls-rprx-visionflow. - Два режима: TUN или локальный SOCKS-прокси.
- Импорт подписок — единый URL подписки разворачивается в список профилей.
- Реалтайм-метрики —
up/downчерез Clash API (порт9090) c обновлением ~1 раз в секунду. - Логи подключения — буфер 200 записей; парсинг stderr sing-box на уровни (
info/warn/error). - Тест задержки — TCP-проверка до сервера профиля.
- Платформенная архитектура: на Windows TUN-режим обслуживает Go-сервис
yobench-vpn-service.exeчерез TCP-порт19876(устанавливается с UAC один раз); на macOS/Linux TUN требуетsudo, для удобства добавляется правило в/etc/sudoers.d/yobench-vpn.
Параметры профиля
VPN-профиль создаётся либо вставкой VLESS URI, либо импортом из подписки:
vless://UUID@SERVER:PORT?encryption=none&type=tcp&security=reality
&fp=FINGERPRINT&pbk=PUBKEY&sid=SHORT_ID&sni=SNI&flow=FLOW#NAME
В БД сохраняются: name, server, server_port, uuid, sni, public_key, short_id, fingerprint, flow, vless_uri.
Глобальные настройки
- Последний профиль (
vpnLastProfileId) — для авто-восстановления после перезапуска приложения. - Режим (
vpnMode) —tun(по умолчанию) илиproxy. - Порт прокси (
vpnProxyPort) — по умолчанию10808. - Авто-подключение (
vpnAutoConnect) — включать соединение автоматически. - URL подписки (
vpnSubscriptionUrl) — внешний URL для импорта набора профилей. - Bypass-домены (
vpnBypassDomains) и bypass-суффиксы (vpnBypassSuffixes) — split tunneling по доменам. - DNS-провайдер (
vpnDnsProvider) — Cloudflare (по умолчанию), Google и др. - Кастомный DNS (
vpnDnsCustomUrl) — поддерживаетtls://,https://,udp://. - TLS-фрагментация (
vpnFragment) —falseпо умолчанию. - Уровень логов (
vpnLogLevel) —error/warn/info/debug. По умолчаниюwarn.
Маршрутизация: приватные IP идут напрямую, мультикаст и mDNS блокируются, публичный IPv6 — через прокси (fallback), DNS-запросы перехватываются (hijack-dns).
Защита от утечек: пока туннель активен, альтернативные DNS-протоколы блокируются, чтобы приложения не могли обойти настроенный DNS-резолвер.
Флоу использования
1. Добавьте профиль
- Откройте модуль VPN в левом меню.
- Импорт подписки: вставьте URL и нажмите Импортировать — появится список профилей.
- Или Добавить вручную: вставьте VLESS URI и имя.
2. Выберите режим
- TUN — для системного туннеля (нужны права администратора).
- Прокси — локальный SOCKS на порту 10808; настройте приложения вручную или через переменные
HTTP_PROXY/HTTPS_PROXY.
3. Подключитесь
Кликните Подключить. Метрики up/down появятся в реальном времени, статус — в шапке.
4. Настройте маршрутизацию
В настройках:
- Bypass-домены — список доменов, которые идут мимо VPN (например, банк-приложение или локальные сервисы).
- DNS — выберите провайдера или кастомный URL.
5. Проверьте задержку
Кнопка Тест задержки отправит TCP-пинг до сервера выбранного профиля и покажет ms.
Что дальше
- Если используете VPN для парсинга — настройте прокси на уровне модуля или используйте локальный SOCKS-порт 10808.
- Для серверного мониторинга через VPN — Серверы.
Помощь и обратная связь
Хотели бы поддержку Trojan, Shadowsocks, Hysteria или kill-switch? Напишите нам через форму обратной связи.