Обзор
Что такое Mistgate и чем он не является, для кого он и как связаны его части.
На этой странице
Mistgate — панель для небольшого VPN-флота на ваших собственных серверах. На этой странице — что она умеет, чего не делает, и понятия, на которых держится вся остальная документация.
Что такое Mistgate#
- Две программы, без Docker.
mistgate— панель.mistgate-node— агент, который работает на каждом VPN-сервере. Обе — одиночные бинарники на Go для Linux (amd64 и arm64). - Одна админка на весь флот. Панель хранит людей, настройки протоколов и серверы в одной базе SQLite и показывает их в веб-админке на русском, английском, упрощённом китайском, персидском и турецком.
- Работу на серверах делают агенты. Агент запускает протоколы и держит хост в том состоянии, которое просит панель. Он сам подключается к панели, поэтому управляющий порт на ваших серверах не нужен. По SSH панель заходит на сервер только чтобы установить ноду (из админки или для ИИ-агента с вашего одобрения) и, пока этот SSH-доступ сохранён, чтобы по вашему запросу сменить или проверить пароль сервера.
- Протоколы. Hysteria2 (официальное ядро, встроено в агента), VLESS REALITY по XHTTP или TCP (xray-core, встроен в агента) и AmneziaWG 2.0 и 3.1 (по умолчанию в userspace, модуль ядра — по запросу для отдельной ноды). Выходом в интернет для всех трёх может служить Cloudflare WARP.
- Одна ссылка на человека. Приложение для подписок получает по ней список серверов в понятном ему формате (список ссылок
hysteria2://иvless://или профиль Mihomo в YAML — выбор по правилам User-Agent). Браузер получает личную страницу человека с инструкциями. Пользователи AmneziaVPN получают по ключу на устройство. - Скрыта по умолчанию. Посторонний, открывший адрес панели, видит сайт-ширму. Админка спрятана за секретным путём, секретным именем хоста или отдельным портом, а на неизвестную ссылку подписки отвечает та же ширма.
- Здоровье и обновления. Панель проверяет каждый сервер так, как его видит клиент, на каждой ноде работает доктор с проверками хоста и несколькими безопасными исправлениями, а алерты объясняют проблему простыми словами. Агенты нод и панель обновляются только до релизов, подписанных ключом релиза, вшитым в панель: ключом проекта для официальных релизов на GitHub, вашим собственным — для ваших сборок.
- Бэкапы. Зашифрованные резервные копии панели в ваш бакет Cloudflare R2 — по расписанию или по кнопке.
- Автоматизация. Скрипты работают с тем же Connect API, что и админка, через API-токены с ограниченными правами; ИИ-агенты — через встроенный MCP-сервер, и рискованные изменения ждут одобрения владельца.
Чем Mistgate не является#
- Не VPN-сервис. Серверы и доменные имена — ваши, и управляете всем вы. Mistgate не сдаёт серверы и не продаёт доступ.
- Не биллинг. Нет платежей, тарифов и счетов. Квоты трафика, сроки и лимиты устройств — это ограничения, которые вы задаёте сами.
- Не клиентское приложение. Люди подключаются готовыми приложениями: приложением для подписок вроде Happ или приложением на ядре mihomo вроде kl!ck (его рекомендуем на Windows и macOS), Clash Verge или FlClash, а для ключей AmneziaWG — AmneziaVPN. Собственное приложение — Планируется.
- Не готовый продукт. Это ранний релиз: API, сохранённые настройки и протокол связи с нодами до версии 1.0 ещё могут меняться. Модель данных рассчитана примерно на 5000 пользователей и 50 нод.
- Не установщик в один клик. Панель ставится одной командой на вашем сервере или вручную — из Linux-бинарников релиза на GitHub или из исходников; сервер и домен ваши, а учётную запись владельца вы создаёте в браузере. Ноду добавляют из админки: автоматически по SSH или одноразовой командой установки, которую вы запускаете на сервере.
Для кого он#
Для человека или небольшой команды, которые держат несколько VPN-серверов для себя, семьи, друзей или небольшого сообщества. Понадобится уверенно обращаться с Linux, SSH, systemd и DNS-записями. Часть настроек по умолчанию учитывает пользователей в России и Китае (Яндекс DNS для российских нод, AliDNS и DNSPod для китайских, контрольные домены доктора для каждой страны, пресеты раздельного DNS); всё это настраивается.
Понятия#
| Понятие | Что это |
|---|---|
| Панель | Процесс mistgate serve, один на установку. Хранит базу, мастер-ключ, которым зашифрованы секреты, и собственный удостоверяющий центр (CA) панели. Отдаёт сайт-ширму, подписки и страницы пользователей на публичном адресе, админку на секретном адресе и точку подключения для агентов нод. |
| Нода | Linux-сервер, через который идёт VPN-трафик. У неё есть имя (de1), адрес, к которому подключаются клиенты (домен или IP), и при желании страна. |
| Агент | Служба mistgate-node на ноде. Держит клиентский сертификат от CA панели и одно соединение с панелью, применяет то, что панель хочет видеть на этой ноде, и отправляет трафик, сессии, состояние и события. |
| Профиль | Готовый набор настроек протокола: протокол и его параметры (порт, сертификат, обфускация и так далее). Пока профиль не поставлен на ноду, он ничего не делает. |
| Сервер на ноде | Профиль, поставленный на ноду, — он же профиль на ноде. Именно он слушает порт на ноде, и именно его человек видит в приложении как один сервер. Порт и домен (SNI) у него можно задать отдельно для каждой ноды. |
| Группа | Набор профилей. Каждый пользователь состоит в одной группе и получает её профили. В новой панели есть пустая группа «Все». |
| Пользователь | Человек с доступом: группа, приложения (подписка, AmneziaVPN или оба), ноды (все или выбранные), квота трафика, срок и лимит устройств. Статус: «Активен», «Отключён», «Истёк» или «Квота исчерпана». |
| Устройство | Устройство пользователя, у которого есть учётные данные. Для приложений с подпиской устройство появляется само, когда приложение забирает ссылку, по одному на ID устройства, и получает свои ключи; приложения без ID устройства делят одно место. В AmneziaWG устройство — это один ключ, привязанный к одному профилю. Лимит устройств считает именно их. |
| Ссылка подписки | Одна секретная ссылка на пользователя. Приложение получает по ней серверы пользователя, браузер — его страницу. Новая ссылка сразу заменяет старую. |
| Страница пользователя | То, что ссылка показывает в браузере: инструкции для платформы человека, QR-код, трафик и срок, а если вы разрешили, то и ключи AmneziaWG, которые человек сам создаёт для своих устройств. Страница может спрашивать пароль. |
Как они связаны:
- Пользователь получает сервер на ноде, если профиль есть в группе пользователя, нода входит в его ноды, сервер включён, пользователь активен и одно из его приложений умеет этот протокол (Hysteria2 и VLESS — приложения для подписок; AmneziaWG — AmneziaVPN, а также приложения на ядре mihomo, если у пользователя включён AmneziaVPN).
- Любое изменение в этой цепочке сразу уходит на нужные ноды. Перезапускать ничего не надо.
Как приложение человека попадает на ноду#
С панелью приложение говорит только когда забирает ссылку. VPN-трафик идёт напрямую от приложения к ноде и дальше в интернет; через панель он не проходит.
Что дальше#
- Требования: что нужно панели и нодам.
- Установка панели, затем Добавление ноды (или Установка ноды по SSH) и Первые пользователи.
- Архитектура: подробнее о том, как части системы общаются друг с другом.