El manual del operador completo: desde la primera instalación hasta las operaciones diarias.
25 temas8 seccionesInstalació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.
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
Servicio
Rol
samm-api
Portal del administrador + portal de autoservicio del cliente + REST API
samm-radius
Vacía la bandeja de salida de CoA; ejecuta barridos de expiración / reinicio diario / ventana de velocidad
samm-worker
Realiza ping a los routers; sincroniza los metadatos de los dispositivos MikroTik a través de la API
samm-notification
Envía notificaciones por email & Telegram a través de una cola con limitación de tasa
samm-telegram
Ejecuta 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.
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.
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)
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:
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)
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
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).
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
Guarde su trabajo y reinicie el PC.
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.
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.)
Guardar y salir (normalmente F10), deje que Windows se inicie y luego ejecute el instalador de SAMM nuevamente.
Ubicación habitual
Marca
Clave de configuración
Ubicación habitual
Dell
F2
Soporte de Virtualización → Virtualización / Habilitar Intel Virtualization Technology
HP
F10 (o Esc, luego F10)
Avanzado (o Seguridad / Configuración del Sistema) → Virtualization Technology (VTx)
Modo avanzado (F7) → Avanzado → Configuración de CPU → Intel Virtualization Technology o SVM Mode
Acer
F2
Avanzado (o Principal) → Intel Virtualization Technology
MSI
Del
OC → CPU Features → Intel Virtualization Tech o SVM Mode
Gigabyte
Del
Tweaker (o Advanced) → Advanced CPU Settings → Intel Virtualization Technology o SVM Mode
Servidores (Dell iDRAC, HPE, Supermicro)
F2 / F9 / Del
Ajustes 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:
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:
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:
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:
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.
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:
En SAMM, vaya a Tools → Backup, cree un respaldo y
descargue el archivo en su computadora.
En el router, elimine la aplicación y agréguela nuevamente con la nueva versión.
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.
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.
Componente
Detalles
FreeRADIUS 3
Configurado con un backend PostgreSQL y clientes NAS dinámicos; validado con freeradius -CX
PostgreSQL
Base de datos, esquema y todas las migraciones SQL aplicadas; cada archivo de migración es idempotente
Python venv
Todas 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
nginx
Proxy 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 services
samm-api, samm-radius, samm-worker, samm-notification, samm-telegram — todos habilitados como unidades de systemd
WireGuard
Paquetes instalados; se configuran posteriormente en System → VPN
cloudflared
El 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
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.
Inicie sesión con administrador / administrador.
Cambie inmediatamente la contraseña desde System → Admins,
o desde el menú de perfil en la barra superior.
2 · Añada su primer router
Vaya a MikroTik → NAS y haga clic en Agregar router.
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.
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 antiguo
Archivo
De 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
Subir el archivo. Aún no se ha escrito nada.
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.
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.
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
Vaya a Usuarios → Planes.
Haga clic en Nuevo plan.
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
Campo
Significado
Nombre
Nombre de plan único, p. ej. Home-50M
Precio
Se cobra por periodo de facturación cuando se utiliza la facturación
Velocidad de descarga / subida
p. ej. 50M, 512K, 1G — aplicado como el límite de velocidad de MikroTik
Sesiones simultáneas
Cuá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ón
La suscripción finaliza tras un periodo fijo después de la activación (días/meses/horas/minutos)
Límite: Cuota
Un límite de datos total (combinado, solo de descarga o solo de subida) para toda la suscripción
Límite: Tiempo de actividad
Un límite de tiempo de conexión acumulado: la suma de todas las duraciones de sesión
Límite: Uso diario
Un límite de datos que se restablece cada día a la hora de daily-reset configurada
Ventana ilimitada
Adición rápida de una ventana de velocidad; el editor completo se encuentra en la página Speed Windows del plan
Pool de IP
Nombre opcional del RADIUS Framed-Pool para la asignación de direcciones
Renovación automática
Iniciar 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ímite
Trazas
Al agotarse
Vencimiento
Tiempo transcurrido desde la activación
Cambiar a otro plan o desconectar
Cuota
Total de bytes usados
Cambiar a otro plan o desconectar
Tiempo de actividad
Segundos acumulados de sesión
Cambiar a otro plan o desconectar
Diario
Bytes desde el último reinicio diario
Limitar — 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
Vaya a Users y haga clic en New customer.
Complete el formulario y haga clic en Guardar; el suscriptor podrá conectarse inmediatamente.
Campo
Significado
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 / Apellido
Nombre del suscriptor
Teléfono móvil / Correo electrónico / Dirección
Datos de contacto — se utilizan para notificaciones y facturas
Plan *
El plan de servicio a asignar
Anulación de vencimiento
Fecha de vencimiento manual opcional en lugar de la calculada por el plan
Renovación automática
Renovar 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ón
Funcionamiento
Ver / Editar
Abra la página de detalles, o edite los datos de contacto, la contraseña y la fecha de vencimiento
Activar / Desactivar
Suspender la cuenta — los suscriptores conectados se desconectan
Renovar plan
Sume 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 / diario
Poner a cero el contador del límite seleccionado
Uso
Abrir gráficos de uso e historial de sesiones
Eliminar
Eliminar 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
Vaya a Users → Hotspot Cards y haga clic en Nuevo grupo.
Complete el siguiente formulario y haga clic en Crear grupo — SAMM genera las credenciales de cada tarjeta automáticamente.
Sección
Campos
Identidad
Nombre de grupo único, descripción, prefijo de nombre de usuario opcional, cantidad de tarjetas a generar (hasta 10,000)
Credenciales
Formato de nombre de usuario y contraseña (números / letras / alfanumérico) y longitud
Límite de velocidad
Velocidad de descarga y subida — 256k, 6M, 1G; 0 = ilimitado
Limitar transferencia
Ilimitado, límite combinado o límites de descarga/subida independientes (MB / GB / TB)
Horarios de limitación
Lí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
Estado
Significado
Sin usar
Generado pero nunca inició sesión
Activo
En uso, dentro de sus límites
Agotado
Se ha alcanzado un límite (cuota, tiempo de conexión o expiración)
Desactivado
Desactivado 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
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.
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.
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.
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.
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.
Crear recompensas: mayor velocidad (la velocidad del plan multiplicada durante algunos días) o días gratis, cada una con un precio en puntos.
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
Inicie sesión en samm.securytik.com y abra Dashboard → Get a server.
Elija un nombre de servidor y el número de usuarios, y luego busque su dominio .com o elija una de las sugerencias.
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.
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.
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.
La línea de capacidad muestra cuántos usuarios caben antes de guardar.
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
Abra System → Settings → Data retention y actívela.
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.
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?
Abra Overview → Data Log → Data retention.
Introduzca la dirección pública, el puerto y la hora de la solicitud que ha recibido.
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
Vaya a MikroTik → NAS y haga clic en Agregar router.
Complete los campos a continuación y haga clic en Guardar.
Campo
Significado
IP / nombre de host del NAS
La dirección del router, tal como la ve el host SAMM
Nombre corto
Una etiqueta descriptiva que se muestra en la UI
Tipo
mikrotik habilita la sincronización de dispositivos en tiempo real y el envío de configuraciones; los demás tipos son solo RADIUS
Secreto
El secreto compartido de RADIUS — debe coincidir exactamente con el del router, o la autenticación fallará
Puerto CoA
Puerto UDP al que SAMM envía paquetes Change-of-Authorization (predeterminado de MikroTik 3799)
Puerto / usuario / contraseña de API
Credenciales 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:
Ajuste
Valor
Comentario
SAMM — la etiqueta que SAMM utiliza para buscar y actualizar esta entrada posteriormente
Servicio
hotspot, ppp
Dirección / secreto
El host SAMM, con el secreto compartido de este registro NAS
Tiempo de espera
3000 ms
CoA entrante
Aceptado, 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ña
Lo que muestra
Descripción general
Información del dispositivo, información del sistema y gráficos de historial de rendimiento (CPU, memoria, sesiones a lo largo del tiempo)
Interfaces
Cada interfaz con su estado en tiempo real, además del historial de tráfico por interfaz
Sitios web & Apps
Tres 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ña
Configuración realizada
Bridge
Cree puentes LAN y elija qué interfaces físicas (puertos) pertenecen a cada uno
VLAN
Agregar y gestionar interfaces VLAN
IP
Tres 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)
DNS
Servidores DNS y caché (el filtro de contenido de la aplicación/sede se encuentra en Websites & Apps)
WiFi / CAPsMAN
Interfaces Wi-Fi con sus configuraciones y perfiles de seguridad; y el controlador CAPsMAN — configuraciones, reglas de aprovisionamiento y CAPs remotos
Servicios & mantenimiento
Pestaña
Configuración realizada
PPPoE
Servidores PPPoE, perfiles PPP, pools de IP y el intervalo de actualización intermedia (interim-update) de accounting de RADIUS
Hotspot
Servidores hotspot, perfiles de hotspot y perfiles de usuario, pools de DHCP/IP y la página de inicio de sesión del captive-portal
Internet
Enlaces ascendentes WAN — WANs gestionadas por SAMM y rutas predeterminadas; cualquier WAN existente no gestionada por SAMM se muestra como solo lectura
Cortafuegos
Reglas 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
Actualizar
Actualizaciones de RouterOS: elija un canal de actualización, compruebe y aplique, y revise los paquetes instalados
Asistente
La 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.
Bienvenido & detect — SAMM analiza el router y muestra lo que ya está configurado, para que pueda omitir esos elementos en el push.
Interfaz Bridge — asigne un nombre al bridge de la LAN.
Bridge ports — seleccione qué interfaces físicas se unen al bridge.
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.
NTP — configure la fuente del reloj del router (cliente NTP y, opcionalmente, servidor de hora para la LAN).
Internet — añada uno o más enlaces WAN ascendentes (Static / DHCP / PPPoE).
RADIUS a SAMM — configure el router para que apunte a su host SAMM para
autenticación, accounting y CoA.
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.
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.
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
Abre Devices → Network Health y pulsa Inspección profunda, o haz clic derecho sobre un router en la página.
Enciende los routers que vas a inspeccionar. Todos los interruptores empiezan apagados. Solo aparecen los BNG MikroTik con un inicio de sesión guardado.
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.
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
La acción se registra en un registro de auditoría como un comando en cola.
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.
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.
Estado
Significado
pendiente
En cola, esperando el siguiente tick de samm-radius
enviado
Enviado (transitorio — el envío y su resultado se registran en el mismo tick, por lo que las filas rara vez permanecen en este estado)
nack
El router rechazó el CoA-Update; SAMM reintentará la operación y, de fallar, procederá a una desconexión
listo
Aplicado correctamente
fallido
Se 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.
Mosaico
Muestra
Abrir
En línea ahora
Suscriptores con una sesión RADIUS activa en este momento
Usuarios filtrados por Online
Suscriptores activos
Cuentas activas, con el recuento total de suscriptores debajo
Usuarios filtrados por Active
Expirado
Suscriptores cuya suscripción ha caducado sin un plan siguiente configurado
Usuarios filtrados por Expired
Tickets abiertos
Tickets de soporte aún no resueltos (excluye finalizados & cerrados)
Usuarios → Tickets de soporte
Routers
Total de registros NAS, más el recuento de los que no están accesibles actualmente
El monitor de MikroTik
Facturas pendientes de pago
Facturas que aún requieren seguimiento de pago
Facturas 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étrica
Qué significa
samm-radius cola
CoAs 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 pendiente
Acciones del administrador en cola que aún no han sido aplicadas por samm-radius
Sesiones limitadas
Suscriptores que actualmente tienen una velocidad reducida debido a un límite — comportamiento esperado, no es un error
Instantánea de sesiones
El recuento de sesiones activas — debe coincidir con Online now
Planes activos
El 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
Columna
Significado
Usuario
Nombre de usuario — enlaza a la página de detalles del suscriptor
Framed IP
La dirección que el router asignó a esta sesión
Router
El nombre corto del NAS y su dirección IP
Plan
Plan actual del suscriptor
Velocidad efectiva
La 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 / Conectado
Contadores de bytes en tiempo real de la sesión
En línea
Tiempo de actividad de la sesión
Iniciado
Cuando 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:
Lista
Rangos
Top 10 descargas de hoy
La descarga más grande desde el último reinicio diario
Top 10 de subida de hoy
Subida máxima desde el último reinicio diario
Top 10 descargas del mes
Descarga más grande de este mes calendario
Top 10 de subida del mes
Subida 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:
Figura
Significado
Efectivo disponible
Saldo total de todas las cuentas de efectivo & bancarias
Saldo a su favor
Cuentas por cobrar — facturas pendientes de clientes y revendedores
Saldo pendiente
Cuentas por pagar — gastos pendientes de pago
Ganancias de este mes
Ingresos 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:
Campo
Significado
Cliente
Búsqueda predictiva de la cuenta a facturar
Categoría de ingresos
Cuenta de ingresos donde se registra la venta
Emisión / Fecha de vencimiento
Si 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 impuesto
Por 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
Conceptos
Una 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ón
Qué se cobra
Factura completa
Solo periodos de plan completos; las fracciones de periodo se redondean al periodo completo siguiente.
Factura segmentada
La 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 factura
Cambie 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:
Ajuste
Significado
% de comisión
La 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édito
Lí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 prepago
Recá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:
Informe
Respuestas
Ganancia & Pérdida
Ingresos 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 general
A 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 caja
Por cuenta de efectivo: saldo inicial, entradas, salidas y saldo final en un rango determinado.
Tiempo de vida
Cuentas por cobrar y por pagar pendientes clasificadas por antigüedad, para que pueda reclamar facturas vencidas y anticiparse a los pagos.
Avanzado
Los 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ó:
Rechazo
Qué significa
Ese registro ya no existe
El suscriptor, la factura o el pago se eliminaron después de su acción; no queda nada que restaurar.
Ese registro ya existe
Se 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ón
Alguien 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 historial
El 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ón
Ejemplos
Comportamiento
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.
Haga clic en una pasarela para expandirla — Stripe, PayPal o Binance.
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.
Haga clic en Run test para confirmar que sus credenciales funcionan.
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
Cree una cuenta gratuita en stripe.com. Mantenga activado el Test mode mientras realiza las pruebas.
Vaya a Developers → API keys y copie la Secret key (comienza con sk_).
En SAMM, expanda Stripe, pegue la Secret key, elija la moneda y la cuenta de efectivo que la recibe, luego Guardar y Ejecutar prueba.
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
Cree una cuenta de PayPal Business, luego en developer.paypal.com cree una App REST y copie su Client ID y Secret.
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.
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.
Inicie sesión en Binance → abra Cuenta → API Management (o busque "API Management").
Haga clic en Create API → elija System generated → asígnele un nombre, p. ej. "SAMM" → complete la verificación de seguridad.
Binance muestra la API Key y la Secret Key — copie ambas ahora (la Secret se muestra solo una vez).
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)
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
En Binance vaya a Wallet → Spot → Deposit (Deposit Crypto).
Seleccione la moneda USDT.
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.
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.
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).
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.
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.
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.
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.
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
Inician sesión en el portal del cliente → Mis facturas.
En una factura no pagada, haga clic en Pay (o "Pay · Stripe" / "Pay · Binance" si hay varias habilitadas).
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.
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.
Tipo
Utilícelo para
WireGuard
Routers RouterOS 7, teléfonos y portátiles. Lo más rápido y sencillo.
L2TP/IPsec
Routers con RouterOS 6 y 7, y dispositivos que no tienen WireGuard.
SSTP
Dos 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
Para WireGuard, haga clic en Generate Keys para crear el par de claves del servidor.
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.
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
Presione el mosaico del logotipo o Subir logotipo y elija una imagen PNG, JPEG, WebP o GIF (de hasta 5 MB).
Arrastre la imagen para colocarla y use el deslizador para hacer zoom. El fondo transparente permanecerá transparente.
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:
Estado
Significado
En ejecución
El túnel está activo y reenviando tráfico
Detenido
Configurado pero no se está ejecutando actualmente
No configurado
El binario está presente — pegue un token para configurarlo
No instalado
Ejecute 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
En el panel de Cloudflare Zero Trust
(one.dash.cloudflare.com), abra Networks → Tunnels
y seleccione Create a tunnel.
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.
Pegue el token en SAMM y haga clic en Configure Tunnel. SAMM entrega el token a cloudflared e inicia el conector.
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
Ajuste
Predeterminado
Controles
samm-radius interval
30 s
Con qué frecuencia se evalúan los eventos temporizados y se envían los CoA
samm-worker interval
5 s
Cadencia de ping del router + sincronización de la API de MikroTik
Intervalo provisional de cuenta
60 s
El intervalo de contabilización enviado a los routers
Hora de reinicio diario
00:00
Cuando los contadores de uso diario se reinician
Zona horaria del servidor
UTC
Zona horaria para las ventanas de velocidad y el reinicio diario
Puerto predeterminado de CoA
3799
Puerto UDP predeterminado para paquetes CoA
Máximo de reintentos de CoA
3
Reintentos 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 realizados
Donde se muestra
Nombre del ISP
Facturas, recibos, tarjetas de hotspot, encabezado del portal
Teléfono de soporte & email
Facturas y tarjetas de hotspot impresas
Número de identificación fiscal / de registro
Impreso 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 & tasa
Añ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
Nodo
Qué es
Sucursal
Un 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.
Superadministrador
Siempre 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ímite
Qué contabiliza
Máximo de usuarios
Cuántos usuarios puede albergar la sucursal y las sucursales dependientes. Eliminar un usuario libera un espacio.
Máximo de tarjetas
Cuá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én
Un dispositivo de la sucursal
Personal de esa sucursal, de las sucursales superiores y de la oficina central
Gestionar
Personal de sus sucursales subordinadas
Ver, solo lectura
Otras sucursales
No se visualiza
Usuarios de esa sucursal y de sus sucursales hijas
Permitir 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:
Nivel
Significado
No permitido
El área está completamente oculta en la barra lateral
Ver
Acceso de solo lectura
Editar
Acceso 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:
Derecha
Funcionalidades
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:
Ajuste
Efecto
Máx. periodos por adelantado
El 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 adelantado
Lo 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.
Control
Funcionamiento
Porcentaje
Los 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 potenciar
Seleccione 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 de
Horas 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.
Columna
Lo que muestra
Cuando
La hora, en su zona horaria
Quién
El 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"
Destino
Acciones 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.
Nivel
Usuarios AAA
Tarjetas de Hotspot
NAS / enrutadores
Monitoreo
No registrado
25
25
1
3
Gratis
100
50
2
6
Lite
500
1,500
4
12
Plus
1,000
3,000
6
18
Pro
2,000
6,000
12
36
Mega
5,000
15,000
24
72
Max
10,000
30,000
ilimitado
ilimitado
Unlimited
ilimitado
ilimitado
ilimitado
ilimitado
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 &
Abra System → License.
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.
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:
Etapa
Qué sucede
Advertencia
Un banner de recordatorio; todo sigue funcionando
Periodo de gracia
Un intervalo corto para reactivar; los suscriptores permanecen conectados
Bloqueo parcial
Los servicios en segundo plano se detienen; RADIUS continúa autenticando durante aproximadamente 7 días
Bloqueo total
Los 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ágina
Lo que ve el suscriptor
Descripción general
Estado de la cuenta, plan, vencimiento, consumo de hoy y del mes, cualquier factura pendiente
Uso & sesiones
Total descargado/subido, presupuesto de tiempo de actividad e historial completo de sesiones
Mis planes
El plan actual más el catálogo de planes disponibles
Mis facturas
Historial de facturación con descarga de PDF en un solo clic
Tickets de soporte
Abrir y hacer seguimiento de los tickets de soporte
Perfil
Editar 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:
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).
Copie el secreto inmediatamente; se muestra una sola vez y solo su hash se almacena en el servidor.
Verifique que funcione y vea qué puede hacer el token:
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
Área
Puntos de conexión
Alcance
Token & commands
GET /commands · GET /me
any token
Users
GET /customers · POST /customers · POST /customers/bulk · GET /customers/{customer_id} · PATCH /customers/{customer_id} · DELETE /customers/{customer_id} · POST /customers/{customer_id}/activate · POST /customers/{customer_id}/assign-plan · PUT /customers/{customer_id}/custom-fields · GET /customers/{customer_id}/data-log · POST /customers/{customer_id}/disconnect · POST /customers/{customer_id}/renew · POST /customers/{customer_id}/reset-limit · POST /customers/{customer_id}/suspend · GET /customers/{customer_id}/timeline · GET /customers/{customer_id}/usage · GET /customers/{customer_id}/timeline/export.{fmt}
GET /plans · POST /plans · GET /plans/{plan_id} · PATCH /plans/{plan_id}
plans:readplans:write
Invoices
GET /invoices · POST /invoices · GET /invoices/{invoice_id} · DELETE /invoices/{invoice_id} · POST /invoices/{invoice_id}/pay · GET /invoices/{invoice_id}/pdf · POST /invoices/{invoice_id}/unpay
billing:readbilling:write
Payments, discounts & wallet
GET /cash-accounts · GET /customers/{customer_id}/wallet · GET /invoices/{invoice_id}/balance · POST /invoices/{invoice_id}/discounts · POST /invoices/{invoice_id}/payments · POST /customers/{customer_id}/wallet/pay-invoice · POST /customers/{customer_id}/wallet/topup · POST /customers/{customer_id}/wallet/withdraw · DELETE /invoices/{invoice_id}/discounts/{discount_id}
billing:readbilling:write
Payment apps (collect)
GET /collect/lookup · POST /collect/payments · GET /collect/payments/{channel}/{reference}
collect:readcollect:write
Accounting export
GET /accounting/export · GET /accounting/export/{kind}
accounting:read
Add-ons & price lists
GET /addons · GET /price-lists · DELETE /user-addons/{user_addon_id} · GET /customers/{customer_id}/addons · POST /customers/{customer_id}/addons
addons:readaddons:write
Hotspot cards
GET /cards/groups · POST /cards/groups · GET /cards/{card_id} · GET /cards/groups/{group_id} · POST /cards/{card_id}/disable · POST /cards/{card_id}/enable · GET /cards/groups/{group_id}/cards · POST /cards/groups/{group_id}/cards · POST /cards/groups/{group_id}/disable · POST /cards/groups/{group_id}/enable · POST /cards/groups/{group_id}/extend · GET /cards/groups/{group_id}/print.pdf · POST /cards/{card_id}/reset/{kind}
cards:readcards:write
Sessions & CoA
GET /coa-outbox · GET /sessions · POST /coa-outbox/cancel · POST /coa-outbox/retry · POST /sessions/disconnect · POST /sessions/reconnect
coa:writesessions:read
Webhooks
GET /webhooks · POST /webhooks · GET /webhooks/events · PATCH /webhooks/{endpoint_id} · DELETE /webhooks/{endpoint_id} · GET /webhooks/{endpoint_id}/deliveries · POST /webhooks/{endpoint_id}/disable · POST /webhooks/{endpoint_id}/enable · POST /webhooks/{endpoint_id}/roll-secret · POST /webhooks/{endpoint_id}/test · POST /webhooks/deliveries/{delivery_id}/resend
webhooks:manage
User files
GET /customers/{customer_id}/files · POST /customers/{customer_id}/files · GET /customers/{customer_id}/files/{file_id} · DELETE /customers/{customer_id}/files/{file_id}
customers:readcustomers:write
Branches
GET /branches · PUT /customers/{customer_id}/branch
admins:writecustomers:read
Admins
GET /admins
customers:read
Self Service (guests)
GET /self-service/handouts · GET /self-service/summary
guests:read
Statistics
GET /stats/overview
stats:read
Routers & router control
GET /routers · POST /routers/jobs · GET /routers/playbooks · GET /routers/{router_id} · GET /routers/jobs/kinds · GET /routers/jobs/prefill · GET /routers/jobs/{job_id} · GET /routers/{router_id}/log · POST /routers/{router_id}/probe · GET /routers/{router_id}/probes · GET /routers/{router_id}/radius · GET /routers/{router_id}/ros · POST /routers/{router_id}/ros · POST /routers/{router_id}/scoop-change · GET /routers/{router_id}/scoop-changes · POST /routers/{router_id}/script · GET /routers/{router_id}/test · GET /routers/{router_id}/traffic · POST /routers/jobs/{job_id}/cancel · GET /routers/wireless/by-user/{customer_id} · GET /routers/{router_id}/ppp/{username} · GET /routers/{router_id}/scoop-change/preview · POST /routers/{router_id}/scoop-change/{change_id}/undo
GET /network/findings · GET /network/health · GET /network/topology · PUT /customers/{customer_id}/features · GET /network/ftth/olts · GET /network/ftth/onus · GET /network/wireless/aps · GET /network/wireless/stations · GET /routers/{router_id}/reach · POST /routers/{router_id}/reach · DELETE /routers/{router_id}/reach/{reach_id}
customers:writerouters:read
Bulk import
POST /imports/users
imports:write
Backups
GET /backups · POST /backups · GET /backups/schedule · PUT /backups/schedule · DELETE /backups/{name} · GET /backups/{name}/download · POST /backups/{name}/restore
backups:readbackups:write
History cleaner
POST /history/clean · GET /history/schedule · PUT /history/schedule · GET /history/space
history:readhistory:write
VPN clients
GET /vpn/l2tp/clients · POST /vpn/l2tp/clients · GET /vpn/sstp/clients · POST /vpn/sstp/clients · GET /vpn/wireguard/clients · POST /vpn/wireguard/clients · PUT /vpn/l2tp/clients/{cid} · DELETE /vpn/l2tp/clients/{cid} · PUT /vpn/sstp/clients/{cid} · DELETE /vpn/sstp/clients/{cid} · PUT /vpn/wireguard/clients/{peer_id} · DELETE /vpn/wireguard/clients/{peer_id} · GET /vpn/l2tp/clients/{cid}/config · GET /vpn/l2tp/clients/{cid}/mikrotik · POST /vpn/l2tp/clients/{cid}/toggle · GET /vpn/sstp/clients/{cid}/config · GET /vpn/sstp/clients/{cid}/mikrotik · POST /vpn/sstp/clients/{cid}/toggle · GET /vpn/wireguard/clients/{peer_id}/config · GET /vpn/wireguard/clients/{peer_id}/mikrotik · POST /vpn/wireguard/clients/{peer_id}/toggle
vpn:readvpn:write
Diagnostics
GET /diagnostics
diagnostics:read
Support & logs
GET /audit · GET /auth-log · GET /audit/actors · GET /support/alerts · GET /support/backups · GET /support/database · GET /support/errors · GET /support/license · GET /support/logs · GET /support/notifications · GET /support/payments · GET /support/probe · GET /support/queues · GET /support/self-test · POST /support/service-restart · GET /support/services · GET /support/settings · PUT /support/settings · GET /support/system · GET /support/update · GET /customers/{customer_id}/why-blocked · GET /support/errors/{incident} · GET /support/payments/incoming
GET /reports/activations · GET /reports/financial · POST /retention/lookup · GET /customers/{customer_id}/statement
accounting:readcustomers:readretention:lookup
Scoop
GET /scoop/schedules · POST /scoop/schedules · DELETE /scoop/schedules/{schedule_id}
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.
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"])
Evento
Cuando
customer.created
A user account was created
customer.updated
A user account was updated
customer.renewed
A plan was renewed (expiration extended)
customer.plan_changed
A user moved to another plan
customer.expired
A user expired (expiration sweep)
customer.suspended
A user was suspended (by an admin or for not paying)
customer.restored
A suspended user was restored
customer.deleted
A user account was deleted
limit.exhausted
A usage limit was exhausted (quota / daily / uptime / expiration)
invoice.created
An invoice was created
invoice.updated
What an invoice owes changed (payment, discount, reversal, write-off)
invoice.paid
An invoice was marked paid
invoice.deleted
An invoice was deleted
payment.received
A payment was received and posted (online, payment app)
payment.reversed
A payment was voided or an invoice reopened
wallet.topup
Money was added to a user's prepaid wallet
addon.added
An add-on was given to or bought by a user
session.started
A user session started (off unless enabled in settings)
session.stopped
A user session stopped (off unless enabled in settings)
alert.opened
An alert opened (router down, service down, rogue DHCP server, new crash)
alert.resolved
An alert cleared on its own or was resolved
webhook.test
Manual test event (sent from the test button)
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
Archivo
Retenciones
/etc/samm/samm.yaml
El DSN de la base de datos, los tamaños del connection-pool, el nivel de log
/etc/samm/api.env
Secretos de sesión del portal y los ajustes SMTP de recuperación de contraseña
/etc/samm/secret.key
La 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 datosEsto 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.