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

В админке: Подписки

Страница пользователя

Что видит человек, когда открывает свою ссылку в браузере, как работает пароль страницы и как админ смотрит предпросмотр страницы.

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

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

Что видит человек#

В приветствии используется необязательное Имя на странице подписки из настроек пользователя. Если оставить его пустым, страница покажет внутреннее имя из раздела Пользователи. Это публичное имя не меняет учётную запись, доступ или настройки подключения.

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

Сверху вниз:

  1. Объявление, если включено Показывать объявление. Человек может его закрыть; новый текст покажется снова.
  2. Приветствие и статус: «Привет, Алиса», статус («Подписка активна», «Подписка закончилась», «Трафик закончился», «Подписка отключена»), сколько дней осталось до конца срока и трафик периода относительно квоты с датой сброса.
  3. Загрузка: насколько занят каждый сервер прямо сейчас — уровнем: Низкая, Средняя или Высокая (от 50% и от 80%): загрузка процессора ноды или, если указана Пропускная способность канала на её вкладке Сервер и канал занят сильнее, доля канала. У сервера без свежего замера от агента уровня нет. Сервер назван по стране и местоположению, никогда не по имени ноды в панели; нода без того и другого называется «Сервер», а повторяющееся название получает номер. Самих скоростей страница не показывает никогда: тот, кто делит ноду с одним другим человеком, не должен видеть, когда тот смотрит видео. Если у какого-то сервера Высокая, карточка советует сервер поспокойнее («Канал сервера … сильно загружен. Если соединение медленное, попробуйте …»).
  4. Шаги подключения (первый визит; тот же поток позже — шторка Добавить устройство). Если у человека оба способа, первый шаг — Чем подключать: две карточки, такие же, как в шторке «Добавить устройство». Через приложение — рекомендуемая, выбрана с начала; Ключом AmneziaVPN — вторая. Если способ один, вопроса нет.
    • Ваше устройство: платформа, определённая по браузеру (iPhone, Android, Windows, Mac, Linux); её можно переключить.
    • Через приложение (названия берутся из списка приложений; в списке только приложения по ссылке, ключевых там нет): выбрать приложение, установить его (кнопка магазина или скачивания и описание с карточки) и Добавить в Happ — ссылка в одно касание по шаблону приложения. Прямо под ней «Не открывается? Скопировать ссылку». «В Happ появятся все ваши серверы (4) — выберите любой». QR-код ссылки, чтобы подключить телефон, если включено QR для второго устройства. «Подключено через подписку» говорит, когда приложения по ссылке последний раз забирали подписку. Если вы или пользователь откроете эту страницу, время не изменится и устройство не добавится: учитывается только запрос приложения.
    • Ключом: установить AmneziaVPN, Добавить устройство (откроется форма ключа), вставить ключ. Если самообслуживание выключено, шаг говорит «Попросите ключ».
  5. Telegram-прокси, если владелец включил Telegram для человека, под серверами (см. Telegram-прокси).
  6. Мои устройства: один список из приложений по ссылке и ключей человека и одна кнопка Добавить устройство для обоих способов (см. Мои устройства).
  7. Поддержка: «Что-то не работает?» с кнопкой, ведущей по ссылке на поддержку, если включена Кнопка поддержки и ссылка задана.
  8. Строка внизу: «Ссылка личная — не пересылайте её. Работает, пока подписка активна.»

Для платформы без приложений написано «Для … приложения нет — выберите другое устройство выше». Человек, который пока ничего не получает, видит «Сервер ещё настраивается — напишите администратору.»

Когда подписка не работает#

Человек, у которого закончился срок, исчерпана квота или отключён доступ, вместо шагов видит причину и кнопку поддержки, если ссылка задана:

Статус Что пишет страница
Срок закончился «Интернет через … сейчас не работает. Напишите — продлим.»
Квота исчерпана, есть сброс «Трафик на этот месяц закончился — до 1 октября VPN не работает. Нужно раньше — напишите.»
Квота исчерпана, сброса нет «Лимит трафика исчерпан. Напишите — увеличим.»
Отключён «Администратор приостановил доступ. Если это ошибка — напишите.»

Приложения показывают ту же причину единственной записью подписки: см. Подписки.

Пароль страницы#

Если включён Пароль на странице (по умолчанию включён), страница спрашивает пароль, прежде чем что-то показать, и без него не работают запросы самообслуживания. Сама подписка, которую приложения берут по тому же адресу, пароль никогда не спрашивает: приложение не может его ввести.

  • Пароль выглядит как k7m2-x9pq: восемь строчных латинских букв и цифр, без похожих друг на друга 0, 1, l и o. Заглавные буквы, пробелы и дефисы при вводе не учитываются.

  • Он нигде не хранится: панель вычисляет его из ссылки человека. Новая ссылка — это новый пароль, а старые ссылка и пароль перестают работать.

  • Админ видит его в окне ссылки рядом со ссылкой (Пароль страницы, со своей кнопкой копирования). Скопировать для отправки копирует ссылку и пароль одним сообщением:

    INI
    Ваша ссылка: https://sub.example.com/<секретный префикс>/<токен>
    Пароль от страницы: k7m2-x9pq
  • Страница спрашивает пароль один раз в браузере и помнит его около 180 дней (cookie, привязанная к пути ссылки).

  • Пять неверных попыток за 10 минут — по одной ссылке или из одной сети — блокируют форму до конца этих 10 минут («Слишком много попыток. Попробуйте через 7 мин.»). Блокировка записывается в аудит с именем человека, без ссылки и без адреса.

  • Форма подсказывает при частых ошибках: русская раскладка («Пароль набирается латиницей — переключите клавиатуру на English») и неверная длина («В пароле 8 знаков, вы ввели 7»).

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

QR-коды#

  • В админке: Ссылка подписки в карточке пользователя показывает QR-код ссылки. Если навести на него камеру телефона, откроется страница.
  • На странице: если включено QR для второго устройства, страница показывает QR-код ссылки для другого устройства: на компьютере — рядом с шагами, на телефоне — под «Подключить другое устройство (QR‑код)».
  • Для ключа: окно ключа показывает QR-код файла .conf, его сканируют в AmneziaVPN или приложениях AmneziaWG. Конфиг с видом QUIC слишком длинный для QR-кода: «Ключ слишком длинный для QR-кода. Скачайте файл или скопируйте ключ.»

Инструкции по платформам#

Шаги берутся из списка приложений на вкладке Страница пользователя. Для выбранной платформы каждое приложение по ссылке получает карточку (ключевые приложения среди них не стоят: у способа «ключом» свои шаги):

  • рекомендованное приложение идёт первым, со значком «рекомендуем», если приложений несколько;
  • кнопка скачивания называет магазин, когда может (App Store, Google Play), иначе «с сайта»;
  • описание с карточки, если задано;
  • кнопка добавления по шаблону ссылки «добавить», а если шаблона нет — «Скопировать ссылку» и куда её вставить («В Happ: добавить подписку → вставить ссылку»).

Для ключей страница даёт шаги AmneziaVPN: на телефоне «Откройте AmneziaVPN», «Нажмите «+» и вставьте ключ», «Нажмите «Продолжить»»; на компьютере «AmneziaVPN → «+» → «Файл с настройками подключения» → выберите скачанный файл» с предупреждением добавлять файл, а не ключ. «Нужна AmneziaVPN 5.0.1.5 или новее» называет самый старый клиент для версии протокола ключа.

Telegram-прокси#

Когда владелец включил для человека Telegram-прокси (см. Пользователи и группы), на странице появляется блок Telegram-прокси со строкой «Подключитесь к Telegram через прокси без VPN-приложения». Он только для приложения Telegram и не зависит от шагов выше.

  • Каждая строка — одна ссылка MTProto, названная по стране и месту сервера, как и другие серверы страницы, и никогда не по имени ноды или профиля в панели. Вторая ссылка на IPv6-адрес ноды заканчивается на · IPv6, а ссылка через ретрансляцию — на · через RU (код страны входа, на языке страницы).
  • Открыть в Telegram открывает ссылку в приложении Telegram, которое просит человека подтвердить прокси. Скопировать ссылку копирует её, чтобы вставить в чат или в настройки прокси Telegram.
  • Пока владелец не выпустил ключ человека или пока для него не работает ни один сервер MTProto, блок пишет «Прокси ещё готовится — напишите администратору.». У человека с выключенным Telegram блока нет.
  • Человек не может перевыпустить или удалить ключ на странице. Это делает владелец в админке.

Ссылки несут ключ человека, поэтому они так же личные, как ссылка подписки.

Мои устройства#

В одной карточке всё, что занимает места из лимита устройств человека:

  • Приложение по ссылке, которое сообщает ID устройства (Happ, kl!ck и другие из Клиентских приложений): своя строка и своё место. В строке название (модель или имя, которое дали человек или владелец; иначе система, например «iPhone») и одна тихая строка: «в сети» или «обновлялось 5 минут назад». Нажмите на строку, чтобы увидеть, что сообщило приложение: систему и приложение с версиями («iOS 18.1 · Happ 3.4.2»). Сначала идут приложения в сети, затем по давности обновления, так что устройство в руках человека всегда наверху. Список длиннее четырёх строк сворачивается до трёх с кнопкой Показать ещё N, кроме случая, когда все места заняты: тогда человек ищет старое устройство, чтобы удалить.
  • Приложения без ID устройства (Hiddify, v2rayNG и другие приложения, не шлющие ID, или Happ с выключенным HWID): одна строка «одно место на всех» на все такие приложения вместе. Её нельзя удалить или переименовать; нажмите на неё, чтобы увидеть последнее приложение. В режиме Строго эти приложения не подключаются, и строка так и говорит: «не подключатся — нужен Happ или kl!ck».
  • Ключи: строка на каждый ключ AmneziaVPN, каждый — одно место; Показать ключ и меню ⋯ (Переименовать, Заменить ключ, Удалить).
  • Счётчик в заголовке («5 из 10») и, когда у человека оба способа и есть лимит, строка о том, что занимает места.

Когда лимит заполнен в режимах Ограничивать и Строго, под заголовком стоит тихая строка: «Все места заняты. Удалите ненужное устройство и обновите подписку в приложении.» После этого приложение подключается сразу. В режиме Только считать никому не отказывают, и строки нет.

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

Кнопка рядом с Добавить устройство копирует ссылку одним нажатием. Человек вставляет её на каждом устройстве: каждое приложение, которое шлёт ID устройства, займёт своё место, остальные — одно общее.

Под списком одна кнопка Добавить устройство (блока «Подключить ещё устройство» под карточкой больше нет). Если способов два, она открывает шторку с вопросом «Как оно будет подключаться?»:

  • Через приложение (рекомендуем): шаги подключения приложения по ссылке — устройство, приложение (приложения по ссылке для этой платформы из списка приложений), «Добавить одним нажатием» или «Скопировать ссылку» и QR-код этой страницы для другого устройства, если включено QR для второго устройства. Карточка говорит «Занимает 1 место» и сколько ещё свободно: приложение, которое шлёт ID устройства, занимает своё место.
  • Ключом: форма нового ключа (см. ниже) с тем же названием и значком ключа, что у своей карточки. Занимает одно место и говорит, сколько ещё свободно.

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

Самообслуживание устройств#

Если включено Устройства на странице (по умолчанию включено), человек сам управляет своими устройствами: приложения по ссылке можно переименовать и удалить (см. Мои устройства), а ключи AmneziaVPN — так. Все изменения вместе ограничены 20 в час с одной клиентской сети и 100 в час на ссылку в целом; сверх этого страница говорит, через сколько минут повторить.

  • Добавить устройство сначала спрашивает, как оно будет подключаться (см. Мои устройства); способ Ключом — это форма: «Вариант подключения» (основной назван по странам своих нод; профиль с WARP — «Запасной выход (если какой-то сайт не открывается)»; профиль 2.0 — «Для старых версий AmneziaVPN (до 5.0.1.5)»), «Что за устройство» и «Название (необязательно)». Ключ открывается сразу.
  • У каждого устройства: Показать ключ — главное действие, и меню ⋯ с пунктами Переименовать, Заменить ключ (старый сразу перестаёт работать) и Удалить (VPN на нём сразу перестаёт работать). Удаление и замена сначала спрашивают, прямо в строке.
  • Окно ключа: Страна (по подключению на каждую ноду; «Каждая страна — отдельное подключение»), Скопировать ключ, Скачать файл, шаги и QR-код. Сервер назван так же, как в карточке Загрузка каналов и в приложении человека: по стране и местоположению, никогда не по имени ноды в панели; нода без того и другого называется «Сервер», а повторяющееся название получает номер («Германия 2»). Подключение ключа в AmneziaVPN называется так же, после названия подписки («Mistgate · Германия 2»).
  • Когда старый ключ перестаёт работать (критичное изменение профиля, новый порт или адрес ноды), у устройства написано «нужен новый ключ», а Получить новый ключ проводит человека через замену.

Ограничения: добавить устройство, показать ключ или заменить его может только активный человек; действует лимит устройств («Все места заняты. Удалите устройство, которым больше не пользуетесь, или напишите — добавим место»); одна клиентская сеть может сделать не больше 20 таких запросов в час, а всего на ссылку приходится не больше 100 запросов. Показ ключа тоже считается. Если параметр выключен, страница перечисляет ключи и пишет «Ключи выдаёт администратор — напишите, если нужен новый.»

Человек с неактивной подпиской по-прежнему видит свои ключи AmneziaVPN, может их переименовать и удалить; добавить новые нельзя.

DNS#

Когда владелец включает Выбор DNS на странице (см. ниже), человек выбирает на своей странице:

  • один DNS для приложений по ссылке (Happ, приложения на ядре mihomo, Xray JSON и sing-box) — из пресетов, которые владелец перечислил под переключателем: карточка вверху раздела Серверы, названная по приложениям, «DNS в Happ и других приложениях по ссылке». Приложения получат новый DNS при следующем обновлении подписки, в пределах интервала обновления, и карточка так и пишет;
  • DNS ключей AmneziaWG каждого сервера — из пресетов, которые владелец предложил на этой ноде: строка DNS ключей в карточке сервера, со значком ключа.

Эти два выбора не смешиваются: первый не доходит до ключей, второй — до приложений по ссылке. Строки DNS ключей видит только тот, кто пользуется ключами AmneziaVPN (приложение у него включено или у него есть ключ), и только на серверах с ключами; тот, кто пользуется и тем и другим, читает под карточкой одну строку о том, что у ключей свой DNS. Если для приложений по ссылке владелец ничего не предлагает, человек с ключами вместо карточки читает, что в приложениях по ссылке DNS один на все серверы, и какой. Сами пресеты и правило, какой DNS действует, описаны в DNS; здесь — что с этим делает страница.

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

Что страница знает о сервере#

По каждому серверу человека страница получает:

  • страну и местоположение, но никогда не имя ноды в панели;
  • отвечает ли нода (если нет — у сервера написано «не отвечает»);
  • уровень загрузки: Низкая, Средняя или Высокая, без процентов (см. Загрузка каналов выше);
  • как сервер называется в приложениях по ссылке. Если шаблон Названия серверов (см. Подписки) содержит {node}, это имя на страницу не попадает, поэтому имя ноды через неё не утекает;
  • только ли для Mihomo-приложений ссылка на сервере. Обфускацию Gecko (см. Hysteria2) понимают только kl!ck и другие приложения на ядре Mihomo, поэтому Happ и остальные приложения со списком ссылок такое подключение не получают. Страница всё равно показывает сервер и пишет на его карточке «Только в kl!ck и других Mihomo-приложениях». Если все серверы человека такие, в приложениях со списком ссылок будет одна запись с этой же причиной вместо пустого списка.

Выбор и применение#

  • Выбор для приложений по ссылке пишется в аудит как page_link_dns_choice: имя человека и пресет. Выбор для ключей сервера делается для одного сервера за раз и пишется как page_dns_choice: имя человека, имя ноды и пресет. Ни там, ни там нет ссылки и адреса.
  • Он считается в общем лимите действий на странице: 20 изменений в час с одной клиентской сети, не больше 100 в час на ссылку в целом.
  • Где это работает, зависит от формата:
    • Ключи AmneziaVPN и AmneziaWG (.conf, vpn://, QR-код): DNS записан внутри ключа, поэтому человеку нужно снова нажать Получить новый ключ. Сам ключ при этом не меняется; пока человек этого не сделал, устройство помечено «нужен новый ключ» с причиной DNS. Метка сравнивает то, что записано в ключе, с тем, что действует для человека на этом сервере сейчас, что бы это ни изменило: его выбор или возврат к умолчанию, смена владельцем предложенных пресетов или умолчания, правка или удаление пресета. Ключ считается полученным, только когда его забирает устройство самого человека: если админ открыл ключ в панели, метка не снимается. Ключ, выданный до того, как это стали отслеживать, помечается только после того, как человек заберёт его хотя бы раз.
    • AmneziaWG-прокси в Mihomo-профиле (Clash Verge Rev, FlClash и т. п.): выбор применится при очередном обновлении подписки.
    • Не по серверам: у Hysteria2 в Mihomo, Happ, Xray JSON и sing-box один резолвер на всю подписку, поэтому там действует DNS приложений по ссылке: выбор самого человека для них или обычный пресет. Выбор по серверам до них не доходит. Другие приложения на base64-формате (v2rayNG, Hiddify, Streisand, Shadowrocket) DNS от панели не получают вообще.
  • В предпросмотре владельца выбор изменить нельзя, как и любое другое действие на странице.

Переключатель#

Подписки → Страница пользователя → Выбор DNS на странице (по умолчанию выключен; панель, настроенная до появления параметра, считается выключенной). Когда он включён, DNS для приложений по ссылке под переключателем перечисляет пресеты, которые человек может выбрать для них, и пресет по умолчанию; пресеты, которые нода предлагает для своих ключей, задаются на ноде. Выключение не стирает уже сделанные людьми выборы: они продолжают действовать, пока вы не сбросите их в карточке пользователя (см. Пользователи и группы).

Предпросмотр в админке#

Подписки → Страница пользователя показывает страницу в рамке телефона рядом с настройками. Предпросмотр как выбирает пользователя (из первых 50); кнопка обновления перезагружает её.

  • Предпросмотр показывает сохранённое: сохраните, и он обновится.
  • Это настоящая страница этого пользователя с его настоящей ссылкой; админка отдаёт её по адресу /preview/user-page/<id пользователя> в рамках вашей сессии. Она не спрашивает пароль страницы и не считается запросом подписки.
  • Ничего записать с неё нельзя: кнопкам самообслуживания некуда отправлять запросы.
  • Открыть её могут только админы, которым видны ссылки пользователей: владелец и помощники.

Кто может открыть страницу#

Любой, у кого есть ссылка, — плюс пароль, если страница его спрашивает. Страница помечена так, чтобы поисковики её не индексировали, её нельзя показать во фрейме чужого сайта, и она ничего не загружает с других адресов. Относитесь к ссылке как к ключу: если она утекла, выдайте новую в карточке пользователя.

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