mistgate Документация
RU
316

Статус и план развития

Что уже есть в релизах Mistgate, что проверяется сейчас, что будет дальше и что нужно для 1.0, а также известные ограничения текущего релиза.

На этой странице

Mistgate в бете; текущий релиз — v0.1.85. Он работает в продакшене, но до 1.0 API, хранимые настройки и протокол ноды ещё могут меняться. Остальная документация описывает только то, что код умеет сегодня, а планы собраны на этой странице. Сроков у планов нет: «Дальше» и «Позже» задают очерёдность, а не даты.

  1. Выпущено#

    v0.1.0 – v0.1.85

    Всё ниже уже в релизах и описано в документации. Сначала — что принёс текущий релиз, затем остальное по разделам админки.

    • Новое в текущем релизе#

      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 устройства с лимитом в трёх режимах, скорость на человека и на устройство; а группа решает ещё и то, на какие ноды ходят её люди.
      • Вкладка «Люди» с сортировкой по любому столбцу и счётчиком устройств и действия сразу над несколькими пользователями.
    • Подписки#

    • Здоровье#

      • Проверки глазами клиента: каждые 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, отслеживание соединений и открытые файлы агента.
    • Обновления#

    • Интеграции#

    • Настройки#

      • Админка, страница пользователя, страница установки ноды, сообщения в Telegram и эта документация на русском, английском и упрощённом китайском, админка и страница пользователя ещё и на персидском и турецком; вход по passkey или паролю с кодом из приложения-аутентификатора, по желанию Cloudflare Turnstile, журнал аудита. См. Безопасность.
      • Аудит кода (v0.1.84) проверил вход, подписки, связь с нодами, MCP и ассистента; найденные пробелы закрыты. См. Безопасность.
      • Сайт-ширма по адресу панели прячет админку от посторонних.
      • Зашифрованные бэкапы в Cloudflare R2 по расписанию, со сроком хранения, или в файл на компьютере владельца; восстановление в панели или установщиком на новом сервере.
      • Журнал панели, сроки хранения, экспорт и метрики для владельца и по желанию анимация появления (Бета).
  2. Сейчас#

    v0.1.34 – v0.1.81

    Новое из последних релизов проходит проверку в боевой работе; по её итогам выходят исправления и уточняется документация.

    • 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. Прочитайте перечисленные доказательства, прежде чем переносить людей. См. Ассистент.

  3. Дальше#

    Следующее по очереди.

    • Клиент 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 облачного сервера, с готовыми примерами для популярных облаков.

  4. Позже#

    В плане, но не в ближайшей очереди.

    • Списки маршрутизации от сообщества#

      Готовые наборы правил, которые ведёт сообщество (для России: полный список местных сайтов «напрямую» и режим для мобильных белых списков), обновляются сами.

    • Любая категория geosite и geoip в правиле сплита#

      Редактор правила подсказывает все категории списков, а не только страны.

    • Выбор ядра протокола для ноды#

      Ядра протоколов (Xray, Hysteria2) встроены в агент ноды, поэтому сейчас нода работает на том ядре, с которым собран её агент. Если ядро когда-нибудь изменится так, что старые приложения не смогут подключаться, а на сервере это не обойти, панель предложит две сборки агента — со старым ядром и с новым — и выбор сборки для каждой ноды, с той же подписанной раскаткой и откатом. До тех пор новое ядро выходит с совместимостью, нужной старым клиентам.

    • Больше протоколов#

      Кандидаты: TUIC, NaiveProxy и MASQUE. Каждый подключается к той же ссылке подписки через контракт протокола.

    • Telegram-бот сверх алертов#

      Сейчас бот только присылает алерты и привязывает чат админа. Позже — работа с флотом из Telegram и бот для пользователей. См. Алерты в Telegram.

    • Зеркала подписки#

      Копии подписки по другим адресам, чтобы приложения получали её, даже когда адрес панели недоступен.

    • Общая карта блокировок#

      Панели, владельцы которых сами это включили, отправляют короткие анонимные сообщения о сбоях (страна, крупный оператор, тип протокола, что именно не работает), а проект раз в неделю публикует открытые сводки, которые может зеркалить кто угодно. Адреса, имена, порты и люди панель не покидают; сводки показывают только сбои и помечены как непроверенные. По умолчанию выключено. Пока не делаем: сначала появится локальный предпросмотр того, что было бы отправлено.

    • Переезд между VPS и Cloudflare-версией#

      Перенос пользователей, нод и ссылок подписок в обе стороны, так чтобы ссылки продолжали работать. Пока для другой версии флот собирается заново. См. Переезд.

    • Cloudflare-версия на настоящем аккаунте#

      Предварительная

      Первый запуск mistgate edge deploy на настоящем аккаунте Cloudflare: шесть Workers, маршрутизатор с доменом и --rollback. Пока команда и панель проверены только на имитации Cloudflare. См. Установку Cloudflare-версии.

  5. Путь к 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 панели и не переходят на летнее время сами: при смене местного времени задайте смещение снова.

Править страницу на GitHub