[Фича]: Поддержка Linux — MVP (Zapret 1/2 и Оркестратор через nfqws/nfqws2) #153

Open
opened 2026-11-17 12:35:36 +03:00 by linkor-ing · 0 comments

Описание проблемы / потребности

ZapretGUI сейчас запускается только на Windows (winws/winws2 + WinDivert). В
репозитории уже есть Linux-слой (src/platforms/linux, root-helper, systemd,
polkit, заготовки deb/AppImage), но собрать рабочую версию нельзя без приватного
репозитория мейнтейнеров (скрипт сборки Nuitka, Lua, блобы, списки, иконки,
каталоги). Из-за этого пользователи Linux не могут пользоваться программой.

Хотелось получить рабочую версию на Linux (проверял на Arch, KDE Wayland):
чтобы запускались Zapret 1, Zapret 2 и Оркестратор через nfqws/nfqws2 + nftables.

Предлагаемое решение

Сделал рабочий MVP минимальными правками поверх существующего Linux-слоя, без
приватного репозитория — недостающее закрыл из публичных источников. Готов
прислать патч (55 файлов, +1447/−98) или открыть PR.

Что работает:

  • Движки nfqws2 (Zapret 2) и nfqws v1 (Zapret 1, bol-van/zapret v72.13) через
    root-helper + nftables; движок сбрасывает права на вызывающего (--uid).
  • Оркестратор портирован на nfqws2 (адаптер под Popen поверх helper'а, читает
    engine.log); циклический перебор/вайтлист/lua не тронуты.
  • Выбор движка по методу запуска, трансляция --wf-*→nft (вкл. v1-форму
    --wf-tcp=/--wf-udp=), абсолютизация путей блобов.
  • Трей (KDE/SNI), Premium (публичный адрес сервера), подбор стратегий, «Анализ
    лога» под формат nfqws2, hosts/DNS через существующие Cap-ветки.
  • Arch PKGBUILD: /opt/zapretgui (read-only, root) + состояние по XDG, systemd,
    polkit, группа zapretgui.

Данные (Lua/блобы/списки/иконки/каталоги) берутся из публичного Windows-
установщика (innoextract, только данные, без exe/dll/sys). Генерируемые приватной
сборкой файлы — заглушки; версию ставит PKGBUILD, адрес Premium восстановлен из
публичного релиза; приватные токены/прокси НЕ зашиваются.

Это MVP, а не замена официальной сборки. Понимаю, что восстановление данных из
релиза и заглушки мейнтейнеры захотят заменить своим пайплайном — это ожидаемо;
MVP показывает, что код приложения на Linux работает минимальными правками.

Альтернативные варианты

  • Ждать официального порта — но Linux-слой в репо уже есть, не хватало сборки.
  • Собирать только из публичного bol-van/zapret2 — тогда нет пресетов/блобов/
    каталогов (они в приватной части), подбор и готовые пресеты не работают.
  • deb/AppImage из репо — тоже требуют приватный build-пайплайн.

Дополнительный контекст / скриншоты

Усилил безопасность root-helper'а (он запускает движок от root по аргументам из
непривилегированного сокета): allowlist точных имён опций (обход через сокращения
getopt), подтверждение путей блобов целиком (обход через ,/: в @-путях),
перенос --hostlist-auto в root-папку (O_NOFOLLOW+fchown, symlink-гонка), запрет
файл-опций без '='.

Честно про известное ограничение (нужен ВТОРОЙ локальный пользователь из группы
zapretgui): read-TOCTOU у --blob/--dpi-desync-fake-* — подмена пути на symlink
после проверки даёт root-чтение чужого файла. --lua-init не эксплуатируется
(droproot() до lua_init()). Полный фикс наметил (копирование файлов в root-папку),
в MVP не делал.

Оговорки:

  • 5–11 из 171 встроенных winws1-пресетов не проходят из-за ошибок в самих
    пресетах, не из-за движка.
  • Linux-набор тестов проходит (642 passed); реальный трафик/helper под root — на
    стороне пользователя.

Готов приложить патч и инструкцию применения, если направление интересно.

Проверка дубликатов

  • Я проверил существующие задачи и не нашёл аналогичного запроса
### Описание проблемы / потребности ZapretGUI сейчас запускается только на Windows (winws/winws2 + WinDivert). В репозитории уже есть Linux-слой (src/platforms/linux, root-helper, systemd, polkit, заготовки deb/AppImage), но собрать рабочую версию нельзя без приватного репозитория мейнтейнеров (скрипт сборки Nuitka, Lua, блобы, списки, иконки, каталоги). Из-за этого пользователи Linux не могут пользоваться программой. Хотелось получить рабочую версию на Linux (проверял на Arch, KDE Wayland): чтобы запускались Zapret 1, Zapret 2 и Оркестратор через nfqws/nfqws2 + nftables. ### Предлагаемое решение Сделал рабочий MVP минимальными правками поверх существующего Linux-слоя, без приватного репозитория — недостающее закрыл из публичных источников. Готов прислать патч (55 файлов, +1447/−98) или открыть PR. Что работает: - Движки nfqws2 (Zapret 2) и nfqws v1 (Zapret 1, bol-van/zapret v72.13) через root-helper + nftables; движок сбрасывает права на вызывающего (--uid). - Оркестратор портирован на nfqws2 (адаптер под Popen поверх helper'а, читает engine.log); циклический перебор/вайтлист/lua не тронуты. - Выбор движка по методу запуска, трансляция --wf-*→nft (вкл. v1-форму --wf-tcp=/--wf-udp=), абсолютизация путей блобов. - Трей (KDE/SNI), Premium (публичный адрес сервера), подбор стратегий, «Анализ лога» под формат nfqws2, hosts/DNS через существующие Cap-ветки. - Arch PKGBUILD: /opt/zapretgui (read-only, root) + состояние по XDG, systemd, polkit, группа zapretgui. Данные (Lua/блобы/списки/иконки/каталоги) берутся из публичного Windows- установщика (innoextract, только данные, без exe/dll/sys). Генерируемые приватной сборкой файлы — заглушки; версию ставит PKGBUILD, адрес Premium восстановлен из публичного релиза; приватные токены/прокси НЕ зашиваются. Это MVP, а не замена официальной сборки. Понимаю, что восстановление данных из релиза и заглушки мейнтейнеры захотят заменить своим пайплайном — это ожидаемо; MVP показывает, что код приложения на Linux работает минимальными правками. ### Альтернативные варианты - Ждать официального порта — но Linux-слой в репо уже есть, не хватало сборки. - Собирать только из публичного bol-van/zapret2 — тогда нет пресетов/блобов/ каталогов (они в приватной части), подбор и готовые пресеты не работают. - deb/AppImage из репо — тоже требуют приватный build-пайплайн. ### Дополнительный контекст / скриншоты Усилил безопасность root-helper'а (он запускает движок от root по аргументам из непривилегированного сокета): allowlist точных имён опций (обход через сокращения getopt), подтверждение путей блобов целиком (обход через ,/: в @-путях), перенос --hostlist-auto в root-папку (O_NOFOLLOW+fchown, symlink-гонка), запрет файл-опций без '='. Честно про известное ограничение (нужен ВТОРОЙ локальный пользователь из группы zapretgui): read-TOCTOU у --blob/--dpi-desync-fake-* — подмена пути на symlink после проверки даёт root-чтение чужого файла. --lua-init не эксплуатируется (droproot() до lua_init()). Полный фикс наметил (копирование файлов в root-папку), в MVP не делал. Оговорки: - 5–11 из 171 встроенных winws1-пресетов не проходят из-за ошибок в самих пресетах, не из-за движка. - Linux-набор тестов проходит (642 passed); реальный трафик/helper под root — на стороне пользователя. Готов приложить патч и инструкцию применения, если направление интересно. ### Проверка дубликатов - [x] Я проверил существующие задачи и не нашёл аналогичного запроса
Sign in to join this conversation.
No milestone
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set

Reference
zapretdiscordyoutube/zapretgui#153
No description provided.