Dokumentation

SAMM Dokumentation

Das vollständige Bedienerhandbuch — von der Erstinstallation bis zum täglichen Betrieb.

25 Themen 8 Abschnitte Installation mit einem Befehl
Schnellinstallation

In wenigen Minuten online, mit einem einzigen Befehl.

Führen Sie einen einzigen Befehl auf einem neuen Ubuntu- oder Debian-Server — oder in der PowerShell unter Windows — aus, und der Installer lädt das neueste Release herunter und richtet den gesamten SAMM-Stack für Sie ein.

Die vollständige Installationsanleitung lesen
Ubuntu / Debian — als root ausführen
curl -fsSL https://samm.securytik.com/install.sh | sudo bash
Windows — in PowerShell als Administrator ausführen
irm https://samm.securytik.com/install-windows.ps1 | iex
Playlist Videokurs SAMM von der Installation bis zum täglichen Betrieb erleben — ein vollständiger Videokurs Eine kostenlose Schritt-für-Schritt-YouTube-Playlist, die Sie durch die Installation von SAMM und den täglichen Betrieb führt — dieselben Inhalte wie in diesem Handbuch, auf Video. Auf YouTube ansehen

Erste Schritte

Übersicht & Architektur

SAMM — SecuryTik Active Mikrotik Manager — ist eine umfassende ISP-Management-Plattform für MikroTik PPPoE & Hotspot-Netzwerke. Ein einziger Installer verwandelt einen Standard-Linux-Server in ein vollständiges AAA-, Billing- und Teilnehmerverwaltungssystem.

Zielgruppe von SAMM

SAMM wurde für Wireless ISPs, Glasfaserbetreiber und Hotspot-Anbieter entwickelt, die MikroTik RouterOS einsetzen. Wenn Sie Abonnenten über PPPoE, Hotspot oder IPoE/DHCP authentifizieren und Geschwindigkeitsstufen, Datenlimits, Ablaufdaten sowie die Abrechnung verwalten müssen — SAMM erledigt all dies über eine einzige Oberfläche.

IPoE/DHCP-Abonnenten werden über ihre DHCP Option 82 circuit-id (den physischen Access Port — die professionelle ISP-Methode) oder die MAC-Adresse des Geräts identifiziert. Das radius-password des DHCP-Servers ist dabei einfach das eigene RADIUS shared secret des Routers, sodass keine zusätzlichen Konfigurationen erforderlich sind.

IPv6 dual-stack ist eine optionale Funktion: Jeder Teilnehmer kann IPv6 zusätzlich zu IPv4 erhalten. Aktivieren Sie diese im Router-Assistenten und wählen Sie die Länge des delegierten (DHCPv6-PD) Präfixes — standardmäßig /56, oder einen Wert zwischen /48 und /64 — sowie die zu verteilenden IPv6-Blöcke. Bei jedem Access-Accept gibt SAMM einen WAN IPv6-Pool sowie ein an das LAN des Teilnehmers delegiertes geroutetes Präfix zurück, sodass der eigene Router des Kunden (im Route-Modus) dieses in /64-Netze unterteilt und SLAAC für dessen Geräte ausführt — das Standardmodell der ISP-Präfix-Delegation. Es funktioniert mit PPPoE, Hotspot und IPoE, und für Geschäftskunden kann pro Teilnehmer ein statisches IPv6-Präfix fest zugewiesen werden.

Funktionsweise

SAMM hält den Hot Path nah an der Datenbank. FreeRADIUS verarbeitet jedes Authentifizierungs- und Accounting-Paket; bei jedem Accounting Interim-Update ruft es PostgreSQL-Funktionen direkt auf, um die Nutzung zu summieren und Limits auszuwerten — es gibt keinen Python-Roundtrip, während Teilnehmer online sind.

Vier Ausführungsebenen arbeiten über eine einzige Datenbank zusammen:

  • 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.

Die fünf Dienste

DienstRolle
samm-apiAdministrator-Portal + Kunden-Self-Service-Portal + REST API
samm-radiusLeert den CoA-Postausgang; führt Bereinigungen für Ablaufdaten / täglichen Reset / Geschwindigkeitsfenster durch
samm-workerPing-Abfrage der Router; synchronisiert MikroTik-Gerätemetadaten über die API
samm-notificationVersendet E-Mail- & Telegram-Benachrichtigungen über eine gedrosselte Queue
samm-telegramStartet den interaktiven Telegram-Self-Service-Bot

Was SAMM bewirkt

AAA-Core

PPPoE & Hotspot-Authentifizierung, benutzerbezogene Geschwindigkeitsbegrenzung, Hybrid CoA.

Tarife & Limits

Geschwindigkeitsstufen sowie vier unabhängige Limits und zeitgesteuerte Geschwindigkeitsfenster.

Kunden

PPPoE-, Hotspot- und IPoE/DHCP-Benutzer sowie Prepaid-Hotspot-Gutscheinkarten mit druckbaren PDFs.

Abrechnung

Tarifabhängige Preise, automatische Rechnungen, ein Hauptbuch mit doppelter Buchführung für Belege/Zahlungen/Ausgaben.

Self-Service

Ein Kundenwebportal und ein Telegram-Bot für die Nutzungsübersicht, Rechnungen und Tickets.

Betrieb

Live MikroTik-Inventar, rollenbasierte Administratoren, Backup & Restore, Bulk-Tools.

System

Integriertes WireGuard VPN, Cloudflare Tunnel, acht Sprachen, anpassbare UI.

Benachrichtigungen

Warnungen zu Verlängerung, Ablauf, Kontingent und Belegen per E-Mail und Telegram.

Der Rest dieses Handbuchs ist eine Anleitung für jeden dieser Bereiche. Nutzen Sie das Menü auf der linken Seite oder beginnen Sie mit der Installation.

Erste Schritte

Was gibt es Neues

SAMM aktualisiert sich selbst, sodass jede Installation diese Funktionen beim nächsten Update erhält. Jede Zeile verlinkt auf die Seite, auf der die Verwendung erklärt wird.

6.0

  • Kartendesigns: Gestalten Sie Ihre gedruckte Hotspot-Karte selbst (Größe, Hintergrund, Ihr Logo, ein QR-Code, der die Karte mit einem Scan anmeldet), oder starten Sie mit einem von zehn fertigen Designs. Jede Gruppe hat ein Design für den Druck und eines für den Schnelldruck auf einem Thermodrucker (80 oder 58 mm). Hotspot-Karten
  • Eine Karte hinzufügen oder eine Liste importieren: + Card fügt eine Karte mit dem Benutzernamen, Passwort und Namen Ihrer Wahl hinzu; Import übernimmt eine CSV- oder Excel-Liste, mit Vorschau. Hotspot-Karten
  • Restzeit und Restdaten auf dem Router: Die Hotspot-Statusseite zeigt, was auf einer Karte übrig ist, und der Router beendet die Sitzung, wenn sie aufgebraucht ist. Hotspot-Karten
  • Ein IP-Pool pro Benutzer (zum Beispiel ein CGNAT-Pool), ausgewählt aus den Pools Ihrer Router. CGNAT & IP-Pools
  • Jede Zeitzone der Welt, mit dem Nahen Osten an erster Stelle.
  • Tiefenprüfung: wählen Sie Ihre MikroTik-BNGs und die Laufzeit und lesen Sie dann einen Bericht mit Bewertung und dem, was Sie zuerst tun sollten, in Ihrer Sprache, als Seite oder als PDF. Sie liest nur den Router. Tiefenprüfung
  • SCOOP AI: ein Assistent unten auf jeder Seite. Fragen Sie in eigenen Worten nach Kunden, Paketen, Rechnungen und Routern; Geld, Löschungen und Router-Änderungen warten auf Ihre Freigabe. SCOOP AI
  • Schnellere Benutzer-Queues: hält Anrufe und Spiele flüssig, während ein Kunde herunterlädt. Der Router-Assistent kann sie einstellen, und Health bietet eine Reparatur mit einem Klick an.
  • Dashboard pro Rolle: wählen Sie, ob eine Rolle das Dashboard sieht. Eine Rolle ohne Dashboard öffnet sich auf ihrer ersten erlaubten Seite.
  • Sham Cash: Bei der nicht offiziellen Verbindung kann ein Kunde, der den Code vergessen hat, die Zahlung mit der Überweisungsnummer und seiner eigenen Adresse bestätigen.

5.12

  • Datenaufbewahrung und Lookup: Sitzungen für den vom Gesetz verlangten Zeitraum speichern (standardmäßig zwei Jahre), auch für gelöschte Benutzer, und ermitteln, welcher Benutzer zu einem bestimmten Zeitpunkt eine öffentliche Adresse und einen Port hatte. Jede Suche braucht ein Aktenzeichen und wird im Lookup-Protokoll gespeichert; eine tägliche verschlüsselte Datei kann auf Ihr NAS gehen. Datenaufbewahrung & Lookup
  • CGNAT und IP-Pools: öffentliche Adressen zwischen Benutzern teilen, jeder mit einem eigenen Portblock, oder SAMM die Adresse pro Router und Tarif selbst vergeben lassen. CGNAT & IP-Pools
  • Cisco, Huawei, Nokia und ZTE als NAS, mit Geschwindigkeiten, Trennungen, einer fertigen Einrichtungsseite, dem Data Log und CGNAT auf Cisco. Andere Router-Marken
  • FTTH: OLTs von V-SOL, Huawei, ZTE und Nokia, jede ONU mit ihrem Signal, ONUs mit Benutzern verknüpft und die Anschlusssperre. FTTH & OLTs
  • Geräteseiten für jede Marke: CPU, Speicher, Temperatur, Betriebszeit und Diagramme für OLTs und andere Router, wie bei MikroTik; das Router-Formular fragt für jeden Typ nach der passenden Anmeldung. Andere Router-Marken
  • VPN über SAMM pro Router: Über SAMM oder Über Router; Sham-Cash-Zahlungen laufen nie über das VPN. VPN über SAMM
  • Nutzung je Benutzer: eine Karte „Ausgewählter Zeitraum“ (gesamt, Sitzungen, Online-Zeit) und eine Leiste mit Tarif, Status, Ablauf, Adresse und MAC; der Telegram-Bot listet seine Befehle in der Sprache des Benutzers auf. Benutzer
  • Wir richten Ihren Server ein: bestellen Sie einen fertigen SAMM-Server mit Ihrer eigenen .com-Domain über Ihr Dashboard. Richten Sie Ihren Server ein

5.11

  • Kasse: eine Kassenseite unter Buchhaltung. Finden Sie einen Benutzer beim Tippen über Name, Mobilnummer oder einen Teil des Benutzernamens, dann kassieren Sie, verlängern, fügen Kontingent hinzu oder laden sein Guthaben bar auf. Sie hat eine eigene Berechtigung mit vier Häkchen, zeigt weder Gewinn noch Berichte und findet nur die Benutzer der Filiale des Kassierers. Buchhaltung, Administratoren, Filialen und Rollen
  • Fälligkeit der Rechnung nach Wahl: „Rechnung fällig nach (Tagen)“ in den Buchhaltungseinstellungen. Bei 0 ist eine Rechnung bei Ausstellung fällig und eine automatische Verlängerung am Ablauftag des Tarifs, sodass die Kulanzfrist ab dem Ablaufdatum zählt. Buchhaltung
  • Ausgleich beim Wechsel in einen günstigeren Tarif: beim Wechsel in einen günstigeren Tarif kann der ungenutzte Teil des Zeitraums ins Guthaben oder bar erstattet werden; der Betrag wird vor dem Speichern angezeigt. Tarif ändern gibt es auch im Zeilenmenü der Benutzerliste. Benutzer
  • Automatische Verlängerung zahlt aus dem Guthaben, und das Guthaben eines säumigen Benutzers begleicht die Schuld, bevor das Konto gesperrt wird. Buchhaltung
  • Benachrichtigungen pro Kanal: wählen Sie die Kanäle jeder Benachrichtigung, senden Sie über alle und schreiben Sie einen eigenen SMS-Text mit Live-Zeichenzähler. Benachrichtigungen
  • VPN über SAMM ohne Tunnel für Router im selben Netz wie SAMM, und Kindersicherung und VPN eines Benutzers im Admin-Bereich verwalten. VPN über SAMM
  • Schnittstellen-Kontingent, das richtig zurückgesetzt wird: Reset quota zählt ab null und schaltet die Schnittstelle sofort wieder ein, jederzeit, mit dem Verbrauch seit dem letzten Zurücksetzen auf der Seite. MikroTik-Manager
  • Listen für Websites und Apps pro Router: jeder Router zeigt, ob seine Liste aktuell ist, mit Anwenden und Befunden auf der Seite Zustand; Überwachungswerte werden alle 5 Sekunden aktualisiert. MikroTik-Manager

5.9

  • Externe VPN-Anbieter: Fügen Sie in einem Schritt ein NordVPN-, Mullvad-, IVPN- oder AirVPN-Konto hinzu, wählen Sie die Anzahl der Server und das Land, oder laden Sie Dateien von einem beliebigen Anbieter wie ProtonVPN hoch. Jeder Benutzer bleibt bei einer Verbindung, die Verbindungen teilen sich die Last nach Gewichtung, und fällt eine aus, behalten ihre Benutzer den Internetzugang über die eigene Leitung von SAMM. VPN über SAMM
  • Zusatzvolumen als Add-on: Verkaufen Sie mehr Datenvolumen, ohne Tarif oder Ablaufdatum des Benutzers zu ändern, als Paket oder als Preis pro GB, im Panel oder im Benutzerportal. Add-ons
  • Funksektoren: jedes Benutzer-Funkgerät mit dem Sektor, in dem es sich befindet, wie lange es dort war und jeden Wechsel, ein Jahr lang gespeichert; die Switches hinter Ihren Sektoren mit den Benutzern an jedem; und auf der Benutzerseite die Kette Sektor › Funkgerät › Switch › Benutzer mit Signal, Reichweite und Qualität. Netzwerk
  • Einen Benutzer überwachen für 24, 48 oder 72 Stunden: Online-Zeit, Geschwindigkeit, Signal, Sektor und jede Trennung mit ihrer Ursache, danach ein druckbarer Bericht mit Diagrammen und einem kurzen Befund. Benutzer
  • Netzwerkkarte auf OpenStreetMap: Platzieren Sie Ihre Router, Sektoren und Benutzer dort, wo sie sich tatsächlich befinden, neben dem Diagramm. Netzwerk
  • Aktualisierungen der App-Liste: SAMM prüft die SecuryTik-App-Liste jeden Tag; wählen Sie „Benachrichtigen“, „Automatisch anwenden“ oder „Aus“ und stellen Sie die vorherige Liste mit einem Klick wieder her. MikroTik-Manager
  • Von- und Bis-Datum in jeder Suche mit Datum, Filter für Kindersicherung und VPN in der Benutzerliste sowie dieselbe Seite in so vielen Fenstern, wie Sie Bildschirme haben. Benutzer, Dashboard
  • Umzug von ADV Radius: übernehmen Sie Benutzer und Tarife aus der Sicherungsdatei, mit Passwörtern, Ablaufdaten, statischen Adressen und Tarifbegrenzungen. Werkzeuge

5.8

  • Externes VPN: VPN-Benutzer gehen über NordVPN (per Zugriffstoken) oder die WireGuard-Dateien eines beliebigen Anbieters hinaus statt über die eigene Leitung von SAMM, auch wenn SAMM keine öffentliche Adresse hat. VPN über SAMM
  • VPN über SAMM: ausgewählte Benutzer leiten ihren gesamten Datenverkehr oder nur die Apps, die sie auswählen, über Ihren SAMM-Server statt über ihren lokalen Anschluss. Erlauben Sie es pro Benutzer oder verkaufen Sie es als Add-on; die Benutzer schalten es im Benutzerportal ein. VPN über SAMM
  • SAMM auf zwei Bildschirmen: öffnen Sie jede Seite oder einen einzelnen Dashboard-Block in einem eigenen Fenster und behalten Sie ihn auf einem zweiten Monitor. Dashboard
  • Kindersicherung als Add-on: verkaufen Sie die Kindersicherung für einen Zeitraum, wie jedes andere Add-on. Add-ons
  • Wi-Fi-Optimizer: eine Live-Spektrumansicht jedes Funkmoduls, der erfassten Netzwerke und der Auslastung jedes Kanals, inklusive eines Kanalplaners, der den leisesten Kanal sowie die beste Breite empfiehlt und Funkmodule nachts automatisch verschieben kann. Netzwerk
  • Ubiquiti-Geräte: fügen Sie UniFi Access Points und airOS Radios als überwachte Geräte hinzu. UniFi Radios zeigen ihre Clients, benachbarte Netzwerke und das Spektrum an, und der Optimizer verschiebt sie tatsächlich auf einen besseren Kanal und eine bessere Kanalbreite. MikroTik Manager
  • Drei Monitore für jeden Router in jedem Tarif: Access Points und Radios, die Sie nur überwachen, verbrauchen keine Router-Kontingente mehr. MikroTik Manager
  • Importieren Sie die Benutzer, die ein Router bereits führt (PPP, Hotspot und User Manager, RouterOS 6 und 7) mit ihren Passwörtern, Tarifen, Limits, Namen, Telefonnummern und Ablaufdaten im Hintergrund. MikroTik Manager
  • Eine Verlängerung rückgängig machen: Durch das Löschen der Rechnung einer Verlängerung kann das Ablaufdatum des Benutzers auf den ursprünglichen Stand zurückgesetzt werden. Die Funktion Renew Plan kann über die obere Leiste rückgängig gemacht werden, und die Rechnungsliste zeigt die Gesamtsummen für alle durch den Filter angezeigten Einträge an. Rückgängig machen & Genehmigungen
  • Backups in Ihr eigenes Google Drive. Verbinden Sie Google Drive unter Backup & Restore mit einem kurzen Code; jedes automatische Backup wird dann zusätzlich in einen SAMM Backups-Ordner in Ihrem Drive kopiert, und jede Kopie kann zur Wiederherstellung zurückgespielt werden. Tools
  • Fester Verlängerungszeitpunkt in einem Tarif: Jedes Ablaufdatum fällt auf die von Ihnen gewählte Uhrzeit, aufgerundet, sodass ein Benutzer niemals weniger als den Zeitraum erhält. Tarife
  • Adressliste pro Tarif: der Router fügt die Adresse jedes Benutzers einer Liste hinzu, die nach dem jeweiligen Tarif benannt ist, damit Sie eigene Firewall-, Queue- und Routing-Regeln erstellen können. Tarife
  • Self Service Collect Mode: Gäste geben ihren Namen und ihre Mobilnummer ein und sind sofort online, ohne Passcode; jeder Login wird für den Export gespeichert. Self Service
  • Ein übersichtlicheres Diagramm zur Verbindungsqualität mit Achsen, Download- und Upload-Linien, Details beim Hovern und zum Datenverbrauch sowie E-Mail in der Benutzersuche und beliebigen Ports in der Data Log-Suche. Users, Data Log

5.7

  • Zweigstellen besitzen ihre eigenen Geräte. Jeder Router und Access Point gehört zu einer Zweigstelle oder zum Hauptquartier; Mitarbeiter der Zweigstellen verwalten ihre eigenen Geräte und sehen nur die übergeordneten Geräte, und eine Einstellung ermöglicht es Benutzern, sich nur über die Router ihrer Zweigstelle anzumelden. Administratoren, Zweigstellen & Rollen
  • Zeitlimits für Rollen. Begrenzen Sie, wie viele Zeiträume oder Tage im Voraus eine Rolle gewähren darf, weisen Sie neuen Benutzern eine feste Zeit zu (zum Beispiel 2 Stunden) und trennen Sie die Funktion Tage hinzufügen von der Eingabe eines Ablaufdatums. Administratoren, Zweigstellen & Rollen
  • SSTP VPN neben WireGuard und L2TP/IPsec, für mehrere Router hinter derselben öffentlichen Adresse. VPN
  • RouterOS 6 funktioniert überall: Assistent, Auto-Complete, Konfigurationsbereitstellung, Massenaktionen, Websites & Apps, QoS und VPN-Links. RouterOS 6
  • Kindersicherung im Benutzerportal: Kategorien, Apps und Websites blockieren, dauerhaft oder über einen Wochenkalender. Kindersicherung
  • Punkte & Belohnungen für Verlängerungen und geworbene Freunde, einlösbar gegen höhere Geschwindigkeiten oder kostenlose Tage. Punkte & Belohnungen
  • Ihr Branding im Administrator-Panel, im Benutzerportal und auf den Anmeldeseiten, mit einem Logo, das Sie direkt im Browser zuschneiden. Branding
  • Sprachumschalter, Sichtbarkeit der Tarife im Portal, SMS-Vorlagenmodus und eine Einzeilen-SAMM-Installation auf einem MikroTik Router. Sprachen, Tarife, MikroTik Container

5.6

  • Konfigurationsbereitstellung: Jede an Ihre Router gesendete Änderung wird mit einem Ergebnis pro Router verfolgt, erreicht offline befindliche Router, sobald diese wieder online sind, und wird automatisch wiederholt. Konfigurationsbereitstellung
  • Ein Dashboard, das in etwa einer Sekunde öffnet, und eine Seitenleiste, die beim Wechsel der Seiten an ihrer Position bleibt.

5.5

  • Data Log-Suche über alle Benutzer: wer eine Adresse, einen Port, ein Protokoll oder eine App in einem beliebigen Zeitraum erreicht hat. Data Log
  • Detaillierte Berechtigungen unter Bearbeiten (Benutzer löschen, verlängern, Tarif ändern, Rechnungen bezahlen, Router-Skripte ausführen…), sowie eine Vorschau des neuen Ablaufdatums vor der Verlängerung. Rollen

5.4

  • Finanzen nach Zweigstelle: jede Rechnung, Zahlung, Ausgabe und jedes Kassenkonto ist einer Zweigstelle zugeordnet, inklusive Zweigstellenauswahl, Kassenübergaben und einem Zweigstellenbericht. Buchhaltung & Abrechnung

5.3

  • Sham Cash, ein Checkout für jede Zahlungsmethode, eine öffentliche Pay page und Renew online für 1 bis 12 Zeiträume. Online-Zahlungen
  • Rechnungsrabatte, Add-ons mit kostenlosen Apps, der Aktivierungsbericht, Benutzername ändern und Anzahlungen bei Verlängerungen. Add-ons

5.2

  • Dynamic Speed Booster, Manager-Aktionen auf vielen Routern gleichzeitig, Add-ons, Preislisten pro Zweigstelle, Benutzerdateien, benutzerdefinierte Felder, die Traffic-Seite und der History-Cleaner. Speed Booster, Manager-Aktionen

Erste Schritte

Installation

SAMM installiert alles Notwendige — FreeRADIUS, PostgreSQL, nginx, WireGuard, cloudflared und die fünf SAMM-Dienste — in einem Schritt. Der Installer ist idempotent: Ein erneuter Durchlauf aktualisiert eine bestehende Installation in place und überschreibt niemals Ihre Konfiguration oder generiert Ihr Datenbankpasswort neu.

Installationshandbuch

Jeder Schritt mit Screenshots: Windows (einschließlich Aktivierung der Virtualisierung im BIOS), Ubuntu, ein MikroTik-Router, ein fertiger Server, die Lizenz (bezahlen, verknüpfen, verlängern), die Anbindung Ihrer Router über das VPN und die Zusatzfunktionen.

SAMM läuft überall — wählen Sie den Installationspfad, der zu Ihrem Netzwerk passt:

Voraussetzungen

  • Ein neu aufgesetzter Server: Ubuntu 22.04 / 24.04 / 26.04 LTS oder Debian 12 / 13. Nur Linux-Server-Distributionen — Desktop-Varianten werden nicht unterstützt.
  • Root / sudo-Zugriff und eine Internetverbindung.
  • systemd und ein Host, auf dem PostgreSQL lokal installiert werden kann (einer ist bereits für Sie eingerichtet).

Installation

Option A — mit einem Befehl installieren

Führen Sie auf dem Server folgenden Befehl aus:

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

Dieses Bootstrap-Skript lädt das neueste SAMM-Release-Bundle von GitHub herunter, entpackt es und führt den vollständigen Installer automatisch aus. In wenigen Minuten erledigt.

Wenn github.com in Ihrem Land blockiert ist, verwenden Sie stattdessen den von Cloudflare gehosteten Mirror — gleicher Installer, es wird nichts von GitHub abgerufen. (Der oben stehende Standardbefehl erkennt ein blockiertes GitHub ebenfalls und wechselt automatisch zu diesem Mirror.)

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

In jedem Fall öffnen Sie nach Abschluss der Installation das Administrator-Portal und melden sich mit diesen Zugangsdaten an:

Login-URLhttp://<your-server>/admin · Benutzernameadmin · Passwortadmin

Ändern Sie das Administrator-Passwort unmittelbar nach Ihrer ersten Anmeldung.

Installation

Option B — auf Windows (Hyper-V) installieren

SAMM läuft unter Windows in einer eigenen kleinen Ubuntu 24.04 virtuellen Maschine auf Hyper-V, die von einem Installer erstellt und verwaltet wird. Die VM ist mit einer eigenen IP-Adresse in Ihrem Netzwerk integriert, sodass Ihre MikroTik Router SAMM direkt erreichen — RADIUS sieht die echte Adresse jedes Routers und CoA-Disconnects funktionieren — genau wie bei einem Linux-Server.

Öffnen Sie die PowerShell als Administrator — nicht die Eingabeaufforderung (cmd): Klicken Sie mit der rechten Maustaste auf die Startschaltfläche, wählen Sie Terminal (Administrator) oder Windows PowerShell (Administrator) und bestätigen Sie mit Ja. Führen Sie dann aus:

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

Wenn samm.securytik.com von diesem PC aus nicht erreicht werden kann, verwenden Sie stattdessen den bei Cloudflare gehosteten Mirror — es ist derselbe Installer. (Der Installer selbst wechselt ebenfalls automatisch zum Mirror, wenn ein Download fehlschlägt.)

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

In jedem Fall öffnen Sie nach Abschluss der Installation das Administrator-Portal und melden sich mit diesen Zugangsdaten an:

Login-URLhttp://<SAMM IP>/admin · Benutzernameadmin · Passwortadmin
OS-Login (SSH)samm / samm · Root (Konsole)root / samm

Die gleichen Standardwerte wie bei der SAMM Server ISO. Ändern Sie alle nach Ihrem ersten Login. Die Verknüpfung SAMM Info auf dem Desktop zeigt diese erneut an, zusammen mit der IP-Adresse von SAMM und der Information, wie die VM über SSH erreicht werden kann.

Anfrageinhalt

  1. Welches Netzwerk SAMM beitreten soll, wenn der PC mehr als einen verbundenen Adapter hat. Drücken Sie Enter für die empfohlene Option (kabelgebunden vor Wi-Fi).
  2. IP-Adresse von SAMM in diesem Netzwerk. Es wird eine freie Adresse vorgeschlagen; drücken Sie Enter, um diese zu akzeptieren, geben Sie eine andere ein oder tippen Sie dhcp.

Wenn Hyper-V deaktiviert ist, aktiviert der Installer es und fordert zu einem einmaligen Neustart von Windows auf; nach der erneuten Anmeldung wird der Vorgang automatisch fortgesetzt. Der Rest — Multipass, die Netzwerkbrücke, die VM und SAMM selbst — dauert 10 bis 20 Minuten und wird durch einen Fortschrittsbalken angezeigt.

Anforderungen

  • Windows 10 / 11 Pro, Enterprise oder Education oder Windows Server 2019 und neuer (64-Bit). Windows Home verfügt über kein Hyper-V.
  • Hardware-Virtualisierung im BIOS/UEFI aktiviert (Intel VT-x oder AMD-V). Das Installationsprogramm prüft dies und bricht mit einer eindeutigen Meldung ab, falls sie deaktiviert ist — siehe Virtualisierung aktivieren.
  • Mindestens 8 GB Arbeitsspeicher, wovon 4 GB für die VM von SAMM frei sein müssen (3 GB sind das Minimum; andere virtuelle Maschinen — VMware, VirtualBox — werden hierbei angerechnet), sowie 40 GB freier Festplattenspeicher.
  • Ein Netzwerkkabel wird dringend empfohlen. Viele Wi-Fi-Treiber können eine virtuelle Maschine nicht in das Netzwerk überbrücken, sodass dann nur der PC selbst SAMM erreichen kann.

Nach der Installation

  • Öffnen Sie das Administrator-Panel unter http://<SAMM IP>/admin/login (eine SAMM Admin-Verknüpfung befindet sich auf dem Desktop), melden Sie sich mit admin / admin an und ändern Sie umgehend das Passwort.
  • Konfigurieren Sie Ihren MikroTik RADIUS auf die SAMM IP (UDP 1812/1813) — der Router Assistent im Panel erledigt dies für Sie.
  • SAMM startet mit Windows, bevor sich ein Benutzer anmeldet, und der PC ist so eingestellt, dass er niemals in den Energiesparmodus wechselt. Schließen Sie bei einem Laptop das Ladegerät an und stellen Sie die Option für das Schließen des Deckels auf „Nichts unternehmen“.
  • Zum Entfernen: Führen Sie dieselbe Zeile mit -Uninstall aus oder & ([scriptblock]::Create((irm https://samm.securytik.com/install-windows.ps1))) -Uninstall.

Installation

Virtualisierung im BIOS/UEFI aktivieren

SAMM unter Windows läuft in einer Hyper-V-virtuellen Maschine, die die Virtualisierungsfunktion des Prozessors benötigt: Intel Virtualization Technology (VT-x) bei Intel oder AMD-V — meist SVM Mode genannt — bei AMD. Bei den meisten PCs ist diese Funktion bereits aktiviert; bei einigen ist sie deaktiviert. Da jeder Hersteller diese Einstellung in einem anderen Menü versteckt, finden Sie hier die allgemeinen Schritte und die üblichen Speicherorte.

Prüfen Sie zuerst, ob es bereits aktiviert ist

Öffnen Sie den Task-Manager (Strg+Umschalt+Esc) → Leistung → CPU. Wenn unter der Grafik Virtualisierung: Aktiviert steht, ist die Einrichtung abgeschlossen. (Wenn Hyper-V bereits aktiviert ist, zeigt Windows stattdessen möglicherweise eine Zeile an, dass ein Hypervisor erkannt wurde — das bedeutet ebenfalls, dass er aktiviert ist.)

Allgemeine Schritte

  1. Speichern Sie Ihre Arbeit und starten Sie den PC neu.
  2. Öffnen Sie das BIOS/UEFI-Setup: Drücken Sie die Setup-Taste wiederholt, sobald der Bildschirm aufleuchtet (siehe Tabelle). Unter Windows 10/11 können Sie auch über Einstellungen → System → Wiederherstellung → Erweiterter Start → Jetzt neu starten und anschließend Problembehandlung → Erweiterte Optionen → UEFI-Firmware-Einstellungen → Neustart gehen.
  3. Suchen Sie in den Menüs Advanced, Advanced CPU, Processor, Chipset, Security oder Virtualization nach Intel Virtualization Technology, Intel VT-x, SVM Mode oder AMD-V und setzen Sie diese Option auf Enabled. (Intel VT-d / AMD IOMMU ist nicht erforderlich.)
  4. Speichern und beenden (normalerweise F10), Windows starten lassen und dann den SAMM-Installer erneut ausführen.

Üblicher Speicherort

MarkeSetup-KeyStandardstandort
DellF2Virtualisierungs-Support → Virtualisierung / Intel Virtualization Technology aktivieren
HPF10 (oder Esc, dann F10)Erweitert (oder Sicherheit / Systemkonfiguration) → Virtualization Technology (VTx)
LenovoF1 / F2 (oder die Novo-Taste)Sicherheit (ThinkPad) oder Konfiguration → Intel Virtualization Technology / AMD SVM Technology
ASUSF2 / DelErweiterter Modus (F7) → Advanced → CPU Configuration → Intel Virtualization Technology oder SVM Mode
AcerF2Erweitert (oder Hauptmenü) → Intel Virtualization Technology
MSIDelOC → CPU Features → Intel Virtualization Tech oder SVM Mode
GigabyteDelTweaker (oder Advanced) → Advanced CPU Settings → Intel Virtualization Technology oder SVM Mode
Server (Dell iDRAC, HPE, Supermicro)F2 / F9 / DelProzessoreinstellungen → Virtualization Technology — oft bereits aktiviert
Eine virtuelle Maschine innerhalb einer anderen virtuellen Maschine (Windows selbst in VMware, Proxmox oder Hyper-V ausgeführt) benötigt stattdessen aktivierte nested virtualization im äußeren Hypervisor — zum Beispiel „Virtualize Intel VT-x/EPT“ in den CPU-Einstellungen von VMware, während die VM ausgeschaltet ist.

Installation

Option C — manuell aus einem Release-Bundle installieren

Laden Sie den neuesten samm-<version>.tar.gz von der GitHub Releases-Seite herunter, dann auf dem Server:

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

Sie können die Bereitstellung auch aus einer ZIP-Datei vornehmen, die auf einer anderen Maschine erstellt wurde — der Installer führt ein rsync der Quelle nach /opt/samm durch:

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

Oder klonen Sie das Repository nach /opt/samm und führen Sie sudo bash /opt/samm/install.sh aus.

In jedem Fall öffnen Sie nach Abschluss der Installation das Administrator-Portal und melden sich mit diesen Zugangsdaten an:

Login-URLhttp://<your-server>/admin · Benutzernameadmin · Passwortadmin

Ändern Sie das Administrator-Passwort unmittelbar nach Ihrer ersten Anmeldung.

Installation

Option D — mit Docker Compose installieren

Wenn Sie SAMM lieber als Container betreiben möchten — dasselbe Produkt, nur anders verpackt — nutzen Sie die Docker Compose Distribution unter github.com/mhdhaidarah/samm-docker. Auf jedem Host, auf dem Docker verfügbar ist:

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

Dies installiert Docker, falls es fehlt, legt eine docker-compose.yml in /opt/samm-docker/ mit einem bereits eingetragenen starken Zufallspasswort für die Datenbank ab und startet den Stack. Das Image mhdhaidarah/samm wird aus demselben kompilierten Bundle wie die Bare-OS-Installation erstellt — konstruktionsbedingt Closed Source.

Multi-arch — dasselbe Tag wird für linux/amd64 und linux/arm64 bereitgestellt, wobei die richtige Variante automatisch aus dem Tag ausgewählt wird: docker pull auf jedem Docker-Host (Intel/AMD, ARM-Server, Apple-silicon Mac) und MikroTik RouterOS 7.23+ direkt auf dem Router. Eine Datei, jede Plattform.

Auf Hosts, auf denen das Piping von curl zu bash nicht erlaubt ist (abgesicherte Systeme, strikte Egress-Richtlinien), können Sie die startbereite Compose-Datei direkt abrufen:

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

Einige Funktionen sind in der Docker-Variante noch nicht enthalten (gestufter Lizenz-Lockdown, dynamischer FreeRADIUS-Reload). Die integrierten WireGuard- und Cloudflare Tunnel-Administratorseiten sind in der Docker-Variante absichtlich ausgeblendet — sie verwalten systemd-Dienste auf Host-Ebene, die aus dem Container heraus nicht erreichbar sind. Wählen Sie oben Option A oder C, wenn Sie diese integrierten Funktionen benötigen, oder führen Sie cloudflared / wg-quick direkt auf dem Docker-Host neben SAMM aus. Weitere Informationen zu den Einschränkungen von v1 und zum manuellen Installationspfad finden Sie im README der Docker-Variante.

Unter Windows (Docker Desktop) — nur zur Evaluierung

Nicht für den Produktiveinsatz empfohlen. Windows-Energiesparmodus / Ruhezustand / Zuklappen des Laptops stoppt die Container; der Boot-Restart wird nur ausgelöst, wenn WSL startet (nicht beim Windows-Boot); der tägliche Auto-Update-Cron läuft nur, solange WSL aktiv ist. Nutzen Sie dies zur Evaluierung / Demo und setzen Sie die Produktion anschließend auf einer Linux VM (Hyper-V, Proxmox, ESXi) oder einem kleinen physischen Gerät (z. B. einem NUC mit Ubuntu Server) ein.

Installieren Sie Docker Desktop für Windows (dies ermöglicht die Einrichtung des WSL2-Backends beim ersten Start). Rufen Sie dann über PowerShell — ein WSL-Terminal ist nicht erforderlich — das Compose-Bundle ab und starten Sie den Stack:

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

Beobachten Sie den Start des Stacks in Docker Desktop → Containers — die samm-Gruppe erweitert sich auf 8 Dienste. Sobald alle grün leuchten, öffnen Sie das Administrator-Portal und melden Sie sich mit diesen Zugangsdaten an:

Login-URLhttp://localhost:8000/admin · Benutzernameadmin · Passwortadmin

Ändern Sie das Administrator-Passwort unmittelbar nach Ihrer ersten Anmeldung.

Wenn ein echter MikroTik NAS diesen Windows-Host für RADIUS anspricht, erlauben Sie UDP 1812 + 1813 durch die Windows Firewall:

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

Deinstallieren: docker compose down -v aus dem Installationsverzeichnis ausführen (das -v löscht das postgres-Volume und den Fernet-Key — sichern Sie diese zuerst, falls Sie Daten hinzugefügt haben).

Installation

Option E — auf einem MikroTik Router installieren (RouterOS 7.23+)

Gleiches SAMM, keine Linux-Box erforderlich. Wenn Ihr MikroTik-Gerät das container-Paket unterstützt und ein USB-Laufwerk oder eine microSD-Karte angeschlossen hat, können Sie den gesamten Stack direkt auf dem Router betreiben — mit der gleichen docker-compose.yml, die überall sonst verwendet wird. RouterOS 7.23+ ruft die richtige CPU-Architektur automatisch aus den Multi-Arch-Image-Tags ab, sodass kein routerspezifischer Download erforderlich ist.

Unterstützt: jeder container-fähige MikroTik Router — RB5009, hAP ax², CCR2004-1G-12S+2XS, CCR2116, CCR2216, L009 und ähnliche (arm64) sowie x86 RouterOS und CHR (amd64). Nicht unterstützt: armv7 / mipsbe / smips / tile / ppc Geräte (hEX, RB750, ältere RB-Modelle) — kein Container-Support oder zu wenig RAM/CPU für den SAMM-Stack. RouterOS 7.23 oder neuer ist erforderlich (ältere Versionen können die Architektur nicht aus einem Multi-Arch-Tag auswählen).

Der schnelle Weg: eine eingefügte Zeile

Öffnen Sie das Terminal des Routers (WinBox → New Terminal oder SSH) und fügen Sie diese eine Zeile ein:

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

Es prüft die RouterOS-Version, CPU und den Speicher des Routers, installiert das Container-Paket, aktiviert den Container-Modus, sucht eine ext4-Disk von mindestens 30 GB, lädt SAMM mit einem starken zufälligen Datenbankpasswort herunter, startet es und wartet, bis das Panel antwortet. Wenn Sie dazu aufgefordert werden (nach einem Neustart, nach einem Kaltstart, nachdem Sie die Disk vorbereitet haben), fügen Sie dieselbe Zeile erneut ein: jeder Schritt prüft, was bereits erledigt wurde, und fährt fort. Es formatiert niemals selbstständig eine Disk und greift niemals in bereits laufende Prozesse ein.

Möchten Sie es lieber manuell erledigen? Folgen Sie den unten stehenden Schritten.

1. Router vorbereiten

Installieren Sie das container-Paket (aus der extra_packages.zip auf mikrotik.com/download — laden Sie das passende container-*.npk über Files hoch und starten Sie dann neu). Aktivieren Sie anschließend den Container-Modus (einmalig — dieser wird erst nach einem Kaltstart aktiviert, nicht nach einem Soft-Reboot):

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

2. Festplatte formatieren und einbinden (ext4)

Setzen Sie ein USB-Laufwerk oder eine microSD-Karte ein (≥ 8 GB empfohlen — Postgres + Image-Layer addieren sich). Auf dem Router:

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

Überprüfen Sie nach der Formatierung, ob die Festplatte gemountet und beschreibbar ist:

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

Geben Sie dem Router anschließend an, von wo die Images heruntergeladen werden sollen (Docker Hub) und wo sie entpackt werden sollen — ohne diese Angabe schlägt jeder SAMM-Container mit "download/extract error: no registry url set" fehl:

/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"
Erscheint die Meldung „no registry url set“ oder „not enough disk space to download layer“? Führen Sie die oben stehenden Zeilen aus — der Download-Ordner muss auf dem USB/microSD-Speicher (dessen Mount-Point) liegen, nicht im kleinen internen Speicher des Routers. Deaktivieren Sie anschließend unter App → samm das Kontrollkästchen Enabled, klicken Sie auf Anwenden, aktivieren Sie es erneut und klicken Sie auf Anwenden: Der Router lädt alle SAMM-Komponenten erneut herunter und startet diese.

3. Compose-Datei kopieren

Eine Datei für jede Plattform. Ersetzen Sie change-me-strong-random-string (das Postgres-Passwort — verwenden Sie überall denselben starken Wert) und change-me-random-token. Gehen Sie dann in WebFig/WinBox zu Container → Apps → + New → YAML, einfügen, die ext4-Disk aus Schritt 2 als Speicher festlegen und bestätigen. RouterOS 7.23+ lädt die richtige CPU-Architektur automatisch aus den Image-Tags.

Hängen Sie bei "waiting for reverse proxy" fest? Deaktivieren Sie bei RouterOS 7.23+ die Option Use HTTPS im Apps-Dialog und führen Sie das Deployment erneut aus — diese Option steuert den Web-UI-Proxy der App, nicht den Abruf von Images.
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 verifizieren und mit SAMM verbinden

Sobald die SAMM-Container laufen, öffnen Sie das Administrator-Portal in einem Browser und melden Sie sich mit diesen Zugangsdaten an:

Login-URLhttp://<router-ip>:8000/admin · Benutzernameadmin · Passwortadmin

Ändern Sie sofort das Administrator-Passwort. RADIUS-Authentifizierung und Accounting sind auf dem Router selbst über UDP 1812 + 1813 erreichbar, sodass der MikroTik RADIUS-Client auf 127.0.0.1 mit dem Shared Secret verweisen kann, das Sie unter System → RADIUS festgelegt haben.

Experimenteller Deployment-Pfad. Die Container-Funktion von RouterOS ist schlanker als Docker Compose — DNS für Dienstnamen, die Reihenfolge von Abhängigkeiten (depends_on) und Live-Neustarts verhalten sich anders. Wenn der Stack auf Ihrer Hardware nicht ordnungsgemäß funktioniert, weichen Sie auf den Betrieb von Docker auf einer kleinen Linux-Box (NUC, Pi 4, Linux VM) neben dem MikroTik aus. Dieselbe Compose-Datei funktioniert dort mit vollständiger Compose-Semantik.

SAMM nach einem Neustart oder Absturz aktiv halten

RouterOS erstellt die Container der App ohne Auto-Start. Führen Sie dies einmal nach der Installation aus: Jeder SAMM-Container startet mit dem Router und startet neu, falls er stoppt, und ein kleiner Watchdog startet jede Minute alle gestoppten Container neu.

/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. Aktualisierung — manuelles Sichern und Wiederherstellen

Das Aktualisieren einer MikroTik Container-App löscht Ihre Datenbank. RouterOS kann die Version einer installierten App nicht direkt ändern — der einzige Weg besteht darin, die App zu entfernen und erneut hinzuzufügen. Das Entfernen löscht alle von der App gespeicherten Daten, einschließlich der SAMM-Datenbank. Erstellen Sie ein Backup und führen Sie den Download auf Ihren Computer aus, BEVOR Sie die App entfernen. Ein auf dem Router verbleibendes Backup wird zusammen mit allem anderen gelöscht.

Um eine MikroTik Container-Installation auf eine neue Version zu aktualisieren:

  1. Gehen Sie in SAMM zu Tools → Backup, erstellen Sie ein Backup und laden Sie die Datei auf Ihren Computer herunter.
  2. Entfernen Sie die App auf dem Router und fügen Sie diese mit der neuen Version erneut hinzu.
  3. Öffnen Sie das neue SAMM, gehen Sie zu Tools → Backup und stellen Sie die heruntergeladene Datei wieder her.

Dies gilt nur für den MikroTik-Container. Bei Docker (Linux, Windows oder einer Linux-VM) erfolgt ein Update über docker compose pull und anschließend docker compose up -d, wobei Ihre Daten unberührt bleiben — die Volumes befinden sich außerhalb der Container und bleiben erhalten.

Installation

Option F — SAMM Server ISO (Appliance-Installation)

Das SAMM Server ISO macht aus jedem leeren Rechner oder jeder VM einen fertigen SAMM-Server: starten, auf dem einzigen angezeigten Bildschirm DHCP oder eine statische IP wählen, bestätigen und fertig. Es installiert Ubuntu Server 24.04 LTS (minimized), nennt den Rechner samm-server und installiert SAMM beim ersten Start direkt aus dem ISO, mit oder ohne Internet; sobald der Server online ist, aktualisiert er sich einmal auf die neueste Version. Die Konsole zeigt einen SAMM-Startbildschirm und einen Anmeldehinweis mit der IP des Servers, der Adresse des Admin-Panels und den Standard-Zugangsdaten, und der Befehl samm-tools öffnet die Wartungswerkzeuge mit einem Tastendruck (Statusprüfung, Datenbank-Sicherung/-Wiederherstellung, Admin-Passwort zurücksetzen).

Das ISO löscht die erste Festplatte des Rechners. Starten Sie es nur auf Hardware oder einer VM, die nur für SAMM bestimmt ist. Internet ist nicht nötig: SAMM ist auf dem ISO und läuft in einem geschlossenen Netz.

Schreiben Sie es auf einen USB-Stick (Rufus, balenaEtcher oder dd) oder binden Sie es an eine VM an, booten Sie und beantworten Sie die Netzwerkfrage. Standard-Logins nach der Installation — Panel: admin / admin, OS: samm / samm oder root / samm — ändern Sie diese alle.

SAMM Server ISO herunterladen 2.5 GB

SHA-2560aa7c06bea4aba8ce7f632aacf243639ac7f78359cc0aa72005d88735930e9be

Installation

Installer-Referenz

Nicht-interaktive Optionen

Alle Abfragen können über Umgebungsvariablen vorab beantwortet werden, sodass der Installer unbeaufsichtigt ausgeführt werden kann:

VariableAuswirkung
DB_PASSVerwenden Sie dieses Datenbankpasswort anstelle eines automatisch generierten Passworts (nur bei der Erstinstallation)
CF_TOKENInstallieren Sie den Cloudflare Tunnel Connector mit diesem Zero Trust Token
SAMM_HTTP_PORTNginx-Listen-Port erzwingen (überspringt die Abfrage zur Port-80-Erkennung)
SAMM_VERBOSE1 gibt die rohe Befehlsausgabe anstelle des Fortschrittsbalkens aus
NO_COLOR1 deaktiviert die farbige Ausgabe
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

Was der Installer konfiguriert

Das Installationsprogramm bietet eine farbige Live-Fortschrittsanzeige — mit einem Prozentbalken und einer Checkliste pro Phase. Die Rohausgabe jeder Phase wird in /var/log/samm-install.log protokolliert; bei einem Fehler werden die letzten 30 Zeilen ausgegeben.

KomponenteDetails
FreeRADIUS 3Konfiguriert mit einem PostgreSQL-Backend und dynamischen NAS-Clients; validiert mit freeradius -CX
PostgreSQLDatenbank, Schema und alle SQL-Migrationen angewendet — jede Migrationsdatei ist idempotent
Python venvAlle Abhängigkeiten aus requirements.txt installiert; Übersetzungskataloge kompiliert. Wenn das Python der Distribution nicht mit dem kompilierten Bundle übereinstimmt, lädt der Installer automatisch einen passenden Standalone-Interpreter nach /opt/samm/runtime herunter
nginxReverse Proxy wird additiv hinzugefügt — bestehende Standorte werden niemals entfernt. Verwendet Port 80, wenn dieser frei ist; andernfalls wird ein alternativer Port abgefragt
5 servicessamm-api, samm-radius, samm-worker, samm-notification, samm-telegram — alle als systemd-Units aktiviert
WireGuardPakete installiert; später unter System → VPN konfigurieren
cloudflaredDie Binärdatei wird immer installiert; das Tunnel-Token ist bei der Installation optional oder wird später unter System → Cloudflare Tunnel hinzugefügt.

Alle Anmeldedaten — das Datenbankpasswort und die Session-Signaturschlüssel — werden bei der ersten Installation automatisch generiert.

Interaktive Abfragen

Alle Abfragen erfolgen vorab, bevor die Installation beginnt:

  • Cloudflare token — fügen Sie einen Zero Trust Connector-Token ein, um SAMM ohne offene Ports online zu veröffentlichen, oder drücken Sie Enter, um diesen Schritt zu überspringen und ihn später zu konfigurieren.
  • HTTP-Port — wenn Port 80 bereits belegt ist, lässt das Installationsprogramm diese Standorte unberührt und fragt nach einem alternativen Port (Standard 8080).

Installationsübersicht

Nach Abschluss der Installation wird eine Zusammenfassung mit der Administrator-URL, dem Standard-Login, dem gewählten HTTP-Port, den Datenbank-Zugangsdaten und den Pfaden der Konfigurationsdateien ausgegeben:

============================================================
  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
============================================================

Upgrade

Für ein Upgrade rufen Sie die neue Quelle ab und führen Sie den Installer erneut aus:

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

Der erneute Durchlauf synchronisiert die Quelle neu, aktualisiert die venv, wendet alle Migrationen erneut an, lädt die FreeRADIUS- und nginx-Konfigurationen neu und startet jeden Dienst neu. Ihre Konfigurationsdateien und der bei der Erstinstallation gewählte HTTP-Port bleiben erhalten.

Tipp SAMM kann sich auch selbst aktualisieren — siehe Lizenzierung & Updates. Aktivieren Sie automatische Updates oder führen Sie diese bei Bedarf unter System → License aus.
Air-gapped & Remote-DB SAMM liefert nur SAMM — FreeRADIUS, PostgreSQL, nginx und weitere Komponenten werden zum Zeitpunkt der Installation aus den Upstream-apt-Repositories bezogen, sodass bei Air-Gapped-Installationen diese Pakete vorab bereitgestellt werden müssen. Für ein remote PostgreSQL legen Sie den DSN nach der Installation in /etc/samm/samm.yaml fest.

Erste Schritte

Erste Schritte

Fünf kurze Schritte führen eine Neuinstallation zu dem Punkt, an dem Abonnenten eine Verbindung herstellen können und abgerechnet werden.

1 · Erste Anmeldung

  1. Öffnen Sie http://<your-server>/admin/ (verwenden Sie den HTTP-Port aus der Installationszusammenfassung, falls dieser nicht 80 ist) oder Ihre Cloudflare-Tunnel-URL.
  2. Melden Sie sich mit admin / admin an.
  3. Ändern Sie das Passwort sofort unter System → Admins oder über das Profilmenü in der oberen Leiste.

2 · Ersten Router hinzufügen

  1. Gehen Sie zu MikroTik → NAS und klicken Sie auf Router hinzufügen.
  2. Geben Sie die IP des Routers, einen Kurznamen und ein RADIUS shared secret ein. Für MikroTik-Geräte können optional API-Zugangsdaten für die Live-Gerätesynchronisierung hinzugefügt werden.
  3. Fügen Sie auf dem MikroTik einen RADIUS-Server hinzu, der auf den SAMM-Host (Ports 1812/1813) verweist, verwenden Sie das gleiche Shared Secret und aktivieren Sie RADIUS für PPP / Hotspot.

Ein Neustart von FreeRADIUS ist nicht erforderlich — SAMM löst NAS-Clients dynamisch aus der Datenbank auf. Siehe Router (NAS) für die vollständige Vorgehensweise oder lassen Sie den Einrichtungs-Assistenten den MikroTik für Sie konfigurieren.

3 · Tarif erstellen

Ein Tarif definiert die Geschwindigkeit, die Limits und den Verkaufspreis. Gehen Sie zu Users → Plans → New plan. Vollständige Feldreferenz: Plans & limits.

4 · Abonnent hinzufügen

Gehen Sie zu Users → New customer, geben Sie die Zugangsdaten ein und wählen Sie einen Tarif aus. Der Benutzer kann sich sofort verbinden. Für Prepaid-Hotspot-Zugänge erstellen Sie stattdessen Gutscheinkarten.

5 · Lizenz aktivieren

Eine Neuinstallation läuft unregistriert auf der niedrigsten Stufe. Öffnen Sie System → License und führen Sie die Aktivierung durch, um die Limits aufzuheben — siehe Licensing & tiers.

Tagesablauf Router hinzufügen → Tarife erstellen → Abonnenten oder Karten hinzufügen → das Dashboard nutzen → Zahlungen unter Rechnungswesen erfassen.

Erste Schritte

Von einem anderen System migrieren

Betreiben Sie bereits ein anderes RADIUS-Abrechnungssystem? SAMM liest dessen Daten aus und erstellt Ihre Tarife und Abonnenten neu, sodass Sie nichts erneut eingeben müssen. Abonnenten behalten ihr bestehendes Dienst-Passwort und das Ablaufdatum, sodass sie sich genau wie zuvor anmelden können.

Gehen Sie zu Tools → Export / Import und wählen Sie unter Migrate from another system Ihr altes System aus. Wie der Rest der Tools ist dies nur für Superadmins zugänglich.

Was hochladen

Altes SystemDateiHerkunft
SAS4 / Radius Manager .sql oder .sql.gz Ein MySQL-Backup der alten Datenbank
Super Speed Radius .sql oder .sql.gz Ein MySQL-Backup der alten Datenbank
Pro Radius .xlsx oder .csv Die exportierte Teilnehmerliste — dieses System bietet keinen Backup-Export

Datenbank-Backups sind oft mehrere Gigabyte groß; das ist in Ordnung, laden Sie die Datei einfach so hoch. Komprimierte Backups müssen nicht vorher entpackt werden.

Funktionsweise

  1. Datei hochladen. Es wurde noch nichts geschrieben.
  2. Überprüfen Sie die Vorschau. Diese listet die Tarife und Abonnenten auf, die erstellt würden, warnt vor allen Elementen, die übersprungen oder korrigiert werden mussten, und prüft die Gesamtzahl gegen Ihre Lizenz, bevor Sie die Änderungen übernehmen.
  3. Wählen Sie aus, was mit bereits existierenden Benutzernamen in SAMM geschehen soll — diese überspringen und den SAMM-Datensatz beibehalten oder dessen Namen und Kontakt aus dem alten System aktualisieren.
  4. Importieren. Jede Zeile wird unabhängig geschrieben, sodass eine einzelne fehlerhafte Zeile niemals den Rest rückgängig macht.

Eingehender Datenverkehr

  • Tarife — Name, Geschwindigkeiten, Preis, Dauer und Traffic-Kontingent, wie sie im alten System erfasst werden.
  • Abonnenten — Benutzername, Passwort für den Dienst, Name, Kontaktdaten, Ablaufdatum, Tarif, statische IP und MAC.
  • Im alten System deaktivierte Abonnenten bleiben deaktiviert.

Abrechnungen, Rechnungen, Prepaid-Karten, Tickets, Buchhaltung und Administrator-Logs werden bewusst nicht importiert — sie gehören zum Datenmodell des alten Systems und lassen sich selten präzise zuordnen.

Werte, die nicht mit ihrer Spalte übereinstimmen

Echte Datenbanken sind unordentlich: eine Adresse im E-Mail-Feld, eine Notiz im Mobilfeld, eine Telefonnummer, die auf einer arabischen Tastatur geschrieben wurde. SAMM prüft jeden Wert daraufhin, was seine Spalte enthalten soll. Alles, was nicht passt, bleibt außerhalb dieses Feldes und wird stattdessen in den nur für Admins sichtbaren Notizen des Abonnenten gespeichert, versehen mit seiner Herkunft — so geht nichts verloren und kein Feld wird verunreinigt. Die Vorschau nennt Ihnen die Anzahl der betroffenen Werte.

Pro Radius Details

Pro Radius exportiert Abonnenten, aber keine Tarife, daher leitet SAMM die Tarife aus der Dienstebene jedes Abonnenten ab und übernimmt die Geschwindigkeit aus dessen Namen (ein Dienst namens „4MBPS“ wird zu einem 4 Mbps Tarif). Drei Dinge sind in dieser Datei schlichtweg nicht enthalten und werden auf sinnvolle Standardwerte gesetzt, die Sie im Anschluss überprüfen sollten:

  • Dauer — auf 1 Monat einstellen. Das tatsächliche Ablaufdatum jedes Abonnenten wird unverändert importiert, sodass dies nur zukünftige Verlängerungen betrifft.
  • Upload-Geschwindigkeit — so einstellen, dass sie mit der Download-Rate übereinstimmt.
  • Preis — auf 0 setzen.
Tarife vor der Rechnungsstellung prüfen Nach einem Pro Radius-Import öffnen Sie Tarife und legen für jeden den tatsächlichen Preis und Zeitraum fest. Bis dahin werden diese Tarife mit null berechnet.

Gut zu wissen

  • Kann sicher mehrfach ausgeführt werden. Beim erneuten Importieren derselben Datei werden bereits vorhandene Personen übersprungen, anstatt sie zu duplizieren.
  • Ihre Lizenz ist weiterhin gültig. Wenn die Datei mehr Teilnehmer enthält, als Ihre Lizenzstufe zulässt, wird dies in der Vorschau direkt angezeigt, zusammen mit der Anzahl der möglichen Teilnehmer — Sie können dann upgraden oder einen Teilimport durchführen.
  • Erstellen Sie zuerst ein Backup, wenn Sie in eine Installation importieren, die bereits produktive Daten enthält.

Abonnenten & Tarife

Tarife & Limits

Ein Tarif ist die Dienstdefinition, die den Abonnenten zugewiesen wird — er legt die Geschwindigkeit, die Limits und den Preis fest. Erstellen Sie Tarife, bevor Sie Benutzer hinzufügen.

Eine Neuinstallation enthält bereits 9 einsatzbereite Tarife — acht monatliche Geschwindigkeitsstufen plus einen „Expired“-Drosselungstarif — sodass Sie sofort mit dem Verkauf beginnen oder eigene Tarife erstellen können. Das Seeding wird nur bei der ersten Installation ausgeführt und überschreibt niemals von Ihnen hinzugefügte Tarife.

Tarif erstellen

  1. Gehen Sie zu Benutzer → Tarife.
  2. Klicken Sie auf Neuen Tarif erstellen.
  3. Füllen Sie das Formular aus und klicken Sie auf Tarif speichern.

Jedes Limit ist ein Schalter — aktivieren Sie nur die, die Sie benötigen. Im selben Modal wird ein bestehender Tarif bearbeitet (⋮-Menü der Zeile öffnen → Bearbeiten).

Tarif-Felder

FeldBedeutung
NameEindeutiger Tarifname, z. B. Home-50M
PreisAbrechnung pro Abrechnungszeitraum bei Nutzung der Rechnungsstellung
Download- / Upload-Geschwindigkeitz. B. 50M, 512K, 1G — wird als MikroTik Rate Limit erzwungen
Gleichzeitige SitzungenWie viele Geräte in diesem Tarif gleichzeitig online sein dürfen. Standardmäßig 1 — ein zweiter Login wird abgelehnt, solange die erste Verbindung noch besteht. Setzen Sie 0 für unbegrenzt. Eine Sitzung, die keine Berichte mehr sendet, wird ignoriert, sodass eine unterbrochene Verbindung den Teilnehmer nie aussperrt
Limit: AblaufdatumDas Abonnement endet nach einem festgelegten Zeitraum nach der Aktivierung (Tage/Monate/Stunden/Minuten)
Limit: KontingentEin Gesamtdatenlimit (kombiniert, nur Download oder nur Upload) für das gesamte Abonnement
Limit: BetriebszeitEine Obergrenze für die kumulierte Verbindungszeit — die Summe aller Sitzungsdauern
Limit: Tägliche NutzungEin Datenlimit, das jeden Tag zur konfigurierten daily-reset Zeit zurückgesetzt wird
Unbegrenztes ZeitfensterSchnelles Hinzufügen eines Speed Windows — der vollständige Editor befindet sich auf der Seite Speed Windows des Tarifs
IP-PoolOptionaler RADIUS Framed-Pool-Name für die Adresszuweisung
Automatische VerlängerungBei Ablauf einen neuen Zeitraum starten, anstatt den Tarif zu wechseln oder die Verbindung zu trennen

Die vier Grenzwerte

Jedes Limit ist unabhängig und optional. Wenn mehrere gesetzt sind, prüft SAMM diese in einer festen Reihenfolge — Ablaufdatum → Quote → Uptime → täglich — und das erste erreichte Limit bestimmt die Aktion.

LimitTracksBei Aufbrauch
AblaufKalenderzeit seit AktivierungZu einem anderen Tarif wechseln oder trennen
KontingentGesamtverbrauch in BytesZu einem anderen Tarif wechseln oder trennen
BetriebszeitKumulierte Sitzungsdauer in SekundenZu einem anderen Tarif wechseln oder trennen
TäglichBytes seit dem letzten täglichen ResetDrosseln — auf von Ihnen eingegebene Geschwindigkeiten oder über einen langsameren Tarif — bis zum nächsten täglichen Reset

Für jedes Limit legen Sie fest, was bei Erschöpfung passiert: Wählen Sie einen nächsten Tarif, auf den der Teilnehmer gewechselt werden soll, oder lassen Sie die Einstellung auf — trennen —. Das tägliche Limit drosselt die Geschwindigkeit, anstatt die Verbindung zu trennen: Standardmäßig geben Sie die Drosselungsgeschwindigkeiten direkt ein (Felder für Download / Upload) oder wählen einen langsameren „nächsten“ Tarif — in beiden Fällen kehrt der Teilnehmer beim nächsten täglichen Reset automatisch zum ursprünglichen Tarif zurück.

Geschwindigkeitsfenster

Ein Speed Window überschreibt die Basisgeschwindigkeit des Tarifs für festgelegte Stunden — zum Beispiel ein Zeitfenster mit unbegrenzter Geschwindigkeit nach Mitternacht. Klicken Sie auf eine Tarifzeile, um den Editor für Speed Windows zu öffnen, der eine Steuerung nach Wochentagen ermöglicht und Zeitfenster unterstützt, die über Mitternacht hinausgehen. Wenn mehrere Fenster übereinstimmen, gewinnt das mit der höchsten Geschwindigkeit.

Hinweis Gedrosselte oder limitierte Abonnenten sind von den Geschwindigkeitsfenstern ausgeschlossen — SAMM erhöht die Geschwindigkeit niemals, solange ein Limit aktiv ist.

Zwei Begriffe der Nutzung

SAMM führt die Nutzung an zwei Stellen und vermischt diese niemals:

  • Zurücksetzbare Zähler — der Status pro Limit. Wird durch einen Reset durch den Administrator sowie durch den täglichen Reset auf Null gesetzt.
  • Abrechnungszähler — nicht zurücksetzbare Gesamtsummen über die gesamte Laufzeit. Diese werden nie auf Null gesetzt, damit Berichte und Rechnungen korrekt bleiben.

Tarife verwalten

Die Liste der Tarife zeigt die Geschwindigkeit, die Anzahl der Abonnenten, die aktiven Limits und die Geschwindigkeitsfenster jedes Tarifs an. Über das ⋮-Menü einer Zeile können Sie den Tarif bearbeiten, dessen Geschwindigkeitsfenster öffnen, ihn aktivieren/deaktivieren, zu seinen Abonnenten springen oder ihn löschen (nur wenn er keine Abonnenten hat). Die Bearbeitung der automatischen Verlängerung bietet die Möglichkeit, die Änderung auf alle aktuellen Abonnenten zu übertragen.

Duplizieren kopiert einen Tarif exakt — Geschwindigkeiten, Limits, Zeitfenster für Geschwindigkeiten und Preis — unter einem neuen Namen. Dies ist wesentlich schneller, als einen Tarif manuell neu zu erstellen, um nur einen Wert zu ändern. Wenn der angegebene Name bereits vergeben ist, wird die nächste freie Nummer verwendet.

Welche Tarife Benutzer sehen

Der Schalter Users can see this plan bei jedem Tarif (auch als Sammelaktion in der Liste der Tarife) legt fest, welche Tarife Benutzer in ihrem Portal sehen und auswählen können. Er ist für jeden Tarif standardmäßig deaktiviert, sodass nichts angezeigt wird, bis Sie eine Auswahl treffen; ein Benutzer sieht immer seinen eigenen Tarif.

Abonnenten & Tarife

Kunden

Ein Abonnent (Kunde / Benutzer) ist ein PPPoE- oder Hotspot-Konto, das sich gegenüber SAMM authentifiziert. Jedem Abonnenten ist genau ein Tarif zugewiesen.

Abonnent erstellen

  1. Gehen Sie zu Users und klicken Sie auf Neuer Kunde.
  2. Füllen Sie das Formular aus und speichern Sie — der Teilnehmer kann sich sofort verbinden.
FeldBedeutung
Benutzername *Der PPPoE / Hotspot-Benutzername — muss eindeutig sein
Passwort *Das Login-Passwort (gespeichert für PAP/CHAP RADIUS-Authentifizierung)
Vorname / NachnameName des Kunden
Mobil / E-Mail / AdresseKontaktdaten — werden für Benachrichtigungen und Rechnungen verwendet
Tarif *Der zuzuweisende Tarif des Dienstes
Ablaufdatum überschreibenOptionales manuelles Ablaufdatum anstelle des berechneten Datums des Tarifs
Automatische VerlängerungTarifzeitraum bei Ablauf automatisch verlängern

Mehrere Abonnenten gleichzeitig erstellen

Neue Batch-Benutzer erstellt eine nummerierte Serie von Konten in einem Durchgang — die übliche Methode, um einen Block von Logins für einen Rollout in einem Dorf, ein Hotel oder für einen Reseller bereitzustellen. Wählen Sie die Anzahl, die Startnummer und die Anzahl der führenden Nullen (3 ergibt 001, 002, …); alle anderen Angaben — Tarif, Ablaufdatum, automatische Verlängerung — werden einmal eingegeben und auf alle angewendet. Sie teilen sich ein Passwort.

Die Rechnungsoption gilt für jeden Benutzer im Stapel separat, sodass bei einem Durchlauf von fünfzig entweder fünfzig Rechnungen oder keine erstellt werden; die Gesamtsumme wird angezeigt, bevor Sie den Vorgang bestätigen.

Die Teilnehmerliste

Die Seite Benutzer listet jeden Abonnenten mit einem Statuspunkt für den schnellen Überblick, dem zugewiesenen Tarif und den verbleibenden Limits auf – tägliche Nutzung mit einem Fortschrittsbalken, verbleibendes Kontingent, verbleibende Betriebszeit und verbleibende Tage. Filtern Sie nach Status (Alle / Aktiv / Suspendiert / Abgelaufen / Online) oder suchen Sie nach Benutzername, Name oder Mobilnummer.

Das Tarifwechsel-Badge Ein einzelnes Abzeichen steht für den Tarif des Abonnenten. Zwei durch einen Pfeil verbundene Abzeichen bedeuten, dass der Abonnent sein tägliches Limit erreicht hat und vorübergehend in einem Drossel-Tarif geparkt ist — beim nächsten täglichen Reset erfolgt die Rückkehr zum ursprünglichen Tarif.

Abonnenten verwalten

Klicken Sie mit der rechten Maustaste auf eine Zeile — oder nutzen Sie das ⋮-Menü —, um Aktionen pro Teilnehmer auszuführen:

AktionFunktionsweise
Anzeigen / BearbeitenÖffnen Sie die Detailseite oder bearbeiten Sie Kontaktdaten, Passwort und Ablaufdatum
Aktivieren / DeaktivierenKonto suspendieren — aktive Abonnenten werden getrennt
Tarif verlängernFügen Sie die Laufzeit des Tarifs zur verbleibenden Zeit hinzu; erstellt eine Rechnung, falls der Tarif einen Preis hat. Eine Tarifauswahl ermöglicht es einem abgelaufenen Benutzer, im selben Schritt zu einem anderen Tarif zu wechseln — lassen Sie die Einstellung auf „Aktuellen Tarif beibehalten“, um wie bisher zu verlängern
Uptime / Quote / Täglich zurücksetzenAusgewählten Limit-Zähler zurücksetzen
VerwendungNutzungsdiagramme und Sitzungsverlauf öffnen
LöschenAbonnenten und dessen gesamte Historie entfernen — aktive Sitzungen werden zuerst getrennt
Wie Aktionen wirksam werden Zurücksetzungen, Tarifänderungen und Verlängerungen werden in einem Audit-Log zwischengespeichert und durch den samm-radius-Tick angewendet — in der Regel innerhalb weniger Sekunden. Wenn der Teilnehmer online ist, sendet SAMM zudem eine Live-Aktualisierung. Siehe CoA & Live-Änderungen.

Die Detailseite kann zudem das Anmeldepasswort des Abonnenten hinter einem Augen-Symbol (mit Ein-Klick-Kopie) anzeigen – praktisch, wenn ein Kunde nach seinen Zugangsdaten fragt.

Die Nutzungsansicht

Die Aktion Usage öffnet eine detaillierte Traffic-Seite für einen Teilnehmer mit einem Zeitraum-Selektor für 7d / 14d / 30d / 90d. Sie zeigt drei Hauptwerte an — den Traffic von heute (mit Aufteilung in Upload/Download und Online-Minuten), den Traffic dieses Monats sowie die kumulierte Online-Zeit für den Monat. Darunter befinden sich ein tägliches Traffic-Diagramm mit Upload gegenüber Download und eine vollständige Tabelle der Sitzungshistorie: Start- und Endzeit, Dauer, Download- und Upload-Bytes, das NAS sowie der Beendigungsgrund jeder Sitzung.

Sammeloperationen

Um den Besitzer, das Ablaufdatum, den Status oder die automatische Verlängerung für viele Abonnenten gleichzeitig zu ändern — oder um viele zu löschen — verwenden Sie die Tools für Massenänderungen und Massenlöschungen. Um Abonnenten massenhaft aus einer Tabellenkalkulation zu erstellen, verwenden Sie Export / Import.

Abonnenten auf bestimmte Router beschränken

Wenn die Einstellung für den Zweigstellen-Login aktiviert ist, meldet sich ein Benutzer über die Router seiner eigenen Zweigstelle, der übergeordneten Zweigstellen und des Hauptquartiers an (siehe Admins, Zweigstellen & Rollen). Über das Bearbeitungsformular können Sie einen Benutzer (oder eine ganze Kartengruppe) weiter auf bestimmte Router eingrenzen: Wenn keine ausgewählt sind, gelten die Router der Zweigstelle; wenn eine oder mehrere ausgewählt sind, wird der Login nur von diesen Routern akzeptiert, was innerhalb von RADIUS erzwungen wird. Eine Änderung der Auswahl trennt jede aktive Sitzung auf einem Router, der nicht mehr zugelassen ist.

Benutzernamen ändern, mit Vorschau erneuern

Benennen Sie einen Benutzer über dessen Seite (die Schaltfläche Username neben Bearbeiten) oder das Menü der Benutzerliste um, nachdem Sie den aktuellen Benutzernamen zur Bestätigung eingegeben haben. Sitzungen, Nutzung und Protokolle werden auf den neuen Namen übertragen, die aktive Sitzung wird getrennt, damit der Router den alten Login vergisst, und der Benutzer wird über den neuen Benutzernamen informiert, sofern Sie dieses Kontrollkästchen nicht deaktivieren. Wenn Sie einen Tarif verlängern oder ändern, wählen Sie aus, ob der neue Zeitraum ab dem Ablaufdatum fortgesetzt wird oder heute beginnt, und prüfen sowie passen Sie das neue Ablaufdatum vor dem Speichern an. Eine Verlängerung kann auch eine Anzahlung berücksichtigen.

Wireless-Verbindung

Für einen Teilnehmer an einem MikroTik Access Point kann die Benutzerseite dessen Funkmodul direkt auslesen: Signalstärke (mit einer einfachen Beschreibung der Qualität), Geschwindigkeit in jeder Richtung, CCQ und Uptime. Es können nur MikroTik-Funkmodule ausgelesen werden.

Benutzerdateien & benutzerdefinierte Felder

Laden Sie Personalausweise, Reisepässe, Verträge und Fotos auf der Detailseite eines Benutzers hoch; Dateien können ohne Download in der Vorschau angezeigt und dem Abonnenten in dessen eigenem Portal unter Files präsentiert werden. Custom fields — einmalig in den Einstellungen definiert — fügen Benutzern, Dateien, Tarifen, Kartengruppen, Tickets und Add-ons zusätzliche Dateneingabefelder hinzu.

Abonnenten & Tarife

Hotspot-Karten

Für den Prepaid-Hotspot-Zugang erstellen Sie eine Charge von Gutscheinkarten anstelle einzelner Benutzer. Jede Karte besteht aus einem Benutzername/Passwort-Paar mit eigenen Geschwindigkeits- und Limit-Einstellungen, die in großen Mengen generiert und zum Verteilen ausgedruckt werden.

Kartengruppe erstellen

  1. Gehen Sie zu Users → Hotspot Cards und klicken Sie auf Gruppe erstellen.
  2. Füllen Sie das folgende Formular aus und klicken Sie auf Gruppe erstellen — SAMM generiert die Zugangsdaten jeder Karte automatisch.
AbschnittFelder
IdentitätEindeutiger Gruppenname, Beschreibung, optionales Benutzernamen-Präfix, Anzahl der zu generierenden Karten (bis zu 10.000)
ZugangsdatenFormat und Länge von Benutzername und Passwort (Zahlen / Buchstaben / alphanumerisch)
BandbreitenbegrenzungDownload- und Upload-Geschwindigkeit — 256k, 6M, 1G; 0 = unbegrenzt
Transfer limitierenUnbegrenzt, kombiniertes Limit oder separate Download/Upload-Limits (MB / GB / TB)
ZeitlimitsUptime-Limit, Ablauf nach erstem Login und ein „Gültig bis“-Datum für eine Gruppe

Die Ablauffrist wird ab dem ersten Login jeder Karte berechnet, während gültig bis ein festes Enddatum ist — danach können die Karten nicht mehr verwendet werden, unabhängig davon, ob sie jemals aktiviert wurden.

Gruppe verwalten

Öffnen Sie das ⋮-Menü einer Gruppe, um alle Karten gleichzeitig zu aktivieren oder zu deaktivieren, das „Gültig bis“-Datum der Gruppe zu verlängern, weitere Karten zum Batch hinzuzufügen oder deren Details zu bearbeiten. Einzelne Karten können auf der Detailseite der Karte zurückgesetzt (Kontingent, Betriebszeit oder Ablaufdatum) oder deaktiviert werden.

Gruppe duplizieren kopiert jede Einstellung exakt und generiert die gleiche Anzahl an Karten mit neuen Codes — ein Kartencode kann immer nur zu einer Karte gehören, daher ist eine Kopie ein neuer Drucklauf und kein Klon der alten. Dies ist der schnellste Weg, um eine ausverkaufte Voucher-Charge nachzubestellen.

Eine Karte hinzufügen oder eine Liste importieren

+ Card in der Kartenliste und auf der Seite einer Gruppe fügt eine Karte mit dem eingegebenen Benutzernamen, Passwort und optionalen Namen hinzu, in eine Gruppe, die Sie aus einer Suchliste wählen. Auf der Seite einer Gruppe übernimmt Import cards eine CSV- oder Excel-Datei (Benutzername, Passwort und optional ein Name); Sie sehen, was hinzugefügt und was übersprungen wird, bevor etwas gespeichert wird.

Kartendesigns

Öffnen Sie Hotspot Cards → Card designs, um die gedruckte Karte zu gestalten: Größe, Hintergrundbild, Ihr Logo und wo Benutzername, Passwort, Preis, Gültigkeit und ein QR-Code stehen. Der QR-Code meldet die Karte mit einem Scan am Hotspot an. Zehn fertige Designs stehen als Ausgangspunkt bereit; bearbeiten, kopieren oder löschen Sie sie wie Ihre eigenen.

Ein Design ist entweder ein A4-Bogen mit Karten (Export) oder ein Thermobeleg mit 80 oder 58 mm für den Schnelldruck. Jede Gruppe hat für beides ihr eigenes Design; eine Gruppe ohne Design druckt die eingebaute Karte, und der Schnelldruck nutzt den fertigen Beleg Thermal Pro.

Kartenstatus

StatusBedeutung
Nicht verwendetGeneriert, aber nie angemeldet
AktivIn Verwendung, innerhalb der Grenzwerte
AufgebrauchtEin Limit (Kontingent, Betriebszeit oder Ablaufdatum) wurde erreicht
DeaktiviertManuell deaktiviert

Drucken & Tracking

Öffnen Sie eine Gruppe, um deren Karten anzuzeigen, drucken Sie diese zur Verteilung als PDF (das Drucklayout verwendet Ihr ISP-Logo aus den Einstellungen) und überprüfen Sie die Nutzung pro Karte. Der Kartenverkehr erscheint ebenfalls in den Reports unter der Registerkarte Karten, und jede Gruppe verfügt über eine eigene Abrechnungsansicht.

Der Router erfährt, was auf jeder Karte übrig ist: Die Hotspot-Statusseite zeigt die verbleibende Zeit und die verbleibenden Daten, und der Router beendet die Sitzung, wenn die Karte aufgebraucht ist.

Abonnenten & Tarife

Self Service — Gäste melden sich selbst an

Das Gegenteil eines Gutscheins: Niemand druckt etwas aus und niemand steht an einem Empfangstresen. Ein Besucher verbindet sich mit Ihrem Hotspot, tippt auf der Anmeldeseite auf Register, gibt seinen Namen und seine Mobilnummer ein, und SAMM sendet ihm einen Passcode per SMS, WhatsApp oder E-Mail. Dieser wird auf derselben Seite eingegeben und der Besucher ist online — und Sie führen ein benanntes, exportierbares Protokoll über alle Personen, die das Gastnetzwerk genutzt haben.

Typische Einsatzorte: Restaurants und Cafés, Hotels und Pensionen, Messen und Ausstellungen, Konferenzen, Einkaufszentren, Kliniken und Wartezimmer, Fitnessstudios, Co-Working-Spaces, Salons, Flughafenlounges, Stadien, Campusse, Bibliotheken, Autohäuser, Hochzeitslocations, Resorts und Campingplätze.

Einschalten

  1. Richten Sie zuerst einen Zustellungskanal ein. Notification Center → SMS oder WhatsApp aktivieren und eine Testnachricht an sich selbst senden. Nichts anderes funktioniert, bis ein Kanal aktiv ist.
  2. Self Service → Settings: Aktivieren Sie Allow guests to register themselves, wählen Sie die anzubietenden Kanäle aus und legen Sie fest, wie lange ein Passcode gültig bleibt und wie lange ein Gast warten muss, bevor er einen weiteren anfordern kann.
  3. Lassen Sie Passcodes come from in der Self Service Gruppenkarte unverändert, sofern Sie keinen Grund für eine Änderung haben — diese Gruppe bestimmt die Geschwindigkeit und wie viele Geräte einen Passcode gemeinsam nutzen dürfen.
  4. Aktivieren Sie die Registerkarte Register für jedes verwendete Login-Design — siehe unten. Dies ist der Schritt, den viele übersehen.

Die Login-Seite — der Schritt, den viele übersehen

Die Registerkarte Registrieren ist pro Login-Design konfiguriert und standardmäßig deaktiviert. Öffnen Sie MikroTik Manager → den Router → Login Page, bearbeiten Sie das verwendete Design und aktivieren Sie Allow Self Service. Sie können jeden Satz, den ein Gast auf demselben Bildschirm sieht, anpassen — die Beschriftung der Registerkarte Registrieren, die Einleitung, die beiden Feldbezeichnungen, die Schaltfläche und die fünf Antworten („Ihr Passcode ist unterwegs“, „Sie besitzen bereits einen“, „Bitte versuchen Sie es später erneut“, „Wir konnten ihn nicht senden“, „Registrierung ist nicht verfügbar“).

Drücken Sie dann Push — und drücken Sie die Taste nach jedem SAMM-Upgrade erneut. Hotspot-Anmeldeseiten befinden sich im eigenen Flash-Speicher des Routers, nicht auf SAMM. Ein Upgrade von SAMM pusht diese nicht erneut, sodass ein Router seine alte Seite — ohne Registerkarte Register — weiterhin bereitstellt, bis Sie diese erneut pushen. SAMM warnt Sie auf der Registerkarte Login Page, wenn ein Router Seiten bereitstellt, die älter als Ihre installierte Version sind, und die Self Service-Seite listet jeden Router auf, der die Registerkarte nicht anzeigen kann, und bietet an, dies für alle gleichzeitig zu beheben.

Regeln zur Missbrauchsprävention

  • Ein aktiver Passcode pro Nummer. Wenn erneut angefragt wird, während ein Code noch gültig ist, wird der Gast aufgefordert, seine Nachrichten zu prüfen, anstatt dass ein weiterer Code gesendet wird.
  • Dann legen Sie eine Wartezeit fest, bevor diese Nummer eine neue anfordern kann.
  • Die Gültigkeit beginnt in dem Moment, in dem der Passcode gesendet wird, nicht erst beim ersten Login — ein Code, der eine Woche lang ungenutzt blieb, ist daher nicht mehr gültig.
  • Ein durch Ihre Lizenz festgelegtes tägliches Limit (siehe unten). Sobald dieses aufgebraucht ist, werden Gäste gebeten, es später erneut zu versuchen; bereits ausgestellte Passcodes bleiben weiterhin gültig.
  • Jeder Versuch wird unter der MAC-Adresse des Geräts aufgezeichnet, so wie der Router sie gemeldet hat — was ein Gast nicht über seinen Browser fälschen kann.

Die Lizenz

Self Service wird separat von Ihrem Tarif lizenziert, basierend auf der Anzahl der Passcodes, die die Installation pro Tag ausgeben darf. Die Verlängerung erfolgt zu einem eigenen Datum — Sie können also den Free-Tarif mit einem kostenpflichtigen Add-on oder den Unlimited-Tarif ohne Add-on nutzen. Jede Installation erhält 10 pro Tag kostenlos; Light erhöht dies auf 50, Heavy auf 200 und Max hebt das Limit auf. Siehe Preise.

Die Self Service-Seite zeigt verbraucht / erlaubt für heute an und gibt deutlich an, wenn das Kontingent aufgebraucht ist. Kaufen oder verlängern Sie über Ihr Dashboard auf securytik.com oder beantragen Sie dies unter System → License, woraufhin ein SecuryTik Administrator die Anfrage genehmigt. Ein Passcode, der nicht zugestellt werden konnte, verbraucht kein Kontingent.

Abonnenten & Tarife

Add-ons & Gutscheine

Ein Add-on ist eine Zusatzoption, die ein Benutzer für eine bestimmte Anzahl von Tagen zusätzlich zu seinem Tarif erwirbt: ein speed boost, unmetered days oder ein night boost für ausgewählte Stunden. Erstellen Sie diese unter Users → Add-ons.

  • Verkaufen Sie ein Add-on über die Benutzerseite, lassen Sie Benutzer es im Benutzerportal oder über den Telegram-Bot kaufen (Bezahlung über die Wallet) oder drucken Sie einmalige voucher codes, die Benutzer im Portal oder im Bot einlösen.
  • Kostenlose Apps: Unmetered aktivieren und Apps nach Kategorie auswählen; nur deren Datenverkehr wird nicht auf die Quote des Benutzers angerechnet. Wenn alle Apps deaktiviert bleiben, ist der gesamte Datenverkehr unmetered. Hierfür ist das Data Log erforderlich.
  • Kindersicherung und VPN: ein Add-on kann für seine Laufzeit die Kindersicherung oder VPN über SAMM einschalten; beide schalten sich am Ende von selbst ab. Legen Sie die Dauer als Wert und Einheit fest (Tage, Wochen oder Kalendermonate).
  • Benutzer sehen ihre aktiven Add-ons und Ablaufdaten auf ihrer Tarif-Seite. Ein einem Benutzer eines Agenten zugewiesenes Add-on wird dem Agenten wie eine Verlängerung in Rechnung gestellt.
  • Jede Zweigstelle kann eigene Add-on-Preise unter Accounting → Price Lists haben.

Rechnungsrabatte

Gewähren Sie einen prozentualen oder festen Rabatt auf eine offene Rechnung unter Angabe eines Grundes, basierend auf der aktuellen Rechnung oder den Rechnungen des Benutzers. Ein dauerhafter Rabatt kann bei den nächsten Verlängerungen des Benutzers wiederholt werden. Jede Rolle hat einen maximalen Rabatt, den sie gewähren darf.

Abonnenten & Tarife

Punkte & Belohnungen

Belohnen Sie treue Benutzer und lassen Sie diese Freunde werben. Punkte sind deaktiviert, bis Sie diese unter Users → Points & rewards aktivieren.

  1. Aktivieren Sie die Punkte und legen Sie für jeden Tarif fest, wie viele Punkte eine bezahlte Verlängerung gewährt und wie viele der einladende Benutzer erhält, wenn ein von ihm geworbener Freund seine erste Rechnung bezahlt.
  2. Belohnungen erstellen: höhere Geschwindigkeit (die Tarif-Geschwindigkeit wird für einige Tage multipliziert) oder kostenlose Tage, jeweils mit einem Preis in Punkten.
  3. Benutzer sehen ihr Guthaben, ihren Einladungslink und die Belohnungen im Benutzerportal und lösen dort Punkte ein. Ein Freund, der den Einladungslink öffnet, hinterlässt seine Daten; Sie erstellen den Benutzer und die Empfehlung wird erfasst.

Punkte werden basierend auf bezahlten Rechnungen berechnet, jeweils einmalig. Wenn eine Rechnung storniert wird, werden die entsprechenden Punkte wieder abgezogen. Sie können Punkte auch manuell hinzufügen oder abziehen sowie die höchsten Guthaben und Beitrittsanfragen auf derselben Seite einsehen.

Abonnenten & Tarife

Kindersicherung

Familien schützen ihre eigene Leitung über das Benutzerportal. Diese Funktion ist für jeden Benutzer deaktiviert, bis Sie sie zulassen: Schalten Sie Parental control im Formular zum Hinzufügen oder Bearbeiten des Benutzers ein (direkt nach Allow Password Change) oder für viele Benutzer gleichzeitig über die Massenaktionen in der Benutzerliste.

Was der Benutzer blockieren kann

  • Kategorien: adult content, Drogen, Glücksspiel, Dating, Gewalt und Hass sowie Proxy- oder VPN-Dienste, die zur Umgehung des Filters genutzt werden. Das Blockieren von adult content aktiviert zudem SafeSearch bei den großen Suchmaschinen und YouTube.
  • Apps und Websites aus demselben Katalog wie Websites & Apps, dargestellt mit ihren offiziellen Logos.
  • Wann: immer oder über einen Wochenkalender (zum Beispiel an Schultagen nach 22:00).
LED am Router SAMM schreibt keine Regeln pro Benutzer. Jeder Router erhält einige gemeinsam genutzte Regeln, und Benutzer werden je nach Beginn und Ende ihrer Zeitpläne diesen zugewiesen oder daraus entfernt, sodass die Auslastung des Routers auch bei vielen Familien niedrig bleibt. Für die App-Blockierung muss der Router von SAMM verwaltet werden (API-Zugriff).

Abonnenten & Tarife

VPN über SAMM

Ausgewählte Benutzer leiten ihren Datenverkehr über Ihren SAMM-Server statt über den eigenen Internetanschluss des Routers. Er läuft durch den Tunnel, den jeder Router ohnehin zu SAMM hat (WireGuard, L2TP/IPsec oder SSTP, siehe VPN), daher muss auf dem Telefon oder Computer des Benutzers nichts installiert werden.

Erlauben

  • Pro Benutzer: schalten Sie VPN über SAMM im Formular zum Anlegen oder Bearbeiten des Benutzers ein, oder für viele Benutzer auf einmal über die Sammelaktionen der Benutzerliste.
  • Als Add-on: unter Benutzer → Add-ons VPN in einem Add-on einschalten und es für eine Anzahl von Tagen, Wochen oder Monaten verkaufen. Es ist für die Laufzeit des Add-ons aktiv und schaltet sich danach von selbst ab.

Was der Benutzer wählt

Berechtigte Benutzer erhalten im Benutzerportal eine VPN-Seite mit drei Optionen:

  • Aus — nichts läuft über das VPN.
  • Gesamter Datenverkehr — jede App und jede Website läuft über das VPN, und auch das DNS des Benutzers.
  • Ausgewählte Apps — nur die Apps und Websites, die der Benutzer aus demselben Katalog wie Webseiten & Apps wählt; alles andere bleibt auf dem lokalen Anschluss.
Wenn der Tunnel ausfällt Benutzer verlieren wegen des VPN nie das Internet: Erreicht der Router SAMM nicht, läuft ihr Datenverkehr über den eigenen Anschluss des Routers, bis der Tunnel wieder steht. Lokale Adressen (Ihr LAN und CGNAT-Bereiche) laufen nie über das VPN. Funktioniert mit RouterOS 6 und 7; der Router muss von SAMM verwaltet werden.

Externes VPN: über einen anderen Anbieter hinaus

Unter System → VPN → External VPN kann SAMM VPN-Benutzer über ein kommerzielles VPN statt über die eigene Leitung hinausleiten, sodass das VPN auch funktioniert, wenn SAMM in Ihrem LAN ohne öffentliche Adresse steht.

  • NordVPN: Fügen Sie ein Zugriffstoken aus Ihrem NordVPN-Konto ein und wählen Sie, wie viele Server geöffnet werden (bis zu 10 pro Konto). SAMM holt den Schlüssel und wählt die Server selbst.
  • Jeder andere Anbieter (ProtonVPN, Mullvad, Surfshark, Ihr eigener Server): Laden Sie seine WireGuard-.conf-Dateien hoch, eine Verbindung pro Datei. Skriptzeilen in einer Datei werden ignoriert und nie ausgeführt.
  • Verbindungen zeigt jede Verbindung live: Status, letzter Handshake, Datenverkehr und Benutzer. Jeder Benutzer bleibt auf einer Verbindung (derselben Ausgangsadresse); eine Gewichtung verteilt die Benutzer auf die Verbindungen.
  • Fällt eine Verbindung aus, gehen ihre Benutzer über die Leitung von SAMM hinaus, bis sie wieder da ist; das Löschen oder Ausschalten einer Verbindung verschiebt ihre Benutzer auf die anderen.
SAMM braucht eine öffentliche Adresse Das VPN ist nur sinnvoll, wenn Ihr SAMM-Server von einem anderen Ort ins Internet geht als die Benutzer, zum Beispiel ein Server in einem Rechenzentrum. Steht SAMM im selben Netz hinter NAT, würde der Verkehr über denselben Anschluss hinausgehen; deshalb zeigen das Benutzerformular und das Add-on-Formular eine Warnung, außer eine externe VPN-Verbindung funktioniert.

Erste Schritte

Richten Sie Ihren Server ein

Sie haben keinen Server? Wir richten einen für Sie ein. Sie bestellen ihn in Ihrem SAMM-Dashboard, bezahlen und erhalten einen fertigen SAMM-Server auf Ihrer eigenen .com-Domain, mit Ihrem Namen darauf. Es ist nichts zu installieren.

Das erhalten Sie

  • Ein Cloud-Server und eine .com-Domain, in drei Größen: 6 Kerne, 12 GB RAM, 200 GB SSD für $100 pro Jahr; 8 Kerne, 24 GB RAM, 300 GB SSD für $200; 12 Kerne, 48 GB RAM, 400 GB SSD für $300. Die Größe wählen Sie im ersten Schritt.
  • HTTPS auf Ihrer Domain; die eigene Adresse des Servers wird nie veröffentlicht.
  • SAMM installiert und mit Ihrem Firmennamen gebrandet, mit Ihrer verknüpften und beim ersten Anmelden aktiven Lizenz.
  • Eine E-Mail mit Ihrer Panel-Adresse (https://your-domain/admin) und einem starken Admin-Passwort.

Jetzt bestellen

  1. Melden Sie sich auf samm.securytik.com an und öffnen Sie Dashboard → Get a server.
  2. Wählen Sie einen Servernamen und die Anzahl der Benutzer, dann suchen Sie nach Ihrer .com-Domain oder wählen Sie einen der Vorschläge.
  3. Bezahlen Sie mit einer der an der Kasse angezeigten Methoden. Die Bestellung wartet zwei Stunden auf die Zahlung; danach wird sie storniert und Sie geben eine neue auf.
  4. Nach der Zahlung läuft alles automatisch. Sobald der Server bereit ist, erhalten Sie die E-Mail mit Ihrer Adresse und Anmeldung.

SSH-Zugang

Unter Dashboard → Servers können Sie Ihre eigene SSH-Anmeldung mit Passwort, öffentlichen Schlüsseln oder beidem anlegen. Eine Schritt-für-Schritt-Anleitung für SSH mit Termius, Windows, Ubuntu und macOS finden Sie auf derselben Seite.

Verlängerung Verlängern Sie spätestens einen Tag vor Jahresende; die Verlängerung öffnet sieben Tage vorher. Wird der Server nicht verlängert, enden der Server, die Domain und die Daten darauf. Halten Sie auch eigene Backups vor.

Abonnenten & Tarife

CGNAT & IP-Pools

Beide finden Sie unter Plans, neben den eigenen Pools des Routers.

CGNAT-Pools

Ein CGNAT-Pool lässt mehrere Benutzer dieselbe öffentliche Adresse teilen. Jeder Benutzer erhält einen festen Portblock auf dieser Adresse, sodass jede Verbindung einem Benutzer zugeordnet werden kann.

  1. Öffnen Sie Plans → CGNAT Pools und legen Sie einen Pool an: die öffentlichen Adressen, wie viele Benutzer sich eine Adresse teilen und wie viele Ports jeder Benutzer erhält.
  2. Die Kapazitätszeile zeigt, wie viele Benutzer hineinpassen, bevor Sie speichern.
  3. Übertragen Sie es auf den Router. SAMM schreibt die NAT-Regeln und führt den Verlauf, welcher Benutzer welche Adresse und Ports hatte; diesen Verlauf liest der Lookup.

IP-Pools

Mit einem IP-Pool vergibt SAMM jedem Benutzer selbst dessen Adresse, pro Router und Tarif, sodass der Router keinen eigenen Adresspool braucht. Die Adresse wird nach Sitzungsende wieder frei. Ist ein Pool voll, übernimmt der eigene Pool des Routers.

Täglicher Betrieb

Datenaufbewahrung & Lookup

Viele Länder verlangen von einem ISP, Verbindungsprotokolle zu speichern und mitzuteilen, welcher Teilnehmer zu einem bestimmten Zeitpunkt eine Adresse genutzt hat. Die Datenaufbewahrung leistet beides. Sie ist ausgeschaltet, bis Sie sie einschalten.

Einschalten

  1. Öffnen Sie System → Settings → Data retention und schalten Sie sie ein.
  2. Legen Sie fest, wie lange Sitzungen gespeichert werden (standardmäßig zwei Jahre). Sitzungen werden für diesen Zeitraum auch dann gespeichert, wenn Sie Benutzer löschen.
  3. Optional können Sie täglich eine verschlüsselte Datei per SFTP, SMB oder NFS an Ihr NAS senden. Öffnen Sie sie mit gpg --decrypt.

Lookup: Wer hat diese Adresse benutzt?

  1. Öffnen Sie Overview → Data Log → Data retention.
  2. Geben Sie die öffentliche Adresse, den Port und die Uhrzeit aus der erhaltenen Anfrage ein.
  3. Geben Sie ein Aktenzeichen ein (SAMM schlägt CASE-1, CASE-2… vor). Das Ergebnis zeigt den Benutzer, die MAC-Adresse, den Router und die Sitzung; es kann durchsucht und exportiert werden.
Lookup-Protokoll Jede Suche wird im Lookup-Protokoll gespeichert, mit Angabe, wer wann gesucht hat und mit dem Aktenzeichen; es lässt sich nicht bearbeiten. Bei CGNAT nutzt der Lookup die Portblöcke Ihrer CGNAT-Pools.

Netzwerk & Router

Andere Router-Marken

Neben MikroTik arbeitet SAMM mit Cisco-, Huawei-, Nokia- und ZTE-Routern als NAS (BNG) zusammen.

  • Fügen Sie den Router hinzu unter Devices → Manager und wählen Sie seinen Typ. Das Formular fragt nach der passenden Anmeldung: die API für MikroTik, SSH für die anderen Marken.
  • Einrichtungsseite: SAMM erzeugt die Konfigurationszeilen für diesen Router, sofort zum Einfügen bereit.
  • Geschwindigkeiten und Trennungen nutzen die RADIUS-Attribute jeder Marke, sodass Tarifänderungen den Router erreichen.
  • Data Log aus den eigenen Verkehrsaufzeichnungen des Routers (NetFlow oder IPFIX).
  • CGNAT auf Cisco: SAMM überträgt die Regeln per SSH, und der Lookup funktioniert wie bei MikroTik. Cisco-Router können sich außerdem per L2TP mit SAMM verbinden.
  • Geräteseite: CPU, Speicher, Temperatur, Betriebszeit und Diagramme, wie bei MikroTik.

Netzwerk & Router

FTTH & OLTs

SAMM liest OLTs von V-SOL, Huawei (SmartAX), ZTE (C300 und C320) und Nokia (ISAM) per SSH aus.

  • FTTH-Seite unter Devices → FTTH: eine Liste der OLTs mit Filtern, Spalten und Export, wie bei Wireless.
  • Jede ONU mit ihrem optischen Signal sowie die ONUs, die auf Hinzufügung warten.
  • ONUs automatisch mit ihren Benutzern verknüpft.
  • Anschlusssperre: SAMM erkennt den Anschluss, über den sich jeder Benutzer verbindet, und kann dessen Anmeldung auf diesen Anschluss beschränken.
  • OLT-Geräteseite: CPU, Speicher, Temperatur, Betriebszeit und Diagramme.

Netzwerk & Router

Router (NAS)

Ein NAS (Network Access Server) ist ein Router, der Abonnenten über RADIUS gegen SAMM authentifiziert. Jeder Router, der Abonnenten-Traffic leitet, benötigt einen NAS-Eintrag.

Router hinzufügen

  1. Gehen Sie zu MikroTik → NAS und klicken Sie auf Router hinzufügen.
  2. Füllen Sie die folgenden Felder aus und speichern Sie.
FeldBedeutung
NAS-IP / HostnameDie Adresse des Routers, wie sie vom SAMM-Host gesehen wird
KurznameEin benutzerfreundliches Label, das in der gesamten UI angezeigt wird
Typmikrotik schaltet die Live-Geräte-Synchronisierung und den Config-Push frei; andere Typen unterstützen nur RADIUS
GeheimnisDas RADIUS shared secret — muss exakt mit dem des Routers übereinstimmen, andernfalls schlägt die Authentifizierung fehl
CoA-PortUDP-Port, an den SAMM Change-of-Authorization-Pakete sendet (MikroTik-Standard 3799)
API Port / Benutzer / PasswortMikroTik API-Zugangsdaten, die SAMM verwendet, um Geräteinfos zu lesen und die Konfiguration zu übertragen
Kein Neustart erforderlich SAMM löst NAS-Clients dynamisch aus der Datenbank auf — das Hinzufügen oder Entfernen eines Routers erfordert keinen Neustart von FreeRADIUS.

Die NAS-Liste

Jeder Router wird in einer Tabelle angezeigt — ID, NAS IP / Hostname, Shortname, Typ, ein maskiertes Secret (Zelle anklicken, um es anzuzeigen), die CoA- und API-Ports sowie ein Live-Ping-Ergebnis mit der Round-Trip-Zeit. Das Suchfeld filtert nach IP, Shortname oder Beschreibung.

Das ⋮-Menü jeder Zeile enthält die routerbezogenen Aktionen — Gerät anzeigen und Infos aktualisieren (nur MikroTik), Bearbeiten, RADIUS-Konfiguration pushen (nur MikroTik) und Löschen. Durch das Öffnen einer Zeile vom Typ mikrotik gelangen Sie direkt zur entsprechenden Geräteseite.

Nachbarn suchen

Klicken Sie auf Discover neighbors, um das Netzwerk nach MikroTik-Geräten zu scannen (über das Neighbor-Discovery-Protokoll von MikroTik) und diese als NAS-Einträge hinzuzufügen, ohne jede Adresse manuell eingeben zu müssen. Ein entdeckter Router kann per IP hinzugefügt oder Auto-added werden — ein Ein-Klick-Bootstrap, der einen SAMM-Management-Benutzer auf dem Router erstellt, eine Management-IP zuweist und die Factory-Bridge löscht.

Auto-Add ist für neue Router gedacht Das One-Click-Bootstrap ist für fabrikneue (oder zurückgesetzte) Geräte gedacht — auf einem Router, der bereits eine Konfiguration besitzt, kann es die bestehenden Einstellungen überschreiben oder beeinträchtigen.

RADIUS-Konfiguration auf den Router übertragen

Für MikroTik NAS-Einträge bietet das ⋮-Menü der Zeile Push RADIUS config — SAMM konfiguriert den Router über die API für Sie, anstatt dass Sie dies manuell eingeben müssen. Sie bestätigen die IP des SAMM-Servers (dieser muss vom Router aus erreichbar sein) sowie die Auth-, Accounting- und CoA-Ports; SAMM erstellt anschließend einen RADIUS-Eintrag auf dem Router oder ersetzt diesen:

EinstellungWert
KommentarSAMM — das Tag, das SAMM verwendet, um diesen Eintrag später zu finden und zu aktualisieren
Diensthotspot, ppp
Adresse / PasswortDer SAMM-Host mit dem Shared Secret aus diesem NAS-Eintrag
Zeitüberschreitung3000 ms
Eingehende CoAAkzeptiert, auf dem von Ihnen bestätigten CoA-Port

Der Dialog zeigt ein Ergebnisprotokoll an, sobald der Push abgeschlossen ist.

MikroTik-Seite konfigurieren

Wenn Sie den Router stattdessen manuell konfigurieren:

  • Fügen Sie einen RADIUS-Server hinzu, der auf den SAMM-Host verweist, mit dem gleichen Shared Secret, aktiviert für PPP / Hotspot.
  • Verwenden Sie den Auth-Port 1812 und den Accounting-Port 1813.
  • Eingehende CoA auf Port 3799 akzeptieren.
  • Setzen Sie das Interim-Update-Intervall für das Accounting auf etwa 5 Minuten (Standardwert des SAMM-Assistenten) — dies ist die Häufigkeit, mit der SAMM die Nutzung summiert und Limits auswertet; kürzere Intervalle verringern die Limit-Latenz auf Kosten von mehr Accounting-Traffic.

Nur-Überwachungs-Geräte

Ein als monitor hinzugefügter Router erscheint im MikroTik-Inventar und wird gepingt sowie synchronisiert, hat jedoch keine RADIUS-Rolle — er kann keine Teilnehmer authentifizieren. Nutzen Sie dies, um Router zu überwachen, die keine Teilnehmer-NAS sind.

SAMM Fallback

Wenn SAMM nicht mehr antwortet, melden die von Ihnen gewählten Router die Teilnehmer eigenständig an — über eine deaktivierte Kopie jedes aktiven Benutzers, die SAMM auf diesen synchron hält. Sobald SAMM wieder verfügbar ist, stellt jeder die Verbindung darüber wieder her. Standardmäßig deaktiviert; pro Router unter Settings → Advanced aktivieren.

Der Fallback schaltet sich nach der von Ihnen festgelegten Verzögerung oder manuell ein, und der Router meldet dies über Telegram. Eine Statustabelle zeigt den Sync-Status jedes Routers, wie viele Benutzer nicht synchronisiert wurden und warum, und markiert Router, deren Backup veraltet ist oder die die Health-Adresse von SAMM nicht erreichen können.

Netzwerk & Router

MikroTik Manager

Wenn ein Router über API-Zugangsdaten verfügt, verwaltet SAMM ihn direkt über die MikroTik API — ohne WinBox, ohne SSH. Der Bereich MikroTik ist ein Live-Inventar aller Router, und jedes Gerät öffnet eine Detailseite mit fünfzehn Registerkarten, mit denen fast jeder Teil von RouterOS direkt im Browser konfiguriert werden kann.

MikroTik Monitor

MikroTik → Monitor zeigt eine Karte pro Router in einer Rasteransicht an. Jede Karte gibt — aktualisiert durch samm-worker und alle 30 Sekunden live abgefragt — den Erreichbarkeitsstatus, die RouterOS-Version, die CPU-Auslastung und Kernanzahl, die Speichernutzung, die Anzahl aktiver Sitzungen, die Betriebszeit sowie den Zeitpunkt der letzten Stichprobe aus.

Eine Karte wird entweder als NAS (ein Router, der Abonnenten auch über RADIUS authentifiziert) oder als Monitor (ein Gerät, das nur zur Überwachung hinzugefügt wurde) gekennzeichnet. MikroTik hinzufügen registriert ein neues Gerät; Jetzt aktualisieren erzwingt eine sofortige Abfrage. Karten nur für die Überwachung verfügen über ein Kontextmenü beim Rechtsklick — Öffnen, Bearbeiten, Informationen aktualisieren, Löschen.

Ubiquiti-Geräte

Beim Hinzufügen eines Monitors wählen Sie dessen Typ: MikroTik, Ubiquiti airOS oder Ubiquiti UniFi access point. Ubiquiti-Geräte werden über SSH mit den eigenen Zugangsdaten des Geräts erreicht; eine Probe-Seite zeigt an, was das Gerät meldet. Ein UniFi access point erscheint in den Wireless- Seiten mit einer Zeile pro Funkmodul — dessen Kanal, Breite und SSIDs, die verbundenen Clients mit Signal, Rauschen und Rate sowie die erkannten benachbarten Netzwerke — und wird im Wi-Fi-Optimizer und Kanalplaner berücksichtigt.

Jeder Tarif erlaubt drei Monitore für jeden Router (ein Tarif mit unbegrenzten Routern bietet unbegrenzte Monitore), sodass die Überwachung Ihrer Access Points niemals Ihr Router-Kontingent aufbraucht.

Auf dem Router gespeicherte Benutzer

SAMM findet die PPP-Logins, Hotspot-Benutzer und User Manager-Benutzer, die ein Router lokal speichert (RouterOS 6 und 7), und listet diese auf der Router-Seite auf. Bevor eine Aktion ausgeführt wird, zeigt jede Zeile an, was SAMM erstellen wird: Benutzername, Passwort, Name, Mobilnummer, Tarif (als „neu“ markiert, wenn SAMM ihn erstellt), Ablaufdatum, Limits, MAC und IP. Namen, Telefonnummern und Enddaten, die in den Router-Kommentaren auf Arabisch oder Englisch stehen, werden ebenfalls ausgelesen. Markieren Sie die Benutzer und importieren Sie diese: Der Vorgang läuft im Hintergrund und die Benutzerliste füllt sich, sobald die Daten eintreffen.

Die Geräteseite — fünfzehn Registerkarten

Öffnen Sie ein beliebiges Gerät, um dessen vollständige Verwaltungsseite aufzurufen. Die Registerkarten sind in vier Gruppen unterteilt.

Monitoring

RegisterkarteAnzeigeinhalt
ÜbersichtGeräteinformationen, Systeminformationen und Diagramme zum Leistungsverlauf (CPU, Speicher, Sitzungen über die Zeit)
SchnittstellenJede Schnittstelle mit ihrem Live-Status sowie dem Traffic-Verlauf pro Schnittstelle
Websites & AppsDrei Unteransichten: Monitor (auf dem Router erkannte Websites & Apps mit Traffic-Historie), QoS (anwendungsbasierte Priorisierung, siehe unten) und App Filter (DNS-basierte Inhaltsblockierung aus dem Katalog)

Manager

Die Registerkarte Manager → General ist die Verwaltungsseite für das Gerät: Identity (der Router-Name), Time (Uhrzeit, Zeitzone und NTP) sowie Tools (Neustart, Ping und andere Router-Aktionen per Klick).

Netzwerkkonfiguration

RegisterkarteWas Sie konfigurieren
BridgeLAN-Bridges erstellen und auswählen, welche physischen Schnittstellen (Ports) zu welcher Bridge gehören
VLANVLAN-Schnittstellen hinzufügen und verwalten
IPDrei Unter-Registerkarten — Static (statische und dynamische Adressen), DHCP client (Adresse vom Upstream beziehen), DHCP server (Adressen zuweisen, mit einer Live-Lease-Tabelle)
DNSDNS-Server und Cache (der Inhaltsfilter für Apps/Standorte befindet sich unter Websites & Apps)
WiFi / CAPsMANWi-Fi-Schnittstellen mit ihren Konfigurationen und Sicherheitsprofilen sowie der CAPsMAN-Controller — Konfigurationen, Provisioning-Regeln und Remote-CAPs

Dienste & Wartung

RegisterkarteWas Sie konfigurieren
PPPoEPPPoE-Server, PPP-Profile, IP-Pools und das RADIUS-Accounting-Interim-Update-Intervall
HotspotHotspot-Server, Hotspot-Profile und Benutzerprofile, DHCP/IP-Pools und die Captive-Portal-Login-Seite
InternetWAN-Uplinks — von SAMM verwaltete WANs und Standard-Routen, wobei alle vorhandenen Nicht-SAMM-WANs schreibgeschützt angezeigt werden
FirewallFilterregeln, eine Router-Sicherheitsanalyse, Konnektivität & Ziele, Sicherheitsmodule und Firewall-Backups — Auto-Security erstellt vor der Anwendung einen Snapshot der Firewall und kann einen zeitgesteuerten Auto-Revert aktivieren, sodass ein Regelsatz, der Sie aussperrt, automatisch zurückgesetzt wird
AktualisierenRouterOS-Updates — Update-Kanal auswählen, prüfen und anwenden sowie installierte Pakete überprüfen
AssistentDie geführte Ersteinrichtung finden Sie unten

Das PPPoE-Interim-Update-Intervall

Auf der Registerkarte PPPoE legt Interim update fest, wie oft der Router RADIUS-Accounting-Interim-Update-Pakete an SAMM sendet. SAMM verwendet diese Pakete, um Byte- und Uptime-Zähler zu summieren sowie das Kontingent, die täglichen Limits und die Uptime-Limits auszuwerten — ohne diese Pakete bleiben die Limit-Durchsetzung und die Live-Sitzungszähler stehen. Der empfohlene Wert ist 5m.

Die Hotspot-Anmeldeseite

Über die Registerkarte Hotspot verwalten Sie die Login-Seite des Captive-Portals: behalten Sie die MikroTik-Standardseiten bei, wenden Sie eine der integrierten Vorlagen an oder wenden Sie eines Ihrer gespeicherten Designs an. SAMM enthält einen visuellen Design-Editor und eine Vorlagengalerie — passen Sie eine Login-Seite an und übertragen Sie diese direkt auf den Hotspot des Routers.

Anwendungsbasiertes QoS

Die QoS-Ansicht (eine Unterregisterkarte von Websites & Apps) wandelt die Apps und Standorte, die SAMM bereits auf dem Router erkennt, in einen Download-Prioritäts-Tarif um. Ziehen Sie jede App aus dem Pool in einen von acht Prioritätsslots — Slot 1 wird bei Engpässen zuerst bedient, Slot 8 zuletzt; Apps, die im Pool verbleiben, werden nicht begrenzt. Optional können Sie die Download-Geschwindigkeit einer App begrenzen (zum Beispiel 10M) und eine gesamte Download-Obergrenze festlegen, um die die Prioritäten konkurrieren. Nach Kategorie automatisch verteilen ordnet alles mit einem Klick an — zuerst Messaging, dann AI-Dienste, dann Stores und alles andere darunter.

Beim Übertragen kompiliert SAMM die Plätze zu einem MikroTik-Queue Tree (markiert mit SAMM:qos, parent=global) mit passenden Packet-Mark-Firewall- Regeln, höchste Priorität zuerst. Er basiert auf demselben Websites-&-App-Filter- Katalog, der auch das Monitoring antreibt, sodass nur tatsächlich auf dem Router erkannte Apps erscheinen — und das Entfernen von SAMM QoS löscht jedes SAMM:qos-Objekt wieder vom Router, ohne Ihre Zähler anzutasten.

Der Einrichtungsassistent

Die Registerkarte Assistent führt Sie in zehn kurzen Schritten durch die gesamte Einrichtung und überträgt die vollständige Konfiguration am Ende in einem Durchgang auf den Router. Es werden keine Daten gesendet, bis Sie den letzten Überprüfungsschritt bestätigen.

  1. Willkommen & Erkennung — SAMM prüft den Router und zeigt an, was bereits konfiguriert ist, sodass Sie diese Punkte beim Push überspringen können.
  2. Bridge-Schnittstelle — Name der LAN-Bridge vergeben.
  3. Bridge ports — wählen Sie aus, welche physischen Schnittstellen der Bridge hinzugefügt werden.
  4. DNS — Upstream-Resolver festlegen (Ein-Klick-Presets für Google, Cloudflare, Quad9 und weitere), Cache-Größe und optional einen DNS-Content-Filter konfigurieren.
  5. NTP — legen Sie die Zeitquelle des Routers fest (NTP-Client und optional Zeitbereitstellung für das LAN).
  6. Internet — einen oder mehrere WAN-Uplinks hinzufügen (Static / DHCP / PPPoE).
  7. RADIUS to SAMM — konfigurieren Sie den Router so, dass er Ihren SAMM-Host für Authentifizierung, Accounting und CoA nutzt.
  8. Services — wählen Sie aus, ob der Assistent einen PPPoE-Server, einen Hotspot-Server oder einen IPoE / DHCP-Dienst erstellen soll, und aktivieren Sie optional IPv6 dual-stack (optional, standardmäßig deaktiviert): wählen Sie die delegierte (DHCPv6-PD) Präfixlänge sowie die IPv6-Blöcke aus, woraufhin der Assistent die Pools erstellt und diese dem PPP-Profil zuweist.
  9. PPPoE / Hotspot-Details & Firewall — Pools, Profile, Lease-Zeiten, die Firewall- & NAT-Regeln sowie ein optionaler Expired pool & internet block, der abgelaufene Abonnenten an die „Abonnement abgelaufen“-Seite von SAMM weiterleitet, anstatt eine tote Verbindung zu hinterlassen.
  10. Überprüfen & übertragen — sehen Sie die genaue Liste der Befehle, die gesendet werden, und übertragen Sie diese dann alle auf den Router.
Die Geschwindigkeit pro Benutzer wird über RADIUS zugewiesen Der Assistent erstellt ein einziges PPPoE / Hotspot-Profil — er überträgt keine profilbasierten Tarife. Die Geschwindigkeit jedes Abonnenten wird von SAMM in der RADIUS-Antwort beim Login übermittelt, sodass Tarifänderungen niemals eine Bearbeitung am Router erfordern.

Netzwerk & Router

Tiefenprüfung

Wenn ein Netz langsam wirkt, tut die Tiefenprüfung, was ein Techniker täte: Sie beobachtet einen Router eine Weile, liest alles, was sie kann, und sagt Ihnen, was falsch ist und was Sie zuerst tun sollten. Sie liest nur: Sie ändert nie etwas am Router, und jede Reparatur bleibt Ihre Entscheidung.

Prüfung starten

  1. Öffnen Sie Devices → Network Health und drücken Sie Tiefenprüfung, oder klicken Sie mit der rechten Maustaste auf einen Router auf der Seite.
  2. Schalten Sie die zu prüfenden Router ein. Alle Schalter starten aus. Nur MikroTik-BNGs mit gespeichertem Login werden angezeigt.
  3. Wählen Sie die Dauer: 15 Minuten, 30 Minuten, 1 Stunde oder 2 Stunden. Ein längerer Lauf ist zuverlässiger; starten Sie ihn zu einer belasteten Zeit.
  4. Drücken Sie Prüfung starten. Sie läuft im Hintergrund, Sie können die Seite also schließen. Pro Router läuft eine Prüfung, höchstens zwei gleichzeitig.

Berichte neben dem Button listet jede Prüfung mit Fortschritt, Ergebnis und Bewertung auf. Sie können eine vorzeitig beenden und behalten, was bis dahin gemessen wurde.

Was geprüft wird

  • Internetleitungen: Verlust und Verzögerung zum Internet und auf jeder Leitung, Spitzen und ob große Pakete durchkommen.
  • Nutzererlebnis: Testnachrichten an eine wechselnde Auswahl online befindlicher Kunden und wie lange die Antworten dauern.
  • Benutzer-Queues und Geschwindigkeit: ob Kunden Daten verlieren, wenn ihr Paket voll ist, Upload und Download sowie Regeln, die Geschwindigkeitslimits umgehen können.
  • Zugangsnetz und Ports: jede Zugangsseite, Funktürme und Geräte hinter dem Router, Port-Fehler, Abbrüche, Geschwindigkeit und Glasfasersignal.
  • Lastverteilung: wie sich die Leitungen den Datenverkehr teilen und ob die Verteilungsregeln vollständig sind und eine ausgefallene Leitung bemerken.
  • Router-Zustand: Prozessorlast und jeder Kern, Speicher, Temperatur, Neustarts, Firmware und das Router-Protokoll.
  • Anmeldungen und RADIUS: rechtzeitige Antworten, abgelehnte Anmeldungen, vorzeitig beendete Sitzungen und Paketgrößen-Einstellungen.
  • Sicherheit: ob der Router zum Internet hin geschlossen ist, Firewall-Reihenfolge, Schutzfunktionen, zusätzliche Dienste und fehlgeschlagene Anmeldungen.
  • Routing: BGP-Sitzungen, OSPF-Nachbarn und tote Routen.

Alle Network-Health-Prüfungen sind enthalten. Eine Prüfung, die nicht gelesen werden konnte, wird aus dem Bericht ausgelassen und nie als gut gezählt.

Der Bericht

Er beginnt mit einer Bewertung von 100 und einem Urteil in einfachen Worten, dann einer Übersicht für jeden Bereich und einer Liste, was zu tun ist, das Wichtigste zuerst. Darunter stehen Details und Zahlen. Er folgt der Sprache Ihres Panels, und Export PDF speichert ihn mit dem SAMM-Logo und „Prepared by SAMM“ auf jeder Seite.

Die Prüfung ist leichtgewichtig und hört auf, Kunden anzupingen, während der Prozessor des Routers sehr ausgelastet ist. Bleibt der Router überlastet, endet sie vorzeitig und sagt das.

System

SCOOP AI

SCOOP AI ist ein Assistent unten auf jeder Admin-Seite. Fragen Sie in eigenen Worten und Ihrer Sprache nach Kunden, Paketen, Karten, Rechnungen, Zahlungen und Routern, und erhalten Sie in Sekunden eine klare Antwort. Er wird automatisch installiert und eingeschaltet.

Eine KI verbinden

Verbinden Sie unter Settings → SCOOP AI Google Gemini (kostenloser Schlüssel), ChatGPT (anmelden, ohne Schlüssel), Claude, OpenAI, OpenRouter oder DeepSeek. Behalten Sie mehrere gespeicherte Anmeldungen und wechseln Sie zwischen ihnen; wählen Sie ein Modell oder lassen Sie es auf Automatisch. Ein Schlüssel, den die KI selbst ablehnt, wird beim Speichern gestoppt, und eine Hilfeseite zeigt, wie man für jede KI einen Schlüssel bekommt.

Was ihn sicher macht

  • Er arbeitet mit den eigenen Rechten jedes Admins: Ein Admin sieht und ändert nur, was seine Rolle erlaubt.
  • Geld, Löschungen und Router-Änderungen werden zurückgehalten, bis Sie Approve drücken.
  • Jede Router-Änderung behält eine Rückgängig-Option auf dem Router selbst und lässt die SAMM-Verbindung zum Router unberührt.
  • Das SCOOP-AI-Protokoll speichert jede Frage, Antwort und Freigabe jedes Admins.

Was Sie ihn tun lassen können

  • Fragen zu Ihren Daten in Ihrer Sprache beantworten.
  • Das Internet nach Prozent auf Ihre Leitungen verteilen, ausgewählte Apps oder ein VPN über eine gewählte Leitung schicken und schnelleres DNS einstellen.
  • Ihnen jeden Montag einen Bericht schicken oder zu einer Uhrzeit erinnern.

Berechtigungen haben einen Block SCOOP AI: nutzen, Protokoll sehen, Einstellungen ändern. Jeder Admin kann ihn für sich selbst über das Robotermenü oder sein Profil ausblenden.

Netzwerk & Router

Netzwerkkarte, Status, Data Log & Verbindungsqualität

Netzwerkplan

Devices → Network Map wird basierend auf den Informationen gezeichnet, die jeder Router über seine Nachbarn meldet — es gibt kein Diagramm, das manuell gepflegt werden muss. Wechseln Sie die Ebenen für Ports, IP-Adressen, Subnetze und CPU oder zeigen Sie den Pfad an, den jedes Gerät zum Internet nimmt. Ziehen Sie Knoten an die gewünschte Stelle und speichern Sie die Anordnung; Discover now liest die Nachbarn erneut aus.

Netzwerkzustand

Devices → Network Health listet alle Router absteigend nach Schweregrad auf: gesund, mit Warnungen, antwortet aber fehlerhaft oder nicht erreichbar. Jeder Befund beschreibt das Problem in einfachen Worten — CoA deaktiviert, RADIUS-Secret stimmt nicht überein, Uhr nicht synchron, Telnet oder FTP offen gelassen. Die Prüfungen lesen den Router nur aus. In der Diagnose-Ansicht eines Routers haben häufige Befunde eine Ein-Klick-Lösung, die zuerst eine Vorschau anzeigt und rückgängig gemacht werden kann. Offene Befunde lösen Warnungen im Alert Center aus.

Für einen längeren Blick auf einen MikroTik-BNG mit vollständigem Bericht verwenden Sie Tiefenprüfung.

Beide Seiten befinden sich hinter einem Schalter, Settings → Advanced → Network Health. Wenn dieser deaktiviert ist, kontaktiert SAMM die Router nicht. Wenn er aktiviert ist, wählen Sie zudem, wie oft jeder Router geprüft wird, wie viele Router pro Durchlauf ausgelesen werden (auslastungsintensive Installationen werden über mehrere Durchläufe verteilt) und ob Nachbarn für die Karte erkannt werden sollen.

Ein Router, der über einen längeren Zeitraum offline ist, kann pausiert werden, sodass er keine Warnungen mehr auslöst, bis er wieder antwortet.

Wi-Fi-Optimizer

Devices → Wireless → Wi-Fi optimizer zeigt für jedes Funkmodul eine Spektrumansicht des genutzten Bandes (Signal in dBm über die Frequenzen, die erkannten Netzwerke und deren Überschneidungen), eine Liste dieser Netzwerke sowie eine Kanaltabelle, die jeden Kanal als Quiet, Busy oder Crowded markiert. Survey now scannt das gesamte Band, wobei jeweils nur ein Funkmodul aktiv ist, sodass ein Standort mit mehreren Sektoren nie alle Clients gleichzeitig verliert; die Schaltfläche zeigt die Dauer an, bevor der Vorgang startet. Live sweep zeichnet die aktuellen, Spitzen- und Durchschnittswerte in Echtzeit auf.

Der Channel Planner empfiehlt den am wenigsten belegten Kanal und die beste Kanalbreite für jedes Funkmodul. Wählen Sie Off, Suggest oder Auto für jedes Funkmodul, separat für dessen Kanal und Breite, oder lassen Sie es seinem Netzwerk folgen; konfigurieren Sie mehrere Funkmodule gleichzeitig über die Wireless-Liste. Bei Auto verschiebt SAMM Funkmodule um 04:00 Uhr nacheinander und scannt jedes Funkmodul auf seinem neuen Kanal erneut. Anwenden verschiebt ein Funkmodul sofort und Rückgängig machen verschiebt es zurück. Dies funktioniert bei MikroTik Funkmodulen (wifi und wireless Pakete, CAPsMAN) sowie bei Ubiquiti UniFi Access Points.

Datenprotokoll

Öffnen Sie einen Benutzer und wählen Sie Data Log, um zu sehen, wohin dessen Traffic fließt: Top-Ziele nach Host und App — YouTube, Facebook, WhatsApp — mit Upload, Download und Verbindungen oder eine Zeitachse. SAMM liest den eigenen Flow-Export (IPFIX) des Routers aus, greift alternativ auf dessen Verbindungstabelle zurück und benennt Apps aus demselben Katalog, den der App Filter verwendet. SAMM befindet sich niemals im Traffic-Pfad.

  • Record user Data Log aktiviert diese Funktion unter Einstellungen → Erweitert → Datenprotokoll.
  • Stündliche Details werden für einige Tage aufbewahrt und anschließend auf eine Zeile pro Standort pro Tag komprimiert — auf etwa ein Vierundzwanzigstel der Größe. Die Seite und der Export lesen beides aus, sodass nichts aus der Ansicht verschwindet.
  • Ziele pro Stunde speichert die am stärksten genutzten Ziele jedes Benutzers pro Stunde und verwirft die Vielzahl an einmaligen Adressen; 0 speichert alles.
  • Retention legt fest, wie lange Zeilen aufbewahrt werden, bevor sie durch die nächtliche Bereinigung gelöscht werden.
  • Ein Backup mit Skip usage schließt das Data Log aus, sodass die Datei klein bleibt.
Deaktiviert, bis Sie es einschalten Ein Superadmin aktiviert das Data Log in den Einstellungen und legt fest, wie lange es aufbewahrt wird. Die Zahlen sind Richtwerte; für die Abrechnung wird immer RADIUS accounting verwendet.

Verbindungsqualität

Während ein Benutzer online ist, kann SAMM alle paar Minuten die Durchschnittsgeschwindigkeit aus den bereits empfangenen Accounting-Daten aufzeichnen sowie Verzögerung und Paketverlust mittels eines kurzen Tests vom Router aus messen. Die Benutzerseite zeigt eine Karte Verbindungsqualität mit den aktuellsten Werten, einen Geschwindigkeitsverlauf im Vergleich zum Tarif und eine Schaltfläche Jetzt testen; die Benutzerliste verfügt über eine optionale Spalte und der Export kann diese Werte enthalten. Der Verlauf wird für zwei Tage gespeichert.

Deaktiviert, bis Sie es einschalten Aktivieren Sie dies unter Settings → Advanced → Connection Quality, wo Sie auch festlegen, wie oft Benutzer abgetastet werden und wie viele Benutzer ein Router pro Runde testet (zuerst diejenigen, die am längsten nicht gemessen wurden). Das Feature ist bewusst ressourcensparend konzipiert: Die Geschwindigkeitsmessung verursacht keinen Router-Traffic und die Testlast auf jedem Router ist begrenzt. Ein Gerät, das den Test blockiert, zeigt keine Antwort, selbst wenn die Leitung in Ordnung ist. Test now funktioniert auch, wenn die Funktion deaktiviert ist.

Netzwerk & Router

CoA & Live-Änderungen

CoA (Change-of-Authorization) ist die Methode, mit der SAMM die Sitzung eines Teilnehmers während der aktiven Verbindung ändert — um dessen Geschwindigkeit zu erhöhen oder zu senken oder die Verbindung zu trennen — ohne auf eine erneute Anmeldung warten zu müssen.

Wie eine Änderung einen aktiven Teilnehmer erreicht

SAMM führt eine Router-Änderung niemals direkt per Klick auf eine Schaltfläche aus. Jede Aktion des Administrators folgt einem sicheren Pfad:

Administrator-Aktion → Audit-Log → samm-radius tick → CoA-Postausgang → Router
  1. Die Aktion wird in einem Audit-Log als queued command aufgezeichnet.
  2. Der samm-radius-Dienst leert die Warteschlange beim nächsten Tick, wendet die Änderung an und stellt — falls der Teilnehmer online ist — ein CoA in die Warteschlange.
  3. Der CoA-Postausgang wird geleert und das Paket an den Router gesendet.

Zeitgesteuerte Ereignisse — Ablauffristen, Grenzen von Geschwindigkeitsfenstern, tägliche Resets — speisen denselben Outbox. Die Obergrenze für die Latenz beträgt einen samm-radius-Tick (standardmäßig 30 s; in den Einstellungen verringern, um eine striktere Durchsetzung zu erreichen).

Hybrid CoA

SAMM sendet zuerst ein CoA-Update, um die Sitzung direkt zu ändern. Wenn der Router dies nach den konfigurierten Wiederholungsversuchen ablehnt, greift SAMM automatisch auf einen Disconnect-Request zurück — der Teilnehmer verbindet sich neu und übernimmt die neuen Einstellungen. Diese Hybrid-Strategie funktioniert über verschiedene MikroTik-Firmware-Versionen hinweg.

Die CoA-Outbox-Seite

Users → CoA Outbox ist die Live-Ansicht dieser Warteschlange. samm-radius ist der einzige Absender — das Administrator-Panel sendet niemals direkt einen CoA — und leert die Warteschlange bei jedem Tick. Die Seite aktualisiert sich automatisch alle 30 Sekunden.

Sechs Zähler befinden sich am Kopf der Seite — Pending, Sent, NACK (retrying), Done, Failed und Total. Filtern Sie die Tabelle nach Status, nach Aktion (update oder disconnect) oder suchen Sie nach Benutzername, NAS IP oder Grund.

StatusBedeutung
ausstehendWarteschlange, wartet auf den nächsten samm-radius Tick
gesendetVersendet (vorübergehend — der Versand und dessen Ergebnis werden im selben Tick aufgezeichnet, sodass Zeilen selten in diesem Zustand verbleiben)
nackDer Router hat das CoA-Update abgelehnt — SAMM versucht es erneut und führt anschließend einen Verbindungsabbruch durch
FertigErfolgreich angewendet
fehlgeschlagenNach Erreichen des Retry-Limits abgebrochen — fahren Sie mit der Maus über das Badge, um den letzten Fehler anzuzeigen

Jede Zeile zeigt den Benutzer, den Router, die Aktion, die Anzahl der Versuche, den Grund sowie die Erstellungs- und Sendezeit an. Zeilenspezifische Aktionen ermöglichen es Ihnen, ein fehlgeschlagenes oder mit NACK beantwortetes Paket zu Wiederholen, ein noch laufendes zu Abbrechen oder die Attribute zu öffnen, um die exakten RADIUS-Attribute des Pakets zu prüfen. Das Badge in der Seitenleiste zählt die ausstehenden Zeilen; das Dashboard verfolgt die Fehler der letzten 24 Stunden. Ein gesundes System hält diese Warteschlange nahezu leer.

Stale-Session-Reaper

Wenn ein Router abstürzt oder die Verbindung verliert, können dessen Accounting-Stop-Pakete verloren gehen — in vielen Systemen bleiben diese Teilnehmer dann dauerhaft „online“. SAMM sucht nach Sitzungen, die keine Interim-Updates mehr senden, und schließt diese automatisch (Beendigungsgrund Reaped-Stale), sodass die Liste der aktiven Sitzungen, die Anzahl der gleichzeitigen Nutzungen und die Nutzungszahlen korrekt bleiben. Das Timeout wird über die Einstellung stale_session_timeout_seconds definiert (Standard 900 s = 15 Minuten; 0 zum Deaktivieren setzen) und wirkt sofort — ein Neustart ist nicht erforderlich.

Täglicher Betrieb

Dashboard & Live-Sessions

Die zwei Ansichten unter Overview sind der Startpunkt jeder Schicht — das Dashboard für den Zustand des gesamten Systems, Live Sessions für die genaue Übersicht, wer gerade verbunden ist.

Zwei Bildschirme: in neuem Fenster öffnen

Jede Seite hat in der oberen Leiste eine Schaltfläche In neuem Fenster öffnen: die Seite öffnet sich allein, ohne Seitenleiste und obere Leiste, bereit für einen zweiten Monitor. Links in diesem Fenster bleiben im selben Modus. Jeder Dashboard-Block hat dieselbe Schaltfläche in seiner Ecke: der Block füllt sein eigenes Fenster und aktualisiert sich weiter mit dem Dashboard, so haben Sie Aktive Sitzungen, den Router-Zustand oder ein Diagramm den ganzen Tag im Blick, ohne Ihr Dashboard-Layout zu ändern.

Dashboard

Overview → Dashboard ist der Startbildschirm für den Betreiber. Ein Zeitraum-Selektor am oberen Rand — Today, 7d, 14d, 30d, 90d — legt das Zeitfenster für das Trenddiagramm und die zeitlich begrenzten Werte fest.

Die sechs KPI-Kacheln

Jede Kachel ist ein Live-Zähler und eine Verknüpfung — klicken Sie darauf, um direkt zur gefilterten Liste hinter der Zahl zu gelangen.

KachelAnzeigenÖffnen
Jetzt onlineAbonnenten mit einer derzeit aktiven RADIUS-SitzungBenutzer nach Online gefiltert
Aktive TeilnehmerAktive Konten, mit der Gesamtzahl der Teilnehmer darunterBenutzer gefiltert nach Active
AbgelaufenAbonnenten, deren Abonnement abgelaufen ist und für die kein nächster Tarif festgelegt wurdeBenutzer nach Expired gefiltert
Offene TicketsNoch nicht gelöste Support-Tickets (ausgenommen erledigt & geschlossen)Benutzer → Support-Tickets
RouterGesamtzahl der NAS-Datensätze, zuzüglich der Anzahl der derzeit nicht erreichbaren DatensätzeDer MikroTik-Monitor
Offene RechnungenRechnungen, bei denen eine Zahlungserinnerung ausstehtRechnungen gefiltert nach Unpaid

Diagramm für Benutzer & aktive Sitzungen

Ein tägliches Snapshot-Liniendiagramm stellt drei Datenreihen über den ausgewählten Zeitraum dar — aktive Benutzer, Online-Sitzungen und abgelaufene Benutzer — sodass Wachstum und Churn auf einen Blick sichtbar sind.

Pipeline-Status

Dieses Panel ist das Herzstück der Enforcement-Engine. In einem gesunden System liegen die Queues bei oder nahe Null — ein dauerhaft hoher Wert deutet auf einen hängenden Dienst oder einen Router hin, der Änderungen ablehnt.

MetrikBedeutung
samm-radius QueueAusstehende CoAs warten auf den nächsten Tick — sollten innerhalb weniger Sekunden bereinigt werden
CoA fehlgeschlagen (24h)Null bei einem einwandfreien System; ein Wert ungleich Null bedeutet, dass ein Router CoAs ablehnt
Audit-Log ausstehendWarteschlange von Administrator-Aktionen, die noch nicht von samm-radius angewendet wurden
Sitzungen gedrosseltAbonnenten, die derzeit durch ein Limit auf eine reduzierte Geschwindigkeit gedrosselt werden — erwartet, kein Fehler
Sitzungs-SnapshotDie Anzahl der Live-Sitzungen — sollte mit Online jetzt übereinstimmen
Aktive TarifeDie Größe Ihres Tarifkatalogs
Der Enforcement-Pfad Administrator-Aktionen werden in samm.audit_log gewartet; der samm-radius-Tick arbeitet diese ab und schreibt CoAs in samm.coa_outbox. Der vollständige Pfad befindet sich unter CoA & live changes.

Tabellen der letzten Aktivitäten

Vier Tabellen unter dem Diagramm bieten eine aktuelle Übersicht der letzten Ereignisse, jeweils mit einem Alle anzeigen-Link zur entsprechenden vollständigen Seite:

  • Aktueller CoA-Postausgang — Aktion, Benutzer, Status (done / pending / nack / failed), Anzahl der Versuche, Grund und Zeit.
  • Kürzliche Administrator-Aktionen — Aktion, Ziel, ausführender Benutzer, Status der Anwendung und Zeitpunkt.
  • Aktuelle Abonnenten — die neuesten Konten mit ihrem Status und dem Zeitpunkt der letzten Authentifizierung.
  • Router — jedes NAS mit einem Statuspunkt für erreichbar / nicht erreichbar / keine Daten.

Aktive Sitzungen

Overview → Live Sessions listet alle Teilnehmer auf, die von den Routern derzeit über RADIUS accounting als online gemeldet werden. Die Seite aktualisiert sich automatisch alle 30 Sekunden; im Header befindet sich eine Schaltfläche zum manuellen Aktualisieren.

Liste filtern

  • Suche — findet Benutzernamen, Framed IP oder NAS IP; die Suche erfolgt während der Eingabe.
  • Router — Liste auf die Sitzungen eines einzelnen NAS einschränken.
  • Nur gedrosselt — zeigt nur die Teilnehmer an, bei denen ein Limit eine reduzierte Geschwindigkeit erzwingt.
  • Pro Seite — 20, 50, 100 oder 200 Zeilen.

Bedeutung der einzelnen Zeilen

SpalteBedeutung
BenutzerBenutzername — verlinkt zur Detailseite des Abonnenten
Framed IPDie vom Router dieser Sitzung zugewiesene Adresse
RouterDer NAS-Kurzname und seine IP-Adresse
TarifAktueller Tarif des Abonnenten
Effektive GeschwindigkeitDie derzeit auf dem Router erzwungene Geschwindigkeit — die Tarif-Geschwindigkeit, angepasst durch ein aktives Speed-Window. Ein throttled-Badge bedeutet, dass ein Limit den Teilnehmer auf eine reduzierte Geschwindigkeit beschränkt.
Down / UpEchtzeit-Byte-Zähler für die Sitzung
OnlineSitzungsdauer
GestartetWenn die Sitzung begann

Sitzung trennen

Die Schaltfläche Disconnect in einer Zeile stellt nach einer Bestätigungsaufforderung einen CoA-Disconnect für genau diese Sitzung (Grund admin_manual) in die Warteschlange. Die Verbindung des Teilnehmers wird sofort getrennt; sofern das Konto noch aktiv ist, kann eine erneute Verbindung hergestellt werden. Verfolgen Sie das Paket im CoA Outbox.

Täglicher Betrieb

Berichte & Analysen

Overview → Reports ist die Analyse-Ansicht — Trends der Teilnehmer, Datenverkehr im Zeitverlauf sowie die aktivsten Benutzer und Karten in Ihrem Netzwerk.

Bereich auswählen

Jede Kennzahl auf der Seite ist an einen Datumsbereich gebunden. Wählen Sie eine Voreinstellung — 7d, 14d, 30d, 90d — oder geben Sie explizite Start- und Enddaten ein und klicken Sie auf Anwenden. Während eine Abfrage über einen langen Zeitraum wie 90d ausgeführt wird, wird die Seite von einem Lade-Overlay überlagert.

Abonnenten- & Session-Trends

Ein Liniendiagramm mit drei Datenreihen über den gewählten Zeitraum: Aktive Abonnenten, Online-Sitzungen und Abgelaufene Abonnenten. Nutzen Sie es, um Wachstum, Churn und die Stoßzeiten Ihres Netzwerks zu erkennen.

Täglicher Datenverkehr

Ein gestapeltes Balkendiagramm der Upload- und Download-Bytes pro Tag. Wenn Sie mit der Maus über einen Tag fahren, werden die Upload- und Download-Werte sowie eine kombinierte Gesamtsumme in der Fußzeile des Tooltips angezeigt.

Top-10-Listen

Vier Tabellen zeigen Ihre Konten mit dem höchsten Datenverkehr an, jeweils sortiert nach dem Volumen in GB:

ListePrioritäten
Top 10 Downloads heuteGrößter Download seit dem letzten täglichen Reset
Top 10 Upload heuteHöchster Upload seit dem letzten täglichen Reset
Top 10 Downloads des MonatsGrößter Download in diesem Kalendermonat
Top 10 Upload des MonatsHöchster Upload in diesem Kalendermonat

Traffic nach Entität

Eine paginierte, durchsuchbare Tabelle des Datenverkehrs pro Konto. Zwei Registerkarten steuern die Anzeige:

  • Benutzer — jeder Abonnent mit seinem Namen, Tarif, dem heutigen Upload/Download in MB sowie dem Upload/Download dieses Monats in GB.
  • Karten — jede Hotspot-Karte mit ihrer Gruppe, ihrem Status und der gleichen Aufteilung des Traffics für heute / Monat.

Das Suchfeld filtert die Tabelle während der Eingabe; der Pro-Seite-Selektor ermöglicht die Auswahl von 20 bis 200 Zeilen. Jede Zeile verlinkt zur Detailseite des entsprechenden Abonnenten oder der Karte.

Exportieren Reports ist eine Analytics-Ansicht auf dem Bildschirm. Um Rohdaten in einer Tabellenkalkulation auszuwerten, verwenden Sie Tools → Export / Import, um Benutzer, Tarife oder NAS als CSV / XLSX herunterzuladen.

Seite Live-Traffic

Eine separate Live-Ansicht des aktuellen Durchsatzes für Benutzer, Router und Schnittstellen, mit einer Aktualisierungsrate von bis zu einer Sekunde. Setzen Sie Lesezeichen für die Kombinationen, die Sie häufig prüfen, damit diese beim nächsten Mal mit einem Klick erreichbar sind.

Täglicher Betrieb

Abrechnung & Fakturierung

SAMM verfügt über ein integriertes, vollständiges System zur doppelten Buchführung — Rechnungen, Ausgaben, Belege, Zahlungen, Reseller, Anlagegüter und vollständige Finanzberichte. Es muss kein separates Abrechnungsprodukt integriert werden und es ist kein Buchhalter erforderlich, um die Bücher korrekt zu führen.

Sie müssen sich nie um Soll und Haben kümmern Jede Aktion — die Erfassung einer Zahlung, das Hinzufügen einer Ausgabe, der Verkauf einer Kartengruppe — erzeugt automatisch einen ausgeglichenen Buchungssatz im Hauptbuch. Sie arbeiten mit einfachen Begriffen (Rechnungen, Ausgaben, Belege); SAMM führt im Hintergrund die doppelte Buchführung und belegt die Ausgeglichenheit in der Summen- und Saldenliste.

Die Seite Accounting ist in elf Registerkarten unterteilt.

Übersicht

Die Finanzübersicht. Vier Hauptkennzahlen befinden sich ganz oben:

AbbildungBedeutung
Verfügbares GuthabenGesamtsaldo aller Kassen- & Bankkonten
Ausstehende ForderungenForderungen — unbezahlte Kunden- und Reseller-Rechnungen
Offener BetragVerbindlichkeiten — offene Ausgaben
Gewinn diesen MonatEinnahmen minus Ausgaben für den aktuellen Monat

Unten: eine Tabelle aller Kassen- & Bankkonten mit ihrem Saldo sowie ein Einnahmen vs. Ausgaben-Diagramm der letzten 1, 2, 3, 6 oder 12 Monate.

Bücher nach Zweigstelle

Jede Rechnung, Zahlung, Ausgabe, jeder Vermögenswert und jedes Kassenkonto ist einer Zweigstelle oder dem Generalunternehmen zugeordnet. Eine Rechnung behält die Zuordnung zu der Zweigstelle bei, in der sich der Benutzer zum Zeitpunkt der Ausstellung befand, auch wenn der Benutzer später wechselt. Ein Branch-Auswähler oben auf jeder Registerkarte zeigt das gesamte Unternehmen, nur das Generalunternehmen oder eine Zweigstelle mit ihren Unterzweigstellen an; zudem können Listen nach Zweigstelle gefiltert, sortiert und gruppiert werden. Ein Administrator einer Zweigstelle mit der Berechtigung Financial sieht nur die Bücher der eigenen Zweigstelle.

Bargeldübergabe: eine Zweigstelle überweist Bargeld von ihrem eigenen Barkonto auf ein Firmenbarkonto; die Erfassung erfolgt, sobald das Unternehmen den Erhalt bestätigt. Reports → Branches stellt die Zweigstellen gegenüber: Umsatz, Ausgaben, Netto, Einzüge, ausstehende Beträge, aktive Benutzer und Umsatz pro Benutzer.

Rechnungen

Eine Rechnung ist ein Beleg, den Sie ausstellen. Klicken Sie auf Neue Rechnung und füllen Sie Folgendes aus:

FeldBedeutung
KundeAuto-Vervollständigung für das zu fakturierende Konto
UmsatzkategorieErtragskonto, auf das der Verkauf gebucht wird
Ausstellungsdatum / FälligkeitsdatumAusstellungsdatum leer = heute; Fälligkeitsdatum leer = Ausstellungsdatum
Steuersatz % / SteuergruppeStandardmäßig wird der Satz in Einstellungen → Abrechnung verwendet; weisen Sie eine Steuergruppe zu, um mehrere Sätze (VAT/GST und weitere) gleichzeitig anzuwenden, wobei jeder auf ein eigenes Steuerkonto gebucht wird
EinzelpostenEine oder mehrere Zeilen für Beschreibung / Menge / Einzelpreis — Zwischensumme, Steuer und Gesamtsumme werden in Echtzeit berechnet

Abrechnungsbetrag — vollständig, segmentiert oder nichts

Wann immer SAMM einen Abonnenten abrechnen will — bei der Aktivierung, Verlängerung, Änderung eines Tarifs, der Verlängerung eines Ablaufdatums oder bei der Durchführung dieser Vorgänge in Masse — erscheint dieselbe Rechnungsauswahl, die den Betrag anzeigt, bevor Sie die Aktion bestätigen:

AuswahlAbrechnungsposten
Vollständige RechnungNur ganze Tarifzeiträume — angebrochene Zeiträume werden auf einen vollen Zeitraum aufgerundet.
Aufgeteilte RechnungDie exakte Zeit unter anteiliger Berechnung des letzten Zeitraums. Die Gesamtsumme wird auf den nächsten ganzzahligen Betrag gerundet, wobei die Differenz als Rundungsanpassung gebucht wird, damit die Buchhaltung ausgeglichen bleibt.
Keine RechnungÄndern Sie den Dienst und berechnen Sie nichts — eine Kulanzverlängerung, eine Migration oder eine Korrektur.

Legen Sie die Dauer mit dem periods multiplier für ganze Tarifzeiträume fest oder geben Sie ein genaues Datum ein, damit SAMM die Kosten berechnet. In beiden Fällen zeigt das Panel die Einzelposten, die Steuer und die Gesamtsumme während der Änderung an, und Paid verbucht sofort eine Barzahlung über den vollen Betrag.

"Keine Rechnung" ist ein Recht, kein Kontrollkästchen Keine Gebühren zu erheben ist eine finanzielle Entscheidung und wird daher über eine rollenspezifische Berechtigung unter Settings → Admins gesteuert. Dies ist besonders wichtig bei Agents: Ein Agent, dessen Abonnenten über ihr eigenes Prepaid-Guthaben abrechnen, könnte andernfalls den ganzen Tag über Tarife erneuern, ändern und Ablaufdaten verlängern, ohne jemals dafür zu bezahlen. Bei neuen Rollen ist diese Berechtigung deaktiviert.

Mahnwesen & Prepaid-Wallet

Über einmalige Rechnungen hinaus automatisiert SAMM den gesamten Inkassozyklus. Ein Mahnplan definiert einen Abrechnungstag, ein Fälligkeitsdatum und einen automatischen Sperrtag — mit optionalen Verzugsgebühren —, sodass überfällige Abonnenten erinnert und anschließend gesperrt werden, ohne dass Sie eine Tabelle im Auge behalten müssen. Ein Prepaid-Wallet-Modus ermöglicht es Abonnenten, ein Guthaben zu führen, das Rechnungen bei Verlängerung automatisch begleicht; sie laden dieses über das Kundenportal per Karte oder Krypto selbst auf, wobei jede Aufladung und jeder Abzug im Hauptbuch verbucht wird.

Grace-Tarife: erst Rechnung, Verlängerung nach Zahlung

Eine gängige Konfiguration ist eine Kette von Tarifen: der kostenpflichtige Tarif läuft in einen kurzen grace-Tarif mit voller Geschwindigkeit über, dann in einen langsamen Tarif, bevor der Benutzer getrennt wird. Aktivieren Sie Erneuerungsrechnung erstellen, wenn ein kostenpflichtiger Tarif in den nächsten Tarif übergeht unter Accounting → Einstellungen, und SAMM erstellt die Erneuerungsrechnung in dem Moment, in dem der Benutzer in den grace-Status wechselt, fällig zum Ende der grace-Phase. Sobald diese bezahlt ist — am Schalter, online oder aus dem Wallet — kehrt der Benutzer zu seinem Tarif zurück, datiert auf den Tag des Ablaufs, sodass sich der Abrechnungstag nie verschiebt. Unbezahlte Benutzer durchlaufen einfach die weitere Kette.

Klicken Sie bei diesen Benutzern nicht auf Tarif erneuern Die Verlängerung des Tarifs stellt den vollständigen Dienst sofort wieder her, unabhängig davon, ob bereits bezahlt wurde. Wenn die Einstellung aktiviert ist, erfolgen die Verlängerung, Rechnung und Zahlung automatisch. Die Einstellung ist deaktiviert, bis Sie diese einschalten.

Rechnungen werden auch automatisch erstellt, wenn der Tarif eines Abonnenten verlängert wird (durch die Aktion Renew Expiration des Benutzers oder per Auto-Renew), sofern der Tarif einen Preis hat. Die Liste lässt sich nach dem Status filtern — unbezahlt, teilweise bezahlt, fällig, bezahlt — und nach Rechnungsnummer oder Kunde durchsuchen. Öffnen Sie eine beliebige Rechnung, um die Detailseite und ein druckbares PDF aufzurufen; Abonnenten können ihre eigenen Kopien über das Kundenportal und den Telegram bot downloaden.

Ausgaben

Eine Ausgabe sind Gelder, die für den Betrieb des ISP aufgewendet werden. Neue Ausgabe erfasst eine Kategorie (das Ausgabenkonto), den bezahlten Hersteller, den Betrag, das Entstehungsdatum und ein optionales Fälligkeitsdatum. Jede Ausgabe durchläuft denselben Lebenszyklus unbezahlt / teilweise bezahlt / fällig / bezahlt wie eine Rechnung und verfügt über eine Detailseite sowie ein druckbares Beleg-PDF.

Belege & Zahlungen

In diesen zwei Registerkarten werden die tatsächlichen Geldflüsse erfasst — unabhängig von der Rechnung oder Ausgabe, die diese verursacht hat.

  • Zahlungseingänge — Geldeingänge in: von einem Kunden, einem Reseller oder aus anderen Einnahmequellen erhaltene Beträge, die auf einem Ihrer Kassenkonten eingehen. Eine Rechnung ist die Forderung; der Zahlungseingang ist das Geld, das daraufhin eingeht.
  • Zahlungen — Geld aus: Zahlungen für eine Ausgabe oder an einen Reseller.

Das Erfassen eines Belegs oder einer Zahlung aktualisiert den Status der zugehörigen Rechnung oder Ausgabe in Richtung bezahlt und bucht den entsprechenden Hauptbucheintrag.

Kunden & Kartenverkauf

Die Registerkarte Customers listet den aktuellen Kontostand jedes Kunden auf — also den Betrag, den diese Ihnen schulden. Card sales umfasst die Einnahmen aus Prepaid-Hotspots: Hier werden verkaufte card groups und resellers nachverfolgt. Ein Reseller kauft ganze card groups per Rechnung von Ihnen und verkauft die einzelnen Karten dann an Endbenutzer weiter; ihr balance owed ist der Betrag, den sie Ihnen noch zahlen müssen.

Agents — Wholesale-Billing

Ein Agent verkauft Ihren Dienst an Endkunden auf Basis eines Prepaid-Großhandelsmodells — ähnlich wie ein Franchisenehmer oder ein Sub-Händler, der einen eigenen Kundenstamm verwaltet, aber Ihr Netzwerk nutzt. Dies ist völlig optional: Wenn Sie keinen Agenten erstellen, funktioniert die Abrechnung genau wie bisher.

Zwei Verbindlichkeiten, sauber getrennt Der Agent schuldet Ihnen den Großhandelspreis (in Ihren Büchern ist dies Ihr Umsatz); der Kunde schuldet dem Agenten den Einzelhandelspreis (außerhalb Ihrer Bücher — die eigene Forderung des Agenten). Ihre Provision ist die Differenz zwischen beiden, gebucht als Handelsrabatt, niemals als Aufwand.

Erstellen Sie einen Agenten unter Einstellungen → Administratoren, indem Sie einem neuen Administrator die integrierte Rolle Agent zuweisen. Ein Agent ist ein eingeschränkter Administrator-Login mit:

EinstellungBedeutung
Provision %Der Anteil des Agenten am Einzelhandelspreis (z. B. 40 % — Sie behalten 60 % als Großhandelsumsatz). Jederzeit pro Agent bearbeitbar.
KreditlimitWie weit das Prepaid-Guthaben des Agenten ins Minus gehen darf, bevor Verlängerungen abgelehnt werden. Für striktes Prepaid 0 eingeben.
Prepaid-GuthabenLaden Sie das Guthaben auf, wenn der Agent Sie bezahlt; bei jeder Verlängerung wird der Großhandelspreis davon abgezogen.

Wenn einer der Abonnenten eines Agents verlängert, belastet SAMM das Guthaben des Agents mit dem Großhandelspreis, verbucht Ihren Umsatz und erstellt eine echte Einzelhandelsrechnung für den Endkunden, die an den Agenten zahlbar ist und nicht in Ihren Büchern erscheint. Agent-seitiges Mahnwesen — ein eigener Schalter unter Einstellungen → Billing, standardmäßig aktiviert, mit einer bearbeitbaren Kulanzfrist — setzt einen nicht zahlenden Kunden automatisch aus (sendet ein CoA-Disconnect); sobald der Agent die Zahlung des Kunden erfasst, wird der Abonnent sofort reaktiviert.

Ein Agent meldet sich in einer eingeschränkten Ansicht an: sein eigenes Dashboard, eine Wallet-Seite Mein Guthaben, eine Liste Meine Kunden mit den Rechnungen und Zahlungen jedes Kunden sowie ein Mein Kontoauszug — alles beschränkt auf seine eigenen Bücher. Ihre unternehmensweiten Bücher, andere Agenten und die Kunden anderer Administratoren bleiben verborgen.

Vermögenswerte & Cash-Konten

  • Assets — registrieren Sie Anlagegüter (Router, Fahrzeuge, Ausrüstung). SAMM verfolgt deren Wert und die Abschreibung im Zeitverlauf.
  • Bargeld — verwalten Sie Ihre Kassen- & Bankkonten sowie Ihre Kapitalkonten: Eigenkapital, wobei eine Einlage Geld ist, das der Eigentümer in das Unternehmen einbringt, und eine Entnahme Geld ist, das entnommen wird. Kapital ist kein Umsatz und erscheint niemals in der Gewinn- & Verlustrechnung.

Berichte — die Finanzberichte

Die Registerkarte Reports ist die Ansicht für den Buchhalter. Fünf Berichte, jeweils mit anpassbarem Zeitraum und exportierbar als PDF:

BerichtAntworten
Gewinn & VerlustEinnahmen gegenüber Ausgaben und Nettogewinn über einen Zeitraum. Periodengerechte Abrechnung — Einnahmen werden bei Rechnungsstellung erfasst, Ausgaben bei Entstehung, nicht beim Geldfluss.
BilanzStichtag: Gegenüberstellung Ihrer Vermögenswerte (Aktiva) und Verbindlichkeiten (Passiva) zuzüglich des Eigenkapitals. Ein balanced-Badge bestätigt, dass beide Seiten übereinstimmen.
CashflowPro Barkonto — Anfangsbestand, Geldeingänge, Geldausgänge, Endbestand über einen Zeitraum.
AgingOffene Forderungen und Verbindlichkeiten, sortiert nach Altersstufen, damit Sie überfällige Rechnungen einfordern und Zahlungsfristen einhalten können.
ErweitertDie Rohbücher: Hauptbuch (jede Zeile auf einem Konto mit laufendem Saldo), Summen- und Saldenliste (die Prüfung des Buchausgleichs), das Journal und ein Aktivitätsprotokoll.
Die Balanced-Check-Prüfung In der Trial Balance müssen die Summen der Soll- und Haben-Spalten jedes Kontos gleich sein — dies ist der Beleg dafür, dass die Bücher korrekt geführt werden. Wenn sie nicht ausgeglichen sind, deutet dies auf einen Buchungsfehler hin, der untersucht werden muss.

Export in Buchhaltungssoftware

Unter Accounting → Reports → Export laden Sie die Bücher als CSV für QuickBooks, Xero oder jede Tabellenkalkulation herunter: General Journal, Chart of Accounts, Invoices, Trial Balance, Profit & Loss und Balance Sheet. General Journal, Invoices und P&L verwenden den Datumsbereich; die übrigen Berichte haben den Stand von heute. Dieselben Daten sind über die API unter GET /api/v1/accounting/export/{kind} (format=json|csv, Scope accounting:read) für BI-Pipelines und Zapier verfügbar. Exporte schließen stornierte Einträge aus, sodass ein Download immer mit den Berichten in der Benutzeroberfläche übereinstimmt.

Täglicher Betrieb

Rückgängig machen & Genehmigungen

Die meisten Fehler in einem ISP-Panel sind finanzielle Fehler: die Verlängerung für den falschen Teilnehmer, eine doppelt erfasste Zahlung oder ein Tarif, der auf dem falschen Konto geändert wurde. SAMM bietet Ihnen ein fünfminütiges Zeitfenster zum Rückgängigmachen dieser Aktionen und — sofern eine Aktion Geld zurückerstattet — eine Genehmigung durch den Superadmin, bevor diese überhaupt wirksam wird.

Das Fenster „Rückgängig machen“

Jede Administrator-Aktion, die Geld oder den Status ändert, wird in Echtzeit aufgezeichnet. Für die nächsten fünf Minuten enthält die Topbar eine Schaltfläche Rückgängig machen und eine Liste Aktionshistorie — klicken Sie auf den Pfeil, um die letzte Aktion rückgängig zu machen, oder öffnen Sie die Historie, um zu einem beliebigen Zeitpunkt innerhalb des Zeitfensters zurückzukehren. Wiederholen macht die Änderung wieder rückgängig.

Warum nur fünf Minuten Ein Rückgängigmachen ist keine Zeitmaschine — es ist ein Sicherheitsnetz für den Klick, den Sie gerade getätigt haben. Nach einigen Minuten hat sich die Situation bereits geändert: der Teilnehmer war online, eine Rechnung wurde bezahlt, jemand anderes hat den Datensatz bearbeitet. SAMM lehnt eine Aktion lieber ab, als stillschweigend die Historie zu überschreiben; daher wird der Schritt einfach aus Ihrer Historie entfernt, wenn das Fenster geschlossen wird.

Ein Rückgängigmachen wird — mit Angabe des Grundes auf dem Bildschirm — verweigert, wenn die Umkehrung etwas löschen würde, das nicht selbst erstellt wurde:

AblehnungBedeutung
Dieser Datensatz existiert nicht mehrDer Abonnent, die Rechnung oder die Zahlung wurde nach Ihrer Aktion gelöscht – es gibt nichts mehr, was wiederhergestellt werden könnte.
Dieser Datensatz existiert bereitsAn seiner Stelle wurde ein neues Element erstellt; ein Rückgängigmachen würde den neueren Datensatz überschreiben.
Dieser Datensatz wurde durch Ihre Aktion geändertJemand anderes hat es in der Zwischenzeit bearbeitet – ein Rückgängigmachen würde deren Änderungen stillschweigend verwerfen.
Dieser Schritt ist nicht mehr in Ihrem Verlauf enthaltenDas Fünf-Minuten-Zeitfenster ist abgelaufen.

Rückgängig machen ist eine Umkehrung, keine Löschung: Sowohl die ursprüngliche Aktion als auch das Rückgängigmachen bleiben im Audit log erhalten, sodass der Verlauf der Ereignisse nie verloren geht. Aktionen, die etwas erstellen, warnen Sie deutlich — das Rückgängigmachen wird die erstellten Elemente löschen — bevor sie ausgeführt werden.

Die Agenten-Genehmigungsinstanz

Ein Agent bezahlt für einen Teilnehmer aus seinem eigenen Prepaid-Guthaben in dem Moment, in dem er diesen aktiviert. Das macht das Rückgängigmachen einer Aktion zu einem Weg, Geld zurückzuerhalten — und zu einer Möglichkeit für Betrug: einen Teilnehmer aktivieren, ihn den ganzen Monat nutzen lassen, ihn dann am letzten Tag löschen und die Gebühr zurückfordern.

SAMM unterteilt die Aktionen eines Agenten daher nach der Art des Geldflusses:

RichtungBeispieleVerhalten
Verursacht Kosten für den Agenten Aktivieren, verlängern, Tarif ändern, Kundenzahlung einziehen Sofort. Das Tagesgeschäft eines Agenten wartet auf niemanden.
Geld zurückerstatten Rückgängig machen, Teilnehmer löschen, Rechnung löschen, Einziehung stornieren Als Anfrage geparkt. Es erfolgt keine Änderung, bis ein Superadmin diese genehmigt.

Gesperrte Aktionen werden nicht teilweise ausgeführt. Die Anfrage wird mit allen für die spätere Ausführung erforderlichen Informationen gespeichert, und eine Genehmigung spielt sie über denselben Code ab, den der Agent ausgeführt hätte — niemals über eine zweite Implementierung, die vom Original abweichen könnte. Eine Ablehnung lässt den Zustand unverändert, und der Agent behält den Auftrag.

Warteschlangen-Management

Anfragen landen unter Accounting → Agents Approval mit dem Agenten, der Aktion, dem Bezugsobjekt und dem zurückzugebenden Betrag — der Zahl, die die Entscheidung bestimmt. Filtern Sie nach Agent oder Status, suchen Sie, markieren Sie mehrere und genehmigen oder lehnen Sie diese gemeinsam ab; eine Ablehnung kann einen kurzen Grund enthalten, den der Agent sieht.

Delegieren Die Überprüfung von Agents den ganzen Tag über ist selten die Aufgabe des Superadmins. Das Recht Agents Approval kann jeder Rolle unter Einstellungen → Administratoren zugewiesen werden, sodass die Person, die die Überprüfung tatsächlich durchführt, genau diese Berechtigung erhält — und nichts anderes. Das Erstellen und Verwalten von Agents bleibt dem Superadmin vorbehalten. Niemand kann über die eigene Anfrage entscheiden.

Was der Agent sieht

Ein Agent erhält eine Seite My Account → Pending Approvals, auf der alle seine Anfragen aufgelistet sind: was noch aussteht und was genehmigt oder abgelehnt wurde — inklusive der Begründung des Prüfers. Ohne diese Information wäre eine Ablehnung nicht von einer verschwundenen Anfrage zu unterscheiden, und der Agent würde die Anfrage einfach erneut stellen.

Sie können ihre eigenen ausstehenden Anfragen zurückziehen — einzeln oder mehrere gleichzeitig — denn eine Anfrage, die man nicht mehr zurücknehmen kann, ist eine Falle. Eine zurückgezogene Anfrage wurde nie ausgeführt, sodass nichts geändert wird; eine entschiedene Anfrage ist abgeschlossen und bleibt bestehen. Eine Rechnung, die auf die Prüfung wartet, wird dies auch auf ihrer eigenen Seite so anzeigen, sodass ein Agent, der auf Löschen geklickt hat und bemerkt, dass nichts passiert, versteht, warum.

Für Ihre Kunden

Online-Zahlungen

SAMM ermöglicht es Ihren Abonnenten, ihre Rechnungen online zu bezahlen — per Bankkarte (Stripe oder PayPal), mit Krypto-Währung (Binance) oder mit Sham Cash in Syrien. Sobald ein Abonnent bezahlt, markiert SAMM die Rechnung als bezahlt, verbucht sie in Ihrer Buchhaltung und — falls der Zugang wegen Nichtzahlung gesperrt war — schaltet ihn automatisch wieder frei. Ihnen entstehen keine Kosten: Jedes Gateway nutzt Ihr eigenes Konto, sodass das Geld direkt an Sie geht.

Aktivieren (beliebiges Gateway)

  1. Öffnen Sie Financial → Online payments (nur Superadmin).
  2. Klicken Sie auf ein Gateway, um es zu erweitern — Stripe, PayPal oder Binance.
  3. Füllen Sie die Felder aus, aktivieren Sie Enable this gateway und klicken Sie auf Save. SAMM lässt Sie nicht speichern, bis die erforderlichen Felder ausgefüllt sind.
  4. Klicken Sie auf Run test, um zu bestätigen, dass Ihre Zugangsdaten funktionieren.
  5. Fertig — Ihre Abonnenten sehen nun eine Bezahlen-Schaltfläche auf ihren unbezahlten Rechnungen im Portal (und auf der Seite „Abonnement abgelaufen“).

Sie können mehr als ein Gateway aktivieren — der Teilnehmer wählt aus, welches er verwenden möchte.

Stripe — Bankkarten, weltweit

  1. Erstellen Sie ein kostenloses Konto bei stripe.com. Lassen Sie den Test mode aktiviert, während Sie die Funktion testen.
  2. Gehen Sie zu Developers → API keys und kopieren Sie den Secret key (dieser beginnt mit sk_).
  3. Erweitern Sie in SAMM Stripe, fügen Sie den Secret key ein, wählen Sie die Währung und das Kassenkonto, auf das die Zahlungen eingehen, und klicken Sie dann auf Speichern und Test ausführen.
  4. Empfohlen: Fügen Sie einen Webhook hinzu, damit Zahlungen zuverlässig bestätigt werden. Gehen Sie in Stripe zu Developers → Webhooks → Add endpoint, legen Sie die URL auf https://YOUR-SAMM/pay/webhook/stripe fest, wählen Sie das Event checkout.session.completed aus und kopieren Sie dann dessen Signing Secret (whsec_…) in das Feld Webhook signing secret von SAMM.
Live-Schaltung Der Testmodus funktioniert überall. Um echte Zahlungen über Stripe zu empfangen, sind ein von Stripe unterstütztes Land und ein verknüpftes Bankkonto erforderlich.

PayPal — Karten & PayPal-Guthaben

  1. Erstellen Sie ein PayPal Business-Konto, erstellen Sie dann unter developer.paypal.com eine REST-App und kopieren Sie deren Client ID und Secret.
  2. Erweitern Sie in SAMM PayPal, fügen Sie die Client ID und das Client secret ein, wählen Sie Sandbox (Testen) oder Live aus und klicken Sie dann auf Speichern und Test ausführen.
  3. Empfohlen: Fügen Sie einen Webhook unter developer.paypal.com → Ihre App → Webhooks hinzu, URL https://YOUR-SAMM/pay/webhook/paypal, abonnieren Sie CHECKOUT.ORDER.APPROVED und PAYMENT.CAPTURE.COMPLETED und fügen Sie dann die Webhook ID in SAMM ein, damit eingehende Benachrichtigungen kryptografisch verifiziert werden.

Binance — Krypto, funktioniert überall, keine Bank erforderlich

Dies ist die beste Option, wenn Karten und PayPal nicht verfügbar sind. Ihre Abonnenten zahlen in Krypto-Währung; SAMM überwacht Ihr Binance-Konto und markiert die Rechnung automatisch als bezahlt. Sie benötigen drei Dinge: einen API Key, ein API Secret und eine Empfangsmöglichkeit — eine Wallet-Adresse und/oder eine Binance Pay ID.

Schritt 1 — schreibgeschützten API-Key erstellen

Sicherheit zuerst Erstellen Sie den Schlüssel mit nur Lesezugriff. Aktivieren Sie niemals Withdraw oder Trade — SAMM muss Ihre eingehenden Zahlungen nur lesen, niemals Gelder bewegen.
  1. Bei Binance anmelden → Account → API Management öffnen (oder nach „API Management“ suchen).
  2. Klicken Sie auf Create API → wählen Sie System generated → benennen Sie diese z. B. "SAMM" → schließen Sie die Sicherheitsprüfung ab.
  3. Binance zeigt den API Key und den Secret Key an — kopieren Sie beide jetzt (der Secret Key wird nur einmal angezeigt).
  4. Klicken Sie auf Edit restrictions und lassen Sie nur „Enable Reading“ aktiviert. Lassen Sie Spot Trading und Withdrawals deaktiviert. (Optional: schränken Sie den Key auf die IP-Adresse Ihres Servers ein.)
  5. Fügen Sie den API Key und das API Secret in die Binance-Karte von SAMM ein (zuerst den Key, dann das Secret — in der gleichen Reihenfolge, wie Binance sie anzeigt).

Schritt 2 — Wallet-Empfangsadresse abrufen

  1. Gehen Sie bei Binance zu Wallet → Spot → Deposit (Deposit Crypto).
  2. Wählen Sie die Coin USDT.
  3. Wählen Sie das Netzwerk — TRC20 ist am günstigsten und am gebräuchlichsten; BEP20 und ERC20 funktionieren ebenfalls. Verwenden Sie dasselbe Netzwerk, das Sie in SAMM auswählen.
  4. Kopieren Sie die Einzahlungs-Adresse und fügen Sie diese in das Feld On-chain receiving wallet address von SAMM ein. Stellen Sie sicher, dass das Network-Dropdown-Menü von SAMM mit dem von Ihnen gewählten Netzwerk übereinstimmt.

Schritt 3 — (optional) Binance Pay ID

Für Abonnenten, die Binance Pay bevorzugen (sofortig, keine Netzwerkgebühr): in der Binance App Pay öffnen und die Pay ID notieren (Ihre E-Mail oder Telefonnummer funktioniert ebenfalls). Diese in das Feld Binance Pay ID von SAMM einfügen. Abonnenten können dann sowohl per Pay ID als auch on-chain bezahlen.

Aktivieren Sie abschließend Enable, klicken Sie auf Speichern und dann auf Test ausführen (hiermit wird geprüft, ob der Schlüssel auf Ihr Konto zugreifen kann). Sie sind nun live.

Genauer Betrag, korrektes Netzwerk Ein Abonnent muss den genauen Betrag, den SAMM anzeigt (die letzten kleinen Ziffern identifizieren seine Rechnung), über das korrekte Netzwerk senden. Ein abweichender Betrag oder das falsche Netzwerk führt zu Verzögerungen oder zum Verlust der Zahlung.

Sham Cash — Syrien

Ihre Benutzer zahlen über ihre Sham Cash App oder die Sham Cash Website, und SAMM wird in dem Moment benachrichtigt, in dem die Zahlung erfolgt ist. Das Geld geht auf Ihr eigenes Sham Cash Geschäftskonto.

  1. Eröffnen Sie ein verifiziertes Sham Cash Geschäftskonto und bitten Sie anschließend den Sham Cash Support, einen elektronischen Zahlungsdienst für Sie einzurichten (dazu werden die Adresse Ihres Logos und der Name abgefragt, den Ihre Benutzer sehen werden).
  2. Sham Cash liefert Ihnen drei Werte: den Agent Key, den Secret Key und die Base URL. Ein Test-Dienst und der produktive Dienst haben jeweils ihre eigenen drei Werte.
  3. Öffnen Sie in SAMM Finanzen → Online-Zahlungen → Sham Cash, lassen Sie Verbindung auf Official API, fügen Sie die drei Werte ein, wählen Sie die Währung (USD oder SYP, dieselbe wie Ihre SAMM-Währung) und klicken Sie auf Speichern, dann auf Test ausführen.
  4. SAMM muss aus dem Internet erreichbar sein, damit Sham Cash jede Zahlung bestätigen kann. Wenn Ihr SAMM unter einer anderen Adresse veröffentlicht ist, geben Sie diese unter Public SAMM address for the callback ein. Auf der Seite von Sham Cash muss hierfür nichts konfiguriert werden: SAMM sendet mit jeder Zahlung seine eigene Adresse.
Test-Dienst oder echter Dienst Mit den test-Werten ist jede Zahlung eine Simulation: Die Zahlungsseite akzeptiert den Code 000000, SAMM zeigt die Rechnung als bezahlt an und es gelangt kein Geld auf ein Konto. Für echte Zahlungen werden die Werte Ihres real-Dienstes vom Sham Cash Support benötigt. Überprüfen Sie die gespeicherte Base URL: Die Test-URL ist nicht die echte URL.

Was der Benutzer tut: Auf der Zahlungskarte drückt er Open Sham Cash. Auf einem Telefon öffnet sich die Sham Cash App (Version 2.2.5 oder neuer), andernfalls die Sham Cash Website; der Benutzer prüft den Betrag und bestätigt diesen mit seinem Überweisungscode (in der Sham Cash App eingerichtet). Auf einem Computer zeigt die Karte zudem einen QR-Code zum Scannen mit der Handykamera. Jeder Zahlungslink ist 10 Minuten lang gültig; die Karte wird automatisch bestätigt, sobald Sham Cash dies tut.

Die eigene App von Sham Cash kann ebenfalls Zahlungen für Sie entgegennehmen: Geben Sie ihr einen Token mit der Berechtigung Payment apps (siehe Abschnitt REST API). Sie sucht einen Benutzer anhand des Benutzernamens und zeichnet die entgegengenommene Zahlung auf.

Sham Cash ohne Händlerschlüssel (Non-official API)

Kein Händlerdienst von Sham Cash? SAMM kann Sham-Cash-Zahlungen über shamcash-api.com annehmen, einen unabhängigen Dienst (nicht Sham Cash), der die Überweisungen auf Ihr eigenes Sham-Cash-Konto liest. Er kann nur lesen: Er kann kein Geld senden.

  1. Erstellen Sie ein Konto bei shamcash-api.com und verknüpfen Sie Ihr Sham-Cash-Konto: Öffnen Sie in der Sham-Cash-App Mein Konto → Verknüpfte Geräte und scannen Sie deren QR-Code. Starten Sie das Abonnement und erstellen Sie einen schreibgeschützten API-Schlüssel.
  2. Öffnen Sie in SAMM Finanzen → Online-Zahlungen → Sham Cash, stellen Sie Verbindung auf Non-official API (shamcash-api.com), fügen Sie den API-Schlüssel ein, wählen Sie die Währung und klicken Sie auf Speichern. SAMM liest Ihre Konto-ID und Ihre Sham-Cash-Adresse aus dem Schlüssel. Dann Test ausführen.

Was der Benutzer tut: die Zahlungskarte zeigt Ihre Sham-Cash-Adresse (und ihren QR-Code), den Betrag und einen kurzen Code wie SM-1234. Der Benutzer sendet den Betrag aus seiner Sham-Cash-App und schreibt den Code in die Überweisungsnotiz. SAMM bestätigt die Zahlung innerhalb einer Minute. Eine Überweisung ohne Code, mit zu geringem Betrag oder in einer anderen Währung wird zur Prüfung zurückgehalten statt verbucht.

Zahlungsseite und Online-Verlängerung

Settings → Billing → Pay page aktiviert eine öffentliche Seite unter /pay: Ein Benutzer gibt seinen Benutzernamen ein, sieht den ausstehenden Betrag und bezahlt, ohne sich anzumelden. Dieselbe Pay page ist im Benutzerportal für angemeldete Benutzer verfügbar.

  • Verlängern: Benutzer können ihren Tarif online für 1 bis 12 Zeiträume verlängern, entweder vor oder nach dem Ablauf. Bei einer Vorauszahlung bleibt die verbleibende Zeit erhalten; ein Benutzer mit abgelaufenem Tarif ist wieder online, sobald die Zahlung eingeht. Zwei Schalter legen fest, wo diese Option angeboten wird: Auf der Bezahlseite verlängern und Im Benutzerportal verlängern (beide standardmäßig aktiviert).
  • Benutzer ohne Präfix oder Suffix finden: Bei Benutzernamen wie 858000@inet wird das Konto durch die Eingabe von 858000 (mindestens 6 Zeichen) gefunden. Wenn mehr als ein Konto übereinstimmt, wird der Benutzer nach dem vollständigen Benutzernamen gefragt. Standardmäßig deaktiviert.
  • Wählen Sie aus, was die Seite über das Konto anzeigen soll (maskierter Name, Tarif, Ablaufdatum und mehr); standardmäßig wird nur der maskierte Name angezeigt.

Ansicht des Teilnehmers

  1. Sie melden sich im Kundenportal an → Meine Rechnungen.
  2. Bei einer unbezahlten Rechnung klicken Sie auf Bezahlen (oder „Pay · Stripe“ / „Pay · Binance“, falls mehrere aktiviert sind).
  3. Karte: Sie werden zur sicheren Seite des Gateways weitergeleitet. Krypto-Währung: Sie sehen den genauen Betrag, Ihre Adresse mit QR-Code und/oder Ihre Pay ID.
  4. Sobald die Rechnung bezahlt wurde, wird sie als Bezahlt markiert, in Ihren Büchern verbucht und falls die Dienste abgelaufen waren, werden sie automatisch wieder aktiviert — abgelaufene Abonnenten erhalten auf der Ablaufseite sogar eine Schaltfläche „Bezahlen & wieder verbinden“.
Ihre Bücher bleiben korrekt Jede Online-Zahlung erzeugt einen ausgeglichenen Doppelbuchungssatz (Dr Cash / Cr Accounts Receivable) und vermerkt die Zahlungsmethode (Stripe / Binance) auf der Rechnung, in der Zahlungshistorie und auf dem PDF — so wissen Sie immer, über welchen Weg jede Zahlung eingegangen ist.

Täglicher Betrieb

Support-Tickets

SAMM verfügt über einen integrierten Helpdesk. Abonnenten können Tickets über das Kundenportal oder den Telegram-Bot erstellen, ein Administrator kann ein Ticket im Namen eines Abonnenten eröffnen, und Ihr Team bearbeitet alle Tickets unter Users → Support Tickets.

Die Ticket-Warteschlange

Die Warteschlange listet jedes Ticket auf — Nummer, Kunde, Betreff, Priorität, Status, das Erstellungs- und das letzte Aktualisierungsdatum sowie die Anzahl der Nachrichten. Filtern Sie diese mit:

  • Status-Chips — einer pro Ticket-Status, jeweils mit einer Echtzeit-Anzahl, sodass die Arbeitslast auf einen Blick sichtbar ist.
  • Priorität — Normal, Mittel oder Kritisch.
  • Aktiv / Zurückgezogen — ein Kunde kann ein Ticket zurückziehen, das er nicht mehr benötigt; zurückgezogene Tickets sind ausgegraut und standardmäßig ausgeblendet.
  • Suche — nach Ticketnummer, Betreff oder Kunde.

Das Badge in der Seitenleiste zählt die offenen Tickets, damit nichts übersehen wird.

Ticket eröffnen

Neues Ticket ermöglicht es einem Administrator, ein Ticket für einen ausgewählten Kunden zu erstellen — wählen Sie den Kunden aus und legen Sie dann Betreff, Priorität und Beschreibung fest. Abonnenten können ihre eigenen Tickets ebenfalls über das Kundenportal oder den Telegram bot eröffnen.

Ticket bearbeiten

Öffnen Sie ein Ticket, um den vollständigen Konversationsverlauf zu lesen. Von dort aus können Sie:

  • Dem Kunden antworten — eine öffentliche Nachricht, die der Abonnent in seinem Portal und über den Telegram-Bot sieht.
  • Interne Notiz hinzufügen — eine nur für Mitarbeiter sichtbare Nachricht, die für den Kunden verborgen bleibt und für Übergabebemerkungen innerhalb Ihres Teams dient.
  • Ändern Sie den Status und die Priorität des Tickets.

Klicken Sie mit der rechten Maustaste auf eine beliebige Zeile — oder verwenden Sie die ⋮-Schaltfläche —, um dieselben Aktionen für Status, Priorität, Antwort und interne Notizen auszuführen, ohne die Queue zu verlassen.

Täglicher Betrieb

Benachrichtigungszentrum

SAMM hält Abonnenten automatisch auf dem Laufenden — per email, Telegram, SMS und WhatsApp — und ermöglicht Ihnen das Versenden von Broadcast-Nachrichten. Der samm-notification Dienst stellt alles über eine gedrosselte Queue zu. Die Seite System → Notification Center verfügt über sechs Registerkarten.

Übersicht

Die Registerkarte Landing — Live-Zähler (in Warteschlange, wird gesendet, heute gesendet, fehlgeschlagen, übersprungen, abgemeldet), der Status jedes Zustellkanals und ein Feed der neuesten Benachrichtigungen.

Kanäle

Konfigurieren Sie, wie Nachrichten SAMM versendet werden. Email verwendet ein eigenes Benachrichtigungskonto, das getrennt vom SMTP für die Passwortwiederherstellung in den Einstellungen verwaltet wird. Telegram verwendet einen Bot-Token, SMS erfolgt über ein generisches HTTP-Gateway oder Twilio und WhatsApp nutzt die offizielle Meta WhatsApp Cloud API (erstellt in Meta for Developers), mit einer optionalen inoffiziellen QR-verknüpften Bridge auf eigene Gefahr — die Bridge wird mit einem Klick auf einem Bare-OS-Server installiert und wird als startbereiter Container auf Docker ausgeliefert. Alle Kanalgeheimnisse werden Fernet-verschlüsselt gespeichert. Jeder Abonnent wählt im Kundenportal aus, welche Kanäle gewünscht sind, oder kann sich vollständig abmelden.

SMS-Gateways können auch im Template-Modus senden, für Anbieter, die nur genehmigte Templates akzeptieren: Sie geben den Template-Namen an und SAMM sendet die Werte in der vom Template erwarteten Reihenfolge. Wählen Sie das vom jeweiligen Gateway gewünschte Nummernformat (international mit + oder 00 oder national mit oder ohne führende 0). Fügen Sie einen funktionierenden Gateway-Link Ihres Anbieters ein und SAMM füllt die Felder, den Template-Modus und das Nummernformat für Sie aus.

Nachrichten

Die Nachrichtenvorlagen, ein Satz pro Ereignis. Bearbeiten Sie den Wortlaut jeder Benachrichtigung — Verlängerungserinnerungen, Belege und weitere — damit jede Nachricht in Ihrem eigenen Stil und in Ihrer Sprache versendet wird.

Regeln & Timer

Diese Registerkarte steuert, wann und wie automatische Benachrichtigungen ausgelöst werden. Für jedes Ereignis legen Sie fest:

  • Ob die Regel aktiviert ist.
  • Opt-out ignorieren — wenn aktiviert, erreicht die Nachricht jeden Abonnenten, auch wenn dieser sich abgemeldet hat. Nur für wichtige Transaktionsnachrichten verwenden.
  • Timing — zum Beispiel, wie viele Tage vor Ablauf eine Erinnerung zur Verlängerung gesendet wird.
  • Zustellung & Drosselung — der Worker leert die Queue mit einem Batch pro Tick; die Batch-Größe und das Tick-Intervall steuern gemeinsam die Geschwindigkeit des Nachrichtenversands, sodass ein großer Broadcast niemals Ihren Mail-Server überlastet.

Die Ereignisse, die SAMM selbst auslösen kann, umfassen die Verlängerungserinnerung (bevor ein Abonnement abläuft), die Ablaufbenachrichtigung (wenn es abläuft), die Kontingentwarnung (wenn ein Datenlimit fast erreicht ist), die Zahlungsbestätigung (wenn eine Zahlung registriert wird) und Tarif verlängert.

Broadcast

Senden Sie eine einmalige Nachricht — ein Wartungsfenster, eine Preisänderung — an eine ausgewählte Gruppe von Abonnenten. Der Broadcast läuft über dieselbe gedrosselte Queue wie die automatischen Benachrichtigungen.

Postausgang

Alle von SAMM in die Warteschlange gestellten oder gesendeten Nachrichten mit ihrem jeweiligen Zustellstatus, sodass Sie bestätigen können, ob eine Benachrichtigung den Abonnenten erreicht hat, oder sehen können, warum dies nicht der Fall war.

System

VPN: WireGuard, L2TP/IPsec, SSTP

SAMM betreibt einen eigenen VPN-Server auf dem SAMM-Host, sodass Router an jedem Ort — hinter NAT, über eine Mobilfunkverbindung, in einer anderen Stadt — SAMM für RADIUS und das Management erreichen. Alles befindet sich unter System → VPN; eine Shell ist nicht erforderlich. Bei Neuinstallationen sind alle drei bereitgestellt, jedoch standardmäßig deaktiviert, bis Sie diese aktivieren.

TypVerwendung für
WireGuardRouterOS 7 Router, Telefone und Laptops. Am schnellsten und einfachsten.
L2TP/IPsecRouterOS 6 und 7 Router sowie Geräte, die kein WireGuard unterstützen.
SSTPZwei oder mehr Router unter RouterOS 6 oder 7, die das Internet über dieselbe öffentliche Adresse erreichen.

Registerkarte Server

  1. Klicken Sie bei WireGuard auf Generate Keys, um das Server-Schlüsselpaar zu erstellen.
  2. Überprüfen Sie den Listen-Port, die Tunnel-Adresse des Servers und den Adressbereich des Clients oder behalten Sie die Standardwerte bei.
  3. Schalten Sie den Server ein. Ein Pop-up bestätigt jede Änderung.

Wenn der SAMM-Host eine private Adresse hat und Ihre öffentliche Adresse an ihn weitergeleitet wird, findet SAMM die öffentliche Adresse (oder Sie geben sie einmal auf der VPN-Seite ein) und gibt sie an jeden Client und Router weiter.

Router mit einem einfügen hinzufügen

Klicken Sie auf Client hinzufügen und geben Sie einen Namen an. Kopieren Sie für einen MikroTik den einzeiligen Installationslink und fügen Sie ihn in das Terminal des Routers ein: Dadurch werden der Tunnel, der eigene SAMM-Login des Routers, dessen RADIUS-Konfiguration und die Seite für abgelaufene Benutzer in einem Schritt eingerichtet. Wählen Sie aus, wie SAMM den Router hinzufügen soll:

  • Managed NAS — der Router authentifiziert Ihre Benutzer über SAMM und SAMM verwaltet den Vorgang.
  • Nur Überwachung — für Access Points und andere Geräte, die Sie beobachten möchten (Status, Karte, die Wireless-Seite), ohne dass sich Benutzer über diese anmelden.

Ein von Mitarbeitern einer Zweigstelle hinzugefügter Router gehört zu deren Zweigstelle. WireGuard-Clients können ebenfalls über eine Konfigurationsdatei oder einen QR-Code für die mobile App hinzugefügt werden. Clients können umbenannt, deaktiviert oder gelöscht werden; ihre Farbe zeigt an, ob sie verbunden, inaktiv oder noch nie gesehen wurden.

Das Regenerieren von Schlüsseln führt zum Datenverlust Regenerate Keys ändert das WireGuard-server-Schlüsselpaar. Jeder bereits eingerichtete Client stellt die Verbindung ein, bis er die neue Konfiguration erhält. Das Panel fordert Sie auf, ein Wort zur Bestätigung einzugeben.

Netzwerk & Router

RouterOS 6 und 7

SAMM verwaltet Router mit RouterOS 6 und RouterOS 7 nebeneinander. Sie müssen nichts anders machen: SAMM liest die Version jedes Routers aus und sendet Befehle, die von dieser Version unterstützt werden.

Alles funktioniert auf beiden: der Assistent, Auto-Complete, die Konfigurationsbereitstellung, Manager-Aktionen, Websites & Apps, QoS, NTP, die Seite für abgelaufene Benutzer sowie die WireGuard (RouterOS 7), L2TP/IPsec und SSTP-Links. Auf RouterOS 6 werden die Listen für Websites & Apps aus den Domainnamen des Katalogs erstellt, da Version 6 keine DNS-Adresslisten besitzt.

Alte Router ohne WireGuard RouterOS 6 verfügt nicht über WireGuard. Binden Sie diese Router über L2TP/IPsec oder SSTP ein.

Netzwerk & Router

Konfigurationsbereitstellung

Jede Änderung, die SAMM an Ihre Router sendet — RADIUS, die Ablaufseite, der Assistent, der DNS-Filter, Websites & Apps, QoS, Auto Security, DNS, NTP und die Kindersicherung — ist eine delivery, die Sie unter Devices → Config delivery verfolgen können.

  • Ein Fortschrittsbalken und das Ergebnis für jeden Router, mit der genauen Begründung, wenn ein Router eine Änderung ablehnt.
  • Ein Router, der offline ist, erhält die Änderung, sobald er wieder online ist; fehlgeschlagene Änderungen werden automatisch wiederholt, und Retry ist nur einen Klick entfernt.
  • Jede Änderung wird nach der Anwendung auf dem Router überprüft, und RADIUS sowie QoS bleiben währenddessen niemals leer.

Netzwerk & Router

Manager-Aktionen auf mehreren Routern

Unter Devices → Manager Router markieren und Actions öffnen, um eine Aufgabe auf allen auszuführen: Websites & Apps pushen, die RADIUS-Konfiguration pushen, die Seite für abgelaufene Benutzer einrichten, Router Security, Backup und Export, RouterOS-Update, ein Skript ausführen oder neu starten.

Jeder Dialog beginnt mit den umfassendsten Einstellungen der ausgewählten Router. Jobs laufen im Hintergrund: Sie können die Seite verlassen, und ein Pop-up informiert Sie, sobald ein Router den Vorgang abgeschlossen hat oder warum dieser fehlgeschlagen ist. Bei riskanten Aktionen werden Sie aufgefordert, ein Wort zur Bestätigung einzugeben. Der Manager zeigt zudem die Zweigstelle jedes Routers an.

Netzwerk & Router

Dynamischer Speed Booster

Während die Internetverbindung eines Routers ungenutzt bleibt, bieten Sie seinen Benutzern kostenlos mehr Geschwindigkeit — und nehmen diese in dem Moment zurück, in dem die Leitung ausgelastet ist. Aktivieren Sie dies unter Tools → Speed Boost → Dynamic (standardmäßig deaktiviert) und wählen Sie die Tarife aus, die beschleunigt werden dürfen.

  • Alle Nutzer an diesem Router erhalten denselben Multiplikator ihrer Download-Geschwindigkeit, standardmäßig bis zu 3-fach.
  • Der Booster lernt die Auslastungszeiten jedes Routers (standardmäßig 3 Tage, wobei die letzten Tage am stärksten gewichtet werden), plant alle 15 Minuten, blickt eine Stunde voraus und erhöht den Boost schrittweise.
  • Ein Guard prüft jede Minute und beendet einen Boost, sobald der Datenverkehr wieder ansteigt. Router, die an den meisten Tagen ausgelastet sind, werden nie geboostet.
  • Benutzer sehen ein Boosted-Abzeichen in ihrem Portal; die Benutzerliste enthält eine Boosted-Spalte und einen Filter.

Täglicher Betrieb

Aktivierungen & Datenprotokoll

Aktivierungen

Overview → Activations zeigt an, welche Tarife in dieser Woche, diesem Monat, diesem Jahr oder zwischen zwei Daten im Vergleich zum vorherigen Zeitraum am häufigsten aktiviert wurden: Verlängerungen, neue Benutzer und Tarifänderungen. Die Listen By plan und By user verfügen über Suche, Filter, Sortierung sowie Excel- oder CSV-Export.

Datenprotokoll

Overview → Data Log durchsucht die Data Logs aller Benutzer gleichzeitig: Finden Sie heraus, wer eine Adresse oder einen Bereich, einen Port, ein Protokoll oder eine App in einem beliebigen Zeitraum erreicht hat. Gruppieren Sie die Ergebnisse, speichern Sie Ansichten und exportieren Sie diese als CSV oder XLSX. Wie lange der Verlauf aufbewahrt wird, können Sie im History cleaner festlegen.

Log akzeptieren

Das Accept Log zeigt an, von welchem Router jeder Anmeldeversuch kam, mit Funktionen für Suche, Gruppierung, Sortierung und Export nach Router.

System

Branding: Ihr Logo, Name und Farbe

Passen Sie SAMM an Ihr Unternehmen an. Alle Einstellungen finden Sie unter System → Settings → ISP.

Ihr Logo

  1. Klicken Sie auf die Logo-Kachel oder Logo hochladen und wählen Sie ein PNG-, JPEG-, WebP- oder GIF-Bild (bis zu 5 MB) aus.
  2. Ziehen Sie das Bild an die gewünschte Position und verwenden Sie den Schieberegler zum Zoomen. Ein transparenter Hintergrund bleibt transparent.
  3. Klicken Sie auf Use logo: Es wird sofort als 400×400 px großes Quadrat gespeichert. Remove entfernt es.

Das Logo wird auf Rechnungen, Quittungen, gedruckten Hotspot-Karten, der Seite für abgelaufene Sitzungen und den Login-Seiten verwendet, die Ihre Router anzeigen.

Branding in den Panels

Aktivieren Sie Use my brand on the panels und legen Sie den Namen, die Farbe und eine Fußzeile fest (zum Beispiel Ihre Support-Nummer), drücken Sie dann auf der Registerkarte ISP Save. Ihr Branding ersetzt daraufhin das von SAMM im Administrator-Panel, im Benutzerportal und auf beiden Anmeldeseiten. Deaktivieren Sie die Option, und alles sieht wieder wie gewohnt aus.

System

Cloudflare Tunnel

Ein Cloudflare Zero Trust Tunnel veröffentlicht SAMM im öffentlichen Internet ohne das Öffnen von Firewall-Ports — nützlich, wenn der SAMM-Host hinter NAT steht. Er wird unter System → Cloudflare Tunnel verwaltet.

Dienststatus

Die Seite öffnet sich mit einer Statuskarte, die den Zustand des Connectors anzeigt:

StatusBedeutung
AktivDer Tunnel ist aktiv und leitet Datenverkehr weiter
GestopptKonfiguriert, aber derzeit nicht aktiv
Nicht konfiguriertDie Binärdatei ist vorhanden — Token einfügen, um sie zu konfigurieren
Nicht installiertinstall.sh erneut ausführen, um die cloudflared-Binärdatei zu installieren

Es zeigt außerdem die cloudflared Version an und ob der Connector so eingestellt ist, dass er beim Booten automatisch startet.

Tunnel konfigurieren

  1. Im Cloudflare Zero Trust Dashboard (one.dash.cloudflare.com) öffnen Sie Networks → Tunnels und wählen Sie Tunnel erstellen.
  2. Wählen Sie den Cloudflared-Connector, benennen Sie den Tunnel und speichern Sie. Kopieren Sie im Installationsschritt nur den Token — die lange Zeichenfolge nach --token.
  3. Fügen Sie es in SAMM ein und klicken Sie auf Tunnel konfigurieren. SAMM übergibt das Token an cloudflared und startet den Connector.
  4. Fügen Sie in Cloudflare einen Public hostname hinzu: Ihre gewählte Adresse, Typ HTTP, URL localhost:80 (via nginx proxied — empfohlen) oder localhost:8000 (direkt zur API).

Innerhalb weniger Sekunden wird das Status-Badge grün und SAMM ist über den öffentlichen Hostnamen erreichbar. Nach der Konfiguration ermöglichen Ein-Klick-Aktionen, den Connector zu Starten, zu Stoppen oder Neustarten, den Token zu ersetzen, um ihn zu rotieren, oder den Tunnel zu entfernen (eine Aktion mit Bestätigungstyp REMOVE).

Keine offenen Ports, Token wurde nie in der Datenbank gespeichert Der Tunnel stellt eine ausgehende Verbindung zum Cloudflare Edge her — es wird kein Firewall-Port auf dem Server geöffnet. Der Token wird an cloudflared weitergeleitet und unter /etc/cloudflared/ gespeichert; SAMM speichert ihn niemals dauerhaft in der Datenbank. TLS wird am Cloudflare Edge terminiert, sodass SAMM selbst einfaches HTTP auf dem Loopback nutzt.

System

Einstellungen

System → Settings enthält die live anpassbaren und im laufenden Betrieb aktualisierbaren Einstellungen. Die Daemons lesen diese beim nächsten Zyklus erneut ein — ein Neustart des Dienstes ist nicht erforderlich. Die Einstellungen sind in Registerkarten organisiert.

Allgemeine Parameter

EinstellungStandardSteuerung
samm-radius interval30 sIntervall für die Auswertung zeitgesteuerter Ereignisse und das Senden von CoAs
samm-worker interval5 sRouter-Ping + MikroTik API Sync-Intervall
Interim-Abrechnungsintervall60 sDas an die Router übermittelte Accounting-Intervall
Tägliche Reset-Zeit00:00Wenn tägliche Nutzungszähler überlaufen
Server-ZeitzoneUTCZeitzone für Geschwindigkeitsfenster und den täglichen Reset
CoA Standard-Port3799Standard-UDP-Port für CoA-Pakete
Maximal CoA-Wiederholungen3Wiederholungsversuche vor dem Disconnect-Request-Fallback

Verringern Sie das samm-radius-Intervall für eine striktere Durchsetzung; erhöhen Sie es, um die Last zu reduzieren.

ISP-Identität, Logo, Währung & Abrechnung (die Registerkarte ISP)

Alles, was die meisten Betreiber mit der Frage „Wo ändere ich das?“ suchen, befindet sich unter System → Settings → ISP. Bearbeiten Sie ein Feld und klicken Sie auf Speichern — die Änderung ist sofort aktiv (kein Neustart erforderlich) und wird in Rechnungen, Belegen, PDFs und dem Kundenportal übernommen.

ÄnderungenWo es angezeigt wird
ISP-NameRechnungen, Belege, Hotspot-Karten, Portal-Header
Support-Telefon & E-MailRechnungen und gedruckte Hotspot-Karten
Steuer- / RegisternummerAuf Rechnungen ausdrucken
ISP-Logo (Upload PNG/JPEG/WebP/GIF)Uploaden Sie das Bild, ziehen und zoomen Sie dann im Browser, um es zuzuschneiden; es erscheint auf Rechnungs-/Quittungs-PDFs, gedruckten Hotspot-Karten und Router-Login-Seiten. Siehe Branding.
Währungscode (e.g. USD)Die ISO-Währung auf Rechnungen und im Hauptbuch
Währungssymbol (e.g. $)Alle im Administrator-UI, Kundenportal und in PDFs angezeigten Beträge
Steuer an/aus, Bezeichnung & SatzFügt Rechnungen eine VAT/GST-Zeile hinzu (z. B. Bezeichnung VAT, Satz 11 = 11%)
Währungssymbol ändern Um die überall angezeigte Währung zu ändern (z. B. von $ auf £ oder ein lokales Symbol), legen Sie auf der ISP-Registerkarte das Währungssymbol fest und klicken Sie auf Speichern — dies aktualisiert das Administrator-Panel, das Kundenportal und alle PDFs gleichzeitig. Legen Sie daneben den Währungscode (USD, EUR, …) für den auf den Rechnungen gedruckten ISO-Code fest.

Datenschutz — anonyme Installationsstatistiken

Wenn SAMM nach Updates sucht, kann es eine zufällige Installations-ID, die SAMM-Version, Ihren Tarif und das ungefähre Land (basierend auf Ihrer IP, via Cloudflare) an SecuryTik senden — keine Abonnenten- oder Kundendaten. Dies hilft uns lediglich dabei, aktive Installationen zu zählen sowie Support und Sprachen zu priorisieren. Sie können dies jederzeit unter System → Einstellungen → Datenschutz deaktivieren; siehe die Datenschutzerklärung.

Registerkarte E-Mail

Konfigurieren Sie den SMTP-Server, der für Passwort-Wiederherstellungscodes an Administratoren und Kunden verwendet wird (Host, Port, SSL/STARTTLS, Benutzername, Absenderadresse, Passwort). Klicken Sie auf Verbindung testen, um die Anmeldedaten zu überprüfen, ohne eine E-Mail zu senden.

Zwei E-Mail-Konten Die Registerkarte Email hier dient nur für OTP / Passwortwiederherstellung. Das für den Kunden Benachrichtigungen verwendete Konto wird separat in Benachrichtigungszentrum konfiguriert.

System

Administratoren, Zweigstellen & Rollen

Unter System → Admins legen Sie fest, wer sich im Administrator-Portal anmelden kann, was die einzelnen Personen tun dürfen und welche Benutzer sie sehen können. Seit Version 5.1.0 bilden die Administratoren eine Hierarchie aus Zweigstellen und Personal. Die Seite verfügt über zwei Registerkarten: Admins und Roles.

Zweigstellen und Personal

KnotenBeschreibung
ZweigstelleEin Ort — ein Büro, eine Stadt. Er umfasst die darin erstellten Benutzer. Niemand meldet sich als Zweigstelle an: sie hat kein Passwort und keine Rolle.
Administrator (Personal)Eine Person, die sich anmeldet. Wenn sie einer Zweigstelle zugeordnet ist, gehört sie zu deren Personal: Jeder Benutzer und jede Karte, die sie erstellt, gehört zu dieser Zweigstelle.
SuperadminImmer an der Spitze des Baums, niemals unter einer Zweigstelle. Sieht und kann alles tun.

Verwenden Sie + Branch und + Admin, um den Baum aufzubauen, und ziehen Sie einen Knoten auf einen anderen, um ihn zu verschieben. Nur eine Zweigstelle kann Administratoren unter sich haben. Ein Agent ist ein Administrator, der verkauft und das Eigentum an den Verkäufen besitzt; Mitarbeiter, die einem Agenten unterstellt sind, nutzen das Wallet und die Genehmigungsregeln des Agenten.

Wer sieht was

Die Sichtbarkeit folgt der Baumstruktur. Eine Zweigstelle — und alle darin tätigen Personen — sieht ihre eigenen Benutzer und die Benutzer der darunter liegenden Zweigstellen. Eine gleichrangige Zweigstelle oder die übergeordnete Zweigstelle sind niemals sichtbar. HQ sieht alles. Die Berechtigungen eines Administrators übersteigen niemals das, was die übergeordneten Administratoren zulassen, und ein Administrator kann nur Berechtigungen vergeben, die er selbst besitzt.

Limits pro Zweigstelle

LimitWas gezählt wird
Maximale BenutzerzahlWie viele Benutzer die Zweigstelle und die darunter liegenden Zweigstellen aufnehmen dürfen. Das Löschen eines Benutzers macht einen Platz frei.
Maximale KartenWie viele Hotspot-Karten in der Zweigstelle gedruckt werden dürfen.

Ein neuer Benutzer oder eine neue Karte wird abgelehnt, wenn ein Limit auf oder über der Ebene des erstellenden Administrators erreicht wird; die Meldung gibt an, welches Limit betroffen ist und wie viel noch übrig ist. Lassen Sie ein Limit leer, wenn kein Limit gelten soll. Beides kann später im Dialog Bearbeiten geändert werden.

Geräte einer Zweigstelle

Jeder Router, einschließlich Access Points, gehört zu einer Zweigstelle oder zum Headquarters. Öffnen Sie das Menü einer Zweigstelle und wählen Sie Assigned devices, um die dazugehörigen Geräte zu markieren; ein nicht markiertes Gerät kehrt zum Headquarters zurück, das von jeder Zweigstelle gemeinsam genutzt wird. Ein von Mitarbeitern einer Zweigstelle hinzugefügtes Gerät (über den Manager, das Monitor-Formular oder einen VPN-Installationslink) landet in deren Zweigstelle; ein vom Headquarters hinzugefügtes Gerät startet im Headquarters.

WerEin Gerät der Zweigstelle
Mitarbeiter dieser Zweigstelle, der darüber liegenden Zweigstellen und der ZentraleVerwalten
Personal der untergeordneten ZweigstellenAnsehen, schreibgeschützt
Andere ZweigstellenNicht sichtbar
Benutzer dieser Zweigstelle und ihrer untergeordneten ZweigstellenAnmeldung darüber möglich

Die Karte, die Wireless-Seite sowie die Listen für den Systemzustand und die Router folgen derselben Regel. Der Login-Teil ist die Einstellung Users log in only through their branch's routers unter Settings → Authentication: bei Neuinstallationen aktiviert; eine aktualisierte Installation, bei der die Geräte bereits den Zweigstellen zugewiesen wurden, startet mit deaktivierter Einstellung, damit niemand den Zugriff verliert — schalten Sie diese ein, wenn Ihre Geräte zugewiesen sind. Benutzer der General company können jeden Router nutzen.

Warnungsempfänger pro Zweigstelle

Das Menü einer Zweigstelle enthält zudem Warnempfänger: E-Mail-Adressen, WhatsApp- und SMS-Nummern sowie Telegram-Chats, jeweils eine pro Zeile. Wenn ein Gerät dieser Zweigstelle (oder einer darunter liegenden Zweigstelle) ausfällt, einen Fehler aufweist, einen Angriff blockiert oder die Konfiguration nicht übereinstimmt, werden diese benachrichtigt. Die Zentrale erhält weiterhin jede Warnung.

Preislisten

Financial → Price Lists (nur Superadmin) legt für jeden Tarif und jedes Add-on einen Preis pro Zweigstelle fest. Eine Unterzweigstelle übernimmt die Preise ihrer übergeordneten Stelle, sofern keine eigenen definiert wurden; eine neue Zweigstelle startet mit dem Standardpreis des Tarifs. Ändern Sie mehrere Preise gleichzeitig um einen Prozentsatz oder einen festen Betrag inklusive Rundung; Reset All setzt eine Zweigstelle auf die Werte der übergeordneten Stelle zurück, und die Liste kann zur Überprüfung exportiert werden.

Rollen & Berechtigungen

Eine Rolle gewährt Zugriff auf bestimmte Bereiche. SAMM enthält vier vorgefertigte Rollen, die Sie bearbeiten oder löschen können — Manager (Tagesgeschäft), Reseller, Accountant (Finanzen) und Monitor (schreibgeschützt) — sowie zwei gesperrte integrierte Rollen: superadmin (vollständiger Zugriff) und Agent, welche den Administrator in einen Wholesale-Reseller mit Prepaid-Guthaben und Provisionsaufteilung verwandelt (siehe Accounting & billing → Agents).

Für jeden Bereich von SAMM (Benutzer, Tarife, Router, Abrechnung, Einstellungen und so weiter) wird eine Rolle auf einer von drei Ebenen festgelegt:

LevelBedeutung
Nicht zulässigDer Bereich ist vollständig aus der Seitenleiste ausgeblendet
AnzeigenNur-Lesezugriff
BearbeitenVollzugriff — erstellen, ändern, löschen

Administratoren & Rollen, Tools, API und Zahlungen verbleiben beim HQ, unabhängig von den Rolleneinstellungen.

Zwei Berechtigungen befinden sich neben den Bereichsebenen, da jede davon eine finanzielle Entscheidung und keine bloße Anzeige ist:

RechtsFunktionsumfang
"Keine Rechnung" zulassen Ändern Sie den Dienst eines Benutzers — verlängern, Tarif ändern, erweitern — und berechnen Sie nichts dafür. Standardmäßig bei jeder neuen Rolle deaktiviert.
Agenten-Genehmigung zulassen Überprüfen und entscheiden Sie über die Anträge von Agenten zur Stornierung einer Zahlung. Das Erstellen und Verwalten von Agenten bleibt dem Superadmin vorbehalten. Siehe Undo & approvals.

Detaillierte Berechtigungen

Unter Edit, Users, Cards, Financial und Routers öffnen sich einzelne Berechtigungen — zum Beispiel Benutzer löschen, verlängern, Tarif ändern, Rechnungen bezahlen, Rabatte gewähren, Router-Skripte ausführen. Deaktivieren Sie eine dieser Berechtigungen für eine Rolle; die Schaltflächen für Berechtigungen, über die die Rolle nicht verfügt, werden ausgeblendet.

Zeitraum, für den eine Rolle gewährt werden kann

Verhindern Sie, dass Mitarbeiter Dienste für mehrere Monate gutschreiben. Für jede Rolle:

EinstellungAuswirkung
Max. Perioden im VorausDas Ablaufdatum darf maximal diese Anzahl an Tarifperioden in der Zukunft liegen — beim Erstellen, Erneuern, Tage hinzufügen, Bearbeiten und bei Massenänderungen.
Max. Tage im VorausDas Gleiche, in Tagen angegeben.
Neue Benutzer starten mit (Stunden)Ein Benutzer, den ein Benutzer mit dieser Rolle erstellt, erhält genau diese Zeitspanne (zum Beispiel 2 Stunden) und keine Rechnung; eine Person mit der entsprechenden Berechtigung kann diese Zeit später verlängern.

Tage hinzufügen und Ablaufdatum eingeben sind separate Rechte unter Benutzer, sodass eine Rolle Verlängerungen vornehmen kann, ohne ein beliebiges Datum eingeben zu können. Lassen Sie ein Feld leer, wenn keine Beschränkung gelten soll; der Superadmin ist niemals beschränkt. Eine Massenänderung überspringt die Benutzer, bei denen das Limit überschritten würde, und gibt den Grund an.

Einer Rolle kann zudem erlaubt werden, jeden Benutzer & jede Karte in der Installation zu sehen, unabhängig vom Baum. Wenn diese Option deaktiviert ist, sieht die Rolle ihre eigene Zweigstelle und die darunter liegenden Zweigstellen.

Das Dashboard bleibt immer erhalten Unabhängig davon, welche anderen Berechtigungen einer Rolle verweigert werden, behält jeder Administrator sein eigenes Dashboard und Profil — ein Login, das zu einem Berechtigungsfehler führt, ist ein fehlerhafter Login, kein sicherer.
Die Lizenz ist immer erreichbar Die Seite System → License ist ein normaler Berechtigungsblock — aber wann immer sich das Gerät in einem Lockdown-Zustand (grace, soft oder hard) befindet, erzwingt SAMM den Zugriff für jeden angemeldeten Administrator unabhängig von der Rolle, sodass der Wiederherstellungspfad niemals gesperrt ist.

System

Tools

Der Bereich Tools bündelt Massen- und Wartungsfunktionen. Da diese auf den gesamten Datensatz wirken, stehen sie nur Superadmins zur Verfügung.

Backup & Wiederherstellung

Erstellen Sie vor jeder größeren Änderung einen vollständigen Datenbank-Snapshot. Ein Backup ist ein gzipped pg_dump-Archiv, das auf dem Server gespeichert wird und jeweils einen SAMM-Header besitzt.

  • Backup erstellen — optional eine Notiz hinzufügen; Nutzung & Historie überspringen aktivieren für einen kleineren, schnelleren Dump, bei dem umfangreiche Log-Tabellen weggelassen werden.
  • Downloaden Sie ein Backup auf Ihren PC oder uploaden Sie ein früheres SAMM-Backup zurück auf den Server.
  • Restore überschreibt die aktuelle Datenbank — dies wird durch einen Bestätigungsdialog vom Typ RESTORE abgesichert.

Hochverfügbarkeit

Für eine Bereitstellung ohne Single Point of Failure betreiben Sie SAMM über zwei Knoten: PostgreSQL streaming replication (ein Primary mit einem zeitversetzten Hot Standby) plus einen Standby AAA-Knoten, und führen Sie bei einem Ausfall eine Promotion und ein Repoint durch. Das vollständige Operator-Runbook — Replikations-Setup, geplanter und ungeplanter Failover, Failback, ein optionaler Modus für synchrone Replikation sowie eine Checkliste zur Verifizierung nach dem Failover — wird als docs/HA.md mit dem Quellcode ausgeliefert. Beachten Sie, dass eine Replikation kein Backup ist (ein fehlerhaftes Löschen wird sofort repliziert), daher sollten Sie auch die oben genannten geplanten Backups beibehalten.

Verlauf bereinigen

Löschen Sie alte Protokoll- und Historienzeilen dauerhaft, um Datenbankspeicher freizugeben. Wählen Sie eine Aufbewahrungsvorgabe und bestätigen Sie diese. Der Cleaner entfernt geschlossene RADIUS-Sessions, Post-Auth-Datensätze, tägliche Nutzungszusammenfassungen, Router/Schnittstellen-Historien, Limitierungsprotokolle, angewendete Audit-Einträge und abgeschlossene CoA-Zeilen. Er greift niemals auf aktive Sessions, in der Warteschlange befindliche Befehle, ausstehende CoAs oder die nicht zurücksetzbaren Gesamtnutzungswerte zu.

Erstellen Sie zuerst ein Backup History Cleaner löscht dauerhaft. Führen Sie vor dem Bereinigen ein Backup durch, falls Sie die Daten später benötigen könnten.

Exportieren / Importieren

Massenexport und -import für Benutzer, Tarife und NAS als .csv oder .xlsx. Laden Sie eine Vorlage (die korrekten Spalten plus eine Beispielzeile) oder einen Snapshot der aktuellen Daten herunter, füllen Sie diese aus und laden Sie sie wieder hoch. Jede Zeile wird validiert und auf einem Vorschaubildschirm angezeigt — Duplikate und ungültige Zeilen werden hervorgehoben, und Sie entscheiden, ob Duplikate übersprungen oder aktualisiert werden sollen — bevor Daten geschrieben werden.

Sammeländerungen

Wenden Sie eine Änderung — Besitzer, Ablaufdatum, Status, automatische Verlängerung oder gesamte Tarifzeiträume — in einem einzigen Durchgang auf jeden Abonnenten an, der einem Filter entspricht. Wählen Sie die Änderung aus, erstellen Sie den Filter (Status / Tarif / Besitzer / Suche), überprüfen Sie die Trefferliste und bestätigen Sie.

Ganze Tarifzeiträume hinzufügen ist die Option zur Massenverlängerung: Jeder Abonnent erhält die entsprechende Anzahl an Zeiträumen seines eigenen Tarifs, sodass ein 7-Tage-Tarif 7 Tage pro Zeitraum und ein Monatstarif einen Kalendermonat erhält — in einem einzigen Durchgang, ohne die Liste zuvor nach Tarifen zu filtern. Abonnenten, deren Tarif keine Ablauffrist hat, werden übersprungen, anstatt eine Schätzung vorzunehmen. Tage hinzufügen bleibt verfügbar, wenn Sie eine feste Anzahl an Tagen ohne Zurücksetzen des Zählers wünschen.

Speed Boost

Erhöhen oder senken Sie die Geschwindigkeit ganzer Tarife gleichzeitig um einen Prozentsatz — ein Feiertagswochenende mit doppelter Geschwindigkeit oder eine Notfall-Drosselung bei einer beeinträchtigten Backhaul-Verbindung. Dies wird sofort wirksam, sowohl für neue Logins als auch für bereits aktive Sitzungen.

SteuerungFunktionsweise
ProzentsatzPositive Werte multiplizieren, negative Werte dividieren: +100% → doppelte Geschwindigkeit, −100% → halbe Geschwindigkeit, −500% → ein Sechstel davon. Die Geschwindigkeit erreicht niemals Null.
Tarife upgradenWählen Sie beliebig viele Tarife aus; jede Zeile zeigt den Tarifpreis, den aktiven Boost und die derzeitige effektive Geschwindigkeit.
Automatisch rückgängig machen nachStunden, bis der Boost automatisch abläuft. 0 behält ihn bei, bis Sie ihn manuell zurücksetzen.
Ein Boost hat Vorrang vor einem Speed Window Die Beschleunigung wird basierend auf der Tarifrate gemessen und ersetzt jedes Geschwindigkeitsfenster, solange sie aktiv ist — ein Tarif mit einem 20M-Nachtfenster wird nicht zu 40M, sondern zu dem Wert, den die Beschleunigung aus der Tarifrate macht. Windows wird in dem Moment wieder aufgenommen, in dem die Beschleunigung abläuft.

Ein Teilnehmer, der ein Limit ausgeschöpft hat, wird durch einen Boost niemals wieder auf die volle Geschwindigkeit gesetzt. Aus demselben Grund wird ein Tarif, der als Drosselziel dient, von Alle auswählen übersprungen und entsprechend gekennzeichnet — ein Boost würde genau die Personen beschleunigen, die Sie drosseln. Sie können das Feld dennoch manuell markieren, falls dies beabsichtigt ist. Alles auf Normal zurücksetzen entfernt jeden Boost und setzt aktive Sitzungen wieder auf die Geschwindigkeit ihres Tarifs zurück.

Massenlöschen

Löschen Sie dauerhaft viele Abonnenten oder Hotspot-Karten gleichzeitig, ausgewählt über einen Filter. Das Löschen eines Abonnenten entfernt auch dessen Nutzungshistorie, Sitzungen, RADIUS-Accounting und Rechnungen und trennt alle aktiven Sitzungen. Gesichert durch einen Bestätigungsdialog vom Typ DELETE.

System

Sprachen & Themes

Sprachen

Die Administrator- und Kundenportale sind vollständig übersetzbar. Acht Sprachen sind bereits integriert: English, Arabic (von rechts nach links), Russian, Persian (von rechts nach links), Turkish, French, Spanish und German. Jeder Benutzer wählt seine Sprache in der oberen Leiste oder in seinem Profil aus; die Auswahl wird pro Konto gespeichert.

Sprache deaktivieren

Unter System → Translations verfügt jede Sprache über einen Ein/Aus-Schalter (nur für Superadmins). Eine deaktivierte Sprache kann von niemandem ausgewählt werden: Sie wird in den Auswahlmenüs nicht mehr angeboten, Benutzer, die sie zuvor ausgewählt hatten, sehen Englisch, und Nachrichten an sie werden auf Englisch verfasst. Englisch bleibt immer aktiviert. Eine Neuinstallation startet mit allen aktivierten Sprachen.

Der Übersetzungseditor

Ein Superadmin kann Übersetzungen live unter System → Translations bearbeiten — ohne Neustart, ohne Dateibearbeitung. Mit dem Editor können zudem komplett neue Sprachen erstellt sowie Übersetzungsdateien als .xlsx importiert und exportiert werden, sodass Sie SAMM in jede von Ihnen bediente Sprache lokalisieren können.

Themes

SAMM enthält 16 visuelle Themes, hell und dunkel. Jeder Benutzer wählt ein Theme in der oberen Leiste aus; die Vorschau aktualisiert sich sofort und wird pro Konto gespeichert. IT-Terminologie wird nie übersetzt, sodass technische Screens in jeder Sprache präzise bleiben.

System

Audit-Log & Aktivität

System → Audit Log beantwortet eine Frage: was ist passiert und wer hat es getan. Eine Liste enthält jede Änderung, die ein Administrator vorgenommen hat, was das System selbstständig erledigt hat (z. B. Ablauf von Fristen) und welche Änderungen Benutzer an ihrem eigenen Konto im Portal oder über Telegram vorgenommen haben — Tarifänderungen, Verlängerungen, Zahlungen sowie Bearbeitungen von Profil und Passwort.

SpalteAnzeigeinhalt
WennDie Zeit in Ihrer Zeitzone
WerDer Administrator, „ali, im Portal“, „ali, auf Telegram“, ein API-Token oder System
Was ist passiertEin Satz, nur mit den Feldern, die geändert wurden, alt → neu — zum Beispiel „Benutzer bearbeitet: Ablaufdatum: 01 Okt → 15 Okt“
ZielÄnderungshistorie — Benutzer · ali, Tarif · Gold 20M, Router · Hamra, Administrator · rami

Filtern Sie nach Who und Period oder geben Sie einen Namen in das Suchfeld ein. Logins und Exporte sind ausgeblendet, sofern Sie Show logins & exports nicht aktivieren. Via, Action, Category, Severity und ID befinden sich in der Spaltenauswahl. Wählen Sie Zeilen aus, um diese zu Export oder Print — die Datei enthält dieselben Spalten wie die Ansicht. Die ⓘ-Schaltfläche in einer Zeile zeigt die vollständige Vorher-Nachher-Tabelle an.

Benutzer-Timeline

Öffnen Sie einen Benutzer und wählen Sie Timeline, um alle Ereignisse dieses Kontos einzusehen — Erstellung, Verlängerung, Tarifänderung, Suspendierung, erreichte Limits — inklusive Rechnungen, Zahlungen sowie Wallet- und Agent-Gebühren in einer Betragsspalte. Filtern Sie nach Art oder Zeitraum, oder nur nach Geldbeträgen, und exportieren Sie diese als CSV oder Excel. Timeline-Zeilen werden niemals gelöscht und bleiben auch nach dem Löschen des Benutzers erhalten.

Accept-Log und Access-Log

Overview → Accept Log listet jeden von den Routern gesendeten Login-Versuch und die Antwort von RADIUS auf, die neuesten zuerst, inklusive des Grundes für jede Ablehnung. Dies ist die Seite, die zu öffnen ist, wenn ein Benutzer keine Verbindung herstellen kann. Eine sich wiederholende Ablehnung wird in einer Zeile mit einem Zähler angezeigt. Overview → Access Log listet die erfolgreich gestarteten Sitzungen aus dem RADIUS-Accounting auf.

Zudem eine Befehlswarteschlange Zurücksetzungen, Tarifänderungen und Verlängerungen, die über die CLI oder die API in die Warteschlange gestellt wurden, werden in dieselbe Tabelle geschrieben und beim nächsten Tick vom samm-radius-Dienst angewendet, welcher dann eine aktive Sitzung mittels CoA aktualisiert. Das Badge in der Seitenleiste zählt die noch ausstehenden Vorgänge.

Lizenzierung

Lizenzierung & Tarife

Jede SAMM-Installation wird pro Gerät lizenziert — der Tarif ist an diese Installation gebunden, sodass Sie mehrere SAMM-Server betreiben können, wobei jeder einen eigenen Tarif nutzt. Der Tarif legt vier numerische Limits fest.

TierAAA-BenutzerHotspot-KartenNAS / RouterÜberwachung
Nicht registriert252513
Kostenlos1005026
Lite5001,500412
Plus1,0003,000618
Pro2,0006,0001236
Mega5,00015,0002472
Max10,00030,000unbegrenztunbegrenzt
Unlimitedunbegrenztunbegrenztunbegrenztunbegrenzt

Eine Neuinstallation läuft unregistriert auf der untersten Stufe. Jede Funktion ist in jeder Stufe verfügbar — die Stufe legt lediglich die Limits fest. Das Erstellen eines Abonnenten, einer Karte oder eines NAS über dem Limit ist gesperrt, bis Sie ein Upgrade durchführen; es gehen niemals Daten verloren.

Monitors sind die Zugangspunkte und Verbindungen, die SAMM nur überwacht. Sie haben ein eigenes Kontingent von drei pro NAS, sodass die Überwachung eines Zugangspunkts niemals einen Router-Slot belegt.

Aktivieren & upgraden

  1. Öffnen Sie System → License.
  2. Aktivieren Sie das Gerät, indem Sie sich mit Ihrem SecuryTik-Konto anmelden — oder verwenden Sie Gerät verknüpfen, wodurch ein Code angezeigt wird, den Sie auf samm.securytik.com bestätigen, ohne Ihr Passwort auf dem Server eingeben zu müssen. Das Gerät wird im Free-Tarif aktiviert.
  3. Um ein Upgrade durchzuführen, wählen Sie einen Tarif auf derselben Seite aus oder abonnieren Sie über Ihr Dashboard. Eine Anfrage über die Seite wird von einem SecuryTik Administrator geprüft und genehmigt.

Die Lizenzseite überprüft die Lizenz auf Anfrage erneut und zeigt Ihre aktuelle Nutzung im Vergleich zu den jeweiligen Limits an. Gerät entkoppeln setzt die Installation auf die nicht registrierte Stufe zurück, ohne Daten zu löschen.

Wenn eine kostenpflichtige Lizenz abläuft

SAMM löscht niemals Daten. Eine abgelaufene Lizenz wird schrittweise deaktiviert:

PhaseWas passiert
WarnungEin Erinnerungsbanner; der Betrieb wird nicht unterbrochen
KulanzzeitEin kurzes Zeitfenster zur Reaktivierung; Abonnenten bleiben online
Soft LockdownHintergrunddienste stoppen; RADIUS authentifiziert für etwa 7 Tage weiter
Hard LockdownDienste werden gestoppt, außer der Seite zur Reaktivierung

Die Reaktivierung in jeder Phase startet jeden Dienst automatisch neu — alle Abonnentendaten und der Verlauf bleiben erhalten.

Automatische Updates

Automatische Updates sind unabhängig von der Lizenzierung — jede Stufe erhält Updates, und eine abgelaufene Lizenz blockiert diese niemals. SAMM prüft täglich auf ein neues signiertes Release. Unter System → License können Sie zwischen notify (Standard — ein Banner mit einer Jetzt anwenden-Schaltfläche) und auto (unbeaufsichtigt anwenden) wählen. Jedes Update wird verifiziert, gesichert und direkt angewendet. Sie können den Installer auch jederzeit erneut ausführen — er führt das Upgrade idempotent durch.

Für Ihre Kunden

Kundenportal & Bot

SAMM bietet jedem Abonnenten zwei Self-Service-Oberflächen — ein Webportal und einen Telegram-Bot —, sodass diese die Nutzung prüfen und bezahlen können, ohne Sie zu kontaktieren.

Das Kundenportal

Abonnenten melden sich im SAMM-Standort-Root (/) mit ihrem SAMM-Benutzernamen und Passwort an. Das Portal enthält:

SeiteAnsicht des Teilnehmers
ÜbersichtKontostatus, Tarif, Ablaufdatum, heutige und monatliche Nutzung, offene Rechnungen
Nutzung & SitzungenGesamt heruntergeladen/hochgeladen, Uptime-Budget und vollständiger Sitzungsverlauf
Meine TarifeDer aktuelle Tarif sowie der Katalog der verfügbaren Tarife
Meine RechnungenAbrechnungsverlauf mit PDF-Download per Klick
Support-TicketsSupport-Tickets öffnen und verfolgen
ProfilKontaktdaten bearbeiten, Passwort ändern, Sprache & Design festlegen, Benachrichtigungen verwalten

Unter Profile verknüpft ein Teilnehmer sein Telegram-Konto, wählt seine bevorzugten Benachrichtigungskanäle aus oder deaktiviert Benachrichtigungen vollständig. Wenn das Passwort vergessen wurde, wird ein OTP-Code per E-Mail versendet (hierfür muss die Registerkarte Email konfiguriert sein).

Der Telegram-Bot

Der samm-telegram-Dienst betreibt einen interaktiven Self-Service-Bot. Ein Abonnent sendet /start, verifiziert sich einmalig mit seinem SAMM-Benutzernamen und Passwort (der Bot löscht die Passwortnachricht sofort) und kann dann, vollständig über den Chat:

  • Prüfen Sie deren Tarif, Kontingent, Nutzung und das Ablaufdatum
  • Rechnungen als PDF anzeigen und herunterladen
  • Profil aktualisieren und Passwort ändern
  • Support-Tickets öffnen und verfolgen

Der Bot versendet zudem automatische Benachrichtigungen — Verlängerungserinnerungen, Ablaufbenachrichtigungen, Kontingentwarnungen und Belege — an Abonnenten, die Telegram verknüpft haben.

Die Landingpage für abgelaufene Abonnements

Wenn ein Abonnement abläuft, leitet der Router (konfiguriert über den „Expired pool & internet block“ des Assistenten) den Browser des Nutzers anstelle einer lautlos unterbrochenen Verbindung auf eine benutzerfreundliche „Abonnement abgelaufen“-Seite weiter, die von SAMM auf Port 81 bereitgestellt wird — inklusive Ihres ISP-Logos und einer Schaltfläche zum Anmelden im Portal.

System

REST API

System → API verwaltet die öffentliche /api/v1 Schnittstelle. Die API bleibt inaktiv, bis Sie das erste Token erstellen; eine Installation, die die API nicht nutzt, gibt somit keine Daten preis. Alle folgenden Informationen sind auch als interaktive OpenAPI Dokumentation verfügbar — mit einer Try-it-Konsole und vollständigen Request/Response- Schemas — in Ihrer eigenen Installation unter /api/v1/docs.

Interaktive Dokumentation (Swagger UI)

Jede Installation stellt eine Live-API-Konsole unter /api/v1/docs bereit — direkt erreichbar über das API-Panel im Administrator-Portal. Klicken Sie auf Authorize, fügen Sie einen Token ein, und jeder Endpunkt kann mit Try it out gegen Ihre eigenen Daten ausgeführt werden; jeder Aufruf zeigt die tatsächliche Antwort sowie einen kopierfertigen curl-Befehl an.

Jeder Endpunkt definiert ein vollständiges, typisiertes Schema — sowohl für Request-Bodies als auch für Responses —, sodass Feldnamen, Typen und Beispiele sichtbar sind, ohne dass ein Aufruf erforderlich ist. Dasselbe Schema wird als maschinenlesbare OpenAPI unter /api/v1/openapi.json bereitgestellt, wodurch ein vollständig typisierter Client in der Sprache Ihrer Wahl generiert werden kann:

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 Endpunkte

Schnellstart

  1. Öffnen Sie System → API (nur superadmin), klicken Sie auf New token, vergeben Sie einen Namen sowie ein Ablaufdatum und aktivieren Sie nur die Berechtigungen, die die Integration benötigt (Read oder Write, eine Zeile pro Bereich).
  2. Kopieren Sie das Secret sofort — es wird nur ein einziges Mal angezeigt und nur dessen Hash wird auf dem Server gespeichert.
  3. Überprüfen Sie die Funktion und sehen Sie, was das Token kann:
curl -H "Authorization: Bearer samm_YOUR_TOKEN" https://YOUR-SAMM/api/v1/me

Aktive Abonnenten auflisten und anschließend einen erstellen:

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

Authentifizierung, Tokens & Scopes

Jede Anfrage sendet Authorization: Bearer <token>. Ein Token enthält einen Namen, ein Rate-Limit pro Minute, ein Ablaufdatum (30–360 Tage oder nie) und eine Reihe von Scopes — Lese-/Schreibberechtigungen pro Ressource; ein write-Scope beinhaltet automatisch den entsprechenden read-Scope. Das Secret wird nur ein einziges Mal angezeigt; der Server speichert nur einen Hash. Ein Token kann widerrufen (Aufrufe schlagen sofort fehl, reversibel) oder vollständig gelöscht werden.

Antworten folgen einem einheitlichen Standard: Listen-Endpunkte akzeptieren limit/offset und geben {"total", "items"} zurück; Fehler verwenden Standard-Statuscodes — 401 fehlender/ungültiger/abgelaufener Token, 403 fehlender Scope, 404 nicht gefunden, 409 Duplikat, 422 Validierungsfehler und 429, wenn das Rate-Limit bei einem Zugriff erreicht wurde (mit Retry-After- und X-RateLimit-*-Headern).

Beträge in den Zahlungs-, Wallet- und Webhook-Daten sind Dezimal-Strings wie "12.50"; Zeitangaben erfolgen im ISO 8601-Format mit dem Offset der Installation.

Endpunkt-Referenz

BereichEndpunkteGeltungsbereich
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}

Rechnungen, Zahlungen, Rabatte & Wallet

Jeder Geldtransfer wird in den doppelt geführten Büchern von SAMM erfasst, genau wie im Panel. Eine Rechnung weist einen offenen Betrag von total − paid − discount auf; ihr Status ändert sich von unpaid/due zu partial und paid (oder discounted, wenn sie allein durch Rabatte beglichen wurde).

# 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 öffnet eine bezahlte Rechnung erneut und DELETE /invoices/{id} schließt eine korrekt ab (ein teilweise bezahlter Restbetrag wird abgeschrieben). Der Buchhaltungsexport als JSON oder CSV erfolgt über GET /accounting/export/{kind}.

Payment-Apps

Geldtransfer-Apps und Shop-Agenten (Wish Money, Sham Cash…) erhalten eigene Scopes, collect:read und collect:write, sowie drei Aufrufe: einen Benutzer über den Benutzernamen suchen (maskierter Name, fälliger Betrag, offene Rechnungen), eine Zahlung erfassen und diese wieder auslesen. Eine Zahlung ist idempotent bezüglich ihrer Referenz: das erneute Senden derselben Zahlung gibt die erste Antwort zurück und bucht nichts.

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

Warteschlangenbefehle

Änderungen, die den aktiven Abrechnungsstatus betreffen — Limit-Resets, das Aktivieren/Deaktivieren von Karten und Gruppen sowie Gültigkeitsverlängerungen — werden nicht unmittelbar innerhalb der Anfrage angewendet. Sie werden in die auditierte Befehlswarteschlange eingereiht und von samm-radius innerhalb eines Ticks (einige Sekunden) ausgeführt, genau wie die entsprechenden Klicks im Administrator-Portal. Solche Endpunkte antworten mit {"queued": true}; fragen Sie GET /commands ab, um zu sehen, wann die in der Warteschlange stehenden Befehle Ihres Tokens auf applied wechseln.

Webhooks

Registrieren Sie eine Endpunkt-URL unter System → API → Webhooks oder mit POST /webhooks und wählen Sie Ereignisse aus: einzelne Ereignisse, eine ganze Gruppe wie invoice.* (spätere Ereignisse dieser Gruppe sind enthalten) oder * für alles. Das Signing Secret wird auf der Seite des Endpunkts angezeigt und kann aktualisiert werden.

Jede Zustellung erfolgt als JSON mit id, type, api_version, created_at und data. Die id ist für jeden Endpunkt und jeden Wiederholungsversuch identisch: verarbeiten Sie jede ID nur einmal. Antworten Sie innerhalb von 10 Sekunden mit einem 2xx-Code; alle anderen Antworten werden mit einem Backoff-Verfahren über etwa zwei Stunden hinweg wiederholt, und ein Endpunkt, der dauerhaft fehlschlägt, wird automatisch deaktiviert. Jede Zustellung wird mit dem vom Server zurückgegebenen HTTP-Code protokolliert und kann erneut gesendet werden.

Überprüfen Sie X-SAMM-Signature-256: t=<unix>,v1=<hex>, einen HMAC-SHA256 von t.body, bevor Sie eine Zustellung akzeptieren:

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"])
EreignisWenn
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)
Dieselben Regeln wie beim Portal API-Mutationen durchlaufen dieselbe geprüfte Befehlswarteschlange und dieselbe Service-Layer wie das Administrator-Portal — ein Reset oder eine Tarifänderung über die API verhält sich exakt so wie ein Klick in der UI, einschließlich CoA und allem Weiteren.
Die Verbindung zu SAMM ist gesperrt Router-Control-Tokens dürfen die Verbindung zwischen SAMM und dem Router selbst nicht beeinflussen — dessen Logins, dessen API-Dienst, dessen RADIUS-Einstellungen, die eigenen Sicherheitsregeln von SAMM oder die Adresse, über die SAMM den Router erreicht. SAMM prüft nach jeder Änderung, ob ein Login noch möglich ist, und jede Änderung oder jeder Skriptlauf wird im Admin Log gespeichert.

Referenz

SAMM-Betrieb

Fast alles wird über das Administrator-Portal erledigt. Diese Seite dient als Shell-Referenz für die seltenen Fälle, in denen Sie diese benötigen.

Dienstverwaltung

# 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

Administrator CLI

Für schnelle Teilnehmer-Operationen über die Shell. Jeder Befehl wird in das Audit-Log eingereiht und beim nächsten samm-radius-Tick ausgeführt — genau wie die Aktionen in der 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

Konfigurationsdateien

DateiWarteschleifen
/etc/samm/samm.yamlDatenbank-DSN, Connection-Pool-Größen, Log-Level
/etc/samm/api.envPortal-Sitzungsgeheimnisse und die SMTP-Einstellungen zur Passwortwiederherstellung
/etc/samm/secret.keyDer Verschlüsselungsschlüssel für gespeicherte Router-API-Passwörter

Diese Dateien werden bei Upgrades beibehalten und niemals durch einen erneuten Durchlauf des Installers überschrieben. Runtime-Einstellungen (Loop-Intervalle, tägliche Reset-Zeit, CoA-Ports) befinden sich stattdessen unter Einstellungen und werden ohne Neustart angewendet.

SAMM aktualisieren

Lassen Sie SAMM entweder über System → Lizenz aktualisieren oder führen Sie den Installer erneut aus — siehe Installation → Upgrading. Beide Pfade wenden Migrationen erneut an und starten Dienste neu; Ihre Konfiguration und Daten bleiben unberührt.

Backup & Wiederherstellung

Verwenden Sie Tools → Backup & Restore für einen vollständigen Datenbank-Snapshot vor jeder größeren Änderung. Um das System auf einem neuen Host neu aufzubauen, installieren Sie SAMM und stellen Sie dann das Backup wieder her.

Wartungswerkzeuge (extern)

Einige Wartungsaufgaben sind so destruktiv, dass sie nicht in das Administrator-Panel gehören, wo ein versehentlicher Klick einen laufenden Geschäftsbetrieb zerstören könnte. SAMM führt diese als eigenständige, nur für Root verfügbare Skripte, die Sie bewusst aus der Shell herunterladen und ausführen — niemals über eine Schaltfläche. Diese befinden sich im öffentlichen Distributions-Repository unter tools/.

Passwort eines gesperrten Administrators zurücksetzen

Aus dem Administrator-Panel ausgesperrt? Setzen Sie ein neues Passwort für ein Superadmin-Konto direkt in der Datenbank — ein funktionierender Login ist nicht erforderlich. Dies aktiviert das Konto auch wieder, falls es deaktiviert war, und lässt alles andere unberührt.

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)

Führen Sie es als root auf dem SAMM-Server aus. Wenn es mehrere Superadmins gibt, übergeben Sie --user <name>, um einen auszuwählen.

Buchhaltung zurücksetzen (Finanzdaten löschen)

Löscht alle Finanztransaktionen, sodass ein ISP seine Buchhaltung bei null beginnen kann, während alle Teilnehmer- und AAA-Daten vollständig erhalten bleiben. Nützlich bei der Übernahme einer Installation oder nach einer Testphase, wenn die Buchhaltung Daten enthält, die der Betreiber löschen möchte, die Kundenbasis jedoch exakt so bleiben muss, wie sie ist.

Gefahr — unwiderruflicher Datenverlust Dies löscht dauerhaft alle Rechnungen, Zahlungen, Belege, Wallet-Guthaben und die Ledger-Historie. Dies kann nicht rückgängig gemacht werden. Die einzige Möglichkeit zur Wiederherstellung ist ein Datenbank-Backup. Führen Sie diesen Vorgang niemals auf einer Produktionsinstallation aus, die Sie nicht zuvor gesichert und verifiziert haben.

Entfernt: Rechnungen und deren Einzelposten, das Hauptbuch der doppelten Buchführung (Zahlungen, Belege, Anpassungen, Wallet-Aufladungen und -Auszahlungen), Online-Zahlungstransaktionen, Ausgaben, Anlagegüter und das Aktivitätsprotokoll der Buchhaltung. Die Rechnungsnummerierung wird zurückgesetzt, sodass die nächste Rechnung mit #1 beginnt.

Beibehalten: jeder Teilnehmer, Tarif, Geschwindigkeitsfenster, Limit, Verbrauchszähler, Tarifhistorie, Hotspot-Karte, Router, Sitzung und RADIUS-Accounting-Datensatz — plus Ihre Accounting-Konfiguration (Kontenplan, Kassenkonten, Steuergruppen, Payment-Gateways). Barbestände, Wallet- und Forderungssalden werden aus dem Hauptbuch abgeleitet, sodass sie danach einfach null anzeigen.

Laden Sie es herunter, lesen Sie es und führen Sie es dann aus. Führen Sie immer zuerst einen Testlauf durch:

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
Nicht direkt in eine Shell leiten Führen Sie dies niemals als curl … | sudo bash aus. Bei einem Skript, das Daten löscht, sollten Sie es zuerst lesen; ein unvollständiger Download darf keinen teilweisen Löschvorgang ausführen. Download, prüfen, dann ausführen.

Das Skript lässt sich nicht als Nicht-Root-Benutzer ausführen. Es gibt genau aus, was gelöscht werden soll, und fordert Sie dann auf, YES einzugeben, um zu bestätigen, dass Sie über ein verifiziertes Backup verfügen, und WIPE, um fortzufahren. Es bietet an, zuerst einen eigenen Datenbank-Dump (unter /var/backups/samm/) zu erstellen, und bricht ab, falls dieser Dump fehlschlägt. Das Löschen wird als einzelne Alles-oder-Nichts-Transaktion ausgeführt, wobei RADIUS bewusst weiterläuft, sodass Abonnenten online bleiben, während die Daten behoben werden.

Referenz

FAQ & Fehlerbehebung

Welche Betriebssysteme unterstützt SAMM?

Ubuntu 22.04 / 24.04 / 26.04 LTS und Debian 12 / 13. Nur Linux-Server-Distributionen — Desktop-Varianten werden nicht unterstützt. Der Installer setzt systemd, eine frische PostgreSQL-Installation (eine wird automatisch eingerichtet) und Root-Zugriff voraus.

Benötige ich eine Internetverbindung, um SAMM zu betreiben?

Nein. SAMM läuft vollständig auf Ihrem eigenen Server und authentifiziert Abonnenten lokal über RADIUS. Der einzige ausgehende Datenverkehr ist ein periodischer Lizenz-Heartbeat an den SecuryTik-Lizenzserver, damit Ihr Tarif validiert bleibt.

Kann ich SAMM in der Cloud betreiben oder muss es on-prem installiert sein?

Beides funktioniert. Die meisten Betreiber setzen es on-prem neben ihren Core-Routern ein; einige nutzen eine kleine Cloud-VM mit einem Cloudflare Zero Trust Tunnel zurück. Die einzige Voraussetzung ist, dass die MikroTik Router den SAMM Server über die RADIUS Ports (1812/1813 UDP) erreichen können und dass SAMM die Router über die MikroTik API erreichen kann.

Muss ich FreeRADIUS neu starten, wenn ich einen Router hinzufüge oder entferne?

Nein. SAMM löst NAS-Clients dynamisch aus der Datenbank auf, sodass das Hinzufügen, Bearbeiten oder Entfernen eines Routers unter MikroTik → NAS ohne Neustart wirksam wird.

Wie schnell treten eine Tarifänderung oder ein Zähler-Reset in Kraft?

Administrator-Aktionen werden in eine Warteschlange gestellt und vom samm-radius-Dienst beim nächsten Tick ausgeführt — standardmäßig innerhalb von 30 Sekunden. Wenn der Teilnehmer online ist, sendet SAMM zudem ein Live-CoA, um die Sitzung zu aktualisieren. Verringern Sie das samm-radius-Intervall unter System → Einstellungen für eine präzisere Zeitsteuerung.

Was passiert mit meinen Daten, wenn eine kostenpflichtige Lizenz abläuft?

Es wird nichts gelöscht. Eine abgelaufene Lizenz durchläuft die Stufen Warnung, Kulanzzeit, einen Soft-Lockdown (RADIUS authentifiziert etwa eine Woche lang weiter) und schließlich einen Hard-Lockdown. Eine Reaktivierung in jeder Phase startet jeden Dienst mit allen intakten Daten neu.

Ist SAMM kostenlos? Was bietet Pro zusätzlich?

Der Free Tarif ist dauerhaft kostenlos und enthält alle Funktionen. Die kostenpflichtigen Tarife schalten keine Funktionen frei — sie erhöhen die Limits für AAA Benutzer und Hotspot-Karten und entfernen die Beschränkung für Router. Siehe Lizenzierung & Tarife.

Ein Teilnehmer kann sich nicht authentifizieren — wo fange ich an?

Überprüfen Sie, ob das RADIUS shared secret des Routers exakt mit dem NAS-Eintrag übereinstimmt, ob der Router für PPP / Hotspot RADIUS aktiviert ist und ob das Konto des Abonnenten aktiv und nicht abgelaufen ist. Beobachten Sie journalctl -u samm-api -f sowie das FreeRADIUS-Log und bestätigen Sie, dass der Router den SAMM-Host über UDP 1812/1813 erreichen kann.

Benötigen Sie weitere Hilfe?

Senden Sie eine E-Mail an samm@securytik.com, um einen Fehler zu melden oder eine Funktion anzufordern.