Home

Mistgate documentation · Документация Mistgate · 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 в одной подписке.

Mistgate 是用于自建 VPN 集群的自托管面板：面板和节点 Agent 各一个二进制文件，一份订阅同时提供 Hysteria2 和 AmneziaWG。

English: Start page · Русский: Начальная страница · 简体中文: 起始页

Website: mistgate.app · Repository: Mistgate/mistgate · Русский: mistgate.app/ru/ · 简体中文: mistgate.app/zh/

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: REALITY on TCP and XHTTP, or TLS with XHTTP and WebSocket, direct or behind a CDN. When to choose it over Hysteria2, every setting, 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, the DNS a person picks for the apps on the link and 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.
• Reachability: Whether the nodes open from inside a country, Russia by default; the Reachability section, its three sources (Globalping, the block lists, the TSPU probe), the verdict of every node with its week, and the alert.
• 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 releases already do, what is being tested now, what comes next and what 1.0 needs, and the known limits of the current release.

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 и XHTTP или TLS с XHTTP и WebSocket, напрямую или за CDN. Когда выбирать его вместо 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-агент придумает уникальный сайт.

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

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

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

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

Справочник

• Командная строка: Все команды 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 работают на одной машине. Методика, версии и ограничения.

简体中文

• Mistgate 文档: 文档包含哪些内容、在哪里查找，以及阅读顺序。

入门

• 概览: Mistgate 是什么、不是什么、适合谁使用，以及各部分如何配合。
• 系统要求: 面板服务器、节点服务器和构建机器的要求，以及 Agent 对节点所做的更改。
• 安装面板: 下载或构建 Mistgate，使用 mistgate setup 准备面板，通过 systemd 运行，并首次登录。
• 安装 Cloudflare 版: 使用 mistgate edge deploy 在 Cloudflare 上运行面板，无需服务器；介绍所需条件、API 令牌、必须备份的密钥文件、首次登录和当前不可用的功能。这是预览版。
• 添加节点: 选择 SSH 安装或手动安装，使用一次性命令注册服务器，查看节点上线情况，并在之后彻底移除节点。
• 通过 SSH 安装节点: 让面板通过 SSH 在新服务器上安装节点 Agent，跟踪、取消和重试安装任务，并管理已保存的 SSH 凭据。
• AI 智能体指南: 三段现成提示词：使用可运行 shell 命令的智能体安装面板，通过 MCP 添加节点并管理集群，以及使用编码智能体参与代码开发。
• 首批用户: 从已有一台已连接节点的面板开始，尽快让用户建立可用连接。

使用指南

• 节点: 了解节点列表和节点页面中的信息、各状态的含义，以及如何更改、重启或退役节点。
• 协议配置: 了解协议配置的含义、编辑器的使用方法、如何设置协议配置在节点上的端口和证书，以及哪些更改会影响现有用户。
• Hysteria2: 了解 Hysteria2 协议配置编辑器中的所有设置、节点如何处理流量，以及应用会收到和需要什么。
• VLESS REALITY: VLESS 协议配置：通过 TCP 和 XHTTP 使用 REALITY，或通过 XHTTP 和 WebSocket 使用 TLS，可直连或经 CDN 连接。了解何时选择它而不是 Hysteria2、各项设置、REALITY 目标、端口，以及应用会收到和需要什么。
• 在同一节点上运行 VLESS 和 Hysteria2: 了解 Hysteria2 和 VLESS 在同一节点上使用哪些端口、两者同时需要 TCP 443 时会发生什么、Let’s Encrypt 续期与端口的关系，以及如何先让少数用户试用 VLESS。
• AmneziaWG: 了解 AmneziaWG 3.1 和 2.0 协议配置、参数和伪装样式、节点的用户态与内核后端，以及用户导入 AmneziaVPN 的设备密钥。
• WARP: 了解如何让协议配置的流量经 Cloudflare WARP 出口、如何为节点获取账户、「停止转发（不回退直连）」的含义，以及如何查看和修复 WARP 连接。
• 用户与分组: 如何创建和管理用户（配额、有效期、流量、设备和访问权限）、分组的作用，以及如何在分组间移动用户。
• 订阅: 每位用户使用一个链接访问所有应用：每个应用会获取哪种格式、面板如何决定、服务器如何命名、应用会显示什么，以及订阅的各项设置。
• 客户端应用: 各个平台适合推荐哪些应用、每个应用从订阅中获取什么内容、一键添加链接及其备用方式，以及如何在管理后台和通过 MCP 配置应用。Mistgate 推荐的桌面应用是 kl!ck。
• 用户页面: 用户在浏览器中打开订阅链接时会看到什么、页面密码如何工作，以及管理员如何预览页面。
• DNS: DNS 预设是什么、DNS 分流如何工作、用户适用哪个预设、用户为订阅类应用和每台服务器选择的 DNS、各应用如何获取 DNS，以及更改何时会生效。
• BT 下载拦截: 按节点启用的 BitTorrent 拦截功能、可识别的流量、它如何拦截 AmneziaWG 和 Hysteria2 流量、事件显示的内容，以及它无法拦截的情况。
• 自有伪装站点: 为什么要用自有小型站点替换内置伪装页面、怎样的站点比较合适、如何通过 --decoy-dir 安装，以及可供 AI 智能体创建独特站点的现成提示词。

运维

• 运行状况: 了解面板如何像真实客户端一样检查每个协议配置、节点诊断会检查和修复什么，以及告警如何打开、关闭和静默。
• 可达性: 能否从某个国家境内（默认俄罗斯）访问节点；「可达性」部分、它的三个来源（Globalping、封锁名单、TSPU 探测）、每个节点的结论及其最近一周，以及告警。
• Telegram 告警: 将面板告警发送到 Telegram。使用 BotFather 设置机器人、关联聊天，了解会发送哪些内容及接收对象，并使用面板监视器接收停机告警。
• 面板监视器: 使用 Cloudflare Worker 每分钟检查一次面板，并在面板停止响应和恢复时发送 Telegram 告警。
• 更新: 了解节点 Agent 如何从已签名发布包自我更新，如何立即或定时更新节点、更新保护机制，以及面板如何自我更新。
• 发布版本和签名: 面向维护者和使用自有密钥构建 Mistgate 的用户：发布密钥、可复现构建、发布版本的签名与发布、自有发布包以及密钥轮换。
• 面板加密备份: 配置 Cloudflare R2 备份，将恢复私钥（identity）保存在离线位置，并将面板恢复到新的数据目录。
• 安全: 了解管理后台的权限、登录、重新验证和会话机制，面板如何通过伪装站点隐藏管理后台，数据目录包含哪些内容，以及如何从面板服务器恢复访问权限。
• 故障排查: 按症状查找常见问题，了解它们在面板中的显示方式以及处理方法。

路线图

• 状态和路线图: 了解 Mistgate 已发布版本的功能、当前测试内容、后续计划、1.0 发布条件，以及当前版本的已知限制。

参考

• 命令行: mistgate 和 mistgate-node 的所有命令及其标志、环境变量、默认值和示例。
• 配置: mistgate serve 和 mistgate setup 的所有标志、对应的环境变量和默认值、其他可配置命令、节点 Agent 的标志，以及数据目录布局。
• 管理 API: 管理后台使用的 Connect-RPC API、如何通过 curl 或生成的客户端调用、API 令牌及其权限级别，以及令牌可以和不可以执行的操作。
• MCP 服务器: 面向 AI 智能体的面板内置 MCP 服务器、客户端连接方式、全部工具、计划与执行流程，以及哪些变更需要等待所有者审批。
• 架构: Mistgate 的组件、面板与节点 Agent 如何通信、数据存放位置，以及各部分落入不当人员手中时能做什么、不能做什么。
• 常见问题: 关于 Mistgate 常见问题的简短回答：Docker、内存、应用、规模、IPv6、Cloudflare、迁移、许可证以及问题反馈渠道。
• 与其他面板对比: Mistgate 与 3x-ui、Marzban、PasarGuard、Remnawave、Hiddify Manager 和 s-ui 的对比、其他项目领先之处，以及截至 2026-10-09 核对过的来源。
• 基准测试: 在同一台小型服务器上测试 Mistgate、3x-ui、Remnawave 和 PasarGuard 的内存、CPU、磁盘、启动时间和订阅负载，并在单服务器上测试 VPN 核心和 Hysteria2 流量。包含方法、版本和限制。