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

В админке: Профили

Профили

Что такое профиль, как устроен редактор, как профиль ставится на ноды со своим портом и сертификатом и какие изменения ломают уже выданное.

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

Профиль — это настройки протокола с названием: «Hysteria2 · 443 с Salamander и Let's Encrypt», «AmneziaWG 3.1, похожий на DNS». Его делают один раз и ставят на сколько угодно нод; каждая такая постановка — профиль на ноде, то есть сервер, к которому подключаются люди. Люди получают профиль через свою группу. На этой странице — раздел Профили, редактор профиля и постановка профилей на ноды; настройки каждого протокола описаны в разделах Hysteria2, VLESS REALITY, AmneziaWG и MTProto.

Профили, ноды и группы#

Что Что решает
Профиль Протокол и его настройки: порт, сертификат, обфускацию, выход.
Профиль на ноде Где он работает. Нода может поменять для себя порт и домен (SNI) профиля.
Группа Кто его получит. Группа — это набор профилей; каждый пользователь состоит в одной группе.

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

Протоколы — это плагины#

Каждый протокол — плагин панели: сейчас это Hysteria2, VLESS, AmneziaWG и MTProto, который помечен как экспериментальный. Плагин приносит свои настройки в виде схемы, и редактор рисует форму по ней. Поэтому формы всех протоколов устроены одинаково:

  • поля разложены по группам Основное, Обфускация и Продвинутое; в заголовке группы видно, сколько изменено («изменено 2») и сколько ошибок («1 ошибка»);
  • у чисел подписаны единицы (Мбит/с, с, байт);
  • у секретов (пароль обфускации Hysteria2, ключ защиты заголовков AmneziaWG) есть кнопка Сгенерировать. Секрет хранится зашифрованным и больше не показывается: поле пишет «Задан и хранится на сервере, показать его нельзя. Сгенерируй новый, чтобы заменить.»;
  • часть полей критичные: если их поменять, у людей перестанут работать уже выданные настройки. Перед сохранением таких изменений редактор переспрашивает, см. ниже.

Список профилей#

Каждый профиль — карточка: название, протокол, короткая строка настроек («UDP 443 · Salamander · Let's Encrypt»), на скольких нодах он работает и сколько пользователей его получают. Жёлтые метки говорят, почему профиль никому не достаётся: Нигде не работает (не стоит ни на одной ноде) и Ни в одной группе. Жёлтая точка предупреждает, что профиль не запустился на какой-то ноде или туда не доходит UDP.

Новый профиль открывает редактор.

На каждой карточке есть спокойная строка: она говорит, в каких форматах подписки профиль работает: см. Форматы подписки профиля.

Форматы подписки профиля#

Не каждый формат подписки может нести каждый профиль: в sing-box нет XHTTP, а Gecko и AmneziaWG есть только в Mihomo. Каждая карточка списка и редактор в блоке Как увидит клиент → Форматы подписки показывают, где профиль работает. Таблица видов профилей — на странице Подписки.

  • Строка перечисляет форматы, которые несут профиль: «Список · Mihomo · Xray JSON · sing-box». У профиля, который работает везде, есть только эта строка.
  • Жёлтая метка отмечает настоящую потерю: «не sing-box: XHTTP». Форматы, которые теряют профиль по одной причине, делят одну метку: «не Список, Xray JSON, sing-box: Gecko». Полная фраза видна при наведении на метку или фокусе на ней.
  • AmneziaWG — не потеря, а устройство протокола: строка заканчивается словами «Mihomo · ключи AmneziaVPN», без метки.
  • MTProto не входит ни в один формат подписки, и это тоже не потеря: его ссылки tg:// берутся со страницы человека, а предпросмотр в блоке Как увидит клиент показывает ссылку («Telegram · ссылка tg://proxy»). См. MTProto.
  • Диапазон прыжков по портам Hysteria2 тоже не потеря. Список ссылок и Xray JSON записывают его одним портом, поэтому их названия подчёркнуты точками, а в подсказке сказано: «Диапазон портов записан одним портом.»
  • В редакторе строка следует за настройками, пока вы их меняете, и скрыта, пока в черновике есть ошибки. В карточке пользователя рядом с профилем по подписке, который какой-то формат не несёт, видна только жёлтая метка.

Причины — устойчивые коды. API панели и MCP отдают их в поле note у каждого формата профиля.

Код Метка Что это значит
xhttp XHTTP В sing-box нет транспорта XHTTP: VLESS через XHTTP, REALITY или TLS, напрямую или за CDN, и собственный сайт ноды.
self_signed самоподписанный sing-box не умеет проверять самоподписанный сертификат Hysteria2 по отпечатку.
gecko Gecko Hysteria2 с Gecko несёт только Mihomo.
awg ключи AmneziaVPN Список ссылок, Xray JSON и sing-box не несут AmneziaWG. Показано подчёркнутым точками словом, не меткой.
unsupported нет поддержки Формат ничего не выдаёт для этого профиля и не называет своей причины, например из-за неверного адреса.
hop_single_port один порт Формат несёт профиль, записав диапазон прыжков по портам одним портом. Это не потеря.

Создание профиля#

  1. Новый профиль — это два шага. Сначала выберите протокол: у каждого своя карточка (Hysteria2, VLESS, AmneziaWG, MTProto; у экспериментального об этом написано). Затем откроется форма, которая начинается с настроек плагина по умолчанию, все секреты уже сгенерированы. Настройки выбранного протокола описаны на его странице, например MTProto.
  2. Название. Пока его не ввели, оно следует за портом: «Hysteria2 · 443». До 64 символов, видно в списках панели и — через {profile} в шаблоне названий — в названиях серверов, которые видят люди (см. Подписки).
  3. Поменяйте нужные настройки. Панель проверяет их по ходу ввода; поле с ошибкой отмечено, а предпросмотр ждёт, пока её исправят.
  4. Блок Сразу после создания решает, что произойдёт по кнопке:
    • Поставить на ноды — отмечены все ноды или только та, с которой вы пришли. Если у профиля Let's Encrypt без домена, блок предупредит о нодах, у которых в адресе IP.
    • Добавить в группы — отмечены группы, где ещё нет профиля этого протокола (без него их люди ничего не получат в этом приложении); группы, где он уже есть, не отмечены: второй профиль обычно для проверки или запасной. Если групп нет совсем, предлагается переключатель Создать группу «Все» с этим профилем.
  5. Создать профиль. Профиль создаётся, добавляется в группы, а затем в том же окне по очереди ставится на ноды. Если какая-то нода отказала, окно остаётся открытым: в нём причина и поле, где это исправить (другой порт, домен).

Панель справа, Как увидит клиент, показывает, что получит клиент для этого профиля, со скрытыми секретами: ссылку для Hysteria2 («Subscription link · URI list») или файл .conf для AmneziaWG («AmneziaVPN · .conf»). Под ней Форматы подписки показывают, где профиль работает.

Где работает#

Страница существующего профиля начинается с блока Где работает: строка о том, работает ли профиль («Работает: 2 ноды, 1 группа, 14 пользователей») или чего не хватает, с кнопкой, которая это исправит, а под ней три столбца:

  • Ноды — каждая нода с портом и состоянием профиля на ней и с ошибкой агента, если профиль не запустился. Поставить на ноды добавляет новые.
  • Группы — группы, в которых он есть; Изменить открывает группу, Добавить в группу добавляет ещё в одну.
  • Пользователи — сколько людей его получают, по группам. Считаются только активные пользователи, у которых включено подходящее приложение.

Постановка профиля на ноды#

Есть два пути с одинаковыми проверками:

  • со страницы профиля: Поставить на ноды, отметить ноды (или Все ноды), затем Поставить на N нод;
  • со страницы ноды: Профили → Добавить профиль, выбрать профиль, затем Добавить.

Профиль можно поставить на любую ноду флота, в том числе на ту, что ещё ждёт установки; на выведенную — нельзя. Нода на связи получает новое состояние сразу, и профиль запускается за несколько секунд; нода не на связи запустит его, когда вернётся агент.

На ноде у профиля могут быть свои:

  • Порт. Пусто — порт из профиля.
  • Домен (SNI) (Hysteria2; и MTProto, где это имя в рукопожатии, если профиль использует имя самой ноды). Пусто — домен из профиля, а если в профиле его нет — адрес ноды, если это домен.

Первый профиль AmneziaWG на ноде вдобавок спрашивает, каким бэкендом AmneziaWG будет пользоваться нода, см. AmneziaWG.

Порты и подсказка свободного порта#

Два профиля не могут слушать один порт на одной ноде, и порт не может попадать в диапазон прыжков другого профиля. Если порт занят, окно сразу подставляет свободный и говорит об этом («Порт 443 занят профилем «Основной» — подставили свободный 8443. Можно вписать свой.»), а кнопка Взять 8443 вернёт его, если вы вписали другое. Для Hysteria2 панель сначала пробует 8443, 4443, 2053, 2083, 2087 и 2096, потом случайные порты от 10000 до 60000; для AmneziaWG — только случайные. Диапазоны прыжков считаются занятыми.

Порт может держать и программа вне Mistgate. До запуска профиля панель этого не видит: профиль тогда не запустится с ошибкой «Порт 443 занят другой программой», доктор назовёт процесс, если сможет, а Сменить порт откроет окно со свободным портом.

Сертификаты#

У AmneziaWG сертификата нет, и у VLESS REALITY тоже: она пользуется сертификатом сайта-цели. Своего сертификата нет и у MTProto: с именем самой ноды посторонние на его порту видят сайт ноды с сертификатом ноды (MTProto). У профиля Hysteria2 — один из двух:

Сертификат Что нужно Как его проверяет приложение
Let's Encrypt Домен, у которого A-запись указывает на ноду, и порты 80 и 443, открытые из интернета. Обычным путём: по домену и цепочке доверия.
Самоподписанный (с пином) Ничего: работает и по IP. По отпечатку SHA-256 сертификата (пину), который приходит в подписке.

Сертификаты Let's Encrypt нода получает сама и продлевает примерно за месяц до окончания. На проверку она отвечает на TCP 443 (там же профиль Hysteria2 показывает свой сайт-маскировку) и на порту 80, если он свободен. Профиль VLESS на TCP 443 той же ноды забирает первое: см. VLESS и Hysteria2 на одной ноде. Самоподписанный сертификат делается на ноде и действует 10 лет; нода сделает новый, с новым пином, когда останется меньше 30 дней или поменяется домен (SNI). Новый пин дойдёт до людей при следующем обновлении подписки.

На какое имя выписан сертификат: Домен (SNI) ноды, иначе Домен (SNI) профиля, иначе адрес ноды, если это домен. Для самоподписанного сертификата на ноде с IP в сертификат попадает IP.

Профиль с Let's Encrypt на ноде, у которой адрес — IP, а домен не указан, работать не может. Окно говорит об этом до нажатия кнопки и предлагает два выхода:

  • Вписать домен, у которого A-запись указывает на IP ноды;
  • перейти на самоподписанный сертификат: Переключить «…» на самоподписанный, если профиль ещё нигде не стоит, или Создать самоподписанный профиль для …, если он уже работает где-то с Let's Encrypt (тот профиль останется как есть).
Важно

Панель пишет, что самоподписанный сертификат проверен с официальным клиентом Hysteria2 и с Mihomo, а в Happ — ещё нет. Проверьте на своём телефоне, прежде чем на него полагаться.

Проверка до нажатия кнопки#

Пока вы заполняете окно добавления профиля (и окно правки профиля на ноде), панель спрашивает у сервера, пройдёт ли настоящий запрос: примерно через 300 мс после каждого изменения она отправляет тот же запрос с флагом «только проверить». Сервер прогоняет все проверки настоящего запроса и ничего не записывает. Ответ — либо отказ, который окно пишет словами рядом с нужным полем и из-за которого кнопка недоступна, либо профиль таким, каким он будет на этой ноде (его настоящие порт и домен для подсказок в полях), с предупреждениями и свободным портом.

Код Когда Что пишет или делает окно
acme_needs_domain Let's Encrypt без домена на ноде с IP Блок Let's Encrypt с кнопкой Вписать домен и путями к самоподписанному.
mtproto_needs_domain Профиль MTProto с именем самой ноды на ноде, у которой только IP-адрес Сообщение просит указать для профиля домен на этой ноде или выбрать Другой сайт.
port_taken Этот порт слушает другой профиль ноды или порт попадает в его диапазон прыжков «Порт 443 на de1 уже занят профилем «Основной».» Подставлен свободный порт; Взять N.
hop_taken Собственный диапазон прыжков профиля пересекается с другим профилем на ноде Пересечение и Открыть профиль: поможет только смена диапазона.
port_in_hop Порт попадает в собственный диапазон прыжков профиля «Порт должен быть вне диапазона прыжков профиля (20000–30000).»
sni_needs_domain В Домен (SNI) профиля с Let's Encrypt вписан IP «Для Let's Encrypt здесь нужен домен, а «…» — не домен.»
sni_invalid Ни домен, ни IP ««…» — не домен и не IP-адрес.»
already_on_node Профиль уже стоит на этой ноде «Этот профиль уже стоит на этой ноде.»
node_retired Нода выведена из флота «Нода выведена из флота.»

При сохранении нового или изменённого порта Mistgate проверяет доставку UDP-пакетов; проверка может занять около 8 секунд, а режим Только проверить использует только кэш. Если выбранный порт теряет пакеты, Mistgate откажет в сохранении и предложит порт, прошедший ту же проверку. Вы можете выбрать Всё равно добавить; Mistgate запишет это решение в журнал аудита. Порты, на которых терялись пакеты за последние 30 дней, не предлагаются; сначала предлагается порт с недавней успешной проверкой, затем — ещё не проверенные порты.

Предупреждение кнопку не блокирует. Сейчас их два:

  • warp_missing — профиль выходит через WARP, а у ноды нет аккаунта WARP, WARP на ней на паузе или по последнему отчёту ноды туннель лежит. Окно говорит, что профиль там не пропустит трафик, и ведёт к карточке WARP ноды.
  • hy2_decoy_paused — профиль VLESS на TCP-порту добавляют рядом с профилем Hysteria2, чей сайт занимает этот порт (по умолчанию TCP 443), или наоборот. Окно называет оба профиля и говорит, что сайт Hysteria2 выключен, пока порт у VLESS. См. VLESS и Hysteria2 на одной ноде.

Те же коды возвращают API и сервер MCP в виде «код: ключ=значение&ключ=значение», так что их могут читать и скрипты. См. API.

Ошибки, которые объясняет редактор#

Поле, которое отклонил сервер, получает пояснение рядом. На эти случаи у редактора свои слова; для остальных полей и кодов он показывает короткий английский текст сервера.

Поле Код Что пишет редактор
Порт out_of_range Порт — от 1 до 65535
Прыжки по портам, начало invalid Порт должен быть вне диапазона прыжков
Прыжки по портам, начало out_of_range Начало диапазона — от 1024 до 65535, чтобы не задеть SSH и служебные порты
Прыжки по портам, конец too_wide В диапазоне не больше 20 000 портов
Пароль обфускации length Пароль — от 8 до 128 символов
Домен (SNI) invalid Это не похоже на домен

Для сетей клиентов AmneziaWG показывается текст сервера: сеть пересекается с другим профилем AmneziaWG («overlaps the network of profile …») или её уже нельзя менять («the client network cannot change once the profile is on a node or has devices»).

Сохранение изменений и что ломает выданное#

Полоса внизу считает изменения («Изменено параметров: 3»), рядом Отменить и Сохранить. Сохранённое уходит на все ноды, где стоит профиль («Сохранено · раскатываю на 2 ноды»); профиль там перезапускается, а подключённые через него люди переподключаются сами.

Некоторые поля критичные: нода и приложение должны совпадать в них, поэтому уже выданные людям настройки при их смене перестают работать. Перед сохранением такого изменения редактор спрашивает Применить критичные изменения? и говорит, что будет:

Протокол Критичные поля Что произойдёт
Hysteria2 Порт, прыжки по портам, домен (SNI), сертификат, тип и пароль обфускации Сервер перестанет работать у всех пользователей профиля, пока их приложение не обновит подписку (до интервала обновления, по умолчанию 12 ч). Окно перечисляет затронутых пользователей.
VLESS Порт, транспорт, цель REALITY, имена сервера, короткие ID, путь XHTTP, заголовок Host и заполнение Сервер перестанет работать у всех пользователей профиля, пока их приложение не обновит подписку — как у Hysteria2. Окно перечисляет затронутых пользователей.
AmneziaWG Версия протокола, порт, сети клиентов, S1–S4, H1–H4, ключ защиты заголовков, случайные хвосты Все устройства профиля перестанут работать и будут помечены как устаревшие: каждому нужен конфиг заново. Кнопка называется Сменить и перевыдать ключи.

Для Hysteria2 и VLESS окно подсказывает два обходных пути: попросить людей обновить подписку вручную или сделать копию профиля на новом порту, а старый убрать позже.

Смена порта профиля AmneziaWG на одной ноде (на вкладке Профили ноды) тоже помечает устройства этого профиля устаревшими: в их конфигах старый порт. То же делает смена Адреса ноды (на её вкладке Сервер) для каждого профиля AmneziaWG на этой ноде: в конфигах старый адрес.

Если кто-то сохранил профиль, пока вы его правили, при сохранении появится «Этот профиль изменили в другом месте» с кнопкой Перезагрузить: панель никогда молча не затирает более новую версию.

Один и тот же сервер с WARP и без#

На странице профиля, под блоком Где работает, кнопка Копия через WARP (или Копия без WARP у профиля, который уже выходит через WARP) делает двойника профиля с другим выходом. Окно перечисляет, что именно будет создано:

  • название с добавленным (или убранным) « · WARP», а если такое название занято — с номером перед ним («Основной 2 · WARP»);
  • порт, свободный на всех нодах профиля (кандидаты те же, что у подсказки свободного порта выше);
  • новые пароли и ключи: ничего секретного не копируется; двойник AmneziaWG получает ещё и свою сеть клиентов;
  • без прыжков по портам (диапазоны пересеклись бы);
  • те же ноды и те же группы. Ноды без рабочего WARP для двойника с WARP перечислены и не отмечены: там он ничего не пропустит.

Сначала сохраните изменения: копия делается из сохранённого профиля. После этого люди из этих групп увидят каждую ноду в приложении дважды. Названия серверов строятся по шаблону в Подписки → Названия и тексты: по умолчанию страна, затем название профиля, так что двойник называется «🇩🇪 DE · Основной · WARP» рядом с «🇩🇪 DE · Основной». В шаблоне без {profile} они различаются только номером; см. Подписки. Для AmneziaWG каждому, кому нужен двойник, нужно отдельное устройство (ключ) для него. Сам WARP описан в разделе WARP.

Удаление профиля#

Опасная зона → Удалить профиль удаляет профиль насовсем, из групп он пропадает. Профиль, который ещё стоит на какой-то ноде, удалить нельзя: окно назовёт эти ноды. Сначала уберите его с них (нода → Профили → Убрать).

Кто что может#

Создавать, менять и удалять профили, ставить их на ноды, снимать с нод и делать двойников может владелец. Добавлять профиль в группу могут владелец и помощники. Смотреть профили может любой админ. См. Безопасность.

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