Home

Mistgate documentation · Документация Mistgate

Mistgate is a self-hosted panel for your own VPN fleet: one binary for the panel, one for the node agent, Hysteria2 and AmneziaWG in one subscription.

Mistgate — панель для собственного VPN-флота: один бинарь для панели, один для агента ноды, Hysteria2 и AmneziaWG в одной подписке.

English: Start page · Русский: Начальная страница

Website: mistgate.app · Repository: Mistgate/mistgate · Сайт: mistgate.app/ru/

English

• Mistgate documentation: What is in the documentation, where to find it, and the order to read it in.

Getting started

• Overview: What Mistgate is and is not, who it is for, and how its parts fit together.
• Requirements: What the panel server, the node servers and the build machine need, and what the agent changes on a node.
• Install the panel: Download or build Mistgate, prepare the panel with mistgate setup, run it under systemd and sign in for the first time.
• Install the Cloudflare edition: Run the panel on Cloudflare Workers instead of a server with mistgate edge deploy: what you need, the API token, the key file you must back up, the first sign-in and what is not available yet. A preview.
• Add a node: Choose between the SSH installation and the manual install, enroll a server with a one-time command, watch it come online, and remove it cleanly later.
• Install a node over SSH: Let the panel install the node agent on a fresh server over SSH, follow, cancel and retry install jobs, and manage the saved SSH access.
• AI agent guide: Three ready prompts; install the panel with a shell-capable agent, add nodes and run the fleet through MCP, and contribute to the code with a coding agent.
• First users: The shortest path from a panel with one connected node to a person with a working connection.

Guide

• Nodes: What the Nodes list and a node's page show, what each status means, and how to change, restart or retire a node.
• Profiles: What a profile is, how the editor works, how a profile is put on nodes with its port and certificate, and which changes break existing users.
• Hysteria2: Every Hysteria2 setting in the profile editor, how the node handles the traffic, and what the apps receive and need.
• VLESS REALITY: The VLESS profile with REALITY on TCP: when to choose it over Hysteria2, every setting, the node's own site or another site as the REALITY target, ports, and what the apps receive and need.
• VLESS and Hysteria2 on one node: Where Hysteria2 and VLESS listen on a shared node, what happens when both want TCP 443, how Let's Encrypt renewal depends on it, and how to try VLESS with a few people first.
• AmneziaWG: AmneziaWG 3.1 and 2.0 profiles, their parameters and mimicry looks, the userspace and kernel backends of a node, and the per-device keys people import into AmneziaVPN.
• WARP: How to send a profile's traffic out through Cloudflare WARP, how to get an account for a node, what fail-closed means, and how to read and fix the WARP link.
• Users and groups: How to create and manage users (limits, term, traffic, devices, access), what a group gives, and how to move people between groups.
• Subscriptions: One link per person for every app: which format each app gets and how the panel decides, how servers are named, what the apps show, and the settings of the subscription.
• Client apps: Which app to recommend on each platform, what each one receives from the subscription, the one-tap add links and their fallbacks, and how to set the apps up in the admin and through MCP. kl!ck is the desktop app Mistgate recommends.
• User page: What a person sees when they open their link in a browser, how the page password works, and how the admin previews the page.
• DNS: What a DNS preset is, how split DNS works, which preset applies to a person, DNS per server, how each app receives it, and when a change reaches people.
• Torrent protection: The per-node BitTorrent blocker, what it recognises, how it blocks on AmneziaWG and Hysteria2, what its events show and what it cannot catch.
• Your own decoy site: Why to replace the built-in decoy page with a small site of your own, what a good one looks like, how to install it with --decoy-dir, and a ready prompt that has an AI agent invent a unique site.

Operations

• Health: How the panel checks every profile as a real client, what the node doctor looks at and can fix, and how alerts open, close and stay quiet.
• Telegram alerts: Send the panel's alerts to Telegram. Set up the bot with BotFather, link your chat, what is sent and to whom, and use the panel watcher for outage alerts.
• Panel watcher: Use a Cloudflare Worker to check the panel once a minute and send Telegram alerts when it stops answering and recovers.
• Updates: How node agents update themselves from signed bundles, how to update a node now or on a schedule, what protects an update, and how the panel updates itself.
• Releases and signing: For maintainers and for anyone who builds Mistgate with a key of their own; the release key, reproducible builds, signing and publishing a release, a bundle of your own, and rotating the key.
• Encrypted panel backups: Configure Cloudflare R2 backups, keep the recovery identity offline, and restore a panel into a fresh data directory.
• Security: Who can do what in the admin, how sign-in, step-up and sessions work, how the panel hides behind a decoy site, what the data directory holds and how to get back in.
• Troubleshooting: Common problems by symptom, how each one shows in the panel, and what to do about it.

Roadmap

• Status and roadmap: What Mistgate does in the current release, what is being tested now, what comes next, and the known limits.

Reference

• Command line: Every command of mistgate and mistgate-node, with its flags, environment variables, defaults and examples.
• Configuration: Every flag of mistgate serve and mistgate setup with its environment variable and default, the other configurable commands, the node agent's flags, and the data directory layout.
• Admin API: The Connect-RPC API behind the admin, how to call it with curl or a generated client, API tokens and their profiles, and what a token may and may not do.
• MCP server: The panel's built-in MCP server for AI agents, how to connect a client, every tool, the plan and apply flow, and which changes wait for the owner.
• Architecture: The components of Mistgate, how the panel and the node agents talk, where the data lives, and what each part can and cannot do if it falls into the wrong hands.
• FAQ: Short answers to common questions about Mistgate: Docker, memory, apps, size, IPv6, Cloudflare, migration, the license and where to report problems.
• Comparison with other panels: How Mistgate compares with 3x-ui, Marzban, PasarGuard, Remnawave, Hiddify Manager and s-ui, where the others are ahead, and the sources, as checked on 2026-10-09.
• Benchmarks: Memory, CPU, disk, start time and subscription load of Mistgate, 3x-ui, Remnawave and PasarGuard on the same small server, and a one-server test with the VPN core and Hysteria2 traffic. Method, versions and limits included.

Русский

• Документация Mistgate: Что есть в документации, где это искать и в каком порядке читать.

Начало работы

• Обзор: Что такое Mistgate и чем он не является, для кого он и как связаны его части.
• Требования: Что нужно серверу панели, серверам нод и машине для сборки, и что агент меняет на ноде.
• Установка панели: Как скачать или собрать Mistgate, подготовить панель командой mistgate setup, запустить её под systemd и войти в первый раз.
• Установка Cloudflare-версии: Как запустить панель на Cloudflare Workers вместо сервера командой mistgate edge deploy: что нужно, API-токен, файл с ключами, который обязательно сохранить, первый вход и что пока недоступно. Предварительная версия.
• Добавление ноды: Как выбрать между установкой по SSH и ручной установкой, подключить сервер одноразовой командой, дождаться, пока он выйдет на связь, и потом аккуратно его убрать.
• Установка ноды по SSH: Как панель сама ставит агента ноды на новый сервер по SSH, как следить за заданиями установки, отменять и повторять их и как устроен сохранённый SSH-доступ.
• Инструкция для AI-агента: Три готовых промпта; установить панель с агентом, который умеет выполнять команды, подключать ноды и вести флот через MCP и дорабатывать код с coding-агентом.
• Первые пользователи: Самый короткий путь от панели с одной подключённой нодой до человека с рабочим подключением.

Руководство

• Ноды: Что показывают список нод и страница ноды, что значит каждый статус и как изменить, перезапустить или вывести ноду из флота.
• Профили: Что такое профиль, как устроен редактор, как профиль ставится на ноды со своим портом и сертификатом и какие изменения ломают уже выданное.
• Hysteria2: Все настройки Hysteria2 в редакторе профиля, как нода обращается с трафиком и что получают и что требуют приложения.
• VLESS REALITY: Профиль VLESS с REALITY поверх TCP: когда выбирать его вместо Hysteria2, все настройки, как выбрать цель REALITY, порты и что получают и что требуют приложения.
• VLESS и Hysteria2 на одной ноде: Где слушают Hysteria2 и VLESS на общей ноде, что происходит, когда обоим нужен TCP 443, как от этого зависит продление Let's Encrypt и как сначала попробовать VLESS на нескольких людях.
• AmneziaWG: Профили AmneziaWG 3.1 и 2.0, их параметры и виды маскировки, бэкенды ноды (userspace и модуль ядра) и ключи на каждое устройство, которые люди импортируют в AmneziaVPN.
• WARP: Как выпустить трафик профиля через Cloudflare WARP, как получить аккаунт для ноды, что значит «закрыто при сбое» и как читать и чинить связь WARP.
• Пользователи и группы: Как создавать пользователей и управлять ими (лимиты, срок, трафик, устройства, доступ), что даёт группа и как переводить людей между группами.
• Подписки: Одна ссылка на человека для всех приложений: какой формат получает каждое приложение и как панель это решает, как называются серверы, что показывают приложения и какие у подписки настройки.
• Приложения-клиенты: Какое приложение рекомендовать на какой платформе, что получает каждое из подписки, ссылки «добавить в одно касание» и что делать, если они не сработали, как настроить приложения в админке и через MCP. kl!ck — десктопное приложение, которое рекомендует Mistgate.
• Страница пользователя: Что видит человек, когда открывает свою ссылку в браузере, как работает пароль страницы и как админ смотрит предпросмотр страницы.
• DNS: Что такое DNS-пресет, как работает раздельный DNS (сплит), какой пресет действует у человека, DNS по серверам, как его получает каждое приложение и когда изменения доходят до людей.
• Защита от торрентов: Блокировка BitTorrent на отдельной ноде — что она распознаёт, как блокирует на AmneziaWG и Hysteria2, что показывают её события и чего она поймать не может.
• Свой сайт-ширма: Зачем заменить встроенную страницу-ширму своим небольшим сайтом, каким он должен быть, как подключить его через --decoy-dir и готовый промпт, по которому AI-агент придумает уникальный сайт.

Эксплуатация

• Здоровье: Как панель проверяет каждый профиль как настоящий клиент, что смотрит и что умеет исправлять доктор ноды и как алерты открываются, закрываются и глушатся.
• Алерты в Telegram: Как отправлять алерты панели в Telegram. Бот через BotFather, привязка чата, что и кому приходит, и наблюдатель панели для уведомлений о сбое.
• Наблюдатель панели: Настройте Cloudflare Worker, который проверяет панель раз в минуту и присылает уведомления о сбое и восстановлении в Telegram.
• Обновления: Как агенты нод обновляются из подписанных пакетов, как обновить ноду сейчас или по расписанию, что страхует обновление и как обновляется сама панель.
• Релизы и подпись: Для мейнтейнеров и для тех, кто собирает Mistgate со своим ключом; ключ релиза, воспроизводимая сборка, подпись и публикация релиза, свой пакет и смена ключа.
• Зашифрованные резервные копии панели: Настройка бэкапов в Cloudflare R2, хранение ключа восстановления офлайн и восстановление панели в чистый каталог данных.
• Безопасность: Кто что может в админке, как устроены вход, повторное подтверждение и сессии, как панель прячется за сайтом-ширмой, что лежит в каталоге данных и как вернуть доступ.
• Решение проблем: Частые проблемы по симптомам, как каждая из них выглядит в панели и что с ней делать.

План развития

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

Справочник

• Командная строка: Все команды mistgate и mistgate-node с флагами, переменными окружения, значениями по умолчанию и примерами.
• Конфигурация: Все флаги mistgate serve и mistgate setup с переменными окружения и значениями по умолчанию, другие настраиваемые команды, флаги агента ноды и устройство каталогов данных.
• API админки: Connect-RPC API, на котором работает админка, как звать его через curl и сгенерированный клиент, API-токены и их профили и что токену можно, а что нельзя.
• MCP-сервер: Встроенный MCP-сервер панели для ИИ-агентов, как подключить клиент, все инструменты, схема «план → применить» и какие изменения ждут владельца.
• Архитектура: Из каких частей состоит Mistgate, как панель общается с агентами нод, где хранятся данные и что может и чего не может каждая часть, если попадёт в чужие руки.
• Частые вопросы: Короткие ответы на частые вопросы о Mistgate: Docker, память, приложения, размер флота, IPv6, Cloudflare, переезд, лицензия и куда сообщать о проблемах.
• Сравнение с другими панелями: Чем Mistgate отличается от 3x-ui, Marzban, PasarGuard, Remnawave, Hiddify Manager и s-ui, в чём другие впереди и откуда данные; проверено 9 октября 2026 года.
• Бенчмарки: Память, процессор, диск, время старта и нагрузка на подписки у Mistgate, 3x-ui, Remnawave и PasarGuard на одном небольшом сервере, а также тест, где панель, ядро VPN и трафик Hysteria2 работают на одной машине. Методика, версии и ограничения.