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

Начало работы

Установка

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

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

• A Одна команда (Linux) Самый быстрый путь — вставьте одну строку на чистом сервере Ubuntu / Debian. Рекомендуется для продакшена.
• B Ручная установка Скачайте tarball релиза сами и запустите установщик — для офлайн/изолированных серверов.
• C Docker Compose Тот же SAMM в виде мультиарх-контейнеров — любой Docker-хост, Windows Docker Desktop, Mac на Apple Silicon.
• D Контейнер MikroTik Весь стек прямо на маршрутизаторе с RouterOS 7.23+. Внешняя Linux-машина не нужна.
• E ISO-образ сервера Загрузите пустую машину с ISO-образа — он сам установит ОС и свежайший SAMM. Навыки Linux не нужны.
• i Справочник установщика Переменные окружения, фазы установки, интерактивные вопросы и обновление.

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

• Чистый сервер: 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

Этот загрузочный скрипт скачивает последний релизный пакет SAMM с GitHub, распаковывает его и автоматически запускает полный установщик. Готово за несколько минут.

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

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

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

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

Установка

Вариант B — установка вручную из релизного пакета

Скачайте последний 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.

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

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

Установка

Вариант C — установка с помощью 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.

Мультиарх — один и тот же тег публикуется для linux/amd64 и linux/arm64, и нужный вариант выбирается автоматически из тега: docker pull на любом Docker-хосте (Intel/AMD, ARM-сервер, Mac с Apple Silicon) и 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 или B выше, если вам нужны эти функции встроенными, или запустите cloudflared / wg-quick на хосте Docker непосредственно рядом с SAMM. Полный список ограничений v1 и способ установки вручную см. в README варианта Docker.

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

Установите 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 → Контейнеры — группа samm расширяется до 8 служб. Как только они станут зелеными, откройте портал администрирования и войдите в систему, используя следующие учетные данные:

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

Если реальный NAS MikroTik будет обращаться к этому хосту 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 — сначала сделайте их резервную копию, если вы добавили данные).

Установка

Вариант D — установка на роутер MikroTik (RouterOS 7.23+)

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

1. Подготовьте роутер

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

/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 ГБ — Postgres + слои образа занимают место). На роутере:

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

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

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

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

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

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
    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: 30s
    ports:
      - "8000:8000"
    volumes:
      - etcsamm:/etc/samm
      - sammvar:/opt/samm/var
      - sammlogs:/var/log/samm
      - sammlocales:/opt/samm/app/locales

  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

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

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

Немедленно смените пароль администратора. Аутентификация и учёт RADIUS доступны на UDP 1812 + 1813 на самом роутере, поэтому RADIUS-клиент MikroTik может указывать на 127.0.0.1 с общим секретом, заданным в System → RADIUS.

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

Чтобы переместить установку контейнера MikroTik в новую версию:

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

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

Установка

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

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

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

Скачать SAMM Server ISO 2.2 GB

SHA-2568b6d57e286a4c0524d96b5b4970b57079113e000fc8229f94360410c12f5102e

Установка

Справочник установщика

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

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

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 строк.

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

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

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

• Токен Cloudflare — вставьте токен коннектора 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, выбранный при первой установке, сохраняются.

Начало работы

Первые шаги

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

1 · Первый вход

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

2 · Добавьте свой первый роутер

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

Перезапуск FreeRADIUS не нужен — SAMM определяет NAS-клиентов динамически из базы данных. Полную процедуру см. в разделе Роутеры (NAS), или позвольте мастеру настройки настроить MikroTik за вас.

3 · Создайте план

План определяет скорость, лимиты и цену, которую вы продаёте. Перейдите в Users → Plans → New plan. Полный справочник по полям: Планы и лимиты.

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

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

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

Свежая установка работает незарегистрированной на минимальном тарифе. Откройте System → License и активируйте, чтобы снять ограничения — см. Лицензирование и тарифы.

Начало работы

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

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

Откройте Инструменты → Экспорт / Импорт и выберите свою прежнюю систему в разделе Миграция с другой системы. Как и остальные Инструменты, функция доступна только суперадминистраторам.

Что загружать

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

Как это работает

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

Что переносится

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

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

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

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

Pro Radius подробности

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

• Срок — установлен в 1 месяц. Настоящая дата окончания каждого абонента импортируется без изменений, так что это влияет только на будущие продления.
• Скорость отдачи — приравнена к скорости приёма.
• Цена — установлена в 0.

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

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

Абоненты & тарифы

Тарифы & ограничения

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

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

Создать план

1. Перейдите в Users → Plans.
2. Нажмите New plan.
3. Заполните форму и нажмите Save plan.

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

Поля плана

Четыре лимита

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

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

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

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

Два понятия потребления

SAMM хранит потребление в двух местах и никогда их не смешивает:

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

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

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

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

Абоненты & тарифы

Абоненты

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

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

1. Перейдите в Users и нажмите New customer.
2. Заполните форму и сохраните — абонент может подключиться сразу.

Создайте много подписчиков одновременно

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

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

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

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

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

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

Страница деталей также показывает пароль абонента за кнопкой-глазом (с копированием в один клик) — удобно, когда клиент спрашивает свои данные.

Представление Usage

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

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

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

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

Абонента (или целую группу карт) можно прикрепить к определенному NAS. маршрутизаторы из формы редактирования. Если маршрутизаторы не выбраны, учетная запись работает на любом НАН; если выбран один или несколько, аутентификация принимается только от тех маршрутизаторы — принудительное закрытие при сбое внутри самого RADIUS. Изменение набора отключает любые немедленно запустить живую сессию на теперь запрещенном маршрутизаторе. В сочетании с администратором By-NAS масштабирование: именно так многофилиальные и франчайзинговые установки удерживают абонентов каждого филиала. на маршрутизаторах этого филиала.

Абоненты & тарифы

Карты Hotspot

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

Создать группу карт

1. Перейдите в Users → Hotspot Cards и нажмите New group.
2. Заполните форму ниже и нажмите Create group — SAMM генерирует учётные данные каждой карты автоматически.

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

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

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

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

Статусы карт

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

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

Абоненты & тарифы

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

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

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

Включение его

1. Сначала настройте канал доставки. Центр уведомлений → включите SMS или WhatsApp и отправьте себе тестовое сообщение. Ничто другое не работает, пока не работает один канал.
2. Самообслуживание → Настройки : отметьте галочкой. Разрешить гостям регистрироваться , выбрать каналы для предложить и установить, как долго будет действовать пароль и как долго гость должен ждать прежде чем просить другого.
3. Оставьте паролей от в системе самообслуживания. группа карт, если у вас нет причины ее менять — эта группа определяет скорость и сколько устройств могут использовать один пароль.
4. Включите вкладку "Регистрация" для каждого используемого вами варианта входа в систему — см. ниже. Это шаг, который люди упускают.

Страница входа — шаг, который люди пропускают

Вкладка «Регистрация» отображается в соответствии с дизайном входа и отключена. по умолчанию. Откройте Диспетчер MikroTik → маршрутизатор → Страница входа , отредактируйте используемый вами дизайн и установите флажок Разрешить самообслуживание . Вы можете перефразировать каждое предложение, которое гость видит на одном и том же экране — метка вкладки «Регистрация», вступление строку, две метки полей, кнопку и пять ответов («ваш пароль указан свой вариант», «один у вас уже есть», «пожалуйста, повторите попытку позже», «не удалось его отправить», «Регистрация недоступна»).

Затем нажмите «Нажать» — и нажимайте ее еще раз после каждого обновления SAMM . Страницы входа в Hotspot хранятся на собственной флэш-памяти маршрутизатора , не на SAMM . Обновление SAMM не приводит к их повторной отправке, поэтому маршрутизатор продолжает обслуживать свои старые страница — без вкладки «Регистрация» — пока вы не нажмете еще раз. SAMM предупреждает вас при входе в систему Вкладка «Страницы», когда маршрутизатор обслуживает страницы старше установленной версии, и На странице самообслуживания указаны все маршрутизаторы, на которых не отображается вкладка, и предлагается их исправить. все сразу.

Правила, которые останавливают злоупотребления

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

Лицензия

Самообслуживание имеет лицензию отдельно от вашего плана , на количество паролей в день при установке\n может выйти, и он продлевается в свой собственный день — так что вы можете пользоваться бесплатной версией с платным дополнением,\n или на Pro Max без него. За каждую установку вы получаете 10 в день бесплатно ;\n Лайт повышает его до 50, Тяжелый до 200, а Макс снимает лимит. См. цены .

На странице самообслуживания показаны использованные/разрешенные на сегодня и говорит прямо, когда пособие закончилось. Купите или продлите срок действия с помощью панели управления на securytik.com или спросите в Система → Лицензия и Администратор SecuryTik одобряет это. Код доступа, который не удалось доставить, не используется. ваше пособие.

Сеть & роутеры

Роутеры (NAS)

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

Добавить роутер

1. Перейдите в MikroTik → NAS и нажмите Add Router.
2. Заполните поля ниже и сохраните.

Список NAS

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

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

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

Нажмите Discover neighbors, чтобы просканировать сеть на устройства MikroTik (по протоколу обнаружения соседей MikroTik) и добавить их как записи NAS, не вводя адреса вручную. Найденный маршрутизатор можно добавить по IP или автодобавить — бутстрап в один клик: создаёт на маршрутизаторе пользователя управления SAMM, задаёт IP управления и убирает заводской мост.

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

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

После завершения отправки диалог показывает журнал результатов.

Настройте сторону MikroTik

Если вместо этого вы настраиваете роутер вручную:

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

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

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

Сеть & роутеры

Менеджер MikroTik

Когда у роутера есть учётные данные API, SAMM управляет им напрямую через API MikroTik — без 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.

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

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

Мониторинг

Менеджер

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

Настройка сети

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

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

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

Страница входа Hotspot

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

QoS с учётом приложений

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

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

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

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

1. Приветствие и определение — SAMM опрашивает маршрутизатор и показывает, что уже настроено, чтобы вы могли пропустить эти пункты при отправке.
2. Интерфейс bridge — задайте имя LAN bridge.
3. Порты bridge — выберите, какие физические интерфейсы войдут в bridge.
4. DNS — задайте вышестоящие резолверы (пресеты в один клик для Google, Cloudflare, Quad9 и других), размер кэша и, при желании, DNS-фильтр контента.
5. NTP — источник времени маршрутизатора (клиент NTP, опционально раздача времени в LAN).
6. Интернет — добавьте одно или несколько WAN-подключений (Static / DHCP / PPPoE).
7. RADIUS в SAMM — направьте маршрутизатор на ваш хост SAMM для аутентификации, учёта и CoA.
8. Службы — выберите, будет ли мастер создавать сервер PPPoE, Сервер точки доступа или служба IPoE/DHCP и при необходимости включите Двойной стек IPv6 (включено, по умолчанию отключено): выберите делегированный (DHCPv6-PD) длину префикса и блоки IPv6, а мастер создает пулы и присоединяет их к Профиль ГЧП.
9. Детали PPPoE / Hotspot и брандмауэр — пулы, профили, время аренды, правила брандмауэра и NAT, плюс опциональный пул Expired и блокировка интернета, перенаправляющий истёкших абонентов на страницу SAMM «подписка истекла» вместо мёртвого соединения.
10. Проверка и отправка — просмотрите точный список команд, которые будут отправлены, затем отправьте их все на маршрутизатор.

Сеть & роутеры

CoA & изменения на лету

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

Как изменение доходит до активного абонента

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

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

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

Гибридный CoA

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

Страница исходящей очереди CoA

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

Шесть счётчиков возглавляют страницу — В ожидании, Отправлено, NACK (повтор), Готово, Ошибка и Всего. Фильтруйте таблицу по статусу, по действию (update или disconnect) или ищите по имени пользователя, IP NAS или причине.

Каждая строка показывает пользователя, маршрутизатор, действие, число попыток, причину, а также время создания и отправки. Действия по строке позволяют Повторить ошибочный или nack-пакет, Отменить ещё выполняющийся или открыть Атрибуты, чтобы изучить точные атрибуты RADIUS, которые несёт пакет. Значок в боковой панели считает строки в ожидании; Панель управления отслеживает ошибки за 24 часа. Исправная система держит эту очередь почти пустой.

Жнец устаревшей сессии

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

Повседневные операции

Панель управления и активные сессии

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

Панель управления

Обзор → Панель управления — это главный экран оператора. Селектор периода вверху — Сегодня, 7д, 14д, 30д, 90д — задаёт окно для графика трендов и показателей, ограниченных датами.

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

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

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

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

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

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

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

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

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

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

Обзор → Активные сессии перечисляет каждого абонента, которого маршрутизаторы сейчас сообщают как находящегося в сети по учёту RADIUS. Страница автоматически обновляется каждые 30 секунд; кнопка ручного Обновления находится в заголовке.

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

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

Что показывает каждая строка

Отключение сессии

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

Повседневные операции

Отчёты и аналитика

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

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

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

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

Линейный график с тремя рядами за выбранный диапазон: Активные абоненты, сессии В сети и Истёкшие абоненты. Используйте его, чтобы замечать рост, отток и часы пиковой нагрузки вашей сети.

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

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

Списки Топ-10

Четыре таблицы выводят учётные записи с наибольшим трафиком, каждая ранжирована по объёму в ГБ:

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

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

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

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

Повседневные операции

Учёт & выставление счетов

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

Страница Бухгалтерия разбита на одиннадцать вкладок.

Обзор

Финансовый снимок. Четыре ключевых показателя расположены вверху:

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

Счета

Счёт — это документ на оплату, который вы выставляете. Нажмите Новый счёт и заполните:

Сколько взимать плату — полную, сегментированную или ничего

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

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

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

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

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

Расходы

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

Поступления и платежи

Эти две вкладки записывают фактическое движение денег — в отличие от счёта или расхода, который его вызвал.

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

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

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

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

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

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

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

Когда один из абонентов агента продлевается, SAMM списывает с баланса агента оптовую цену, проводит вашу выручку и выставляет реальный розничный счёт конечному клиенту, оплачиваемый агенту и остающийся вне вашей книги. Взыскание на стороне агента — со своим переключателем в Настройки → Биллинг, включённым по умолчанию, с настраиваемым льготным периодом — автоматически приостанавливает неплатящего клиента (отправляя разрыв CoA); когда агент фиксирует оплату клиента, абонент реактивируется мгновенно.

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

Активы и кассовые счета

• Активы — регистрируйте основные средства (маршрутизаторы, транспорт, оборудование). SAMM отслеживает их стоимость и амортизацию во времени.
• Касса — управляйте вашими кассовыми и банковскими счетами и вашими счетами капитала: собственный капитал, где взнос — это деньги, которые владелец вкладывает в бизнес, а изъятие — это деньги, взятые из него. Капитал не является выручкой и никогда не появляется в Отчёте о прибылях и убытках.

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

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

Экспорт в бухгалтерскую программу

В разделе Бухгалтерия → Отчёты → Экспорт скачайте книги в CSV для QuickBooks, Xero или любой таблицы: Общий журнал, План счетов, Счета, Оборотная ведомость, Прибыли и убытки и Баланс. Общий журнал, Счета и P&L используют диапазон дат; остальное — на сегодняшний день. Те же данные доступны через API по адресу GET /api/v1/accounting/export/{kind} (format=json|csv, право accounting:read) для BI-конвейеров и Zapier. Экспорт исключает аннулированные записи, поэтому выгрузка всегда сходится с отчётами на экране.

Повседневные операции

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

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

Окно отмены

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

Отмена отменяется (с указанием причины на экране), когда реверсирование уничтожает то, что оно не создавало:

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

Ворота утверждения агента

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

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

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

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

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

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

Агент получает страницу Моя учетная запись → Ожидающие утверждения . перечисляя все, что они просили: что еще ждет, и что было одобрено или отклонено — с указанием причины рецензента. Без этого отказ был бы неотличим. из запроса, который исчез, и они просто спросили бы снова.

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

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

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

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

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

1. Откройте Финансовые → Онлайн-платежи (только суперадминистратор).
2. Нажмите шлюз, чтобы развернуть его — Stripe , PayPal или Binance / USDT .
3. Заполните поля, установите флажок Включить этот шлюз и нажмите Сохранить . SAMM не позволит вам сохранить данные, пока не будут заполнены обязательные поля.
4. Нажмите Выполнить тест , чтобы убедиться, что ваши учетные данные работают.
5. Готово: ваши подписчики теперь видят кнопку Оплатить в своих неоплаченных счетах на портале (и на странице «Срок действия подписки истек»).

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

Stripe – банковские карты по всему миру.

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

PayPal – карты и усилители; PayPal баланс

1. Создайте учетную запись PayPal Business , затем на сайте Developer.paypal.com создайте приложение REST и скопируйте его идентификатор клиента и секрет .
2. В SAMM разверните PayPal , вставьте Идентификатор клиента и Секрет клиента , выберите Песочница (тестирование) или Live , затем Сохранить и Запустить тест .
3. Рекомендуется: добавьте веб-перехватчик на сайте Developer.paypal.com → ваше приложение → Веб-перехватчики , URL-адрес https://YOUR-SAMM/pay/webhook/paypal , подпишитесь на CHECKOUT.ORDER.APPROVED и PAYMENT.CAPTURE.COMPLETED , затем вставьте идентификатор веб-перехватчика в SAMM , чтобы входящие уведомления были криптографически проверены.

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

Это лучший вариант, когда карты и PayPal недоступны. Ваши подписчики отправляют USDT ; SAMM отслеживает вашу учетную запись Binance и автоматически отмечает счет-фактуру оплаченным. Вам нужны три вещи: Ключ API , Секрет API и место для получить — адрес кошелька и/или Binance Pay ID .

Шаг 1. Создайте ключ API только для чтения.

1. Войдите в Binance → откройте учетную запись → Управление API (или выполните поиск «Управление API»).
2. Нажмите Создать API → выберите Создано системой → назовите его, например. " SAMM " → завершить проверку безопасности.
3. Binance показывает Ключ API и Секретный ключ — скопируйте оба сейчас (Секрет отображается только один раз).
4. Нажмите Изменить ограничения и оставьте флажок только у параметра "Включить чтение" . Оставьте спотовую торговлю и вывод средств ВЫКЛ. (Необязательно: ограничьте ключ IP-адресом вашего сервера.)
5. Вставьте Ключ API и Секрет API в карточку Binance пользователя SAMM (сначала Ключ, затем Секрет — в том же порядке, в котором они показаны Binance ).

Шаг 2 — получите адрес получающего кошелька

1. В Binance перейдите в раздел Кошелек → Спот → Депозит (Крипто-депозит).
2. Выберите монету USDT .
3. Выберите сеть — TRC20 – самая дешевая и распространенная; BEP20 и ERC20 также работают. Используйте тот же, который вы выбрали в SAMM .
4. Скопируйте адрес депозита и вставьте его в поле SAMM Адрес кошелька для получения средств в цепочке . Убедитесь, что раскрывающийся список Сеть пользователя SAMM соответствует выбранной вами сети.

Шаг 3 — (необязательно) Binance Идентификатор платежа

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

Наконец, установите флажок Включить , нажмите Сохранить , затем Запустить тест . (он проверяет, что ключ может читать вашу учетную запись). Вы живы.

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

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

Повседневные операции

Заявки в поддержку

В SAMM встроена служба поддержки. Абоненты создают заявки из клиентского портала или Telegram-бота, администратор может открыть заявку от имени абонента, а ваша команда работает со всеми ими из Пользователи → Заявки в поддержку.

Очередь заявок

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

• Чипы статуса — по одному на статус заявки, каждый несёт живой счётчик, так что нагрузка видна с первого взгляда.
• Приоритет — Обычный, Умеренный или Критический.
• Активные / Отозванные — клиент может отозвать заявку, которая ему больше не нужна; отозванные заявки затемнены и скрыты по умолчанию.
• Поиск — по номеру заявки, теме или клиенту.

Значок в боковой панели считает открытые заявки, чтобы ничего не было упущено.

Открытие заявки

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

Работа с заявкой

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

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

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

Повседневные операции

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

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

Обзор

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

Каналы

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

Сообщения

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

Правила и таймеры

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

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

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

Рассылка

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

Исходящие

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

Система

WireGuard VPN

SAMM может запускать сервер WireGuard VPN на хосте SAMM — обычно для удалённого административного доступа к машине SAMM и управляющего доступа к MikroTik за ней. Он управляется полностью из Система → VPN; shell не нужен.

Вкладка сервера

1. Нажмите Сгенерировать ключи, чтобы создать пару ключей сервера. Открытый ключ сервера появляется после генерации — он нужен клиентам.
2. Задайте Порт прослушивания (UDP, по умолчанию 51820), Адрес туннеля сервера (CIDR на интерфейсе wg0, по умолчанию 10.254.254.1/24) и Диапазон IP клиентов — начальный и конечный адреса, которые SAMM автоматически выдаёт новым пирам.
3. Включите Включить WireGuard VPN и нажмите Сохранить — SAMM поднимает интерфейс wg0. Переключатель заблокирован, пока не появятся ключи сервера.

Вкладка клиентов

Нажмите Добавить клиента, дайте пиру имя, и SAMM назначит ему следующий адрес из диапазона клиентов. Для каждого пира вы можете скачать его файл конфигурации, отсканировать QR-код с помощью мобильного приложения WireGuard или скопировать готовые команды MikroTik RouterOS, чтобы вывести маршрутизатор на VPN. Пиры можно включать/выключать или удалять; цвета статуса показывают, подключён ли каждый, устарел или никогда не был виден.

Система

Cloudflare Tunnel

Туннель Cloudflare Zero Trust публикует SAMM в публичный интернет без открытия каких-либо портов firewall — полезно, когда хост SAMM находится за NAT. Он управляется из Система → Cloudflare Tunnel.

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

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

Она также показывает версию cloudflared и настроен ли коннектор на автозапуск при загрузке.

Настройте туннель

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

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

Система

Настройки

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

Общие параметры

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

Данные провайдера, логотип, валюта и биллинг (вкладка ISP)

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

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

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

Вкладка Email

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

Система

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

Система → Администраторы управляет тем, кто может входить в административный портал и что каждый может делать. Она имеет две вкладки: Администраторы и Роли.

Учётные записи администраторов

Создайте администратора с именем, паролем, необязательной почтой и ролью. Через меню ⋮ можно изменить роль или пароль, отключить учётную запись или удалить её. Управлять администраторами может только суперадмин — и три раздела (Админы, Инструменты и API) доступны только суперадмину: их нельзя выдать пользовательской роли, в матрице они показаны запертыми.

Роли и разрешения

Роль предоставляет доступ по областям. Встроенная роль суперадминистратора всегда имеет полный доступ и не может быть изменена. Создавайте пользовательские роли для ограниченного доступа — новая роль начинается без доступа, пока вы не зададите её разрешения.

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

Для каждого раздела SAMM (абоненты, тарифы, NAS, бухгалтерия, настройки и т. д.) роли задаётся один из трёх уровней:

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

Область видимости данных

У каждой роли также есть область действия. Просмотреть всех клиентов и карты означают\n роль видит каждую запись. Если этот флажок снят, роль ограничена NAS : a\n суперадминистратор назначает каждому администратору определенные маршрутизаторы («Доступ к NAS» в меню администратора ⋮),\n и этот админ видит только абонентов и группы карт, привязанных к этим роутерам —\n идеально подходит для филиалов, франшиз или торговых посредников. Подписчики, которых создает администратор By-NAS:\n автоматически прикрепляются к их маршрутизаторам.

Система

Инструменты

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

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

Создайте полный снимок базы данных перед любым крупным изменением. Резервная копия — это сжатый gzip архив pg_dump, хранящийся на сервере, каждый с заголовком SAMM.

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

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

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

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

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

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

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

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

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

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

Увеличение скорости

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

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

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

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

Система

Языки и темы

Языки

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

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

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

Темы

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

Система

Журнал аудита

Система → Журнал аудита — это запись действий администратора — и очередь команд, которая их выполняет. Когда вы сбрасываете счётчик, меняете план или продлеваете абонента, SAMM записывает действие здесь, а не касается активного маршрутизатора напрямую.

Каждая запись показывает действие, его цель, администратора, который его инициировал, когда это произошло, и было ли оно уже применено. Служба samm-radius опустошает ожидающие записи на своём следующем тике и, где нужно, выпускает CoA для обновления активной сессии. Значок в боковой панели считает записи, всё ещё ожидающие; панель состояния конвейера на Панели управления отслеживает очередь.

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

Лицензирование и тарифы

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

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

Активация и повышение уровня

1. Откройте Система → Лицензия.
2. Активируйте, войдя с вашей учётной записью SecuryTik — или используйте Привязать это устройство, которое показывает код, подтверждаемый вами на samm.securytik.com без ввода вашего пароля на сервере. Устройство активируется на уровне Free.
3. Чтобы подняться выше, запросите Pro или Pro Max с той же страницы — администратор SecuryTik рассматривает и одобряет это.

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

Если платная лицензия истекает

SAMM никогда не удаляет данные. Истёкшая лицензия понижается плавно:

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

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

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

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

Клиентский портал и бот

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

Клиентский портал

Абоненты входят в корневой раздел сайта SAMM (/), используя своё имя пользователя SAMM и пароль. На портале есть:

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

Telegram-бот

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

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

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

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

Когда подписка истекает, маршрутизатор (настроенный мастером через «пул Expired и блокировку интернета») перенаправляет браузер абонента на дружелюбную страницу «подписка истекла», которую SAMM отдаёт на порту 81 — с логотипом вашего провайдера и кнопкой входа в портал — вместо молчаливо мёртвого соединения.

Система

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

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

1. Откройте System → API (только суперадмин), задайте имя, срок действия и нужные интеграции области, затем нажмите Создать токен.
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 дней или бессрочно) и набор областей — права чтения/записи по ресурсам; область write автоматически включает соответствующую read. Секрет показывается ровно один раз; сервер хранит только хеш. Токен можно отозвать (вызовы сразу перестают работать, обратимо) или удалить совсем.

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

Справочник эндпоинтов

Команды в очереди

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

Webhooks

Зарегистрируйте URL эндпоинта и выберите события (абонент создан/изменён/продлён/истёк, лимит исчерпан, счёт создан/оплачен, опциональные события сессий). Секрет подписи возвращается один раз при создании. Доставки повторяются с нарастающей задержкой; постоянно сбоящий эндпоинт отключается автоматически — включите снова через POST /webhooks/{id}/enable или отправьте себе образец через POST /webhooks/{id}/test.

Каждая доставка несёт X-SAMM-Event и X-SAMM-Signature: sha256=HMAC(body). Проверяйте, прежде чем доверять:

import hmac, hashlib

def verify(body: bytes, signature_header: str, secret: str) -> bool:
    calc = "sha256=" + hmac.new(secret.encode(), body,
                                hashlib.sha256).hexdigest()
    return hmac.compare_digest(calc, signature_header)

Справочник

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

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

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

# 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

Admin CLI

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

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

Файлы конфигурации

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

Обновление SAMM

Либо позвольте SAMM обновиться самому из System → License, либо повторно запустите установщик — см. Installation → Upgrading. Оба пути повторно применяют миграции и перезапускают службы; ваша конфигурация и данные остаются нетронутыми.

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

Используйте Tools → Backup & Restore для полного снимка базы данных перед любым значимым изменением. Чтобы восстановить систему на новом хосте, установите SAMM, а затем восстановите резервную копию.

Инструменты обслуживания (внешние)

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

Сброс пароля заблокированного администратора

Потеряли доступ к панели администратора? Задайте новый пароль для учётной записи 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. Если superadmin несколько, укажите --user <name>.

Сбросить бухгалтерские книги (стирать финансовые данные)

Очищает каждую финансовую транзакцию, чтобы интернет-провайдер мог начать учет с нуля. при этом все данные подписчиков и AAA остаются нетронутыми. Полезно при приеме на себя установить или после пробного/тестового периода, когда книги заполнены данными оператора желания исчезли, но клиентская база должна остаться такой, какая она есть.

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

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

Загрузите его, прочитайте, затем запустите. Всегда сначала делайте пробный прогон:

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

Скрипт отказывается запускаться от имени пользователя без полномочий root, печатает именно то, что собирается удалить, затем попросит вас ввести YES , чтобы подтвердить, что у вас есть проверенная резервная копия, и WIPE , чтобы продолжить. Он предлагает сначала сделать дамп собственной базы данных (в /var/backups/samm/ ) и прерывается в случае сбоя этого дампа. Очистка выполняется как одна транзакция по принципу «все или ничего», а RADIUS намеренно оставлен включенным, поэтому подписчики остаются онлайн, пока книги очищаются.

Справочник

FAQ и устранение неполадок

Нужна дополнительная помощь?

Напишите на [email protected], чтобы сообщить об ошибке или запросить функцию.