senboost/README.md

SenBoost

очередная обертка под zapret

Требования

• Node.js 20+ (проверено на 24)
• npm 10+

Команды

npm install        # зависимости + скачивание бинарника Electron
npm run dev        # dev-режим: HMR для UI, авто-рестарт main-процесса
npm run start      # запуск собранной версии без упаковки
npm run build      # typecheck + сборка main/preload/renderer в out/
npm run lint       # ESLint
npm run format     # Prettier
npm run typecheck  # tsc для node- и web-частей отдельно

npm run build:unpack   # быстрая проверка: приложение без установщика (release/*-unpacked)
npm run build:mac      # .dmg + .zip  (x64 + arm64)
npm run build:win      # NSIS .exe    (x64; arm64 не собираем — нет подписанного WinDivert)
npm run build:linux    # AppImage + .deb (x64)

Обход блокировок по платформам

Платформа	Движок	Права	Статус
Windows	winws + драйвер WinDivert, служба senboost-zapret	UAC при первой настройке	стабильно, гарантированно работает
macOS	utunws (форк nfqws под utun+BPF) + правила pf, LaunchDaemon	пароль администратора при каждом включении/выключении	частично — движок портирован недавно
Linux	nfqws + правила nftables (NFQUEUE)	пароль через pkexec при каждом включении/выключении	частично

На всех трёх платформах — один и тот же движок zapret уровня пакетов (winws/nfqws/utunws — одна и та же сборка nfq/nfqws.c под разный бэкенд), поэтому используется один набор из 22 стратегий Flowseal/zapret-discord-youtube.

На macOS для работы нужна версия 14 (Sonoma) или новее — движок собран под соответствующий API ядра. Переотправка пакетов идёт через BPF на MAC-адрес шлюза, поэтому активный VPN/туннель (маршрут по умолчанию уходит в свой utun) ломает обход — выключите другие VPN перед включением. Как и на других платформах, полезно сменить DNS на сторонний (1.1.1.1/8.8.8.8 или DNS-over-HTTPS) — блокировку по DNS сам zapret не лечит. Принудительная остановка (если приложение недоступно):

sudo "/Library/Application Support/SenBoost/zapret/stop.sh"

На Linux дополнительно нужны пакеты nftables и polkit (в .deb — заявлены как зависимости и ставятся сами; для AppImage — своими силами, sudo apt install nftables policykit-1). Ни службы, ни автозапуска с системой на Linux нет: демон и правила nftables переживают выход из приложения (правила закрыты флагом bypass — без работающего nfqws трафик просто проходит как есть, а не блокируется), но после перезагрузки заново их никто не поднимает. Автозапуск самого приложения (см. ниже) частично это закрывает — обход поднимется при входе в систему, но потребует pkexec на каждый вход.

Планы до 1.0

• Очистка и ревью нейросгенерированного кода
• Полная поддержка MacOS и Linux
• Фоновая работа в трей
• Поддержка Telegram-прокси
• Обновление из приложения

Ссылки

• bol-van/zapret — сам движок zapret, спасибо за столь хороший инструмент
• Flowseal/zapret-discord-youtube — списки сайтов (resources/zapret/lists/), fake-пакеты (resources/zapret/fakes/) и все 22 стратегии (src/main/zapret/strategies.win32.generated.ts).
• Flowseal/zapret-mac-discord-youtube — macOS-порт nfqws (utunws, resources/zapret/darwin/) и референс для привилегированных скриптов LaunchDaemon (resources/darwin-helper/).
• Sergeydigl3/zapret-discord-youtube-linux — референс для Linux-порта: те же стратегии Flowseal через nfqws, nftables вместо WinDivert.