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

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

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

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

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

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

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

Сверху вниз:

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

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

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

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

Статус Что пишет страница
Срок закончился «Интернет через … сейчас не работает. Напишите — продлим.»
Квота исчерпана, есть сброс «Трафик на этот месяц закончился — до 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 или новее» называет самый старый клиент для версии протокола ключа.

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

Если включено Устройства на странице (по умолчанию включено), человек сам управляет своими ключами AmneziaVPN:

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

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

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

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

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

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

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

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