TNS Panel
Comenzar

Guía del administrador

La interfaz de administración (https://<host>:2087) se organiza en doce secciones de la barra lateral: Cuentas, Sitios web, Correo, DNS, Bases de datos, Acceso, Backups, Seguridad, Servidor, Clúster, Migración, Panel. Un cuadro de búsqueda en la parte superior de la barra lateral filtra las entradas. La página de inicio muestra la carga del nodo, los discos, el estado de los servicios, los contadores y los hallazgos del asesor.

Todo lo que hace la interfaz web también está disponible a través de la API; un subconjunto está disponible además mediante la herramienta de línea de comandos panel en el servidor (ejecute panel sin argumentos para ver la lista). En un clúster la CLI es de sólo lectura para los datos compartidos: use la interfaz web o la API (ver Clúster).

Nodos

Un nodo es un servidor que ejecuta el panel. Una instalación independiente es un único nodo. El nombre de host, la fecha, la hora y la zona horaria, las direcciones IP y un reinicio inmediato o programado están en Servidor.

  • Nombre de host (Servidor → Nombre de host): al cambiarlo también se revisa /etc/resolv.conf y se restaura si el cambio de nombre lo vació. El certificado del panel y el del correo dependen del nombre de host, así que vuelva a emitirlos después. En un clúster, la identidad del nodo no es su nombre de host y no cambia.
  • Reiniciar ahora requiere confirmación explícita y se rechaza en un nodo de clúster (use el reinicio coordinado, ver Clúster).
  • Reinicio programado: elija una ventana (por ejemplo 03:00-05:00); el nodo se reinicia allí sólo cuando hay un kernel más nuevo pendiente. Desactivado por defecto.

Servicios

Servidor → Servicios lista los servicios que administra el panel (Apache, nginx, OpenLiteSpeed, Varnish, Postfix, Dovecot, Rspamd, ClamAV, BIND, unbound, Pure-FTPd, cron, MariaDB, PostgreSQL, Prometheus, Grafana, el cortafuegos y el propio panel) con su estado real. Puede iniciarlos, detenerlos y reiniciarlos.

  • La lista es cerrada: el panel sólo opera los servicios de su catálogo, nunca unidades arbitrarias.
  • Detener es una intención. Un servicio que usted detiene queda detenido: la reconciliación y las publicaciones de configuración no lo reinician. El asesor le recuerda mientras algo está detenido a propósito.
  • El panel no se reinicia a sí mismo desde esta pantalla.
  • "No instalado" es distinto de "detenido".

Cortafuegos

El cortafuegos está construido sobre nftables y se administra desde Seguridad → Cortafuegos, Permitidos y Bloqueados. Cada campo explica qué hace y a quién afecta.

  • Puertos: el instalador carga los puertos de los servicios que instaló (web, correo, DNS, FTP y su rango pasivo). Agregue o cierre otros por protocolo y rango.
  • Puertos mínimos: SSH y los dos puertos del panel están siempre abiertos y no pueden cerrarse desde el panel, para que no se quede fuera del servidor.
  • Permitidos: direcciones que eluden los bloqueos. Agregue aquí su propia dirección antes de endurecer cualquier regla.
  • Bloqueados: bloqueos temporales o permanentes. Los bloqueos vencen en el kernel; ningún demonio tiene que levantarlos.
  • Importar CSF: lee un csf.conf y las listas de permitidos y denegados para no perder la configuración existente.
  • Protección contra fuerza bruta: los intentos fallidos repetidos de ingreso al panel desde una misma dirección se bloquean en el cortafuegos.

CLI: panel fw-sembrar, fw-aplicar, fw-permitir, fw-denegar, fw-ban, fw-desbanear.

PHP

  • Versión de PHP del nodo (Servidor → PHP): la versión que usa un sitio cuando no elige la propia. Con una licencia, se instalan versiones adicionales desde el repositorio del proveedor (desactivado por defecto) y se elige una versión por sitio (Sitios web → sitio → Opciones de PHP). Sin licencia sólo hay una versión activa.
  • Respaldo cuando falta una versión. Si desinstala una versión que usa algún sitio, esos sitios pasan a la inmediata inferior instalada, o a la inmediata superior si no hay ninguna inferior. Se conserva la versión solicitada, de modo que al reinstalarla se restaura. El asesor lista los sitios afectados.
  • Extensiones de PHP (Acceso → Extensiones de PHP): un catálogo cerrado por cliente. El cliente puede activar o desactivar las extensiones comunes; seis de riesgo (ffi, xdebug, pcntl, posix, imap, ssh2) sólo puede habilitarlas un administrador, cliente por cliente, y la página indica qué abre cada una. imagick funciona con una política de ImageMagick reforzada; su disponibilidad depende de la versión de la distribución.
  • Manejador: panel manejador-php fpm|fcgid muestra o fija el manejador del nodo. PHP-FPM requiere licencia; fcgid+suexec es el manejador de la versión gratuita.
  • Cada cuenta ejecuta su propio master de PHP-FPM (por cliente y versión) con open_basedir y disable_functions aplicados; ver Modelo de seguridad.

Pilas web

El borde público en los puertos 80/443 es uno de Apache, nginx u OpenLiteSpeed, elegido por nodo. Sólo un proceso puede ocupar esos puertos; todo lo que está detrás (PHP-FPM, contenedores) escucha en loopback.

panel stack            # muestra el borde actual
panel stack nginx      # apache | nginx | litespeed

Al cambiar, se liberan los puertos, se reescriben los sockets y se levanta el nuevo borde; si el nuevo borde no arranca, el panel vuelve al anterior. Las combinaciones con Varnish y Apache detrás de nginx (nginx+Varnish+Apache) existen en el diseño; seleccionarlas desde el panel está Próximamente.

Las opciones de sitio disponibles para los clientes (y aplicadas en los tres bordes) figuran en la Guía del cliente.

Planes, revendedores y cuentas

Ver Revendedores para planes y revendedores. Operaciones sobre cuentas:

  • Cuentas → Nueva cuenta crea el cliente, su usuario UNIX y, opcionalmente, un primer sitio y un plan.
  • Suspender corta el servicio (sitios, correo, bases, FTP, cron, contenedores, consola), pero el cliente puede seguir ingresando al panel para ver el motivo. Desactivar además bloquea el ingreso al panel. Ambas acciones son reversibles y no borran nada. Estas acciones fijan un estado; repetirlas es seguro.
  • Operaciones masivas (Cuentas) suspenden, reactivan o cambian planes de muchas cuentas a la vez, autorizando cada cuenta por separado e informando qué cambió, qué ya estaba así y qué falló. Filtros: suspendidas, con cuota excedida.
  • Acceso a consola (shell) está desactivado por defecto; al habilitarlo, el cliente obtiene una shell SSH dentro de una jaula aislada. SFTP funciona para toda cuenta activa.
  • Suplantar (Cuentas → Suplantar): los administradores pueden abrir el panel de un cliente para resolver problemas; queda auditado con ambos nombres y requiere su propia clave.
  • Restablecer la clave de un usuario / regenerar el segundo factor: disponibles para los administradores; cada una requiere su propia clave y cierra las sesiones del usuario afectado.

Actualizaciones

Panel → Actualizaciones y CLI:

panel actualizacion-canal estable https://license.tnspanel.com/artefactos
panel actualizacion-buscar     # ¿hay una versión más nueva?
panel actualizar               # aplicarla
  • Tres canales: estable, candidata (versión candidata) y beta, seleccionables por nodo.
  • Las actualizaciones nunca se aplican sin que usted lo pida. El nodo verifica primero que no tenga desvíos respecto de su estado deseado.
  • La actualización es un paquete firmado, verificado contra una clave fijada en el nodo. Se rechaza el manifiesto de otro canal, y la rotación de claves sólo puede avanzar.
  • Se aplica mediante un proceso desprendido; después el panel debe seguir en pie y sano. Si no es así, el nodo vuelve atrás automáticamente a la versión anterior.
  • Las actualizaciones se sirven a los nodos cuya licencia está informando; un nodo gratuito sin licencia también las recibe.

Registro de auditoría

Seguridad → Auditoría registra quién hizo qué, cuándo, desde qué dirección y sobre qué recurso, incluidas las acciones de los administradores. Desde el punto de vista del panel es de sólo agregado. Las entradas pueden enviarse fuera del nodo, que es la única protección si el nodo mismo queda comprometido:

panel auditoria-externa                       # ¿se está enviando?
panel auditoria-externa-destino syslog+tls://logs.ejemplo.com:6514
panel auditoria-externa-destino -             # desactivar (esta acción también se envía antes de detenerse)
  • Formato: syslog RFC 5424 con entramado por conteo de octetos, que entienden rsyslog, Graylog y Splunk estándar.
  • Con syslog+tls:// el certificado del servidor siempre se verifica; no hay ningún interruptor para omitir la verificación. Si su SIEM usa una CA privada, suba esa CA en la página de auditoría (Seguridad → Auditoría): se confía sólo para ese destino.
  • syslog:// sin cifrar se acepta para redes internas de confianza.
  • Si el destino está caído, las entradas se encolan y se reintentan; el asesor avisa mientras el envío esté trabado.

Métricas

  • El nodo expone métricas en formato Prometheus en /metricas sobre el puerto de administración, protegidas por un token portador que usted genera en Servidor → Métricas (se muestra una sola vez; se rota o se elimina desde allí). Sin token, la ruta responde 404. Esto es gratuito en todos los niveles.
  • Mide el nodo y la CPU, memoria, IO y throttling de cada cliente desde su cgroup, el estado de los servicios y los contadores. No publica series por sitio.
  • Con una licencia, Servidor → Pila de métricas instala Prometheus y Grafana en el nodo. Cada nodo ejecuta su propio par y raspa a los demás, de modo que cada nodo tiene los datos de todo el clúster. A Grafana se accede a través del panel (sólo administrador); no tiene un ingreso separado.

Asesor

Servidor → Recomendaciones lee lo que el panel ya sabe y lista los elementos que tienen una acción concreta: certificados vencidos o próximos a vencer, sitios servidos en HTTP sin cifrar, servicios detenidos que el nodo necesita, destinos de backup que no funcionan, un cortafuegos vacío, clientes con directivas de servidor libres habilitadas, exportación de auditoría trabada, sitios cuya versión de PHP solicitada no está instalada, transferencia por encima del 80 % del plan. Una tabla sin filas significa que se revisó y no se encontró nada.

Otras herramientas de administración

  • Registros del nodo (Servidor): registros de correo, web, DNS, cortafuegos y panel, con búsqueda.
  • Cola de correo (Correo): listar, reencolar o eliminar mensajes en cola. Cada cambio queda auditado antes.
  • Escaneo de malware (Seguridad): detecta e informa; nunca borra archivos.
  • WAF (Sitios web): ModSecurity con el conjunto de reglas base de OWASP; exclusiones de reglas por sitio. Requiere licencia.
  • Cloudflare (DNS): ver API e integraciones.
  • Destinos de backup (Backups): ver la sección de backups de la Guía del cliente.
  • Marca (Panel → Marca): nombre del panel, logo y colores; ver Revendedores.