Статус и план развития
Что уже есть в релизах Mistgate, что проверяется сейчас, что будет дальше и что нужно для 1.0, а также известные ограничения текущего релиза.
На этой странице
Mistgate в бете; текущий релиз — v0.1.85. Он работает в продакшене, но до 1.0 API, хранимые настройки и протокол ноды ещё могут меняться. Остальная документация описывает только то, что код умеет сегодня, а планы собраны на этой странице. Сроков у планов нет: «Дальше» и «Позже» задают очерёдность, а не даты.
Выпущено#
Всё ниже уже в релизах и описано в документации. Сначала — что принёс текущий релиз, затем остальное по разделам админки.
Новое в текущем релизе#
v0.1.85- Страница «Обновления» в три слоя и состояние ОС серверов. Сверху три карточки: Эта панель, Агенты нод и Система серверов. Новый слой только читает: дистрибутив, ядро, ожидающие и защитные обновления, нужна ли перезагрузка и собран ли модуль AmneziaWG под новое ядро; ставить обновления и перезагружать из панели пока нельзя. Нужен агент v0.1.85. См. Операционная система серверов.
- Докачка обновления сразу занимает слот. Когда связь ноды с панелью зависала, продолжение загрузки ждало и отклонялось, и на плохом канале терялись минуты окна. Теперь продолжение того же файла занимает слот ноды сразу. См. Откуда берётся пакет.
- GitHub как запасной источник обновления. Нода может докачать обновление из нескольких источников по очереди; панель предлагает GitHub вторым, если выпуск там подписан её ключом и содержит те же файлы. Включено по умолчанию, выключается в Настройки → Система → Источники загрузки; GitHub видит адреса нод. Нужен агент v0.1.85. См. Источники загрузки.
- Часовой лимит изменений людей для API-токенов. Токен без владельца может отнять доступ или переписать не больше 10 человек в час, так что утёкший токен не отключит всех сразу; создание, продление и включение людей в счёт не идут. Владелец снимает лимит переключателем на токене; существующие токены после обновления ограничены. См. Ограничения.
- Порты ноды из туннеля. Клиент с полным туннелем AmneziaWG теперь достаёт остальные опубликованные входы той же ноды (Telegram-прокси, VLESS и Hysteria2 на других портах), а не только TCP 443. Нужен агент v0.1.85. См. Устранение неполадок.
- Подготовка к собственному приложению Mistgate. В панели появился API клиента: переключатель владельца, подключение устройства по ключу, синхронизация и отключение. Он выключен по умолчанию, а для существующих приложений ничего не меняется.
- Безопасность: без Multipath TCP на наших портах (v0.1.83). Go по умолчанию открывает каждый слушающий порт с MPTCP, а через MPTCP-порт показан удалённый root по CVE-2026-98432 — ошибке в TCP ядра Linux (CVSS 9.8). Панель и агент ноды вместе с портами Xray теперь открывают обычный TCP; обновите панель и ноды. Сама ошибка в ядре: выключите ещё
net.mptcp.enabled=0и поставьте исправленное ядро вашего дистрибутива, когда оно выйдет. См. Поиск неполадок.
Профили#
- Hysteria2 на официальном ядре с Salamander.
- AmneziaWG 2.0 и 3.1 в userspace или модулем ядра, несколько профилей на ноду.
- VLESS на xray-core: REALITY по XHTTP или TCP (RAW + Vision), в роли цели — собственный сайт ноды или чужой сайт; TLS по XHTTP или WebSocket, напрямую или за CDN.
- Hysteria2 и VLESS на одной ноде, в том числе на TCP 443.
- MTProto, экспериментально: прокси для приложения Telegram с Fake TLS, один ключ на человека.
Ноды#
- Установка по SSH из админки и через MCP с одобрением владельца: закреплённый host key, проверки до любых изменений, задания, которые можно отменить, повторить и продолжить после обрыва.
- Подключение ноды командой:
mistgate-node enrollобъясняет отказ в TLS-рукопожатии (перед панелью CDN или обратный прокси) и называет флаги, которые это исправляют. - Сохранённый SSH-доступ, зашифрованный, с проверенной сменой пароля; собственный SSH-ключ панели,
authorized_keysсервера из карточки ноды и доступ к нодам, поставленным командой. - Выход через WARP, который закрывается, если связь с WARP пропала, и защита от торрентов на каждой ноде.
- Проверить порты: доставка UDP и TCP-соединение до каждого порта ноды с другой ноды флота.
- Замер пропускной способности канала ноды.
- Сайт-ширма для каждой ноды: встроенный, сайт панели или свой архив.
- Ретрансляции через ноду-вход: проверка до включения, наблюдение каждые 5 минут, копия сервера в подписке; серверы AmneziaWG тоже, со своим ключом для пути через вход.
- Вход по IPv6: серверы ноды на одном из её IPv6-адресов, с проверкой снаружи до включения.
- Ресурсы и нагрузка: сколько серверу стоят нода и сам Mistgate, вид Нагрузка с запасом на новых людей, отладочная запись одной ноды, карта флота и «Входы» в виде графа.
Пользователи#
- Пользователи и группы: квоты трафика с периодами, сроки, устройства по ID устройства с лимитом в трёх режимах, скорость на человека и на устройство; а группа решает ещё и то, на какие ноды ходят её люди.
- Вкладка «Люди» с сортировкой по любому столбцу и счётчиком устройств и действия сразу над несколькими пользователями.
Подписки#
- Одна ссылка подписки на человека: список ссылок для Happ и похожих приложений, Mihomo YAML для приложений на ядре mihomo, Xray JSON и sing-box JSON для приложений на этих ядрах.
- Лимит устройств для приложений по ссылке в режимах Только считать, Ограничивать и Строго.
- Страница пользователя: инструкции по платформам, QR-коды, ключи
vpn://для AmneziaVPN и свои устройства, которые человек может переименовать и удалить, с кнопкой копирования ссылки. - DNS-пресеты, в том числе со списками страны для «напрямую» (Китай: китайские сайты напрямую), и с блокировкой рекламы в приложениях; на странице пользователя — выбор DNS для приложений по ссылке и по серверам для ключей.
- Автоматический выбор сервера: группа Auto в профилях Mihomo и sing-box и конфигурация
Autoв Xray JSON, с которыми приложение само переходит на рабочий сервер.
Здоровье#
- Проверки глазами клиента: каждые 5 минут панель подключается к серверам так же, как приложение, в том числе по VLESS (REALITY и TLS, напрямую или через CDN).
- Счётчики соединений с нод: подключения, обрывы сразу после подключения, отклонённые ключи, незавершённые рукопожатия, время онлайн и неизвестные ключи — по устройствам на странице человека, когда протокол позволяет их определить, и по профилям на ноде. Событийные счётчики Hysteria2 и AmneziaWG, а также время сессий VLESS и, с агентом от v0.1.79, неизвестные ключи; для Hysteria2 ещё и то, как кончилось соединение (зависший путь, затихший клиент, закрытие), задержка и потери; только числа, хранятся 7 дней (168 часов).
- Журнал ноды: предупреждения и ошибки агента и движков каждой ноды за 7 дней, без адресов клиентов, для любого админа и в MCP.
- Доктор ноды: проверки хоста и безопасные исправления, среди них Обновить службу: она переписывает systemd-юнит агента прямо из админки, предупреждение, когда на сервере выключены автоматические обновления безопасности, и исправление Включить обновления безопасности на Debian и Ubuntu.
- Доступность — отдельный раздел с неделей каждой ноды: пробы внутри России через Globalping, добровольные пробы cheburcheck и мобильные SIM-пробы bsbord (включая Крым, с месячным лимитом), списки блокировок antifilter, ТСПУ-зонд с вашей ноды в России и отчёты пользователей kl!ck из их собственных сетей, каждый источник включается отдельно и по умолчанию выключен; алерт, когда нода недоступна из страны; каждая нода измеряется и по своему IPv6-адресу, если IPv6 у неё работает.
- Отклик через открытый туннель и время подключения отдельно, а также уведомление, когда хост панели теряет UDP.
- Алерты в админке и в Telegram.
- Наблюдатель панели: Cloudflare Worker раз в минуту проверяет панель и пишет в Telegram, если она не отвечает.
- Закрытие алерта, пока проблема не прошла, и 21 проверка доктора, среди них CPU steal, отслеживание соединений и открытые файлы агента.
Обновления#
- Что нового: заметки к релизам между вашей версией и доступной, на языке интерфейса.
- Подписанные обновления агентов нод по одной ноде, сейчас или по расписанию, с проверкой здоровья и автоматическим откатом.
- Самообновление панели из подписанных релизов GitHub с откатом, если новая панель не удержалась.
- Каналы релизов (стабильный, тестовый, разработка) для панели и её нод и бэкап перед самообновлением панели.
- Установка панели одной командой с проверкой подписи релиза.
- Воспроизводимые релизы, подписанные офлайн из тега.
- Окно загрузки для медленных каналов, 30 минут по умолчанию, и прогресс загрузки каждой ноды в раскатке.
Интеграции#
- API-токены с профилями readonly, operator и admin.
- MCP-сервер со схемой «план → применить» и одобрением владельца, теперь с изменениями на каждый день, чтениями одним вызовом, пробами между вашими нодами, диагностикой и задачами по расписанию; готовые промпты — в инструкции для AI-агента.
- Алерты в Telegram админам, которые привязали чат: здоровье, новые версии, сбои бэкапа, планы на одобрение, безопасность входа.
- Ассистент: чат с облачной моделью, который готовит изменения карточками, с возвратами по таймеру и задачами по расписанию.
Настройки#
- Админка, страница пользователя, страница установки ноды, сообщения в Telegram и эта документация на русском, английском и упрощённом китайском, админка и страница пользователя ещё и на персидском и турецком; вход по passkey или паролю с кодом из приложения-аутентификатора, по желанию Cloudflare Turnstile, журнал аудита. См. Безопасность.
- Аудит кода (v0.1.84) проверил вход, подписки, связь с нодами, MCP и ассистента; найденные пробелы закрыты. См. Безопасность.
- Сайт-ширма по адресу панели прячет админку от посторонних.
- Зашифрованные бэкапы в Cloudflare R2 по расписанию, со сроком хранения, или в файл на компьютере владельца; восстановление в панели или установщиком на новом сервере.
- Журнал панели, сроки хранения, экспорт и метрики для владельца и по желанию анимация появления (Бета).
Сейчас#
Новое из последних релизов проходит проверку в боевой работе; по её итогам выходят исправления и уточняется документация.
VLESS в боевой работе#
REALITY — с v0.1.34, собственный сайт ноды в роли цели — с v0.1.35, TLS и CDN — с v0.1.36. За настоящим CDN VLESS ещё не проверялся: в сквозном тесте роль CDN играет сама нода. См. VLESS за CDN.
Устройства по ID устройства в боевой работе#
Уже существующие панели работают в режиме Только считать, поэтому вы видите, кто превысил лимит, до того как включите Ограничивать. См. Как перейти с «Только считать» на «Ограничивать».
Xray JSON и sing-box JSON в боевой работе#
По умолчанию Xray JSON не отдаёт ни одно правило: добавьте его для нужных приложений или сначала попробуйте приложение, дописав
?format=xray-jsonк его ссылке. См. Кому что отдавать.Сайт-ширма на каждой ноде#
Встроенный сайт, сайт панели или свой архив для каждой ноды. Ноды, созданные до v0.1.36, остаются на встроенной странице, пока вы не выберете другой вариант. См. Свой сайт-ширма.
Проверка из страны в боевой работе#
Все источники по умолчанию выключены. Включите один из них и посмотрите на колонку Из России, прежде чем полагаться на его алерт: пробы Globalping не принадлежат панели, а
listed(«в реестре») — отметка реестра, а не измерение. См. Доступность.Ретрансляции в боевой работе#
Новое в v0.1.65. Панель проверяет ретрансляцию снаружи страны, поэтому зависание, которое видят только люди внутри, заметно в отчётах kl!ck и в bsbord, а не в проверке самой панели. См. Ретрансляции.
Вход по IPv6 в боевой работе#
Новое в v0.1.66, карточка в админке — с v0.1.67. Только на ноде, у которой IPv6 у хостера работает. Проходят ли по нему люди изнутри страны, первым покажут отчёты kl!ck. См. Вход по IPv6.
Блокировка рекламы на устройстве в боевой работе#
Новое в v0.1.67. Happ берёт список из своих geo-файлов, по умолчанию от Loyalsoldier, где около 195 000 доменов: на iPhone проверьте, что Happ работает с этим пресетом, прежде чем давать его многим. См. Реклама и трекеры.
Исправление «Обновления безопасности» в боевой работе#
Новое в v0.1.67. Оно ставит пакет на сервер: сначала примените его на одной ноде и посмотрите итог доктора там, потом на остальных. См. Исправления.
Ноды для группы в боевой работе#
Новое в v0.1.68. Отключение ноды у группы сразу убирает её у всех в группе, даже у человека, у которого эта нода отмечена в его карточке: профиль на ней перестаёт ему приходить. См. Пользователи и группы.
MTProto в боевой работе#
Новое в v0.1.69, экспериментально. На настоящих блокировках его ещё не проверяли: сначала дайте ссылку одному-двум людям и убедитесь, что Telegram подключается из их сетей, и только потом раздавайте широко. См. MTProto.
Ассистент в боевой работе#
Новое в v0.1.81. Он отправляет выбранному провайдеру разговор и то, что прочитали его инструменты, поэтому прежде чем подключать провайдера, прочитайте, куда уходят его данные, и задайте месячный бюджет. Начните с Только я в Кто может пользоваться и перечитывайте формулировку карточки плана, прежде чем нажать Применить. См. Провайдеры и куда уходят данные.
Диагностика блокировок в боевой работе#
Новое в v0.1.81.
block_diagnosisиaccess_reportприменяют фиксированные правила к счётчикам нод и проверкам из страны; где две причины выглядят одинаково, они так и говорят, с низкой уверенностью. Стенд с устроенными блокировками перед каждым релизом, затрагивающим диагностику, проверяет семь классов (адрес, порт, UDP, заморозка TCP, белый список, один оператор, сломанная нода); распознанный протокол и регион проверены только на составленных счётчиках. Счётчикам рукопожатий нужен агент v0.1.81. Прочитайте перечисленные доказательства, прежде чем переносить людей. См. Ассистент.
Дальше#
Следующее по очереди.
Клиент Mistgate#
Собственное приложение для компьютера, сначала для Windows. Оно общается с панелью напрямую, а не только по ссылке подписки, само говорит на Hysteria2 и AmneziaWG, содержит встроенные детекторы ТСПУ и других блокировок и с согласия человека отправляет в панель отладочные отчёты. Панельная часть готова и выключена по умолчанию: владелец включает её в Подписки → Кому что отдавать, и приложение сможет подключать устройство по ключу и получать серверы напрямую; для существующих приложений ничего не меняется. Само приложение ещё не выпущено, а пока люди подключаются существующими приложениями: см. Приложения-клиенты.
Операционная система серверов из панели#
В следующем релизе панель ставит обновления безопасности на одну ноду и перезагружает её с вашего подтверждения: нода проверяет, что перезагрузка безопасна, панель ждёт её возвращения и проверяет профили, а сбой останавливает обновление и открывает алерт. Следом идут несколько нод сразу с канарейкой, окно по времени и сервер самой панели. Обновление списков пакетов пока только кнопка владельца в админке: API-токенам и MCP оно недоступно. См. Обновление системы одного сервера.
Раздача обновления с другой ноды#
Нода с плохой связью с панелью получает файл обновления от соседней ноды флота, которая его уже скачала. Сейчас запасной источник один — GitHub. См. Источники загрузки.
Из какого оператора пришло подключение#
Сеть (ASN) каждого подключения по часам, но не адрес: сводка по операторам, включена по умолчанию, и режим по людям, выключен по умолчанию; оба хранятся 7 дней. Диагностика сможет различать операторов. Сейчас панель узнаёт операторов только из проб проверки страны и отчётов пользователей kl!ck. См. Ассистент.
Новый IPv6-адрес одной кнопкой#
Вход по IPv6 и проверки доступности по IPv6 есть в релизах начиная с v0.1.65. Агент ноды уже держит дополнительный адрес на внешнем интерфейсе сервера; не хватает половины панели: заменить адрес входа новым из собственной сети /64 сервера одной кнопкой. См. Вход по IPv6.
Релей сам выбирает лучший выход#
Сейчас релей пересылает на один выходной сервер, а приложение выбирает между целыми путями (напрямую или через каждый релей) группой Auto. Дальше у релея появится группа выходов, и панель будет переводить его на тот, с которым связь лучше, по потерям и задержке, которые она уже измеряет между нодами: не чаще заданного интервала, с причиной и историей на странице релея и с ручным закреплением. См. Ретрансляции. Запрошено в #47.
Где ваши люди#
Регион при первой настройке и в настройках: DNS-пресеты, списки «напрямую», рекомендованные приложения и проверки доступности следуют за выбранными странами. Части для Китая уже есть («китайские сайты напрямую» с v0.1.64; AliDNS, DNSPod и проверка Baidu в докторе ноды с v0.1.78); самой настройки региона нет.
Заглушки, похожие на обычный домашний сервис#
Встроенные сайты-заглушки в виде статус-страницы, файлообменника или страницы входа в сервис, у каждой установки свои, вплоть до ответов 404, 429 и robots.txt, чтобы сканер не мог их опознать; вход там всегда неудачен и ничего не сохраняет.
Cloudflare-версия наравне с VPS#
Перенести в версию из шести Workers то, чего там пока нет:
- зашифрованные бэкапы и восстановление;
- MCP, ассистент, задачи по расписанию и выпуск новых API-токенов;
- пробы, отладочная запись, журнал панели и вид «Нагрузка»;
- проверки туннелей глазами клиента;
- обновление панели из админки;
- живой лог ноды и «Свой сайт» как сайт-ширму ноды.
Установка через cloud-init#
Установка панели и ноды без вопросов из user-data облачного сервера, с готовыми примерами для популярных облаков.
Позже#
В плане, но не в ближайшей очереди.
Списки маршрутизации от сообщества#
Готовые наборы правил, которые ведёт сообщество (для России: полный список местных сайтов «напрямую» и режим для мобильных белых списков), обновляются сами.
Любая категория geosite и geoip в правиле сплита#
Редактор правила подсказывает все категории списков, а не только страны.
Выбор ядра протокола для ноды#
Ядра протоколов (Xray, Hysteria2) встроены в агент ноды, поэтому сейчас нода работает на том ядре, с которым собран её агент. Если ядро когда-нибудь изменится так, что старые приложения не смогут подключаться, а на сервере это не обойти, панель предложит две сборки агента — со старым ядром и с новым — и выбор сборки для каждой ноды, с той же подписанной раскаткой и откатом. До тех пор новое ядро выходит с совместимостью, нужной старым клиентам.
Больше протоколов#
Кандидаты: TUIC, NaiveProxy и MASQUE. Каждый подключается к той же ссылке подписки через контракт протокола.
Telegram-бот сверх алертов#
Сейчас бот только присылает алерты и привязывает чат админа. Позже — работа с флотом из Telegram и бот для пользователей. См. Алерты в Telegram.
Зеркала подписки#
Копии подписки по другим адресам, чтобы приложения получали её, даже когда адрес панели недоступен.
Общая карта блокировок#
Панели, владельцы которых сами это включили, отправляют короткие анонимные сообщения о сбоях (страна, крупный оператор, тип протокола, что именно не работает), а проект раз в неделю публикует открытые сводки, которые может зеркалить кто угодно. Адреса, имена, порты и люди панель не покидают; сводки показывают только сбои и помечены как непроверенные. По умолчанию выключено. Пока не делаем: сначала появится локальный предпросмотр того, что было бы отправлено.
Переезд между VPS и Cloudflare-версией#
Перенос пользователей, нод и ссылок подписок в обе стороны, так чтобы ссылки продолжали работать. Пока для другой версии флот собирается заново. См. Переезд.
Cloudflare-версия на настоящем аккаунте#
ПредварительнаяПервый запуск
mistgate edge deployна настоящем аккаунте Cloudflare: шесть Workers, маршрутизатор с доменом и--rollback. Пока команда и панель проверены только на имитации Cloudflare. См. Установку Cloudflare-версии.
Путь к 1.0#
Условия, после которых выйдет 1.0. До этого возможны несовместимые изменения.
Протокол ноды и хранимые настройки зафиксированы#
Панель и агенты разных версий 1.x понимают друг друга, а данные панели переходят с версии на версию без ручных шагов.
Обновление со старых версий проверяется тестами#
Каждый релиз проходит автотест обновления с прежних версий: панель со своими данными и подключённые к ней ноды.
Стабильный API#
API, API-токены и инструменты MCP без несовместимых изменений в пределах 1.x. См. API и MCP.
Известные ограничения#
- Проверка «глазами клиента» пропускает VLESS, если агент ноды не сообщает нужную возможность. В агентах до v0.1.34 нет движка VLESS; для профилей TLS также нужна возможность
vless-tls/1(v0.1.36 или новее). - Проверить порты смотрит из одной точки — с другой ноды флота или с хоста панели. На портах VLESS она делает TLS-рукопожатие с ожидаемым именем, но не рукопожатие REALITY.
- Установка по SSH входит собственным ключом панели, паролем или один раз собственным закрытым ключом владельца, а карточка ноды управляет
authorized_keys. Закрытия входа по паролю в sshd и смены ключа панели пока нет. См. Установка ноды по SSH. - Бэкапы идут в Cloudflare R2 или в файл на компьютере владельца. Восстановление есть в версии для VPS (в панели и в установщике); облачная редакция хранит данные в D1 и восстановления пока не умеет.
- Панель не создаёт аккаунт Cloudflare, бакет или токен: вы даёте токен на один бакет с правами на чтение, запись и удаление.
- Cloudflare-версия предварительная, на настоящем аккаунте Cloudflare её ещё не пробовали: часть возможностей в ней пока недоступна (см. список), а перенести флот между ней и панелью на VPS нельзя.
- ID устройства — это то, что сообщает приложение. Блокировка запрещает этот ID; приложение, которое сообщит другой ID, станет новым устройством и займёт свободное место. Чтобы отрезать ссылку, которую передали дальше, выдайте и новую ссылку.
- Скорость на человека считается на каждой ноде отдельно, поэтому у человека на двух нодах сразу она может быть вдвое выше лимита. Агенты нод до v0.1.39 держат каждое устройство в меньшем из двух лимитов.
- В Cloudflare-версии сводка того, что отправлено на ноду, должна умещаться в одну строку D1 (2 МБ): это около 38 тысяч учётных данных на ноду. См. ограничения этой версии.
- В sing-box JSON нет XHTTP, и он не умеет сверять самоподписанный сертификат Hysteria2 по отпечатку; Gecko и AmneziaWG уходят только в Mihomo YAML. Сервер, который формат нести не может, в этом формате отсутствует. См. Что где работает.
- Проверка из страны смотрит с нескольких проб, а не из каждой сети, а списки блокировок охватывают только Россию.
listed(«в реестре») значит, что адрес есть в реестре, а не что его трафик режут. - Часть настроек по умолчанию зависит от страны (Яндекс DNS для России, AliDNS и DNSPod для Китая, контрольные домены доктора, пресеты split-DNS); всё это меняется в настройках.
- Ассистент отправляет подключённому облачному провайдеру разговор, свои инструкции, ваши заметки и то, что прочитали его инструменты, поэтому действует политика данных этого провайдера. Введённые вами цены дают оценку, и месячный бюджет считается по ней. См. Провайдеры и куда уходят данные.
- Ассистент, MCP, задачи по расписанию, пробы, замер скорости, отладочная запись, журнал панели, ресурсы панели и вид «Нагрузка» есть только в версии для VPS. См. список.
- Диагностика не лучше счётчиков. У VLESS нет счётчика попыток, а ядерный бэкенд AmneziaWG не отличает запрос рукопожатия от ответа; где две причины выглядят одинаково,
block_diagnosisтак и говорит, с низкой уверенностью. Агенты старше v0.1.81 не считают, почему рукопожатия не проходят и чего не хватает машине ноды: панель пишет «неизвестно». - Задачи по расписанию идут по фиксированному смещению UTC панели и не переходят на летнее время сами: при смене местного времени задайте смещение снова.