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

Пользователи и группы

Как создавать пользователей и управлять ими (лимиты, срок, трафик, устройства, доступ), что даёт группа и как переводить людей между группами.

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

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

Что получает человек#

Человек получает сервер, когда выполнено всё:

  • человек активен (не отключён, срок не закончился, квота не исчерпана);
  • профиль есть в группе человека;
  • профиль стоит на ноде, которой человеку можно пользоваться (все ноды или выбранные для него);
  • этот профиль на ноде включён и работает или запускается;
  • один из включённых у человека переключателей приложений разрешает этот протокол.

Любое изменение этих условий сразу уходит на ноды.

Два способа подключения#

По ссылке подписки По ключу AmneziaWG
Приложения Приложения по ссылке (Happ и другие, которые читают ссылки, приложения на ядре mihomo) AmneziaVPN и приложения AmneziaWG
Протокол Hysteria2 (и AmneziaWG для приложений на ядре mihomo) AmneziaWG
Что добавляет человек Одну ссылку на все устройства Свой ключ на каждое устройство
Обновление Приложение само обновляет подписку Ключ импортируют заново вручную
Переключатель у пользователя переключатель с названием приложений по ссылке («Happ» или названия приложений из раздела «Подписки») AmneziaVPN

На странице человека оба способа показаны рядом. Хотя бы один переключатель всегда остаётся включённым. См. Подписки, AmneziaWG и Страница пользователя.

Вкладка «Люди»#

В заголовке — сколько людей и сколько из них онлайн. Над списком:

  • Имя или группа — поиск по имени пользователя или названию группы;
  • фильтры Все, Онлайн сейчас, Истекает скоро (в ближайшие 7 дней) и Превысил квоту, у каждого своё число.
Столбец Что показывает
Имя Имя; Нет доступа, если человек пока ничего не получит (профили группы не стоят ни на одной ноде или ничего не подходит к включённым приложениям и выбранным нодам).
Статус Активен, Истёк, Квота исчерпана, Лимит устройств или Отключён.
Приложение Чем человек на самом деле пользовался за последние 7 дней: Happ, Amnezia или Оба.
Группа Группа.
Устр. Занятые устройства и лимит.
Трафик Израсходованный трафик текущего периода, с полосой относительно квоты.
Срок Сколько дней осталось, ∞ — бессрочно.
Был онлайн «сейчас», пока онлайн, иначе сколько времени назад.
Нода Нода самого свежего подключения.

Лимит устройств — не отдельное состояние: это активный человек, у которого устройства дошли до лимита. Отключённый человек показан как Отключён, что бы ни было ещё; затем идёт Истёк, затем Квота исчерпана.

Список загружается по 50 человек; Показать ещё загружает следующих.

Действия над несколькими#

Отметьте людей в списке (или всех на странице) — появится полоса «Выбрано: 3».

  • Продлить на 30 дней сдвигает срок каждого на 30 дней вперёд от более поздней из двух дат: сегодня или текущий конец срока. Людей без срока пропускает: продление дало бы им срок.
  • Отключить сразу отключает людей. В сообщении несколько секунд есть кнопка Откатить.
  • Отмена снимает выделение.

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

Создание пользователя#

Новый пользователь открывает форму:

Поле По умолчанию Что это
Имя Обязательно, без повторов (регистр не важен), до 64 символов.
Группа «Все», если такая группа есть, иначе первая Строка Получит под ней говорит, что получит человек этой группы: подписку и ключи AmneziaVPN, на скольких нодах. Красная строка предупреждает, если он не получит ничего. Изменить группу открывает группу.
Квота 100 ГБ Шаг 10 ГБ; 0 — Без лимита. В месяц, сброс 1-го числа.
Срок 30 дней Шаг 5 дней; 0 — бессрочно. Потом доступ приостановится.
Устройства 5 1–100: сколько устройств можно подключить.
Приложения в подписке то, что даёт группа Переключатель приложений по ссылке и AmneziaVPN. Пока их не трогали, они следуют за группой: способ, для которого группа ничего не даёт, выключен, и под ним написано почему.
Все ноды включено Новые ноды добавятся сами. Выключено — отметьте ноды; новые не добавятся.
Дополнительно → DNS наследуется Свой DNS-пресет пользователя; пусто — пресет группы или основной. См. DNS.

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

Гигабайты десятичные: 100 ГБ — это 100 000 000 000 байт.

Карточка пользователя#

В шапке — имя и статус, приложения, группа и срок («до 12 октября · 14 дн»), и три кнопки: Отключить (или Включить), Продлить на 30 дней (недоступна у пользователя без срока) и Ссылка подписки.

Под шапкой полоса объясняет остановку и предлагает быстрое решение:

Остановка Полоса Кнопка
Срок закончился «Срок закончился 3 дня назад — доступ приостановлен.» Продлить на 30 дней
Квота исчерпана «Квота 100 ГБ исчерпана — доступ приостановлен, пока она не сбросится или ты её не увеличишь.» +50 ГБ
Лимит устройств «Лимит устройств (5) исчерпан — новое подключить не получится.» +1 устройство

Трафик#

Израсходованный трафик текущего периода относительно квоты, период сброса («сброс 1-го числа»), график за последние 14 дней и трафик по нодам и протоколам.

Устройства#

Счётчик показывает занятые устройства и лимит. Два списка:

  • Через подписку — одна строка, Приложения по ссылке, на все приложения по ссылке на всех устройствах: вместе они занимают одно место. Видно, когда приложения последний раз забирали ссылку. Отключить обрывает их сейчас; они подключатся снова при следующем обновлении подписки.
  • Ключи AmneziaVPN — строка на каждое устройство с платформой, профилем и последним подключением; Показать ключ и Удалить. Добавить устройство создаёт новый ключ. Значок устарел значит, что устройству нужен конфиг заново. См. AmneziaWG.

Удалить отключает устройство и убирает его ключ со всех нод.

Лимиты#

Настройка Шаг и диапазон
Квота 10 ГБ, 0–10000 ГБ; 0 — Без лимита.
Срок 5 дней, до 3650; ∞ — Бессрочно. «−» на ∞ ставит 30 дней.
Устройства 1, от 1 до 100.
Лимит скорости Переключатель включает 20 Мбит/с; дальше шаг 5 Мбит/с, 5–10000. Экспериментально, только Hysteria2.

Изменение сохраняется, как только вы перестаёте нажимать.

Доступ#

  • Группа — при выборе другой группы панель сначала спрашивает у сервера, что изменится, и показывает это: «Алиса потеряет: «AWG 3.1» (перестанут работать 2 ключа AmneziaVPN)», «Получит: …». Сменить группу подтверждает. Ключ AmneziaVPN принадлежит одному профилю, поэтому ключи потерянного профиля перестают работать.
  • Профили группы двумя способами, каждый — ссылка на свою страницу.
  • DNS — свой пресет пользователя или пусто, тогда пресет группы или основной. Строка под ним говорит, какой действует и откуда он.
  • Переключатели приложений.
  • Все ноды или флажки по нодам. Нода, где человеку ничего не подходит, серая; «только Hysteria2» отмечает ноду с одним протоколом. Имя ноды открывает её вкладку Профили, где задаются её собственные порт и домен.

Опасная зона#

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

Периоды квоты#

У пользователя, созданного в админке, квота сбрасывается 1-го числа каждого месяца (UTC). Через API можно задать ещё сброс каждый день, каждую неделю, каждые 30 дней или без сброса; карточка показывает тот, что действует. Когда период заканчивается, трафик снова считается с нуля, а человек, остановленный квотой, получает доступ обратно сам.

Устройства и лимит устройств#

Устройство — это одно место в лимите:

  • все приложения по ссылке одного человека на всех его устройствах — одно устройство («Приложения по ссылке»); приложения на ядре mihomo, которые получают AmneziaWG, тоже входят в него;
  • каждый ключ AmneziaVPN — одно устройство.

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

Вкладка «Группы»#

Группа — это набор профилей, которые получают её люди. Каждая группа — карточка: название, сколько в ней людей (ссылка на отфильтрованный список), её профили двумя способами с числом нод, где они работают, и DNS-пресет, если он задан. На карточке кнопки Изменить и Удалить.

Если групп нет совсем, вкладка предлагает Создать группу «Все» со всеми профилями и Новая группа.

Создание и правка группы#

  • Название, до 64 символов.
  • Профили в группе — у новой группы отмечены все профили; снимите отметку с того, чего группа давать не должна.
  • Ещё → DNS — пресет группы; пусто — основной пресет экземпляра.

Правка группы меняет доступ всем в ней («В группе 3 пользователя — изменение коснётся всех»). Если убрать профиль у группы, где есть люди, панель сначала покажет, что они потеряют и какие ключи AmneziaVPN перестанут работать, а кнопка превратится в «Убрать у 3 человек».

Добавить профиль в группу можно и со страницы профиля (Добавить в группу).

Перевод людей между группами#

  • Одного человека: карточка пользователя → Доступ → Группа, с предпросмотром того, что он потеряет и получит.
  • Всех людей группы: удалить группу с переносом людей (ниже). Массовой смены группы в списке нет.

Удаление группы#

  • Пустая группа удаляется сразу: её профили остаются, удаляется только группа.
  • Группа с людьми спрашивает, куда их перенести («В группе 3 человека. Куда их перенести?»); если есть группа «Все», выбрана она. Перенести 3 человека и удалить переносит их и удаляет группу одним шагом.
  • Если другой группы нет, переносить некуда: сначала создайте другую группу.

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

Пользователей и группы видит любой админ. Владелец и помощники создают, меняют и удаляют пользователей и группы, выдают ссылки и ключи и выбирают DNS-пресеты для пользователей и групп. См. Безопасность.

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