vpn

🤔 Зачем

Большие клиенты для VLESS (v2rayN, Hiddify, Nekoray и др.) часто работают в TUN-режиме и заворачивают через VPN весь трафик. Под раздачу попадает и SSH, а многие VPN-серверы режут исходящий порт 22. В итоге при включённом VPN на свои серверы не зайти.

vpn — маленький консольный клиент на базе Xray-core. Он работает как локальный прокси, сам включает системный прокси macOS и никогда не пускает SSH и локальную сеть через VPN.

✨ Возможности

🛡 SSH мимо VPN Порт 22, приватные сети и localhost всегда идут напрямую. Плюс свои исключения: домены, IP, подсети.

🖥 TUI и CLI Интерфейс на Bubble Tea: пинг с подсветкой, скорость ↑/↓, лог, исключения. Для скриптов — vpn on / off / status.

🔗 Подписки Marzban, Remnawave, 3x-ui и другие. Обновляются сами раз в сутки, показывают остаток трафика и срок.

🔐 Протоколы VLESS (TCP, WS, gRPC, XHTTP, HTTPUpgrade; TLS и Reality), VMess, Trojan, Shadowsocks.

🔁 Сам себя чинит Сторож в фоне поднимает VPN после перезагрузки, перезапускает упавший xray и уходит на лучший сервер, если текущий умер.

⚡ Честный пинг Запрос через каждый сервер, а не TCP до порта. b — сразу к самому быстрому.

🧭 Режимы global — всё через VPN. ru — российские сайты напрямую.

📦 Без зависимостей Один бинарник. Ядро Xray скачивается само, с проверкой SHA-256.

🍎 Сделан для macOS Системный прокси через networksetup, автозапуск через launchd, экспериментальный TUN, интерфейс на русском и английском.

📥 Установка

Homebrew — самый простой способ, обновления через brew upgrade:

brew install --cask pnnnx/tap/vpn

Готовый бинарник (для Intel замени arm64 на amd64):

mkdir -p ~/.local/bin
curl -fsSL https://github.com/pnnnx/vpn/releases/latest/download/vpn_darwin_arm64.tar.gz | tar xz -C ~/.local/bin vpn

Если ~/.local/bin нет в PATH:

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc && source ~/.zshrc

Через Go (1.24+):

go install github.com/pnnnx/vpn@latest

Из исходников:

git clone https://github.com/pnnnx/vpn && cd vpn && make build

🚀 Быстрый старт

vpn sub 'https://ссылка-на-подписку'   # 1. загрузить серверы
vpn                                    # 2. P — пинг, b — лучший, Enter — подключиться
vpn autostart on                       # 3. (по желанию) автозапуск и автопереключение

При первом включении vpn сам скачает ядро Xray, а macOS может спросить пароль — так меняется системный прокси.

⌨️ Управление

Команда	Что делает
vpn	открыть TUI
vpn on [N] · off · toggle	включить / выключить
vpn status	состояние, сервер, подписка, автозапуск
vpn sub <url> · update	задать / обновить подписку
vpn autoupdate on|off	обновлять подписку раз в сутки (по умолчанию да)
vpn add <ссылка>	добавить сервер вручную
vpn list · use N	список / выбрать сервер
vpn ping [--real] · best	пинг с причинами отказов / выбрать лучший
vpn test	задержка и внешний IP через VPN
vpn mode global|ru	режим маршрутизации
vpn direct add|rm|list <x>	исключения: домен, IP или CIDR
vpn autostart on|off	фоновый сторож через launchd
vpn autoswitch on|off	переключать сервер при падении
vpn sysproxy on|off	трогать ли системный прокси
vpn tun on|off	🧪 TUN-режим для всех программ (нужен sudo)
vpn lang ru|en|auto	язык интерфейса
vpn env [--off]	прокси для терминала: eval "$(vpn env)"
vpn setup	скачать / обновить ядро Xray
vpn config · log · version	конфиг Xray, логи, версия

🧭 Как это работает

flowchart LR
    U["vpn: CLI и TUI"] -->|config.json| X["xray-core: SOCKS 10808, HTTP 10809"]
    W["vpn watch (launchd)"] -.->|перезапуск, переключение| X
    A["Браузеры и приложения"] -->|системный прокси| X
    X -->|VLESS Reality| S[("VPN-сервер")]
    S --> I(("Интернет"))
    T["ssh, git по ssh, локальная сеть"] -->|напрямую| I

• Протоколы vpn сам не реализует: криптография и транспорт — это Xray-core. vpn собирает для него конфиг и управляет процессом.
• xray живёт в отдельной сессии. Закрытие терминала или выход из TUI VPN не выключает.
• Режим — локальный прокси, не TUN. Через VPN идут программы, которые уважают системный прокси: Safari, Chrome, Telegram и большинство приложений.

Почему SSH работает. Терминальный ssh системный прокси не использует и идёт напрямую. Даже если трафик всё же попадёт в xray (через vpn env или proxychains), первое правило маршрутизации отправляет порт 22 напрямую. Так же напрямую идут 10/8, 172.16/12, 192.168/16, 100.64/10, localhost и *.local.

SSH на нестандартном порту — добавь сервер в исключения:

vpn direct add 203.0.113.7            # IP
vpn direct add myserver.example.com   # домен и все поддомены

🔁 Автозапуск и автопереключение

vpn autostart on ставит агент launchd, который запускает vpn watch при входе в систему. Сторож раз в 30 секунд:

Ситуация	Что делает
Mac перезагрузился, VPN был включён	поднимает xray
Mac перезагрузился, VPN был выключен	снимает «висящий» системный прокси
xray упал	перезапускает
~1,5 минуты нет ответа через VPN, а интернет напрямую есть	реальный пинг всех серверов → переход на самый быстрый

vpn off сторож уважает и обратно VPN не включает. Без переключения серверов: vpn autoswitch off. Убрать агент: vpn autostart off.

🧪 TUN-режим (экспериментально)

Системный прокси слушают не все программы: часть CLI-утилит, игры, некоторые мессенджеры идут мимо него. TUN заворачивает в VPN весь IPv4-трафик системы:

vpn tun on        # один раз
sudo vpn on       # TUN-интерфейсу нужен root
sudo vpn off

This is the beginning of the README. Read the rest at the original. Read the full README ↗