Documentación

SAMM documentación

El manual del operador completo: desde la primera instalación hasta las operaciones diarias.

25 temas 8 secciones Instalación con un solo comando
Instalación rápida

En línea en minutos, con un solo comando.

Ejecute una sola línea en un servidor Ubuntu o Debian limpio — o en PowerShell en Windows — y el instalador descargará la última versión y configurará todo el stack de SAMM por usted.

Lea la guía de instalación completa
Ubuntu / Debian — ejecutar como root
curl -fsSL https://samm.securytik.com/install.sh | sudo bash
Windows — ejecutar en PowerShell como administrador
irm https://samm.securytik.com/install-windows.ps1 | iex
Lista de reproducción Curso en vídeo Vea SAMM desde la instalación hasta las operaciones diarias: un curso completo en vídeo Una lista de reproducción de YouTube gratuita y paso a paso que le guía en la instalación de SAMM y su uso diario — el mismo contenido que cubre este manual, en video. Ver en YouTube

Primeros pasos

Descripción general de la arquitectura &

SAMM — SecuryTik Active Mikrotik Manager — es una plataforma completa de gestión de ISP para redes MikroTik PPPoE & Hotspot. Un solo instalador convierte un servidor Linux básico en un sistema completo de AAA, facturación y gestión de suscriptores.

A quién se dirige SAMM

SAMM está diseñado para ISPs inalámbricos, operadores de fibra y proveedores de hotspot que utilizan MikroTik RouterOS. Si autentica a sus suscriptores a través de PPPoE, Hotspot o IPoE/DHCP y necesita aplicar perfiles de velocidad, límites de datos, fechas de vencimiento y facturación, SAMM lo hace todo desde una sola pantalla.

Los suscriptores IPoE/DHCP se identifican mediante el circuit-id de la Opción 82 de DHCP (el puerto de acceso físico — el método profesional de los ISP) o la MAC del dispositivo, y el radius-password del servidor DHCP es simplemente el RADIUS shared secret del propio router, por lo que no es necesario aprovisionar nada adicional.

IPv6 dual-stack es una opción opcional: cada suscriptor puede obtener IPv6 junto con IPv4. Actívelo en el asistente del router y elija la longitud del prefijo delegado (DHCPv6-PD) —un /56 por defecto, o cualquier valor entre /48 y /64— y los bloques IPv6 a asignar. En cada Access-Accept, SAMM devuelve un pool de IPv6 WAN más un prefijo enrutado delegado a la LAN del suscriptor, de modo que el propio router del cliente (en modo ruta) lo subdivide en /64 y ejecuta SLAAC para sus dispositivos —el modelo estándar de delegación de prefijos de ISP. Funciona con PPPoE, Hotspot e IPoE, y se puede fijar un prefijo IPv6 estático por suscriptor para clientes empresariales.

Cómo funciona

SAMM mantiene la ruta crítica cerca de la base de datos. FreeRADIUS gestiona cada paquete de autenticación y accounting; en cada Interim-Update de accounting, llama directamente a funciones de PostgreSQL para acumular el consumo y evaluar los límites; no hay procesos intermedios de Python mientras los suscriptores están en línea.

Cuatro superficies de ejecución cooperan a través de una única base de datos:

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

Los cinco servicios

ServicioRol
samm-apiPortal del administrador + portal de autoservicio del cliente + REST API
samm-radiusVacía la bandeja de salida de CoA; ejecuta barridos de expiración / reinicio diario / ventana de velocidad
samm-workerRealiza ping a los routers; sincroniza los metadatos de los dispositivos MikroTik a través de la API
samm-notificationEnvía notificaciones por email & Telegram a través de una cola con limitación de tasa
samm-telegramEjecuta el bot interactivo de autoservicio de Telegram

Qué hace SAMM

Core AAA

Autenticación PPPoE & Hotspot, limitación de velocidad por usuario, CoA híbrido.

Planes & límites

Perfiles de velocidad, cuatro límites independientes y ventanas de velocidad programadas.

Suscriptores

Usuarios de PPPoE, Hotspot e IPoE/DHCP, además de tarjetas de voucher de hotspot prepago con PDFs imprimibles.

Facturación

Precios por plan, facturas automáticas y un libro mayor de partida doble para recibos, pagos y gastos.

Autoservicio

Un portal web para clientes y un bot de Telegram para el consumo, las facturas y los tickets.

Operaciones

Inventario de MikroTik en vivo, administradores basados en roles, copia de seguridad y restauración de &, herramientas masivas.

Sistema

WireGuard VPN integrada, Cloudflare túnel, ocho idiomas, interfaz de usuario temática.

Notificaciones

Alertas de renovación, vencimiento, cuota y recibos por correo electrónico y Telegram.

El resto de este manual es una guía paso a paso para cada una de estas áreas. Use el menú de la izquierda o comience con Instalación.

Primeros pasos

Novedades

SAMM se actualiza automáticamente, por lo que cada instalación obtiene estas funciones en su próxima actualización. Cada línea enlaza a la página que explica cómo utilizarlas.

6.0

  • Diseños de tarjetas: diseñe su propia tarjeta Hotspot impresa (tamaño, fondo, su logotipo y un código QR que inicia sesión con un solo escaneo), o parta de diez diseños listos. Cada grupo tiene un diseño para imprimir y otro para la impresión rápida en una impresora térmica (80 o 58 mm). Tarjetas de Hotspot
  • Añadir una tarjeta o importar una lista: + Card añade una tarjeta con el usuario, la contraseña y el nombre que elija; Import trae una lista CSV o Excel con una vista previa. Tarjetas de Hotspot
  • Tiempo y datos restantes en el router: la página de estado del Hotspot muestra lo que queda en una tarjeta, y el router cierra la sesión cuando se agota. Tarjetas de Hotspot
  • Un pool de IP por usuario (por ejemplo, un pool CGNAT), elegido entre los pools de sus routers. CGNAT y pools de IP
  • Todas las zonas horarias del mundo, con Oriente Medio primero.
  • Inspección profunda: elige tus BNG MikroTik y cuánto tiempo ejecutar, y luego lee un informe con una puntuación y qué hacer primero, en tu idioma, como página o PDF. Solo lee el router. Inspección profunda
  • SCOOP AI: un asistente en la parte inferior de cada página. Pregunta con tus palabras sobre usuarios, planes, facturas y routers; el dinero, las eliminaciones y los cambios en routers esperan tu Approve. SCOOP AI
  • Colas de usuarios más rápidas: mantiene fluidas las llamadas y los juegos mientras un usuario descarga. El asistente de router puede configurarlas, y Health ofrece una solución con un clic.
  • Panel por rol: elige si un rol ve el panel. Un rol sin él abre en su primera página permitida.
  • Sham Cash: en la conexión no oficial, un usuario que olvidó el código puede confirmar el pago con el número de transferencia y su propia dirección.

5.12

  • Conservación de datos y Lookup: conserve las sesiones durante el periodo que exige la ley (dos años por defecto), incluso para usuarios eliminados, y averigüe qué usuario tenía una dirección pública y un puerto en un momento dado. Cada búsqueda necesita un número de caso y queda registrada en el registro de Lookup; un archivo cifrado diario puede enviarse a su NAS. Conservación de datos & Lookup
  • CGNAT y pools de IP: comparta direcciones públicas entre usuarios con un bloque de puertos para cada uno, o deje que SAMM asigne la dirección a los usuarios por router y plan. CGNAT & pools de IP
  • Cisco, Huawei, Nokia y ZTE como NAS, con velocidades, desconexiones, una página de configuración lista, el Data Log y CGNAT en Cisco. Otras marcas de routers
  • FTTH: OLT de V-SOL, Huawei, ZTE y Nokia, cada ONU con su señal, ONU vinculadas a usuarios y el bloqueo de línea del abonado. FTTH & OLTs
  • Páginas de dispositivo para cada marca: CPU, memoria, temperatura, tiempo de actividad y gráficos para OLT y otros routers, como MikroTik; el formulario del router pide el acceso correcto para cada tipo. Otras marcas de routers
  • VPN a través de SAMM por router: A través de SAMM o A través del router; los pagos con Sham Cash nunca pasan por la VPN. VPN a través de SAMM
  • Uso por usuario: una tarjeta de Periodo seleccionado (total, sesiones, tiempo en línea) y una franja con plan, estado, vencimiento, dirección y MAC; el bot de Telegram muestra sus comandos en el idioma del usuario. Usuarios
  • Configuramos su servidor: pida un servidor SAMM listo con su propio dominio .com desde su panel. Configure su servidor

5.11

  • Cajero: una página de caja en Contabilidad. Busque un usuario por nombre, número de móvil o parte del nombre de usuario mientras escribe y luego cobre su pago, renuévelo, añada cuota o recargue su monedero en efectivo. Tiene su propio permiso con cuatro opciones, no muestra beneficios ni informes y solo encuentra a los usuarios de la sucursal del cajero. Contabilidad, Administradores, sucursales y roles
  • Vencimiento de factura a su elección: «Factura vence a los (días)» en los ajustes de contabilidad. Con 0 una factura vence al emitirse y una renovación automática el día en que vence el plan, así el periodo de gracia cuenta desde la fecha de vencimiento del plan. Contabilidad
  • Compensación al pasar a un plan más barato: al pasar a un usuario a un plan más barato se le puede devolver la parte no usada del periodo al monedero o en efectivo, con el importe mostrado antes de guardar. Cambiar plan también está en el menú de fila de la lista de Usuarios. Usuarios
  • La renovación automática se paga desde el monedero, y el monedero de un usuario moroso salda la deuda antes de suspender la cuenta. Contabilidad
  • Notificaciones por canal: elija qué canales puede usar cada notificación, envíe por todos y escriba un texto SMS aparte con contador de caracteres en vivo. Notificaciones
  • VPN a través de SAMM sin túnel para routers en la misma red que SAMM, y control parental y VPN de un usuario gestionados desde el panel de administración. VPN a través de SAMM
  • Cuota de interfaz que se reinicia bien: Reset quota cuenta desde cero y reactiva la interfaz al instante, en cualquier momento, con el consumo desde el último reinicio en la página. Gestor de MikroTik
  • Listas de sitios web y aplicaciones por router: cada router muestra si su lista está al día, con Aplicar y hallazgos en la página Salud; los valores de supervisión se actualizan cada 5 segundos. Gestor de MikroTik

5.9

  • Proveedores de VPN externos: añada una cuenta de NordVPN, Mullvad, IVPN o AirVPN en un solo paso, elija cuántos servidores y en qué país, o suba archivos de cualquier proveedor, como ProtonVPN. Cada usuario se mantiene en una sola conexión, las conexiones reparten la carga según su peso y, si una se detiene, sus usuarios siguen navegando a través de la línea propia de SAMM. VPN a través de SAMM
  • Cuota extra como complemento: venda más datos sin cambiar el plan ni la fecha de vencimiento del usuario, en forma de paquete o de precio por GB, desde el panel o desde el portal del usuario. Complementos
  • Sectores inalámbricos: cada radio de usuario con el sector en el que está, cuánto tiempo permaneció en él y cada cambio, guardado durante un año; los switches detrás de sus sectores con los usuarios de cada uno; y, en la página del usuario, la cadena sector › radio › switch › usuario con señal, alcance y calidad. Red
  • Supervise a un usuario durante 24, 48 o 72 horas: tiempo en línea, velocidad, señal, sector y cada desconexión con su causa, y luego un informe imprimible con gráficos y un breve resultado. Usuarios
  • Mapa de red en OpenStreetMap: ubique sus routers, sectores y usuarios donde realmente están, junto al diagrama. Red
  • Actualizaciones de la lista de aplicaciones: SAMM comprueba la lista de aplicaciones de SecuryTik cada día; elija «Notificarme», «Aplicar automáticamente» o «Desactivado», y restaure la lista anterior con un solo clic. Gestor de MikroTik
  • Fechas «Desde» y «Hasta» en cada búsqueda que tenga fecha, filtros de Control parental y VPN en la lista de usuarios, y la misma página abierta en tantas ventanas como pantallas tenga. Usuarios, Panel
  • Migración desde ADV Radius: traiga usuarios y planes desde su archivo de copia de seguridad, con contraseñas, fechas de vencimiento, direcciones estáticas y límites de plan. Herramientas

5.8

  • VPN externa: los usuarios de VPN salen por NordVPN (con un token de acceso) o los archivos WireGuard de cualquier proveedor en lugar de la línea de SAMM, incluso cuando SAMM no tiene dirección pública. VPN a través de SAMM
  • VPN a través de SAMM: los usuarios elegidos envían todo su tráfico, o solo las apps que escojan, por tu servidor SAMM en lugar de su línea local. Actívalo por usuario o véndelo como complemento; los usuarios lo encienden en el portal de usuario. VPN a través de SAMM
  • SAMM en dos pantallas: abre cualquier página, o un solo bloque del panel, en su propia ventana y mantenla en un segundo monitor. Panel
  • Control parental como complemento: vende el control parental por un período, como cualquier otro complemento. Complementos
  • Optimizador de Wi-Fi: una vista del espectro en tiempo real de cada radio, las redes que detecta y el nivel de saturación de cada canal, con un planificador de canales que recomienda el canal más despejado y el ancho óptimo, y puede cambiar los radios automáticamente por la noche. Red
  • Dispositivos Ubiquiti: añada puntos de acceso UniFi y radios airOS como dispositivos monitoreados. Las radios UniFi muestran sus clientes, redes vecinas y el espectro, y el optimizador los mueve efectivamente a un mejor canal y ancho. Gestor MikroTik
  • Tres monitores para cada router en cada plan: los puntos de acceso y radios que solo supervisa ya no consumen la cuota de routers. Gestor MikroTik
  • Importar los usuarios que un router ya tiene (PPP, Hotspot y User Manager, RouterOS 6 y 7) con sus contraseñas, planes, límites, nombres, números de teléfono y fechas de finalización, en segundo plano. Gestor MikroTik
  • Revertir una renovación: al eliminar la factura de una renovación, la fecha de vencimiento del usuario puede volver a su estado anterior; la acción Renew Plan se puede deshacer desde la barra superior y la lista de Invoices muestra los totales de todo lo que indica el filtro. Deshacer & aprobaciones
  • Copias de seguridad en su propio Google Drive. Conecte Google Drive en Backup & Restore mediante un código corto; cada copia de seguridad automática se copiará también en una carpeta de SAMM Backups en su Drive, y cualquier copia puede recuperarse para ser restaurada. Tools
  • Hora de renovación fija en un plan: cada vencimiento ocurre a la hora que usted elija, redondeada al alza para que un usuario nunca reciba menos que el periodo. Plans
  • Lista de direcciones por plan: el router añade la dirección de cada usuario a una lista con el nombre de su plan, para que usted defina sus propias reglas de cortafuegos, colas y enrutamiento. Plans
  • Modo de Recolección de Autoservicio: los invitados ingresan su nombre y número de móvil y se conectan al instante, sin código de acceso; cada inicio de sesión se guarda para su exportación. Autoservicio
  • Un gráfico de calidad de conexión más claro con ejes, líneas de descarga y subida, detalles al pasar el cursor y datos utilizados, además de e-mail en la búsqueda de usuarios y cualquier puerto en la búsqueda del Data Log. Users, Data Log

5.7

  • Las sucursales son propietarias de sus dispositivos. Cada router y punto de acceso pertenece a una sucursal o a la oficina central; el personal de la sucursal gestiona sus propios dispositivos y solo puede ver los de niveles superiores, y un ajuste permite que los usuarios inicien sesión únicamente a través de los routers de su sucursal. Administradores, sucursales & roles
  • Límites de tiempo de rol. Limite cuántos periodos o días por adelantado puede otorgar un rol, asigne a los nuevos usuarios un tiempo fijo (por ejemplo, 2 horas) y separe la opción Añadir días de la introducción de una fecha de expiración. Administradores, sucursales & roles
  • SSTP VPN junto con WireGuard y L2TP/IPsec, para varios routers detrás de la misma dirección pública. VPN
  • RouterOS 6 funciona en todas partes: asistente, Auto-Complete, entrega de configuración, acciones masivas, Websites & Apps, QoS y enlaces VPN. RouterOS 6
  • Control parental en el portal del usuario: bloquear categorías, apps y sitios web, de forma permanente o mediante un calendario semanal. Control parental
  • Puntos de & recompensas por renovaciones y amigos invitados, canjeables por mayor velocidad o días gratis. Puntos de & recompensas
  • Su marca en el panel del administrador, el portal del usuario y las páginas de inicio de sesión, con un logotipo que puede recortar en el navegador. Branding
  • Selectores de idioma, visibilidad del plan en el portal, modo de plantilla de SMS e instalación de SAMM en una sola línea en un router MikroTik. Idiomas, Planes, Contenedor MikroTik

5.6

  • Entrega de configuración: cada cambio enviado a sus routers se rastrea con un resultado por router, llega a los routers desconectados cuando vuelven a estar en línea y se reintenta automáticamente. Entrega de configuración
  • Un panel que se abre en aproximadamente un segundo y una barra lateral que permanece fija mientras cambian las páginas.

5.5

  • Búsqueda en el Data Log de todos los usuarios: quién accedió a una dirección, puerto, protocolo o app, en cualquier periodo. Data Log
  • Permisos detallados en Editar (eliminar usuarios, extender, cambiar plan, pagar facturas, ejecutar scripts del router…), y una vista previa de la nueva fecha de vencimiento antes de renovar. Roles

5.4

  • Finanzas por sucursal: cada factura, pago, gasto y cuenta de efectivo pertenece a una sucursal, con un selector de sucursal, traspasos de efectivo y un informe de sucursales. Contabilidad & facturación

5.3

  • Sham Cash, un checkout para cada método de pago, una Página de pago pública y Renovación en línea de 1 a 12 periodos. Pagos en línea
  • Descuentos en facturas, complementos con aplicaciones gratuitas, el informe de Activaciones, cambio de nombre de usuario y pagos anticipados en renovaciones. Add-ons

5.2

  • Dynamic Speed Booster, acciones del gestor en múltiples routers a la vez, complementos, listas de precios por sucursal, archivos de usuario, campos personalizados, la página de Tráfico y el limpiador de Historial. Speed Booster, acciones del gestor

Primeros pasos

Instalación

SAMM instala todo lo necesario — FreeRADIUS, PostgreSQL, nginx, WireGuard, cloudflared y los cinco servicios de SAMM — en un solo paso. El instalador es idempotente: volver a ejecutarlo actualiza una instalación existente in situ y nunca sobrescribe su configuración ni regenera la contraseña de su base de datos.

Manual de instalación

Cada paso con capturas de pantalla: Windows (incluida la activación de la virtualización en la BIOS), Ubuntu, un router MikroTik, un servidor listo, la licencia (pagar, vincular, renovar), la conexión de sus routers por la VPN y las funciones adicionales.

SAMM se ejecuta en cualquier lugar; elija la ruta de instalación que mejor se adapte a su red:

Requisitos previos

  • Un servidor limpio: Ubuntu 22.04 / 24.04 / 26.04 LTS, o Debian 12 / 13. Solo Linux de grado servidor; las variantes de escritorio no son compatibles.
  • Acceso Root / sudo y una conexión a internet.
  • systemd y un host donde se pueda instalar PostgreSQL localmente (uno ya está configurado para usted).

Instalación

Opción A — instalar con un solo comando

En el servidor, ejecute:

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

Este script de bootstrap descarga el paquete de la última versión de SAMM desde GitHub, lo extrae y ejecuta el instalador completo automáticamente. Todo queda listo en unos pocos minutos.

Si github.com está bloqueado en su país, utilice en su lugar el mirror alojado en Cloudflare: es el mismo instalador y no se descarga nada desde GitHub. (El comando estándar anterior también detecta si GitHub está bloqueado y cambia a este mirror automáticamente)

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

De cualquier modo, una vez que el instalador finalice, abra el portal del administrador e inicie sesión con estas credenciales:

URL de inicio de sesiónhttp://<your-server>/admin · Nombre de usuarioadmin · Contraseñaadmin

Cambie la contraseña del administrador inmediatamente después de su primer inicio de sesión.

Instalación

Opción B — instalar en Windows (Hyper-V)

SAMM se ejecuta en Windows dentro de su propia pequeña máquina virtual Ubuntu 24.04 en Hyper-V, creada y gestionada por un único instalador. La VM se une a su red con su propia dirección IP, por lo que sus routers MikroTik acceden a SAMM directamente — RADIUS ve la dirección real de cada router y las desconexiones CoA funcionan — exactamente como en un servidor Linux.

Abra PowerShell como administrador — no el Símbolo del sistema (cmd): haga clic derecho en el botón de Inicio, elija Terminal (Administrador) o Windows PowerShell (Administrador) y haga clic en Sí. Luego ejecute:

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

Si samm.securytik.com no está disponible desde este PC, utilice en su lugar el mirror alojado en Cloudflare; es el mismo instalador. (El propio instalador también cambia automáticamente al mirror cuando falla una descarga)

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

De cualquier modo, una vez que el instalador finalice, abra el portal del administrador e inicie sesión con estas credenciales:

URL de inicio de sesiónhttp://<SAMM IP>/admin · Nombre de usuarioadmin · Contraseñaadmin
Inicio de sesión en el OS (SSH)samm / samm · Root (consola)root / samm

Los mismos valores predeterminados que la ISO del servidor SAMM. Cámbielos todos después de su primer inicio de sesión. El acceso directo SAMM Info en el escritorio los muestra nuevamente, junto con la dirección IP de SAMM y cómo acceder a la VM a través de SSH.

Lo que solicita

  1. A qué red debe unirse SAMM cuando el PC tiene más de un adaptador conectado. Presione Enter para seleccionar la recomendada (cableada antes que Wi-Fi).
  2. la dirección IP de SAMM en esa red. El sistema sugiere una disponible; presione Enter para aceptarla, escriba otra o escriba dhcp.

Si Hyper-V está desactivado, el instalador lo activa y solicita reiniciar Windows una vez; después de que usted inicie sesión nuevamente, el proceso continúa automáticamente. El resto —Multipass, el puente de red, la VM y el propio SAMM— tarda de 10 a 20 minutos, con una barra de progreso.

Requisitos

  • Windows 10 / 11 Pro, Enterprise o Education, o Windows Server 2019 y versiones posteriores (64 bits). Windows Home no dispone de Hyper-V.
  • Virtualización de hardware activada en la BIOS/UEFI (Intel VT-x o AMD-V). El instalador lo comprueba y se detiene con un mensaje claro si está desactivada; consulte Activar la virtualización.
  • Al menos 8 GB de memoria, con 4 GB libres para la VM de SAMM (el mínimo es 3 GB; otras máquinas virtuales — VMware, VirtualBox — se descuentan de este total), y 40 GB de disco libre.
  • Se recomienda encarecidamente el uso de un cable de red. Muchos controladores de Wi-Fi no permiten crear un puente entre una máquina virtual y la red, por lo que solo el propio PC podrá acceder a SAMM.

Tras la instalación

  • Abra el panel del administrador en http://<SAMM IP>/admin/login (hay un acceso directo a SAMM Admin en el escritorio), inicie sesión con admin / admin y cambie la contraseña inmediatamente.
  • Configure el RADIUS de su MikroTik hacia la IP de SAMM (UDP 1812/1813); el asistente de router en el panel lo hace por usted.
  • SAMM se inicia con Windows, antes de que cualquier usuario inicie sesión, y el PC está configurado para no suspenderse nunca. En un portátil, mantenga el cargador conectado y configure el cierre de la tapa en "No hacer nada".
  • Para eliminarlo: ejecute la misma línea con -Uninstall, o & ([scriptblock]::Create((irm https://samm.securytik.com/install-windows.ps1))) -Uninstall.

Instalación

Activar la virtualización en la BIOS/UEFI

SAMM en Windows se ejecuta en una máquina virtual Hyper-V, la cual requiere la función de virtualización del procesador: Intel Virtualization Technology (VT-x) en Intel, o AMD-V —normalmente llamada SVM Mode— en AMD. La mayoría de los PC la traen activada de fábrica; algunos la tienen desactivada. Cada marca la ubica en un menú diferente, por lo que a continuación se presentan los pasos generales y dónde se encuentra habitualmente.

Primero, compruebe si ya está activado

Abra el Administrador de tareas (Ctrl+Shift+Esc) → Rendimiento → CPU. Debajo del gráfico, Virtualización: Habilitado significa que el proceso ha finalizado. (Si Hyper-V ya está activado, es posible que Windows muestre un mensaje indicando que se detectó un hipervisor; esto también significa que está activado)

Pasos generales

  1. Guarde su trabajo y reinicie el PC.
  2. Abra la configuración de BIOS/UEFI: presione repetidamente la tecla de configuración tan pronto como se ilumine la pantalla (consulte la tabla). En Windows 10/11 también puede ir a Settings → System → Recovery → Advanced startup → Restart now, luego a Troubleshoot → Advanced options → UEFI Firmware Settings → Restart.
  3. Busque en el menú Advanced, Advanced CPU, Processor, Chipset, Security o Virtualization las opciones Intel Virtualization Technology, Intel VT-x, SVM Mode o AMD-V, y establézcalas en Enabled. (Intel VT-d / AMD IOMMU no es necesario.)
  4. Guardar y salir (normalmente F10), deje que Windows se inicie y luego ejecute el instalador de SAMM nuevamente.

Ubicación habitual

MarcaClave de configuraciónUbicación habitual
DellF2Soporte de Virtualización → Virtualización / Habilitar Intel Virtualization Technology
HPF10 (o Esc, luego F10)Avanzado (o Seguridad / Configuración del Sistema) → Virtualization Technology (VTx)
LenovoF1 / F2 (o el botón Novo)Seguridad (ThinkPad) o Configuración → Intel Virtualization Technology / AMD SVM Technology
ASUSF2 / DelModo avanzado (F7) → Avanzado → Configuración de CPU → Intel Virtualization Technology o SVM Mode
AcerF2Avanzado (o Principal) → Intel Virtualization Technology
MSIDelOC → CPU Features → Intel Virtualization Tech o SVM Mode
GigabyteDelTweaker (o Advanced) → Advanced CPU Settings → Intel Virtualization Technology o SVM Mode
Servidores (Dell iDRAC, HPE, Supermicro)F2 / F9 / DelAjustes del procesador → Virtualization Technology — a menudo ya activada
Una máquina virtual dentro de otra máquina virtual (Windows ejecutándose en VMware, Proxmox o Hyper-V) requiere que la virtualización anidada esté activada en el hipervisor externo; por ejemplo, "Virtualize Intel VT-x/EPT" en los ajustes de CPU de VMware, con la VM apagada.

Instalación

Opción C — instalar manualmente desde un paquete de versión

Descargue el archivo samm-<version>.tar.gz más reciente desde la página de GitHub Releases, luego en el servidor:

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

También puede realizar el despliegue desde un archivo zip generado en otra máquina; el instalador utiliza rsync para copiar el origen en el propio directorio /opt/samm:

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

O clone el repositorio en /opt/samm y ejecute sudo bash /opt/samm/install.sh.

De cualquier modo, una vez que el instalador finalice, abra el portal del administrador e inicie sesión con estas credenciales:

URL de inicio de sesiónhttp://<your-server>/admin · Nombre de usuarioadmin · Contraseñaadmin

Cambie la contraseña del administrador inmediatamente después de su primer inicio de sesión.

Instalación

Opción D — instalar con Docker Compose

Si prefiere ejecutar SAMM como contenedores —el mismo producto, pero empaquetado de forma diferente— use la distribución de Docker Compose en github.com/mhdhaidarah/samm-docker. En cualquier host que tenga Docker disponible:

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

Esto instala Docker si no está presente, coloca un docker-compose.yml en /opt/samm-docker/ con una contraseña de base de datos aleatoria y segura ya configurada, e inicia el stack. La imagen mhdhaidarah/samm se construye a partir del mismo paquete compilado que la instalación bare-OS; es de código cerrado por diseño.

Multi-arch — la misma etiqueta se distribuye para linux/amd64 y linux/arm64, y la variante correcta se selecciona automáticamente a partir de la etiqueta: docker pull en cualquier host de Docker (Intel/AMD, servidor ARM, Mac con Apple-silicon), y MikroTik RouterOS 7.23+ en el propio router. Un solo archivo, todas las plataformas.

En los hosts donde no se permite redirigir curl a bash (equipos restringidos, políticas de egreso estrictas), puede obtener el archivo compose listo para ejecutar directamente:

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

Algunas funciones aún no están disponibles en la variante de Docker (bloqueo de licencia escalonado, recarga dinámica de FreeRADIUS). Las páginas de administrador integradas de WireGuard y Cloudflare Tunnel están ocultas intencionadamente en la variante de Docker — gestionan servicios de systemd a nivel de host que no son accesibles desde el interior del contenedor. Elija la Opción A o C arriba si necesita que estén integradas, o ejecute cloudflared / wg-quick directamente en el host de Docker junto a SAMM. Consulte el README de la variante de Docker para ver todas las advertencias de la v1 y la ruta de instalación manual.

En Windows (Docker Desktop) — solo para evaluación

No recomendado para producción. La suspensión, hibernación o el cierre de la tapa en Windows detienen los contenedores; el reinicio al arrancar solo se ejecuta cuando inicia WSL (no al iniciar Windows); el cron de actualización automática diaria solo funciona mientras WSL esté activo. Utilícelo para evaluación o demostraciones, y luego despliegue el entorno de producción en una VM de Linux (Hyper-V, Proxmox, ESXi) o en un equipo físico pequeño (por ejemplo, un NUC con Ubuntu Server).

Instale Docker Desktop para Windows (esto permite configurar el backend de WSL2 en el primer inicio). Luego, desde PowerShell —no es necesaria una terminal de WSL— descargue el paquete de compose e inicie el 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

Observe el arranque del stack en Docker Desktop → Containers — el grupo samm se expande en 8 servicios. Una vez que todos estén en verde, abra el portal del administrador e inicie sesión con estas credenciales:

URL de inicio de sesiónhttp://localhost:8000/admin · Nombre de usuarioadmin · Contraseñaadmin

Cambie la contraseña del administrador inmediatamente después de su primer inicio de sesión.

Si un NAS MikroTik real accede a este host de Windows para RADIUS, permita UDP 1812 + 1813 a través del cortafuegos de Windows:

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

Desinstalar: docker compose down -v desde el directorio de instalación (el parámetro -v borra el volumen de postgres y la clave Fernet; realice una copia de seguridad de ambos primero si ha añadido datos).

Instalación

Opción E — instalar en un router MikroTik (RouterOS 7.23+)

Mismo SAMM, sin necesidad de un equipo Linux. Si su dispositivo MikroTik soporta el paquete container y tiene una unidad USB o microSD conectada, puede ejecutar todo el stack directamente en el router — con el mismo docker-compose.yml utilizado en cualquier otro lugar. RouterOS 7.23+ obtiene automáticamente la arquitectura de CPU correcta a partir de las etiquetas de imagen multi-arch, por lo que no hay nada específico del router que descargar.

Soportado: todo router MikroTik compatible con contenedores — RB5009, hAP ax², CCR2004-1G-12S+2XS, CCR2116, CCR2216, L009 y similares (arm64), además de RouterOS x86 y CHR (amd64). No soportado: dispositivos armv7 / mipsbe / smips / tile / ppc (hEX, RB750, modelos RB antiguos) — no cuentan con soporte para contenedores o tienen RAM/CPU insuficiente para el stack de SAMM. Se requiere RouterOS 7.23 o posterior (las versiones anteriores no permiten seleccionar la arquitectura desde una etiqueta multi-arch).

La forma rápida: una sola línea pegada

Abra la terminal del router (WinBox → New Terminal, o SSH) y pegue esta línea:

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

Verifica la versión de RouterOS, la CPU y la memoria del router, instala el paquete container, activa el modo container, busca un disco ext4 de al menos 30 GB, descarga SAMM con una contraseña de base de datos aleatoria y segura, lo inicia y espera hasta que el panel responda. Cuando se le solicite (después de un reinicio, después de un ciclo de encendido, después de preparar el disco), pegue la misma línea nuevamente: cada paso verifica lo que ya se ha hecho y continúa. Nunca formatea un disco por sí mismo y nunca modifica nada que ya esté en ejecución.

¿Prefiere hacerlo manualmente? Siga los pasos a continuación.

1. Preparar el router

Instale el paquete container (desde extra_packages.zip en mikrotik.com/download — suba el archivo container-*.npk correspondiente a través de Files y luego reinicie). Después, active el modo container (una sola vez — se activa únicamente tras un ciclo de encendido físico, no con un reinicio por software):

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

2. Formatear y montar el disco (ext4)

Inserte una unidad USB o microSD (se recomienda ≥ 8 GB; Postgres y las capas de imagen consumen espacio). En el router:

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

Después del formateo, verifique que el disco se monte y que se pueda escribir en él:

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

Luego indique al router de dónde descargar las imágenes (Docker Hub) y dónde descomprimirlas; sin esto, cada contenedor SAMM fallará con "download/extract error: no registry url set":

/container config set registry-url=https://registry-1.docker.io tmpdir=samm/tmp layer-dir=samm/layers
# "samm" = your disk's Mount Point (System > Disks > the disk > Mount Point)
# if layer-dir is refused on your RouterOS version, keep only tmpdir
/ip dns set servers=8.8.8.8,1.1.1.1
:put "ok"
¿Ve "no registry url set" o "not enough disk space to download layer"? Ejecute las líneas anteriores; la carpeta de descarga debe estar en el disco USB/microSD (su punto de montaje), no en el almacenamiento interno limitado del router. Luego, en App → samm desmarque Enabled, haga clic en Aplicar, márquelo de nuevo y haga clic en Aplicar: el router descargará nuevamente cada parte de SAMM y lo iniciará.

3. Copie el archivo compose

Un archivo para cada plataforma. Reemplace change-me-strong-random-string (la contraseña de Postgres; use el mismo valor robusto en todas sus apariciones) y change-me-random-token. Luego, en WebFig/WinBox: Container → Apps → + New → YAML, pegar, establecer el disco ext4 del paso 2 como almacenamiento y enviar. RouterOS 7.23+ obtiene automáticamente la arquitectura de CPU correcta a partir de las etiquetas de la imagen.

¿Se ha quedado en "waiting for reverse proxy"? En RouterOS 7.23+, desmarque Use HTTPS en el diálogo de Apps y vuelva a desplegar; esa opción controla el proxy de la web-UI de la aplicación, no la forma en que se descargan las imágenes.
docker-compose.yml
name: samm

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

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

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

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

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

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

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

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

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

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

4. Verificar y conectar MikroTik a SAMM

Una vez que los contenedores SAMM estén en ejecución, abra el portal del administrador en un navegador e inicie sesión con estas credenciales:

URL de inicio de sesiónhttp://<router-ip>:8000/admin · Nombre de usuarioadmin · Contraseñaadmin

Cambie la contraseña del administrador inmediatamente. La autenticación y el accounting de RADIUS están expuestos en los puertos UDP 1812 y 1813 en el propio router, por lo que el cliente RADIUS de MikroTik puede apuntar a 127.0.0.1 con el secreto compartido que configuró en System → RADIUS.

Ruta de despliegue experimental. La función de contenedores de RouterOS es más simplificada que Docker Compose: el DNS por nombre de servicio, el orden de dependencias (depends_on) y los reinicios en vivo se comportan de manera diferente. Si el stack no funciona correctamente en su hardware, recurra a ejecutar Docker en un equipo Linux pequeño (NUC, Pi 4, VM de Linux) junto al MikroTik. El mismo archivo compose funciona allí con la semántica completa de Compose.

Mantener SAMM en ejecución después de un reinicio o un fallo

RouterOS crea los contenedores de la aplicación sin inicio automático. Ejecute esto una vez después de la instalación: cada contenedor SAMM se iniciará con el router y se reiniciará si se detiene, y un pequeño watchdog iniciará cualquier contenedor detenido cada minuto.

/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. Actualización — copia de seguridad y restauración manuales

Actualizar una aplicación de contenedor de MikroTik elimina su base de datos. RouterOS no puede cambiar la versión de una aplicación instalada directamente; la única forma es eliminar la aplicación y añadirla de nuevo, y al eliminarla se borra todo lo que la aplicación almacenó, incluida la base de datos de SAMM. Realice una copia de seguridad y realice la descarga a su computadora ANTES de eliminar la aplicación. Una copia de seguridad almacenada en el router se elimina junto con todo lo demás.

Para migrar una instalación de contenedor MikroTik a una nueva versión:

  1. En SAMM, vaya a Tools → Backup, cree un respaldo y descargue el archivo en su computadora.
  2. En el router, elimine la aplicación y agréguela nuevamente con la nueva versión.
  3. Abra el SAMM recién instalado, vaya a Tools → Backup y restaure el archivo que descargó.

Esto se aplica únicamente al contenedor de MikroTik. En Docker (Linux, Windows o una VM de Linux), una actualización consiste en ejecutar docker compose pull y luego docker compose up -d, y sus datos permanecen intactos: los volúmenes residen fuera de los contenedores y se conservan.

Instalación

Opción F — ISO del servidor SAMM (instalación de appliance)

La ISO de SAMM Server convierte cualquier máquina vacía o VM en un servidor SAMM listo: arráncala, elige DHCP o una IP estática en la única pantalla que muestra, confirma y déjala trabajar. Instala Ubuntu Server 24.04 LTS (minimized), llama al equipo samm-server y luego instala SAMM en el primer arranque desde la propia ISO, con o sin internet; en cuanto el servidor tiene conexión se actualiza una vez a la última versión. La consola muestra una pantalla de arranque de SAMM y un aviso de inicio de sesión con la IP del servidor, la dirección del panel de administración y las credenciales por defecto, y el comando samm-tools da acceso con una tecla a las herramientas de mantenimiento (comprobación de estado, copia/restauración de la base de datos, restablecer la contraseña del administrador).

La ISO borra el primer disco de la máquina. Arráncala solo en hardware o en una VM dedicados a SAMM. No necesita internet: SAMM está en la ISO y funciona en una red cerrada.

Grábelo en una memoria USB (Rufus, balenaEtcher o dd) o adjúntelo a una VM, inicie el sistema y responda a la pregunta de red. Credenciales predeterminadas tras la instalación — panel: admin / admin, OS: samm / samm o root / samm — cámbielas todas.

Descarga de la ISO de SAMM Server 2.5 GB

SHA-2560aa7c06bea4aba8ce7f632aacf243639ac7f78359cc0aa72005d88735930e9be

Instalación

Referencia del instalador

Opciones no interactivas

Todas las solicitudes pueden responderse previamente mediante variables de entorno, para que el instalador pueda ejecutarse de forma desatendida:

VariableEfecto
DB_PASSUse esta contraseña de base de datos en lugar de una generada automáticamente (solo en la primera instalación)
CF_TOKENInstale el conector de Cloudflare Tunnel con este token de Zero Trust
SAMM_HTTP_PORTForzar el puerto de escucha de nginx (omite el aviso de detección del puerto 80)
SAMM_VERBOSE1 muestra la salida sin procesar del comando en lugar de la barra de progreso
NO_COLOR1 desactiva la salida en color
DB_PASS='strong_pw'   sudo bash /opt/samm/install.sh
CF_TOKEN='eyJ...'     sudo bash /opt/samm/install.sh
SAMM_HTTP_PORT=8080   sudo bash /opt/samm/install.sh

Lo que el instalador configura

El instalador muestra el progreso en tiempo real mediante una pantalla coloreada: una barra de porcentaje y una lista de verificación por fase. La salida detallada de cada fase se registra en /var/log/samm-install.log; en caso de error, se imprimen las últimas 30 líneas.

ComponenteDetalles
FreeRADIUS 3Configurado con un backend PostgreSQL y clientes NAS dinámicos; validado con freeradius -CX
PostgreSQLBase de datos, esquema y todas las migraciones SQL aplicadas; cada archivo de migración es idempotente
Python venvTodas las dependencias se instalaron a partir de requirements.txt; catálogos de traducción compilados. Si el Python de la distro no coincide con el paquete compilado, el instalador descarga automáticamente un intérprete independiente compatible en /opt/samm/runtime
nginxProxy inverso añadido de forma aditiva — las sedes existentes nunca se eliminan. Usa el puerto 80 si está libre; de lo contrario, solicita un puerto alternativo
5 servicessamm-api, samm-radius, samm-worker, samm-notification, samm-telegram — todos habilitados como unidades de systemd
WireGuardPaquetes instalados; se configuran posteriormente en System → VPN
cloudflaredEl binario siempre se instala; el token del túnel es opcional durante la instalación o se puede añadir posteriormente desde System → Cloudflare Tunnel

Todas las credenciales —la contraseña de la base de datos y las claves de firma de sesión— se generan automáticamente en la primera instalación.

Prompts interactivos

Cualquier aviso aparecerá al principio, antes de que comience la instalación:

  • Cloudflare token — pegue un token de conector Zero Trust para publicar SAMM en línea sin puertos abiertos, o presione Enter para omitir y configurarlo más tarde.
  • Puerto HTTP — si el puerto 80 ya está en uso, el instalador no modifica esas sedes y solicita un puerto alternativo (predeterminado 8080).

Resumen de instalación

Cuando el instalador finaliza, imprime un resumen con la URL del administrador, el inicio de sesión predeterminado, el puerto HTTP elegido, las credenciales de la base de datos y las rutas del archivo de configuración:

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

Actualización

Para actualizar, obtenga el nuevo código fuente y ejecute nuevamente el instalador:

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

La ejecución repetida resincroniza la fuente, actualiza el venv, vuelve a aplicar todas las migraciones, recarga las configuraciones de FreeRADIUS y nginx, y reinicia cada servicio. Sus archivos de configuración y el puerto HTTP elegido en la primera instalación se preservan.

Consejo SAMM también puede actualizarse automáticamente; consulte Licensing & updates. Active las actualizaciones automáticas, o aplíquelas bajo demanda, desde System → License.
DB aislada & remota SAMM incluye únicamente SAMM — FreeRADIUS, PostgreSQL, nginx y el resto se obtienen al momento de la instalación desde los repositorios apt oficiales, por lo que las instalaciones air-gapped deben preposicionar esos paquetes. Para un PostgreSQL remoto, configure el DSN en /etc/samm/samm.yaml después de la instalación.

Primeros pasos

Primeros pasos

Cinco tareas breves permiten que una instalación nueva llegue al punto en que los suscriptores pueden conectarse y ser facturados.

1 · Primer inicio de sesión

  1. Abra http://<your-server>/admin/ (use el puerto HTTP del resumen de instalación si no es el 80), o la URL de su túnel de Cloudflare.
  2. Inicie sesión con administrador / administrador.
  3. Cambie inmediatamente la contraseña desde System → Admins, o desde el menú de perfil en la barra superior.

2 · Añada su primer router

  1. Vaya a MikroTik → NAS y haga clic en Agregar router.
  2. Ingrese la IP del router, un nombre corto y un secreto compartido de RADIUS. Para dispositivos MikroTik, puede agregar opcionalmente credenciales de API para la sincronización del dispositivo en tiempo real.
  3. En el MikroTik, añada un servidor RADIUS que apunte al host SAMM (puertos 1812/1813) con el mismo secreto compartido, y active RADIUS para PPP / Hotspot.

No es necesario reiniciar FreeRADIUS; SAMM resuelve los clientes NAS dinámicamente desde la base de datos. Consulte Routers (NAS) para ver el procedimiento completo, o deje que el asistente de configuración configure el MikroTik por usted.

3 · Crear un plan

Un plan define la velocidad, los límites y el precio de venta. Vaya a Users → Plans → New plan. Referencia completa de campos: Plans & limits.

4 · Añadir un suscriptor

Vaya a Users → New customer, complete las credenciales de inicio de sesión y elija un plan. El suscriptor puede conectarse inmediatamente. Para el acceso a hotspot prepago, genere voucher cards en su lugar.

5 · Active su licencia

Una instalación nueva se ejecuta sin registrar en el nivel mínimo. Abra System → License y actívela para eliminar las limitaciones; consulte Licensing & tiers.

Ritmo diario Agregar routers → crear planes → agregar suscriptores o tarjetas → consultar el panel → registrar pagos en Contabilidad.

Primeros pasos

Migrar desde otro sistema

¿Ya utiliza otro sistema de facturación RADIUS? SAMM lee sus datos y recrea sus planes y suscriptores, para que no tenga que volver a escribir nada. Los suscriptores mantienen su contraseña de servicio y fecha de vencimiento actuales, lo que significa que seguirán iniciando sesión exactamente como antes.

Vaya a Tools → Export / Import y seleccione su sistema antiguo en Migrate from another system. Al igual que el resto de Tools, esta opción es exclusiva para superadmin.

Qué cargar en la subida

Sistema antiguoArchivoDe dónde procede
SAS4 / Radius Manager .sql o .sql.gz Un respaldo de MySQL de la base de datos anterior
Super Speed Radius .sql o .sql.gz Un respaldo de MySQL de la base de datos anterior
Pro Radius .xlsx o .csv La lista de suscriptores exportada; ese sistema no ofrece exportación de respaldo

Las copias de seguridad de la base de datos suelen tener varios gigabytes; no hay problema, suba el archivo tal cual. Las copias de seguridad comprimidas no necesitan descomprimirse primero.

Cómo funciona

  1. Subir el archivo. Aún no se ha escrito nada.
  2. Revise la vista previa. Esta enumera los planes y suscriptores que se crearían, advierte sobre cualquier elemento que haya tenido que omitir o corregir, y verifica el total frente a su licencia antes de confirmar.
  3. Elija qué sucede con los nombres de usuario que ya existen en SAMM: omitirlos y mantener el registro de SAMM, o actualizar su nombre y contacto desde el sistema antiguo.
  4. Importar. Cada fila se escribe de forma independiente, por lo que una sola fila incorrecta nunca revierte el resto.

Lo que se recibe

  • Plans — nombre, velocidades, precio, duración y cuota de tráfico donde el sistema antiguo los registra.
  • Subscribers — nombre de usuario, contraseña del servicio, nombre, datos de contacto, fecha de vencimiento, plan, IP estática y MAC.
  • Los suscriptores desactivados en el sistema antiguo permanecen desactivados.

La facturación, las facturas, las tarjetas prepago, los tickets, la contabilidad y los registros del administrador no se importan deliberadamente; pertenecen al modelo de datos del sistema antiguo y rara vez se pueden mapear con precisión.

Valores que no coinciden con su columna

Las bases de datos reales son desordenadas: una dirección escrita en la casilla de correo, una nota en el campo de móvil, un número de teléfono escrito con teclado árabe. SAMM comprueba cada valor frente a lo que su columna debería contener. Todo lo que no encaja se deja fuera de ese campo y se guarda en las notas internas del suscriptor, etiquetado con su procedencia — así no se pierde nada y ningún campo queda contaminado. La vista previa te dice a cuántos valores ha afectado.

Pro Radius especificaciones

Pro Radius exporta los suscriptores pero no los planes, por lo que SAMM deduce los planes a partir del nivel de servicio de cada suscriptor, tomando la velocidad de su nombre (un servicio llamado "4MBPS" se convierte en un plan de 4 Mbps). Tres elementos simplemente no están en ese archivo y se configuran con valores predeterminados razonables que usted debe revisar posteriormente:

  • Duración — establecer en 1 mes. La fecha de vencimiento real de cada suscriptor se importa sin cambios, por lo que esto solo afecta a las renovaciones futuras.
  • Velocidad de subida — configúrela para que coincida con la velocidad de descarga.
  • Precio — establecer en 0.
Revise los planes antes de facturar Después de una importación de Pro Radius, abra Plans y establezca el precio y el periodo reales para cada uno. Hasta que lo haga, esos planes facturarán a cero.

Información útil

  • Puede ejecutarlo más de una vez de forma segura. Al volver a importar el mismo archivo, se omiten los usuarios que ya están presentes en lugar de duplicarlos.
  • Su licencia sigue siendo válida. Si el archivo contiene más suscriptores de los que permite su nivel de licencia, la vista previa lo indicará al principio y le dirá cuántos cabrían; puede actualizar su licencia o importar un conjunto parcial.
  • Realice primero una copia de seguridad si va a importar en una instalación que ya contiene datos reales.

Planes de suscriptores &

Planes & límites

Un plan es la definición del servicio asignada a los suscriptores: establece la velocidad, los límites y el precio. Cree los planes antes de añadir usuarios.

Una instalación limpia ya incluye 9 planes listos para usar — ocho niveles de velocidad mensuales más un plan de limitación "Expired" — para que pueda vender inmediatamente o crear los suyos propios. La carga inicial se ejecuta solo en la primera instalación y nunca sobrescribe los planes que haya añadido.

Crear un plan

  1. Vaya a Usuarios → Planes.
  2. Haga clic en Nuevo plan.
  3. Complete el formulario y haga clic en Guardar plan.

Cada límite es un interruptor: active solo los que necesite. El mismo modal permite editar un plan existente (abra el menú ⋮ de la fila → Editar).

Campos del plan

CampoSignificado
NombreNombre de plan único, p. ej. Home-50M
PrecioSe cobra por periodo de facturación cuando se utiliza la facturación
Velocidad de descarga / subidap. ej. 50M, 512K, 1G — aplicado como el límite de velocidad de MikroTik
Sesiones simultáneasCuántos dispositivos pueden estar conectados simultáneamente en este plan. 1 por defecto — se rechaza un segundo inicio de sesión mientras el primero sigue conectado. Establezca 0 para acceso ilimitado. Se ignora la sesión que ha dejado de reportar, por lo que una conexión caída nunca bloquea al suscriptor
Límite: ExpiraciónLa suscripción finaliza tras un periodo fijo después de la activación (días/meses/horas/minutos)
Límite: CuotaUn límite de datos total (combinado, solo de descarga o solo de subida) para toda la suscripción
Límite: Tiempo de actividadUn límite de tiempo de conexión acumulado: la suma de todas las duraciones de sesión
Límite: Uso diarioUn límite de datos que se restablece cada día a la hora de daily-reset configurada
Ventana ilimitadaAdición rápida de una ventana de velocidad; el editor completo se encuentra en la página Speed Windows del plan
Pool de IPNombre opcional del RADIUS Framed-Pool para la asignación de direcciones
Renovación automáticaIniciar un periodo nuevo al vencer en lugar de cambiar de plan o desconectar

Los cuatro límites

Cada límite es independiente y opcional. Cuando se establecen varios, SAMM los comprueba en un orden fijo — expiration → quota → uptime → daily — y el primero que se agote determina la acción.

LímiteTrazasAl agotarse
VencimientoTiempo transcurrido desde la activaciónCambiar a otro plan o desconectar
CuotaTotal de bytes usadosCambiar a otro plan o desconectar
Tiempo de actividadSegundos acumulados de sesiónCambiar a otro plan o desconectar
DiarioBytes desde el último reinicio diarioLimitar — a las velocidades que usted ingrese, o mediante un plan más lento — hasta el siguiente reinicio diario

Para cada límite, elija qué sucede al agotarse: seleccione un plan siguiente al que cambiar al suscriptor, o déjelo como — disconnect —. El límite diario limita la velocidad en lugar de desconectar: por defecto, ingrese las velocidades de limitación directamente (campos de descarga / subida), o elija un plan siguiente más lento; en cualquier caso, el suscriptor vuelve al plan original automáticamente en el siguiente reinicio diario.

Ventanas de velocidad

Una ventana de velocidad anula la velocidad base del plan durante horas establecidas — por ejemplo, una ventana de velocidad ilimitada después de la medianoche. Haga clic en la fila de un plan para abrir su editor de Velocidad Windows, que añade control por día de la semana y admite ventanas que cruzan la medianoche. Cuando coinciden varias ventanas, prevalece la de mayor velocidad.

Nota Los suscriptores limitados o que hayan agotado su límite están excluidos de las ventanas de velocidad; SAMM nunca aumenta la velocidad mientras haya un límite vigente.

Dos conceptos de uso

SAMM mantiene el registro de uso en dos lugares y nunca los confunde:

  • Contadores restablecibles — el estado por límite. Se ponen a cero mediante un restablecimiento del administrador y por el restablecimiento diario.
  • Contadores de facturación — totales acumulados no restablecibles. Nunca se reinician, por lo que los informes y las facturas mantienen su precisión.

Gestión de planes

La lista de planes muestra la velocidad, el número de suscriptores, los límites activos y las ventanas de velocidad de cada plan. Desde el menú ⋮ de una fila puede editar, abrir sus ventanas de velocidad, habilitar/deshabilitar, ir a sus suscriptores o eliminarlo (solo cuando no tenga suscriptores). Al editar la renovación automática, se ofrece propagar el cambio a todos los suscriptores actuales.

Duplicar copia un plan exactamente —velocidades, límites, ventanas de velocidad y precio— bajo un nombre nuevo, lo cual es mucho más rápido que reconstruir una tarifa manualmente para cambiar un solo número. Si el nombre que asigna ya está en uso, se utilizará el siguiente número disponible.

Planes que ven los usuarios

El interruptor Users can see this plan en cada plan (también disponible como acción masiva en la lista de Plans) determina qué planes pueden ver y elegir los usuarios en su portal. Se encuentra desactivado por defecto para cada plan, por lo que no se muestra nada hasta que usted lo seleccione; un usuario siempre ve su propio plan.

Planes de suscriptores &

Suscriptores

Un suscriptor (cliente / usuario) es una cuenta PPPoE o Hotspot que se autentica en SAMM. A cada suscriptor se le asigna exactamente un plan.

Crear un suscriptor

  1. Vaya a Users y haga clic en New customer.
  2. Complete el formulario y haga clic en Guardar; el suscriptor podrá conectarse inmediatamente.
CampoSignificado
Nombre de usuario *El nombre de usuario de PPPoE / Hotspot debe ser único
Contraseña *La contraseña de inicio de sesión (almacenada para la autenticación RADIUS PAP/CHAP)
Nombre / ApellidoNombre del suscriptor
Teléfono móvil / Correo electrónico / DirecciónDatos de contacto — se utilizan para notificaciones y facturas
Plan *El plan de servicio a asignar
Anulación de vencimientoFecha de vencimiento manual opcional en lugar de la calculada por el plan
Renovación automáticaRenovar el periodo del plan automáticamente al vencer

Crear múltiples suscriptores a la vez

New batch users crea una serie numerada de cuentas en un solo paso — la forma habitual de entregar un bloque de accesos para un despliegue en una aldea, un hotel o un revendedor. Elija la cantidad, el número de inicio y cuántos dígitos de relleno añadir (3 genera 001, 002, …); todo lo demás — plan, vencimiento, renovación automática — se completa una vez y se aplica a todos. Comparten una misma contraseña.

La opción de facturación se aplica a cada usuario del lote por separado, por lo que una ejecución de cincuenta genera cincuenta facturas o ninguna, y el total se muestra antes de confirmar.

La lista de suscriptores

La página de Usuarios enumera cada suscriptor con un punto de estado para una vista rápida, el plan asignado y cuánto queda de cada límite: el uso diario con una barra de progreso, la cuota restante, el tiempo de actividad restante y los días restantes. Filtre por estado (All / Active / Suspended / Expired / Online) o busque por nombre de usuario, nombre o móvil.

La insignia de cambio de plan Una sola insignia representa el plan del suscriptor. Dos insignias unidas por una flecha significan que el suscriptor tuvo un acceso que alcanzó su límite diario y se encuentra temporalmente en un plan de limitación; volverá al original en el siguiente reinicio diario.

Gestión de un suscriptor

Haga clic derecho en una fila — o use el menú ⋮ — para realizar cualquier acción por suscriptor:

AcciónFuncionamiento
Ver / EditarAbra la página de detalles, o edite los datos de contacto, la contraseña y la fecha de vencimiento
Activar / DesactivarSuspender la cuenta — los suscriptores conectados se desconectan
Renovar planSume la duración del plan al tiempo restante; genera una factura si el plan tiene un precio. La opción de Plan permite que un usuario expirado regrese con un plan diferente en el mismo paso; deje seleccionada la opción "Keep the current plan" para renovar como antes
Reiniciar tiempo de actividad / cuota / diarioPoner a cero el contador del límite seleccionado
UsoAbrir gráficos de uso e historial de sesiones
EliminarEliminar al suscriptor y todo su historial; primero se desconectan las sesiones activas
Cómo se aplican las acciones Los restablecimientos, los cambios de plan y las renovaciones se encolan en un registro de auditoría y se aplican mediante el tick de samm-radius, normalmente en unos pocos segundos. Si el suscriptor está en línea, SAMM también envía una actualización en tiempo real. Consulte CoA & cambios en vivo.

La página de detalles también puede mostrar la contraseña de inicio de sesión del suscriptor mediante un icono de ojo (con copia en un clic), lo cual es útil cuando un cliente solicita sus credenciales.

Vista de uso

La acción Usage abre una página de tráfico detallada para un suscriptor, con un selector de periodo de 7d / 14d / 30d / 90d. Informa tres cifras principales: el tráfico de hoy (con el desglose de subida/descarga y los minutos en línea), el tráfico de este mes y el tiempo en línea acumulado del mes. Debajo se encuentra un gráfico de tráfico diario de subida frente a descarga, y una tabla completa del historial de sesiones: la hora de inicio y fin, la duración, los bytes de descarga y subida, el NAS y la causa de terminación de cada sesión.

Operaciones masivas

Para cambiar el propietario, la fecha de expiración, el estado o la renovación automática de varios suscriptores a la vez —o para eliminar varios— use las herramientas de Cambios Masivos y Eliminación Masiva. Para crear suscriptores en masa desde una hoja de cálculo, use Export / Import.

Restringir un suscriptor a routers específicos

Cuando el ajuste de inicio de sesión de la sucursal está activado, un usuario inicia sesión a través de los routers de su propia sucursal, de las sucursales superiores y de la oficina central (consulte Admins, branches & roles). Desde el formulario de edición puede restringir aún más a un usuario (o a un grupo de tarjetas completo) a routers específicos: si no hay ninguno seleccionado, se aplican los routers de la sucursal; si hay uno o más seleccionados, el inicio de sesión se acepta solo desde esos routers, lo cual se aplica internamente en RADIUS. Cambiar el conjunto desconecta cualquier sesión activa en un router que ya no esté permitido.

Cambiar nombre de usuario, renovar con vista previa

Cambie el nombre de un usuario desde su página (el botón Username junto a Edit) o desde el menú de la lista de Users, tras escribir el nombre de usuario actual para confirmar. Las sesiones, el consumo y los logs se vinculan al nuevo nombre, la sesión activa se desconecta para que el router olvide el login antiguo, y se informa al usuario sobre el nuevo nombre de usuario a menos que desmarque esa casilla. Al renovar o cambiar un plan, elija si el nuevo periodo continúa desde la fecha de vencimiento o comienza hoy, y vea —y ajuste— el nuevo vencimiento antes de Guardar. Una renovación también puede aceptar un pago inicial.

Enlace inalámbrico

Para un suscriptor en un punto de acceso MikroTik, la página de usuario puede leer la información de su radio directamente: señal (con una palabra sencilla que indique su calidad), velocidad en cada dirección, CCQ y tiempo de actividad. Solo se pueden leer radios MikroTik.

Archivos de usuario & campos personalizados

Suba tarjetas de identidad, pasaportes, contratos y fotos a un usuario desde su página de detalles; vista previa de archivos sin descargarlos, los cuales pueden mostrarse al suscriptor en su propio portal en Files. Custom fields — definidos una vez en Settings — añaden campos de datos adicionales a usuarios, archivos, planes, grupos de tarjetas, tickets y complementos.

Planes de suscriptores &

Tarjetas de Hotspot

Para el acceso Hotspot prepago, genere un lote de voucher cards en lugar de suscriptores individuales. Cada tarjeta es un par de usuario/contraseña con su propia velocidad y límites, generadas por millares e impresas para su distribución.

Crear un grupo de tarjetas

  1. Vaya a Users → Hotspot Cards y haga clic en Nuevo grupo.
  2. Complete el siguiente formulario y haga clic en Crear grupo — SAMM genera las credenciales de cada tarjeta automáticamente.
SecciónCampos
IdentidadNombre de grupo único, descripción, prefijo de nombre de usuario opcional, cantidad de tarjetas a generar (hasta 10,000)
CredencialesFormato de nombre de usuario y contraseña (números / letras / alfanumérico) y longitud
Límite de velocidadVelocidad de descarga y subida — 256k, 6M, 1G; 0 = ilimitado
Limitar transferenciaIlimitado, límite combinado o límites de descarga/subida independientes (MB / GB / TB)
Horarios de limitaciónLímite de tiempo de actividad, expiración tras el primer inicio de sesión y una fecha de validez del grupo

La expiración se cuenta a partir del primer inicio de sesión de cada tarjeta, mientras que válido hasta es una fecha de vencimiento fija: las tarjetas no podrán utilizarse después de esa fecha, independientemente de si fueron activadas o no.

Gestión de un grupo

Abra el menú ⋮ de un grupo para activar o desactivar todas las tarjetas a la vez, extender la fecha de validez del grupo, añadir más tarjetas al lote o editar sus detalles. Las tarjetas individuales pueden restablecerse (cuota, tiempo de actividad o expiración) o desactivarse desde la página de detalles de la tarjeta.

Duplicar grupo copia cada ajuste exactamente y genera el mismo número de tarjetas con códigos nuevos — un código de tarjeta solo puede pertenecer a una sola tarjeta, por lo que una copia es una nueva tirada de impresión, no un clon de la anterior. Es la forma rápida de volver a generar un lote de cupones que se haya agotado.

Añadir una tarjeta o importar una lista

+ Card, en la lista de tarjetas y en la página de un grupo, añade una tarjeta con el usuario, la contraseña y el nombre opcional que escriba, en un grupo que elige de una lista de búsqueda. En la página de un grupo, Import cards trae un archivo CSV o Excel (usuario, contraseña y un nombre opcional); verá lo que se añadirá y lo que se omitirá antes de guardar nada.

Diseños de tarjetas

Abra Hotspot Cards → Card designs para diseñar la tarjeta impresa: su tamaño, una imagen de fondo, su logotipo y dónde van el usuario, la contraseña, el precio, la validez y un código QR. El código QR inicia sesión en el Hotspot con un solo escaneo. Hay diez diseños listos para empezar; edítelos, cópielos o elimínelos como los suyos.

Un diseño es una hoja A4 de tarjetas (Export) o un ticket térmico de 80 o 58 mm para la impresión rápida. Cada grupo tiene su propio diseño para cada uno; un grupo sin diseño imprime la tarjeta integrada, y la impresión rápida usa el ticket listo Thermal Pro.

Estados de la tarjeta

EstadoSignificado
Sin usarGenerado pero nunca inició sesión
ActivoEn uso, dentro de sus límites
AgotadoSe ha alcanzado un límite (cuota, tiempo de conexión o expiración)
DesactivadoDesactivado manualmente

Imprimiendo seguimiento de &

Abra un grupo para ver sus tarjetas, imprímalas en un PDF para su distribución (el diseño de impresión utiliza el logotipo de su ISP configurado en los ajustes) y revise el uso por tarjeta. El tráfico de las tarjetas también aparece en Reports en la pestaña Cards, y cada grupo tiene su propia vista de contabilidad.

El router recibe lo que queda en cada tarjeta, así que la página de estado del Hotspot muestra el tiempo y los datos restantes, y el router cierra la sesión cuando la tarjeta se agota.

Planes de suscriptores &

Autoservicio — los invitados se registran por sí mismos

Lo opuesto a un voucher: nadie imprime nada y nadie está en un mostrador. Un visitante se conecta a su hotspot, pulsa Register en la página de inicio de sesión, escribe su nombre y número de móvil, y SAMM le envía un código de acceso por SMS, WhatsApp o email. Lo introduce en la misma página y ya está conectado — y usted mantiene un registro nominal y exportable de todas las personas que usaron la red de invitados.

Lugares típicos: restaurantes y cafeterías, hoteles y casas de huéspedes, exposiciones y ferias comerciales, conferencias, centros comerciales, clínicas y salas de espera, gimnasios, espacios de co-working, salones de belleza, salas VIP de aeropuertos, estadios, campus, bibliotecas, concesionarios de automóviles, centros de eventos para bodas, resorts y campings.

Encendido

  1. Configure primero un canal de entrega. Notification Center → active SMS o WhatsApp y envíese un mensaje de prueba. Nada más funcionará hasta que un canal esté activo.
  2. Self Service → Settings: marque Allow guests to register themselves, elija qué canales ofrecer y configure cuánto tiempo permanece válido un código de acceso y cuánto tiempo debe esperar un invitado antes de solicitar otro.
  3. Deje Passcodes come from en el grupo de tarjetas Self Service a menos que tenga un motivo para cambiarlo; ese grupo decide la velocidad y cuántos dispositivos pueden compartir un mismo passcode.
  4. Active la pestaña Register para cada diseño de inicio de sesión que utilice — vea a continuación. Este es el paso que suele omitirse.

La página de inicio de sesión: el paso que se suele olvidar

La pestaña Register tiene un diseño por inicio de sesión y está desactivada por defecto. Abra MikroTik Manager → el router → Login Page, edite el diseño que utiliza y marque Allow Self Service. Puede modificar cada frase que ve un invitado en la misma pantalla: la etiqueta de la pestaña Register, la línea de introducción, las etiquetas de los dos campos, el botón y las cinco respuestas (“su código de acceso está en camino”, “ya tiene uno”, “por favor, inténtelo más tarde”, “no pudimos enviarlo”, “el registro no está disponible”).

Luego presione Push — y presiónelo nuevamente después de cada actualización de SAMM. Las páginas de inicio de sesión de Hotspot residen en el almacenamiento flash del propio router, no en SAMM. Actualizar SAMM no las vuelve a enviar, por lo que el router sigue sirviendo su página antigua —sin la pestaña Register— hasta que usted las envíe de nuevo. SAMM le advierte en la pestaña Login Page cuando un router sirve páginas más antiguas que la versión instalada, y la página Self Service enumera cada router que no puede mostrar la pestaña y ofrece solucionarlos todos a la vez.

Reglas para evitar el abuso

  • Un código de acceso activo por número. Si se solicita uno nuevo mientras el código sigue siendo válido, se le indicará al invitado que revise sus mensajes en lugar de enviar otro.
  • Luego un periodo de espera que usted defina, antes de que ese número pueda solicitar uno nuevo.
  • La validez comienza a contar desde el momento en que se envía el código de acceso, no desde el primer inicio de sesión; por lo tanto, un código que haya permanecido sin usar durante una semana ya no funcionará.
  • Un límite diario establecido por su licencia (ver abajo). Una vez agotado, se les pedirá a los invitados que lo intenten más tarde y los códigos de acceso ya emitidos seguirán funcionando.
  • Cada intento se registra con la dirección MAC del dispositivo tal como la informó el router, la cual un invitado no puede falsificar desde su navegador.

La licencia

Self Service se licencia independientemente de su plan, según la cantidad de códigos de acceso que la instalación pueda emitir al día, y se renueva en su propia fecha; por lo tanto, puede estar en el plan Free con un complemento de pago, o en Unlimited sin ninguno. Cada instalación obtiene 10 al día sin cargo; Light lo aumenta a 50, Heavy a 200 y Max elimina el límite. Consulte los precios.

La página de Self Service muestra usado / permitido para hoy e indica claramente cuando se ha agotado el límite. Compre o renueve desde su panel en securytik.com, o solicítelo desde System → License y un administrador de SecuryTik lo aprobará. Un código de acceso que no haya podido entregarse no consume su límite.

Planes de suscriptores &

Complementos & vouchers

Un add-on es un complemento que un usuario adquiere adicionalmente a su plan por un número determinado de días: un speed boost, unmetered days o un night boost para las horas seleccionadas. Créelos en Users → Add-ons.

  • Venda un complemento desde la página del usuario, permita que los usuarios lo compren en el portal de usuario o en el bot de Telegram (pagado desde la billetera), o imprima códigos de cupón de un solo uso que los usuarios canjeen en el portal o en el bot.
  • Apps gratuitas: active Unmetered y seleccione las apps por categoría; solo su tráfico dejará de contabilizarse para la cuota del usuario. Si desactiva todas las apps, todo el tráfico será ilimitado. Esto requiere el Data Log.
  • Control parental y VPN: un complemento puede activar el Control parental o el VPN a través de SAMM durante su período; ambos se desactivan solos al terminar. Indica la duración con un valor y una unidad (días, semanas o meses naturales).
  • Los usuarios ven sus complementos activos y las fechas de finalización en su página de Planes. Un complemento asignado al usuario de un agente se le factura al agente como una renovación.
  • Cada sucursal puede tener sus propios precios de complementos en Accounting → Price Lists.

Descuentos de factura

Aplique un porcentaje o un monto fijo de descuento a una factura abierta, indicando el motivo, desde la factura o las facturas del usuario. Un descuento recurrente puede repetirse en las próximas renovaciones del usuario. Cada rol tiene un descuento máximo que puede otorgar.

Planes de suscriptores &

Puntos & recompensas

Recompense a los usuarios leales y permita que inviten a sus amigos. Los puntos están desactivados hasta que los active en Users → Points & rewards.

  1. Active los puntos y configure, en cada plan, cuántos puntos otorga una renovación pagada y cuántos recibe el usuario que invita cuando un amigo referido paga su primera factura.
  2. Crear recompensas: mayor velocidad (la velocidad del plan multiplicada durante algunos días) o días gratis, cada una con un precio en puntos.
  3. Los usuarios ven su saldo, su enlace de invitación y las recompensas en el portal de usuario, y canjean sus puntos allí. Un amigo que abra el enlace de invitación deja sus datos; usted crea el usuario y se registra la referencia.

Los puntos se contabilizan a partir de las facturas pagadas, una sola vez. Si una factura se cancela, sus puntos se retiran. También puede asignar o quitar puntos manualmente, y ver los saldos más altos y las solicitudes de unión en la misma página.

Planes de suscriptores &

Control parental

Las familias protegen su propia línea desde el portal de usuario. Esta función está desactivada para cada usuario hasta que usted la permita: active Parental control en el formulario de añadir o editar usuario (se encuentra justo después de Allow Password Change), o para varios usuarios a la vez desde las acciones masivas de la lista de Users.

Lo que el usuario puede bloquear

  • Categorías: contenido para adultos, drogas, juegos de azar, citas, violencia y odio, y servicios de proxy o VPN utilizados para evadir el filtro. El bloqueo de contenido para adultos también activa SafeSearch en los principales motores de búsqueda y YouTube.
  • Apps y sitios web del mismo catálogo que Websites & Apps, mostrados con sus logotipos oficiales.
  • Cuándo: siempre, o mediante un calendario semanal (por ejemplo, noches escolares después de las 22:00).
Indicador luminoso del router SAMM no escribe reglas por usuario. Cada router recibe algunas reglas compartidas, y los usuarios se incluyen o excluyen de ellas a medida que sus horarios comienzan y terminan, para que la carga del router se mantenga baja incluso con muchas familias. El router debe ser gestionado por SAMM (acceso API) para el bloqueo de aplicaciones.

Planes de suscriptores &

VPN a través de SAMM

Los usuarios elegidos envían su tráfico por tu servidor SAMM en lugar de la línea de internet del router. Va por el túnel que cada router ya tiene con SAMM (WireGuard, L2TP/IPsec o SSTP, ver VPN), así que no hay que instalar nada en el teléfono ni en el ordenador del usuario.

Permitirlo

  • Por usuario: activa VPN a través de SAMM en el formulario de alta o edición del usuario, o para muchos usuarios a la vez desde las acciones masivas de la lista de Usuarios.
  • Como complemento: en Usuarios → Complementos, activa el VPN en un complemento y véndelo por un número de días, semanas o meses. Está activo durante el período del complemento y se desactiva solo después.

Lo que elige el usuario

Los usuarios con permiso tienen una página VPN en el portal de usuario con tres opciones:

  • Desactivado — nada pasa por el VPN.
  • Todo el tráfico — todas las apps y sitios web pasan por el VPN, y también el DNS del usuario.
  • Apps elegidas — solo las apps y sitios que el usuario escoge, del mismo catálogo que Sitios web y aplicaciones; todo lo demás sigue por la línea local.
Si el túnel se cae Los usuarios nunca se quedan sin internet por el VPN: si el router no llega a SAMM, su tráfico vuelve a la línea del propio router hasta que el túnel regresa. Las direcciones locales (tu LAN y los rangos CGNAT) nunca pasan por el VPN. Funciona en RouterOS 6 y 7; el router debe estar gestionado por SAMM.

VPN externa: salir por otro proveedor

En System → VPN → External VPN SAMM puede sacar a los usuarios de VPN por una VPN comercial en lugar de su propia línea, así la VPN funciona aunque SAMM esté en tu LAN sin dirección pública.

  • NordVPN: pega un token de acceso de tu cuenta NordVPN y elige cuántos servidores abrir (hasta 10 por cuenta). SAMM obtiene la clave y elige los servidores por sí mismo.
  • Cualquier otro proveedor (ProtonVPN, Mullvad, Surfshark, tu propio servidor): sube sus archivos WireGuard .conf, una conexión por archivo. Las líneas de script de un archivo se ignoran y nunca se ejecutan.
  • Conexiones muestra cada conexión en vivo: estado, último handshake, tráfico y usuarios. Cada usuario se queda en una conexión (la misma dirección de salida); un peso reparte los usuarios entre las conexiones.
  • Si una conexión deja de funcionar, sus usuarios salen por la línea de SAMM hasta que vuelve; eliminar o desactivar una conexión mueve sus usuarios a las demás.
SAMM necesita una dirección pública La VPN solo es útil cuando tu servidor SAMM sale a Internet desde un lugar distinto al de los usuarios, por ejemplo un servidor en un centro de datos. Si SAMM está detrás de NAT en la misma red, el tráfico saldría por la misma línea, por eso el formulario del usuario y el del complemento muestran un aviso, salvo que funcione una conexión de VPN externa.

Primeros pasos

Configure su servidor

¿No tiene servidor? Se lo configuramos. Lo pide desde su panel de SAMM, paga y recibe un servidor SAMM listo en su propio dominio .com, con su nombre. No hay nada que instalar.

Lo que incluye

  • Un servidor en la nube y un dominio .com, en tres tamaños: 6 núcleos, 12 GB RAM, 200 GB SSD por $100 al año; 8 núcleos, 24 GB RAM, 300 GB SSD por $200; 12 núcleos, 48 GB RAM, 400 GB SSD por $300. El tamaño se elige en el primer paso.
  • HTTPS en su dominio; la dirección propia del servidor nunca se publica.
  • SAMM instalado y con la marca de su empresa, con su licencia vinculada y activa en el primer inicio de sesión.
  • Un correo con la dirección de su panel (https://your-domain/admin) y una contraseña de administrador segura.

Pídalo

  1. Inicie sesión en samm.securytik.com y abra Dashboard → Get a server.
  2. Elija un nombre de servidor y el número de usuarios, y luego busque su dominio .com o elija una de las sugerencias.
  3. Pague con cualquier método mostrado en la caja. El pedido espera dos horas por el pago; después se cancela y debe hacer un nuevo pedido.
  4. Tras el pago todo es automático. Cuando el servidor esté listo, recibirá el correo con su dirección y acceso.

Acceso SSH

Desde Dashboard → Servers puede crear su propio acceso SSH con contraseña, claves públicas o ambos. En la misma página hay una guía paso a paso de SSH para Termius, Windows, Ubuntu y macOS.

Renovación Renueve al menos un día antes del fin del año; la renovación se abre siete días antes. Si el servidor no se renueva, el servidor, el dominio y los datos en él terminan. Mantenga también sus propias copias de seguridad.

Planes de suscriptores &

CGNAT & pools de IP

Ambos están en Plans, junto a los pools propios del router.

Pools CGNAT

Un pool CGNAT permite que varios usuarios compartan una misma dirección pública. Cada usuario recibe un bloque fijo de puertos en esa dirección, así que cada conexión puede rastrearse hasta un solo usuario.

  1. Abra Plans → CGNAT Pools y añada un pool: las direcciones públicas, cuántos usuarios comparten una dirección y cuántos puertos recibe cada usuario.
  2. La línea de capacidad muestra cuántos usuarios caben antes de guardar.
  3. Envíelo al router. SAMM escribe las reglas NAT y guarda el historial de qué usuario tuvo qué dirección y puertos, que lee el Lookup.

Pools de IP

Con un pool de IP, SAMM asigna a cada usuario su propia dirección, por router y plan, de modo que el router no necesita un pool de direcciones propio. La dirección se libera al terminar la sesión. Cuando un pool se llena, entra en funcionamiento el pool propio del router.

Operaciones diarias

Conservación de datos & Lookup

Muchos países exigen a un ISP conservar registros de conexión e indicar qué abonado usó una dirección en un momento dado. La conservación de datos hace ambas cosas. Está desactivada hasta que la active.

Actívela

  1. Abra System → Settings → Data retention y actívela.
  2. Defina cuánto tiempo se conservan las sesiones (dos años por defecto). Las sesiones se conservan durante ese periodo incluso para los usuarios que elimine.
  3. Opcionalmente, envíe un archivo cifrado diario a su NAS por SFTP, SMB o NFS. Ábralo con gpg --decrypt.

Lookup: ¿quién usó esta dirección?

  1. Abra Overview → Data Log → Data retention.
  2. Introduzca la dirección pública, el puerto y la hora de la solicitud que ha recibido.
  3. Introduzca un número de caso (SAMM sugiere CASE-1, CASE-2…). El resultado muestra el usuario, la dirección MAC, el router y la sesión; se puede buscar y exportar.
Registro de Lookup Cada búsqueda queda registrada en el registro de Lookup, con quién buscó, cuándo y el número de caso, y no se puede editar. Con CGNAT, Lookup usa los bloques de puertos de sus pools CGNAT.

Redes & routers

Otras marcas de routers

Además de MikroTik, SAMM funciona con routers Cisco, Huawei, Nokia y ZTE como NAS (BNG).

  • Añada el router en Devices → Manager y elija su tipo. El formulario pide el acceso correcto: la API para MikroTik, SSH para las demás marcas.
  • Página de configuración: SAMM genera las líneas de configuración de ese router, listas para pegar.
  • Velocidades y desconexiones usan los atributos RADIUS propios de cada marca, así que los cambios de plan llegan al router.
  • Data Log a partir de los registros de tráfico propios del router (NetFlow o IPFIX).
  • CGNAT en Cisco: SAMM envía las reglas por SSH y Lookup funciona como en MikroTik. Los routers Cisco también pueden conectarse a SAMM por L2TP.
  • Página de dispositivo: CPU, memoria, temperatura, tiempo de actividad y gráficos, como en MikroTik.

Redes & routers

FTTH & OLTs

SAMM lee las OLT de V-SOL, Huawei (SmartAX), ZTE (C300 y C320) y Nokia (ISAM) por SSH.

  • Página FTTH en Devices → FTTH: una lista de OLT con filtros, columnas y exportación, como en Wireless.
  • Cada ONU con su señal óptica, y las ONU pendientes de añadir.
  • ONU vinculadas automáticamente a sus usuarios.
  • Bloqueo de línea del abonado: SAMM aprende la línea desde la que se conecta cada usuario y puede mantener su acceso a esa línea.
  • Página de dispositivo OLT: CPU, memoria, temperatura, tiempo de actividad y gráficos.

Redes & routers

Routers (NAS)

Un NAS (Network Access Server) es un router que autentica a los suscriptores en SAMM a través de RADIUS. Cada router que transporta tráfico de suscriptores necesita un registro NAS.

Añadir un router

  1. Vaya a MikroTik → NAS y haga clic en Agregar router.
  2. Complete los campos a continuación y haga clic en Guardar.
CampoSignificado
IP / nombre de host del NASLa dirección del router, tal como la ve el host SAMM
Nombre cortoUna etiqueta descriptiva que se muestra en la UI
Tipomikrotik habilita la sincronización de dispositivos en tiempo real y el envío de configuraciones; los demás tipos son solo RADIUS
SecretoEl secreto compartido de RADIUS — debe coincidir exactamente con el del router, o la autenticación fallará
Puerto CoAPuerto UDP al que SAMM envía paquetes Change-of-Authorization (predeterminado de MikroTik 3799)
Puerto / usuario / contraseña de APICredenciales de la API de MikroTik que SAMM utiliza para leer la información del dispositivo y enviar la configuración
No es necesario reiniciar SAMM resuelve los clientes NAS dinámicamente desde la base de datos; añadir o eliminar un router nunca requiere reiniciar FreeRADIUS.

La lista de NAS

Todos los routers se muestran en una sola tabla: ID, IP de NAS / hostname, shortname, tipo, un secret enmascarado (haga clic en la celda para revelarlo), los puertos CoA y API, y un resultado de ping en tiempo real con el tiempo de ida y vuelta. El cuadro de búsqueda filtra por IP, shortname o descripción.

El menú ⋮ de cada fila contiene las acciones por router: Ver dispositivo y Actualizar información (solo MikroTik), Editar, Enviar configuración RADIUS (solo MikroTik) y Eliminar. Al abrir una fila de tipo mikrotik, se accede directamente a su página del dispositivo.

Descubrir vecinos

Haga clic en Discover neighbors para escanear la red en busca de dispositivos MikroTik (a través del protocolo de descubrimiento de vecinos de MikroTik) y agregarlos como registros NAS sin tener que escribir cada dirección manualmente. Un router descubierto puede agregarse por IP, o mediante Auto-added: un proceso de arranque de un solo clic que crea un usuario de gestión SAMM en el router, asigna una IP de gestión y elimina el bridge de fábrica.

Auto-add es para routers nuevos El bootstrap de un solo clic está destinado a dispositivos nuevos de fábrica (o restablecidos); en un router que ya tenga una configuración, puede sobrescribir o afectar el funcionamiento de la configuración existente.

Enviar la configuración de RADIUS al router

Para los registros de MikroTik NAS, el menú ⋮ de la fila ofrece Push RADIUS config — SAMM configura el router por usted a través de la API para que no tenga que hacerlo manualmente. Usted confirma la IP del servidor SAMM (debe ser accesible desde el router) y los puertos de auth, accounting y CoA; luego, SAMM crea o reemplaza una entrada de RADIUS en el router:

AjusteValor
ComentarioSAMM — la etiqueta que SAMM utiliza para buscar y actualizar esta entrada posteriormente
Serviciohotspot, ppp
Dirección / secretoEl host SAMM, con el secreto compartido de este registro NAS
Tiempo de espera3000 ms
CoA entranteAceptado, en el puerto CoA que confirmó

El cuadro de diálogo muestra un registro de resultados cuando finaliza el push.

Configure el lado de MikroTik

Si en su lugar configura el router manualmente:

  • Agregue un servidor RADIUS que apunte al host de SAMM, con el mismo secreto compartido, habilitado para PPP / Hotspot.
  • Use el puerto de autenticación 1812 y el puerto de accounting 1813.
  • Aceptar CoA entrante en el puerto 3799.
  • Establezca el intervalo de Interim-Update de accounting en aproximadamente 5 minutos (valor predeterminado del asistente de SAMM); esta es la frecuencia con la que SAMM acumula el consumo y evalúa los límites; intervalos más cortos reducen la latencia de los límites a costa de un mayor tráfico de accounting.

Dispositivos solo de monitoreo

Un router añadido como monitor aparece en el inventario de MikroTik y se sincroniza y se le realiza ping, pero no tiene un rol de RADIUS; por lo tanto, no puede autenticar suscriptores. Utilícelo para supervisar routers que no sean NAS de suscriptores.

Respaldo SAMM

Si SAMM deja de responder, los routers que usted elija seguirán autenticando a los suscriptores por su cuenta, utilizando una copia desactivada de cada usuario activo que SAMM mantiene sincronizada en ellos. Cuando SAMM se restablezca, todos se reconectarán a través de él. Desactivado por defecto; actívelo por router desde Settings → Advanced.

El respaldo se activa después del retraso que usted configure, o manualmente, y el router lo informa a través de Telegram. Una tabla de estado muestra el estado de sincronización de cada router, cuántos usuarios fallaron al sincronizarse y por qué, y marca un router cuyo respaldo ha quedado obsoleto o que no puede alcanzar la dirección de estado (health address) de SAMM.

Redes & routers

MikroTik gestor

Cuando un router tiene credenciales de API, SAMM lo gestiona directamente a través de la API de MikroTik — sin WinBox, sin SSH. La sección MikroTik es un inventario en tiempo real de cada router, y cada dispositivo abre una página de detalles con quince pestañas que permiten configurar casi cualquier parte de RouterOS desde su navegador.

MikroTik Monitor

MikroTik → Monitor muestra una tarjeta por router, dispuestas en una cuadrícula. Cada tarjeta informa —actualizada por samm-worker y consultada en tiempo real cada 30 segundos— el punto de disponibilidad, la versión de RouterOS, la carga de CPU y el número de núcleos, el uso de memoria, el número de sesiones activas, el tiempo de actividad y la hora de la última muestra.

Una tarjeta se etiqueta como NAS (un router que también autentica a los suscriptores a través de RADIUS) o monitor (un dispositivo añadido solo para monitoreo). Agregar MikroTik registra un nuevo dispositivo; Actualizar ahora obliga a una consulta inmediata. Las tarjetas solo para monitoreo tienen un menú al hacer clic derecho — Abrir, Editar, Actualizar Info, Eliminar.

Dispositivos Ubiquiti

Al añadir un monitor, elija su tipo: MikroTik, Ubiquiti airOS o Ubiquiti UniFi access point. Se accede a los dispositivos Ubiquiti a través de SSH con las credenciales del propio dispositivo; una página de Probe muestra la información que reporta el dispositivo. Un UniFi access point aparece en las páginas Wireless con una fila por radio —su canal, ancho y SSIDs, los clientes conectados con señal, ruido y tasa, y las redes vecinas que detecta— y participa en el optimizador de Wi-Fi y el planificador de canales.

Cada plan permite tres monitores por cada router (un plan con routers ilimitados tiene monitores ilimitados), por lo que supervisar sus puntos de acceso nunca consume su cupo de routers.

Usuarios configurados en un router

SAMM encuentra los inicios de sesión PPP, los usuarios de Hotspot y los usuarios de User Manager que el router mantiene (RouterOS 6 y 7) y los enumera en la página del router. Antes de realizar cualquier acción, cada fila muestra lo que SAMM creará: nombre de usuario, contraseña, nombre, móvil, plan (marcado como new cuando SAMM lo crea), vencimiento, límites, MAC e IP. También se leen los nombres, números de teléfono y fechas de finalización escritos en los comentarios del router, ya sea en árabe o inglés. Seleccione los usuarios e impórtelos: el proceso se ejecuta en segundo plano y la lista de Users se completa a medida que llegan.

La página del dispositivo — quince pestañas

Abra cualquier dispositivo para acceder a su página de gestión completa. Las pestañas se dividen en cuatro grupos.

Monitoreo

PestañaLo que muestra
Descripción generalInformación del dispositivo, información del sistema y gráficos de historial de rendimiento (CPU, memoria, sesiones a lo largo del tiempo)
InterfacesCada interfaz con su estado en tiempo real, además del historial de tráfico por interfaz
Sitios web & AppsTres subvistas: Monitor (sitios web y & apps detectadas en el router con historial de tráfico), QoS (prioridad basada en aplicaciones, a continuación) y App Filter (bloqueo de contenido basado en DNS desde el catálogo)

Gestor

La pestaña Manager → General es la página de mantenimiento del dispositivo: Identity (el nombre del router), Time (reloj, zona horaria y NTP) y Tools (reiniciar, ping y otras acciones del router de un solo clic).

Configuración de red

PestañaConfiguración realizada
BridgeCree puentes LAN y elija qué interfaces físicas (puertos) pertenecen a cada uno
VLANAgregar y gestionar interfaces VLAN
IPTres pestañas secundarias — Static (direcciones estáticas y dinámicas), DHCP client (obtener una dirección del upstream), DHCP server (asignar direcciones, con una tabla de concesiones en tiempo real)
DNSServidores DNS y caché (el filtro de contenido de la aplicación/sede se encuentra en Websites & Apps)
WiFi / CAPsMANInterfaces Wi-Fi con sus configuraciones y perfiles de seguridad; y el controlador CAPsMAN — configuraciones, reglas de aprovisionamiento y CAPs remotos

Servicios & mantenimiento

PestañaConfiguración realizada
PPPoEServidores PPPoE, perfiles PPP, pools de IP y el intervalo de actualización intermedia (interim-update) de accounting de RADIUS
HotspotServidores hotspot, perfiles de hotspot y perfiles de usuario, pools de DHCP/IP y la página de inicio de sesión del captive-portal
InternetEnlaces ascendentes WAN — WANs gestionadas por SAMM y rutas predeterminadas; cualquier WAN existente no gestionada por SAMM se muestra como solo lectura
CortafuegosReglas de filtrado, un análisis de seguridad del router, objetivos de conectividad &, módulos de seguridad y copias de seguridad del cortafuegos — Auto-Security toma instantáneas del cortafuegos antes de aplicar y puede activar una reversión automática programada, para que un conjunto de reglas que le bloquee el acceso se revierta automáticamente
ActualizarActualizaciones de RouterOS: elija un canal de actualización, compruebe y aplique, y revise los paquetes instalados
AsistenteLa configuración guiada inicial, a continuación

El intervalo de interim-update de PPPoE

En la pestaña PPPoE, Interim update establece con qué frecuencia el router envía paquetes RADIUS accounting Interim-Update a SAMM. SAMM utiliza esos paquetes para acumular los contadores de bytes y de tiempo de conexión y para evaluar la cuota, así como los límites diarios y de tiempo de conexión — sin ellos, la aplicación de los límites y los contadores de sesiones activas se detienen. El valor recomendado es 5m.

La página de inicio de sesión del Hotspot

Desde la pestaña Hotspot usted gestiona la página de inicio de sesión del portal cautivo: mantenga las páginas predeterminadas de MikroTik, aplique una de las plantillas integradas, o aplique uno de sus diseños guardados. SAMM incluye un editor de diseño visual y una galería de plantillas; personalice una página de inicio de sesión y envíela directamente al hotspot del router.

QoS basado en aplicaciones

La vista QoS (una pestaña secundaria de Websites & Apps) convierte las aplicaciones y sedes que SAMM ya detecta en el router en un plan de prioridad de descarga. Arrastre cada aplicación del grupo a una de las ocho ranuras de prioridad: la ranura 1 se atiende primero en caso de congestión y la ranura 8 al final; las aplicaciones que permanezcan en el grupo no serán limitadas. Opcionalmente, limite la velocidad de descarga de cualquier aplicación (por ejemplo, 10M) y establezca un límite total de descarga para que las prioridades compitan. Auto-distribuir por categoría organiza todo con un solo clic: primero la mensajería, luego los servicios de AI, después las tiendas y todo lo demás debajo.

Cuando envías, SAMM compila las franjas en un queue tree de MikroTik (etiquetado SAMM:qos, parent=global) con reglas de firewall de marcado de paquetes que coinciden, la prioridad más alta primero. Se construye sobre el mismo catálogo del Websites & App filter que impulsa la monitorización, así que solo aparecen las aplicaciones realmente detectadas en el router — y al eliminar el QoS de SAMM se retiran del router todos los objetos SAMM:qos, dejando tus contadores intactos.

El asistente de configuración

La pestaña Asistente recopila toda la información en diez pasos breves y envía la configuración completa al router en un solo bloque al final. No se envía nada hasta que usted confirme en el paso de revisión final.

  1. Bienvenido & detect — SAMM analiza el router y muestra lo que ya está configurado, para que pueda omitir esos elementos en el push.
  2. Interfaz Bridge — asigne un nombre al bridge de la LAN.
  3. Bridge ports — seleccione qué interfaces físicas se unen al bridge.
  4. DNS — configure los resolutores upstream (ajustes predefinidos de un solo clic para Google, Cloudflare, Quad9 y más), el tamaño de la caché y, opcionalmente, un filtro de contenido DNS.
  5. NTP — configure la fuente del reloj del router (cliente NTP y, opcionalmente, servidor de hora para la LAN).
  6. Internet — añada uno o más enlaces WAN ascendentes (Static / DHCP / PPPoE).
  7. RADIUS a SAMM — configure el router para que apunte a su host SAMM para autenticación, accounting y CoA.
  8. Services — elija si el asistente crea un servidor PPPoE, un servidor Hotspot o un servicio IPoE / DHCP, y opcionalmente active IPv6 dual-stack (opcional, desactivado por defecto): seleccione la longitud del prefijo delegado (DHCPv6-PD) y los bloques IPv6, y el asistente creará los pools y los asociará al perfil PPP.
  9. Detalles de PPPoE / Hotspot & Cortafuegos — pools, perfiles, tiempos de concesión, las reglas de cortafuegos & NAT, y un Expired pool & internet block opcional que redirige a los suscriptores con la suscripción vencida a la página de "suscripción vencida" de SAMM en lugar de dejar la conexión sin servicio.
  10. Revisar & enviar — vea la lista exacta de comandos que se enviarán y, a continuación, envíelos todos al router.
La velocidad por usuario proviene de RADIUS El asistente crea un único perfil PPPoE / hotspot; no asigna perfiles por nivel. La velocidad de cada suscriptor es entregada por SAMM en la respuesta RADIUS al iniciar sesión, por lo que los cambios de plan nunca requieren editar el router.

Redes & routers

Inspección profunda

Cuando una red va lenta, la Inspección profunda hace lo que haría un ingeniero: observa un router durante un rato, lee todo lo que puede y te dice qué está mal y qué hacer primero. Solo lee: nunca cambia nada en el router, y cualquier arreglo sigue siendo tu decisión.

Iniciar una inspección

  1. Abre Devices → Network Health y pulsa Inspección profunda, o haz clic derecho sobre un router en la página.
  2. Enciende los routers que vas a inspeccionar. Todos los interruptores empiezan apagados. Solo aparecen los BNG MikroTik con un inicio de sesión guardado.
  3. Elige cuánto: 15 minutos, 30 minutos, 1 hora o 2 horas. Una ejecución más larga es más fiable; ejecútala en una hora de mucha carga.
  4. Pulsa Iniciar inspección. Se ejecuta en segundo plano, así que puedes cerrar la página. Se ejecuta una inspección por router, como máximo dos a la vez.

Informes, junto al botón, muestra cada inspección con su progreso, resultado y puntuación. Puedes detener una antes de tiempo y conservar lo que ya midió.

Qué revisa

  • Enlaces a internet: pérdida y retraso hacia internet y en cada enlace, picos, y si pasan los paquetes grandes.
  • Experiencia del usuario: mensajes de prueba a una muestra cambiante de usuarios conectados, y cuánto tardan las respuestas.
  • Colas de usuarios y velocidad: si los usuarios pierden datos cuando su plan se llena, subida y bajada, y reglas que pueden saltarse los límites de velocidad.
  • Red de acceso y puertos: cada lado de acceso, las torres y los equipos detrás del router, errores de puerto, caídas, velocidad y señal de fibra.
  • Balanceo de carga: cómo reparten el tráfico los enlaces, y si las reglas de balanceo están completas y detectan un enlace caído.
  • Salud del router: carga del procesador y de cada núcleo, memoria, temperatura, reinicios, firmware y el registro del router.
  • Inicios de sesión y RADIUS: respuestas a tiempo, inicios de sesión rechazados, sesiones que terminan antes de tiempo y ajustes de tamaño de paquete.
  • Seguridad: si el router está cerrado a internet, el orden del cortafuegos, las protecciones, los servicios extra y los inicios de sesión fallidos.
  • Enrutamiento: sesiones BGP, vecinos OSPF y rutas muertas.

Se incluyen todas las comprobaciones de Network Health. Una comprobación que no se pudo leer se deja fuera del informe, nunca se cuenta como correcta.

El informe

Empieza con una puntuación sobre 100 y un veredicto en palabras sencillas, luego una tabla de resultados por área y una lista de qué hacer, lo más importante primero. Debajo están los detalles y los números. Sigue el idioma de tu panel, y Export PDF lo guarda con el logotipo de SAMM y “Prepared by SAMM” en cada página.

La inspección es ligera y deja de hacer ping a los usuarios mientras el procesador del router está muy ocupado. Si el router sigue sobrecargado, termina antes y lo indica.

Sistema

SCOOP AI

SCOOP AI es un asistente en la parte inferior de cada página de administración. Pregunta con tus palabras y tu idioma sobre usuarios, planes, tarjetas, facturas, pagos y routers, y recibe una respuesta clara en segundos. Se instala y se activa solo.

Conecta una IA

En Settings → SCOOP AI, conecta Google Gemini (clave gratuita), ChatGPT (inicia sesión, sin clave), Claude, OpenAI, OpenRouter o DeepSeek. Guarda varios inicios de sesión y cambia entre ellos, y elige un modelo o déjalo en Automático. Una clave que la propia IA rechaza se detiene al guardarla, y una página de ayuda muestra cómo obtener una clave para cada IA.

Qué lo mantiene seguro

  • Funciona con los permisos de cada administrador: un administrador ve y cambia solo lo que permite su rol.
  • El dinero, las eliminaciones y los cambios en los routers se retienen hasta que pulsas Approve.
  • Cada cambio en el router mantiene una opción de deshacer en el propio router y nunca toca el enlace de SAMM con el router.
  • El registro de SCOOP AI guarda cada pregunta, respuesta y aprobación de cada administrador.

Qué puedes pedirle que haga

  • Responder preguntas sobre tus datos, en tu idioma.
  • Repartir internet entre tus enlaces por porcentaje, enviar apps elegidas o una VPN por un enlace elegido, y configurar un DNS más rápido.
  • Enviarte un informe cada lunes, o recordártelo a una hora determinada.

Los permisos tienen un bloque SCOOP AI: usarlo, ver el registro, cambiar los ajustes. Cada administrador puede ocultarlo para sí mismo desde el menú del robot o desde su Perfil.

Redes & routers

Mapa de red, estado, Data Log & calidad de conexión

Mapa de red

Devices → Network Map se genera a partir de la información que cada router reporta sobre sus vecinos; no es necesario mantener ningún diagrama. Cambie las capas para visualizar puertos, direcciones IP, subredes y CPU, o muestre la ruta que cada dispositivo sigue hacia internet. Arrastre los nodos a su posición y guarde la disposición; Discover now vuelve a leer los vecinos.

Estado de la red

Devices → Network Health enumera cada router empezando por el estado más crítico: saludable, con advertencias, responde pero con errores, o inalcanzable. Cada hallazgo indica el problema en términos sencillos: CoA desactivado, secreto de RADIUS incorrecto, reloj desincronizado, Telnet o FTP abiertos. Las comprobaciones solo leen el router. Desde la vista Diagnose de un router, los hallazgos comunes tienen una solución de un solo clic que muestra una vista previa primero y puede revertirse. Los hallazgos abiertos generan alertas en el Alert Center.

Para una revisión más larga de un BNG MikroTik, con un informe completo, usa Inspección profunda.

Ambas páginas se encuentran bajo un mismo interruptor, Settings → Advanced → Network Health. Mientras esté desactivado, SAMM no contacta con los routers en su nombre. Cuando está activado, usted también elige con qué frecuencia se comprueba cada router, cuántos routers lee una pasada (las instalaciones saturadas se distribuyen en varias pasadas) y si se descubren los vecinos para el mapa.

Un router que ha estado caído durante mucho tiempo puede ser pausado, para que deje de generar alertas hasta que vuelva a responder.

Optimizador de Wi-Fi

Devices → Wireless → Wi-Fi optimizer muestra, para cada radio, una vista de espectro de la banda en la que opera (señal en dBm a través de las frecuencias, las redes que detecta y dónde se solapan), una lista de esas redes y un gráfico de canales que marca cada canal como Quiet, Busy o Crowded. Survey now analiza toda la banda, un radio a la vez para que una sede con varios sectores nunca pierda a todos sus clientes simultáneamente; el botón indica el coste antes de comenzar. Live sweep dibuja las lecturas finales, máximas y promedio en tiempo real.

El planificador de canales recomienda el canal más despejado y el ancho de canal óptimo para cada radio. Elija Off, Suggest o Auto para cada radio, por separado para su canal y su ancho, o permita que siga su red; configure varios radios a la vez desde la lista Wireless. En Auto, SAMM cambia los radios a las 04:00, uno a la vez, y analiza cada radio nuevamente en su nuevo canal. Aplicar mueve un radio ahora y Deshacer lo devuelve a su canal anterior. Funciona en radios MikroTik (paquetes wifi y wireless, CAPsMAN) y en puntos de acceso Ubiquiti UniFi.

Registro de datos

Abra un usuario y elija Data Log para ver a dónde se dirige su tráfico: los principales destinos por host y aplicación — YouTube, Facebook, WhatsApp — con subida, descarga y conexiones, o una línea de tiempo. SAMM lee la exportación de flujo (IPFIX) del propio router, recurriendo a su tabla de conexiones, y nombra las aplicaciones basándose en el mismo catálogo que utiliza el App Filter. SAMM nunca se sitúa en la ruta del tráfico.

  • Record user Data Log lo activa, en la ruta Settings → Advanced → Data Log.
  • El detalle horario se conserva durante unos días y luego se compacta a una fila por sede por día — aproximadamente una veinticuatroava parte del tamaño. Tanto la página como la exportación leen ambos formatos, por lo que nada desaparece de la vista.
  • Destinations per hour mantiene los destinos más activos de cada usuario por hora y descarta el resto de direcciones esporádicas; 0 mantiene todo.
  • Retention establece cuánto tiempo se conservan las filas antes de que la limpieza nocturna las elimine.
  • Una copia de seguridad con Skip usage excluye el Data Log, por lo que el archivo se mantiene pequeño.
Desactivado hasta que lo active Un superadmin activa el Data Log en Ajustes y elige cuánto tiempo se conserva. Las cifras son indicativas; la facturación siempre utiliza la contabilidad de RADIUS.

Calidad de la conexión

Mientras un usuario está en línea, SAMM puede registrar su velocidad promedio cada pocos minutos, a partir de la contabilidad que ya recibe, y medir el retraso y la pérdida mediante una prueba corta desde su router. La página del usuario muestra una tarjeta de Calidad de conexión con las cifras más recientes, un historial de velocidad frente al plan y un botón de Probar ahora; la lista de usuarios tiene una columna opcional y la exportación puede incluir las cifras. El historial se conserva durante dos días.

Desactivado hasta que lo active Actívelo en Settings → Advanced → Connection Quality, donde también puede configurar la frecuencia de muestreo de los usuarios y cuántos usuarios prueba un router por ronda (empezando por los medidos hace más tiempo). Está diseñado para ser ligero: la medición de velocidad no consume tráfico del router y la carga de prueba en cada router está limitada. Un dispositivo que bloquee la prueba no mostrará respuesta aunque la línea esté bien. Test now funciona incluso cuando la función está desactivada.

Redes & routers

CoA & cambios en tiempo real

CoA (Change-of-Authorization) es el mecanismo mediante el cual SAMM modifica la sesión de un suscriptor mientras está en línea — para aumentar o reducir su velocidad, o para desconectarlo — sin esperar a que se reconecte.

Cómo llega un cambio a un suscriptor activo

SAMM nunca aplica un cambio en un router directamente al hacer clic en un botón. Cada acción del administrador sigue una única ruta segura:

Acción del administrador → Registro de auditoría → samm-radius tick → Bandeja de salida CoA → Router
  1. La acción se registra en un registro de auditoría como un comando en cola.
  2. El servicio samm-radius vacía la cola en su siguiente tick, aplica el cambio y — si el suscriptor está en línea — pone un CoA en cola.
  3. La bandeja de salida de CoA se vacía y el paquete se envía al router.

Los eventos basados en el tiempo —vencimientos, límites de ventanas de velocidad, reinicios diarios— alimentan la misma bandeja de salida. El límite superior de la latencia es un tick de samm-radius (30 s por defecto; redúzcalo en Ajustes para una aplicación más estricta).

CoA híbrido

SAMM envía primero un CoA-Update para cambiar la sesión en tiempo real. Si el router lo rechaza tras los reintentos configurados, SAMM recurre automáticamente a un Disconnect-Request — el suscriptor se reconecta y aplica los nuevos ajustes. Esta estrategia híbrida funciona en todas las versiones de firmware de MikroTik.

La página CoA Outbox

Users → CoA Outbox es la vista en tiempo real de esa cola. samm-radius es el único remitente — el panel del administrador nunca envía un CoA directamente — y vacía la cola en cada ciclo. La página se actualiza automáticamente cada 30 segundos.

Seis contadores encabezan la página: Pending, Sent, NACK (retrying), Done, Failed y Total. Filtre la tabla por estado, por acción (update o disconnect), o busque por nombre de usuario, IP del NAS o motivo.

EstadoSignificado
pendienteEn cola, esperando el siguiente tick de samm-radius
enviadoEnviado (transitorio — el envío y su resultado se registran en el mismo tick, por lo que las filas rara vez permanecen en este estado)
nackEl router rechazó el CoA-Update; SAMM reintentará la operación y, de fallar, procederá a una desconexión
listoAplicado correctamente
fallidoSe detuvo tras alcanzar el límite de reintentos — pase el cursor sobre la insignia para ver el último error

Cada fila muestra el usuario, router, acción, recuento de intentos, motivo y las horas de creación y envío. Las acciones por fila le permiten Reintentar un paquete fallido o rechazado (nack'd), Cancelar uno que aún esté en tránsito, o abrir Atributos para inspeccionar los atributos RADIUS exactos que lleva el paquete. La insignia de la barra lateral cuenta las filas pendientes; el panel rastrea los fallos de las últimas 24 horas. Un sistema saludable mantiene esta cola casi vacía.

Depurador de sesiones inactivas

Si un router falla o pierde la conectividad, sus paquetes Accounting-Stop pueden perderse — y en muchos sistemas esos suscriptores permanecen "online" indefinidamente. SAMM busca sesiones que hayan dejado de enviar Interim-Updates y las cierra automáticamente (causa de terminación Reaped-Stale), para que la lista de sesiones activas, los recuentos de uso simultáneo y las cifras de consumo se mantengan precisas. El tiempo de espera es el ajuste stale_session_timeout_seconds (predeterminado 900 s = 15 minutos; establezca 0 para desactivar), y surte efecto inmediatamente — no es necesario reiniciar.

Operaciones diarias

Panel & sesiones activas

Las dos pantallas bajo Overview son el punto de partida de cada turno: el panel para supervisar el estado general del sistema y Live Sessions para ver exactamente quién está conectado en este momento.

Dos pantallas: abrir en una ventana nueva

Cada página tiene un botón Abrir en una ventana nueva en la barra superior: la página se abre sola, sin la barra lateral ni la barra superior, lista para arrastrarla a un segundo monitor. Los enlaces dentro de esa ventana siguen en el mismo modo. Cada bloque del panel tiene el mismo botón en su esquina: el bloque llena su propia ventana y se sigue actualizando con el panel, así puedes tener Sesiones activas, el estado de los routers o un gráfico a la vista todo el día sin cambiar la disposición de tu panel.

Panel

Overview → Panel es la pantalla de inicio del operador. Un selector de periodo en la parte superior — Today, 7d, 14d, 30d, 90d — define el intervalo para el gráfico de tendencias y las cifras delimitadas por fecha.

Los seis mosaicos de KPI

Cada mosaico es un contador en tiempo real y un acceso directo: haga clic en él para ir directamente a la lista filtrada correspondiente al número.

MosaicoMuestraAbrir
En línea ahoraSuscriptores con una sesión RADIUS activa en este momentoUsuarios filtrados por Online
Suscriptores activosCuentas activas, con el recuento total de suscriptores debajoUsuarios filtrados por Active
ExpiradoSuscriptores cuya suscripción ha caducado sin un plan siguiente configuradoUsuarios filtrados por Expired
Tickets abiertosTickets de soporte aún no resueltos (excluye finalizados & cerrados)Usuarios → Tickets de soporte
RoutersTotal de registros NAS, más el recuento de los que no están accesibles actualmenteEl monitor de MikroTik
Facturas pendientes de pagoFacturas que aún requieren seguimiento de pagoFacturas filtradas por Unpaid

Gráfico de usuarios & sesiones activas

Un gráfico de líneas de instantáneas diarias muestra tres series a lo largo del periodo seleccionado — usuarios activos, sesiones en línea y usuarios expirados — para que el crecimiento y la tasa de cancelación sean visibles de un vistazo.

Estado del pipeline

Este panel es el núcleo del motor de ejecución. En un sistema saludable, las colas se mantienen en cero o cerca de cero; un número que permanezca alto indica un servicio bloqueado o un router que rechaza los cambios.

MétricaQué significa
samm-radius colaCoAs pendientes esperando el siguiente tick — deberían borrarse en unos segundos
CoA fallido (24h)Cero en un sistema saludable; un recuento distinto de cero significa que un router está rechazando CoAs
Registro de auditoría pendienteAcciones del administrador en cola que aún no han sido aplicadas por samm-radius
Sesiones limitadasSuscriptores que actualmente tienen una velocidad reducida debido a un límite — comportamiento esperado, no es un error
Instantánea de sesionesEl recuento de sesiones activas — debe coincidir con Online now
Planes activosEl tamaño de su catálogo de planes
La ruta de aplicación Las acciones del administrador se encolan en samm.audit_log; el tick de samm-radius las vacía y emite CoAs hacia samm.coa_outbox. La ruta completa se encuentra en CoA & live changes.

Tablas de actividad reciente

Cuatro tablas debajo del gráfico ofrecen una vista actualizada de lo ocurrido recientemente, cada una con un enlace View all a su página completa:

  • Bandeja de salida de CoA reciente — acción, usuario, estado (done / pending / nack / failed), número de intentos, motivo y hora.
  • Acciones recientes del administrador — acción, objetivo, el actor que la activó, si ya se ha aplicado y hora.
  • Suscriptores recientes — las cuentas más recientes con su estado y la hora de la última autenticación.
  • Routers — cada NAS con un punto de estado de alcanzable / inalcanzable / sin datos.

Sesiones activas

Overview → Live Sessions enumera a cada suscriptor que los routers reportan actualmente como conectado a través de RADIUS accounting. La página se actualiza automáticamente cada 30 segundos; en el encabezado se encuentra un botón de Refresh manual.

Filtrado de la lista

  • Buscar — coincide con el nombre de usuario, la IP enmarcada o la IP de NAS, realizando la búsqueda mientras escribe.
  • Router — filtrar la lista para mostrar las sesiones de un único NAS.
  • Only throttled — mostrar solo los suscriptores cuyo límite está restringiendo la velocidad.
  • Por página — 20, 50, 100 o 200 filas.

Qué muestra cada fila

ColumnaSignificado
UsuarioNombre de usuario — enlaza a la página de detalles del suscriptor
Framed IPLa dirección que el router asignó a esta sesión
RouterEl nombre corto del NAS y su dirección IP
PlanPlan actual del suscriptor
Velocidad efectivaLa velocidad aplicada en el router en este momento: la velocidad del plan ajustada por cualquier ventana de velocidad activa. Una insignia de throttled indica que un límite mantiene al suscriptor a una velocidad reducida.
Desconectado / ConectadoContadores de bytes en tiempo real de la sesión
En líneaTiempo de actividad de la sesión
IniciadoCuando comenzó la sesión

Desconexión de una sesión

El botón Disconnect de una fila pone en cola un CoA-Disconnect para esa sesión exacta (motivo admin_manual) tras un aviso de confirmación. El suscriptor se desconecta inmediatamente; si su cuenta sigue activa, puede volver a conectarse. Siga el paquete en la CoA Outbox.

Operaciones diarias

Informes & analíticas

Overview → Reports es la vista de analítica: tendencias de suscriptores, tráfico a lo largo del tiempo y los usuarios y tarjetas con mayor consumo de su red.

Selección del rango

Cada cifra de la página está vinculada a un rango de fechas. Elija un preajuste — 7d, 14d, 30d, 90d — o escriba las fechas de inicio y fin explícitas y haga clic en Aplicar. Una superposición de carga cubre la página mientras se ejecuta una consulta de rango amplio, como la de 90d.

Tendencias de sesión del suscriptor &

Un gráfico de líneas con tres series sobre el rango seleccionado: suscriptores Activos, sesiones En línea y suscriptores Expirados. Utilícelo para detectar el crecimiento, la tasa de cancelación y las horas punta de su red.

Tráfico diario

Un gráfico de barras apiladas de bytes de subida y descarga por día. Al pasar el cursor sobre un día, se muestran las cifras de subida y descarga, además de un total combinado en el pie del cuadro de información.

Listas de los 10 mejores

Cuatro tablas muestran sus cuentas con mayor tráfico, cada una clasificada por volumen en GB:

ListaRangos
Top 10 descargas de hoyLa descarga más grande desde el último reinicio diario
Top 10 de subida de hoySubida máxima desde el último reinicio diario
Top 10 descargas del mesDescarga más grande de este mes calendario
Top 10 de subida del mesSubida máxima de este mes calendario

Tráfico por entidad

Una tabla paginada y con función de búsqueda del tráfico por cuenta. Dos pestañas permiten cambiar la información mostrada:

  • Usuarios — cada suscriptor con su nombre, plan, subida/descarga de hoy en MB y subida/descarga de este mes en GB.
  • Tarjetas — cada tarjeta de hotspot con su grupo, estado y el mismo desglose de tráfico diario / mensual.

El cuadro de búsqueda filtra la tabla mientras escribe; el selector de elementos por página permite elegir entre 20 y 200 filas. Cada fila contiene un enlace a la página de detalles de ese suscriptor o tarjeta.

Exportación Reports es una vista de análisis en pantalla. Para obtener filas de datos sin procesar y analizarlas en una hoja de cálculo, use Tools → Export / Import para descargar usuarios, planes o NAS en formato CSV / XLSX.

Página de tráfico en tiempo real

Una vista en vivo y separada del rendimiento actual de usuarios, routers e interfaces, con actualizaciones cada segundo. Guarde en marcadores las combinaciones que consulte a menudo para tenerlas a un solo clic la próxima vez.

Operaciones diarias

Contabilidad & facturación

SAMM tiene incorporado un sistema completo de contabilidad de partida doble: facturas, gastos, recibos, pagos, revendedores, activos fijos y estados financieros completos. No es necesario integrar ningún producto de facturación independiente, ni contar con un contador para mantener los libros al día.

Usted nunca debe modificar los débitos y créditos Cada acción —registrar un pago, añadir un gasto, vender un grupo de tarjetas— genera automáticamente un asiento contable cuadrado en el libro mayor. Usted trabaja en términos sencillos (facturas, gastos, recibos); SAMM mantiene la contabilidad de partida doble en segundo plano y demuestra que cuadran en el Balance de Comprobación.

La página Accounting está organizada en once pestañas.

Descripción general

El resumen financiero. Cuatro cifras principales aparecen en la parte superior:

FiguraSignificado
Efectivo disponibleSaldo total de todas las cuentas de efectivo & bancarias
Saldo a su favorCuentas por cobrar — facturas pendientes de clientes y revendedores
Saldo pendienteCuentas por pagar — gastos pendientes de pago
Ganancias de este mesIngresos menos gastos del mes actual

A continuación: una tabla de cada cuenta de efectivo & bancaria con su saldo, y un gráfico de ingresos vs gastos de los últimos 1, 2, 3, 6 o 12 meses.

Libros por sucursal

Cada factura, pago, gasto, activo y cuenta de efectivo pertenece a una sucursal o a la empresa General. Una factura conserva la sucursal que tenía el usuario al momento de su emisión, incluso si el usuario es trasladado posteriormente. Un selector de Sucursal en la parte superior de cada pestaña muestra toda la empresa, solo la empresa General, o una sucursal con sus sub-sucursales; asimismo, las listas se pueden filtrar, ordenar y agrupar por sucursal. Un administrador de sucursal con el permiso Financial ve únicamente los libros de su propia sucursal.

Entrega de efectivo: una sucursal envía efectivo desde su propia cuenta de efectivo a una cuenta de efectivo de la empresa; se registra cuando la empresa confirma su recepción. Reports → Branches muestra cada sucursal comparativamente: ingresos, gastos, neto, cobros, pendientes, usuarios activos e ingresos por usuario.

Facturas

Una factura es un documento de cobro que usted emite. Haga clic en New invoice y complete:

CampoSignificado
ClienteBúsqueda predictiva de la cuenta a facturar
Categoría de ingresosCuenta de ingresos donde se registra la venta
Emisión / Fecha de vencimientoSi la fecha de emisión está en blanco, se asigna la fecha de hoy; si la fecha de vencimiento está en blanco, se asigna la fecha de emisión
Tasa de impuesto % / grupo de impuestoPor defecto, utiliza la tasa en Ajustes → Billing; asigne un grupo de impuestos para aplicar varias tasas (VAT/GST y más) a la vez, cada una contabilizada en su propia cuenta de impuestos
ConceptosUna o más filas de descripción / cantidad / precio unitario — el subtotal, el impuesto y el total se calculan en tiempo real

Cuánto cobrar: total, segmentado o nada

Siempre que SAMM esté a punto de facturar a un suscriptor —al activar, renovar, cambiar un plan, extender un vencimiento o realizar cualquiera de estas acciones en lote— aparecerá el mismo selector de factura, el cual muestra el importe antes de confirmar:

OpciónQué se cobra
Factura completaSolo periodos de plan completos; las fracciones de periodo se redondean al periodo completo siguiente.
Factura segmentadaLa hora exacta, prorrateando el último periodo parcial. El total se redondea al importe entero más cercano y la diferencia se registra como un ajuste de redondeo para que los libros sigan cuadrando.
Sin facturaCambie el servicio y no cobre nada: una extensión de cortesía, una migración o una corrección.

Establezca la duración con el multiplicador de periodos para periodos completos del plan, o escriba una fecha exacta y deje que SAMM calcule el coste. En cualquier caso, el panel muestra los conceptos, el impuesto y el total a medida que los cambia, y Paid registra un pago en efectivo por el importe total inmediatamente.

"No invoice" es un derecho, no una casilla de verificación No cobrar es una decisión financiera, por lo que está restringida mediante un permiso por rol en Ajustes → Administradores. Esto es especialmente importante con los agents: un agente cuyos suscriptores facturan a su propio saldo prepago podría, de lo contrario, renovar, cambiar planes y extender vencimientos constantemente sin pagar nunca por ellos. Los nuevos roles tienen este permiso desactivado.

Gestión de impagos & billetera prepago

Más allá de las facturas individuales, SAMM automatiza todo el ciclo de cobro. Un calendario de reclamación establece un día de facturación, un día de vencimiento y un día de bloqueo automático —con cargos por mora opcionales— para que los suscriptores morosos reciban recordatorios y luego sean desconectados, sin que usted tenga que supervisar una hoja de cálculo. El modo de monedero prepago permite que los suscriptores mantengan un saldo que liquida automáticamente las facturas al renovar; ellos mismos lo recargan desde el portal del cliente mediante tarjeta o crypto, y cada recarga y deducción se registra en el libro mayor.

Planes de gracia: facturar primero, renovar al pagar

Una configuración común es una cadena de planes: el plan de pago expira hacia un plan de grace corto a máxima velocidad, luego un plan lento y, finalmente, el usuario es desconectado. Active Raise the renewal invoice when a paid plan expires into its next plan en Accounting → Settings y SAMM emitirá la factura de renovación en el momento en que el usuario pase al periodo de grace, con vencimiento al finalizar dicho periodo. Tan pronto como se pague —en el mostrador, en línea o desde la wallet— el usuario regresa a su plan, con fecha desde el día en que expiró, para que el día de facturación nunca se desplace. Los usuarios que no paguen simplemente continúan bajando por la cadena.

No presione Renew plan para estos usuarios Renovar el plan restaura el servicio completo de inmediato, esté pagado o no. Con el ajuste activado, la factura y el pago realizan la renovación por usted. El ajuste permanece desactivado hasta que usted lo active.

Las facturas también se generan automáticamente cuando se renueva el plan de un suscriptor (desde la acción Renew Expiration del usuario o mediante la renovación automática), siempre que el plan tenga un precio. La lista se filtra por estado — unpaid, partial, due, paid — y permite buscar por número de factura o cliente. Abra cualquier factura para acceder a su página de detalles y a un PDF imprimible; los suscriptores pueden descargar sus propias copias desde el portal del cliente y el bot de Telegram.

Gastos

Un gasto es dinero invertido en la operación del ISP. New expense registra una categoría (la cuenta de gastos), el fabricante al que se pagó, el monto, la fecha en que se incurrió y una fecha de vencimiento opcional. Cada gasto tiene el mismo ciclo de vida unpaid / partial / due / paid que una factura, una página de detalles y un voucher PDF imprimible.

Recibos & Pagos

Estas dos pestañas registran el movimiento real de efectivo, a diferencia de la factura o el gasto que lo causó.

  • Recibos — dinero entrante: efectivo recibido de un cliente, un revendedor u otros ingresos, que ingresan en una de sus cuentas de efectivo. Una factura es el documento de cobro; el recibo es el dinero que se recibe para liquidarla.
  • Pagos — dinero saliente: efectivo pagado por un gasto o a un revendedor.

El registro de un recibo o pago actualiza el estado de la factura o el gasto relacionado a pagado y contabiliza el asiento correspondiente en el libro mayor.

Clientes & ventas de tarjetas

La pestaña Customers enumera el saldo actual de cada cliente: lo que le deben a usted. Card sales cubre los ingresos de los hotspots prepago: realiza el seguimiento de los card groups vendidos y los resellers. Un reseller le compra grupos de tarjetas completos mediante una factura y luego revende las tarjetas individuales a los usuarios finales; su balance owed es lo que aún tiene pendiente de pagarle.

Agentes — facturación mayorista

Un agente vende su servicio a clientes finales bajo un modelo de prepaid wholesale — imagine una franquicia o un subdistribuidor que gestiona su propia cartera de suscriptores pero utiliza su red. Es totalmente opcional: si nunca crea un agente, la facturación funcionará exactamente como siempre.

Dos deudas, claramente separadas El agente le debe a usted el precio al por mayor (en sus libros, es su ingreso); el cliente le debe al agente el precio al por menor (fuera de sus libros; es la cuenta por cobrar del agente). Su comisión es la diferencia entre ambos, registrada como un descuento comercial, nunca como un gasto.

Cree un agente en Ajustes → Administradores asignando a un nuevo administrador el rol integrado de Agent. Un agente es un inicio de sesión de administrador con alcance limitado con:

AjusteSignificado
% de comisiónLa comisión del agente sobre el precio de venta al público (p. ej. 40% — usted conserva el 60% como ingresos mayoristas). Editable por agente en cualquier momento.
Límite de créditoLímite hasta el cual el saldo prepago del agente puede quedar en negativo antes de que se rechacen las renovaciones. Establezca 0 para prepago estricto.
Saldo prepagoRecárguelo cuando el agente le pague; cada renovación deducirá el precio al por mayor de este saldo.

Cuando uno de los suscriptores del agente renueva, SAMM debita del saldo del agente el precio al por mayor, registra sus ingresos y emite una factura minorista real al cliente final, la cual es pagadera al agente y no figura en su libro contable. El cobro persuasivo del agente —su propio interruptor en Ajustes → Facturación, activado por defecto, con un periodo de gracia editable— suspende automáticamente a un cliente moroso (emitiendo una desconexión CoA); cuando el agente registra el pago del cliente, el suscriptor se reactiva al instante.

Un agente inicia sesión en una vista delimitada: su propio panel, una página de billetera My Balance, una lista de My Customers con las facturas y pagos de cada cliente, y un My Statement — todo limitado a su propio libro. Los libros de toda la empresa, así como los clientes de otros agentes y otros administradores, permanecen ocultos.

Activos & Cuentas de efectivo

  • Assets — registre activos fijos (routers, vehículos, equipos). SAMM realiza el seguimiento de su valor y depreciación a lo largo del tiempo.
  • Efectivo — gestione sus cuentas bancarias de efectivo & y sus cuentas de capital: el patrimonio neto, donde una aportación es dinero que el propietario aporta al negocio y un retiro es dinero que se extrae. El capital no es un ingreso y nunca aparece en Pérdidas & Ganancias.

Informes — los estados financieros

La pestaña Reports es la vista del contador. Cinco informes, cada uno con un rango de fechas y exportable a PDF:

InformeRespuestas
Ganancia & PérdidaIngresos frente a gastos y beneficio neto en un rango de fechas. Base de devengo: los ingresos se contabilizan al facturarse y los gastos al incurrirse, no cuando se produce el movimiento de efectivo.
Balance generalA una fecha determinada: lo que posee (activos) frente a lo que debe (pasivos) más el patrimonio neto. Una insignia de equilibrado confirma que ambos lados coinciden.
Flujo de cajaPor cuenta de efectivo: saldo inicial, entradas, salidas y saldo final en un rango determinado.
Tiempo de vidaCuentas por cobrar y por pagar pendientes clasificadas por antigüedad, para que pueda reclamar facturas vencidas y anticiparse a los pagos.
AvanzadoLos libros contables: Libro Mayor (cada línea en una cuenta con un saldo acumulado), Balance de Comprobación (la verificación del equilibrio de los libros), el Libro Diario y un registro de actividad.
La comprobación de equilibrio En el Trial Balance, las columnas de débito y crédito de cada cuenta deben sumar lo mismo; esa es la prueba de que los libros son correctos. Si en algún momento no hay equilibrio, esto indica un error de registro que debe investigarse.

Exportar a software de contabilidad

En Accounting → Reports → Export, realice la descarga de los libros en CSV para QuickBooks, Xero o cualquier hoja de cálculo: General Journal, Chart of Accounts, Invoices, Trial Balance, Profit & Loss y Balance Sheet. General Journal, Invoices y P&L utilizan el rango de fechas; el resto se generan con fecha de hoy. Los mismos datos están disponibles a través de la API en GET /api/v1/accounting/export/{kind} (format=json|csv, scope accounting:read) para pipelines de BI y Zapier. Las exportaciones excluyen las entradas anuladas, por lo que una descarga siempre coincide con los informes en pantalla.

Operaciones diarias

Deshacer & aprobaciones

La mayoría de los errores en un panel de ISP son errores monetarios: se renovó al suscriptor equivocado, se registró un pago dos veces o se cambió un plan en la cuenta incorrecta. SAMM le ofrece una ventana de deshacer de cinco minutos para esas acciones y —cuando una acción implica la devolución de dinero— una puerta de aprobación del superadmin antes de que surta efecto.

La ventana de deshacer

Cada acción del administrador que mueva dinero o el estado se registra en el momento en que ocurre. Durante los próximos cinco minutos, la barra superior muestra un botón de Deshacer y una lista de Historial de acciones: haga clic en la flecha para revertir la última acción, o abra el historial y regrese a cualquier punto dentro de ese intervalo. Rehacer restablece la acción.

Por qué solo cinco minutos Deshacer no es una máquina del tiempo; es una red de seguridad para el clic que acaba de realizar. Después de unos minutos el mundo ha avanzado: el suscriptor ha estado en línea, se ha pagado una factura, alguien más ha editado el registro. SAMM prefiere rechazar la acción que reescribir el historial silenciosamente, por lo que el paso simplemente desaparece de su historial cuando se cierra la ventana.

Una acción de deshacer se rechaza —mostrando el motivo en pantalla— cuando revertirla destruiría algo que no creó:

RechazoQué significa
Ese registro ya no existeEl suscriptor, la factura o el pago se eliminaron después de su acción; no queda nada que restaurar.
Ese registro ya existeSe ha vuelto a crear un elemento en su lugar; deshacer la acción sobrescribiría el registro más reciente.
Este registro ha cambiado tras su acciónAlguien más lo ha editado mientras tanto; deshacer la acción descartaría silenciosamente su edición.
Ese paso ya no se encuentra en su historialEl plazo de cinco minutos ha expirado.

Deshacer es una reversión, no una eliminación: tanto la acción original como su anulación permanecen en el Audit log, por lo que el registro de lo ocurrido nunca se pierde. Las acciones que crean algo le advierten claramente — deshacer esto eliminará lo que se creó — antes de ejecutarse.

El filtro de aprobación del agente

Un agente paga por un suscriptor utilizando su propio saldo prepago en el momento en que lo activa. Esto hace que revertir una acción sea una forma de recuperar el dinero y, a la vez, una forma de hacer trampas: activar a un suscriptor, dejar que use el servicio todo el mes y luego eliminarlo el último día para recuperar el cargo.

Así, SAMM divide las acciones de un agente según la dirección en que se mueve el dinero:

DirecciónEjemplosComportamiento
Genera costes para el agente Activar, renovar, cambiar plan, cobrar un pago de cliente Inmediato. El trabajo diario de un agente nunca espera a nadie.
Reembolso de dinero Deshacer, eliminar un suscriptor, eliminar una factura, anular un cobro Pendiente como solicitud. No se aplicará ningún cambio hasta que un superadmin lo apruebe.

Las acciones restringidas no se ejecutan parcialmente. La solicitud se almacena con todo lo necesario para llevarla a cabo más tarde, y aprobarla la reproduce a través del mismo código que habría ejecutado el agente — nunca una segunda implementación que pudiera divergir de la primera. Rechazarla deja el entorno exactamente como estaba y el agente conserva la tarea.

Gestión de la cola

Las solicitudes llegan a Accounting → Agents Approval con el agente, la acción, a qué se refiere y cuánto dinero devuelve — el número que define la decisión. Filtre por agente o estado, busque, seleccione varias y apruebe o rechace todas a la vez; un rechazo puede incluir un motivo breve que el agente podrá ver.

Delegar Revisar agentes todo el día rara vez es tarea del superadministrador. El permiso de Agents Approval puede otorgarse a cualquier rol en Ajustes → Administradores, para que la persona que realmente realiza la revisión tenga exactamente ese poder —y nada más. La creación y gestión de agentes sigue siendo exclusiva del superadministrador. Nadie puede decidir sobre su propia solicitud.

Lo que ve el agente

El agente dispone de una página My Account → Pending Approvals donde se enumera todo lo que ha solicitado: lo que sigue pendiente y lo que fue aprobado o rechazado — junto con el motivo del revisor. Sin esto, un rechazo sería indistinguible de una solicitud que desapareció, y el agente simplemente volvería a solicitarlo.

Pueden retirar sus propias solicitudes pendientes —una a la vez o varias simultáneamente— porque solicitar algo que no se puede anular es una trampa en sí misma. Una solicitud retirada nunca se ejecutó, por lo que nada cambia; una ya resuelta es historia y permanece. Una factura que espera revisión también lo indica en su propia página, por lo que un agente que haya hecho clic en Eliminar y no haya visto ningún cambio entenderá por qué.

Para sus suscriptores

Pagos en línea

SAMM permite a sus suscriptores pagar sus facturas en línea — con tarjeta bancaria (Stripe o PayPal), con criptomonedas (Binance), o con Sham Cash en Siria. Cuando un suscriptor paga, SAMM marca la factura como pagada, la registra en su contabilidad y — si había sido desconectado por falta de pago — lo reconecta automáticamente. Usted nunca paga comisiones: cada pasarela usa su propia cuenta, así que el dinero va directamente a usted.

Activar (cualquier pasarela)

  1. Abra Financial → Online payments (solo superadmin).
  2. Haga clic en una pasarela para expandirla — Stripe, PayPal o Binance.
  3. Complete sus campos, marque Enable this gateway y haga clic en Save. SAMM no le permitirá guardar hasta que los campos obligatorios estén completos.
  4. Haga clic en Run test para confirmar que sus credenciales funcionan.
  5. Listo — sus suscriptores ahora ven un botón de Pagar en sus facturas impagadas en el portal (y en la página de "suscripción expirada").

Puede habilitar más de una pasarela; el suscriptor elige cuál utilizar.

Stripe — tarjetas bancarias, a nivel mundial

  1. Cree una cuenta gratuita en stripe.com. Mantenga activado el Test mode mientras realiza las pruebas.
  2. Vaya a Developers → API keys y copie la Secret key (comienza con sk_).
  3. En SAMM, expanda Stripe, pegue la Secret key, elija la moneda y la cuenta de efectivo que la recibe, luego Guardar y Ejecutar prueba.
  4. Recomendado: añada un webhook para que los pagos se confirmen de forma fiable. En Stripe, vaya a Developers → Webhooks → Add endpoint, establezca la URL como https://YOUR-SAMM/pay/webhook/stripe, elija el evento checkout.session.completed y luego copie su signing secret (whsec_…) en el campo Webhook signing secret de SAMM.
Puesta en servicio El modo de prueba funciona en cualquier lugar. Para recibir dinero real a través de Stripe, se requiere un país compatible con Stripe y una cuenta bancaria vinculada.

PayPal — tarjetas & saldo de PayPal

  1. Cree una cuenta de PayPal Business, luego en developer.paypal.com cree una App REST y copie su Client ID y Secret.
  2. En SAMM, expanda PayPal, pegue el Client ID y el Client secret, elija Sandbox (pruebas) o Live, luego haga clic en Guardar y Ejecutar prueba.
  3. Recomendado: añada un webhook en developer.paypal.com → su App → Webhooks, URL https://YOUR-SAMM/pay/webhook/paypal, suscríbase a CHECKOUT.ORDER.APPROVED y PAYMENT.CAPTURE.COMPLETED, luego pegue el Webhook ID en SAMM para que las notificaciones entrantes se verifiquen criptográficamente.

Binance — criptomonedas, funciona en todas partes, no requiere banco

Esta es la mejor opción cuando las tarjetas y PayPal no están disponibles. Sus suscriptores pagan en criptomonedas; SAMM supervisa su cuenta de Binance y marca la factura como pagada automáticamente. Necesita tres cosas: una API Key, un API Secret y un lugar donde recibir — una dirección de billetera y/o un Binance Pay ID.

Paso 1 — Crear una API key de solo lectura

La seguridad es lo primero Cree la clave con solo acceso de lectura. Nunca habilite Withdraw o Trade; SAMM solo necesita leer sus pagos entrantes, nunca mover fondos.
  1. Inicie sesión en Binance → abra Cuenta → API Management (o busque "API Management").
  2. Haga clic en Create API → elija System generated → asígnele un nombre, p. ej. "SAMM" → complete la verificación de seguridad.
  3. Binance muestra la API Key y la Secret Key — copie ambas ahora (la Secret se muestra solo una vez).
  4. Haga clic en Edit restrictions y mantenga marcada solo la opción "Enable Reading". Deje Spot Trading y Withdrawals desactivados. (Opcional: restrinja la clave a la dirección IP de su servidor)
  5. Pegue la API Key y el API Secret en la tarjeta de Binance de SAMM (primero la Key, luego el Secret — en el mismo orden en que los muestra Binance).

Paso 2 — obtenga la dirección de su billetera de recepción

  1. En Binance vaya a Wallet → Spot → Deposit (Deposit Crypto).
  2. Seleccione la moneda USDT.
  3. Elija la red — TRC20 es la más económica y común; BEP20 y ERC20 también funcionan. Use la misma que seleccione en SAMM.
  4. Copie la Address de depósito y péguela en el campo On-chain receiving wallet address de SAMM. Asegúrese de que el menú desplegable Network de SAMM coincida con la red que eligió.

Paso 3 — (opcional) Binance Pay ID

Para los suscriptores que prefieran Binance Pay (instantáneo, sin comisión de red): en la aplicación de Binance abra Pay y anote su Pay ID (también puede usar su correo electrónico o teléfono). Péguelo en el campo Binance Pay ID de SAMM. Los suscriptores podrán pagar mediante Pay ID, así como on-chain.

Por último, marque Enable, haga clic en Save y luego en Run test (esto comprueba que la clave puede leer su cuenta). Ya está activo.

Monto exacto, red correcta El suscriptor debe enviar la cantidad exacta que muestra SAMM (los últimos dígitos pequeños identifican su factura) a través de la red correcta. Una cantidad diferente o la red incorrecta retrasarán o provocarán la pérdida del pago.

Dinero Ficticio — Siria

Sus usuarios pagan desde su aplicación Sham Cash o el sitio web de Sham Cash, y SAMM es notificado en el momento en que se realiza el pago. El dinero va a su propia cuenta comercial de Sham Cash.

  1. Abra una cuenta comercial verificada de Sham Cash y luego solicite al soporte de Sham Cash que cree un servicio de pago electrónico para usted (le solicitarán la dirección de su logotipo y el nombre que verán sus usuarios).
  2. Sham Cash le proporciona tres valores: la Agent Key, la Secret Key y la Base URL. Tanto el servicio de prueba como el servicio real tienen sus propios tres valores.
  3. En SAMM abre Finanzas → Pagos en línea → Sham Cash, deja Conexión en Official API, pega los tres valores, elige la moneda (USD o SYP, la misma que tu moneda de SAMM) y pulsa Guardar, luego Ejecutar prueba.
  4. SAMM debe ser accesible desde Internet para que Sham Cash pueda confirmar cada pago. Si su SAMM está publicado bajo otra dirección, ingrésela en Public SAMM address for the callback. No es necesario configurar nada en el lado de Sham Cash para esto: SAMM envía su propia dirección con cada pago.
Servicio de prueba o servicio real Con los valores de test, cada pago es una simulación: la página de pago acepta el código 000000, SAMM muestra la factura como pagada y no llega dinero a ninguna cuenta. Los pagos reales requieren los valores de su servicio real proporcionados por el soporte de Sham Cash. Verifique la Base URL que guardó: la de prueba no es la real.

Lo que hace el usuario: en la tarjeta de pago presiona Open Sham Cash. En un teléfono se abre la aplicación Sham Cash (versión 2.2.5 o posterior), de lo contrario el sitio web de Sham Cash; el usuario verifica el monto y confirma con su código de confirmación de transferencia (configurado en su aplicación Sham Cash). En una computadora, la tarjeta también muestra un código QR para escanear con la cámara del teléfono. Cada enlace de pago es válido durante 10 minutos; la tarjeta se confirma automáticamente tan pronto como lo hace Sham Cash.

La propia aplicación de Sham Cash también puede procesar pagos por usted: asígnele un token que tenga únicamente el permiso de Payment apps (consulte la sección de REST API). Esta busca a un usuario por su nombre de usuario y registra el pago realizado.

Sham Cash sin claves de comercio (Non-official API)

¿No tienes servicio de comercio de Sham Cash? SAMM puede cobrar pagos de Sham Cash a través de shamcash-api.com, un servicio independiente (no es Sham Cash) que lee las transferencias que llegan a tu propia cuenta de Sham Cash. Solo puede leer: no puede enviar dinero.

  1. Crea una cuenta en shamcash-api.com y vincula tu cuenta de Sham Cash: en la app de Sham Cash abre Mi cuenta → Dispositivos vinculados y escanea su código QR. Inicia su suscripción y crea una clave API de solo lectura.
  2. En SAMM abre Finanzas → Pagos en línea → Sham Cash, pon Conexión en Non-official API (shamcash-api.com), pega la clave API, elige la moneda y pulsa Guardar. SAMM lee tu ID de cuenta y tu dirección de Sham Cash a partir de la clave. Luego Ejecutar prueba.

Lo que hace el usuario: la tarjeta de pago muestra tu dirección de Sham Cash (y su código QR), el importe y un código corto como SM-1234. El usuario envía el importe desde su app de Sham Cash y escribe el código en la nota de la transferencia. SAMM confirma el pago en un minuto. Una transferencia sin el código, por menos del importe o en otra moneda queda guardada para tu revisión en lugar de aplicarse.

Página de pago y renovación en línea

Settings → Billing → Pay page activa una página pública en /pay: el usuario ingresa su nombre de usuario, ve el monto adeudado y realiza el pago sin iniciar sesión. La misma Pay page está disponible en el portal de usuario para los usuarios que han iniciado sesión.

  • Renovar: los usuarios pueden renovar su plan en línea por periodos de 1 a 12, antes o después de que expire. El pago anticipado mantiene el tiempo restante; un usuario con el plan expirado vuelve a estar en línea tan pronto como se recibe el pago. Dos interruptores deciden dónde se ofrece: Renovar en la página de pago y Renovar en el portal de usuario (ambos activados por defecto).
  • Buscar usuarios sin su prefijo o sufijo: para nombres de usuario como 858000@inet, escribir 858000 (al menos 6 caracteres) encontrará la cuenta. Cuando más de una cuenta coincida, se le solicitará al usuario el nombre de usuario completo. Desactivado por defecto.
  • Elija qué muestra la página sobre la cuenta (nombre oculto, plan, fecha de vencimiento y más); por defecto solo se muestra el nombre oculto.

Lo que ve el suscriptor

  1. Inician sesión en el portal del cliente → Mis facturas.
  2. En una factura no pagada, haga clic en Pay (o "Pay · Stripe" / "Pay · Binance" si hay varias habilitadas).
  3. Tarjeta: se les lleva a la página segura de la pasarela. Criptomonedas: ven el monto exacto, su dirección con código QR y/o su Pay ID.
  4. Una vez pagada, la factura pasa a Paid, se registra en su contabilidad y, si estaban vencidos, se reconectan automáticamente — los suscriptores vencidos incluso reciben un botón de "Pay & reconnect" en la página de vencimiento.
Sus libros se mantienen exactos Cada pago en línea genera un asiento contable de partida doble equilibrado (Dr Cash / Cr Accounts Receivable) y registra el método (Stripe / Binance) en la factura, en el historial de pagos y en el PDF, para que siempre sepa cómo se recibió cada pago.

Operaciones diarias

Tickets de soporte

SAMM tiene un help desk integrado. Los suscriptores crean tickets desde el portal del cliente o el bot de Telegram, un administrador puede abrir uno en nombre de un suscriptor y su equipo los gestiona todos desde Users → Support Tickets.

La cola de tickets

La cola enumera cada ticket: número, cliente, asunto, prioridad, estado, las fechas de apertura y de última actualización, y el recuento de mensajes. Filtre la lista con:

  • Etiquetas de estado — una por estado de ticket, cada una con un recuento en tiempo real, para que la carga de trabajo sea visible de un vistazo.
  • Prioridad — Normal, Moderada o Crítica.
  • Activo / Retirado — un cliente puede retirar un ticket que ya no necesite; los tickets retirados aparecen atenuados y ocultos por defecto.
  • Buscar — por número de ticket, asunto o cliente.

El indicador de la barra lateral cuenta los tickets abiertos para que no se pase nada por alto.

Apertura de un ticket

Nuevo ticket permite que un administrador cree un ticket para un cliente seleccionado: elija el cliente y luego establezca un asunto, prioridad y descripción. Los suscriptores también pueden abrir sus propios tickets desde el portal del cliente o el bot de Telegram.

Gestión de un ticket

Abra un ticket para leer el hilo completo de la conversación. Desde allí puede:

  • Responder al cliente — un mensaje público que el suscriptor ve en su portal y a través del bot de Telegram.
  • Agregar una nota interna — un mensaje exclusivo para el personal, oculto para el cliente, para notas de traspaso entre los miembros de su equipo.
  • Cambie el estado y la prioridad del ticket.

Haga clic derecho en cualquier fila —o use su botón ⋮— para realizar las mismas acciones de estado, prioridad, respuesta y nota interna sin salir de la cola.

Operaciones diarias

Centro de notificaciones

SAMM mantiene a los suscriptores informados automáticamente — a través de email, Telegram, SMS y WhatsApp — y le permite difundir mensajes. El servicio samm-notification entrega todo a través de una cola con limitación de tasa. La página System → Notification Center tiene seis pestañas.

Descripción general

La pestaña de inicio — contadores en tiempo real (en cola, enviando, enviados hoy, fallidos, omitidos, excluidos), el estado de cada canal de entrega y un feed con las notificaciones más recientes.

Canales

Configure cómo salen los mensajes de SAMM. Email utiliza su propia cuenta de notificaciones, mantenida separada del SMTP de recuperación de contraseña en Settings. Telegram utiliza un token de bot, SMS se envía a través de una pasarela HTTP genérica o Twilio, y WhatsApp utiliza la API oficial Meta WhatsApp Cloud API (creada en Meta for Developers), con un puente opcional no oficial vinculado por QR bajo su propio riesgo — el puente se instala con un clic en un servidor con OS limpio y se incluye como un contenedor listo para ejecutar en Docker. Todos los secretos de los canales se almacenan cifrados con Fernet. Cada suscriptor, desde el portal del cliente, elige qué canales desea y puede darse de baja por completo.

Las pasarelas SMS también pueden enviar en modo de plantilla, para aquellos operadores que solo aceptan plantillas aprobadas: usted indica el nombre de la plantilla y SAMM envía los valores en el orden que la plantilla requiere. Elija el formato de número que solicita cada pasarela (internacional con + o 00, o nacional con o sin el 0 inicial). Pegue un enlace de pasarela válido de su proveedor y SAMM completará los campos, el modo de plantilla y el formato de número automáticamente.

Mensajes

Las plantillas de mensajes, un conjunto por evento. Edite la redacción de cualquier notificación —recordatorios de renovación, recibos y demás— para que cada mensaje se envíe con su propio tono y lenguaje.

Reglas & Temporizadores

Esta pestaña controla cuándo y cómo se activan las notificaciones automáticas. Para cada evento, usted puede controlar:

  • Si la regla está activada.
  • Ignorar exclusión — cuando está activado, el mensaje llega a todos los suscriptores aunque hayan optado por no recibirlo. Resérvelo para mensajes transaccionales importantes.
  • Plazos — por ejemplo, cuántos días antes del vencimiento se envía un recordatorio de renovación.
  • Limitación de entrega & throttling — el worker vacía la cola en un lote por tick; el tamaño del lote y el intervalo del tick regulan la velocidad de salida de los mensajes, evitando que un envío masivo sature su servidor de correo.

Los eventos que SAMM puede emitir por sí mismo incluyen el recordatorio de renovación (antes de que expire una suscripción), el aviso de expiración (cuando esta caduca), la advertencia de cuota (cuando el límite de datos se está agotando), el recibo de pago (cuando se registra un pago) y plan renovado.

Broadcast

Envíe un mensaje puntual —una ventana de mantenimiento, un cambio de precio— a un conjunto seleccionado de suscriptores. La difusión fluye a través de la misma cola limitada que las notificaciones automáticas.

Bandeja de salida

Cada mensaje que SAMM ha puesto en cola o enviado, con su estado de entrega individual, para que pueda confirmar que una notificación llegó al suscriptor o ver por qué no fue así.

Sistema

VPN: WireGuard, L2TP/IPsec, SSTP

SAMM ejecuta su propio servidor VPN en el host de SAMM para que los routers en cualquier lugar —detrás de NAT, en una línea móvil, en otra ciudad— se conecten a SAMM para RADIUS y gestión. Todo se encuentra en System → VPN; no se requiere shell. Las nuevas instalaciones incluyen los tres listos, cada uno desactivado hasta que usted lo active.

TipoUtilícelo para
WireGuardRouters RouterOS 7, teléfonos y portátiles. Lo más rápido y sencillo.
L2TP/IPsecRouters con RouterOS 6 y 7, y dispositivos que no tienen WireGuard.
SSTPDos o más routers que acceden a Internet a través de la misma dirección pública, en RouterOS 6 o 7.

Pestaña Server

  1. Para WireGuard, haga clic en Generate Keys para crear el par de claves del servidor.
  2. Verifique el puerto de escucha, la dirección del túnel del servidor y el rango de direcciones del cliente, o mantenga los valores predeterminados.
  3. Encienda el servidor. Una ventana emergente confirmará cada cambio.

Si el host de SAMM tiene una dirección privada y su dirección pública está redirigida hacia él, SAMM encuentra la dirección pública (o usted la escribe una vez en la página de la VPN) y se la proporciona a cada cliente y router.

Agregar un router en un solo pegar

Haga clic en Add Client y asígnele un nombre. Para un MikroTik, copie el install link de una sola línea y péguelo en la terminal del router: esto configura el túnel, el inicio de sesión SAMM propio del router, su configuración RADIUS y la página de usuarios expirados en un solo paso. Elija cómo SAMM añade el router:

  • NAS gestionado — el router autentica a sus usuarios a través de SAMM y SAMM lo gestiona.
  • Solo monitoreo — para puntos de acceso y otros dispositivos que desee supervisar (estado, mapa, la página Wireless) sin que los usuarios inicien sesión a través de ellos.

Un router añadido por el personal de una sucursal pertenece a dicha sucursal. También se pueden añadir clientes WireGuard mediante un archivo de configuración o un código QR para la aplicación móvil. Los clientes pueden renombrarse, desactivarse o eliminarse; su color indica si están conectados, inactivos o si nunca se han visto.

La regeneración de claves es destructiva Regenerate Keys cambia el par de claves del servidor WireGuard. Todos los clientes ya configurados dejarán de conectarse hasta que reciban la nueva configuración. El panel le pedirá que escriba una palabra para confirmar.

Redes & routers

RouterOS 6 y 7

SAMM gestiona routers con RouterOS 6 y RouterOS 7 simultáneamente. Usted no tiene que hacer nada diferente: SAMM lee la versión de cada router y envía los comandos que dicha versión entiende.

Todo funciona en ambos: el asistente de configuración, Auto-Complete, la entrega de configuración, las acciones del gestor, Websites & Apps, QoS, NTP, la página de usuarios expirados y los enlaces de WireGuard (RouterOS 7), L2TP/IPsec y SSTP. En RouterOS 6, las listas de Websites & Apps se crean a partir de los nombres de dominio del catálogo, ya que la versión 6 no dispone de listas de direcciones DNS.

Routers antiguos sin WireGuard RouterOS 6 no dispone de WireGuard. Conecte esos routers a través de L2TP/IPsec o SSTP.

Redes & routers

Entrega de configuración

Cada cambio que SAMM envía a sus routers — RADIUS, la página de expiración, el asistente, el filtro DNS, Websites & Apps, QoS, Auto Security, DNS, NTP y el control parental — es una entrega que puede seguir en Devices → Config delivery.

  • Una barra de progreso y el resultado para cada router, con el motivo exacto en caso de que un router rechace un cambio.
  • Un router que esté fuera de línea recibe el cambio tan pronto como se reconecte; los cambios fallidos se reintentan automáticamente y Retry se ejecuta con un solo clic.
  • Cada cambio se verifica en el router después de aplicarlo, y RADIUS y QoS nunca quedan vacíos mientras se realiza el cambio.

Redes & routers

Acciones del gestor en varios routers

En Devices → Manager, marque los routers y abra Actions para ejecutar una tarea en todos ellos: enviar Websites & Apps, enviar la configuración de RADIUS, configurar la página de usuarios expirados, Router Security, realizar copia de seguridad y exportar, actualizar RouterOS, ejecutar un script o reiniciar.

Cada diálogo comienza con los ajustes más completos encontrados entre los routers seleccionados. Las tareas se ejecutan en segundo plano: puede salir de la página y una ventana emergente le avisará cuando cada router termine o el motivo del fallo. Las acciones riesgosas le pedirán escribir una palabra para confirmar. El Gestor también muestra la sucursal de cada router.

Redes & routers

Acelerador de velocidad dinámico

Mientras el Internet de un router no se utilice, otorgue a sus usuarios más velocidad gratis —y recupérela en el momento en que la línea se sature. Actívelo en Tools → Speed Boost → Dynamic (desactivado por defecto) y seleccione los planes que puede potenciar.

  • Todos los usuarios conectados a ese router obtienen el mismo múltiplo de su velocidad de descarga, hasta 3 veces por defecto.
  • El booster aprende las horas de mayor y menor actividad de cada router (3 días por defecto, los días más recientes tienen más peso), planifica cada 15 minutos, analiza la hora siguiente y aumenta el boost paso a paso.
  • Un guardián verifica cada minuto y finaliza un boost tan pronto como el tráfico regresa. Los routers que están ocupados la mayoría de los días nunca reciben un boost.
  • Los usuarios ven una insignia de Boosted en su portal; la lista de usuarios tiene una columna y un filtro de Boosted.

Operaciones diarias

Activaciones & Registro de datos

Activaciones

Overview → Activations muestra qué planes se han activado más esta semana, mes, año o entre dos fechas, en comparación con el periodo anterior: renovaciones, nuevos usuarios y cambios de plan. Las listas By plan y By user disponen de búsqueda, filtros, ordenación y exportación a Excel o CSV.

Registro de datos

Overview → Data Log busca en el Data Log de todos los usuarios a la vez: encuentre quién accedió a una dirección o rango, un puerto, un protocolo o una aplicación, en cualquier periodo. Agrupe los resultados, guarde vistas y exporte a CSV o XLSX. El tiempo que se conserve el historial depende de su elección; configúrelo en el History cleaner.

Aceptar registro

El Accept Log muestra desde qué router provino cada intento de inicio de sesión, con opciones de búsqueda, agrupación, ordenación y exportación por router.

Sistema

Branding: su logotipo, nombre y color

Personalice SAMM con la imagen de su empresa. Todo se encuentra en System → Settings → ISP.

Su logo

  1. Presione el mosaico del logotipo o Subir logotipo y elija una imagen PNG, JPEG, WebP o GIF (de hasta 5 MB).
  2. Arrastre la imagen para colocarla y use el deslizador para hacer zoom. El fondo transparente permanecerá transparente.
  3. Presione Use logo: se guarda inmediatamente como un cuadrado de 400×400 px. Remove lo elimina.

El logo se utiliza en facturas, recibos, tarjetas de hotspot impresas, la página de expiración y las páginas de inicio de sesión que muestran sus routers.

Personalización de marca en los paneles

Active Use my brand on the panels y configure el nombre, el color y una línea de pie de página (por ejemplo, su número de soporte), luego pulse Guardar en la pestaña ISP. Su marca reemplazará entonces a la de SAMM en el panel de administrador, el portal de usuario y ambas páginas de inicio de sesión. Desactívelo y todo volverá a verse como siempre.

Sistema

Cloudflare Tunnel

Un túnel de Cloudflare Zero Trust publica SAMM en la internet pública sin abrir ningún puerto del cortafuegos — útil cuando el host de SAMM se encuentra detrás de NAT. Se gestiona desde System → Cloudflare Tunnel.

Estado del servicio

La página se abre en una tarjeta de estado que muestra el estado del conector:

EstadoSignificado
En ejecuciónEl túnel está activo y reenviando tráfico
DetenidoConfigurado pero no se está ejecutando actualmente
No configuradoEl binario está presente — pegue un token para configurarlo
No instaladoEjecute install.sh nuevamente para instalar el binario cloudflared

También muestra la versión de cloudflared y si el conector está configurado para iniciarse automáticamente al arrancar.

Configure el túnel

  1. En el panel de Cloudflare Zero Trust (one.dash.cloudflare.com), abra Networks → Tunnels y seleccione Create a tunnel.
  2. Elija el conector Cloudflared, asigne un nombre al túnel y guarde. En el paso de instalación, copie solo el token: la cadena larga después de --token.
  3. Pegue el token en SAMM y haga clic en Configure Tunnel. SAMM entrega el token a cloudflared e inicia el conector.
  4. De vuelta en Cloudflare, añada un Public hostname: la dirección elegida, tipo HTTP, URL localhost:80 (a través de proxy de nginx — recomendado) o localhost:8000 (directo a la API).

En unos pocos segundos, la insignia de estado se vuelve verde y SAMM es accesible a través del nombre de host público. Una vez configurado, las acciones de un solo clic le permiten Iniciar, Detener o Reiniciar el conector, Reemplazar token para rotarlo, o Eliminar túnel (una acción de tipo REMOVE para confirmar).

Sin puertos abiertos, el token nunca estuvo en la base de datos El túnel realiza una conexión saliente hacia el edge de Cloudflare; nunca se abre ningún puerto del cortafuegos en el servidor. El token se reenvía a cloudflared y se almacena en /etc/cloudflared/; SAMM nunca lo guarda en la base de datos. TLS termina en el edge de Cloudflare, por lo que SAMM se ejecuta mediante HTTP simple en el loopback.

Sistema

Ajustes

System → Settings contiene los ajustes activos y recargables en caliente. Los daemons los vuelven a leer en su siguiente ciclo — no es necesario reiniciar el servicio. Los ajustes están organizados en pestañas.

Parámetros generales

AjustePredeterminadoControles
samm-radius interval30 sCon qué frecuencia se evalúan los eventos temporizados y se envían los CoA
samm-worker interval5 sCadencia de ping del router + sincronización de la API de MikroTik
Intervalo provisional de cuenta60 sEl intervalo de contabilización enviado a los routers
Hora de reinicio diario00:00Cuando los contadores de uso diario se reinician
Zona horaria del servidorUTCZona horaria para las ventanas de velocidad y el reinicio diario
Puerto predeterminado de CoA3799Puerto UDP predeterminado para paquetes CoA
Máximo de reintentos de CoA3Reintentos antes del respaldo Disconnect-Request

Reduzca el intervalo de samm-radius para una aplicación más estricta; auméntelo para reducir la carga.

Identidad del ISP, logotipo, facturación en moneda & (la pestaña ISP)

Todo lo que la mayoría de los operadores preguntan "¿dónde cambio esto?" se encuentra en System → Settings → ISP. Edite un campo y haga clic en Guardar — el cambio se aplica inmediatamente (sin reiniciar) y se refleja en las facturas, recibos, PDFs y el portal del cliente.

Cambios realizadosDonde se muestra
Nombre del ISPFacturas, recibos, tarjetas de hotspot, encabezado del portal
Teléfono de soporte & emailFacturas y tarjetas de hotspot impresas
Número de identificación fiscal / de registroImpreso en las facturas
Logo del ISP (subida PNG/JPEG/WebP/GIF)Subir, luego arrastrar y hacer zoom para recortar en el navegador; aparece en los PDF de facturas/recibos, tarjetas de hotspot impresas y páginas de inicio de sesión del router. Ver Branding.
Código de moneda (e.g. USD)La moneda ISO en las facturas y el libro mayor
Símbolo de moneda (e.g. $)Cada importe mostrado en la UI del administrador, el portal del cliente y los PDF
Impuesto activado/desactivado, etiqueta & tasaAñade una línea de VAT/GST a las facturas (p. ej. etiqueta VAT, tasa 11 = 11%)
Cambiar el símbolo de moneda Para cambiar la moneda mostrada en todo el sistema (p. ej. de $ a £ o un símbolo local), configure Currency symbol en la pestaña ISP y haga clic en Guardar; esto actualizará el panel del administrador, el portal del cliente y todos los PDF a la vez. Configure el Currency code (USD, EUR, …) junto a este para definir el código ISO que se imprimirá en las facturas.

Privacidad — estadísticas de instalación anónimas

Cuando SAMM busca actualizaciones, puede enviar a SecuryTik un ID de instalación aleatorio, la versión de SAMM, su nivel de plan y un país aproximado (basado en su IP, a través de Cloudflare) — sin datos del suscriptor o cliente. Esto solo nos ayuda a contabilizar las instalaciones activas y a priorizar el soporte y los idiomas. Desactívelo en cualquier momento en System → Settings → Privacy; consulte la política de privacidad.

Pestaña Email

Configure el servidor SMTP utilizado para los códigos de recuperación de contraseña enviados a los administradores y clientes (host, puerto, SSL/STARTTLS, nombre de usuario, dirección de remitente, contraseña). Haga clic en Test connection para verificar las credenciales sin enviar correos.

Dos cuentas de correo electrónico La pestaña Email aquí es solo para la recuperación de OTP / contraseña. La cuenta utilizada para las notificaciones del cliente se configura por separado en el Centro de Notificaciones.

Sistema

Administradores, sucursales & roles

System → Admins es donde usted decide quién puede iniciar sesión en el portal del administrador, qué puede hacer cada persona y a qué usuarios pueden ver. Desde la versión 5.1.0, los administradores forman un árbol de sucursales y personal. La página tiene dos pestañas: Admins y Roles.

Sucursales y personal

NodoQué es
SucursalUn lugar — una oficina, una ciudad. Posee los usuarios creados en él. Nadie inicia sesión como sucursal: no tiene contraseña ni rol.
Administrador (personal)Una persona que inicia sesión. Al situarse bajo una sucursal, se considera parte de su personal: cada usuario y tarjeta que cree pertenecerá a esa sucursal.
SuperadministradorSiempre en la parte superior del árbol, nunca bajo una sucursal. Ve y puede hacer todo.

Use + Branch y + Admin para construir el árbol, y arrastre un nodo sobre otro para moverlo. Solo una sucursal puede tener administradores debajo. Un agente es un administrador que vende y es dueño de lo que vende; el personal ubicado bajo un agente utiliza la wallet y las reglas de aprobación del agente.

Quién ve qué

La visibilidad sigue la estructura del árbol. Una sucursal —y todo el personal que trabaje en ella— ve a sus propios usuarios y a los usuarios de las sucursales inferiores. Nunca ve una sucursal hermana ni la sucursal superior. HQ lo ve todo. Los permisos de un administrador nunca superan lo que permiten los administradores superiores, y un administrador solo puede otorgar los permisos que él mismo posee.

Límites por sucursal

LímiteQué contabiliza
Máximo de usuariosCuántos usuarios puede albergar la sucursal y las sucursales dependientes. Eliminar un usuario libera un espacio.
Máximo de tarjetasCuántas tarjetas de hotspot se pueden imprimir en la sucursal.

Se rechaza un nuevo usuario o tarjeta cuando se alcanza cualquier límite del administrador que lo crea o de un nivel superior, y el mensaje indica qué límite se ha alcanzado y cuánto queda disponible. Deje el campo de límite vacío para que no haya restricción. Ambos pueden cambiarse posteriormente desde el diálogo Editar.

Dispositivos de una sucursal

Cada router, incluidos los puntos de acceso, pertenece a una sucursal o a Headquarters. Abra el menú de una sucursal y elija Assigned devices para marcar los dispositivos que le pertenecen; un dispositivo que desmarque volverá a Headquarters, que es compartido por todas las sucursales. Un dispositivo añadido por el personal de la sucursal (desde el gestor, el formulario de monitor o un enlace de instalación de VPN) se ubicará en su sucursal; uno añadido por Headquarters comenzará en Headquarters.

QuiénUn dispositivo de la sucursal
Personal de esa sucursal, de las sucursales superiores y de la oficina centralGestionar
Personal de sus sucursales subordinadasVer, solo lectura
Otras sucursalesNo se visualiza
Usuarios de esa sucursal y de sus sucursales hijasPermitir el inicio de sesión a través de este

El mapa, la página Wireless, el estado de salud y las listas de routers siguen la misma regla. La parte del inicio de sesión es el ajuste Users log in only through their branch's routers en Settings → Authentication: activado para instalaciones nuevas; una instalación actualizada cuyos dispositivos hayan sido asignados a sucursales comienza con este ajuste desactivado para que nadie quede desconectado — actívelo cuando sus dispositivos estén asignados. Los usuarios de la empresa General pueden usar cualquier router.

Destinatarios de alertas por sucursal

El menú de una sucursal también tiene Alert recipients: direcciones de e-mail, números de WhatsApp y SMS y chats de Telegram, uno por línea. Cuando un dispositivo de esa sucursal (o de una sucursal inferior) se cae, presenta un fallo, bloquea un ataque o pierde su configuración, se les notifica. La sede central sigue recibiendo todas las alertas.

Listas de precios

Financial → Price Lists (solo superadmin) establece un precio para cada plan y complemento por sucursal. Una subsucursal hereda los precios de su sucursal matriz a menos que se le asignen los propios, y una sucursal nueva comienza con el precio de tarifa del plan. Cambie múltiples precios a la vez mediante un porcentaje o un monto fijo, con redondeo; Reset All restablece una sucursal a los valores de su matriz, y la lista se puede exportar para su revisión.

Roles y permisos &

Un rol otorga acceso por área. SAMM incluye cuatro roles predefinidos que puede editar o eliminar — Gestor (operaciones diarias), Reseller, Accountant (finanzas) y Monitor (solo lectura) — y dos roles integrados bloqueados: superadmin (acceso total) y Agent, que convierte al administrador en un reseller mayorista con un saldo prepago y un reparto de comisiones (consulte Accounting & billing → Agents).

Para cada área de SAMM (usuarios, planes, routers, contabilidad, ajustes, etcétera), se asigna un rol en uno de tres niveles:

NivelSignificado
No permitidoEl área está completamente oculta en la barra lateral
VerAcceso de solo lectura
EditarAcceso total — crear, modificar, eliminar

Administradores & roles, Herramientas, API y Pagos permanecen en HQ independientemente de lo que indique el rol.

Dos indicadores se encuentran junto a los niveles de área, ya que cada uno representa una decisión financiera en lugar de una pantalla:

DerechaFuncionalidades
Permitir "No Invoice" Cambie el servicio de un usuario —renovar, cambiar plan, extender— sin realizar ningún cobro. Desactivado por defecto en cada rol nuevo.
Permitir aprobación de agentes Revise y decida sobre las solicitudes de los agentes para revertir un cargo. La creación y gestión de agentes sigue siendo exclusiva del superadmin. Consulte Undo & approvals.

Permisos detallados

En Edit, Users, Cards, Financial y Routers se despliegan en permisos individuales; por ejemplo: eliminar usuarios, renovar, cambiar plan, pagar facturas, otorgar descuentos o ejecutar scripts del router. Desactive cualquiera de ellos para un rol; los botones de los permisos que el rol no posea se ocultarán.

Tiempo que un rol puede otorgar

Evite que el personal asigne meses de servicio. En cada rol:

AjusteEfecto
Máx. periodos por adelantadoEl vencimiento puede ser como máximo este número de periodos del plan a partir de ahora — al crear, renovar, añadir días, editar y realizar cambios masivos.
Máx. días por adelantadoLo mismo, expresado en días.
Los nuevos usuarios comienzan con (horas)Un usuario creado con este rol obtiene exactamente este tiempo (por ejemplo 2 horas) y ninguna factura; alguien con permisos para otorgar más tiempo lo extenderá posteriormente.

Añadir días y Escribir una fecha de expiración son permisos independientes en Usuarios, por lo que un rol puede renovar sin poder escribir cualquier fecha que desee. Deje un campo vacío para que no haya límite; el superadmin nunca tiene límites. Un cambio masivo omite a los usuarios que superarían el límite e indica el motivo.

También se puede permitir que un rol vea cada usuario & tarjeta de la instalación, independientemente del árbol. Con esta opción desactivada, el rol ve su propia sucursal y las sucursales inferiores.

El panel nunca se quita Independientemente de los permisos que se le denieguen a un rol, cada administrador conserva su propio panel y perfil; un inicio de sesión que termina en un error de permisos es un inicio de sesión fallido, no uno seguro.
La licencia siempre está disponible La página System → License es un bloque de permisos normal; sin embargo, siempre que el dispositivo esté en un estado de bloqueo (grace, soft o hard), SAMM lo hace accesible para todo administrador conectado independientemente de su rol, de modo que la ruta de recuperación nunca quede bloqueada.

Sistema

Herramientas

La sección Tools agrupa utilidades de mantenimiento y procesamiento masivo. Actúa sobre todo el conjunto de datos, por lo que solo está disponible para los superadmins.

Copia de seguridad & Restauración

Cree una instantánea completa de la base de datos antes de realizar cualquier cambio importante. Un respaldo es un archivo pg_dump comprimido con gzip almacenado en el servidor, cada uno con un encabezado SAMM.

  • Crear copia de seguridad — opcionalmente añada una nota; marque Skip usage & history para obtener un volcado más pequeño y rápido que omita las tablas de registros voluminosas.
  • Descargue un respaldo en su PC, o suba un respaldo previo de SAMM al servidor.
  • Restore sobrescribe la base de datos actual; requiere un cuadro de diálogo de confirmación de tipo RESTORE.

Alta disponibilidad

Para un despliegue sin un único punto de falla, ejecute SAMM en dos nodos: replicación por streaming de PostgreSQL (un primario con un nodo en espera caliente con retraso de segundos) más un nodo AAA en espera, y promueva + redirija en caso de falla. El manual de operador completo —configuración de replicación, conmutación por error planificada y no planificada, failback, un modo opcional de replicación síncrona y una lista de verificación posterior a la conmutación por error— se incluye como docs/HA.md con el código fuente. Tenga en cuenta que la replicación no es un respaldo (un borrado erróneo se replica instantáneamente), por lo que mantenga también activos los respaldos programados mencionados anteriormente.

Limpiador de historial

Elimine permanentemente las filas antiguas de los registros y del historial para recuperar espacio en la base de datos. Seleccione un ajuste preestablecido de retención y confirme. El limpiador elimina las sesiones RADIUS cerradas, los registros post-auth, los resúmenes de uso diario, el historial de router/interfaz, los registros de limitación, las entradas de auditoría aplicadas y las filas de CoA finalizadas. Nunca afecta a las sesiones activas, los comandos en cola, los CoA pendientes o los totales de uso vitalicios no restablecibles.

Realice primero una copia de seguridad History Cleaner elimina los datos de forma permanente. Realice una copia de seguridad antes de la limpieza si es posible que necesite los datos más adelante.

Exportar / Importar

Exportación e importación masiva de usuarios, planes y NAS en formato .csv o .xlsx. Descargue una plantilla (con las columnas correctas y una fila de ejemplo) o una instantánea de los datos actuales, complétela y cárguela de nuevo. Cada fila se valida y se muestra en una pantalla de vista previa — donde se señalan los duplicados y las filas no válidas, y usted elige si omitir los duplicados o actualizarlos — antes de que se escriba cualquier dato.

Cambios masivos

Aplique un cambio —propietario, fecha de vencimiento, estado, renovación automática o periodos de todo el plan— a todos los suscriptores que coincidan con un filtro, en una sola ejecución. Elija el cambio, cree el filtro (estado / plan / propietario / búsqueda), revise la lista de coincidencias y confirme.

Agregar periodos completos del plan es la opción de renovación masiva: cada suscriptor obtiene esa cantidad de periodos de su propio plan; por ejemplo, un plan de 7 días suma 7 días por periodo y un plan mensual suma un mes calendario, todo en la misma ejecución y sin necesidad de dividir la lista por plan previamente. Los suscriptores cuyo plan no tiene un periodo de expiración son omitidos en lugar de intentar estimarlo. Agregar días sigue estando disponible para cuando desee un número fijo de días sin reiniciar el contador.

Speed Boost

Aumente o disminuya la velocidad de planes completos a la vez mediante un porcentaje: un fin de semana festivo a doble velocidad, o una limitación de emergencia mientras un backhaul esté degradado. Se aplica inmediatamente, tanto para nuevos inicios de sesión como para sesiones ya activas.

ControlFuncionamiento
PorcentajeLos valores positivos multiplican y los negativos dividen: +100% → el doble de velocidad, −100% → la mitad de velocidad, −500% → una sexta parte. La velocidad nunca llega a cero.
Planes para potenciarSeleccione cualquier número de planes; cada fila muestra la tarifa del plan, el boost activo y la velocidad efectiva actual.
Revertir automáticamente después deHoras hasta que el boost expire automáticamente. 0 lo mantiene hasta que lo restablezca manualmente.
Un boost tiene prioridad sobre una ventana de velocidad El incremento se mide a partir de la tasa del plan plan y sustituye cualquier ventana de velocidad mientras esté activo — un plan con una ventana nocturna de 20M no pasa a ser de 40M, sino que pasa a ser lo que el incremento determine sobre la tasa de su plan. Windows se reanuda en el momento en que el incremento expira.

Un suscriptor que ha agotado un límite nunca recupera la velocidad máxima mediante un boost. Por la misma razón, un plan utilizado como objetivo de limitación es omitido por Seleccionar todo y etiquetado como tal; aplicarle un boost aceleraría precisamente a las personas que usted está limitando. Aún puede marcarlo manualmente si eso es lo que desea. Restablecer todo a la normalidad elimina todos los boosts y devuelve las sesiones activas a la velocidad de su plan.

Eliminar en lote

Elimine permanentemente múltiples suscriptores o tarjetas de hotspot a la vez, seleccionados mediante un filtro. Eliminar un suscriptor también borra su historial de uso, sesiones, contabilidad RADIUS y facturas, y desconecta cualquier sesión activa. Protegido por un cuadro de diálogo de confirmación de tipo DELETE.

Sistema

Idiomas & temas

Idiomas

Los portales del administrador y del cliente son totalmente traducibles. Incluyen ocho idiomas integrados: English, Arabic (de derecha a izquierda), Russian, Persian (de derecha a izquierda), Turkish, French, Spanish y German. Cada usuario elige su idioma desde la barra superior o su perfil; la elección se guarda por cuenta.

Desactivar un idioma

En System → Translations cada idioma tiene un interruptor de activación/desactivación (solo superadmin). Un idioma desactivado no puede ser seleccionado por nadie: los selectores dejan de ofrecerlo, los usuarios que lo habían seleccionado verán el contenido en English y los mensajes enviados a ellos se escribirán en English. English siempre permanece activado. Una instalación nueva comienza con todos los idiomas activados.

El editor de traducciones

Un superadmin puede editar las traducciones en tiempo real desde System → Translations — sin reiniciar el sistema ni editar archivos. El editor también permite crear idiomas completamente nuevos e importar/exportar libros de trabajo de traducción como .xlsx, para que pueda localizar SAMM en cualquier idioma que utilice.

Temas

SAMM incluye 16 temas visuales, claros y oscuros. Cada usuario elige un tema desde la barra superior; la vista previa se actualiza al instante y se guarda por cuenta. La terminología de IT nunca se traduce, por lo que las pantallas técnicas se mantienen precisas en todos los idiomas.

Sistema

Registro de auditoría & actividad

System → Audit Log responde a una sola pregunta: qué sucedió y quién lo hizo. Una lista contiene cada cambio realizado por un administrador, las acciones automáticas del sistema (como los vencimientos) y los cambios que los usuarios realizaron en su propia cuenta a través del portal o de Telegram: cambios de plan, renovaciones, pagos y ediciones de perfil y contraseña.

ColumnaLo que muestra
CuandoLa hora, en su zona horaria
QuiénEl administrador, "ali, en el portal", "ali, en Telegram", un token de API o System
Qué sucedióUna sola frase, solo con los campos que cambiaron, antiguo → nuevo — por ejemplo "Se editó el usuario: Expiry: 01 Oct → 15 Oct"
DestinoAcciones realizadas sobre — Usuario · ali, Plan · Gold 20M, Router · Hamra, Administrador · rami

Filtre por Who y Period, o escriba un nombre en el cuadro de búsqueda. Los inicios de sesión y las exportaciones están ocultos a menos que marque Show logins & exports. Via, Action, Category, Severity e ID se encuentran en el selector de columnas. Seleccione filas para Export o Print — el archivo contiene las mismas columnas que la pantalla. El botón ⓘ de una fila muestra la tabla completa de cambios (antes y después).

Línea de tiempo del usuario

Abra un usuario y elija Timeline para ver todo lo que ha sucedido en esa cuenta — creación, renovación, cambio de plan, suspensión, límites alcanzados — con facturas, pagos, cargos de billetera y de agente en una columna de importe. Filtre por tipo o periodo, o solo por dinero, y exporte a CSV o Excel. Las filas de Timeline nunca se eliminan y permanecen aunque el usuario sea borrado.

Log de Aceptación y Log de Acceso

Overview → Accept Log enumera cada intento de inicio de sesión enviado por los routers y la respuesta de RADIUS, los más recientes primero, con el motivo de cada rechazo. Es la página que debe abrir cuando un usuario no puede conectarse. Un rechazo que se repite se muestra en una sola línea con un contador. Overview → Access Log enumera las sesiones que se iniciaron, basándose en el accounting de RADIUS.

También una cola de comandos Los restablecimientos, cambios de plan y renovaciones en cola desde la CLI o la API se escriben en la misma tabla y son aplicados por el servicio samm-radius en su siguiente ciclo, el cual actualiza la sesión activa mediante un CoA. La insignia de la barra lateral indica la cantidad de elementos que aún están pendientes.

Licenciamiento

Licencias & niveles

Cada instalación de SAMM tiene una licencia por dispositivo — el plan reside en esa instalación, por lo que puede ejecutar varios servidores SAMM, cada uno en su propio nivel. El nivel establece cuatro límites numéricos.

NivelUsuarios AAATarjetas de HotspotNAS / enrutadoresMonitoreo
No registrado252513
Gratis1005026
Lite5001,500412
Plus1,0003,000618
Pro2,0006,0001236
Mega5,00015,0002472
Max10,00030,000ilimitadoilimitado
Unlimitedilimitadoilimitadoilimitadoilimitado

Una instalación nueva se ejecuta como unregistered en el nivel mínimo. Todas las funciones están disponibles en todos los niveles; el nivel solo establece los límites. La creación de un suscriptor, tarjeta o NAS que supere el límite está bloqueada hasta que realice una actualización; nunca se pierden datos.

Monitors son los puntos de acceso y enlaces que SAMM solo supervisa. Tienen su propio límite, tres por NAS, por lo que la supervisión de un punto de acceso nunca consume una ranura de router.

Activar actualización &

  1. Abra System → License.
  2. Active iniciando sesión con su cuenta de SecuryTik — o use Vincular este dispositivo, que muestra un código que usted aprueba en samm.securytik.com sin escribir su contraseña en el servidor. El dispositivo se activa en Free.
  3. Para subir de nivel, elija un plan en la misma página o suscríbase desde su panel. Las solicitudes realizadas desde la página son revisadas y aprobadas por un administrador de SecuryTik.

La página de licencia también vuelve a verificar la licencia bajo demanda y muestra su uso actual frente a cada límite. Desvincular dispositivo devuelve la instalación al nivel no registrado sin eliminar ningún dato.

Si caduca una licencia de pago

SAMM nunca elimina datos. Una licencia caducada se desactiva progresivamente:

EtapaQué sucede
AdvertenciaUn banner de recordatorio; todo sigue funcionando
Periodo de graciaUn intervalo corto para reactivar; los suscriptores permanecen conectados
Bloqueo parcialLos servicios en segundo plano se detienen; RADIUS continúa autenticando durante aproximadamente 7 días
Bloqueo totalLos servicios se detienen, excepto la página de reactivación

La reactivación en cualquier etapa reinicia cada servicio automáticamente; todos los datos y el historial del suscriptor permanecen intactos.

Actualizaciones automáticas

La actualización automática es independiente de la licencia: todos los niveles se actualizan y una licencia caducada nunca la bloquea. SAMM busca diariamente una nueva versión firmada. Desde System → License puede cambiar entre notify (la opción predeterminada: un banner con un botón de Aplicar ahora) y auto (aplicar sin supervisión). Cada actualización se verifica, se respalda y se aplica en el sitio. También puede volver a ejecutar el instalador en cualquier momento; la actualización es idempotente.

Para sus suscriptores

Portal del cliente & bot

SAMM ofrece a cada suscriptor dos interfaces de autoservicio —un portal web y un bot de Telegram— para que puedan consultar el consumo y pagar sin contactar con usted.

El portal del cliente

Los suscriptores inician sesión en la raíz de la sede SAMM (/) con su nombre de usuario y contraseña de SAMM. El portal tiene:

PáginaLo que ve el suscriptor
Descripción generalEstado de la cuenta, plan, vencimiento, consumo de hoy y del mes, cualquier factura pendiente
Uso & sesionesTotal descargado/subido, presupuesto de tiempo de actividad e historial completo de sesiones
Mis planesEl plan actual más el catálogo de planes disponibles
Mis facturasHistorial de facturación con descarga de PDF en un solo clic
Tickets de soporteAbrir y hacer seguimiento de los tickets de soporte
PerfilEditar datos de contacto, cambiar contraseña, configurar idioma & tema, gestionar notificaciones

Desde Profile, un suscriptor conecta su cuenta de Telegram, elige sus canales de notificación preferidos o desactiva las notificaciones por completo. Si olvida su contraseña, se le envía un código OTP por correo electrónico (esto requiere que la pestaña Email esté configurada).

El bot de Telegram

El servicio samm-telegram ejecuta un bot interactivo de autoservicio. Un suscriptor envía /start, se verifica una vez con su nombre de usuario y contraseña de SAMM (el bot elimina el mensaje de la contraseña inmediatamente) y luego puede, totalmente desde el chat:

  • Verifique su plan, cuota, uso y fecha de vencimiento
  • Ver y descargar facturas en PDF
  • Actualizar su perfil y cambiar su contraseña
  • Abrir y hacer seguimiento de los tickets de soporte

El bot también envía notificaciones automáticas —recordatorios de renovación, avisos de vencimiento, advertencias de cuota y recibos— a los suscriptores que conectaron Telegram.

La página de destino para suscriptores vencidos

Cuando una suscripción expira, el router (configurado mediante el "Expired pool & internet block" del asistente) redirige el navegador del usuario a una página amigable de "subscription expired" servida por SAMM en el puerto 81 —con el logotipo de su ISP y un botón para iniciar sesión en el portal— en lugar de una conexión caída sin aviso.

Sistema

REST API

System → API gestiona la interfaz pública /api/v1. La API permanece inactiva hasta que cree el primer token, por lo que una instalación que nunca la utilice no expone nada. Todo lo siguiente también está disponible como documentación interactiva de OpenAPI — con una consola de prueba y esquemas completos de solicitud/respuesta — en su propia instalación en /api/v1/docs.

Documentación interactiva (Swagger UI)

Cada instalación ofrece una consola de API en vivo en /api/v1/docs — accesible directamente desde el panel API en el portal del administrador. Haga clic en Authorize, pegue un token y podrá ejecutar cualquier punto de conexión con sus propios datos mediante Try it out; cada llamada muestra la respuesta real además de un comando curl listo para copiar.

Cada punto de conexión declara un esquema tipado completo —tanto para los cuerpos de las solicitudes como para las respuestas— de modo que los nombres de los campos, los tipos y los ejemplos son visibles sin necesidad de realizar ninguna llamada. El mismo esquema se proporciona como OpenAPI legible por máquina en /api/v1/openapi.json, lo que genera un cliente totalmente tipado en el lenguaje de su elección:

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

samm-openapi.json · SAMM 6.0.0 · 187 puntos de conexión

Guía de inicio rápido

  1. Abra System → API (solo superadmin), pulse New token, asígnele un nombre, una fecha de expiración y active solo los permisos que la integración necesite (Read o Write, una línea por área).
  2. Copie el secreto inmediatamente; se muestra una sola vez y solo su hash se almacena en el servidor.
  3. Verifique que funcione y vea qué puede hacer el token:
curl -H "Authorization: Bearer samm_YOUR_TOKEN" https://YOUR-SAMM/api/v1/me

Liste los suscriptores activos y luego cree uno:

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

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

Autenticación, tokens y scopes

Cada solicitud envía Authorization: Bearer <token>. Un token contiene un nombre, un límite de tasa por minuto, una fecha de expiración (30–360 días o nunca) y un conjunto de scopes: permisos de lectura/escritura por recurso; un scope write incluye automáticamente el read correspondiente. El secreto se muestra una sola vez; el servidor almacena únicamente un hash. Un token puede ser revocado (las llamadas fallan inmediatamente, proceso reversible) o eliminado definitivamente.

Las respuestas siguen un conjunto de convenciones: los puntos de conexión de listado aceptan limit/offset y devuelven {"total", "items"}; los errores utilizan códigos de estado estándar: 401 token ausente, inválido o expirado, 403 scope ausente, 404 no encontrado, 409 duplicado, 422 error de validación y 429 cuando se produce un acceso que excede el límite de tasa (con los encabezados Retry-After y X-RateLimit-*).

Los montos en los datos de pago, billetera y webhook son cadenas decimales como "12.50"; las horas utilizan el formato ISO 8601 con el desplazamiento de la instalación.

Referencia del punto de conexión

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

Facturas, pagos, descuentos y wallet

Cada transacción monetaria pasa por los libros de partida doble de SAMM, exactamente igual que el panel. Una factura tiene un saldo pendiente de total − paid − discount; su estado cambia de unpaid/due a partial y paid (o discounted cuando los descuentos por sí solos la liquidaron).

# 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 reabre una factura pagada y DELETE /invoices/{id} la cierra correctamente (se anula el saldo remanente de una factura pagada parcialmente). Los libros se exportan en formato JSON o CSV mediante GET /accounting/export/{kind}.

Aplicaciones de pago

Las aplicaciones de transferencia de dinero y los agentes de tiendas (Wish Money, Sham Cash…) tienen sus propios scopes, collect:read y collect:write, y tres llamadas: buscar un usuario por nombre de usuario (nombre enmascarado, monto adeudado, facturas abiertas), registrar un pago y leerlo. Un pago es idempotente según su referencia: enviar el mismo pago nuevamente devuelve la primera respuesta y no registra nada.

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

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

Comandos en cola

Las mutaciones que afectan al estado de contabilidad activo —restablecimientos de límites, habilitación/deshabilitación de tarjetas y grupos, extensiones de validez— no se aplican dentro de la solicitud. Se encolan en la cola de comandos auditados y son aplicadas por samm-radius en un tick (unos pocos segundos), exactamente igual que al hacer clic en el portal del administrador. Dichos puntos de conexión responden {"queued": true}; consulte GET /commands para ver cómo los comandos encolados de su token cambian a applied.

Webhooks

Registre una URL de punto de conexión en System → API → Webhooks o con POST /webhooks, y seleccione los eventos: individuales, un grupo completo como invoice.* (se incluyen eventos posteriores de ese grupo) o * para todo. El secreto de firma se muestra en la página del punto de conexión y puede renovarse.

Cada entrega es un JSON con id, type, api_version, created_at y data. El id es el mismo para cada punto de conexión y cada reintento: procese cada id una sola vez. Responda con un código 2xx en menos de 10 segundos; cualquier otra respuesta se reintentará con backoff durante aproximadamente dos horas, y un punto de conexión que siga fallando se desactivará automáticamente. Cada entrega se registra con el código HTTP que devolvió su servidor y puede enviarse de nuevo.

Verifique X-SAMM-Signature-256: t=<unix>,v1=<hex>, un HMAC-SHA256 de t.body, antes de validar una entrega:

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"])
EventoCuando
customer.createdA user account was created
customer.updatedA user account was updated
customer.renewedA plan was renewed (expiration extended)
customer.plan_changedA user moved to another plan
customer.expiredA user expired (expiration sweep)
customer.suspendedA user was suspended (by an admin or for not paying)
customer.restoredA suspended user was restored
customer.deletedA user account was deleted
limit.exhaustedA usage limit was exhausted (quota / daily / uptime / expiration)
invoice.createdAn invoice was created
invoice.updatedWhat an invoice owes changed (payment, discount, reversal, write-off)
invoice.paidAn invoice was marked paid
invoice.deletedAn invoice was deleted
payment.receivedA payment was received and posted (online, payment app)
payment.reversedA payment was voided or an invoice reopened
wallet.topupMoney was added to a user's prepaid wallet
addon.addedAn add-on was given to or bought by a user
session.startedA user session started (off unless enabled in settings)
session.stoppedA user session stopped (off unless enabled in settings)
alert.openedAn alert opened (router down, service down, rogue DHCP server, new crash)
alert.resolvedAn alert cleared on its own or was resolved
webhook.testManual test event (sent from the test button)
Se aplican las mismas reglas que en el portal Las mutaciones de la API pasan por la misma cola de comandos auditada y capa de servicio que el portal del administrador; un reinicio o cambio de plan a través de la API se comporta exactamente igual que uno realizado en la UI, incluyendo el CoA y todo lo demás.
El enlace a SAMM está bloqueado Los tokens de control del router no pueden afectar el enlace entre SAMM y el propio router: sus inicios de sesión, su servicio API, sus ajustes de RADIUS, las propias reglas de seguridad de SAMM o la dirección mediante la cual SAMM accede a él. SAMM verifica que aún puede iniciar sesión después de cada cambio, y cada cambio o ejecución de script se guarda en el Admin Log.

Referencia

Funcionamiento de SAMM

Casi todo se hace desde el portal del administrador. Esta página es la referencia de la shell para las raras ocasiones en que la necesite.

Gestión del servicio

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

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

# Validate the FreeRADIUS config after any change
freeradius -CX

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

CLI del administrador

Para operaciones rápidas de suscriptores desde la shell. Cada comando se encola en el registro de auditoría y se aplica en el siguiente tick de samm-radius, exactamente igual que las acciones de la 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

Archivos de configuración

ArchivoRetenciones
/etc/samm/samm.yamlEl DSN de la base de datos, los tamaños del connection-pool, el nivel de log
/etc/samm/api.envSecretos de sesión del portal y los ajustes SMTP de recuperación de contraseña
/etc/samm/secret.keyLa clave de cifrado para las contraseñas de la API del router almacenadas

Estos archivos se conservan durante las actualizaciones y nunca son sobrescritos al ejecutar el instalador nuevamente. Los ajustes de tiempo de ejecución (cadencias de bucle, hora de reinicio diario, puertos CoA) se encuentran en Ajustes y se aplican sin necesidad de reiniciar.

Actualización de SAMM

Permita que SAMM se actualice desde System → License o ejecute nuevamente el instalador; consulte Installation → Upgrading. Ambas rutas vuelven a aplicar las migraciones y reinician los servicios; su configuración y datos permanecen intactos.

Copia de seguridad y recuperación &

Use Tools → Backup & Restore para realizar una instantánea completa de la base de datos antes de cualquier cambio importante. Para reconstruir en un host nuevo, instale SAMM y luego restaure la copia de seguridad.

Herramientas de mantenimiento (externas)

Algunas tareas de mantenimiento son lo suficientemente destructivas como para no pertenecer al panel del administrador, donde un clic accidental podría afectar la operatividad de un negocio. SAMM las mantiene como scripts independientes, exclusivos de root, que usted descarga y ejecuta deliberadamente desde la shell — nunca mediante un botón. Se encuentran en el repositorio de distribución pública en la ruta tools/.

Restablecer la contraseña de un administrador bloqueado

¿No puede acceder al panel del administrador? Establezca una nueva contraseña para una cuenta de superadmin directamente en la base de datos, sin necesidad de un inicio de sesión activo. También vuelve a habilitar la cuenta si estaba desactivada y no modifica nada más.

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)

Ejecútelo como root en el servidor SAMM. Si hay varios superadministradores, use --user <name> para elegir uno.

Restablecer los libros (borrar datos financieros)

Borra todas las transacciones financieras para que un ISP pueda comenzar su contabilidad desde cero, manteniendo intactos todos los datos de los suscriptores y de AAA. Es útil al hacerse cargo de una instalación o después de un periodo de prueba, cuando los registros contienen datos que el operador desea eliminar pero la base de clientes debe permanecer exactamente como está.

Peligro — pérdida irreversible de datos Esto elimina permanentemente todas las facturas, pagos, recibos, saldos de billetera e historial del libro mayor. Esta acción no se puede deshacer. La única forma de recuperar los datos es mediante un respaldo de la base de datos. Nunca ejecute este comando en una instalación de producción que no haya respaldado y verificado previamente.

Eliminado: facturas y sus partidas, el libro mayor de partida doble (pagos, recibos, ajustes, recargas y retiros de billetera), transacciones de pago en línea, gastos, activos fijos y el registro de actividad contable. La numeración de las facturas se reinicia, por lo que la siguiente factura comienza en #1.

Conservado: cada suscriptor, plan, ventana de velocidad, límite, contador de uso, historial de planes, tarjeta de hotspot, router, sesión y registro de contabilidad RADIUS — además de su configuración contable (plan de cuentas, cuentas de efectivo, grupos de impuestos, pasarelas de pago). Los saldos de efectivo, billetera y cuentas por cobrar se derivan del libro mayor, por lo que simplemente aparecerán en cero posteriormente.

Descárguelo, léalo y luego ejecútelo. Realice siempre una prueba en seco primero:

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
No lo redirija directamente a una shell Nunca ejecute esto como curl … | sudo bash. Cuando se trate de un script que destruye datos, usted debe leerlo primero; una descarga truncada no debe ser capaz de ejecutar un borrado parcial. Descargue, inspeccione y luego ejecute.

El script se niega a ejecutarse como un usuario que no sea root, imprime exactamente lo que está a punto de eliminar y luego le pide que escriba YES para confirmar que dispone de un respaldo verificado y WIPE para proceder. Ofrece realizar primero su propio volcado de base de datos (en /var/backups/samm/) y se aborta si dicho volcado falla. El borrado se ejecuta como una única transacción de todo o nada, y RADIUS se deja ejecutándose deliberadamente durante todo el proceso, para que los suscriptores permanezcan conectados mientras los registros son resueltos.

Referencia

Preguntas frecuentes & solución de problemas

¿Qué sistemas operativos soporta SAMM?

Ubuntu 22.04 / 24.04 / 26.04 LTS y Debian 12 / 13. Solo Linux de grado servidor; las variantes de escritorio no son compatibles. El instalador requiere systemd, una instalación limpia de PostgreSQL (se configurará una automáticamente) y acceso root.

¿Necesito una conexión a internet para ejecutar SAMM?

No. SAMM se ejecuta completamente en su propio servidor y autentica a los suscriptores localmente a través de RADIUS. El único tráfico saliente es un heartbeat de licencia periódico al servidor de licencias de SecuryTik para que su plan permanezca validado.

¿Puedo ejecutar SAMM en la nube o debe ser local (on-prem)?

Cualquiera de las dos opciones funciona. La mayoría de los operadores lo ejecutan de forma local junto a sus routers core; algunos lo ejecutan en una pequeña VM en la nube con un túnel de Cloudflare Zero Trust de retorno. El único requisito es que los routers MikroTik tengan conectividad con el servidor SAMM en los puertos RADIUS (1812/1813 UDP) y que SAMM tenga conectividad con los routers a través de la API de MikroTik.

¿Tengo que reiniciar FreeRADIUS cuando añado o elimino un router?

No. SAMM resuelve los clientes NAS dinámicamente desde la base de datos, por lo que añadir, editar o eliminar un router en MikroTik → NAS surte efecto sin necesidad de reiniciar.

¿Con qué rapidez surte efecto un cambio de plan o el reinicio de un contador?

Las acciones del administrador se encolan y se aplican mediante el servicio samm-radius en su siguiente ciclo — por defecto, en un plazo de 30 segundos. Si el suscriptor está en línea, SAMM también envía un CoA en vivo para actualizar la sesión. Reduzca el intervalo samm-radius en System → Settings para obtener una sincronización más precisa.

¿Qué ocurre con mis datos si caduca una licencia de pago?

Nada se elimina nunca. Una licencia vencida pasa por una advertencia, un periodo de gracia, un bloqueo parcial (RADIUS sigue autenticando durante aproximadamente una semana) y, finalmente, un bloqueo total. La reactivación en cualquier etapa reinicia cada servicio con todos los datos intactos.

¿Es SAMM gratuito? ¿Qué añade la versión Pro?

El nivel Free es gratuito para siempre e incluye todas las funciones. Los planes de pago no desbloquean funciones, sino que aumentan los límites de usuarios AAA y tarjetas de hotspot, y eliminan el límite de routers. Consulte Licensing & tiers.

Un suscriptor no puede autenticarse: ¿por dónde empezar?

Verifique que el secreto compartido RADIUS del router coincida exactamente con el registro NAS, que el router tenga habilitado RADIUS para PPP / Hotspot y que la cuenta del suscriptor esté Activa y no haya expirado. Monitoree journalctl -u samm-api -f y el log de FreeRADIUS, y confirme que el router puede alcanzar el host SAMM a través de UDP 1812/1813.

¿Necesita más ayuda?

Envíe un correo electrónico a samm@securytik.com para informar de un error o solicitar una funcionalidad.