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

SAMM документация

Полное руководство оператора — от первой установки до повседневной эксплуатации.

25 тем 8 разделов Установка одной командой
Быстрая установка

Запуск за считанные минуты одной командой.

Выполните одну команду на чистом сервере Ubuntu или Debian — или в PowerShell на Windows — и установщик загрузит последнюю версию и настроит для вас весь стек SAMM.

Прочтите полное руководство по установке
Ubuntu / Debian — запуск от имени root
curl -fsSL https://samm.securytik.com/install.sh | sudo bash
Windows — запустите в PowerShell от имени администратора
irm https://samm.securytik.com/install-windows.ps1 | iex
Плейлист Видеокурс Смотрите курс по SAMM: от установки до повседневной эксплуатации — полный видеокурс Бесплатный пошаговый плейлист на YouTube, в котором показаны установка SAMM и его повседневное использование — тот же материал, что представлен в данном руководстве, но в формате видео. Смотреть на YouTube

Руководство по началу работы

Обзор & архитектура

SAMM — SecuryTik Active Mikrotik Manager — это полноценная платформа управления ISP для сетей MikroTik PPPoE & Hotspot. Один установщик превращает чистый Linux-сервер в полноценную систему AAA, биллинга и управления абонентами.

Для кого предназначен SAMM

SAMM создан для беспроводных ISP, операторов оптоволоконной связи и провайдеров hotspot, использующих MikroTik RouterOS. Если вы аутентифицируете абонентов через PPPoE, Hotspot или IPoE/DHCP и вам необходимо управлять скоростью доступа, лимитами трафика, сроками действия и биллингом — SAMM позволяет делать всё это с одного экрана.

Абоненты IPoE/DHCP идентифицируются по DHCP Option 82 circuit-id (физический порт доступа — профессиональный метод ISP) или MAC-адресу устройства, а radius-password сервера DHCP является общим секретом RADIUS самого маршрутизатора, поэтому дополнительные настройки не требуются.

IPv6 dual-stack — это опциональная функция: каждый абонент может получить IPv6 вместе с IPv4. Включите её в мастере маршрутизатора, выберите длину делегируемого (DHCPv6-PD) префикса — по умолчанию /56, или любое значение от /48 до /64 — и блоки IPv6 для распределения. В каждом Access-Accept SAMM возвращает пул WAN IPv6 и маршрутизируемый префикс, делегируемый в LAN абонента, чтобы собственный маршрутизатор клиента (в режиме route) разделял его на подсети /64 и использовал SLAAC для своих устройств — это стандартная модель делегирования префиксов ISP. Функция работает с PPPoE, Hotspot и IPoE, а для бизнес-клиентов можно закрепить статический IPv6 префикс за конкретным абонентом.

Принцип работы

SAMM держит hot path максимально близко к базе данных. FreeRADIUS обрабатывает каждый пакет аутентификации и учета; при каждом Interim-Update учета он напрямую вызывает функции PostgreSQL для накопления данных об использовании и проверки лимитов — пока подписчики находятся в сети, никаких обращений к Python не происходит.

Четыре среды исполнения взаимодействуют через единую базу данных:

  • FreeRADIUS (unlang + rlm_sql) — authenticates every packet; on each Interim-Update it accumulates bytes/uptime and evaluates limits inside Postgres.
  • samm-radius — runs time-driven sweeps (expiry, daily reset, speed windows) and is the only process that sends Change-of-Authorization packets.
  • samm-worker — pings routers and syncs MikroTik device metadata over the API.
  • samm-api — the admin & customer portals; admin actions are queued to the database and applied by samm-radius, never sent as CoAs directly.

Пять служб

СлужбаРоль
samm-apiПортал администратора + портал самообслуживания клиентов + REST API
samm-radiusОчищает исходящую очередь CoA; выполняет очистку по истечении срока действия / ежедневный сброс / проверку временных окон скорости
samm-workerОпрашивает маршрутизаторы; синхронизирует метаданные устройств MikroTik через API
samm-notificationОтправляет уведомления по email & Telegram через одну очередь с ограничением скорости
samm-telegramЗапускает интерактивного Telegram-бота для самообслуживания

Что делает SAMM

Ядро AAA

Аутентификация PPPoE & Hotspot, ограничение скорости для каждого пользователя, гибридный CoA.

Лимиты тарифов &

Тарифные планы скорости, четыре независимых лимита и расписание временных интервалов ограничения скорости.

Абоненты

Пользователи PPPoE, Hotspot и IPoE/DHCP, а также предоплаченные ваучеры Hotspot с PDF-файлами для печати.

Биллинг

Ценообразование по тарифам, автоматические счета, книга учета поступлений/платежей/расходов по методу двойной записи.

Самообслуживание

Веб-портал для клиентов и Telegram-бот для управления использованием, счетами и тикетами.

Операции

Живой инвентарь MikroTik, администраторы на основе ролей, резервное копирование и восстановление &, инструменты массовой обработки.

Система

Встроенный VPN WireGuard , туннель Cloudflare , восемь языков, пользовательский интерфейс с возможностью оформления тем.

Уведомления

Оповещения о продлении, истечении срока действия, квотах и квитанциях по email и Telegram.

Остальная часть данного руководства содержит инструкции по каждой из этих областей. Используйте меню слева или начните с раздела Installation.

Руководство по началу работы

Что нового

SAMM обновляется автоматически, поэтому эти функции появятся во всех установках при следующем обновлении. Каждая строка ведет на страницу с описанием использования соответствующей функции.

6.0

  • Дизайны карт: создайте свою печатную карту Hotspot (размер, фон, ваш логотип и QR-код, который входит по карте одним сканированием) или начните с одного из десяти готовых дизайнов. У каждой группы свой дизайн для печати и свой для быстрой печати на термопринтере (80 или 58 mm). Карты Hotspot
  • Добавьте одну карту или импортируйте список: + Card добавляет карту с выбранными вами именем пользователя, паролем и именем; Import загружает список CSV или Excel с предварительным просмотром. Карты Hotspot
  • Оставшееся время и трафик на маршрутизаторе: страница статуса Hotspot показывает остаток на карте, а маршрутизатор завершает сессию, когда он заканчивается. Карты Hotspot
  • Пул IP для каждого пользователя (например, пул CGNAT), выбранный из пулов ваших маршрутизаторов. CGNAT и пулы IP
  • Все часовые пояса мира, с Ближним Востоком в начале списка.
  • Глубокая проверка: выберите ваши MikroTik BNG и продолжительность, затем прочитайте отчёт с оценкой и тем, что делать в первую очередь, на вашем языке, как страницу или PDF. Она только читает роутер. Глубокая проверка
  • SCOOP AI: помощник внизу каждой страницы. Спрашивайте своими словами о пользователях, тарифах, счетах и роутерах; деньги, удаления и изменения на роутерах ждут вашего Approve. SCOOP AI
  • Более быстрые очереди пользователей: держат звонки и игры плавными, пока пользователь скачивает данные. Мастер роутера может их настроить, а Health предлагает исправление в одно нажатие.
  • Панель для каждой роли: выберите, видит ли роль панель управления. Роль без неё открывается на первой разрешённой странице.
  • Sham Cash: на неофициальном подключении пользователь, который забыл код, может подтвердить платёж номером перевода и своим адресом.

5.12

  • Хранение данных и Lookup: храните сессии в течение срока, который требует закон (по умолчанию два года), в том числе для удалённых пользователей, и находите, какой пользователь имел публичный адрес и порт в заданное время. Каждый поиск требует номер дела и сохраняется в журнале Lookup; ежедневный зашифрованный файл может отправляться на ваш NAS. Хранение данных & Lookup
  • CGNAT и пулы IP: делите публичные адреса между пользователями, каждому из которых выделен блок портов, или позвольте SAMM выдавать адрес самостоятельно, для каждого роутера и тарифа. CGNAT & пулы IP
  • Cisco, Huawei, Nokia и ZTE в роли NAS, со скоростями, отключениями, готовой страницей настройки, Data Log и CGNAT на Cisco. Другие марки роутеров
  • FTTH: OLT от V-SOL, Huawei, ZTE и Nokia, каждый ONU с его сигналом, ONU, привязанные к пользователям, и блокировка абонентской линии. FTTH & OLTs
  • Страницы устройств для каждой марки: CPU, память, температура, время работы и графики для OLT и других роутеров, как у MikroTik; форма роутера запрашивает правильный логин для каждого типа. Другие марки роутеров
  • VPN через SAMM для каждого роутера: Через SAMM или Через роутер; платежи Sham Cash никогда не идут через VPN. VPN через SAMM
  • Использование пользователей: карточка Выбранный период (всего, сессии, время онлайн) и полоса с тарифом, статусом, сроком действия, адресом и MAC; бот Telegram показывает свои команды на языке пользователя. Пользователи
  • Мы настроим ваш сервер: закажите готовый сервер SAMM с вашим собственным доменом .com в панели управления. Настройте ваш сервер

5.11

  • Касса: кассовая страница в разделе Бухгалтерия. Найдите пользователя по имени, номеру мобильного или части имени пользователя прямо при вводе, затем примите оплату, продлите, добавьте квоту или пополните кошелёк наличными. У неё своё разрешение с четырьмя флажками, она не показывает прибыль и отчёты и находит только пользователей филиала кассира. Бухгалтерия, Администраторы, филиалы и роли
  • Срок оплаты счёта на ваш выбор: «Счёт к оплате через (дней)» в настройках бухгалтерии. При 0 счёт подлежит оплате сразу после выставления, а автопродление — в день окончания тарифа, поэтому льготный период отсчитывается от даты окончания. Бухгалтерия
  • Компенсация при переходе на более дешёвый тариф: при переводе пользователя на более дешёвый тариф неиспользованную часть периода можно вернуть в кошелёк или наличными, сумма видна до сохранения. Смена тарифа есть и в меню строки списка пользователей. Пользователи
  • Автопродление оплачивается из кошелька, а кошелёк должника гасит долг до приостановки аккаунта. Бухгалтерия
  • Уведомления по каналам: выберите каналы для каждого уведомления, отправляйте по всем и пишите отдельный текст SMS с живым счётчиком символов. Уведомления
  • VPN через SAMM без туннеля для роутеров в одной сети с SAMM, а родительский контроль и VPN пользователя управляются из панели администратора. VPN через SAMM
  • Квота интерфейса, которая сбрасывается правильно: Reset quota начинает отсчёт с нуля и сразу возвращает интерфейс, в любой момент, а на странице видно потребление с последнего сброса. Менеджер MikroTik
  • Списки сайтов и приложений по роутерам: каждый роутер показывает, актуален ли его список, с кнопкой Применить и находками на странице Состояние; значения мониторинга обновляются каждые 5 секунд. Менеджер MikroTik

5.9

  • Внешние VPN-провайдеры: добавьте аккаунт NordVPN, Mullvad, IVPN или AirVPN в один шаг, выберите количество серверов и страну или загрузите файлы от любого провайдера, например ProtonVPN. Каждый пользователь остаётся на одном подключении, подключения делят нагрузку по весу, а если одно из них прекращает работу, его пользователи сохраняют доступ в интернет через собственный канал SAMM. VPN через SAMM
  • Дополнительный трафик как опция: продавайте больше трафика без изменения тарифа или срока действия пользователя — пакетом или по цене за GB, в панели или в пользовательском портале. Опции
  • Беспроводные секторы: каждое радиоустройство пользователя с сектором, на котором оно находится, временем пребывания и каждым перемещением, хранится год; коммутаторы за вашими секторами с пользователями на каждом; а на странице пользователя — цепочка сектор › радиоустройство › коммутатор › пользователь с сигналом, дальностью и качеством. Сеть
  • Наблюдайте за пользователем 24, 48 или 72 часа: время онлайн, скорость, сигнал, сектор и каждое отключение с его причиной, а затем отчёт для печати с графиками и краткими выводами. Пользователи
  • Карта сети на OpenStreetMap: отметьте ваши роутеры, секторы и пользователей там, где они находятся на самом деле, рядом со схемой сети. Сеть
  • Обновления списка приложений: SAMM проверяет список приложений SecuryTik каждый день; выберите «Уведомлять», «Применять автоматически» или «Выкл.» и верните предыдущий список одним кликом. Менеджер MikroTik
  • Даты «С» и «По» в каждом поиске, где есть дата, фильтры «Родительский контроль» и VPN в списке пользователей, а также одна и та же страница в стольких окнах, сколько у вас экранов. Пользователи, Панель управления
  • Переход с ADV Radius: перенесите пользователей и тарифы из его файла резервной копии вместе с паролями, датами окончания, статическими адресами и ограничениями тарифов. Инструменты

5.8

  • Внешний VPN: пользователи VPN выходят через NordVPN (по токену доступа) или файлы WireGuard любого провайдера вместо собственной линии SAMM, даже если у SAMM нет публичного адреса. VPN через SAMM
  • VPN через SAMM: выбранные пользователи направляют весь свой трафик или только выбранные ими приложения через ваш сервер SAMM вместо своей локальной линии. Разрешите это для отдельного пользователя или продавайте как дополнение; пользователи включают его в пользовательском портале. VPN через SAMM
  • SAMM на двух экранах: откройте любую страницу или отдельный блок панели мониторинга в собственном окне и держите его на втором мониторе. Панель мониторинга
  • Родительский контроль как дополнение: продавайте родительский контроль на определённый срок, как любое другое дополнение. Дополнения
  • Wi-Fi optimizer: мониторинг спектра каждого радиомодуля в реальном времени, отображение видимых сетей и степени загруженности каждого канала, а также планировщик, который рекомендует наименее загруженный канал и оптимальную ширину полосы, и может самостоятельно перенастроить радиомодули в ночное время. Сеть
  • Устройства Ubiquiti: добавляйте точки доступа UniFi и радиомодули airOS в качестве отслеживаемых устройств. Радиомодули UniFi отображают своих клиентов, соседние сети и спектр, а оптимизатор действительно переводит их на более подходящий канал и ширину. Менеджер устройств MikroTik
  • Три монитора для каждого маршрутизатора на любом тарифе: точки доступа и радиомодули, за которыми вы только наблюдаете, больше не расходуют лимит маршрутизатора. MikroTik менеджер устройств
  • Импортируйте пользователей, которые уже созданы на маршрутизаторе (PPP, Hotspot и User Manager, RouterOS 6 и 7) вместе с их паролями, тарифами, лимитами, именами, номерами телефонов и датами окончания действия в фоновом режиме. MikroTik менеджер устройств
  • Отмена продления: удаление счета за продление может вернуть дату истечения срока действия пользователя к прежнему значению; действие Renew Plan можно отменить с помощью верхней панели, а в списке Invoices отображаются итоги по всем позициям, выбранным фильтром. Отмена & согласования
  • Резервное копирование в ваш Google Drive. Подключите Google Drive в разделе Backup & Restore с помощью короткого кода; после этого каждая автоматическая резервная копия будет также копироваться в папку SAMM Backups в вашем Drive, и любую из них можно будет использовать для восстановления. Инструменты
  • Фиксированное время продления в тарифе: дата истечения срока всегда приходится на выбранное вами время с округлением в большую сторону, чтобы пользователь никогда не получал период меньше оплаченного. Тарифы
  • Список адресов по тарифу: маршрутизатор добавляет адрес каждого пользователя в список, название которого совпадает с названием его тарифа, для использования в ваших собственных правилах межсетевого экрана, очередей и маршрутизации. Тарифы
  • Режим Self Service Collect: гости вводят свое имя и номер мобильного телефона и сразу получают доступ в сеть без пароля; данные о каждом входе сохраняются для экспорта. Self Service
  • Более наглядный график качества соединения с осями, линиями загрузки и отдачи, подробностями при наведении и объемом использованных данных, а также поиск по e-mail в разделе Users и по любому порту в Data Log. Users, Data Log

5.7

  • Филиалы владеют своими устройствами. Каждый маршрутизатор и точка доступа принадлежит филиалу или головному офису; сотрудники филиалов управляют своими устройствами и могут просматривать только те, что находятся выше них в иерархии, а специальная настройка позволяет пользователям входить в систему только через маршрутизаторы своего филиала. Администраторы, филиалы & роли
  • Ограничения времени ролей. Ограничьте количество периодов или дней, которые может предоставить роль, установите для новых пользователей фиксированное время (например, 2 часа) и разделите функцию «Добавить дни» и ввод даты истечения срока. Администраторы, филиалы & роли
  • SSTP VPN наряду с WireGuard и L2TP/IPsec для нескольких маршрутизаторов за одним публичным адресом. VPN
  • RouterOS 6 работает везде: в мастере, Auto-Complete, доставке конфигураций, массовых действиях, Websites & Apps, QoS и VPN-каналах. RouterOS 6
  • Родительский контроль в портале пользователя: блокировка категорий, приложений и веб-сайтов, постоянно или по еженедельному календарю. Родительский контроль
  • Баллы & вознаграждения за продление и приглашенных друзей, которые можно потратить на увеличение скорости или бесплатные дни. Баллы & вознаграждения
  • Ваш бренд на панели администратора, пользовательском портале и страницах входа с логотипом, который можно обрезать прямо в браузере. Брендинг
  • Переключение языков, видимость тарифов в портале, режим шаблонов SMS и установка SAMM одной командой на маршрутизатор MikroTik. Языки, Тарифы, Контейнер MikroTik

5.6

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

5.5

  • Поиск в Data Log по всем пользователям: кто обращался к адресу, порту, протоколу или приложению в любой период. Data Log
  • Детальные разрешения в меню Редактировать (удаление пользователей, продление, смена тарифа, оплата счетов, запуск скриптов маршрутизатора…), а также предпросмотр новой даты истечения перед продлением. Роли

5.4

  • Финансы по филиалам: каждый счет, платеж, расход и кассовый счет привязаны к филиалу; доступны выбор филиала, передача наличности и отчет по филиалам. Бухгалтерия & биллинг

5.3

  • Sham Cash, единая форма оплаты для всех способов платежа, публичная Pay page и Renew online на срок от 1 до 12 периодов. Онлайн-платежи
  • Скидки в счетах, дополнения с бесплатными приложениями, отчет об активациях, смена имени пользователя и авансовые платежи при продлении. Add-ons

5.2

  • Dynamic Speed Booster, Действия менеджера устройств на многих маршрутизаторах одновременно, дополнения, прайс-листы по филиалам, файлы пользователей, пользовательские поля, страница Traffic и очистка истории. Speed Booster, Действия менеджера устройств

Руководство по началу работы

Установка

SAMM устанавливает всё необходимое — FreeRADIUS, PostgreSQL, nginx, WireGuard, cloudflared и пять служб SAMM — одним шагом. Инсталлятор идемпотентен: повторный запуск обновляет существующую установку без удаления данных и никогда не перезаписывает вашу конфигурацию и не генерирует заново пароль базы данных.

Руководство по установке

Каждый шаг со скриншотами: Windows (включая включение виртуализации в BIOS), Ubuntu, маршрутизатор MikroTik, готовый сервер, лицензия (оплата, привязка, продление), подключение маршрутизаторов через VPN и дополнительные функции.

SAMM работает где угодно — выберите путь установки, подходящий для вашей сети:

Предварительные требования

  • Чистый сервер: Ubuntu 22.04 / 24.04 / 26.04 LTS или Debian 12 / 13. Только серверные дистрибутивы Linux — десктопные версии не поддерживаются.
  • Доступ Root / sudo и подключение к интернету.
  • systemd и хост, на котором может быть локально установлен PostgreSQL (один уже настроен).

Установка

Вариант A — установка одной командой

На сервере выполните:

curl -fsSL https://samm.securytik.com/install.sh | sudo bash

Этот bootstrap-скрипт загружает последний релиз-бандл SAMM с GitHub, извлекает его и автоматически запускает полный установщик. Процесс займет несколько минут.

Если github.com заблокирован в вашей стране, используйте зеркало на базе Cloudflare — установщик тот же, данные с GitHub не загружаются. (Стандартная команда выше также определяет блокировку GitHub и автоматически переключается на это зеркало.)

curl -fsSL https://dl.securytik.com/install.sh | sudo bash

В любом случае, после завершения работы установщика откройте портал администратора и войдите в систему, используя следующие учетные данные:

URL для входаhttp://<your-server>/admin · Имя пользователяadmin · Парольadmin

Смените пароль администратора сразу после первого входа в систему.

Установка

Вариант B — установка на Windows (Hyper-V)

SAMM работает в Windows внутри собственной небольшой виртуальной машины Ubuntu 24.04 на Hyper-V, которая создается и управляется одним установщиком. VM подключается к вашей сети со своим IP-адресом, поэтому ваши маршрутизаторы MikroTik обращаются к SAMM напрямую — RADIUS видит реальный адрес каждого маршрутизатора, и CoA-отключения работают точно так же, как на Linux-сервере.

Откройте PowerShell от имени администратора — не командную строку (cmd): нажмите правой кнопкой мыши на кнопку «Пуск», выберите Terminal (Admin) или Windows PowerShell (Admin), подтвердите действие, нажав «Да». Затем запустите:

irm https://samm.securytik.com/install-windows.ps1 | iex

Если samm.securytik.com недоступен с этого ПК, используйте вместо него зеркало на Cloudflare — это тот же установщик. (Установщик и сам переключается на зеркало, если загрузка не удалась.)

irm https://dl.securytik.com/install-windows.ps1 | iex

В любом случае, после завершения работы установщика откройте портал администратора и войдите в систему, используя следующие учетные данные:

URL для входаhttp://<SAMM IP>/admin · Имя пользователяadmin · Парольadmin
Вход в ОС (SSH)samm / samm · Root (консоль)root / samm

Те же значения по умолчанию, что и в SAMM Server ISO. Измените их все после первого входа. Ярлык SAMM Info на рабочем столе снова отобразит эти данные, а также IP-адрес SAMM и способ подключения к VM по SSH.

Что запрашивается

  1. К какой сети должен подключиться SAMM, если у ПК подключено более одного адаптера. Нажмите Enter для рекомендуемого варианта (проводное соединение важнее Wi-Fi).
  2. IP-адрес SAMM в этой сети. Система предложит свободный адрес; нажмите Enter, чтобы принять его, введите другой или введите dhcp.

Если Hyper-V выключен, установщик включит его и предложит один раз перезагрузить Windows; после повторного входа в систему процесс продолжится автоматически. Остальное — Multipass, сетевой мост, VM и сам SAMM — занимает от 10 до 20 минут, при этом отображается индикатор выполнения.

Требования

  • Windows 10 / 11 Pro, Enterprise или Education, или Windows Server 2019 и более новые версии (64-бит). В Windows Home отсутствует Hyper-V.
  • Аппаратная виртуализация включена в BIOS/UEFI (Intel VT-x или AMD-V). Инсталлятор проверяет этот параметр и, если он выключен, прекращает работу с соответствующим уведомлением — см. Включить виртуализацию.
  • Минимум 8 GB оперативной памяти, из которых 4 GB должны быть свободны для VM SAMM (минимум 3 GB; другие виртуальные машины — VMware, VirtualBox — учитываются в этом объеме), и 40 GB свободного места на диске.
  • Настоятельно рекомендуется сетевой кабель. Многие драйверы Wi-Fi не могут связать виртуальную машину с сетью через мост, и тогда SAMM будет доступен только самому ПК.

После установки

  • Откройте панель администратора по адресу http://<SAMM IP>/admin/login (на рабочем столе есть ярлык SAMM Admin), войдите, используя данные admin / admin, и сразу смените пароль.
  • Настройте RADIUS вашего MikroTik на IP-адрес SAMM (UDP 1812/1813) — мастер настройки маршрутизатора в панели сделает это за вас.
  • SAMM запускается вместе с Windows, ещё до входа пользователя в систему, а ПК настроен так, чтобы никогда не переходить в спящий режим. На ноутбуке держите зарядное устройство подключённым и установите для закрытия крышки действие «Ничего не делать».
  • Для удаления: выполните ту же команду с параметром -Uninstall или & ([scriptblock]::Create((irm https://samm.securytik.com/install-windows.ps1))) -Uninstall.

Установка

Включите виртуализацию в BIOS/UEFI

SAMM в Windows работает в виртуальной машине Hyper-V, для которой нужна функция виртуализации процессора: Intel Virtualization Technology (VT-x) у Intel, или AMD-V — обычно называемая SVM Mode — у AMD. У большинства ПК она включена по умолчанию; у некоторых выключена. Каждый производитель прячет её в своём меню, поэтому ниже приведены общие шаги и её обычное расположение.

Сначала проверьте, включено ли оно

Откройте Менеджер задач (Ctrl+Shift+Esc) → Производительность → CPU. Надпись Виртуализация: Включена под графиком означает, что всё готово. (Если Hyper-V уже включен, Windows может вместо этого вывести сообщение о том, что гипервизор обнаружен — это также означает, что он включен.)

Общие шаги

  1. Сохраните свою работу и перезагрузите ПК.
  2. Войдите в настройки BIOS/UEFI: многократно нажимайте клавишу настройки, как только загорится экран (см. таблицу). В Windows 10/11 вы также можете перейти в Settings → System → Recovery → Advanced startup → Restart now, затем в Troubleshoot → Advanced options → UEFI Firmware Settings → Restart.
  3. Найдите Intel Virtualization Technology, Intel VT-x, SVM Mode или AMD-V в меню Advanced, Advanced CPU, Processor, Chipset, Security или Virtualization и установите значение Enabled. (Intel VT-d / AMD IOMMU не требуются.)
  4. Сохраните изменения и выйдите (обычно F10), дождитесь запуска Windows, затем снова запустите установщик SAMM.

Обычное расположение

БрендКлюч настройкиОбычное место
DellF2Поддержка виртуализации → Виртуализация / Включить Intel Virtualization Technology
HPF10 (или Esc, затем F10)Дополнительно (или Security / System Configuration) → Virtualization Technology (VTx)
LenovoF1 / F2 (или кнопка Novo)Безопасность (ThinkPad) или Конфигурация → Intel Virtualization Technology / AMD SVM Technology
ASUSF2 / DelРасширенный режим (F7) → Advanced → CPU Configuration → Intel Virtualization Technology или SVM Mode
AcerF2Advanced (или Main) → Intel Virtualization Technology
MSIDelOC → CPU Features → Intel Virtualization Tech или SVM Mode
GigabyteDelTweaker (или Advanced) → Advanced CPU Settings → Intel Virtualization Technology или SVM Mode
Серверы (Dell iDRAC, HPE, Supermicro)F2 / F9 / DelНастройки Processor → Virtualization Technology — часто уже включена
Виртуальная машина внутри другой виртуальной машины (например, Windows, запущенная в VMware, Proxmox или Hyper-V) требует включения вложенной виртуализации в основном гипервизоре — например, опции «Virtualize Intel VT-x/EPT» в настройках CPU в VMware при выключенной VM.

Установка

Вариант C — ручная установка из пакета релиза

Загрузите последний архив samm-<version>.tar.gz со страницы GitHub Releases, затем на сервере:

tar -xzf samm-<version>.tar.gz
cd samm-<version>
sudo bash install.sh

Вы также можете выполнить развертывание из zip-архива, созданного на другом устройстве — установщик rsync исходные данные непосредственно в /opt/samm:

mkdir -p /opt/samm && unzip samm.zip -d /tmp/samm-bundle
sudo bash /tmp/samm-bundle/samm/install.sh

Или клонируйте репозиторий в /opt/samm и выполните sudo bash /opt/samm/install.sh.

В любом случае, после завершения работы установщика откройте портал администратора и войдите в систему, используя следующие учетные данные:

URL для входаhttp://<your-server>/admin · Имя пользователяadmin · Парольadmin

Смените пароль администратора сразу после первого входа в систему.

Установка

Вариант D — установка с помощью Docker Compose

Если вы предпочитаете запускать SAMM в контейнерах — тот же продукт, но в другом виде поставки — используйте дистрибутив Docker Compose по адресу github.com/mhdhaidarah/samm-docker. На любом хосте с установленным Docker:

curl -fsSL https://github.com/mhdhaidarah/samm-docker/releases/latest/download/install.sh | sudo bash

Это установит Docker при его отсутствии, поместит docker-compose.yml в /opt/samm-docker/ с уже заполненным сильным случайным паролем базы данных и запустит стек. Образ mhdhaidarah/samm собирается из того же скомпилированного бандла, что и bare-OS-установка — закрытый исходный код by design.

Multi-arch — один и тот же тег используется для linux/amd64 и linux/arm64, а подходящий вариант выбирается автоматически: docker pull на любом Docker-хосте (Intel/AMD, ARM-сервер, Apple-silicon Mac) и MikroTik RouterOS 7.23+ на самом маршрутизаторе. Один файл для всех платформ.

На хостах, где передача вывода curl в bash запрещена (заблокированные системы, строгие политики исходящего трафика), вы можете скачать готовый к запуску compose-файл напрямую:

git clone https://github.com/mhdhaidarah/samm-docker.git
cd samm-docker
# optional: edit docker-compose.yml and replace change-me-strong-random-string
docker compose up -d

Некоторые функции еще не реализованы в Docker-варианте (поэтапное ограничение лицензии, динамическая перезагрузка FreeRADIUS). Встроенные страницы администратора WireGuard и Cloudflare Tunnel намеренно скрыты в Docker-варианте — они управляют службами systemd на уровне хоста, которые недоступны изнутри контейнера. Выберите вариант A или C выше, если вам нужны эти встроенные функции, или запустите cloudflared / wg-quick непосредственно на Docker-хосте вместе с SAMM. См. README Docker-варианта для полного списка ограничений v1 и пути ручной установки.

На Windows (Docker Desktop) — только для ознакомления

Не рекомендуется для использования в продакшене. Спящий режим / гибернация / закрытие крышки Windows останавливают контейнеры; перезапуск при загрузке срабатывает только при запуске WSL (не при загрузке Windows); ежедневный cron автообновления работает только пока активен WSL. Используйте этот вариант для оценки / демо, а для продакшена разверните систему на Linux VM (Hyper-V, Proxmox, ESXi) или на небольшом физическом устройстве (например, NUC под управлением Ubuntu Server).

Установите Docker Desktop для Windows (это позволит настроить бэкенд WSL2 при первом запуске). Затем из PowerShell — терминал WSL не требуется — скачайте compose-бандл и запустите стек:

mkdir C:\samm-docker
cd C:\samm-docker
curl.exe -fLO https://github.com/mhdhaidarah/samm-docker/releases/latest/download/docker-compose.yml
# optional: notepad docker-compose.yml — replace change-me-strong-random-string with your own password
docker compose pull
docker compose up -d

Следите за загрузкой стека в Docker Desktop → Containers — группа samm развернется в 8 служб. Когда все они станут зелеными, откройте портал администратора и войдите, используя следующие учетные данные:

URL для входаhttp://localhost:8000/admin · Имя пользователяadmin · Парольadmin

Смените пароль администратора сразу после первого входа в систему.

Если реальный MikroTik NAS будет обращаться к этому хосту Windows по протоколу RADIUS, разрешите UDP 1812 + 1813 в межсетевом экране Windows:

New-NetFirewallRule -DisplayName "SAMM RADIUS" -Direction Inbound -Protocol UDP -LocalPort 1812,1813 -Action Allow

Удаление: docker compose down -v из директории установки (флаг -v удаляет том postgres и ключ Fernet — сначала создайте их резервные копии, если вы добавляли данные).

Установка

Вариант E — установка на маршрутизатор MikroTik (RouterOS 7.23+)

Тот же SAMM, Linux-сервер не требуется. Если ваше устройство MikroTik поддерживает пакет container и к нему подключен USB-накопитель или карта microSD, вы можете запустить весь стек прямо на маршрутизаторе — с тем же docker-compose.yml, который используется везде. RouterOS 7.23+ автоматически определяет нужную архитектуру CPU из multi-arch тегов образа, поэтому загружать что-либо специально для маршрутизатора не нужно.

Поддерживаются: все маршрутизаторы MikroTik с поддержкой контейнеров — RB5009, hAP ax², CCR2004-1G-12S+2XS, CCR2116, CCR2216, L009 и аналогичные (arm64), а также x86 RouterOS и CHR (amd64). Не поддерживаются: устройства armv7 / mipsbe / smips / tile / ppc (hEX, RB750, старые модели RB) — из-за отсутствия поддержки контейнеров или недостаточного объема RAM/CPU для стека SAMM. Требуется RouterOS 7.23 или новее (в более старых версиях невозможно выбрать архитектуру из multi-arch тега).

Быстрый способ: одна вставленная строка

Откройте терминал маршрутизатора (WinBox → New Terminal или SSH) и вставьте эту строку:

/tool fetch url="https://samm.securytik.com/install-routeros.rsc" dst-path=samm-install.rsc; /import samm-install.rsc

Скрипт проверяет версию RouterOS, CPU и память маршрутизатора, устанавливает пакет container, включает режим container, находит диск ext4 объемом не менее 30 GB, загружает SAMM с надежным случайным паролем базы данных, запускает его и ждет ответа от панели. Когда система попросит вас об этом (после перезагрузки, после цикла выключения-включения питания, после подготовки диска), вставьте ту же строку снова: каждый шаг проверяет, что уже сделано, и продолжает работу. Скрипт никогда не форматирует диск самостоятельно и не затрагивает уже запущенные процессы.

Предпочитаете сделать это вручную? Выполните следующие шаги.

1. Подготовка маршрутизатора

Установите пакет container (из extra_packages.zip на mikrotik.com/download — выполните отдачу соответствующего container-*.npk через Files, затем перезагрузите). Затем включите режим container (однократно — он активируется только после полного цикла выключения питания, а не программной перезагрузки):

/system device-mode update container=yes
# HARD reboot the router (unplug the power) — a soft /system reboot
# will NOT activate the container feature

2. Форматирование и монтирование диска (ext4)

Вставьте USB-накопитель или карту microSD (рекомендуется ≥ 8 GB — Postgres и слои образа в сумме занимают значительный объем). На маршрутизаторе:

/disk print
# note the disk slot, e.g. "usb1-part1" or "disk1"
/disk format usb1-part1 file-system=ext4 label=samm

После форматирования убедитесь, что диск смонтирован и доступен для записи:

/disk print detail
# look for "type=ext4" and a mount point like "/usb1-part1"

Затем укажите маршрутизатору, откуда загружать образы (Docker Hub) и куда их распаковывать — без этого каждый контейнер SAMM завершится с ошибкой "download/extract error: no registry url set":

/container config set registry-url=https://registry-1.docker.io tmpdir=samm/tmp layer-dir=samm/layers
# "samm" = your disk's Mount Point (System > Disks > the disk > Mount Point)
# if layer-dir is refused on your RouterOS version, keep only tmpdir
/ip dns set servers=8.8.8.8,1.1.1.1
:put "ok"
Видите сообщение «no registry url set» или «not enough disk space to download layer»? Выполните указанные выше команды — папка загрузки должна находиться на USB/microSD диске (в точке его монтирования), а не во внутреннем хранилище маршрутизатора. Затем в App → samm снимите флажок Enabled, нажмите Применить, снова установите флажок и нажмите Применить: маршрутизатор заново загрузит все части SAMM и запустит их.

3. Скопируйте compose-файл

Один файл для каждой платформы. Замените change-me-strong-random-string (пароль Postgres — используйте одно и то же надежное значение везде, где оно встречается) и change-me-random-token. Затем в WebFig/WinBox: Container → Apps → + New → YAML, вставьте текст, выберите диск ext4 из шага 2 в качестве хранилища и нажмите Submit. RouterOS 7.23+ автоматически определяет нужную архитектуру CPU по тегам образа.

Застряло на "waiting for reverse proxy"? В RouterOS 7.23+ снимите флажок Use HTTPS в диалоге Apps и разверните заново — эта опция управляет прокси веб-интерфейса приложения, а не загрузкой образов.
docker-compose.yml
name: samm

services:
  postgres:
    image: postgres:16-alpine
    restart: unless-stopped
    environment:
      POSTGRES_DB: samm
      POSTGRES_USER: samm
      POSTGRES_PASSWORD: change-me-strong-random-string
      TZ: UTC
    volumes:
      - pgdata:/var/lib/postgresql/data
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U samm -d samm"]
      interval: 10s
      timeout: 5s
      retries: 12

  samm-api:
    image: mhdhaidarah/samm:latest
    restart: unless-stopped
    command: ["api"]
    environment:
      SAMM_ROLE: api
      POSTGRES_HOST: postgres
      POSTGRES_PORT: 5432
      POSTGRES_DB: samm
      POSTGRES_USER: samm
      POSTGRES_PASSWORD: change-me-strong-random-string
      TZ: UTC
      SAMM_API_HOST: 0.0.0.0
      SAMM_API_PORT: 8000
      SAMM_API_WORKERS: 2
      WA_BRIDGE_URL: http://wa-bridge:8787
      WA_BRIDGE_TOKEN: change-me-random-token
      SAMM_SCOOP_URL: http://samm-scoop:4097
    depends_on:
      postgres:
        condition: service_healthy
    healthcheck:
      test: ["CMD-SHELL", "curl -fsS http://127.0.0.1:8000/health >/dev/null || exit 1"]
      interval: 10s
      timeout: 5s
      retries: 30
      start_period: 1800s
    ports:
      - "8000:8000"
    volumes:
      - etcsamm:/etc/samm
      - sammvar:/opt/samm/var
      - sammlogs:/var/log/samm
      - sammlocales:/opt/samm/app/locales

  samm-scoop:
    image: mhdhaidarah/samm:latest
    restart: unless-stopped
    command: ["scoop"]
    environment:
      SAMM_ROLE: scoop  # see samm-api notes — parser-agnostic role hint
      POSTGRES_HOST: postgres
      POSTGRES_PORT: 5432
      POSTGRES_DB: samm
      POSTGRES_USER: samm
      POSTGRES_PASSWORD: change-me-strong-random-string
      TZ: UTC
      SAMM_API_URL: http://samm-api:8000
    depends_on:
      samm-api:
        condition: service_healthy
    volumes:
      - etcsamm:/etc/samm
      - sammvar:/opt/samm/var
      - scoopengine:/opt/samm/runtime/scoop
      - scoophome:/var/lib/samm-scoop

  samm-radius:
    image: mhdhaidarah/samm:latest
    restart: unless-stopped
    command: ["radius"]
    environment:
      SAMM_ROLE: radius  # see samm-api notes — parser-agnostic role hint
      POSTGRES_HOST: postgres
      POSTGRES_PORT: 5432
      POSTGRES_DB: samm
      POSTGRES_USER: samm
      POSTGRES_PASSWORD: change-me-strong-random-string
      TZ: UTC
    depends_on:
      postgres:
        condition: service_healthy
      samm-api:
        condition: service_healthy
    volumes:
      - etcsamm:/etc/samm
      - sammvar:/opt/samm/var
      - sammlogs:/var/log/samm

  samm-worker:
    image: mhdhaidarah/samm:latest
    restart: unless-stopped
    command: ["worker"]
    environment:
      SAMM_ROLE: worker  # see samm-api notes — parser-agnostic role hint
      POSTGRES_HOST: postgres
      POSTGRES_PORT: 5432
      POSTGRES_DB: samm
      POSTGRES_USER: samm
      POSTGRES_PASSWORD: change-me-strong-random-string
      TZ: UTC
    depends_on:
      postgres:
        condition: service_healthy
      samm-api:
        condition: service_healthy
    cap_add:
      - NET_RAW
    sysctls:
      - net.ipv4.ping_group_range=0 2147483647
    volumes:
      - etcsamm:/etc/samm
      - sammvar:/opt/samm/var
      - sammlogs:/var/log/samm

  samm-notification:
    image: mhdhaidarah/samm:latest
    restart: unless-stopped
    command: ["notification"]
    environment:
      SAMM_ROLE: notification  # see samm-api notes — parser-agnostic role hint
      POSTGRES_HOST: postgres
      POSTGRES_PORT: 5432
      POSTGRES_DB: samm
      POSTGRES_USER: samm
      POSTGRES_PASSWORD: change-me-strong-random-string
      TZ: UTC
      WA_BRIDGE_URL: http://wa-bridge:8787
      WA_BRIDGE_TOKEN: change-me-random-token
    depends_on:
      postgres:
        condition: service_healthy
      samm-api:
        condition: service_healthy
    volumes:
      - etcsamm:/etc/samm
      - sammvar:/opt/samm/var
      - sammlogs:/var/log/samm

  samm-telegram:
    image: mhdhaidarah/samm:latest
    restart: unless-stopped
    command: ["telegram"]
    environment:
      SAMM_ROLE: telegram  # see samm-api notes — parser-agnostic role hint
      POSTGRES_HOST: postgres
      POSTGRES_PORT: 5432
      POSTGRES_DB: samm
      POSTGRES_USER: samm
      POSTGRES_PASSWORD: change-me-strong-random-string
      TZ: UTC
    depends_on:
      postgres:
        condition: service_healthy
      samm-api:
        condition: service_healthy
    volumes:
      - etcsamm:/etc/samm
      - sammvar:/opt/samm/var
      - sammlogs:/var/log/samm

  wa-bridge:
    image: mhdhaidarah/samm:wa-bridge-latest
    restart: unless-stopped
    environment:
      WA_BRIDGE_TOKEN: change-me-random-token
      TZ: UTC
    depends_on:
      - samm-api
    volumes:
      - wabridge_auth:/data/auth      # multi-device session — persists the QR link

  freeradius:
    image: mhdhaidarah/samm:freeradius-latest
    restart: unless-stopped
    environment:
      POSTGRES_HOST: postgres
      POSTGRES_PASSWORD: change-me-strong-random-string
      TZ: UTC
    depends_on:
      postgres:
        condition: service_healthy
      samm-api:
        condition: service_healthy
    ports:
      - "1812:1812/udp"
      - "1813:1813/udp"

volumes:
  pgdata: {}
  etcsamm: {}
  sammvar: {}
  sammlogs: {}
  sammlocales: {}
  wabridge_auth: {}      # WhatsApp bridge multi-device session
  scoopengine: {}        # SCOOP AI engine (OpenCode) and the previous one, for rollback
  scoophome: {}          # SCOOP AI's saved AI logins and conversations

4. Проверка и подключение MikroTik к SAMM

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

URL для входаhttp://<router-ip>:8000/admin · Имя пользователяadmin · Парольadmin

Немедленно измените пароль администратора. RADIUS auth + accounting доступны по UDP 1812 + 1813 на самом маршрутизаторе, поэтому RADIUS-клиент MikroTik может быть настроен на 127.0.0.1 с общим секретом, который вы указали в System → RADIUS.

Экспериментальный путь развертывания. Функция контейнеров в RouterOS более упрощена, чем Docker Compose: DNS по именам служб, порядок зависимостей (depends_on) и перезапуски на лету работают иначе. Если стек работает некорректно на вашем оборудовании, вернитесь к использованию Docker на небольшом устройстве с Linux (NUC, Pi 4, Linux VM) рядом с MikroTik. Тот же compose-файл будет работать там со всей семантикой Compose.

Автоматический запуск SAMM после перезагрузки или сбоя

RouterOS создает контейнеры приложения без автозапуска. Выполните это один раз после установки: каждый контейнер SAMM будет запускаться вместе с маршрутизатором и перезапускаться при остановке, а небольшой watchdog будет каждую минуту запускать любой остановленный контейнер.

/container set [find where name~"^app-samm"] start-on-boot=yes restart-policy=always
/system scheduler remove [find name=samm-watchdog]
/system scheduler add name=samm-watchdog start-time=startup interval=1m on-event=":foreach c in=[/container find where name~\"^app-samm\" and stopped] do={/container start \$c}"
:put "ok"

5. Обновление — резервное копирование и восстановление вручную

Обновление контейнерного приложения MikroTik приводит к удалению базы данных. RouterOS не поддерживает обновление версии установленного приложения «на месте» — единственный способ заключается в том, чтобы удалить приложение и добавить его заново. При удалении стираются все данные приложения, включая базу данных SAMM. Создайте резервную копию и выполните её загрузку на компьютер ДО удаления приложения. Резервная копия, оставленная на маршрутизаторе, будет удалена вместе со всеми остальными данными.

Чтобы обновить установленный контейнер MikroTik до новой версии:

  1. В SAMM перейдите в Tools → Backup, создайте резервную копию и загрузите файл на компьютер.
  2. На маршрутизаторе удалите приложение и добавьте его снова, используя новую версию.
  3. Откройте чистый SAMM, перейдите в Tools → Backup и восстановите скачанный файл.

Это относится только к контейнеру MikroTik. В Docker (Linux, Windows или Linux VM) обновление выполняется командами docker compose pull, а затем docker compose up -d, при этом ваши данные остаются нетронутыми — тома находятся вне контейнеров и сохраняются.

Установка

Вариант F — ISO-образ SAMM Server (установка как appliance)

SAMM Server ISO превращает любую пустую машину или VM в готовый сервер SAMM: загрузите его, выберите DHCP или статический IP на единственном экране, подтвердите и можно уходить. Он устанавливает Ubuntu Server 24.04 LTS (minimized), называет машину samm-server, а затем при первой загрузке устанавливает SAMM прямо с ISO, с интернетом или без него; как только сервер выходит в сеть, он один раз обновляется до последней версии. На консоли отображаются заставка SAMM и баннер входа с IP сервера, адресом панели администратора и учётными данными по умолчанию, а команда samm-tools открывает инструменты обслуживания одним нажатием (проверка состояния, резервное копирование и восстановление базы данных, сброс пароля администратора).

ISO стирает первый диск машины. Загружайте его только на оборудовании или VM, выделенных под SAMM. Интернет не нужен: SAMM находится на ISO и работает в закрытой сети.

Запишите образ на USB-накопитель (Rufus, balenaEtcher или dd) или подключите его к VM, загрузитесь и ответьте на вопрос о сети. Логины по умолчанию после установки — панель: admin / admin, OS: samm / samm или root / samm — измените их все.

Загрузка SAMM Server ISO 2.5 GB

SHA-2560aa7c06bea4aba8ce7f632aacf243639ac7f78359cc0aa72005d88735930e9be

Установка

Руководство по установке

Неинтерактивные параметры

На все запросы можно заранее ответить с помощью переменных окружения, чтобы установщик мог работать в автоматическом режиме:

ПеременнаяРезультат
DB_PASSИспользуйте этот пароль базы данных вместо автоматически сгенерированного (только при первой установке)
CF_TOKENУстановите коннектор Cloudflare Tunnel с помощью этого токена Zero Trust
SAMM_HTTP_PORTПринудительно установить порт прослушивания nginx (пропускает запрос на обнаружение порта 80)
SAMM_VERBOSE1 выводит необработанный вывод команды вместо индикатора выполнения
NO_COLOR1 отключает цветной вывод
DB_PASS='strong_pw'   sudo bash /opt/samm/install.sh
CF_TOKEN='eyJ...'     sudo bash /opt/samm/install.sh
SAMM_HTTP_PORT=8080   sudo bash /opt/samm/install.sh

Что устанавливает установщик

Установщик отображает цветной индикатор прогресса в реальном времени — полосу процентов и контрольный список этапов. Необработанный вывод каждого этапа записывается в /var/log/samm-install.log; в случае сбоя выводятся последние 30 строк.

КомпонентПодробности
FreeRADIUS 3Настроено с использованием PostgreSQL в качестве бэкенда и динамических NAS-клиентов; проверено с помощью freeradius -CX
PostgreSQLБаза данных, схема и все примененные SQL-миграции — каждый файл миграции идемпотентен
Python venvВсе зависимости установлены из requirements.txt; каталоги переводов скомпилированы. Если версия Python в дистрибутиве не совпадает с версией в скомпилированном пакете, установщик автоматически загружает подходящий автономный интерпретатор в /opt/samm/runtime
nginxОбратный прокси добавляется дополнительно — существующие площадки никогда не удаляются. Использует порт 80, если он свободен; в противном случае запрашивает альтернативный порт
5 servicessamm-api, samm-radius, samm-worker, samm-notification, samm-telegram — все запущены как юниты systemd
WireGuardПакеты установлены; настройка выполняется позже в System → VPN
cloudflaredБинарный файл устанавливается всегда; токен туннеля необязателен при установке, его можно добавить позже в System → Cloudflare Tunnel

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

Интерактивные запросы

Все запросы появляются в самом начале, до начала установки:

  • Cloudflare token — вставьте токен коннектора Zero Trust, чтобы опубликовать SAMM в сети без открытия портов, или нажмите Enter, чтобы пропустить этот шаг и настроить его позже.
  • HTTP порт — если порт 80 уже используется, установщик не затрагивает эти площадки и запрашивает альтернативный порт (по умолчанию 8080).

Сводка установки

По завершении работы установщик выводит сводку с URL администратора, логином по умолчанию, выбранным HTTP портом, учетными данными базы данных и путями к конфигурационным файлам:

============================================================
  SAMM is installed and running.
  Admin portal  : http://localhost/admin/login
  Default login : admin / admin   <- CHANGE AFTER FIRST LOGIN
  Config files  : /etc/samm/samm.yaml  /etc/samm/api.env
============================================================

Обновление

Для обновления загрузите новый исходный код и снова запустите установщик:

git -C /opt/samm pull        # or unpack a newer release bundle
sudo bash /opt/samm/install.sh

Повторный запуск синхронизирует источник, обновляет venv, заново применяет все миграции, перезагружает конфигурации FreeRADIUS и nginx, а также перезапускает каждую службу. Ваши конфигурационные файлы и HTTP порт, выбранный при первой установке, сохраняются.

Подсказка SAMM также может обновляться самостоятельно — см. Licensing & updates. Включите автоматические обновления или устанавливайте их по требованию в System → License.
Изолированная & удаленная DB SAMM поставляется только с SAMM — FreeRADIUS, PostgreSQL, nginx и остальные компоненты загружаются во время установки из официальных apt-репозиториев, поэтому для установки в изолированных сетях (air-gapped) эти пакеты должны быть подготовлены заранее. Для использования удаленного PostgreSQL настройте DSN в /etc/samm/samm.yaml после установки.

Руководство по началу работы

Первые шаги

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

1 · Первый вход в систему

  1. Откройте http://<your-server>/admin/ (используйте HTTP порт из сводки установки, если он отличается от 80) или URL вашего Cloudflare туннеля.
  2. Войдите, используя учетные данные admin / admin.
  3. Немедленно измените пароль в разделе System → Admins или в меню профиля на верхней панели.

2 · Добавьте ваш первый маршрутизатор

  1. Перейдите в MikroTik → NAS и нажмите Добавить маршрутизатор.
  2. Введите IP-адрес маршрутизатора, короткое имя и общий секрет RADIUS. Для устройств MikroTik можно дополнительно добавить учетные данные API для синхронизации устройств в реальном времени.
  3. На MikroTik добавьте RADIUS-сервер, указав адрес хоста SAMM (порты 1812/1813) и тот же общий секрет (shared secret), а затем включите RADIUS для PPP / Hotspot.

Перезапуск FreeRADIUS не требуется — SAMM динамически определяет NAS-клиентов из базы данных. См. Маршрутизаторы (NAS) для полного описания процедуры или используйте мастер настройки для автоматической конфигурации MikroTik.

3 · Создать тариф

Тариф определяет скорость, лимиты и стоимость услуги. Перейдите в Users → Plans → New plan. Полное описание полей: Plans & limits.

4 · Добавить абонента

Перейдите в Users → New customer, введите учетные данные и выберите тариф. Пользователь сможет подключиться сразу. Для предоплаченного доступа к hotspot вместо этого создайте ваучеры.

5 · Активируйте вашу лицензию

После чистой установки система работает в незарегистрированном режиме с минимальным уровнем лицензии. Перейдите в System → License и выполните активацию, чтобы снять ограничения — см. Licensing & tiers.

Ежедневный ритм Добавьте маршрутизаторы → создайте тарифы → добавьте подписчиков или карты → следите за панелью мониторинга → фиксируйте платежи в разделе Accounting.

Руководство по началу работы

Миграция из другой системы

Уже используете другую биллинговую систему RADIUS? SAMM считывает её данные и воссоздает ваши тарифы и абонентов, поэтому вам не придется ничего перевводить. Абоненты сохраняют свои текущие пароли от службы и даты истечения срока действия, а значит, смогут подключаться точно так же, как и раньше.

Перейдите в Tools → Export / Import и выберите вашу старую систему в разделе Migrate from another system. Как и остальные инструменты в Tools, этот функционал доступен только superadmin.

Что отправить

Старая системаФайлИсточник данных
SAS4 / Radius Manager .sql или .sql.gz Резервная копия старой базы данных MySQL
Super Speed Radius .sql или .sql.gz Резервная копия старой базы данных MySQL
Pro Radius .xlsx или .csv Экспорт списка абонентов — в этой системе отсутствует функция экспорта резервных копий

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

Принцип работы

  1. Загрузите файл. Пока ничего не написано.
  2. Просмотрите предварительный просмотр. В нем перечислены тарифы и подписчики, которые будут созданы, указаны предупреждения о любых элементах, которые пришлось пропустить или исправить, а также проверяется общее количество на соответствие вашей лицензии перед подтверждением.
  3. Выберите действие для уже существующих имен пользователей в SAMM — пропустить их и сохранить запись SAMM или обновить имя и контактные данные из старой системы.
  4. Импорт. Каждая строка записывается независимо, поэтому одна некорректная строка не приводит к откату остальных.

Что поступает на вход

  • Тарифы — название, скорость, цена, длительность и квота трафика, как они записаны в старой системе.
  • Subscribers — имя пользователя, пароль службы, имя, контактные данные, дата истечения срока действия, тариф, статический IP и MAC.
  • Абоненты, отключенные в старой системе, остаются отключенными.

Данные биллинга, счета, предоплаченные карты, тикеты, бухгалтерский учет и логи администратора намеренно не импортируются — они относятся к модели данных старой системы и редко корректно переносятся.

Значения, не соответствующие своему столбцу

Реальные базы данных неаккуратны: адрес, введённый в поле e-mail, заметка в поле мобильного телефона, номер, набранный на арабской клавиатуре. SAMM проверяет каждое значение на соответствие тому, что должно храниться в его столбце. Всё, что не подходит, остаётся вне этого поля и вместо этого сохраняется в служебных заметках абонента с пометкой источника — так ничего не теряется и ни одно поле не засоряется. Предпросмотр сообщит, сколько значений это затронуло.

Pro Radius особенности

Pro Radius экспортирует подписчиков, но не тарифы, поэтому SAMM определяет тарифы на основе уровня службы каждого подписчика, извлекая скорость из названия (служба с названием «4MBPS» становится тарифом 4 Mbps). Три параметра просто отсутствуют в этом файле и установлены по умолчанию; рекомендуем проверить их после завершения процесса:

  • Duration — установите значение 1 месяц. Реальная дата истечения срока действия каждого подписчика импортируется без изменений, поэтому эта настройка повлияет только на будущие продления.
  • Скорость отдачи — установите значение, соответствующее скорости загрузки.
  • Price — установите значение 0.
Проверьте тарифы перед выставлением счета После импорта Pro Radius откройте Plans и установите актуальную цену и период для каждого тарифа. До этого момента по этим тарифам будет выставляться нулевой счет.

Полезно знать

  • Безопасный многократный запуск. При повторном импорте того же файла пользователи, которые уже присутствуют в системе, будут пропущены, а не продублированы.
  • Ваша лицензия по-прежнему действует. Если в файле больше подписчиков, чем позволяет ваш тариф, в окне предварительного просмотра будет указано это и сообщено, сколько из них можно импортировать — вы можете обновить лицензию или импортировать часть списка.
  • Сначала создайте резервную копию, если вы выполняете импорт в систему, в которой уже есть реальные данные.

Тарифы подписчиков &

Лимиты тарифов &

Тариф — это определение службы, назначаемое подписчикам; в нем устанавливаются скорость, лимиты и стоимость. Создайте тарифы перед добавлением пользователей.

Чистая установка уже включает 9 готовых тарифов — восемь ежемесячных уровней скорости и тариф с ограничением «Expired», чтобы вы могли начать продажи сразу или создать свои собственные. Первоначальное заполнение выполняется только при первой установке и никогда не перезаписывает добавленные вами тарифы.

Создать тариф

  1. Перейдите в Пользователи → Тарифы.
  2. Нажмите Новый тариф.
  3. Заполните форму и нажмите Сохранить тариф.

Каждый лимит представляет собой переключатель — включите только те, которые вам необходимы. В этом же модальном окне можно редактировать существующий тариф (откройте меню ⋮ в строке → Edit).

Поля тарифа

ПолеЗначение
ИмяУникальное название тарифа, например Home-50M
ЦенаОплата за расчетный период при использовании выставления счетов
Скорость загрузки / отдачинапр. 50M, 512K, 1G — используются в качестве ограничения скорости MikroTik
Одновременные сессииСколько устройств могут быть онлайн одновременно на этом тарифе. По умолчанию 1 — повторный вход отклоняется, пока первое устройство все еще подключено. Установите 0 для неограниченного количества. Сессия, которая перестала передавать данные, игнорируется, поэтому разрыв соединения никогда не блокирует доступ абонента
Лимит: Срок действияПодписка завершается по истечении фиксированного периода после активации (дни/месяцы/часы/минуты)
Лимит: КвотаОбщий лимит данных (суммарный, только на загрузку или только на отдачу) для всей подписки
Лимит: время работыЛимит совокупного времени подключения — сумма длительностей всех сессий
Лимит: ежедневный объем трафикаЛимит данных, который сбрасывается ежедневно в настроенное время daily-reset
Неограниченное окноБыстрое добавление одного окна скорости — полный редактор находится на странице Speed Windows вашего тарифа
Пул IP-адресовНеобязательное имя RADIUS Framed-Pool для назначения адресов
АвтопродлениеНачать новый период по истечении срока вместо смены тарифа или отключения

Четыре ограничения

Каждый лимит независим и опционален. Если установлено несколько лимитов, SAMM проверяет их в фиксированном порядке — срок действия → квота → время работы → суточный лимит, и первый исчерпанный лимит определяет действие.

ОграничениеТрекиПри исчерпании
Срок действияКалендарное время с момента активацииПерейдите на другой тариф или отключитесь
КвотаВсего использовано байтПерейдите на другой тариф или отключитесь
Время работыСуммарное время сессий (сек)Перейдите на другой тариф или отключитесь
ЕжедневноКоличество байт с момента последнего ежедневного сбросаОграничение скорости — до введенных вами значений или согласно более медленному тарифу — до следующего ежедневного сброса

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

Окна скорости

Окно скорости переопределяет базовую скорость тарифа в установленные часы — например, окно с неограниченной скоростью после полуночи. Нажмите на строку тарифа, чтобы открыть редактор Speed Windows, который позволяет настраивать дни недели и поддерживает окна, пересекающие полночь. Если условий несколько, применяется окно с наивысшей скоростью.

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

Два понятия использования

SAMM ведет учет использования в двух разных местах и никогда их не смешивает:

  • Сбрасываемые счетчики — состояние для каждого лимита. Обнуляются администратором или при ежедневном сбросе.
  • Биллинговые счетчики — общие итоги за все время, которые невозможно сбросить. Они никогда не обнуляются, что обеспечивает точность отчетов и счетов.

Управление тарифами

В списке тарифов отображаются скорость каждого тарифа, количество подписчиков, активные лимиты и временные интервалы скорости. В меню ⋮ строки можно редактировать тариф, открыть его временные интервалы скорости, включить/выключить его, перейти к списку его подписчиков или удалить его (только если у него нет подписчиков). При редактировании автопродления предлагается распространить изменения на всех текущих подписчиков.

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

Доступные пользователям тарифы

Переключатель Users can see this plan для каждого тарифа (также доступен как массовое действие в списке Plans) определяет, какие тарифы пользователи видят и могут выбрать в своем портале. По умолчанию он выключен для всех тарифов, поэтому ничего не отображается, пока вы не сделаете выбор; пользователь всегда видит свой собственный тариф.

Тарифы подписчиков &

Абоненты

Абонент (клиент / пользователь) — это учетная запись PPPoE или Hotspot, которая проходит аутентификацию в SAMM. Каждому пользователю назначается ровно один тариф.

Создание абонента

  1. Перейдите в Users и нажмите New customer.
  2. Заполните форму и нажмите Сохранить — абонент сможет подключиться сразу.
ПолеЗначение
Имя пользователя *Имя пользователя PPPoE / Hotspot должно быть уникальным
Пароль *Пароль для входа (сохраняется для RADIUS-аутентификации PAP/CHAP)
Имя / ФамилияИмя абонента
Мобильный телефон / Email / АдресКонтактные данные — используются для уведомлений и выставления счетов
Тариф *Назначаемый тариф службы
Переопределение срока действияНеобязательная дата истечения срока действия, заданная вручную вместо вычисленной для тарифа
АвтопродлениеАвтоматически продлевать период тарифа по истечении срока действия

Массовое создание подписчиков

Новые пакетные пользователи позволяют создать пронумерованную серию учетных записей за один раз — это стандартный способ передачи блока логинов для развертывания в поселке, отеле или реселлеру. Выберите количество записей, начальный номер и количество ведущих нулей (3 даст 001, 002, …); все остальное — тариф, срок действия, автопродление — заполняется один раз и применяется ко всем созданным аккаунтам. У них будет один общий пароль.

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

Список абонентов

На странице Users перечислены все подписчики с индикатором статуса, назначенным тарифом и остатком каждого лимита: ежедневным использованием с индикатором выполнения, остатком квоты, оставшимся временем работы и количеством оставшихся дней. Фильтрация доступна по статусу (All / Active / Suspended / Expired / Online) или через поиск по имени пользователя, имени или мобильному номеру.

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

Управление абонентом

Щелкните правой кнопкой мыши по строке — или используйте меню ⋮ — для выполнения действий для конкретного подписчика:

ДействиеПринцип работы
Просмотр / РедактироватьОткройте страницу с подробностями или измените контактные данные, пароль и срок действия
Включить / ВыключитьПриостановить действие учетной записи — активные подписчики будут отключены
Продлить тарифДобавляет длительность тарифа к оставшемуся времени; создает счет, если у тарифа указана цена. Выбор тарифа позволяет пользователю с истекшим сроком действия вернуться на другой тариф на том же шаге — оставьте «Keep the current plan», чтобы продлить тариф, как и прежде
Сбросить время работы / квоту / ежедневноОбнулить счетчик выбранного лимита
ИспользованиеОткрыть графики использования и историю сессий
УдалитьУдалить абонента и всю его историю — сначала разрываются активные сессии
Как действуют правила Сбросы, изменения тарифа и продления записываются в журнал аудита и применяются по тику samm-radius — обычно в течение нескольких секунд. Если абонент находится в сети, SAMM также отправляет запрос на обновление в реальном времени. См. CoA & изменения в реальном времени.

На странице с деталями также можно увидеть пароль для входа абонента, нажав на значок глаза (с копированием в один клик) — это удобно, когда клиент запрашивает свои учетные данные.

Раздел Usage

Действие Usage открывает страницу с детальной статистикой трафика одного абонента с выбором периода 7d / 14d / 30d / 90d. В ней отображаются три основных показателя — трафик за сегодня (с разделением на отдачу/загрузку и временем в сети), трафик за этот месяц и суммарное время в сети за месяц. Ниже расположены график ежедневного трафика (отдача и загрузка) и полная таблица истории сессий: время начала и окончания, длительность, объем загрузки и отдачи, NAS и причина завершения каждой сессии.

Массовые операции

Чтобы изменить владельца, срок действия, статус или автопродление для нескольких подписчиков одновременно — или удалить их — используйте инструменты массового изменения и массового удаления. Для массового создания подписчиков из таблицы используйте Export / Import.

Ограничение доступа абонента к определенным маршрутизаторам

Когда настройка входа через филиал включена, пользователь входит через маршрутизаторы своего филиала, вышестоящих филиалов и головного офиса (см. Admins, branches & roles). В форме редактирования вы можете дополнительно ограничить пользователя (или всю группу карт) конкретными маршрутизаторами: если ничего не выбрано, применяются маршрутизаторы филиала; если выбран один или несколько, вход разрешен только с этих маршрутизаторов, что контролируется внутри RADIUS. Изменение набора маршрутизаторов разрывает все активные сессии на маршрутизаторах, которые больше не разрешены.

Изменение имени пользователя, продление с предпросмотром

Переименуйте пользователя на его странице (кнопка Username рядом с Edit) или в меню списка Users, введя текущее имя пользователя для подтверждения. Сессии, статистика использования и логи переносятся на новое имя, активная сессия разрывается, чтобы маршрутизатор забыл старый логин, а пользователь получает уведомление о новом имени, если вы не снимите соответствующий флажок. При продлении или смене тарифа выберите, продолжится ли новый период с даты истечения или начнется сегодня, а также проверьте и при необходимости скорректируйте новую дату истечения перед сохранением. При продлении также может быть внесен авансовый платеж.

Беспроводной канал

Для абонента на точке доступа MikroTik на странице пользователя можно напрямую отобразить данные радиомодуля: уровень сигнала (с текстовым описанием качества), скорость в каждом направлении, CCQ и время работы. Данные доступны только для радиомодулей MikroTik.

Файлы пользователя & пользовательские поля

Загружайте удостоверения личности, паспорта, контракты и фотографии пользователя на его странице с деталями; предпросмотр файлов доступен без скачивания, а сами файлы могут быть отображены подписчику в его личном портале в разделе Files. Custom fields — определяются один раз в Settings — добавляют дополнительные поля ввода данных для пользователей, файлов, тарифов, групп карт, тикетов и аддонов.

Тарифы подписчиков &

Карты Hotspot

Для предоплаченного доступа к Hotspot создавайте пакеты ваучерных карт вместо отдельных пользователей. Каждая карта представляет собой пару имя пользователя/пароль с собственными скоростью и лимитами; такие карты могут генерироваться тысячами и распечатываться для распространения.

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

  1. Перейдите в Users → Hotspot Cards и нажмите New group.
  2. Заполните форму ниже и нажмите Create group — SAMM автоматически создаст учетные данные для каждой карты.
РазделПоля
Имя устройстваУникальное имя группы, описание, необязательный префикс имени пользователя, количество генерируемых карт (до 10 000)
Учетные данныеФормат и длина имени пользователя и пароля (цифры / буквы / буквенно-цифровые символы)
Ограничение скоростиСкорость загрузки и отдачи — 256k, 6M, 1G; 0 = безлимитно
Ограничение трафикаUnlimited, общий лимит или раздельные лимиты на загрузку/отдачу (MB / GB / TB)
Ограничение по времениЛимит времени работы, истечение срока после первого входа и срок действия группы «valid until»

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

Управление группой

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

Дублировать группу в точности копирует каждую настройку и генерирует такое же количество карт с новыми кодами — код карты может принадлежать только одной карте, поэтому копия является новым тиражом, а не клоном старого. Это быстрый способ повторно создать партию ваучеров, которые закончились.

Добавить одну карту или импортировать список

+ Card в списке карт и на странице группы добавляет одну карту с введёнными вами именем пользователя, паролем и необязательным именем в группу, выбранную из списка поиска. На странице группы Import cards загружает файл CSV или Excel (имя пользователя, пароль и необязательное имя); до сохранения вы видите, что будет добавлено, а что пропущено.

Дизайны карт

Откройте Hotspot Cards → Card designs, чтобы оформить печатную карту: размер, фоновое изображение, ваш логотип и где расположены имя пользователя, пароль, цена, срок действия и QR-код. QR-код выполняет вход по карте в Hotspot одним сканированием. Для начала есть десять готовых дизайнов; меняйте, копируйте или удаляйте их как свои.

Дизайн — это либо лист A4 с картами (Export), либо термочек 80 или 58 mm для быстрой печати. У каждой группы свой дизайн для каждого случая; группа без дизайна печатает встроенную карту, а быстрая печать использует готовый чек Thermal Pro.

Статусы карт

СтатусЗначение
Не используетсяСоздано, но вход не выполнен
АктивенИспользуется в пределах установленных лимитов
ИсчерпаноДостигнут лимит (квота, время работы или срок действия)
ОтключеноОтключено вручную

Печать отслеживания &

Откройте группу, чтобы увидеть её карты, распечатайте их в PDF для распространения (макет печати использует логотип вашего ISP из настроек) и проверьте использование каждой карты. Трафик карт также отображается в Reports на вкладке Cards, а для каждой группы предусмотрен собственный вид учёта.

Маршрутизатор получает остаток по каждой карте, поэтому страница статуса Hotspot показывает оставшееся время и трафик, а маршрутизатор завершает сессию, когда карта исчерпана.

Тарифы подписчиков &

Самообслуживание — гости регистрируются самостоятельно

Противоположность ваучеров: ничего не нужно печатать и не нужно стоять за стойкой. Посетитель подключается к вашему hotspot, нажимает Register на странице авторизации, вводит свое имя и номер мобильного телефона, после чего SAMM отправляет ему код подтверждения по SMS, WhatsApp или email. Он вводит код на этой же странице и получает доступ в интернет — а вы сохраняете именованный, доступный для экспорта список всех, кто использовал гостевую сеть.

Типичные места использования: рестораны и кафе, отели и гостевые дома, выставки и торговые ярмарки, конференции, торговые центры, клиники и залы ожидания, спортзалы, коворкинги, салоны, залы ожидания в аэропортах, стадионы, кампусы, библиотеки, автосалоны, площадки для проведения свадеб, курорты и кемпинги.

Включение

  1. Сначала настройте канал доставки. Notification Center → включите SMS или WhatsApp и отправьте себе тестовое сообщение. Остальные функции не будут работать, пока не будет настроен хотя бы один канал.
  2. Self Service → Settings: отметьте Allow guests to register themselves, выберите предлагаемые каналы, а также установите срок действия пароля и время, которое гость должен подождать перед повторным запросом.
  3. Оставьте Passcodes come from в группе карт Self Service без изменений, если у вас нет причин их менять — эта группа определяет скорость и количество устройств, которые могут использовать один passcode.
  4. Включите вкладку Register для каждого используемого дизайна страницы входа — см. ниже. Именно этот шаг часто пропускают.

Страница входа — этап, который часто упускают из виду

Вкладка Register имеет индивидуальный дизайн для каждого логина и по умолчанию отключена. Перейдите в MikroTik Manager → маршрутизатор → Login Page, отредактируйте используемый дизайн и отметьте Allow Self Service. На этом же экране вы можете изменить любой текст, который видит гость: название вкладки Register, вступительную строку, названия двух полей, текст кнопки и пять вариантов ответов («ваш код в пути», «у вас уже есть аккаунт», «пожалуйста, попробуйте позже», «не удалось отправить», «регистрация недоступна»).

Затем нажмите Push — и нажимайте её повторно после каждого обновления SAMM. Страницы авторизации Hotspot хранятся в собственной flash-памяти маршрутизатора, а не в SAMM. Обновление SAMM не отправляет их повторно, поэтому маршрутизатор продолжает использовать старую страницу — без вкладки Register — до тех пор, пока вы не отправите её снова. SAMM предупредит вас на вкладке Login Page, если маршрутизатор использует страницы версии старше установленной, а страница Self Service перечислит все маршрутизаторы, которые не могут отобразить эту вкладку, и предложит исправить их все сразу.

Правила защиты от злоупотреблений

  • Один действующий пароль на номер. Если запросить код повторно, пока предыдущий еще действителен, гостю будет предложено проверить сообщения вместо отправки нового кода.
  • Затем период ожидания, который вы устанавливаете, прежде чем по этому номеру можно будет запросить новый.
  • Срок действия отсчитывается с момента отправки пароля, а не с первого входа — поэтому код, который оставался неиспользованным в течение недели, работать не будет.
  • Дневной лимит, установленный вашей лицензией (см. ниже). После его исчерпания гостям будет предложено повторить попытку позже, а уже выданные пароли продолжат работать.
  • Каждая попытка записывается по MAC-адресу устройства в том виде, в котором его сообщил маршрутизатор — этот адрес гость не может подменить через браузер.

Лицензия

Self Service лицензируется отдельно от вашего тарифа в зависимости от количества одноразовых паролей, которые установка может выдавать в день, и продлевается в свою дату — так что вы можете использовать тариф Free с платным дополнением или Unlimited без него. Каждая установка получает 10 паролей в день бесплатно; Light увеличивает лимит до 50, Heavy до 200, а Max снимает ограничение. См. цены.

Страница Self Service показывает использовано / разрешено на сегодня и явно сообщает, когда лимит исчерпан. Купите или продлите лицензию на панели мониторинга на securytik.com или отправьте запрос через System → License, и администратор SecuryTik одобрит его. Пароль, который не удалось доставить, не расходует ваш лимит.

Тарифы подписчиков &

Дополнения & ваучеры

Аддон — это дополнительная опция, которую пользователь приобретает в дополнение к своему тарифу на определенное количество дней: speed boost, unmetered days или night boost на выбранные часы. Создавайте их в разделе Users → Add-ons.

  • Продавайте дополнения со страницы пользователя, позволяйте пользователям покупать их в пользовательском портале или Telegram-боте (оплата из кошелька) или создавайте одноразовые voucher codes, которые пользователи активируют в портале или боте.
  • Бесплатные приложения: включите Unmetered и выберите приложения по категориям; только их трафик перестанет учитываться в квоте пользователя. Если не выбрать ни одного приложения, весь трафик станет безлимитным. Для этого требуется Data Log.
  • Родительский контроль и VPN: дополнение может включать Родительский контроль или VPN через SAMM на свой срок; по окончании оба выключаются сами. Срок задаётся значением и единицей (дни, недели или календарные месяцы).
  • Пользователи видят свои активные дополнения и даты их окончания на странице Тарифы. Дополнение, предоставленное пользователю агента, оплачивается агентом так же, как продление тарифа.
  • Для каждого филиала можно установить собственные цены на дополнения в Accounting → Price Lists.

Скидки в счетах-фактурах

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

Тарифы подписчиков &

Баллы & вознаграждений

Поощряйте лояльных пользователей и предложите им приглашать друзей. Баллы отключены, пока вы не включите их по пути Users → Points & rewards.

  1. Включите баллы и установите для каждого тарифа, сколько баллов дает платное продление и сколько получает пригласивший пользователь, когда приглашенный им друг оплачивает свой первый счет.
  2. Создавайте награды: повышенная скорость (скорость тарифа умножается на определенное количество дней) или бесплатные дни; для каждой награды укажите стоимость в баллах.
  3. Пользователи видят свой баланс, ссылку-приглашение и награды в пользовательском портале, а также тратят там баллы. Друг, перешедший по ссылке-приглашению, оставляет свои данные; вы создаете пользователя, и реферал фиксируется.

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

Тарифы подписчиков &

Родительский контроль

Семьи защищают свою линию через портал пользователя. Эта функция отключена для каждого пользователя, пока вы её не разрешите: включите Parental control в форме добавления или редактирования пользователя (она находится сразу после Allow Password Change) или для нескольких пользователей одновременно с помощью массовых действий в списке Users.

Что может заблокировать пользователь

  • Категории: контент для взрослых, наркотики, азартные игры, знакомства, насилие и ненависть, а также прокси или VPN службы, используемые для обхода фильтра. Блокировка контента для взрослых также включает SafeSearch в крупнейших поисковых системах и YouTube.
  • Приложения и веб-сайты из того же каталога, что и Websites & Apps, отображаются с официальными логотипами.
  • Когда: всегда или по еженедельному календарю (например, в школьные будни после 22:00).
Индикатор на маршрутизаторе SAMM не создает отдельные правила для каждого пользователя. Каждый маршрутизатор получает несколько общих правил, в которые пользователи добавляются или из которых удаляются в соответствии с их расписанием; благодаря этому нагрузка на маршрутизатор остается низкой даже при большом количестве семей. Для блокировки приложений маршрутизатор должен быть управляемым через SAMM (доступ по API).

Тарифы подписчиков &

VPN через SAMM

Выбранные пользователи направляют свой трафик через ваш сервер SAMM вместо собственной интернет-линии роутера. Он идёт по туннелю, который у каждого роутера уже есть до SAMM (WireGuard, L2TP/IPsec или SSTP, см. VPN), поэтому на телефон или компьютер пользователя ничего устанавливать не нужно.

Как разрешить

  • Для отдельного пользователя: включите VPN через SAMM в форме добавления или редактирования пользователя, либо сразу для многих пользователей через массовые действия в списке пользователей.
  • Как дополнение: в разделе Пользователи → Дополнения включите VPN в дополнении и продавайте его на несколько дней, недель или месяцев. Он работает в течение срока дополнения и затем выключается сам.

Что выбирает пользователь

Пользователи с разрешением получают в пользовательском портале страницу VPN с тремя вариантами:

  • Выкл. — через VPN ничего не идёт.
  • Весь трафик — все приложения и сайты идут через VPN, как и DNS пользователя.
  • Выбранные приложения — только приложения и сайты, которые пользователь выбрал из того же каталога, что и в разделе «Сайты и приложения»; всё остальное идёт по локальной линии.
Если туннель упал Пользователи никогда не теряют интернет из-за VPN: если роутер не может связаться с SAMM, их трафик возвращается на собственную линию роутера, пока туннель не восстановится. Локальные адреса (ваша LAN и диапазоны CGNAT) никогда не идут через VPN. Работает на RouterOS 6 и 7; роутер должен управляться SAMM.

Внешний VPN: выход через другого провайдера

В разделе System → VPN → External VPN SAMM может выводить пользователей VPN через коммерческий VPN вместо своей линии, поэтому VPN работает даже тогда, когда SAMM находится в вашей локальной сети без публичного адреса.

  • NordVPN: вставьте токен доступа из своей учётной записи NordVPN и выберите, сколько серверов открыть (до 10 на учётную запись). SAMM сам получит ключ и выберет серверы.
  • Любой другой провайдер (ProtonVPN, Mullvad, Surfshark, ваш собственный сервер): загрузите его файлы WireGuard .conf, одно подключение на файл. Строки сценариев в файле пропускаются и никогда не выполняются.
  • Подключения показывают каждое подключение в реальном времени: состояние, последнее рукопожатие, трафик и пользователей. Каждый пользователь остаётся на одном подключении (с тем же адресом выхода); вес распределяет пользователей между подключениями.
  • Если подключение перестаёт работать, его пользователи выходят через линию SAMM, пока оно не восстановится; удаление или выключение подключения переносит его пользователей на другие.
SAMM нужен публичный адрес VPN полезен, только если ваш сервер SAMM выходит в Интернет из другого места, чем пользователи, например сервер в дата-центре. Если SAMM стоит за NAT в той же сети, трафик будет выходить через ту же линию, поэтому форма пользователя и форма дополнения показывают предупреждение, если не работает подключение внешнего VPN.

Руководство по началу работы

Настройте ваш сервер

Нет сервера? Мы настроим его за вас. Вы заказываете его в панели SAMM, оплачиваете и получаете готовый сервер SAMM на вашем собственном домене .com, с вашим именем. Ничего устанавливать не нужно.

Что вы получите

  • Облачный сервер и домен .com, в трёх размерах: 6 ядер, 12 GB RAM, 200 GB SSD за $100 в год; 8 ядер, 24 GB RAM, 300 GB SSD за $200; 12 ядер, 48 GB RAM, 400 GB SSD за $300. Размер выбирается на первом шаге.
  • HTTPS на вашем домене; собственный адрес сервера никогда не публикуется.
  • SAMM установлен и оформлен под название вашей компании, с привязанной лицензией, которая активна при первом входе.
  • Письмо с адресом вашей панели (https://your-domain/admin) и надёжным паролем администратора.

Закажите его

  1. Войдите на samm.securytik.com и откройте Dashboard → Get a server.
  2. Выберите имя сервера и количество пользователей, затем найдите свой домен .com или выберите один из предложенных вариантов.
  3. Оплатите любым способом, доступным на странице оплаты. Заказ ожидает оплату два часа; после этого он отменяется, и вам нужно оформить новый.
  4. После оплаты всё происходит автоматически. Когда сервер будет готов, вы получите письмо с адресом и логином.

Доступ по SSH

В разделе Dashboard → Servers вы можете создать свой вход по SSH с паролем, открытыми ключами или и тем и другим. Пошаговое руководство по SSH для Termius, Windows, Ubuntu и macOS находится на той же странице.

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

Тарифы подписчиков &

CGNAT & пулы IP

Оба находятся в разделе Plans, рядом с собственными пулами роутера.

Пулы CGNAT

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

  1. Откройте Plans → CGNAT Pools и добавьте пул: публичные адреса, сколько пользователей делят один адрес и сколько портов получает каждый пользователь.
  2. Строка ёмкости показывает, сколько пользователей поместится, ещё до сохранения.
  3. Отправьте на роутер. SAMM записывает правила NAT и хранит историю того, какой пользователь получил какой адрес и порты; её читает Lookup.

Пулы IP

С пулом IP SAMM сам выдаёт каждому пользователю его адрес, для каждого роутера и тарифа, поэтому роутеру собственный пул адресов не нужен. Адрес освобождается по окончании сессии. Когда пул заполнен, в работу вступает собственный пул роутера.

Ежедневная эксплуатация

Хранение данных & Lookup

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

Включите

  1. Откройте System → Settings → Data retention и включите её.
  2. Задайте срок хранения сессий (по умолчанию два года). Сессии хранятся в этот срок, даже для удалённых вами пользователей.
  3. По желанию можно ежедневно отправлять зашифрованный файл на ваш NAS по SFTP, SMB или NFS. Открывайте его командой gpg --decrypt.

Lookup: кто использовал этот адрес?

  1. Откройте Overview → Data Log → Data retention.
  2. Введите публичный адрес, порт и время из полученного запроса.
  3. Введите номер дела (SAMM предлагает CASE-1, CASE-2…). Результат показывает пользователя, MAC-адрес, роутер и сессию; его можно искать и экспортировать.
Журнал Lookup Каждый поиск сохраняется в журнале Lookup с указанием того, кто искал, когда и номер дела; редактировать его нельзя. При CGNAT Lookup использует блоки портов ваших пулов CGNAT.

Сеть & маршрутизаторы

Другие марки роутеров

Помимо MikroTik, SAMM работает с роутерами Cisco, Huawei, Nokia и ZTE в роли NAS (BNG).

  • Добавьте роутер в разделе Devices → Manager и выберите его тип. Форма запрашивает нужный логин: API для MikroTik, SSH для остальных марок.
  • Страница настройки: SAMM генерирует строки конфигурации для этого роутера, готовые к вставке.
  • Скорости и отключения используют собственные атрибуты RADIUS каждой марки, поэтому изменения тарифа доходят до роутера.
  • Data Log на основе собственных записей трафика роутера (NetFlow или IPFIX).
  • CGNAT на Cisco: SAMM передаёт правила по SSH, а Lookup работает так же, как на MikroTik. Роутеры Cisco также могут подключаться к SAMM по L2TP.
  • Страница устройства: CPU, память, температура, время работы и графики, как у MikroTik.

Сеть & маршрутизаторы

FTTH & OLTs

SAMM считывает данные OLT от V-SOL, Huawei (SmartAX), ZTE (C300 и C320) и Nokia (ISAM) по SSH.

  • Страница FTTH в разделе Devices → FTTH: список OLT с фильтрами, столбцами и экспортом, как в разделе Wireless.
  • Каждый ONU с его оптическим сигналом, а также ONU, ожидающие добавления.
  • ONU автоматически привязываются к своим пользователям.
  • Блокировка абонентской линии: SAMM запоминает линию, с которой подключается каждый пользователь, и может закрепить за ней его логин.
  • Страница устройства OLT: CPU, память, температура, время работы и графики.

Сеть & маршрутизаторы

Маршрутизаторы (NAS)

NAS (Network Access Server) — это маршрутизатор, который аутентифицирует абонентов в SAMM по протоколу RADIUS. Для каждого маршрутизатора, через который проходит трафик абонентов, необходима запись NAS.

Добавить маршрутизатор

  1. Перейдите в MikroTik → NAS и нажмите Добавить маршрутизатор.
  2. Заполните поля ниже и нажмите Сохранить.
ПолеЗначение
IP-адрес / имя хоста NASАдрес маршрутизатора, как его видит хост SAMM
Краткое имяПонятная метка, отображаемая по всему интерфейсу
Типmikrotik открывает возможность синхронизации устройств в реальном времени и отправки конфигураций; другие типы поддерживают только RADIUS
ПарольОбщий секрет RADIUS должен точно совпадать с секретом на маршрутизаторе, иначе аутентификация не удастся
Порт CoAUDP порт, на который SAMM отправляет пакеты Change-of-Authorization (по умолчанию в MikroTik 3799)
Порт API / пользователь / парольУчетные данные MikroTik API, которые SAMM использует для чтения информации об устройстве и отправки конфигурации
Перезагрузка не требуется SAMM динамически определяет NAS-клиентов из базы данных — добавление или удаление маршрутизатора не требует перезапуска FreeRADIUS.

Список NAS

Все маршрутизаторы отображаются в одной таблице: ID, IP / имя хоста NAS, короткое имя, тип, маскированный секрет (нажмите на ячейку, чтобы отобразить его), порты CoA и API, а также результат ping в реальном времени с временем отклика. Поле поиска позволяет фильтровать по IP, короткому имени или описанию.

Меню ⋮ в каждой строке содержит действия для конкретного маршрутизатора — View Device и Refresh Info (только MikroTik), Edit, Push RADIUS config (только MikroTik) и Delete. Нажатие на строку типа mikrotik ведет сразу на страницу устройства.

Обнаружение соседей

Нажмите Discover neighbors, чтобы просканировать сеть на наличие устройств MikroTik (с помощью протокола neighbor-discovery от MikroTik) и добавить их как записи NAS, не вводя каждый адрес вручную. Обнаруженный маршрутизатор можно добавить по IP или выбрать Auto-added — автоматическую настройку в один клик, которая создает пользователя управления SAMM на маршрутизаторе, назначает IP-адрес управления и удаляет заводской bridge.

Автодобавление предназначено для новых маршрутизаторов Одношаговая настройка (bootstrap) предназначена для новых (или сброшенных до заводских настроек) устройств — на маршрутизаторе с уже имеющейся конфигурацией она может перезаписать или нарушить существующие настройки.

Отправить конфигурацию RADIUS на маршрутизатор

Для записей MikroTik NAS в меню ⋮ строки доступен пункт Push RADIUS config — SAMM настраивает маршрутизатор через API, чтобы вам не пришлось вводить данные вручную. Вы подтверждаете IP-адрес сервера SAMM (он должен быть доступен с маршрутизатора), а также порты auth, accounting и CoA; затем SAMM создает или заменяет запись RADIUS на маршрутизаторе:

НастройкаЗначение
КомментарийSAMM — тег, который SAMM использует для поиска и последующего обновления этой записи
Службаhotspot, ppp
Адрес / секретный ключХост SAMM с общим секретом из этой записи NAS
Тайм-аут3000 ms
Входящий CoAПринято на подтвержденном вами порту CoA

В диалоговом окне отображается журнал результатов после завершения push.

Настройка MikroTik

Если вы решите настроить маршрутизатор вручную:

  • Добавьте RADIUS-сервер, указывающий на хост SAMM, с тем же общим секретом (shared secret), включив поддержку PPP / Hotspot.
  • Используйте порт аутентификации 1812, порт учета (accounting) 1813.
  • Принимать входящие CoA на порту 3799.
  • Установите интервал Interim-Update для учета примерно на 5 минут (значение по умолчанию в мастере SAMM) — с такой частотой SAMM накапливает данные об использовании и проверяет лимиты; более короткие интервалы сокращают задержку срабатывания лимитов за счет увеличения трафика учета.

Устройства только для мониторинга

Маршрутизатор, добавленный как monitor, отображается в инвентаре MikroTik, опрашивается по ping и синхронизируется, но не имеет роли RADIUS — он не может аутентифицировать подписчиков. Используйте этот режим для мониторинга маршрутизаторов, которые не являются NAS для подписчиков.

Резервный SAMM

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

Резервный режим включается после установленной вами задержки или вручную, и маршрутизатор сообщает об этом через Telegram. Таблица статусов отображает состояние синхронизации каждого маршрутизатора, количество пользователей, у которых синхронизация не удалась, и причины этого, а также помечает маршрутизатор, резервная копия которого устарела или который не может связаться с адресом проверки работоспособности SAMM.

Сеть & маршрутизаторы

Менеджер устройств MikroTik

Когда у маршрутизатора есть учетные данные API, SAMM управляет им напрямую через MikroTik API — без WinBox и SSH. Раздел MikroTik представляет собой актуальный список всех маршрутизаторов; при выборе устройства открывается страница с подробной информацией и пятнадцатью вкладками, которые позволяют настроить почти любую часть RouterOS прямо из браузера.

MikroTik Monitor

MikroTik → Monitor отображает по одной карточке для каждого маршрутизатора в виде сетки. В каждой карточке — данные, которые обновляются с помощью samm-worker и опрашиваются в реальном времени каждые 30 секунд: индикатор доступности, версия RouterOS, загрузка CPU и количество ядер, использование памяти, количество активных сессий, время работы и время последнего замера.

Карточка помечается либо NAS (роутер, который также аутентифицирует абонентов через RADIUS), либо monitor (устройство, добавленное только для мониторинга). Add MikroTik регистрирует новое устройство; Refresh now принудительно выполняет немедленный опрос. Карточки только для мониторинга имеют меню по правому щелчку — Open, Edit, Refresh Info, Delete.

Устройства Ubiquiti

При добавлении монитора вы выбираете его тип: MikroTik, Ubiquiti airOS или Ubiquiti UniFi access point. Доступ к устройствам Ubiquiti осуществляется по SSH с использованием собственного логина устройства; на странице Probe отображаются данные, передаваемые устройством. Точка доступа UniFi отображается на страницах Wireless одной строкой для каждого радиомодуля — с указанием канала, ширины и SSID, подключенных клиентов с уровнем сигнала, шумом и скоростью, а также соседних сетей, которые устройство обнаруживает, — и участвует в работе оптимизатора Wi-Fi и планировщика каналов.

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

Пользователи, хранящиеся на маршрутизаторе

SAMM находит данные PPP-авторизаций, пользователей Hotspot и пользователей User Manager, которые хранятся на маршрутизаторе (RouterOS 6 и 7), и выводит их на странице маршрутизатора. Перед началом импорта в каждой строке отображается то, что создаст SAMM: имя пользователя, пароль, имя, мобильный телефон, тариф (помечается как new, если SAMM создает его), срок действия, лимиты, MAC и IP. Также считываются имена, номера телефонов и даты окончания срока действия, записанные в комментариях маршрутизатора на арабском или английском языках. Отметьте пользователей и импортируйте их: процесс будет выполняться в фоновом режиме, а список Users будет заполняться по мере их добавления.

Страница устройства — пятнадцать вкладок

Откройте любое устройство, чтобы перейти на страницу полного управления. Вкладки разделены на четыре группы.

Мониторинг

ВкладкаЧто отображается
ОбзорИнформация об устройстве, системная информация и графики истории производительности (CPU, память, сессии за период)
ИнтерфейсыКаждый интерфейс с его текущим состоянием, а также история трафика по каждому интерфейсу
Сайты & приложенияТри подраздела: Monitor (веб-сайты и & приложения, обнаруженные на маршрутизаторе, с историей трафика), QoS (приоритизация с учетом приложений, см. ниже) и App Filter (блокировка контента на базе DNS из каталога)

Менеджер устройств

Вкладка Manager → General предназначена для базовой настройки устройства: Identity (имя маршрутизатора), Time (время, часовой пояс и NTP), а также Tools (перезагрузка, ping и другие быстрые действия с маршрутизатором).

Конфигурация сети

ВкладкаЧто вы настраиваете
BridgeСоздайте LAN-мосты и выберите, какие физические интерфейсы (порты) относятся к каждому из них
VLANДобавление и управление интерфейсами VLAN
IPТри подвкладки — Static (статические и динамические адреса), DHCP client (получение адреса от вышестоящего устройства), DHCP server (выдача адресов с таблицей активных аренд)
DNSDNS-серверы и кэш (фильтр контента приложений и площадок находится в разделе Websites & Apps)
WiFi / CAPsMANИнтерфейсы Wi-Fi с их конфигурациями и профилями безопасности, а также контроллер CAPsMAN — конфигурации, правила подготовки и удаленные CAPs

Обслуживание служб &

ВкладкаЧто вы настраиваете
PPPoEСерверы PPPoE, профили PPP, пулы IP и интервал промежуточного обновления (interim-update) учета RADIUS
HotspotСерверы Hotspot, профили Hotspot и профили пользователей, пулы DHCP/IP и страница входа Captive Portal
ИнтернетWAN-каналы — управляемые SAMM WAN и маршруты по умолчанию; любые существующие WAN, не управляемые SAMM, отображаются только для чтения
Межсетевой экранПравила фильтрации, анализ безопасности маршрутизатора, проверка связности & целей, модули безопасности и резервные копии межсетевого экрана — Auto-Security делает снимок межсетевого экрана перед применением и может активировать отложенный автоматический откат, чтобы набор правил, который блокирует ваш доступ, был отменен автоматически
ОбновитьОбновления RouterOS — выбор канала обновлений, проверка и установка, а также просмотр установленных пакетов
МастерПошаговое руководство по первоначальной настройке приведено ниже

Интервал interim-update для PPPoE

На вкладке PPPoE параметр Interim update определяет, как часто маршрутизатор отправляет пакеты RADIUS accounting Interim-Update в SAMM. SAMM использует эти пакеты для накопления счетчиков байтов и времени работы, а также для проверки квоты, дневных лимитов и лимитов времени работы — без них контроль лимитов и счетчики активных сессий перестают обновляться. Рекомендуемое значение — 5m.

Страница авторизации Hotspot

На вкладке Hotspot вы управляете страницей входа captive-portal: оставьте стандартные страницы MikroTik, примените один из встроенных шаблонов или один из ваших сохраненных дизайнов. SAMM включает визуальный редактор дизайна и галерею шаблонов — настройте страницу входа и отправьте её напрямую в hotspot маршрутизатора.

QoS с распознаванием приложений

Вкладка QoS (подвкладка Websites & Apps) превращает приложения и сайты, которые SAMM уже видит на маршрутизаторе, в тариф приоритетов загрузки. Перетащите каждое приложение из общего списка в один из восьми слотов приоритета — слот 1 обслуживается первым при возникновении конкуренции за трафик, слот 8 — последним; приложения, оставшиеся в списке, не ограничиваются. При необходимости ограничьте скорость загрузки любого приложения (например, 10M) и установите общий потолок загрузки, за который будут конкурировать приоритеты. Автораспределение по категориям упорядочит всё одним кликом — сначала мессенджеры, затем AI-службы, затем магазины, а всё остальное ниже.

При отправке SAMM компилирует слоты в дерево очередей MikroTik (с меткой SAMM:qos, parent=global) с соответствующими правилами firewall для пакетных меток, начиная с наивысшего приоритета. Оно построено на том же каталоге фильтра сайтов и приложений, который питает мониторинг, поэтому появляются только приложения, реально замеченные на маршрутизаторе, — а удаление SAMM QoS убирает с маршрутизатора все объекты SAMM:qos, оставляя ваши счётчики нетронутыми.

Мастер настройки

Вкладке Мастер позволяет собрать все данные за десять коротких шагов и отправить полную конфигурацию на маршрутизатор одним пакетом в конце. Никакие данные не будут отправлены до вашего подтверждения на финальном шаге проверки.

  1. Добро пожаловать & detect — SAMM сканирует маршрутизатор и показывает уже настроенные параметры, чтобы вы могли пропустить их при отправке конфигурации.
  2. Bridge interface — укажите имя LAN-моста.
  3. Bridge ports — выберите физические интерфейсы, которые будут объединены в bridge.
  4. DNS — настройка вышестоящих резолверов (пресеты в один клик для Google, Cloudflare, Quad9 и других), размера кэша и, при необходимости, фильтра контента DNS.
  5. NTP — настройка источника синхронизации времени маршрутизатора (NTP-клиент и, при необходимости, раздача времени в LAN).
  6. Internet — добавьте один или несколько WAN-каналов (Static / DHCP / PPPoE).
  7. RADIUS to SAMM — укажите в маршрутизаторе ваш хост SAMM для аутентификации, учета и CoA.
  8. Services — выберите, должен ли мастер создать PPPoE-сервер, Hotspot-сервер или службу IPoE / DHCP, и при необходимости включите IPv6 dual-stack (опционально, по умолчанию выключено): выберите длину делегированного (DHCPv6-PD) префикса и блоки IPv6, после чего мастер создаст пулы и привяжет их к профилю PPP.
  9. Детали PPPoE / Hotspot & межсетевой экран — пулы, профили, время аренды, правила межсетевого экрана & NAT, а также необязательный Срок действия пула истек & доступ в интернет заблокирован, который перенаправляет пользователей с истекшей подпиской на страницу SAMM «срок действия подписки истек» вместо обрыва соединения.
  10. Проверьте & push — просмотрите точный список команд, которые будут отправлены, а затем отправьте их все на маршрутизатор.
Скорость для каждого пользователя передается из RADIUS Мастер создает один общий профиль PPPoE / hotspot — он не назначает отдельные профили для каждого уровня. Скорость каждого абонента передается SAMM в ответе RADIUS при авторизации, поэтому изменение тарифа не требует редактирования настроек маршрутизатора.

Сеть & маршрутизаторы

Глубокая проверка

Когда сеть работает медленно, «Глубокая проверка» делает то, что сделал бы инженер: какое-то время наблюдает за одним роутером, читает всё, что может, и говорит, что не так и что делать в первую очередь. Она только читает: ничего на роутере не меняет, а любое исправление остаётся вашим решением.

Начать проверку

  1. Откройте Devices → Network Health и нажмите Глубокая проверка, либо щёлкните правой кнопкой по роутеру на странице.
  2. Включите роутеры для проверки. Все переключатели изначально выключены. Показываются только MikroTik BNG с сохранённым логином.
  3. Выберите время: 15 минут, 30 минут, 1 час или 2 часа. Более длинный запуск надёжнее; запускайте в часы пик.
  4. Нажмите Начать проверку. Она работает в фоне, так что страницу можно закрыть. На каждый роутер — одна проверка, не более двух одновременно.

Отчёты, рядом с кнопкой, показывают каждую проверку с её ходом, результатом и оценкой. Можно остановить проверку раньше и сохранить то, что уже измерено.

Что проверяется

  • Интернет-линии: потери и задержка до интернета и на каждой линии, скачки, и проходят ли большие пакеты.
  • Работа пользователей: тестовые сообщения меняющейся выборке онлайн-пользователей и время ответов.
  • Очереди пользователей и скорость: теряют ли пользователи данные, когда их тариф исчерпан, загрузка и выгрузка, а также правила, которые могут обходить ограничения скорости.
  • Сеть доступа и порты: каждая сторона доступа, вышки и устройства за роутером, ошибки портов, обрывы, скорость и сигнал оптики.
  • Балансировка нагрузки: как линии делят трафик и полны ли правила балансировки, замечают ли они мёртвую линию.
  • Состояние роутера: загрузка процессора и каждого ядра, память, температура, перезапуски, прошивка и журнал роутера.
  • Входы и RADIUS: ответы вовремя, отклонённые входы, сессии, которые обрываются раньше времени, и настройки размера пакетов.
  • Безопасность: закрыт ли роутер от интернета, порядок правил файрвола, защиты, лишние службы и неудачные входы.
  • Маршрутизация: сессии BGP, соседи OSPF и мёртвые маршруты.

Включены все проверки Network Health. Проверка, которую не удалось прочитать, исключается из отчёта и никогда не считается хорошей.

Отчёт

Он начинается с оценки из 100 и вердикта простыми словами, затем таблица оценок по каждой области и список того, что делать, сначала самое важное. Ниже — подробности и цифры. Язык отчёта совпадает с языком вашей панели, а Export PDF сохраняет его с логотипом SAMM и «Prepared by SAMM» на каждой странице.

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

Система

SCOOP AI

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

Подключить ИИ

В Settings → SCOOP AI подключите Google Gemini (бесплатный ключ), ChatGPT (вход без ключа), Claude, OpenAI, OpenRouter или DeepSeek. Можно сохранить несколько логинов и переключаться между ними, выбрать модель или оставить «Automatic». Ключ, который сам ИИ отклоняет, останавливается при сохранении, а справочная страница показывает, как получить ключ для каждого ИИ.

Что делает его безопасным

  • Он работает с правами каждого администратора: администратор видит и меняет только то, что разрешает его роль.
  • Деньги, удаления и изменения на роутерах задерживаются, пока вы не нажмёте Approve.
  • Каждое изменение на роутере сохраняет возможность отката на самом роутере и никогда не трогает связь SAMM с роутером.
  • Журнал SCOOP AI хранит каждый вопрос, ответ и подтверждение каждого администратора.

Что можно ему поручить

  • Отвечать на вопросы о ваших данных на вашем языке.
  • Распределять интернет между линиями по проценту, отправлять выбранные приложения или VPN через выбранную линию и настраивать более быстрый DNS.
  • Присылать отчёт каждый понедельник или напоминать в нужное время.

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

Сеть & маршрутизаторы

Карта сети, состояние, Data Log & качество соединения

Карта сети

Devices → Network Map строится на основе данных, которые каждый маршрутизатор сообщает о своих соседях — поддерживать схему вручную не нужно. Переключайте слои для отображения портов, IP-адресов, подсетей и CPU или отобразите путь каждого устройства к интернету. Перетаскивайте узлы и сохраняйте расположение; Discover now заново считывает данные о соседях.

Состояние сети

Devices → Network Health выводит список всех маршрутизаторов, начиная с наиболее проблемных: исправных, с предупреждениями, отвечающих, но с ошибками, или недоступных. Каждая проблема описана простыми словами — CoA отключен, несовпадение секрета RADIUS, рассинхронизация часов, открыты Telnet или FTP. Проверки только считывают данные с маршрутизатора. В представлении Diagnose маршрутизатора для распространенных проблем доступно исправление в один клик с предварительным просмотром и возможностью отката. Открытые проблемы создают оповещения в Alert Center.

Для более подробного разбора одного MikroTik BNG с полным отчётом используйте Глубокая проверка.

Обе страницы находятся в одном разделе Settings → Advanced → Network Health. Если эта функция выключена, SAMM не опрашивает маршрутизаторы. Если она включена, вы также выбираете частоту проверки каждого маршрутизатора, количество маршрутизаторов за один проход (загруженные установки распределяются по нескольким проходам) и необходимость обнаружения соседей для карты.

Маршрутизатор, который долгое время находится в автономном режиме, можно приостановить, чтобы он перестал отправлять оповещения до тех пор, пока снова не ответит.

Оптимизатор Wi-Fi

Devices → Wireless → Wi-Fi optimizer показывает для каждого радиомодуля спектр диапазона, в котором он работает (уровень сигнала в dBm по частотам, видимые сети и области их перекрытия), список этих сетей и диаграмму каналов, где каждый канал отмечен как Quiet, Busy или Crowded. Survey now сканирует весь диапазон по очереди для каждого радиомодуля, чтобы площадка с несколькими секторами не теряла всех клиентов одновременно; кнопка сообщает о стоимости операции перед началом. Live sweep отображает последние, пиковые и средние показатели в реальном времени.

Планировщик каналов рекомендует наименее загруженный канал и оптимальную ширину канала для каждого радиомодуля. Выберите Off, Suggest или Auto для каждого радиомодуля отдельно для канала и ширины, либо позвольте им следовать настройкам сети; настройте сразу несколько радиомодулей в списке Wireless. В режиме Auto SAMM переключает радиомодули в 04:00 по одному и заново сканирует каждый радиомодуль на новом канале. Применить переключает радиомодуль сейчас, а Отменить возвращает его обратно. Функция работает с радиомодулями MikroTik (пакеты wifi и wireless, CAPsMAN) и точками доступа Ubiquiti UniFi.

Журнал данных

Откройте пользователя и выберите Data Log, чтобы увидеть, куда направляется его трафик: основные пункты назначения по хостам и приложениям — YouTube, Facebook, WhatsApp — с данными об отдаче, загрузке и соединениях, или временную шкалу. SAMM считывает собственный экспорт потоков (IPFIX) маршрутизатора, используя в качестве резерва таблицу соединений, и определяет названия приложений из того же каталога, что и App Filter. SAMM никогда не находится на пути прохождения трафика.

  • Record user Data Log включает запись лога данных пользователя; настройка находится в разделе Settings → Advanced → Data Log.
  • Почасовая детализация хранится несколько дней, затем архивируется до одной строки на площадку в день — примерно до одной двадцать четвертой части объема. Страница и экспорт считывают оба типа данных, поэтому информация не теряется.
  • Destinations per hour сохраняет наиболее активные адреса назначения каждого пользователя в час и отсекает малозначимый «длинный хвост» разовых адресов; 0 сохраняет всё.
  • Retention определяет срок хранения строк до их удаления во время ночной очистки.
  • Резервная копия с опцией Skip usage не включает Data Log, поэтому ее размер остается небольшим.
Выключено, пока вы его не включите Суперадминистратор включает Data Log в настройках и выбирает срок его хранения. Эти данные носят ознакомительный характер; для биллинга всегда используется RADIUS accounting.

Качество соединения

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

Выключено, пока вы его не включите Включите эту функцию в Settings → Advanced → Connection Quality, где вы также можете настроить частоту опроса пользователей и количество пользователей, которых один маршрутизатор тестирует за раунд (сначала те, чьи показатели измерялись давно). Система спроектирована как легковесная: проверка скорости не расходует трафик маршрутизатора, а тестовая нагрузка на каждый маршрутизатор ограничена. Устройство, блокирующее тест, не пришлет ответ, даже если с линией всё в порядке. Test now работает даже при выключенной функции.

Сеть & маршрутизаторы

CoA & изменения в реальном времени

CoA (Change-of-Authorization) — это механизм, с помощью которого SAMM изменяет параметры сессии абонента прямо во время ее активности — чтобы увеличить или ограничить скорость, либо разорвать соединение — не дожидаясь повторного подключения пользователя.

Как изменения применяются к активному подписчику

SAMM никогда не применяет изменения на маршрутизаторе сразу после нажатия кнопки. Каждое действие администратора проходит по одному безопасному пути:

Действие администратора → Журнал аудита → samm-radius tick → Исходящие CoA → Маршрутизатор
  1. Действие записывается в журнал аудита как поставленная в очередь команда.
  2. Служба samm-radius обрабатывает очередь при следующем такте, применяет изменения и — если подписчик в сети — ставит CoA в очередь.
  3. Исходящая очередь CoA очищается, и пакет отправляется на маршрутизатор.

События по времени — истечение срока действия, границы временных окон скорости, ежедневные сбросы — поступают в ту же очередь исходящих сообщений. Верхний предел задержки составляет один тик samm-radius (по умолчанию 30 s; уменьшите его в Настройках для более строгого соблюдения).

Гибридный CoA

SAMM сначала отправляет CoA-Update, чтобы изменить параметры текущей сессии. Если маршрутизатор отклоняет запрос после заданного количества попыток, SAMM автоматически переходит к Disconnect-Request — абонент переподключается и получает новые настройки. Эта гибридная стратегия работает во всех версиях прошивки MikroTik.

Страница CoA Outbox

Users → CoA Outbox — это представление данной очереди в реальном времени. samm-radius является единственным отправителем — панель администратора никогда не отправляет CoA напрямую — и он очищает очередь при каждом тике. Страница автоматически обновляется каждые 30 секунд.

В верхней части страницы расположены шесть счетчиков — Pending, Sent, NACK (retrying), Done, Failed и Total. Таблицу можно отфильтровать по статусу, действию (update или disconnect) или выполнить поиск по имени пользователя, IP NAS или причине.

СтатусЗначение
ожиданиеВ очереди, ожидание следующего тика samm-radius
отправленоОтправлено (переходное состояние — отправка и её результат фиксируются в одном тике, поэтому строки редко остаются в этом статусе)
nackМаршрутизатор отклонил CoA-Update — SAMM повторяет попытку, после чего переходит к разрыву соединения
ГотовоУспешно применено
ошибкаПопытки прекращены по достижении лимита повторов — наведите курсор на значок, чтобы увидеть последнюю ошибку

В каждой строке указаны пользователь, маршрутизатор, действие, количество попыток, причина, а также время создания и отправки. Действия в каждой строке позволяют Повторить отправку неудачного или отклоненного (nack'd) пакета, Отменить отправку пакета, который еще находится в пути, или открыть Атрибуты, чтобы просмотреть точные RADIUS-атрибуты пакета. Значок на боковой панели отображает количество ожидающих строк; панель мониторинга отслеживает сбои за последние 24 часа. В исправно работающей системе эта очередь должна быть почти пустой.

Очистка устаревших сессий

Если маршрутизатор дает сбой или теряет связь, пакеты Accounting-Stop могут быть потеряны — и во многих системах такие абоненты навсегда остаются «в сети». SAMM ищет сессии, которые перестали отправлять Interim-Updates, и закрывает их автоматически (причина завершения Reaped-Stale), чтобы список активных сессий, счетчики одновременных подключений и данные об использовании оставались актуальными. Таймаут определяется настройкой stale_session_timeout_seconds (по умолчанию 900 s = 15 минут; установите 0 для отключения) и вступает в силу мгновенно — перезагрузка не требуется.

Ежедневная эксплуатация

Панель мониторинга & активные сессии

Два экрана в разделе Overview — это то, с чего вы начинаете каждую смену: панель мониторинга для контроля состояния всей системы и Live Sessions для того, чтобы видеть, кто именно подключен в данный момент.

Два экрана: открыть в новом окне

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

Панель мониторинга

Overview → Dashboard — это главный экран оператора. Селектор периода в верхней части — Today, 7d, 14d, 30d, 90d — задает временной интервал для графика трендов и показателей за выбранный период.

Шесть плиток KPI

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

ВиджетОтображаетОткрыть
Сейчас в сетиАбоненты с активной RADIUS-сессией в данный моментОтображаются пользователи с фильтром Online
Активные абонентыАктивные аккаунты, общее количество подписчиков указано нижеОтображаются только Active пользователи
Истек срок действияПодписчики, у которых истекла подписка и не задан следующий тарифПользователи, отфильтрованные по статусу Expired
Открытые тикетыНеразрешенные тикеты поддержки (исключая завершенные & закрытые)Пользователи → Тикеты поддержки
МаршрутизаторыОбщее количество записей NAS, включая количество в данный момент недоступныхМонитор MikroTik
Неоплаченные счетаСчета, по которым требуется контроль оплатыСчета с фильтром Unpaid

График пользователей & активных сессий

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

Состояние конвейера

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

МетрикаЧто это значит
samm-radius очередьОжидающие CoA до следующего такта — должны быть очищены в течение нескольких секунд
Неудачные CoA (24ч)Ноль в исправной системе; ненулевое значение означает, что маршрутизатор отклоняет CoA
Ожидание журнала аудитаОчередь действий администратора, которые еще не были применены samm-radius
Ограничение количества сессийАбоненты, чья скорость в данный момент ограничена лимитом — это ожидаемое поведение, а не ошибка
Снимок сессийКоличество активных сессий должно соответствовать значению Online now
Активные тарифыРазмер вашего каталога тарифов
Путь принудительного применения Действия администратора ставятся в очередь в samm.audit_log; тик samm-radius обрабатывает их и отправляет CoA в samm.coa_outbox. Полный путь описан в CoA & live changes.

Таблицы недавней активности

Четыре таблицы под графиком отображают последние события; в каждой из них есть ссылка View all для перехода на соответствующую страницу:

  • Последние исходящие CoA — действие, пользователь, статус (done / pending / nack / failed), количество попыток, причина и время.
  • Последние действия администратора — действие, объект, пользователь, выполнивший действие, статус применения и время.
  • Последние подписчики — список новых учетных записей с указанием их статуса и времени последней аутентификации.
  • Маршрутизаторы — каждый NAS с индикатором состояния: доступен / недоступен / нет данных.

Активные сессии

Overview → Live Sessions содержит список всех подписчиков, которые на данный момент отмечены маршрутизаторами как онлайн через RADIUS accounting. Страница автоматически обновляется каждые 30 секунд; в заголовке также расположена кнопка Refresh для обновления вручную.

Фильтрация списка

  • Поиск — поиск по имени пользователя, framed IP или IP-адресу NAS; поиск выполняется автоматически при вводе.
  • Маршрутизатор — фильтрация списка по сессиям на одном NAS.
  • Только ограниченные — показывать только тех подписчиков, чья скорость ограничена лимитом.
  • На странице — 20, 50, 100 или 200 строк.

Содержимое каждой строки

СтолбецЗначение
ПользовательИмя пользователя — ссылка на страницу с подробной информацией об абоненте
Framed IPАдрес, назначенный маршрутизатором данной сессии
МаршрутизаторКороткое имя NAS и его IP-адрес
ТарифТекущий тариф абонента
Реальная скоростьТекущая скорость, установленная на маршрутизаторе, — это скорость тарифа с учетом любого активного окна скорости. Бейдж throttled означает, что из-за ограничения абонент работает на пониженной скорости.
Выкл. / ВклСчетчики байтов сессии в реальном времени
В сетиДлительность сессии
ЗапущеноКогда сессия началась

Разрыв сессии

Кнопка Disconnect в строке ставит в очередь запрос CoA-Disconnect для данной сессии (причина admin_manual) после подтверждения действия. Подписчик отключается немедленно; если его учетная запись все еще активна, он может подключиться снова. Отследить пакет можно в CoA Outbox.

Ежедневная эксплуатация

Отчеты & аналитика

Overview → Reports — это раздел аналитики: тенденции по подписчикам, трафик за определенный период, а также самые активные пользователи и карты в вашей сети.

Выбор диапазона

Каждый показатель на странице привязан к диапазону дат. Выберите предустановленный вариант — 7d, 14d, 30d, 90d — или введите конкретные даты начала и окончания и нажмите Применить. Пока выполняется запрос за длительный период, например 90d, страницу перекрывает оверлей загрузки.

Тренды сессий абонента &

Линейный график с тремя сериями за выбранный период: Active (активные) подписчики, Online (онлайн) сессии и Expired (истекшие) подписчики. Используйте его, чтобы отслеживать рост, отток и часы пиковой нагрузки вашей сети.

Ежедневный трафик

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

Списки топ-10

Четыре таблицы отображают аккаунты с наибольшим объемом трафика, отсортированные по объему в GB:

СписокРанги
Топ-10 загрузок за сегодняМаксимальный объем загрузки с момента последнего ежедневного сброса
Топ-10 по отдаче за сегодняМаксимальная отдача с момента последнего ежедневного сброса
Топ-10 загрузок за месяцМаксимальная загрузка за текущий календарный месяц
Топ-10 по отдаче за месяцМаксимальная отдача за текущий календарный месяц

Трафик по объектам

Таблица трафика по каждой учетной записи с пагинацией и поиском. Две вкладки переключают отображаемые данные:

  • Users — каждый пользователь с указанием имени, тарифа, сегодняшней отдачи/загрузки в MB и отдачи/загрузки за этот месяц в GB.
  • Карты — каждая карта hotspot с указанием её группы, статуса и аналогичным разделением трафика за сегодня / месяц.

Поле поиска фильтрует таблицу по мере ввода; селектор количество строк на странице позволяет выбрать от 20 до 200 строк. Каждая строка содержит ссылку на страницу с подробной информацией об этом подписчике или карте.

Экспорт Отчеты — это экран аналитики. Чтобы получить необработанные данные для анализа в таблице, используйте Tools → Export / Import для загрузки списков пользователей, тарифов или NAS в формате CSV / XLSX.

Страница Live Traffic

Отдельный режим просмотра текущей пропускной способности пользователей, маршрутизаторов и интерфейсов в реальном времени с обновлением раз в секунду. Добавляйте в закладки часто используемые комбинации, чтобы они были доступны в один клик.

Ежедневная эксплуатация

Биллинг и учет &

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

Вы никогда не работаете с дебетом и кредитом Каждое действие — регистрация платежа, добавление расхода, продажа группы карт — автоматически создает сбалансированную бухгалтерскую запись в реестре. Вы работаете с привычными понятиями (счета, расходы, квитанции), а SAMM ведет двойную запись в фоновом режиме и подтверждает их сбалансированность в Оборотно-сальдовой ведомости.

Страница Accounting состоит из одиннадцати вкладок.

Обзор

Финансовый обзор. В верхней части расположены четыре основных показателя:

РисунокЗначение
Наличные средстваОбщий баланс по всем расчетным & банковским счетам
Сумма к получениюДебиторская задолженность — неоплаченные счета клиентов и реселлеров
Ваша задолженностьКредиторская задолженность — неоплаченные расходы
Прибыль за этот месяцДоходы минус расходы за текущий месяц

Ниже: таблица всех денежных & банковских счетов с их балансом и график доходов и расходов за последние 1, 2, 3, 6 или 12 месяцев.

Книги по филиалам

Каждый счет, платеж, расход, актив и денежный счет принадлежит филиалу или основной компании. Счет сохраняет привязку к филиалу пользователя на момент его выставления, даже если пользователь позже переходит в другой филиал. Селектор Branch в верхней части каждой вкладки позволяет отобразить всю компанию, только основную компанию или один филиал с его подфилиалами; списки можно фильтровать, сортировать и группировать по филиалам. Администратор филиала с разрешением Financial видит только бухгалтерские книги своего филиала.

Передача наличных: филиал отправляет наличные со своего кассового счета на кассовый счет компании; операция фиксируется после подтверждения получения компанией. Reports → Branches позволяет сравнить показатели филиалов: выручку, расходы, чистую прибыль, сборы, задолженность, количество активных пользователей и выручку на одного пользователя.

Счета

Инвойс — это счет, который вы выставляете. Нажмите New invoice и заполните:

ПолеЗначение
КлиентПоиск с автозаполнением аккаунта, которому выставляется счет
Категория доходовСчет доходов, на который списываются продажи
Дата выпуска / Срок исполненияЕсли дата выставления не указана, устанавливается сегодняшнее число; если не указана дата оплаты, она будет равна дате выставления
Ставка налога % / группа налогаПо умолчанию используется ставка в Settings → Billing; назначьте группу налогов, чтобы одновременно применить несколько ставок (VAT/GST и др.), при этом каждая будет зачисляться на свой налоговый счет
ПозицииОдна или несколько строк с описанием / количеством / ценой за единицу — промежуточный итог, налог и общая сумма вычисляются на лету

Способ тарификации — полная, сегментированная или бесплатная

В любом случае, когда SAMM собирается выставить счет абоненту — при активации, продлении, смене тарифа, продлении срока действия или при выполнении любого из этих действий массово — появляется тот же выбор счета, который показывает сумму до подтверждения операции:

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

Установите длительность с помощью множителя периодов для полных периодов тарифа или введите точную дату, и SAMM рассчитает стоимость. В обоих случаях панель отображает позиции, налог и общую сумму по мере их изменения, а Paid сразу регистрирует денежный платеж на полную сумму.

"No invoice" — это право, а не флажок Отсутствие оплаты — это финансовое решение, поэтому оно регулируется соответствующим разрешением для каждой роли в Settings → Admins. Это особенно важно для агентов: агент, чьи подписчики оплачивают услуги из собственного предоплаченного баланса, в противном случае мог бы весь день продлевать подписки, менять тарифы и увеличивать сроки действия, ничего за это не оплачивая. Для новых ролей эта настройка по умолчанию выключена.

Даннинг & предоплаченного кошелька

Помимо разовых счетов, SAMM автоматизирует весь цикл сбора платежей. График взыскания (dunning schedule) определяет день выставления счета, дату оплаты и день автоматической блокировки — с возможным начислением пеней, — чтобы абоненты с задолженностью получали напоминания, а затем отключались без необходимости вашего контроля за таблицами. Режим предоплаченного кошелька позволяет абонентам поддерживать баланс, с которого автоматически оплачиваются счета при продлении; они самостоятельно пополняют его через портал клиента с помощью карты или криптоактивов, при этом каждое пополнение и списание фиксируется в реестре.

Тарифы с льготным периодом: сначала счет, продление после оплаты

Распространенная настройка — это цепочка тарифов: по истечении платного тарифа включается короткий grace-тариф с полной скоростью, затем медленный тариф, после чего пользователь отключается. Включите Raise the renewal invoice when a paid plan expires into its next plan в Accounting → Settings, и SAMM выставит счет на продление в момент перехода пользователя на grace-тариф, со сроком оплаты до окончания этого периода. Как только счет будет оплачен — в кассе, онлайн или из кошелька — пользователь вернется на свой тариф с датой начала от дня его истечения, чтобы дата биллинга не смещалась. Пользователи, не оплатившие счет, просто продолжают движение по цепочке.

Не нажимайте Renew plan для этих пользователей Продление тарифа мгновенно восстанавливает полноценную работу службы, независимо от оплаты. Если эта настройка включена, счет и платеж выполнят продление автоматически. По умолчанию настройка выключена, пока вы ее не активируете.

Счета также создаются автоматически при продлении тарифа пользователя (через действие пользователя Renew Expiration или при автопродлении), если у тарифа указана стоимость. Список фильтруется по статусу — unpaid, partial, due, paid — и поддерживает поиск по номеру счета или клиенту. Откройте любой счет, чтобы перейти на страницу с деталями и получить PDF-версию для печати; пользователи могут загрузить свои копии через портал клиента и Telegram бот.

Расходы

Расход — это денежные средства, затраченные на работу ISP. Новый расход фиксирует категорию (счет расходов), производителя, которому была произведена оплата, сумму, дату возникновения и необязательную дату оплаты. Каждый расход имеет тот же жизненный цикл unpaid / partial / due / paid, что и счет, страницу с деталями и доступный для печати voucher PDF.

Квитанции & Платежи

В этих двух вкладках фиксируется фактическое движение денежных средств — в отличие от счета или расхода, которые его вызвали.

  • Поступления — деньги входящие: наличные, полученные от клиента, реселлера или иной доход, поступающий на один из ваших расчетных счетов. Инвойс — это счет на оплату; поступление — это деньги, пришедшие в счет этого инвойса.
  • Платежи — исходящие денежные средства: оплата расходов или выплаты реселлеру.

Регистрация поступления или платежа переводит соответствующий счет или расход в статус оплачено и создает соответствующую запись в главной книге.

Клиенты & продажи карт

На вкладке Customers отображается текущий баланс каждого пользователя — сумма, которую он вам должен. Card sales отвечает за доход от предоплаченных hotspot: здесь отслеживаются проданные card groups и resellers. Реселлер покупает у вас целые группы карт по счету, а затем перепродает отдельные карты конечным пользователям; их balance owed — это сумма, которую они еще должны вам оплатить.

Агенты — оптовый биллинг

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

Два долга, четко разделенные Агент должен вам оптовую цену (в вашем учете это ваш доход); клиент должен агенту розничную цену (вне вашего учета — дебиторская задолженность самого агента). Ваша комиссия — это разница между ними, которая отражается как торговая скидка, а не как расход.

Создайте агента в Settings → Admins, назначив новому администратору встроенную роль Agent. Агент — это логин администратора с ограниченной областью доступа, который имеет:

НастройкаЗначение
Комиссия %Комиссия агента от розничной цены (например, 40% — вы получаете 60% как оптовую выручку). Можно редактировать для каждого агента в любое время.
Кредитный лимитДо какого значения может опуститься предоплаченный баланс агента ниже нуля, прежде чем продления будут отклонены. Установите 0 для строгого соблюдения предоплаты.
Баланс предоплатыПополняйте баланс по мере оплаты агентом; при каждом продлении с него будет списываться оптовая стоимость.

Когда один из подписчиков агента продлевает подписку, SAMM списывает с баланса агента оптовую цену, зачисляет вашу прибыль и выставляет конечному клиенту реальный розничный счет, который оплачивается агенту и не отражается в вашем бухгалтерском учете. Dunning на стороне агента — отдельный переключатель в Settings → Billing, включенный по умолчанию, с редактируемым льготным периодом — автоматически приостанавливает доступ неплательщика (отправляя CoA disconnect); когда агент фиксирует оплату клиента, подписчик активируется мгновенно.

Агент входит в ограниченный режим просмотра: свою панель мониторинга, страницу кошелька My Balance, список My Customers со счетами и платежами каждого клиента, а также My Statement — всё это ограничено его собственным счетом. Общие счета вашей компании, другие агенты и клиенты других администраторов остаются скрытыми.

Активы & Денежные счета

  • Assets — регистрация основных средств (маршрутизаторов, транспорта, оборудования). SAMM отслеживает их стоимость и амортизацию с течением времени.
  • Cash — управление вашими денежными & банковскими счетами и вашими капитальными счетами: собственным капиталом, где взнос — это деньги, которые владелец вкладывает в бизнес, а вывод — деньги, которые извлекаются. Капитал не является доходом и никогда не отображается в Profit & Loss.

Отчеты — финансовая отчетность

Вкладка Reports предназначена для бухгалтера. Доступно пять отчетов; для каждого можно выбрать период дат и экспортировать его в PDF:

ОтчетОтветы
Прибыль & УбытокДоходы, расходы и чистая прибыль за выбранный период. Метод начисления — доходы учитываются при выставлении счета, расходы — по мере их возникновения, а не в момент движения денежных средств.
Балансовый отчетНа определенную дату: ваши активы в сопоставлении с обязательствами и собственным капиталом. Значок balanced подтверждает, что обе стороны баланса совпадают.
Движение денежных средствПо каждому денежному счету — начальный остаток, приход, расход и конечный остаток за выбранный период.
Время жизни записейДебиторская и кредиторская задолженность, распределенная по периодам просрочки, чтобы вы могли взыскивать оплату по просроченным счетам и своевременно оплачивать собственные счета.
ДополнительноОсновные книги: Главная книга (каждая запись по одному счету с накопительным итогом), Оборотно-сальдовая ведомость (проверка сбалансированности книг), Журнал и лог активности.
Проверка баланса В Trial Balance суммы по дебету и кредиту каждого счета должны быть равны — это подтверждает корректность учета. Любое расхождение указывает на ошибку при проведении операций, которую необходимо исследовать.

Экспорт в бухгалтерское ПО

В разделе Accounting → Reports → Export выполните загрузку книг в формате CSV для QuickBooks, Xero или любой электронной таблицы: General Journal, Chart of Accounts, Invoices, Trial Balance, Profit & Loss и Balance Sheet. Для General Journal, Invoices и P&L используется диапазон дат; остальные отчеты формируются на текущую дату. Те же данные доступны через API по адресу GET /api/v1/accounting/export/{kind} (format=json|csv, scope accounting:read) для BI-конвейеров и Zapier. Экспорт исключает аннулированные записи, поэтому загрузка всегда совпадает с данными в отчетах на экране.

Ежедневная эксплуатация

Отмена & одобрения

Большинство ошибок в панели ISP связаны с финансами: продление подписки не тому абоненту, двойное зачисление платежа или смена тарифа не на том аккаунте. SAMM предоставляет пятиминутное окно отмены для таких действий, а в случаях, когда действие предполагает возврат средств, — подтверждение суперадминистратора, прежде чем оно вступит в силу.

Окно отмены действий

Каждое действие администратора, изменяющее баланс или состояние, фиксируется в реальном времени. В течение следующих пяти минут в верхней панели отображаются кнопка Undo и список Action history — нажмите на стрелку, чтобы отменить последнее действие, или откройте историю и вернитесь к любому моменту в этом интервале. Redo вернет изменения обратно.

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

Отмена отклоняется — с указанием причины на экране — если её выполнение приведет к удалению объекта, который не был создан этой операцией:

ОтказЧто это значит
Эта запись больше не существуетАбонент, счет или платеж были удалены после вашего действия — восстанавливать больше нечего.
Эта запись уже существуетНа этом месте было создано новое устройство; отмена операции перезапишет более новую запись.
Эта запись была изменена в результате вашего действияКто-то другой внес изменения в это время — отмена действий приведет к скрытому удалению их правок.
Этот шаг больше не отображается в вашей историиПятиминутное окно закрыто.

Отмена — это обратное действие, а не удаление: и исходное действие, и его отмена остаются в Audit log, поэтому запись о произошедшем никогда не теряется. Действия, которые что-то создают, четко предупреждают перед выполнением: отмена этого действия удалит созданные объекты.

Механизм подтверждения агента

Агент оплачивает услуги абонента из своего предоплаченного баланса в момент их активации. Таким образом, отмена действия становится способом возврата средств — и способом обмана: активировать абонента, позволить ему пользоваться связью весь месяц, а затем удалить его в последний день и вернуть оплату.

Таким образом, SAMM разделяет действия агента в зависимости от того, как перемещаются денежные средства:

НаправлениеПримерыПринципы работы
Приводит к финансовым затратам агента Активировать, продлить, сменить тариф, принять платеж клиента Немедленно. Основная работа агента не ждет.
Возврат средств Отменить, удалить абонента, удалить счет, аннулировать платеж Сохранено как запрос. Изменения не вступят в силу до тех пор, пока superadmin не одобрит их.

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

Работа с очередью

Запросы поступают в Accounting → Agents Approval с указанием агента, действия, объекта запроса и суммы возврата — числа, на основании которого принимается решение. Фильтруйте по агенту или статусу, используйте поиск, отмечайте несколько заявок и одобряйте или отклоняйте их группой; при отклонении можно указать краткую причину, которую увидит агент.

Делегировать Проверка агентов в течение всего дня редко входит в обязанности superadmin. Право Agents Approval может быть предоставлено любой роли в Settings → Admins, чтобы сотрудник, который фактически занимается проверкой, получил именно эти полномочия — и ничего больше. Создание и управление агентами остаются доступными только для superadmin. Никто не может одобрить собственный запрос.

Что видит агент

Агенту доступна страница My Account → Pending Approvals, где перечислены все его запросы: те, что ожидают рассмотрения, а также одобренные или отклоненные — с указанием причины отказа. Без этого отказ было бы невозможно отличить от пропавшего запроса, и агент просто отправил бы его снова.

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

Для ваших абонентов

Онлайн-платежи

SAMM позволяет вашим абонентам оплачивать счета онлайн — банковской картой (Stripe или PayPal), криптовалютой (Binance) или через Sham Cash в Сирии. Когда абонент платит, SAMM отмечает счёт как оплаченный, вносит запись в ваш учёт и — если доступ был ограничен из-за неуплаты — автоматически восстанавливает подключение. С вас не берётся плата: каждый шлюз использует ваш собственный аккаунт, поэтому деньги поступают напрямую вам.

Включить (любой шлюз)

  1. Перейдите в Financial → Online payments (только для superadmin).
  2. Нажмите на шлюз, чтобы развернуть его: Stripe, PayPal или Binance.
  3. Заполните его поля, отметьте Enable this gateway и нажмите Save. SAMM не позволит сохранить изменения, пока не будут заполнены обязательные поля.
  4. Нажмите Run test, чтобы проверить правильность введенных учетных данных.
  5. Готово — теперь ваши подписчики видят кнопку Pay в неоплаченных счетах на портале (а также на странице с истекшим сроком действия подписки).

Вы можете включить более одного шлюза — абонент сам выбирает, какой из них использовать.

Stripe — банковские карты, весь мир

  1. Создайте бесплатный аккаунт на stripe.com. Оставьте Test mode включенным, пока тестируете сервис.
  2. Перейдите в Developers → API keys и скопируйте Secret key (он начинается с sk_).
  3. В SAMM разверните Stripe, вставьте Secret key, выберите валюту и кассовый счет для получения средств, затем нажмите Сохранить и Запустить тест.
  4. Рекомендуется добавить webhook для надежного подтверждения платежей. В Stripe перейдите в Developers → Webhooks → Add endpoint, укажите URL https://YOUR-SAMM/pay/webhook/stripe, выберите событие checkout.session.completed, затем скопируйте секретный ключ подписи (whsec_…) в поле Webhook signing secret в SAMM.
Запуск в эксплуатацию Тестовый режим работает везде. Для получения реальных платежей через Stripe требуется страна, поддерживаемая Stripe, и привязанный банковский счет.

PayPal — карты & баланс PayPal

  1. Создайте аккаунт PayPal Business, затем на сайте developer.paypal.com создайте REST App и скопируйте его Client ID и Secret.
  2. В SAMM разверните PayPal, вставьте Client ID и Client secret, выберите Sandbox (тестирование) или Live, затем нажмите Save и Run test.
  3. Рекомендуется: добавьте webhook на developer.paypal.com → ваше приложение → Webhooks, URL https://YOUR-SAMM/pay/webhook/paypal, подпишитесь на CHECKOUT.ORDER.APPROVED и PAYMENT.CAPTURE.COMPLETED, затем вставьте Webhook ID в SAMM, чтобы входящие уведомления проходили криптографическую проверку.

Binance — криптовалюта, работает везде, банк не нужен

Это лучший вариант, если карты и PayPal недоступны. Ваши абоненты платят криптовалютой; SAMM отслеживает ваш аккаунт Binance и автоматически отмечает счёт как оплаченный. Нужны три вещи: API Key, API Secret и реквизиты для получения — адрес кошелька и/или Binance Pay ID.

Шаг 1 — создайте API-ключ только для чтения

Безопасность прежде всего Создайте ключ только с правом чтения. Никогда не включайте Withdraw или Trade — SAMM нужно только читать данные о ваших входящих платежах, перемещать средства не требуется.
  1. Войдите в Binance → откройте Account → API Management (или введите в поиске "API Management").
  2. Нажмите Create API → выберите System generated → укажите имя, например "SAMM" → пройдите проверку безопасности.
  3. Binance показывает API Key и Secret Key — скопируйте оба сейчас (Secret Key отображается только один раз).
  4. Нажмите Edit restrictions и оставьте отмеченным только «Enable Reading». Оставьте Spot Trading и Withdrawals выключенными. (Дополнительно: ограничьте действие ключа IP-адресом вашего сервера.)
  5. Вставьте API Key и API Secret в карточку Binance в SAMM (сначала Key, затем Secret — в том же порядке, в котором их отображает Binance).

Шаг 2 — получите адрес вашего кошелька для получения средств

  1. В Binance перейдите в Wallet → Spot → Deposit (Deposit Crypto).
  2. Выберите монету USDT.
  3. Выберите сеть — TRC20 самая дешевая и распространенная; BEP20 и ERC20 также поддерживаются. Используйте ту же сеть, которую вы выбрали в SAMM.
  4. Скопируйте Address депозита и вставьте его в поле On-chain receiving wallet address в SAMM. Убедитесь, что в выпадающем списке Network в SAMM выбрана та же сеть, которую вы выбрали ранее.

Шаг 3 — (опционально) Binance Pay ID

Для подписчиков, которые предпочитают Binance Pay (мгновенно, без комиссии сети): в приложении Binance откройте Pay и запишите ваш Pay ID (также подойдут ваш email или номер телефона). Вставьте его в поле Binance Pay ID в SAMM. После этого подписчики смогут оплачивать как через Pay ID, так и on-chain.

Наконец, установите флажок Enable, нажмите Save, затем Run test (это проверит возможность чтения данных вашего аккаунта с помощью ключа). Всё готово.

Точная сумма, правильная сеть Абонент должен отправить точную сумму, указанную в SAMM (последние цифры которой идентифицируют его счет), через правильную сеть. Неверная сумма или неправильная сеть приведут к задержке или потере платежа.

Сирийский шат — Sham Cash

Ваши пользователи оплачивают услуги через приложение Sham Cash или сайт Sham Cash, и SAMM получает уведомление в момент совершения платежа. Деньги поступают на ваш собственный коммерческий аккаунт Sham Cash.

  1. Откройте верифицированный коммерческий аккаунт Sham Cash, затем обратитесь в поддержку Sham Cash с просьбой создать для вас службу электронных платежей (у вас запросят ссылку на логотип и название, которое будут видеть ваши пользователи).
  2. Sham Cash предоставляет вам три значения: Agent Key, Secret Key и Base URL. Для тестовой и реальной служб предусмотрены свои наборы из трех значений.
  3. В SAMM откройте Финансы → Онлайн-платежи → Sham Cash, оставьте Подключение на Official API, вставьте три значения, выберите валюту (USD или SYP, ту же, что валюта SAMM) и нажмите Сохранить, затем Запустить тест.
  4. SAMM должен быть доступен из интернета, чтобы Sham Cash мог подтвердить каждый платеж. Если ваш SAMM опубликован по другому адресу, введите его в Public SAMM address for the callback. Со стороны Sham Cash ничего настраивать не нужно: SAMM передает свой адрес с каждым платежом.
Тестовая служба или реальная служба При использовании значений test каждый платеж является симуляцией: страница оплаты принимает код 000000, SAMM отображает счет как оплаченный, и денежные средства на счета не поступают. Для реальных платежей необходимы данные вашей real службы из поддержки Sham Cash. Проверьте сохраненный Base URL: тестовый адрес не является реальным.

Действия пользователя: на платежной карте пользователь нажимает Open Sham Cash. На телефоне открывается приложение Sham Cash (версии 2.2.5 или новее), в противном случае — веб-сайт Sham Cash; пользователь проверяет сумму и подтверждает ее кодом подтверждения перевода (настроенным в приложении Sham Cash). На компьютере на карте также отображается QR-код для сканирования камерой телефона. Каждая платежная ссылка работает в течение 10 минут; карта подтверждается автоматически, как только это делает Sham Cash.

Собственное приложение Sham Cash также может принимать платежи за вас: предоставьте ему токен только с разрешением Payment apps (см. раздел REST API). Оно находит пользователя по имени пользователя и фиксирует принятый платеж.

Sham Cash без ключей продавца (Non-official API)

Нет мерчант-сервиса от Sham Cash? SAMM может принимать платежи Sham Cash через shamcash-api.com — независимый сервис (не Sham Cash), который читает переводы, поступающие на ваш собственный счёт Sham Cash. Он может только читать: отправлять деньги он не может.

  1. Создайте аккаунт на shamcash-api.com и привяжите свой счёт Sham Cash: в приложении Sham Cash откройте Мой аккаунт → Привязанные устройства и отсканируйте их QR-код. Оформите подписку и создайте API-ключ только для чтения.
  2. В SAMM откройте Финансы → Онлайн-платежи → Sham Cash, установите Подключение на Non-official API (shamcash-api.com), вставьте API-ключ, выберите валюту и нажмите Сохранить. SAMM считывает ваш ID аккаунта и адрес Sham Cash из ключа. Затем Запустить тест.

Что делает пользователь: на карточке оплаты показаны ваш адрес Sham Cash (и его QR-код), сумма и короткий код, например SM-1234. Пользователь отправляет сумму из своего приложения Sham Cash и пишет код в комментарии к переводу. SAMM подтверждает платёж в течение минуты. Перевод без кода, на меньшую сумму или в другой валюте не зачисляется, а оставляется на вашу проверку.

Страница оплаты и продление онлайн

Settings → Billing → Pay page активирует публичную страницу по адресу /pay: пользователь вводит свое имя пользователя, видит сумму задолженности и производит оплату без авторизации. Эта же Pay page доступна в пользовательском портале для авторизованных пользователей.

  • Продление: пользователи могут продлить свой тариф онлайн на срок от 1 до 12 периодов до или после истечения его действия. Предоплата сохраняет остаток времени; пользователь с истекшим тарифом снова получает доступ в сеть сразу после поступления оплаты. Два переключателя определяют, где предлагается продление: Renew on the Pay page и Renew in the user portal (оба включены по умолчанию).
  • Поиск пользователей без префикса или суффикса: для имен пользователей вроде 858000@inet ввод 858000 (минимум 6 символов) позволяет найти аккаунт. Если найдено несколько подходящих аккаунтов, пользователю будет предложено ввести полное имя пользователя. По умолчанию выключено.
  • Выберите, какая информация об аккаунте будет отображаться на странице (маскированное имя, тариф, дата истечения срока действия и др.); по умолчанию отображается только маскированное имя.

Что видит абонент

  1. Авторизуйтесь в личном кабинете клиента → Мои счета.
  2. В неоплаченном счете они нажимают Pay (или «Pay · Stripe» / «Pay · Binance», если включено несколько способов оплаты).
  3. Карта: абонента перенаправляют на защищённую страницу шлюза. Криптовалюта: абонент видит точную сумму, ваш адрес с QR-кодом и/или ваш Pay ID.
  4. После оплаты счет переходит в статус Paid, данные заносятся в бухгалтерский учет, а если срок действия подписок истек, они восстанавливаются автоматически — у пользователей с истекшим сроком действия подписки на соответствующей странице даже появляется кнопка «Pay & reconnect».
Ваш учет остается точным Каждый онлайн-платеж создает одну сбалансированную двойную запись (Dr Cash / Cr Accounts Receivable) и фиксирует способ оплаты (Stripe / Binance) в счете, в истории платежей и в PDF — так вы всегда знаете, каким образом поступил каждый платеж.

Ежедневная эксплуатация

Тикеты поддержки

В SAMM встроена служба поддержки. Подписчики создают тикеты через портал клиента или Telegram-бот, администратор может открыть тикет от имени подписчика, а ваша команда обрабатывает их все в разделе Users → Support Tickets.

Очередь тикетов

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

  • Статусные индикаторы — по одному для каждого статуса тикета, с актуальным счетчиком, чтобы нагрузка была видна с первого взгляда.
  • Приоритет — Normal, Moderate или Critical.
  • Active / Withdrawn — клиент может отозвать тикет, который ему больше не нужен; отозванные тикеты отображаются серым цветом и по умолчанию скрыты.
  • Поиск — по номеру тикета, теме или клиенту.

Индикатор в боковой панели отображает количество открытых тикетов, чтобы вы ничего не упустили.

Создание тикета

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

Работа с тикетом

Откройте тикет, чтобы прочитать всю ветку переписки. Оттуда вы сможете:

  • Ответить клиенту — публичное сообщение, которое абонент видит в своем личном кабинете и через Telegram-бот.
  • Добавить внутреннюю заметку — сообщение только для персонала, скрытое от клиента, для передачи информации внутри вашей команды.
  • Измените статус и приоритет тикета.

Щелкните правой кнопкой мыши по любой строке — или используйте кнопку ⋮ — чтобы изменить статус, приоритет, отправить ответ или добавить внутреннюю заметку, не покидая очередь.

Ежедневная эксплуатация

Центр уведомлений

SAMM автоматически информирует подписчиков — через email, Telegram, SMS и WhatsApp — и позволяет делать рассылки сообщений. Служба samm-notification доставляет все уведомления через одну очередь с ограничением скорости. На странице System → Notification Center шесть вкладок.

Обзор

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

Каналы

Настройте способ отправки сообщений SAMM . Электронная почта использует собственное уведомление. учетную запись, хранящуюся отдельно от SMTP для восстановления пароля в Настройки . Telegram использует токен бота, SMS проходит через общий HTTP-шлюз или Twilio, и WhatsApp использует официальный Meta WhatsApp Cloud API (созданный в Meta для Разработчики) с дополнительным неофициальным QR-мостом на свой страх и риск — мост устанавливается в один клик на сервер с чистой ОС и поставляется в виде готового к использованию контейнера на Docker . Все секреты канала сохраняются Зашифровано Fernet. Каждый подписчик на клиентском портале выбирает, какие каналы он хочет хотите и можете полностью отказаться.

SMS-шлюзы также могут отправлять сообщения в режиме шаблонов для операторов, которые принимают только утвержденные шаблоны: вы указываете имя шаблона, а SAMM отправляет значения в том порядке, в котором их ожидает шаблон. Выберите формат номера, требуемый для каждого шлюза (международный с + или 00, либо национальный с ведущим 0 или без него). Вставьте рабочую ссылку на шлюз от вашего провайдера, и SAMM автоматически заполнит поля, выберет режим шаблонов и формат номера.

Сообщения

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

Правила & Таймеры

Эта вкладка определяет, когда и как отправляются автоматические уведомления. Для каждого события вы можете настроить следующее:

  • Включено ли правило on.
  • Игнорировать отказ — при включении сообщение будет доставлено каждому подписчику, даже если он отказался от рассылки. Используйте эту опцию только для важных транзакционных сообщений.
  • Сроки — например, за сколько дней до истечения срока действия отправляется напоминание о продлении.
  • Ограничение & скорости доставки — воркер обрабатывает очередь по одному пакету за такт; размер пакета и интервал такта вместе определяют скорость отправки сообщений, поэтому массовая рассылка никогда не перегрузит ваш почтовый сервер.

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

Широковещательная рассылка

Отправьте разовое сообщение — об окне технического обслуживания, изменении цены — выбранному набору подписчиков. Рассылка проходит через ту же очередь с ограничением скорости, что и автоматические уведомления.

Исходящие

Все сообщения, которые SAMM поставил в очередь или отправил, с соответствующим статусом доставки для каждого сообщения, чтобы вы могли подтвердить получение уведомления подписчиком или узнать причину недоставки.

Система

VPN: WireGuard, L2TP/IPsec, SSTP

SAMM запускает собственный VPN-сервер на хосте SAMM, чтобы маршрутизаторы в любом месте — за NAT, через мобильную сеть, в другом городе — могли связаться с SAMM для RADIUS и управления. Все настройки находятся в System → VPN; использование shell не требуется. В новых установках все три варианта готовы к работе, но по умолчанию выключены.

ТипИспользуйте для
WireGuardМаршрутизаторы RouterOS 7, телефоны и ноутбуки. Самый быстрый и простой способ.
L2TP/IPsecМаршрутизаторы с RouterOS 6 и 7, а также устройства, не поддерживающие WireGuard.
SSTPДва или более маршрутизатора, которые выходят в интернет через один и тот же публичный адрес, под управлением RouterOS 6 или 7.

Вкладка Server

  1. Для WireGuard нажмите Generate Keys, чтобы создать пару ключей сервера.
  2. Проверьте порт прослушивания, адрес туннеля сервера и диапазон адресов клиентов или оставьте значения по умолчанию.
  3. Включите сервер. Каждое изменение подтверждается во всплывающем окне.

Если хост SAMM имеет частный адрес, а ваш публичный адрес перенаправлен на него, SAMM определяет этот публичный адрес (или вы вводите его один раз на странице VPN) и передает его каждому клиенту и маршрутизатору.

Добавить маршрутизатор одним вставлением

Нажмите Add Client и укажите имя. Для MikroTik скопируйте однострочную install link и вставьте её в терминал маршрутизатора: это одним шагом настроит туннель, собственный SAMM-логин маршрутизатора, его конфигурацию RADIUS и страницу для пользователей с истекшим сроком действия. Выберите способ добавления маршрутизатора в SAMM:

  • Управляемый NAS — маршрутизатор аутентифицирует ваших пользователей через SAMM, и SAMM управляет этим процессом.
  • Только мониторинг — для точек доступа и других устройств, за которыми вы хотите наблюдать (состояние, карта, страница Wireless), без возможности авторизации пользователей через них.

Маршрутизатор, добавленный сотрудником филиала, принадлежит этому филиалу. Также можно добавить WireGuard-клиентов с помощью файла конфигурации или QR-кода для мобильного приложения. Клиентов можно переименовать, отключить или удалить; их цвет показывает, подключены ли они, устарел ли статус подключения или они никогда не подключались.

Перегенерация ключей является деструктивной операцией Regenerate Keys изменяет пару ключей сервера WireGuard. Все уже настроенные клиенты перестанут подключаться, пока не получат новую конфигурацию. Панель попросит вас ввести слово для подтверждения.

Сеть & маршрутизаторы

RouterOS 6 и 7

SAMM управляет маршрутизаторами под управлением RouterOS 6 и RouterOS 7 одновременно. Вам не нужно ничего менять: SAMM определяет версию каждого маршрутизатора и отправляет команды, совместимые с этой версией.

Все работает в обоих случаях: мастер настройки, Auto-Complete, доставка конфигураций, действия менеджера устройств, Websites & Apps, QoS, NTP, страница с истекшими пользователями, а также WireGuard (RouterOS 7), L2TP/IPsec и SSTP соединения. В RouterOS 6 списки Websites & Apps создаются на основе доменных имен из каталога, так как в версии 6 отсутствуют DNS address lists.

Старые маршрутизаторы без WireGuard В RouterOS 6 нет WireGuard. Подключайте такие маршрутизаторы через L2TP/IPsec или SSTP.

Сеть & маршрутизаторы

Передача конфигурации

Каждое изменение, которое SAMM отправляет на ваши маршрутизаторы — RADIUS, страницу об истечении срока действия, мастер, DNS-фильтр, Websites & Apps, QoS, Auto Security, DNS, NTP и родительский контроль — представляет собой одну доставку, отслеживать которую можно по пути Devices → Config delivery.

  • Индикатор выполнения и результат для каждого маршрутизатора, с указанием точной причины в случае отказа маршрутизатора применить изменения.
  • Маршрутизатор, находящийся в автономном режиме, получит изменения, как только восстановит связь; при сбое применение изменений повторяется автоматически, а кнопка Retry позволяет повторить попытку одним кликом.
  • Каждое изменение проверяется на маршрутизаторе после его применения; при этом настройки RADIUS и QoS никогда не остаются пустыми в процессе внесения изменений.

Сеть & маршрутизаторы

Действия менеджера устройств для нескольких маршрутизаторов

В Devices → Manager отметьте маршрутизаторы и откройте Actions, чтобы выполнить одну задачу для всех выбранных устройств: отправить Websites & Apps, отправить конфигурацию RADIUS, настроить страницу для пользователей с истекшим сроком действия, Router Security, создать резервную копию и экспорт, обновить RouterOS, запустить скрипт или перезагрузить.

Каждый диалог открывается с наиболее полными настройками, найденными среди выбранных вами маршрутизаторов. Задачи выполняются в фоновом режиме: вы можете покинуть страницу, а всплывающее окно сообщит вам, когда маршрутизатор завершит работу или по какой причине произошла ошибка. Рискованные действия требуют ввода слова для подтверждения. Менеджер устройств также показывает филиал каждого маршрутизатора.

Сеть & маршрутизаторы

Динамический ускоритель скорости

Пока интернет-канал маршрутизатора простаивает, предоставляйте пользователям дополнительную скорость бесплатно — и возвращайте её, как только линия будет загружена. Включите эту функцию в Tools → Speed Boost → Dynamic (по умолчанию выключена) и выберите тарифы, для которых может применяться ускорение.

  • Все пользователи, подключенные к этому маршрутизатору, получают одинаковый множитель скорости загрузки, по умолчанию до 3 раз.
  • Бустер анализирует часы пиковой и низкой нагрузки каждого маршрутизатора (по умолчанию за 3 дня, последние дни имеют наибольший вес), составляет тариф каждые 15 минут, заглядывает на час вперед и постепенно повышает уровень ускорения.
  • Контроль осуществляется каждую минуту, и ускорение прекращается, как только трафик возвращается в норму. Маршрутизаторы, которые загружены большую часть времени, никогда не ускоряются.
  • Пользователи видят значок Boosted в своем портале; в списке пользователей есть столбец и фильтр Boosted.

Ежедневная эксплуатация

Активации & Журнал данных

Активации

Overview → Activations показывает, какие тарифы активировались чаще всего за текущую неделю, месяц, год или в интервале между двумя датами по сравнению с предыдущим периодом: продления, новые пользователи и смены тарифов. Списки By plan и By user поддерживают поиск, фильтрацию, сортировку и экспорт в Excel или CSV.

Журнал данных

Overview → Data Log позволяет искать по журналам данных всех пользователей одновременно: найдите, кто обращался к адресу или диапазону, порту, протоколу или приложению за любой период. Группируйте результаты, сохраняйте виды и экспортируйте данные в CSV или XLSX. Срок хранения истории настраивается в History cleaner.

Принять лог

В журнале Accept Log отображается, с какого маршрутизатора была произведена каждая попытка входа; доступны поиск, группировка, сортировка и экспорт по маршрутизатору.

Система

Брендинг: ваш логотип, название и цвет

Настройте SAMM в соответствии с брендингом вашей компании. Все настройки находятся в System → Settings → ISP.

Ваш логотип

  1. Нажмите на плитку с логотипом или Upload logo и выберите изображение в формате PNG, JPEG, WebP или GIF (до 5 MB).
  2. Перетащите изображение, чтобы разместить его, и используйте ползунок для масштабирования. Прозрачный фон останется прозрачным.
  3. Нажмите Use logo: изображение будет сразу сохранено в виде квадрата 400×400 px. Remove удаляет его.

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

Брендинг на панелях

Включите Use my brand on the panels и укажите название, цвет и строку футера (например, номер службы поддержки), затем нажмите Save на вкладке ISP. После этого ваш бренд заменит SAMM на панели администратора, в портале пользователя и на обеих страницах входа. Выключите этот переключатель, чтобы вернуть прежний вид.

Система

Cloudflare Tunnel

Туннель Cloudflare Zero Trust публикует SAMM в открытом интернете без открытия портов межсетевого экрана — это полезно, если хост SAMM находится за NAT. Управление осуществляется в разделе System → Cloudflare Tunnel.

Статус службы

Страница открывается на карточке статуса, в которой отображается состояние коннектора:

СостояниеЗначение
ВыполняетсяТуннель активен и пересылает трафик
ОстановленоНастроено, но в данный момент не запущено
Не настроеноБинарный файл присутствует — вставьте токен для настройки
Не установленоСнова запустите install.sh, чтобы установить бинарный файл cloudflared

Также отображается версия cloudflared и настроен ли для коннектора автозапуск при загрузке системы.

Настройка туннеля

  1. В панели мониторинга Cloudflare Zero Trust (one.dash.cloudflare.com) откройте Networks → Tunnels и нажмите Create a tunnel.
  2. Выберите коннектор Cloudflared, укажите имя туннеля и нажмите Сохранить. На шаге установки скопируйте только токен — длинную строку после --token.
  3. Вставьте его в SAMM и нажмите Configure Tunnel. SAMM передает токен в cloudflared и запускает коннектор.
  4. Вернитесь в Cloudflare и добавьте Public hostname: выбранный вами адрес, тип HTTP, URL localhost:80 (через прокси nginx — рекомендуется) или localhost:8000 (напрямую к API).

Через несколько секунд индикатор статуса станет зеленым, и SAMM будет доступен по публичному имени хоста. После настройки с помощью действий в один клик можно Запустить, Остановить или Перезапустить коннектор, Заменить токен для его ротации или Удалить туннель (действие с подтверждением путем ввода REMOVE).

Открытых портов нет, токен не записывается в базу данных Туннель устанавливает исходящее соединение с edge-узлом Cloudflare — на сервере не открывается ни один порт межсетевого экрана. Токен пересылается в cloudflared и хранится в /etc/cloudflared/; SAMM никогда не сохраняет его в базе данных. TLS-сессия завершается на edge-узле Cloudflare, поэтому сам SAMM работает по обычному HTTP на loopback-интерфейсе.

Система

Настройки

System → Settings содержит активные настройки с поддержкой горячей перезагрузки. Демоны перечитывают их при следующем такте — перезапуск службы не требуется. Настройки организованы по вкладкам.

Общие параметры настройки

НастройкаПо умолчаниюЭлементы управления
samm-radius interval30 sКак часто проверяются события по таймеру и отправляются CoA
samm-worker interval5 sPing маршрутизатора + частота синхронизации MikroTik API
Интервал промежуточных расчетов60 sИнтервал учета, передаваемый на маршрутизаторы
Время ежедневного сброса00:00При обнулении счетчиков ежедневного использования
Часовой пояс сервераUTCЧасовой пояс для окон скорости и ежедневного сброса
Порт CoA по умолчанию3799UDP-порт по умолчанию для CoA-пакетов
Максимальное количество попыток CoA3Количество повторных попыток перед переходом на резервный Disconnect-Request

Уменьшите интервал samm-radius для более строгого контроля; увеличьте его для снижения нагрузки.

Идентификационные данные ISP, логотип, валюта & для биллинга (вкладка ISP)

Все, о чем операторы чаще всего спрашивают «где это изменить?», находится по пути System → Settings → ISP. Отредактируйте поле и нажмите Save — изменения вступят в силу немедленно (без перезагрузки) и отобразятся в счетах, квитанциях, PDF-файлах и в личном кабинете клиента.

Что вы изменилиГде это отображается
Имя ISPСчета, квитанции, карты hotspot, заголовок портала
Телефон поддержки & emailСчета и распечатанные карты hotspot
Налоговый / регистрационный номерПечатать в счетах
Логотип ISP (отдача PNG/JPEG/WebP/GIF)Загрузите, затем перетащите и масштабируйте изображение для обрезки в браузере; оно отображается в PDF-инвойсах/квитанциях, на распечатанных картах hotspot и страницах авторизации маршрутизатора. См. Branding.
Код валюты (e.g. USD)Валюта ISO в счетах и главной книге
Символ валюты (e.g. $)Каждая сумма в админ-интерфейсе, клиентском портале и PDF
Налог вкл/выкл, метка & ставкаДобавляет строку VAT/GST в счета (например, метка VAT, ставка 11 = 11%)
Изменить символ валюты Чтобы изменить валюту, отображаемую во всех разделах (например, с $ на £ или локальный символ), установите Currency symbol на вкладке ISP и нажмите Сохранить — это одновременно обновит панель администратора, портал клиента и все PDF-файлы. Рядом укажите Currency code (USD, EUR, …) для ISO-кода, который будет печататься в счетах.

Конфиденциальность — анонимная статистика установки

Когда SAMM проверяет наличие обновлений, он может отправить в SecuryTik случайный ID установки, версию SAMM, ваш тариф и страну (определенную по IP через Cloudflare) — никаких данных о подписчике или клиенте. Это помогает нам подсчитывать количество активных установок, а также определять приоритеты поддержки и языков. Отключите эту функцию в любое время в System → Settings → Privacy; см. политику конфиденциальности.

Вкладка Email

Настройте SMTP-сервер, используемый для отправки кодов восстановления пароля администраторам и клиентам (хост, порт, SSL/STARTTLS, имя пользователя, адрес отправителя, пароль). Нажмите Test connection, чтобы проверить учетные данные без отправки письма.

Две учетные записи электронной почты Вкладка Email здесь предназначена только для OTP / восстановления пароля. Аккаунт, используемый для уведомлений клиентов, настраивается отдельно в Центре уведомлений.

Система

Администраторы, филиалы & роли

System → Admins — здесь вы определяете, кто может входить в портал администратора, какие права доступа имеет каждый пользователь и каких пользователей он может видеть. Начиная с версии 5.1.0 администраторы образуют дерево филиалов и персонала. На странице есть две вкладки: Admins и Roles.

Филиалы и сотрудники

УзелОписание
ФилиалМесто — офис, город. Ему принадлежат созданные в нем пользователи. Вход под учетной записью филиала невозможен: у него нет ни пароля, ни роли.
Администратор (персонал)Пользователь, который входит в систему. При привязке к филиалу он считается его сотрудником: каждый пользователь и карта, которые он создает, принадлежат этому филиалу.
SuperadminВсегда в корне дерева, никогда не под филиалом. Видит и может делать всё.

Используйте + Branch и + Admin для построения дерева, а также перетаскивайте один узел на другой для его перемещения. Только филиал может иметь подчиненных администраторов. Агент — это администратор, который продает и владеет тем, что продает; сотрудники, назначенные под агента, используют кошелек и правила одобрения этого агента.

Кто и что видит

Видимость соответствует структуре дерева. Филиал — и все работающие в нем — видят своих пользователей и пользователей нижестоящих филиалов. При этом соседние филиалы или филиалы выше по иерархии не видны. HQ видит всё. Права администратора никогда не превышают прав, предоставленных администраторами выше, и администратор может предоставлять только те права, которыми обладает сам.

Лимиты на филиал

ОграничениеЧто подсчитывается
Максимальное количество пользователейСколько пользователей может поддерживать филиал и находящиеся под ним филиалы. Удаление пользователя освобождает место.
Максимальное количество картСколько карт hotspot может быть распечатано в филиале.

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

Устройства филиала

Каждый маршрутизатор, включая точки доступа, принадлежит филиалу или Headquarters. Откройте меню филиала и выберите Assigned devices, чтобы отметить принадлежащие ему устройства; устройство, с которого вы снимете отметку, вернется в Headquarters, общие для всех филиалов. Устройство, добавленное сотрудником филиала (через менеджер устройств, форму мониторинга или ссылку для установки VPN), попадает в его филиал; устройство, добавленное Headquarters, изначально закрепляется за Headquarters.

КтоУстройство филиала
Сотрудники этого филиала, вышестоящих филиалов и головного офисаУправление
Персонал дочерних филиаловПросмотр, только для чтения
Другие филиалыНе отображается
Пользователи этого филиала и его дочерних филиаловВозможность входа через него

Карта, страница Wireless, списки состояния и маршрутизаторов работают по тому же правилу. За авторизацию отвечает настройка Users log in only through their branch's routers в Settings → Authentication: она включена для новых установок; при обновлении системы, если устройства уже переданы филиалам, она изначально выключена, чтобы никто не потерял доступ — включите её после назначения устройств. Пользователи General компании могут использовать любой маршрутизатор.

Получатели оповещений по филиалам

В меню филиала также есть Alert recipients: адреса e-mail, номера WhatsApp и SMS, а также чаты Telegram, по одному на строку. Если устройство этого филиала (или нижестоящего филиала) отключается, в его работе возникает сбой, оно блокирует атаку или теряет конфигурацию, этим получателям отправляется оповещение. Центральный офис по-прежнему получает все оповещения.

Прайс-листы

Financial → Price Lists (только для superadmin) позволяет установить цену для каждого тарифа и дополнения для каждого филиала. Дочерний филиал наследует цены родительского, если для него не заданы собственные, а для нового филиала устанавливается базовая цена тарифа. Можно изменить сразу несколько цен на определенный процент или фиксированную сумму с округлением; Reset All возвращает филиал к ценам родителя, а список можно экспортировать для проверки.

Роли & права доступа

Роль предоставляет доступ к определенным разделам. SAMM включает четыре готовые роли, которые можно редактировать или удалять — Manager (повседневные операции), Reseller, Accountant (финансы) и Monitor (только чтение), а также две заблокированные встроенные роли: superadmin (полный доступ) и Agent, которая превращает администратора в оптового реселлера с предоплаченным балансом и разделением комиссии (см. Accounting & billing → Agents).

Для каждой области SAMM (пользователи, тарифы, маршрутизаторы, биллинг, настройки и так далее) роли назначается один из трех уровней:

УровеньЗначение
ЗапрещеноЭтот раздел полностью скрыт из боковой панели
ПросмотрДоступ только для чтения
РедактироватьПолный доступ — создавать, изменять, удалять

Администраторы & ролей, Инструменты, API и Платежи остаются за HQ независимо от прав роли.

Два права расположены рядом с уровнями доступа, так как каждое из них представляет собой финансовое решение, а не настройку интерфейса:

СправаВозможности
Разрешить "No Invoice" Измените службу пользователя — продлите, смените тариф или увеличьте срок действия — без взимания платы. По умолчанию отключено для каждой новой роли.
Разрешить подтверждение агентов Рассмотрите и примите решение по запросам агентов на возврат платежа. Создание и управление агентами доступно только superadmin. См. Undo & approvals.

Расширенные права доступа

В разделе Edit пункты Users, Cards, Financial и Routers открывают список отдельных прав — например, удаление пользователей, продление, смена тарифа, оплата счетов, предоставление скидок, запуск скриптов маршрутизатора. Отключите любое из них для конкретной роли; кнопки функций, которыми роль не обладает, будут скрыты.

Время действия роли

Запретите сотрудникам предоставлять доступ к службе на несколько месяцев вперед. Для каждой роли:

НастройкаРезультат
Макс. периодов вперёдСрок действия может быть не более указанного количества периодов тарифа от текущего момента — при создании, продлении, добавлении дней, редактировании и массовых изменениях.
Макс. дней вперёдТо же самое, но в днях.
Начальное время для новых пользователей (часов)Пользователь, созданный с этой ролью, получает ровно столько времени (например, 2 часа) без выставления счета; пользователь с соответствующими правами может продлить этот срок позже.

Добавить дни и Ввести дату истечения — это разные права в разделе Users, поэтому роль может продлевать доступ, не имея возможности ввести любую произвольную дату. Оставьте поле пустым, чтобы убрать ограничение; superadmin не имеет ограничений. При массовом изменении пользователи, для которых будет превышен лимит, будут пропущены с указанием причины.

Роли также может быть разрешено видеть карточки всех пользователей & на install, независимо от дерева. Если эта опция отключена, роль видит свой филиал и находящиеся ниже филиалы.

Панель мониторинга доступна всегда Независимо от того, в каких еще правах отказано роли, каждый администратор сохраняет доступ к своей панели мониторинга и профилю — вход, приводящий к ошибке прав доступа, считается некорректным, а не безопасным.
Лицензия всегда доступна Страница System → License представляет собой обычный блок разрешений, но когда устройство находится в состоянии блокировки (grace, soft или hard), SAMM делает её доступной для любого авторизованного администратора независимо от роли, чтобы путь восстановления всегда оставался открытым.

Система

Инструменты

Раздел Tools объединяет утилиты для массовой обработки и обслуживания. Он работает со всем набором данных, поэтому доступен только суперадминистраторам.

Резервное копирование & Восстановление

Создайте полный снимок базы данных перед любыми серьезными изменениями. Резервная копия представляет собой gzipped-архив pg_dump, хранящийся на сервере; каждый такой архив имеет заголовок SAMM.

  • Создать резервную копию — при необходимости добавьте заметку; отметьте Skip usage & history для создания более компактного и быстрого дампа без громоздких таблиц логов.
  • Скачайте резервную копию на ваш ПК или загрузите предыдущую резервную копию SAMM обратно на сервер.
  • Restore перезаписывает текущую базу данных — действие подтверждается в диалоговом окне типа RESTORE.

Высокая доступность

Для развертывания без единой точки отказа запустите SAMM на двух узлах: потоковая репликация PostgreSQL (основной узел и резервный hot standby с задержкой в несколько секунд) плюс резервный узел AAA, с последующим повышением статуса и перенаправлением при отказе. Полное руководство оператора — настройка репликации, плановое и внеплановое переключение при отказе, обратное переключение, опциональный режим синхронной репликации и контрольный список проверки после переключения при отказе — прилагается к исходному коду в виде docs/HA.md. Обратите внимание, что репликация не является резервным копированием (ошибочное удаление реплицируется мгновенно), поэтому продолжайте выполнять вышеупомянутое регулярное резервное копирование.

Очистка истории

Безвозвратно удалите старые записи логов и истории, чтобы освободить место в базе данных. Выберите предустановленный период хранения и подтвердите действие. Инструмент очистки удаляет закрытые RADIUS-сессии, записи post-auth, ежедневные сводки использования, историю маршрутизаторов/интерфейсов, логи ограничений, примененные записи аудита и завершенные строки CoA. Он никогда не затрагивает активные сессии, команды в очереди, ожидающие CoA или общие показатели использования за все время, которые не подлежат сбросу.

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

Экспорт / Импорт

Массовый экспорт и импорт пользователей, тарифов и NAS в форматах .csv или .xlsx. Загрузите шаблон (необходимые столбцы и пример строки) или снимок текущих данных, заполните его и загрузите обратно. Каждая строка проходит проверку и отображается на экране предварительного просмотра — дубликаты и некорректные строки будут выявлены, и вы сможете выбрать, пропустить дубликаты или обновить их, прежде чем данные будут записаны.

Массовые изменения

Примените одно изменение — владельца, дату истечения, статус, автопродление или периоды всего тарифа — ко всем подписчикам, соответствующим фильтру, за один раз. Выберите изменение, настройте фильтр (статус / тариф / владелец / поиск), просмотрите список подходящих пользователей и подтвердите.

Добавить полные периоды тарифа — это опция массового продления: каждый абонент получает указанное количество периодов своего тарифа. Таким образом, тариф на 7 дней продлевается на 7 дней за период, а месячный тариф — на календарный месяц; всё это происходит за один запуск, без предварительного разделения списка по тарифам. Абоненты, у которых в тарифе не указан срок действия, просто пропускаются. Добавить дни используется в случаях, когда вам нужно добавить фиксированное количество дней без сброса счетчика.

Speed Boost

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

УправлениеПринцип работы
Процентное соотношениеПоложительные значения увеличивают, отрицательные — уменьшают скорость: +100% → скорость удваивается, −100% → скорость halved (в два раза меньше), −500% → в шесть раз меньше. Скорость никогда не достигает нуля.
Тарифы для ускоренияОтметьте любое количество тарифов; в каждой строке указана стоимость тарифа, действующий буст и текущая фактическая скорость.
Автоматический откат черезКоличество часов до автоматического завершения ускорения. 0 сохраняет его до тех пор, пока вы не сбросите его вручную.
Boost имеет приоритет над speed window Ускорение рассчитывается от скорости тарифа и заменяет любое окно скорости, пока оно активно — тариф с ночным окном 20M не становится 40M, а принимает значение, которое ускорение устанавливает для скорости этого тарифа. Windows возобновляются в момент прекращения действия ускорения.

Абонент, который исчерпал лимит, никогда не возвращается к полной скорости с помощью буста. По той же причине тариф, используемый в качестве цели ограничения, пропускается при выборе Select all и помечается соответствующим образом — его ускорение увеличит скорость именно тем пользователям, которых вы ограничиваете. Вы все равно можете отметить его вручную, если это необходимо. Reset everything to normal удаляет все бусты и возвращает активные сессии к скорости их тарифа.

Массовое удаление

Безвозвратно удалить сразу множество подписчиков или карт hotspot, выбранных с помощью фильтра. Удаление подписчика также удаляет историю использования, сессии, RADIUS accounting и счета, а также разрывает все активные сессии. Действие подтверждается диалоговым окном типа DELETE.

Система

Языки & темы

Языки

Порталы администратора и пользователя полностью локализуемы. В систему встроено восемь языков: English, Arabic (справа налево), Russian, Persian (справа налево), Turkish, French, Spanish и German. Каждый пользователь выбирает язык в верхней панели или в своем профиле; выбор сохраняется для каждой учетной записи.

Отключить язык

В System → Translations для каждого языка есть переключатель вкл/выкл (только для superadmin). Если язык выключен, никто не может его выбрать: он перестает отображаться в списках выбора, пользователи, выбравшие его ранее, видят интерфейс на английском, и сообщения им отправляются на английском. Английский язык всегда остается включенным. После чистой установки все языки включены по умолчанию.

Редактор перевода

Суперадминистратор может редактировать переводы в реальном времени в разделе System → Translations — без перезагрузки и правки файлов. Редактор также позволяет создавать новые языки и импортировать/экспортировать рабочие книги переводов в формате .xlsx, чтобы вы могли локализовать SAMM на любой необходимый вам язык.

Темы

SAMM включает 16 визуальных тем, светлых и темных. Каждый пользователь выбирает тему в верхней панели; предпросмотр обновляется мгновенно и настройки сохраняются для каждой учетной записи. IT-терминология не переводится, поэтому технические экраны остаются точными на любом языке.

Система

Журнал аудита активности &

System → Audit Log отвечает на один вопрос: что произошло и кто это сделал. В одном списке собраны все изменения, внесенные администратором, действия системы (например, истечение срока действия), а также изменения, которые пользователи внесли в свои аккаунты в портале или в Telegram: смена тарифа, продления, платежи, редактирование профиля и пароля.

СтолбецЧто отображается
КогдаВремя в вашем часовом поясе
КтоАдминистратор, «ali в портале», «ali в Telegram», API-токен или System
Что произошлоОдно предложение, только с измененными полями, старое → новое — например «Отредактирован пользователь: Срок действия: 01 Oct → 15 Oct»
ЦельОбъект изменений — Пользователь · ali, Тариф · Gold 20M, Маршрутизатор · Hamra, Администратор · rami

Фильтруйте по Who и Period или введите имя в поле поиска. Логины и экспорты скрыты, если не отмечен пункт Show logins & exports. Via, Action, Category, Severity и ID доступны в выборе колонок. Выберите строки, чтобы выполнить Export или Print — файл будет содержать те же колонки, что и на экране. Кнопка ⓘ в строке показывает полную таблицу до и после изменений.

Хронология действий пользователя

Откройте пользователя и выберите Timeline, чтобы увидеть все события, связанные с этим аккаунтом: создание, продление, смену тарифа, приостановку, достижение лимитов, а также счета, платежи, списания с кошелька и агента в колонке Amount. Фильтруйте данные по типу, периоду или только по денежным операциям, и экспортируйте их в CSV или Excel. Строки Timeline никогда не удаляются и сохраняются даже после удаления пользователя.

Журнал Accept и журнал доступа

Overview → Accept Log содержит список всех попыток входа, отправленных маршрутизаторами, и ответов RADIUS, начиная с самых новых, с указанием причины каждого отказа. Эту страницу следует открывать, если пользователь не может подключиться. Повторяющийся отказ отображается одной строкой с указанием количества. Overview → Access Log содержит список установленных сессий из данных RADIUS accounting.

Также очередь команд Сбросы, изменения тарифа и продления, поставленные в очередь через CLI или API, записываются в одну и ту же таблицу и применяются службой samm-radius при следующем такте, после чего активная сессия обновляется с помощью CoA. Значок на боковой панели отображает количество ожидающих операций.

Лицензирование

Уровни лицензирования &

Каждая установка SAMM лицензируется за каждое устройство — тариф привязан к конкретной установке, поэтому вы можете запустить несколько серверов SAMM, каждый из которых будет иметь свой тариф. Тариф устанавливает четыре числовых лимита.

УровеньПользователи AAAКарты HotspotNAS / маршрутизаторыМониторинг
Незарегистрирован252513
Бесплатно1005026
Lite5001,500412
Plus1,0003,000618
Pro2,0006,0001236
Mega5,00015,0002472
Max10,00030,000безлимитныйбезлимитный
Unlimitedбезлимитныйбезлимитныйбезлимитныйбезлимитный

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

Мониторы — это точки доступа и каналы связи, за которыми SAMM только наблюдает. Для них предусмотрен отдельный лимит — три на один NAS, поэтому мониторинг точки доступа не занимает слот маршрутизатора.

Активировать обновление &

  1. Перейдите в System → License.
  2. Активируйте устройство, войдя в свою учетную запись SecuryTik, или используйте Привязать это устройство: появится код, который нужно подтвердить на samm.securytik.com, чтобы не вводить пароль на самом сервере. Устройство активируется на плане Free.
  3. Чтобы повысить лимит, выберите тариф на этой же странице или оформите подписку в панели мониторинга. Запрос со страницы рассматривается и одобряется администратором SecuryTik.

На странице License также можно повторно проверить лицензию по запросу и просмотреть текущее использование относительно каждого лимита. Unlink device возвращает установку на незарегистрированный уровень без удаления каких-либо данных.

При истечении срока действия платной лицензии

SAMM никогда не удаляет данные. По истечении срока действия лицензии происходит плавный переход на ограниченный функционал:

ЭтапЧто происходит
ПредупреждениеБаннер-напоминание; все процессы продолжают работать
GraceКороткий интервал для повторной активации; абоненты остаются в сети
Мягкая блокировкаФоновые службы останавливаются; RADIUS продолжает выполнять аутентификацию в течение примерно 7 дней
Жесткая блокировкаСлужбы останавливаются, за исключением страницы повторной активации

Повторная активация на любом этапе автоматически перезапускает каждую службу — все данные и история подписчиков сохраняются.

Автоматические обновления

Автообновление не зависит от лицензии — обновления доступны для всех уровней, и истекшая лицензия никогда их не блокирует. SAMM ежедневно проверяет наличие нового подписанного релиза. В разделе System → License вы можете переключиться между режимами notify (по умолчанию — баннер с кнопкой Apply now) и auto (автоматическая установка). Каждое обновление проверяется, резервируется и применяется на месте. Вы также можете запустить установщик в любое время — он выполняет обновление идемпотентно.

Для ваших абонентов

Личный кабинет клиента & бот

SAMM предоставляет каждому абоненту два интерфейса самообслуживания — веб-портал и Telegram-бот, чтобы они могли проверять расход трафика и оплачивать услуги без обращения к вам.

Личный кабинет клиента

Подписчики входят в систему в корне площадки SAMM (/), используя свое имя пользователя и пароль SAMM. Портал содержит:

СтраницаЧто видит абонент
ОбзорСтатус аккаунта, тариф, дата истечения, расход трафика за сегодня и за текущий месяц, неоплаченные счета
Использование & сессийОбщий объем скачанных/переданных данных, бюджет аптайма и полная история сессий
Мои тарифыТекущий тариф и каталог доступных тарифов
Мои счетаИстория платежей с загрузкой PDF в один клик
Тикеты поддержкиОткрытие и отслеживание тикетов поддержки
ПрофильРедактировать контактные данные, изменить пароль, установить язык & тему, управлять уведомлениями

Во вкладке Profile пользователь подключает свой аккаунт Telegram, выбирает предпочитаемые каналы уведомлений или полностью отключает их. Если пользователь забудет пароль, ему будет отправлен OTP-код по электронной почте (для этого должна быть настроена вкладка Email).

Бот Telegram

Служба samm-telegram запускает интерактивного бота самообслуживания. Подписчик отправляет /start, один раз проходит аутентификацию с помощью имени пользователя и пароля SAMM (бот немедленно удаляет сообщение с паролем), после чего может выполнять все действия прямо из чата:

  • Проверьте их тариф, квоту, объем использования и дату истечения срока действия
  • Просмотр и загрузка счетов в формате PDF
  • Обновить профиль и изменить пароль
  • Открытие и отслеживание тикетов поддержки

Бот также отправляет автоматические уведомления — напоминания о продлении, уведомления об истечении срока действия, предупреждения о лимитах и квитанции — подписчикам, которые подключили Telegram.

Страница для абонентов с истекшим сроком действия

Когда срок действия подписки истекает, маршрутизатор (настроенный с помощью раздела «Expired pool & internet block» в мастере) перенаправляет браузер пользователя на информационную страницу «срок действия подписки истек», которую SAMM предоставляет на порту 81 — с логотипом вашего ISP и кнопкой входа в портал — вместо того чтобы просто обрывать соединение.

Система

REST API

System → API управляет публичным интерфейсом /api/v1. API остается неактивным до создания первого токена, поэтому в установках, где он не используется, никакие данные не открываются. Все описанное ниже также доступно в виде интерактивной документации OpenAPI — с консолью для тестирования и полными схемами запросов и ответов — в вашей установке по пути /api/v1/docs.

Интерактивная документация (Swagger UI)

Каждая установка предоставляет доступ к интерактивной консоли API по адресу /api/v1/docs — она доступна прямо с панели API в портале администратора. Нажмите Authorize, вставьте токен, и любую конечную точку можно будет протестировать на ваших данных с помощью Try it out; каждый вызов показывает реальный ответ и готовую для копирования команду curl.

Каждая конечная точка объявляет полную типизированную схему — как для тел запросов, так и для ответов, — поэтому имена полей, типы и примеры видны без выполнения каких-либо вызовов. Эта же схема предоставляется в машиночитаемом формате OpenAPI по адресу /api/v1/openapi.json, что позволяет сгенерировать полностью типизированный клиент на выбранном вами языке:

openapi-generator-cli generate \
  -i https://YOUR-SAMM/api/v1/openapi.json \
  -g python -o ./samm-client

samm-openapi.json · SAMM 6.0.0 · 187 конечные точки

Быстрый старт

  1. Откройте System → API (только для superadmin), нажмите New token, укажите имя, срок действия и включите только те разрешения, которые необходимы для интеграции (Read или Write, по одной строке на каждую область).
  2. Скопируйте секретный ключ сразу — он отображается только один раз, и на сервере хранится только его хеш.
  3. Проверьте работоспособность и узнайте, какие возможности предоставляет токен:
curl -H "Authorization: Bearer samm_YOUR_TOKEN" https://YOUR-SAMM/api/v1/me

Выведите список активных подписчиков, затем создайте нового:

curl -H "Authorization: Bearer samm_YOUR_TOKEN" \
  "https://YOUR-SAMM/api/v1/customers?status=active&limit=20"

curl -X POST -H "Authorization: Bearer samm_YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"username":"john","password":"secret1","firstname":"John",
       "lastname":"Doe","plan_id":3}' \
  https://YOUR-SAMM/api/v1/customers

Аутентификация, токены и области доступа

В каждом запросе передается Authorization: Bearer <token>. Токен содержит имя, минутный лимит запросов, срок действия (30–360 дней или бессрочно) и набор scope — прав на чтение/запись для каждого ресурса; scope write автоматически включает соответствующий read. Секрет отображается только один раз; сервер хранит только хеш. Токен можно отозвать (запросы перестанут выполняться немедленно, действие обратимо) или удалить полностью.

Ответы следуют единым соглашениям: конечные точки со списками принимают limit/offset и возвращают {"total", "items"}; ошибки используют стандартные коды состояния — 401 токен отсутствует, недействителен или истек, 403 отсутствует область доступа, 404 не найдено, 409 дубликат, 422 ошибка валидации и 429 при превышении лимита обращений (с заголовками Retry-After и X-RateLimit-*).

Суммы в данных о платежах, кошельках и webhook представлены в виде десятичной строки, например "12.50"; время указано в формате ISO 8601 со смещением часового пояса установки.

Ссылка на конечную точку

ОбластьКонечные точкиОбласть применения
Token & commands GET /commands · GET /me any token
Users GET /customers · POST /customers · POST /customers/bulk · GET /customers/{customer_id} · PATCH /customers/{customer_id} · DELETE /customers/{customer_id} · POST /customers/{customer_id}/activate · POST /customers/{customer_id}/assign-plan · PUT /customers/{customer_id}/custom-fields · GET /customers/{customer_id}/data-log · POST /customers/{customer_id}/disconnect · POST /customers/{customer_id}/renew · POST /customers/{customer_id}/reset-limit · POST /customers/{customer_id}/suspend · GET /customers/{customer_id}/timeline · GET /customers/{customer_id}/usage · GET /customers/{customer_id}/timeline/export.{fmt} coa:write customers:read customers:renew customers:write diagnostics:read
Plans GET /plans · POST /plans · GET /plans/{plan_id} · PATCH /plans/{plan_id} plans:read plans:write
Invoices GET /invoices · POST /invoices · GET /invoices/{invoice_id} · DELETE /invoices/{invoice_id} · POST /invoices/{invoice_id}/pay · GET /invoices/{invoice_id}/pdf · POST /invoices/{invoice_id}/unpay billing:read billing:write
Payments, discounts & wallet GET /cash-accounts · GET /customers/{customer_id}/wallet · GET /invoices/{invoice_id}/balance · POST /invoices/{invoice_id}/discounts · POST /invoices/{invoice_id}/payments · POST /customers/{customer_id}/wallet/pay-invoice · POST /customers/{customer_id}/wallet/topup · POST /customers/{customer_id}/wallet/withdraw · DELETE /invoices/{invoice_id}/discounts/{discount_id} billing:read billing:write
Payment apps (collect) GET /collect/lookup · POST /collect/payments · GET /collect/payments/{channel}/{reference} collect:read collect:write
Accounting export GET /accounting/export · GET /accounting/export/{kind} accounting:read
Add-ons & price lists GET /addons · GET /price-lists · DELETE /user-addons/{user_addon_id} · GET /customers/{customer_id}/addons · POST /customers/{customer_id}/addons addons:read addons:write
Hotspot cards GET /cards/groups · POST /cards/groups · GET /cards/{card_id} · GET /cards/groups/{group_id} · POST /cards/{card_id}/disable · POST /cards/{card_id}/enable · GET /cards/groups/{group_id}/cards · POST /cards/groups/{group_id}/cards · POST /cards/groups/{group_id}/disable · POST /cards/groups/{group_id}/enable · POST /cards/groups/{group_id}/extend · GET /cards/groups/{group_id}/print.pdf · POST /cards/{card_id}/reset/{kind} cards:read cards:write
Sessions & CoA GET /coa-outbox · GET /sessions · POST /coa-outbox/cancel · POST /coa-outbox/retry · POST /sessions/disconnect · POST /sessions/reconnect coa:write sessions:read
Webhooks GET /webhooks · POST /webhooks · GET /webhooks/events · PATCH /webhooks/{endpoint_id} · DELETE /webhooks/{endpoint_id} · GET /webhooks/{endpoint_id}/deliveries · POST /webhooks/{endpoint_id}/disable · POST /webhooks/{endpoint_id}/enable · POST /webhooks/{endpoint_id}/roll-secret · POST /webhooks/{endpoint_id}/test · POST /webhooks/deliveries/{delivery_id}/resend webhooks:manage
User files GET /customers/{customer_id}/files · POST /customers/{customer_id}/files · GET /customers/{customer_id}/files/{file_id} · DELETE /customers/{customer_id}/files/{file_id} customers:read customers:write
Branches GET /branches · PUT /customers/{customer_id}/branch admins:write customers:read
Admins GET /admins customers:read
Self Service (guests) GET /self-service/handouts · GET /self-service/summary guests:read
Statistics GET /stats/overview stats:read
Routers & router control GET /routers · POST /routers/jobs · GET /routers/playbooks · GET /routers/{router_id} · GET /routers/jobs/kinds · GET /routers/jobs/prefill · GET /routers/jobs/{job_id} · GET /routers/{router_id}/log · POST /routers/{router_id}/probe · GET /routers/{router_id}/probes · GET /routers/{router_id}/radius · GET /routers/{router_id}/ros · POST /routers/{router_id}/ros · POST /routers/{router_id}/scoop-change · GET /routers/{router_id}/scoop-changes · POST /routers/{router_id}/script · GET /routers/{router_id}/test · GET /routers/{router_id}/traffic · POST /routers/jobs/{job_id}/cancel · GET /routers/wireless/by-user/{customer_id} · GET /routers/{router_id}/ppp/{username} · GET /routers/{router_id}/scoop-change/preview · POST /routers/{router_id}/scoop-change/{change_id}/undo routers:diagnose routers:jobs routers:read routers:write
Network map & health GET /network/findings · GET /network/health · GET /network/topology · PUT /customers/{customer_id}/features · GET /network/ftth/olts · GET /network/ftth/onus · GET /network/wireless/aps · GET /network/wireless/stations · GET /routers/{router_id}/reach · POST /routers/{router_id}/reach · DELETE /routers/{router_id}/reach/{reach_id} customers:write routers:read
Bulk import POST /imports/users imports:write
Backups GET /backups · POST /backups · GET /backups/schedule · PUT /backups/schedule · DELETE /backups/{name} · GET /backups/{name}/download · POST /backups/{name}/restore backups:read backups:write
History cleaner POST /history/clean · GET /history/schedule · PUT /history/schedule · GET /history/space history:read history:write
VPN clients GET /vpn/l2tp/clients · POST /vpn/l2tp/clients · GET /vpn/sstp/clients · POST /vpn/sstp/clients · GET /vpn/wireguard/clients · POST /vpn/wireguard/clients · PUT /vpn/l2tp/clients/{cid} · DELETE /vpn/l2tp/clients/{cid} · PUT /vpn/sstp/clients/{cid} · DELETE /vpn/sstp/clients/{cid} · PUT /vpn/wireguard/clients/{peer_id} · DELETE /vpn/wireguard/clients/{peer_id} · GET /vpn/l2tp/clients/{cid}/config · GET /vpn/l2tp/clients/{cid}/mikrotik · POST /vpn/l2tp/clients/{cid}/toggle · GET /vpn/sstp/clients/{cid}/config · GET /vpn/sstp/clients/{cid}/mikrotik · POST /vpn/sstp/clients/{cid}/toggle · GET /vpn/wireguard/clients/{peer_id}/config · GET /vpn/wireguard/clients/{peer_id}/mikrotik · POST /vpn/wireguard/clients/{peer_id}/toggle vpn:read vpn:write
Diagnostics GET /diagnostics diagnostics:read
Support & logs GET /audit · GET /auth-log · GET /audit/actors · GET /support/alerts · GET /support/backups · GET /support/database · GET /support/errors · GET /support/license · GET /support/logs · GET /support/notifications · GET /support/payments · GET /support/probe · GET /support/queues · GET /support/self-test · POST /support/service-restart · GET /support/services · GET /support/settings · PUT /support/settings · GET /support/system · GET /support/update · GET /customers/{customer_id}/why-blocked · GET /support/errors/{incident} · GET /support/payments/incoming customers:read diagnostics:read errors:read logs:read services:write settings:write
Reports GET /reports/activations · GET /reports/financial · POST /retention/lookup · GET /customers/{customer_id}/statement accounting:read customers:read retention:lookup
Scoop GET /scoop/schedules · POST /scoop/schedules · DELETE /scoop/schedules/{schedule_id}

Счета, платежи, скидки и кошелек

Каждая денежная операция проходит через систему двойной записи SAMM, точно так же, как и в панели. Сумма задолженности по счету составляет total − paid − discount; его статус меняется с unpaid/due на partial и paid (или discounted, если счет был полностью погашен за счет скидок).

# what an invoice still owes
curl -H "Authorization: Bearer $T" https://YOUR-SAMM/api/v1/invoices/501/balance

# a 10 percent discount (or "kind":"fixed","value":"2.00")
curl -X POST -H "Authorization: Bearer $T" -H "Content-Type: application/json" \
  -d '{"kind":"percent","value":"10","reason":"Loyalty"}' \
  https://YOUR-SAMM/api/v1/invoices/501/discounts

# a partial payment into a cash account (GET /cash-accounts)
curl -X POST -H "Authorization: Bearer $T" -H "Content-Type: application/json" \
  -d '{"amount":"5.00","cash_account_id":1,"memo":"Counter"}' \
  https://YOUR-SAMM/api/v1/invoices/501/payments

# prepaid wallet: top up (pays open invoices oldest first), then read it
curl -X POST -H "Authorization: Bearer $T" -H "Content-Type: application/json" \
  -d '{"amount":"25.00","cash_account_id":1}' \
  https://YOUR-SAMM/api/v1/customers/42/wallet/topup
curl -H "Authorization: Bearer $T" https://YOUR-SAMM/api/v1/customers/42/wallet

POST /invoices/{id}/unpay повторно открывает оплаченный счет, а DELETE /invoices/{id} корректно закрывает его (остаток при частичной оплате списывается). Экспорт бухгалтерских книг в формате JSON или CSV выполняется через GET /accounting/export/{kind}.

Платежные приложения

Приложения для денежных переводов и агенты магазинов (Wish Money, Sham Cash…) получают собственные области доступа, collect:read и collect:write, и три вызова: поиск пользователя по имени пользователя (маскированное имя, сумма к оплате, открытые счета), регистрация платежа и его чтение. Платеж является идемпотентным по своему идентификатору (reference): повторная отправка того же платежа возвращает первый ответ и не создает новых записей.

curl -H "Authorization: Bearer $T" "https://YOUR-SAMM/api/v1/collect/lookup?username=ali"

curl -X POST -H "Authorization: Bearer $T" -H "Content-Type: application/json" \
  -d '{"username":"ali","amount":"20.00","reference":"WM-88213","channel":"wishmoney"}' \
  https://YOUR-SAMM/api/v1/collect/payments

Очередь команд

Изменения, затрагивающие текущее состояние биллинга — сброс лимитов, включение/выключение карт и групп, продление срока действия — не применяются мгновенно в рамках запроса. Они помещаются в очередь аудируемых команд и выполняются samm-radius в течение одного тика (несколько секунд), точно так же, как при нажатии соответствующих кнопок в панели администратора. Такие конечные точки возвращают {"queued": true}; опрашивайте GET /commands, чтобы увидеть, как статус команд вашего токена в очереди изменится на applied.

Webhooks

Зарегистрируйте URL конечной точки в System → API → Webhooks или с помощью POST /webhooks и выберите события: отдельные, целую группу, такую как invoice.* (включая последующие события этой группы) или * для всех событий. Секрет подписи отображается на странице конечной точки, его можно обновить.

Каждое уведомление передается в формате JSON и содержит id, type, api_version, created_at и data. id остается неизменным для каждой конечной точки и каждой повторной попытки: обрабатывайте каждый id один раз. Ответ 2xx должен поступить в течение 10 секунд; в любом другом случае будут выполнены повторные попытки с увеличивающейся задержкой в течение примерно двух часов, а конечная точка, которая продолжает выдавать ошибку, будет отключена автоматически. Каждая доставка регистрируется с HTTP-кодом, который вернул ваш сервер, и может быть отправлена повторно.

Перед тем как подтвердить получение доставки, проверьте X-SAMM-Signature-256: t=<unix>,v1=<hex> — HMAC-SHA256 от t.body:

import hmac, hashlib, time

def verify(raw: bytes, header: str, secret: bytes) -> bool:
    p = dict(x.split("=", 1) for x in header.split(","))
    if abs(time.time() - int(p["t"])) > 300:      # replay window
        return False
    mac = hmac.new(secret, p["t"].encode() + b"." + raw,
                   hashlib.sha256).hexdigest()
    return hmac.compare_digest(mac, p["v1"])
СобытиеКогда
customer.createdA user account was created
customer.updatedA user account was updated
customer.renewedA plan was renewed (expiration extended)
customer.plan_changedA user moved to another plan
customer.expiredA user expired (expiration sweep)
customer.suspendedA user was suspended (by an admin or for not paying)
customer.restoredA suspended user was restored
customer.deletedA user account was deleted
limit.exhaustedA usage limit was exhausted (quota / daily / uptime / expiration)
invoice.createdAn invoice was created
invoice.updatedWhat an invoice owes changed (payment, discount, reversal, write-off)
invoice.paidAn invoice was marked paid
invoice.deletedAn invoice was deleted
payment.receivedA payment was received and posted (online, payment app)
payment.reversedA payment was voided or an invoice reopened
wallet.topupMoney was added to a user's prepaid wallet
addon.addedAn add-on was given to or bought by a user
session.startedA user session started (off unless enabled in settings)
session.stoppedA user session stopped (off unless enabled in settings)
alert.openedAn alert opened (router down, service down, rogue DHCP server, new crash)
alert.resolvedAn alert cleared on its own or was resolved
webhook.testManual test event (sent from the test button)
Те же правила, что и для портала Мутации API проходят через ту же проверенную очередь команд и слой службы, что и портал администратора — сброс или смена тарифа через API работают точно так же, как и при нажатии в UI, включая CoA и всё остальное.
Ссылка на SAMM заблокирована Токены управления маршрутизатором не могут влиять на связь между SAMM и самим маршрутизатором — его учетные данные, службу API, настройки RADIUS, собственные правила безопасности SAMM или адрес, по которому SAMM обращается к нему. SAMM проверяет возможность входа в систему после каждого изменения, а каждое изменение или запуск скрипта фиксируются в Admin Log.

Справочник

Эксплуатация SAMM

Почти всё выполняется через портал администратора. Эта страница служит справочником по shell для тех редких случаев, когда он вам понадобится.

Управление службами

# Restart all SAMM services
systemctl restart samm-api samm-radius samm-worker samm-notification samm-telegram

# Live logs for one service
journalctl -u samm-api    -f
journalctl -u samm-radius -f

# Validate the FreeRADIUS config after any change
freeradius -CX

# Port 8000 stuck after a crash (admin portal unreachable)
kill -9 $(lsof -ti:8000); systemctl restart samm-api

CLI администратора

Для быстрого управления абонентами из shell. Каждая команда записывается в очередь лога аудита и применяется при следующем тике samm-radius — точно так же, как действия в UI.

CLI="sudo -u samm /opt/samm/venv/bin/python -m samm_radius.cli"

$CLI reset-quota      alice          # reset a limit counter
$CLI reset-daily      alice
$CLI reset-uptime     alice
$CLI reset-expiration alice
$CLI change-plan      alice home-50M # switch a subscriber's plan
$CLI encrypt-pw                       # encrypt a router API password for the DB

Конфигурационные файлы

ФайлОжидание
/etc/samm/samm.yamlDSN базы данных, размер пула соединений, уровень логирования
/etc/samm/api.envСекреты сессий портала и настройки SMTP для восстановления пароля
/etc/samm/secret.keyКлюч шифрования для сохраненных паролей API маршрутизатора

Эти файлы сохраняются при обновлениях и никогда не перезаписываются при повторном запуске установщика. Параметры среды выполнения (интервалы циклов, время ежедневного сброса, порты CoA) находятся в разделе Settings и применяются без перезагрузки.

Обновление SAMM

Либо обновите SAMM через System → License, либо запустите установщик повторно — см. Installation → Upgrading. Оба пути повторно применяют миграции и перезапускают службы; ваши конфигурация и данные останутся нетронутыми.

Резервное копирование и восстановление &

Используйте Tools → Backup & Restore для создания полного снимка базы данных перед любыми серьезными изменениями. Чтобы развернуть систему на новом хосте, установите SAMM, а затем восстановите резервную копию.

Инструменты обслуживания (внешние)

Некоторые задачи по обслуживанию настолько опасны, что их нельзя размещать в панели администратора, где случайный клик может парализовать работу бизнеса. SAMM предоставляет их в виде отдельных скриптов только для root, которые вы загружаете и запускаете осознанно из shell — никогда не в виде кнопки. Они находятся в публичном репозитории дистрибутива по пути tools/.

Сброс пароля администратора при блокировке доступа

Потеряли доступ к панели администратора? Установите новый пароль для аккаунта superadmin напрямую в базе данных — действующий логин не потребуется. Это также повторно активирует аккаунт, если он был отключен, и не затрагивает остальные настройки.

curl -fsSL -o samm-reset-admin-password.sh \
  https://raw.githubusercontent.com/mhdhaidarah/samm/main/tools/samm-reset-admin-password.sh

sudo bash samm-reset-admin-password.sh --list   # list the superadmin accounts
sudo bash samm-reset-admin-password.sh          # reset (prompts for the new password, twice)

Запустите эту команду от имени root на сервере SAMM. Если суперадминистраторов несколько, используйте --user <name>, чтобы выбрать одного из них.

Сбросить записи (очистить финансовые данные)

Очищает все финансовые транзакции, чтобы ISP мог начать учет с нуля, при этом все данные абонентов и AAA остаются полностью нетронутыми. Полезно при приеме установки в эксплуатацию или после пробного/тестового периода, когда в учете накопились данные, которые оператор хочет удалить, но клиентская база должна остаться без изменений.

Опасно — безвозвратная потеря данных Это безвозвратно удалит все счета, платежи, квитанции, балансы кошельков и историю реестра. Отменить действие невозможно. Единственный способ восстановления — резервная копия базы данных. Никогда не запускайте эту операцию в рабочей установке, если вы предварительно не создали и не проверили резервную копию.

Удалено: счета и их позиции, книга двойной записи (платежи, поступления, корректировки, пополнения и списания с кошелька), транзакции онлайн-платежей, расходы, основные средства и журнал бухгалтерских операций. Нумерация счетов сбрасывается, поэтому следующий счет будет под номером #1.

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

Загрузите, прочитайте, а затем запустите. Всегда сначала выполняйте пробный запуск:

curl -fsSL -o samm-wipe-financials.sh \
  https://raw.githubusercontent.com/mhdhaidarah/samm/main/tools/samm-wipe-financials.sh

sudo bash samm-wipe-financials.sh --dry-run   # show what would be deleted, change nothing
sudo bash samm-wipe-financials.sh             # do it
Не передавайте вывод напрямую в shell Никогда не запускайте это через curl … | sudo bash. Скрипт, который удаляет данные, необходимо сначала изучить, так как при прерванной загрузке выполнение части команды по очистке недопустимо. Сначала выполните загрузку, проверьте содержимое и только затем запускайте.

Скрипт отказывается запускаться от имени пользователя, не являющегося root, выводит точный список объектов, которые будут удалены, а затем просит вас ввести YES, чтобы подтвердить наличие проверенной резервной копии, и WIPE для продолжения. Скрипт предлагает сначала создать дамп собственной базы данных (в /var/backups/samm/) и прерывает работу, если этот дамп не удался. Очистка выполняется как единая транзакция по принципу «все или ничего», при этом RADIUS намеренно остается запущенным, чтобы абоненты оставались в сети, пока данные устраняются.

Справочник

FAQ & устранение неполадок

Какие операционные системы поддерживает SAMM?

Ubuntu 22.04 / 24.04 / 26.04 LTS и Debian 12 / 13. Только серверные версии Linux — десктопные варианты не поддерживаются. Установщику требуются systemd, чистая установка PostgreSQL (будет настроена автоматически) и root-доступ.

Нужно ли подключение к интернету для работы SAMM?

Нет. SAMM работает полностью на вашем собственном сервере и аутентифицирует абонентов локально через RADIUS. Единственным исходящим трафиком является периодический запрос проверки лицензии на сервер лицензий SecuryTik, чтобы ваш тариф оставался активным.

Могу ли я запустить SAMM в облаке или он должен быть установлен локально (on-prem)?

Подходит любой вариант. Большинство операторов развертывают систему локально рядом со своими основными маршрутизаторами; некоторые используют небольшую облачную VM с обратным туннелем Cloudflare Zero Trust. Единственное требование заключается в том, чтобы маршрутизаторы MikroTik имели доступ к серверу SAMM по портам RADIUS (1812/1813 UDP), а SAMM имел доступ к маршрутизаторам через MikroTik API.

Нужно ли перезапускать FreeRADIUS при добавлении или удалении маршрутизатора?

Нет. SAMM динамически определяет NAS-клиентов из базы данных, поэтому добавление, изменение или удаление маршрутизатора в MikroTik → NAS вступает в силу без перезагрузки.

Как быстро вступают в силу изменения тарифа или сброс счетчика?

Действия администратора ставятся в очередь и применяются службой samm-radius при следующем такте — по умолчанию в течение 30 секунд. Если абонент находится в сети, SAMM также отправляет CoA в реальном времени для обновления сессии. Для более оперативного применения настроек уменьшите интервал samm-radius в System → Settings.

Что произойдет с моими данными, если срок действия платной лицензии истечет?

Ничего не удаляется. По истечении срока действия лицензии система последовательно переходит в режимы предупреждения, льготного периода, мягкой блокировки (RADIUS продолжает аутентификацию примерно неделю) и, наконец, полной блокировки. Реактивация на любом этапе перезапускает каждую службу с полным сохранением всех данных.

Бесплатен ли SAMM? Какие возможности добавляет версия Pro?

Тариф Free бесплатен навсегда и включает все функции. Платные тарифы не открывают доступ к новым функциям — они увеличивают лимиты на AAA пользователей и hotspot-карты, а также снимают ограничение на количество маршрутизаторов. См. Licensing & tiers.

Абонент не может пройти аутентификацию — с чего начать?

Убедитесь, что общий секрет (shared secret) RADIUS маршрутизатора точно совпадает с записью NAS, что на маршрутизаторе включен PPP / Hotspot RADIUS, а учетная запись абонента активна и срок ее действия не истек. Следите за выводом journalctl -u samm-api -f и логом FreeRADIUS, а также убедитесь, что маршрутизатор имеет доступ к хосту SAMM по UDP 1812/1813.

Нужна дополнительная помощь?

Напишите на samm@securytik.com, чтобы сообщить об ошибке или предложить новую функцию.