🇷🇺 Что нового (RU)
Что решает этот релиз
v0.21.3 - patch-релиз для installer/control-plane, который закрывает проблему из #236.
На Debian 12 установка через mtbuddy --interactive могла падать на шаге:
✖ nfqws build failed
А после ручной установки nfqws сервис mtproto-proxy мог уходить в restart loop с:
status=217/USER
Failed at step USER spawning /opt/mtproto-proxy/mtproto-proxy
Причин было две:
- текущий upstream
zapret/nfqлинкуется с-lnfnetlink, а installer не ставил явный пакетlibnfnetlink-dev; - systemd unit использует
User=mtprotoиGroup=mtproto, но installer создавал только пользователя и не гарантировал наличие одноимённой system group.
В v0.21.3 mtbuddy install стал строже и понятнее: нужная dependency ставится явно, вывод сборки zapret/nfq больше не скрывается, а service user/group создаются детерминированно.
[!NOTE]
Изменений вconfig.tomlне требуется.
[!TIP]
Если нужен быстрый bare install без OS-level TCP desync, можно использоватьsudo mtbuddy install --no-nfqws ...или--no-dpi. Но для обычной установки сnfqwsэтот релиз должен закрыть проблему на Debian 12.
Что изменено
Installer: фикс сборки nfqws (#237)
- В список build dependencies добавлен
libnfnetlink-dev, который нуженzapret/nfqдля-lnfnetlink. git cloneиmakeдляzapret/nfqбольше не глушат stderr/stdout.- При ошибке сборки
mtbuddyтеперь показывает хвост вывода команды, а не только общую строкуnfqws build failed. - После сборки дополнительно проверяется наличие
/opt/zapret/nfq/nfqws.
Installer: фикс systemd status=217/USER (#237)
- Installer явно создаёт system group
mtproto. - Service user теперь создаётся с
--gid mtprotoи home/opt/mtproto-proxy. chown,systemctl daemon-reload,systemctl enableиsystemctl restartстали strict-шагами: install больше не печатает ложный success, если сервис не стартовал.- При ошибке старта
mtbuddyпечатаетsystemctl status mtproto-proxy --no-pager -l.
Проверено
make testzig build -Dtarget=x86_64-linux -Doptimize=ReleaseFast- Debian 12 container: установка dependencies + сборка
zapret/nfqзавершиласьnfqws-ok
🇬🇧 Release notes (EN)
What this release addresses
v0.21.3 is an installer/control-plane patch release that fixes #236.
On Debian 12, installing through mtbuddy --interactive could fail at:
✖ nfqws build failed
After manually installing nfqws, mtproto-proxy could then enter a restart loop with:
status=217/USER
Failed at step USER spawning /opt/mtproto-proxy/mtproto-proxy
There were two root causes:
- current upstream
zapret/nfqlinks with-lnfnetlink, but the installer did not explicitly installlibnfnetlink-dev; - the systemd unit uses
User=mtprotoandGroup=mtproto, while the installer only created the user and did not guarantee the matching system group.
v0.21.3 makes mtbuddy install stricter and more diagnosable: the missing dependency is installed explicitly, zapret/nfq build output is no longer hidden, and service user/group creation is deterministic.
[!NOTE]
Noconfig.tomlchanges are required.
[!TIP]
For a quick bare install without OS-level TCP desync, usesudo mtbuddy install --no-nfqws ...or--no-dpi. For the normalnfqwspath, this release should fix the Debian 12 installer failure.
What changed
Installer: nfqws build fix (#237)
- Added the explicit
libnfnetlink-devbuild dependency required byzapret/nfqfor-lnfnetlink. git cloneandmakeforzapret/nfqno longer suppress stderr/stdout.- On build failure,
mtbuddynow prints the tail of command output instead of onlynfqws build failed. - The installer now verifies that
/opt/zapret/nfq/nfqwsexists after the build.
Installer: systemd status=217/USER fix (#237)
- The installer now explicitly creates the
mtprotosystem group. - The service user is created with
--gid mtprotoand home/opt/mtproto-proxy. chown,systemctl daemon-reload,systemctl enable, andsystemctl restartare now strict steps: install no longer prints a false success when the service fails.- On service startup failure,
mtbuddyprintssystemctl status mtproto-proxy --no-pager -l.
Verified
make testzig build -Dtarget=x86_64-linux -Doptimize=ReleaseFast- Debian 12 container: dependency install +
zapret/nfqbuild completed withnfqws-ok