v0.20.1

sleep3r/mtproto.zigv0.20.1Apr 25, 2026by sleep3r

Upgrading?

AI Summary

v0.20.1 includes critical fixes for the monitoring dashboard, including robust TOML parsing, GitHub-based UV installation, port conflict prevention, and the addition of the Grafana dashboard file.

Key Highlights

  • Fixed `[monitor]` section parsing in config.toml using a line-by-line parser.
  • Switched UV installation script to download directly from GitHub Releases.
  • Added port conflict guard for Nginx masking port (8443).
  • Added missing `mtproto-zig-grafana.json` file.

New Features

  • Resolve dashboard config parsing, UV installation, port conflicts, and Grafana dashboard

Full Release Notes

🇷🇺 Что нового (RU)

## Что решает этот релиз

Этот релиз содержит набор важных исправлений для дашборда и безопасности установки.

## Что изменено

- **Защита порта (#211)**: Инсталлятор и сам прокси теперь проверяют, чтобы порт прокси не совпадал с портом маскировки Nginx (`8443`). Это предотвращает тихие падения сервиса при неверной конфигурации.
- **Установка UV**: Скрипт установки менеджера пакетов `uv` (используется для дашборда) переведён с `astral.sh` на прямую загрузку из GitHub Releases. Это решает проблему недоступности `astral.sh` в некоторых регионах.
- **Парсинг конфига дашборда (#213)**: Исправлен баг, из-за которого секция `[monitor]` в `config.toml` могла игнорироваться, если она содержала незначительные отклонения от стандарта TOML (из-за молчаливого падения `tomllib`). Теперь используется надёжный построчный парсер, как и во всём остальном прокси.
- **Grafana Dashboard (#214)**: Добавлен недостающий файл `mtproto-zig-grafana.json`, на который ссылалась документация по Docker. Теперь можно сразу импортировать дашборд со всеми прокси-метриками.

Изменений в конфигурации не требуется.

--------
🇬🇧 Release notes (EN)

## What this release addresses

This release brings a set of important bugfixes for the monitoring dashboard and installation safety.

## What changed

- **Port Conflict Guard (#211)**: The installer and proxy runtime now actively prevent binding the proxy to the same port as the Nginx zero-RTT masking server (`8443`), avoiding silent service failures on misconfiguration.
- **UV Installation**: The `uv` package manager bootstrap script (used by the dashboard) now downloads directly from GitHub Releases instead of `astral.sh`, bypassing regional network blocks.
- **Dashboard Config Parsing (#213)**: Fixed a bug where the `[monitor]` section in `config.toml` could be completely ignored due to silent parsing failures in `tomllib`. It now uses a robust line-by-line parser consistent with the rest of the proxy codebase.
- **Grafana Dashboard (#214)**: Added the missing `mtproto-zig-grafana.json` file referenced in the Docker documentation, providing a ready-to-import Grafana dashboard with comprehensive metrics visualization.

No configuration changes required.

## Changelog

- fix: resolve dashboard config parsing, UV installation, port conflicts, and Grafana dashboard (#215)

Related Repositories