Das vollständige Bedienerhandbuch — von der Erstinstallation bis zum täglichen Betrieb.
25 Themen8 AbschnitteInstallation 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.
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
Dienst
Rolle
samm-api
Administrator-Portal + Kunden-Self-Service-Portal + REST API
samm-radius
Leert den CoA-Postausgang; führt Bereinigungen für Ablaufdaten / täglichen Reset / Geschwindigkeitsfenster durch
samm-worker
Ping-Abfrage der Router; synchronisiert MikroTik-Gerätemetadaten über die API
samm-notification
Versendet E-Mail- & Telegram-Benachrichtigungen über eine gedrosselte Queue
samm-telegram
Startet den interaktiven Telegram-Self-Service-Bot
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
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.
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).
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.)
Ä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:
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.)
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
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).
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
Speichern Sie Ihre Arbeit und starten Sie den PC neu.
Ö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.
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.)
Speichern und beenden (normalerweise F10), Windows starten lassen und dann den SAMM-Installer erneut ausführen.
OC → CPU Features → Intel Virtualization Tech oder SVM Mode
Gigabyte
Del
Tweaker (oder Advanced) → Advanced CPU Settings → Intel Virtualization Technology oder SVM Mode
Server (Dell iDRAC, HPE, Supermicro)
F2 / F9 / Del
Prozessoreinstellungen → 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:
Ä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:
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:
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:
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.
Ä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:
Gehen Sie in SAMM zu Tools → Backup, erstellen Sie ein Backup und laden Sie die Datei auf Ihren Computer herunter.
Entfernen Sie die App auf dem Router und fügen Sie diese mit der neuen Version erneut hinzu.
Ö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.
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.
Komponente
Details
FreeRADIUS 3
Konfiguriert mit einem PostgreSQL-Backend und dynamischen NAS-Clients; validiert mit freeradius -CX
PostgreSQL
Datenbank, Schema und alle SQL-Migrationen angewendet — jede Migrationsdatei ist idempotent
Python venv
Alle 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
nginx
Reverse Proxy wird additiv hinzugefügt — bestehende Standorte werden niemals entfernt. Verwendet Port 80, wenn dieser frei ist; andernfalls wird ein alternativer Port abgefragt
5 services
samm-api, samm-radius, samm-worker, samm-notification, samm-telegram — alle als systemd-Units aktiviert
WireGuard
Pakete installiert; später unter System → VPN konfigurieren
cloudflared
Die 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
Öffnen Sie http://<your-server>/admin/ (verwenden Sie den HTTP-Port aus der Installationszusammenfassung, falls dieser nicht 80 ist) oder Ihre Cloudflare-Tunnel-URL.
Melden Sie sich mit admin / admin an.
Ändern Sie das Passwort sofort unter System → Admins
oder über das Profilmenü in der oberen Leiste.
2 · Ersten Router hinzufügen
Gehen Sie zu MikroTik → NAS und klicken Sie auf Router hinzufügen.
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.
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 System
Datei
Herkunft
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
Datei hochladen. Es wurde noch nichts geschrieben.
Ü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.
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.
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
Gehen Sie zu Benutzer → Tarife.
Klicken Sie auf Neuen Tarif erstellen.
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
Feld
Bedeutung
Name
Eindeutiger Tarifname, z. B. Home-50M
Preis
Abrechnung pro Abrechnungszeitraum bei Nutzung der Rechnungsstellung
Download- / Upload-Geschwindigkeit
z. B. 50M, 512K, 1G — wird als MikroTik Rate Limit erzwungen
Gleichzeitige Sitzungen
Wie 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: Ablaufdatum
Das Abonnement endet nach einem festgelegten Zeitraum nach der Aktivierung (Tage/Monate/Stunden/Minuten)
Limit: Kontingent
Ein Gesamtdatenlimit (kombiniert, nur Download oder nur Upload) für das gesamte Abonnement
Limit: Betriebszeit
Eine Obergrenze für die kumulierte Verbindungszeit — die Summe aller Sitzungsdauern
Limit: Tägliche Nutzung
Ein Datenlimit, das jeden Tag zur konfigurierten daily-reset Zeit zurückgesetzt wird
Unbegrenztes Zeitfenster
Schnelles Hinzufügen eines Speed Windows — der vollständige Editor befindet sich auf der Seite Speed Windows des Tarifs
IP-Pool
Optionaler RADIUS Framed-Pool-Name für die Adresszuweisung
Automatische Verlängerung
Bei 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.
Limit
Tracks
Bei Aufbrauch
Ablauf
Kalenderzeit seit Aktivierung
Zu einem anderen Tarif wechseln oder trennen
Kontingent
Gesamtverbrauch in Bytes
Zu einem anderen Tarif wechseln oder trennen
Betriebszeit
Kumulierte Sitzungsdauer in Sekunden
Zu einem anderen Tarif wechseln oder trennen
Täglich
Bytes seit dem letzten täglichen Reset
Drosseln — 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
Gehen Sie zu Users und klicken Sie auf Neuer Kunde.
Füllen Sie das Formular aus und speichern Sie — der Teilnehmer kann sich sofort verbinden.
Feld
Bedeutung
Benutzername *
Der PPPoE / Hotspot-Benutzername — muss eindeutig sein
Passwort *
Das Login-Passwort (gespeichert für PAP/CHAP RADIUS-Authentifizierung)
Vorname / Nachname
Name des Kunden
Mobil / E-Mail / Adresse
Kontaktdaten — werden für Benachrichtigungen und Rechnungen verwendet
Tarif *
Der zuzuweisende Tarif des Dienstes
Ablaufdatum überschreiben
Optionales manuelles Ablaufdatum anstelle des berechneten Datums des Tarifs
Automatische Verlängerung
Tarifzeitraum 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:
Aktion
Funktionsweise
Anzeigen / Bearbeiten
Öffnen Sie die Detailseite oder bearbeiten Sie Kontaktdaten, Passwort und Ablaufdatum
Aktivieren / Deaktivieren
Konto suspendieren — aktive Abonnenten werden getrennt
Tarif verlängern
Fü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ücksetzen
Ausgewählten Limit-Zähler zurücksetzen
Verwendung
Nutzungsdiagramme und Sitzungsverlauf öffnen
Löschen
Abonnenten 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
Gehen Sie zu Users → Hotspot Cards und klicken Sie auf Gruppe erstellen.
Füllen Sie das folgende Formular aus und klicken Sie auf Gruppe erstellen — SAMM generiert die Zugangsdaten jeder Karte automatisch.
Abschnitt
Felder
Identität
Eindeutiger Gruppenname, Beschreibung, optionales Benutzernamen-Präfix, Anzahl der zu generierenden Karten (bis zu 10.000)
Zugangsdaten
Format und Länge von Benutzername und Passwort (Zahlen / Buchstaben / alphanumerisch)
Bandbreitenbegrenzung
Download- und Upload-Geschwindigkeit — 256k, 6M, 1G; 0 = unbegrenzt
Transfer limitieren
Unbegrenzt, kombiniertes Limit oder separate Download/Upload-Limits (MB / GB / TB)
Zeitlimits
Uptime-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
Status
Bedeutung
Nicht verwendet
Generiert, aber nie angemeldet
Aktiv
In Verwendung, innerhalb der Grenzwerte
Aufgebraucht
Ein Limit (Kontingent, Betriebszeit oder Ablaufdatum) wurde erreicht
Deaktiviert
Manuell 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
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.
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.
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.
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.
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.
Belohnungen erstellen: höhere Geschwindigkeit (die Tarif-Geschwindigkeit wird für einige Tage multipliziert) oder kostenlose Tage, jeweils mit einem Preis in Punkten.
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
Melden Sie sich auf samm.securytik.com an und öffnen Sie Dashboard → Get a server.
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.
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.
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.
Ö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.
Die Kapazitätszeile zeigt, wie viele Benutzer hineinpassen, bevor Sie speichern.
Ü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
Öffnen Sie System → Settings → Data retention und schalten Sie sie ein.
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.
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?
Öffnen Sie Overview → Data Log → Data retention.
Geben Sie die öffentliche Adresse, den Port und die Uhrzeit aus der erhaltenen Anfrage ein.
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
Gehen Sie zu MikroTik → NAS und klicken Sie auf Router hinzufügen.
Füllen Sie die folgenden Felder aus und speichern Sie.
Feld
Bedeutung
NAS-IP / Hostname
Die Adresse des Routers, wie sie vom SAMM-Host gesehen wird
Kurzname
Ein benutzerfreundliches Label, das in der gesamten UI angezeigt wird
Typ
mikrotik schaltet die Live-Geräte-Synchronisierung und den Config-Push frei; andere Typen unterstützen nur RADIUS
Geheimnis
Das RADIUS shared secret — muss exakt mit dem des Routers übereinstimmen, andernfalls schlägt die Authentifizierung fehl
CoA-Port
UDP-Port, an den SAMM Change-of-Authorization-Pakete sendet (MikroTik-Standard 3799)
API Port / Benutzer / Passwort
MikroTik 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:
Einstellung
Wert
Kommentar
SAMM — das Tag, das SAMM verwendet, um diesen Eintrag später zu finden und zu aktualisieren
Dienst
hotspot, ppp
Adresse / Passwort
Der SAMM-Host mit dem Shared Secret aus diesem NAS-Eintrag
Zeitüberschreitung
3000 ms
Eingehende CoA
Akzeptiert, 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
Registerkarte
Anzeigeinhalt
Übersicht
Geräteinformationen, Systeminformationen und Diagramme zum Leistungsverlauf (CPU, Speicher, Sitzungen über die Zeit)
Schnittstellen
Jede Schnittstelle mit ihrem Live-Status sowie dem Traffic-Verlauf pro Schnittstelle
Websites & Apps
Drei 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
Registerkarte
Was Sie konfigurieren
Bridge
LAN-Bridges erstellen und auswählen, welche physischen Schnittstellen (Ports) zu welcher Bridge gehören
VLAN
VLAN-Schnittstellen hinzufügen und verwalten
IP
Drei Unter-Registerkarten — Static (statische und dynamische Adressen), DHCP client (Adresse vom Upstream beziehen), DHCP server (Adressen zuweisen, mit einer Live-Lease-Tabelle)
DNS
DNS-Server und Cache (der Inhaltsfilter für Apps/Standorte befindet sich unter Websites & Apps)
WiFi / CAPsMAN
Wi-Fi-Schnittstellen mit ihren Konfigurationen und Sicherheitsprofilen sowie der CAPsMAN-Controller — Konfigurationen, Provisioning-Regeln und Remote-CAPs
Dienste & Wartung
Registerkarte
Was Sie konfigurieren
PPPoE
PPPoE-Server, PPP-Profile, IP-Pools und das RADIUS-Accounting-Interim-Update-Intervall
Hotspot
Hotspot-Server, Hotspot-Profile und Benutzerprofile, DHCP/IP-Pools und die Captive-Portal-Login-Seite
Internet
WAN-Uplinks — von SAMM verwaltete WANs und Standard-Routen, wobei alle vorhandenen Nicht-SAMM-WANs schreibgeschützt angezeigt werden
Firewall
Filterregeln, 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
Aktualisieren
RouterOS-Updates — Update-Kanal auswählen, prüfen und anwenden sowie installierte Pakete überprüfen
Assistent
Die 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.
Willkommen & Erkennung — SAMM prüft den Router und zeigt an, was bereits konfiguriert ist, sodass Sie diese Punkte beim Push überspringen können.
Bridge-Schnittstelle — Name der LAN-Bridge vergeben.
Bridge ports — wählen Sie aus, welche physischen Schnittstellen der Bridge hinzugefügt werden.
DNS — Upstream-Resolver festlegen (Ein-Klick-Presets für Google, Cloudflare, Quad9 und weitere), Cache-Größe und optional einen DNS-Content-Filter konfigurieren.
NTP — legen Sie die Zeitquelle des Routers fest (NTP-Client und optional Zeitbereitstellung für das LAN).
Internet — einen oder mehrere WAN-Uplinks hinzufügen (Static / DHCP / PPPoE).
RADIUS to SAMM — konfigurieren Sie den Router so, dass er Ihren SAMM-Host für Authentifizierung, Accounting und CoA nutzt.
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.
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.
Ü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
Öffnen Sie Devices → Network Health und drücken Sie Tiefenprüfung, oder klicken Sie mit der rechten Maustaste auf einen Router auf der Seite.
Schalten Sie die zu prüfenden Router ein. Alle Schalter starten aus. Nur MikroTik-BNGs mit gespeichertem Login werden angezeigt.
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.
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:
Die Aktion wird in einem Audit-Log als queued command aufgezeichnet.
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.
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.
Status
Bedeutung
ausstehend
Warteschlange, wartet auf den nächsten samm-radius Tick
gesendet
Versendet (vorübergehend — der Versand und dessen Ergebnis werden im selben Tick aufgezeichnet, sodass Zeilen selten in diesem Zustand verbleiben)
nack
Der Router hat das CoA-Update abgelehnt — SAMM versucht es erneut und führt anschließend einen Verbindungsabbruch durch
Fertig
Erfolgreich angewendet
fehlgeschlagen
Nach 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.
Kachel
Anzeigen
Öffnen
Jetzt online
Abonnenten mit einer derzeit aktiven RADIUS-Sitzung
Benutzer nach Online gefiltert
Aktive Teilnehmer
Aktive Konten, mit der Gesamtzahl der Teilnehmer darunter
Benutzer gefiltert nach Active
Abgelaufen
Abonnenten, deren Abonnement abgelaufen ist und für die kein nächster Tarif festgelegt wurde
Benutzer nach Expired gefiltert
Offene Tickets
Noch nicht gelöste Support-Tickets (ausgenommen erledigt & geschlossen)
Benutzer → Support-Tickets
Router
Gesamtzahl der NAS-Datensätze, zuzüglich der Anzahl der derzeit nicht erreichbaren Datensätze
Der MikroTik-Monitor
Offene Rechnungen
Rechnungen, bei denen eine Zahlungserinnerung aussteht
Rechnungen 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.
Metrik
Bedeutung
samm-radius Queue
Ausstehende 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 ausstehend
Warteschlange von Administrator-Aktionen, die noch nicht von samm-radius angewendet wurden
Sitzungen gedrosselt
Abonnenten, die derzeit durch ein Limit auf eine reduzierte Geschwindigkeit gedrosselt werden — erwartet, kein Fehler
Sitzungs-Snapshot
Die Anzahl der Live-Sitzungen — sollte mit Online jetzt übereinstimmen
Aktive Tarife
Die 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
Spalte
Bedeutung
Benutzer
Benutzername — verlinkt zur Detailseite des Abonnenten
Framed IP
Die vom Router dieser Sitzung zugewiesene Adresse
Router
Der NAS-Kurzname und seine IP-Adresse
Tarif
Aktueller Tarif des Abonnenten
Effektive Geschwindigkeit
Die 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 / Up
Echtzeit-Byte-Zähler für die Sitzung
Online
Sitzungsdauer
Gestartet
Wenn 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:
Liste
Prioritäten
Top 10 Downloads heute
Größter Download seit dem letzten täglichen Reset
Top 10 Upload heute
Höchster Upload seit dem letzten täglichen Reset
Top 10 Downloads des Monats
Größter Download in diesem Kalendermonat
Top 10 Upload des Monats
Hö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:
Abbildung
Bedeutung
Verfügbares Guthaben
Gesamtsaldo aller Kassen- & Bankkonten
Ausstehende Forderungen
Forderungen — unbezahlte Kunden- und Reseller-Rechnungen
Offener Betrag
Verbindlichkeiten — offene Ausgaben
Gewinn diesen Monat
Einnahmen 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:
Feld
Bedeutung
Kunde
Auto-Vervollständigung für das zu fakturierende Konto
Standardmäß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
Einzelposten
Eine 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:
Auswahl
Abrechnungsposten
Vollständige Rechnung
Nur ganze Tarifzeiträume — angebrochene Zeiträume werden auf einen vollen Zeitraum aufgerundet.
Aufgeteilte Rechnung
Die 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:
Einstellung
Bedeutung
Provision %
Der Anteil des Agenten am Einzelhandelspreis (z. B. 40 % — Sie behalten 60 % als Großhandelsumsatz). Jederzeit pro Agent bearbeitbar.
Kreditlimit
Wie weit das Prepaid-Guthaben des Agenten ins Minus gehen darf, bevor Verlängerungen abgelehnt werden. Für striktes Prepaid 0 eingeben.
Prepaid-Guthaben
Laden 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:
Bericht
Antworten
Gewinn & Verlust
Einnahmen gegenüber Ausgaben und Nettogewinn über einen Zeitraum. Periodengerechte Abrechnung — Einnahmen werden bei Rechnungsstellung erfasst, Ausgaben bei Entstehung, nicht beim Geldfluss.
Bilanz
Stichtag: Gegenüberstellung Ihrer Vermögenswerte (Aktiva) und Verbindlichkeiten (Passiva) zuzüglich des Eigenkapitals. Ein balanced-Badge bestätigt, dass beide Seiten übereinstimmen.
Cashflow
Pro Barkonto — Anfangsbestand, Geldeingänge, Geldausgänge, Endbestand über einen Zeitraum.
Aging
Offene Forderungen und Verbindlichkeiten, sortiert nach Altersstufen, damit Sie überfällige Rechnungen einfordern und Zahlungsfristen einhalten können.
Erweitert
Die 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:
Ablehnung
Bedeutung
Dieser Datensatz existiert nicht mehr
Der Abonnent, die Rechnung oder die Zahlung wurde nach Ihrer Aktion gelöscht – es gibt nichts mehr, was wiederhergestellt werden könnte.
Dieser Datensatz existiert bereits
An seiner Stelle wurde ein neues Element erstellt; ein Rückgängigmachen würde den neueren Datensatz überschreiben.
Dieser Datensatz wurde durch Ihre Aktion geändert
Jemand 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 enthalten
Das 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:
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)
Öffnen Sie Financial → Online payments (nur Superadmin).
Klicken Sie auf ein Gateway, um es zu erweitern — Stripe, PayPal oder Binance.
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.
Klicken Sie auf Run test, um zu bestätigen, dass Ihre Zugangsdaten funktionieren.
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
Erstellen Sie ein kostenloses Konto bei stripe.com. Lassen Sie den Test mode aktiviert, während Sie die Funktion testen.
Gehen Sie zu Developers → API keys und kopieren Sie den Secret key (dieser beginnt mit sk_).
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.
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
Erstellen Sie ein PayPal Business-Konto, erstellen Sie dann unter developer.paypal.com eine REST-App und kopieren Sie deren Client ID und Secret.
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.
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.
Bei Binance anmelden → Account → API Management öffnen (oder nach „API Management“ suchen).
Klicken Sie auf Create API → wählen Sie System generated → benennen Sie diese z. B. "SAMM" → schließen Sie die Sicherheitsprüfung ab.
Binance zeigt den API Key und den Secret Key an — kopieren Sie beide jetzt (der Secret Key wird nur einmal angezeigt).
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.)
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
Gehen Sie bei Binance zu Wallet → Spot → Deposit (Deposit Crypto).
Wählen Sie die Coin USDT.
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.
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.
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).
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.
Ö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.
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.
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.
Ö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
Sie melden sich im Kundenportal an → Meine Rechnungen.
Bei einer unbezahlten Rechnung klicken Sie auf Bezahlen (oder „Pay · Stripe“ / „Pay · Binance“, falls mehrere aktiviert sind).
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.
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.
Typ
Verwendung für
WireGuard
RouterOS 7 Router, Telefone und Laptops. Am schnellsten und einfachsten.
L2TP/IPsec
RouterOS 6 und 7 Router sowie Geräte, die kein WireGuard unterstützen.
SSTP
Zwei oder mehr Router unter RouterOS 6 oder 7, die das Internet über dieselbe öffentliche Adresse erreichen.
Registerkarte Server
Klicken Sie bei WireGuard auf Generate Keys, um das Server-Schlüsselpaar zu erstellen.
Überprüfen Sie den Listen-Port, die Tunnel-Adresse des Servers und den Adressbereich des Clients oder behalten Sie die Standardwerte bei.
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
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.
Ziehen Sie das Bild an die gewünschte Position und verwenden Sie den Schieberegler zum Zoomen. Ein transparenter Hintergrund bleibt transparent.
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:
Status
Bedeutung
Aktiv
Der Tunnel ist aktiv und leitet Datenverkehr weiter
Gestoppt
Konfiguriert, aber derzeit nicht aktiv
Nicht konfiguriert
Die Binärdatei ist vorhanden — Token einfügen, um sie zu konfigurieren
Nicht installiert
install.sh erneut ausführen, um die cloudflared-Binärdatei zu installieren
Es zeigt außerdem die cloudflaredVersion an und ob der Connector so eingestellt ist, dass er beim Booten automatisch startet.
Tunnel konfigurieren
Im Cloudflare Zero Trust Dashboard
(one.dash.cloudflare.com) öffnen Sie Networks → Tunnels
und wählen Sie Tunnel erstellen.
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.
Fügen Sie es in SAMM ein und klicken Sie auf Tunnel konfigurieren. SAMM übergibt das Token an cloudflared und startet den Connector.
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
Einstellung
Standard
Steuerung
samm-radius interval
30 s
Intervall für die Auswertung zeitgesteuerter Ereignisse und das Senden von CoAs
samm-worker interval
5 s
Router-Ping + MikroTik API Sync-Intervall
Interim-Abrechnungsintervall
60 s
Das an die Router übermittelte Accounting-Intervall
Tägliche Reset-Zeit
00:00
Wenn tägliche Nutzungszähler überlaufen
Server-Zeitzone
UTC
Zeitzone für Geschwindigkeitsfenster und den täglichen Reset
CoA Standard-Port
3799
Standard-UDP-Port für CoA-Pakete
Maximal CoA-Wiederholungen
3
Wiederholungsversuche 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.
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.
Änderungen
Wo es angezeigt wird
ISP-Name
Rechnungen, Belege, Hotspot-Karten, Portal-Header
Support-Telefon & E-Mail
Rechnungen und gedruckte Hotspot-Karten
Steuer- / Registernummer
Auf 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 & Satz
Fü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
Knoten
Beschreibung
Zweigstelle
Ein 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.
Superadmin
Immer 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
Limit
Was gezählt wird
Maximale Benutzerzahl
Wie viele Benutzer die Zweigstelle und die darunter liegenden Zweigstellen aufnehmen dürfen. Das Löschen eines Benutzers macht einen Platz frei.
Maximale Karten
Wie 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.
Wer
Ein Gerät der Zweigstelle
Mitarbeiter dieser Zweigstelle, der darüber liegenden Zweigstellen und der Zentrale
Verwalten
Personal der untergeordneten Zweigstellen
Ansehen, schreibgeschützt
Andere Zweigstellen
Nicht sichtbar
Benutzer dieser Zweigstelle und ihrer untergeordneten Zweigstellen
Anmeldung 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:
Level
Bedeutung
Nicht zulässig
Der Bereich ist vollständig aus der Seitenleiste ausgeblendet
Anzeigen
Nur-Lesezugriff
Bearbeiten
Vollzugriff — 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:
Rechts
Funktionsumfang
"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:
Einstellung
Auswirkung
Max. Perioden im Voraus
Das 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 Voraus
Das 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.
Steuerung
Funktionsweise
Prozentsatz
Positive Werte multiplizieren, negative Werte dividieren: +100% → doppelte Geschwindigkeit, −100% → halbe Geschwindigkeit, −500% → ein Sechstel davon. Die Geschwindigkeit erreicht niemals Null.
Tarife upgraden
Wählen Sie beliebig viele Tarife aus; jede Zeile zeigt den Tarifpreis, den aktiven Boost und die derzeitige effektive Geschwindigkeit.
Automatisch rückgängig machen nach
Stunden, 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.
Spalte
Anzeigeinhalt
Wenn
Die Zeit in Ihrer Zeitzone
Wer
Der Administrator, „ali, im Portal“, „ali, auf Telegram“, ein API-Token oder System
Was ist passiert
Ein Satz, nur mit den Feldern, die geändert wurden, alt → neu — zum Beispiel „Benutzer bearbeitet: Ablaufdatum: 01 Okt → 15 Okt“
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.
Tier
AAA-Benutzer
Hotspot-Karten
NAS / Router
Überwachung
Nicht registriert
25
25
1
3
Kostenlos
100
50
2
6
Lite
500
1,500
4
12
Plus
1,000
3,000
6
18
Pro
2,000
6,000
12
36
Mega
5,000
15,000
24
72
Max
10,000
30,000
unbegrenzt
unbegrenzt
Unlimited
unbegrenzt
unbegrenzt
unbegrenzt
unbegrenzt
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
Öffnen Sie System → License.
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.
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:
Phase
Was passiert
Warnung
Ein Erinnerungsbanner; der Betrieb wird nicht unterbrochen
Kulanzzeit
Ein kurzes Zeitfenster zur Reaktivierung; Abonnenten bleiben online
Soft Lockdown
Hintergrunddienste stoppen; RADIUS authentifiziert für etwa 7 Tage weiter
Hard Lockdown
Dienste 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:
Seite
Ansicht des Teilnehmers
Übersicht
Kontostatus, Tarif, Ablaufdatum, heutige und monatliche Nutzung, offene Rechnungen
Nutzung & Sitzungen
Gesamt heruntergeladen/hochgeladen, Uptime-Budget und vollständiger Sitzungsverlauf
Meine Tarife
Der aktuelle Tarif sowie der Katalog der verfügbaren Tarife
Meine Rechnungen
Abrechnungsverlauf mit PDF-Download per Klick
Support-Tickets
Support-Tickets öffnen und verfolgen
Profil
Kontaktdaten 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:
Ö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).
Kopieren Sie das Secret sofort — es wird nur ein einziges Mal angezeigt und nur dessen Hash wird auf dem Server gespeichert.
Überprüfen Sie die Funktion und sehen Sie, was das Token kann:
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
Bereich
Endpunkte
Geltungsbereich
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}
GET /plans · POST /plans · GET /plans/{plan_id} · PATCH /plans/{plan_id}
plans:readplans: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:readbilling: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:readbilling:write
Payment apps (collect)
GET /collect/lookup · POST /collect/payments · GET /collect/payments/{channel}/{reference}
collect:readcollect: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:readaddons: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:readcards:write
Sessions & CoA
GET /coa-outbox · GET /sessions · POST /coa-outbox/cancel · POST /coa-outbox/retry · POST /sessions/disconnect · POST /sessions/reconnect
coa:writesessions: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:readcustomers:write
Branches
GET /branches · PUT /customers/{customer_id}/branch
admins:writecustomers: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
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:writerouters: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:readbackups:write
History cleaner
POST /history/clean · GET /history/schedule · PUT /history/schedule · GET /history/space
history:readhistory: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:readvpn: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
GET /reports/activations · GET /reports/financial · POST /retention/lookup · GET /customers/{customer_id}/statement
accounting:readcustomers:readretention: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.
Ä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"])
Ereignis
Wenn
customer.created
A user account was created
customer.updated
A user account was updated
customer.renewed
A plan was renewed (expiration extended)
customer.plan_changed
A user moved to another plan
customer.expired
A user expired (expiration sweep)
customer.suspended
A user was suspended (by an admin or for not paying)
customer.restored
A suspended user was restored
customer.deleted
A user account was deleted
limit.exhausted
A usage limit was exhausted (quota / daily / uptime / expiration)
invoice.created
An invoice was created
invoice.updated
What an invoice owes changed (payment, discount, reversal, write-off)
invoice.paid
An invoice was marked paid
invoice.deleted
An invoice was deleted
payment.received
A payment was received and posted (online, payment app)
payment.reversed
A payment was voided or an invoice reopened
wallet.topup
Money was added to a user's prepaid wallet
addon.added
An add-on was given to or bought by a user
session.started
A user session started (off unless enabled in settings)
session.stopped
A user session stopped (off unless enabled in settings)
alert.opened
An alert opened (router down, service down, rogue DHCP server, new crash)
alert.resolved
An alert cleared on its own or was resolved
webhook.test
Manual 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
Datei
Warteschleifen
/etc/samm/samm.yaml
Datenbank-DSN, Connection-Pool-Größen, Log-Level
/etc/samm/api.env
Portal-Sitzungsgeheimnisse und die SMTP-Einstellungen zur Passwortwiederherstellung
/etc/samm/secret.key
Der 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 DatenverlustDies 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.