Funciones de Extended
- Estadísticas de correo
- Estadísticas de uso del disco
- Instalar aplicación Node.js
- FASTPANEL Extended
- Marca
- Notificaciones del servidor
- Prometheus
Estadísticas de correo
En esta página
FASTPANEL Extended está habilitada de forma predeterminada para todos los usuarios. No es necesario activar una licencia.
FASTPANEL® incluye una función de Estadísticas de correo que le permite supervisar fácilmente la actividad de correo saliente de un dominio completo o de buzones individuales. Puede ver rápidamente cuántos mensajes se enviaron, entregaron o rebotaron, y consultar códigos de error SMTP detallados con recomendaciones que explican por qué se rechazaron ciertos correos.
Configurar la recopilación automática de estadísticas
- Para habilitar la recopilación automática de estadísticas de correo, vaya a "Configuración" → "Correo" → "Estadísticas" y active la opción "Habilitar recopilación de estadísticas".
Si prefiere no recopilar datos automáticamente, desactive esta opción. Entonces tendrá que hacer clic manualmente en el botón "Actualizar" en la vista de estadísticas (consulte la siguiente sección) para actualizar los datos.
-
Puede definir con qué frecuencia se actualizan automáticamente las estadísticas: desde cada 1 hora hasta cada 24 horas.
-
Para guardar su configuración, no olvide hacer clic en el botón "Guardar".
Vista de estadísticas
Para ver las estadísticas, vaya a "Gestión" → "Correo" y haga clic en el icono de gráfico junto al dominio que desea analizar.
La vista de estadísticas se divide en tres secciones principales, que se describen en detalle a continuación.
Gráfico de estadísticas
Muestra el número total de mensajes enviados, entregados y rebotados durante el período de tiempo seleccionado. El gráfico le ayuda a identificar tendencias y problemas de entrega de un vistazo.
Puede personalizar los datos mostrados mediante lo siguiente:
-
Seleccionar un dominio de correo.
-
Seleccionar estadísticas para todo el dominio o para un buzón específico.
-
Elegir el intervalo de tiempo del informe, desde las últimas 24 horas hasta el último mes.
-
Hacer clic en el botón "Actualizar" para refrescar manualmente las estadísticas y recuperar los datos más recientes.
Principales razones de rebote
Enumera las causas más frecuentes de los fallos de entrega de mensajes, junto con sus correspondientes códigos de error SMTP. Esto le permite comprender y resolver problemas recurrentes.
Eventos de error saliente
Proporciona información detallada sobre cada mensaje rechazado o no entregado, con acciones recomendadas para resolver los problemas.
Para cada registro, se muestran los siguientes detalles:
-
Fecha/Hora — la hora exacta en la que se produjo el intento de entrega
-
ID de cola — el identificador único del mensaje en la cola de correo
-
De / Dominio del remitente / Para — direcciones del remitente y del destinatario, así como el dominio de origen
-
Código SMTP — el código de respuesta devuelto por el servidor de correo del destinatario (por ejemplo, 550-5.7.26)
-
Consejo — una breve explicación del problema y una acción recomendada (p. ej., “Mensaje rechazado por Gmail: falta autenticación SPF/DKIM o ha fallado”)
-
Detalle — el texto completo de la respuesta SMTP, que puede incluir un enlace a documentación externa del servidor del destinatario (por ejemplo, páginas de soporte de Gmail)
-
Código desconocido — indica si la respuesta SMTP no pudo clasificarse
-
Bytes — tamaño del mensaje de correo
-
Recuento de reintentos — número de intentos de entrega realizados antes de que el mensaje fuera rechazado permanentemente
-
Último intento — marca temporal del intento de entrega final
-
Puntuación de spam — resultado de la evaluación de spam, si corresponde
Estos datos proporcionan una visión general completa de los problemas de entrega saliente, lo que le ayuda a diagnosticar problemas de autenticación, reputación o configuración.
Estadísticas de uso del disco
FASTPANEL Extended está habilitada de forma predeterminada para todos los usuarios. No es necesario activar una licencia.
FASTPANEL® incluye una función de Estadísticas de uso del disco que le permite ver rápidamente qué archivos y directorios consumen espacio en los directorios de usuario de sus sitios web.
Para usar esta función, abra "Administración" → "Administrador de archivos" y haga clic en el icono redondo en la esquina superior derecha
En la siguiente pantalla, verá estadísticas detalladas de uso del disco, incluidas Directorios, Archivos grandes principales y Estadísticas por extensión.
- Haga clic en el icono de carpeta en la esquina superior derecha para volver al administrador de archivos.
- Haga clic en el icono de actualización (flechas circulares) en la esquina superior derecha para recargar los datos.
- Haga clic en el nombre de usuario en la esquina superior izquierda para cambiar entre los directorios personales de distintos usuarios; las estadísticas se actualizarán en consecuencia.
Node.js
En esta página
FASTPANEL Extended está habilitada de forma predeterminada para todos los usuarios. No es necesario activar una licencia.
Introducción
Node.js es una plataforma de servidor que ejecuta aplicaciones escritas en JavaScript.
Primero, necesita instalar Node.js:
- Vaya a "Configuración" -> "Aplicaciones"
- Haga clic en el botón "Instalar" para la versión de Node.js requerida
Cree un sitio web:
- Seleccione una plantilla para un sitio web Node.js
- Especifique el dominio y los parámetros relacionados. En la etapa de configuración puede cambiar la BD, el usuario FTP y el Backend
- Cargue los archivos de la aplicación en el directorio del sitio web
- Para instalar dependencias ejecute
npm20.15.1 installen Terminal (es necesario instalar la aplicación ttyd para FASTPANEL®)
- Reinicie Node.js yendo al panel del sitio y luego abriendo la sección "Servicios".
Framework Express
Usando el framework Express como ejemplo, creemos un servidor web simple:
- Conéctese al servidor mediante SSH como el usuario propietario del sitio (puede usar la aplicación ttyd para FASTPANEL®)
- Cree un archivo
app.jsen el directorio del sitio web y complételo con el siguiente código:
const express = require('express');
const app = express();
const PORT = process.env.SERVICE_PORT;
app.get('/', (req, res) => {
res.send('Hello! This is my first server on Node.js + Express 🚀');
});
app.listen(PORT, () => {
console.log(`Server is running at http://localhost:${PORT}`);
});
- En el directorio del sitio web, ejecute el comando para instalar express
npm20.15.1 install express- Vaya al panel del sitio y luego a la sección Servicios
- Reinicie el servicio
- Compruebe el sitio web
Docusaurus
Usando la aplicación web Docusaurus como ejemplo, configuremos los ajustes:
- Conéctese al servidor mediante SSH como el usuario propietario del sitio (puede usar la aplicación ttyd para FASTPANEL®)
- En el directorio del sitio web, ejecute la instalación de Docusaurus
npx20.15.1 create-docusaurus -j ./docs-
Cuando se le pida seleccionar una plantilla, responda classic (recommended)
-
Después de la instalación, reemplace una línea en el archivo
docs/package.json
"start": "docusaurus start",
# replace with
"start": "docusaurus start --port $SERVICE_PORT",$SERVICE_PORT es una variable del sistema establecida en FASTPANEL®
-
En el panel de control, vaya a "ajustes del sitio" -> "Backend"
-
Seleccione el controlador Standalone o PM2.
-
Elija la versión de Node.js deseada.
-
Especifique la carpeta de trabajo
docs -
En el campo Comando de inicio, introduzca:
npm run start -
Guarde. Espere a que la aplicación se compile (la información aparecerá en los registros). Compruebe el sitio web
Next.js
Usando Next.js con Node.js 20.19 como ejemplo, vamos a crear un servidor web sencillo:
- Conéctese al servidor mediante SSH como el usuario propietario del sitio web (también puede usar la aplicación ttyd en FASTPANEL®).
- En el directorio del sitio web, ejecute el comando de inicialización del proyecto:
yarn20.19.4 init -y
yarn20.19.4 add next react react-dom- Añada un bloque scripts al archivo
package.json:
"scripts": {
"dev": "next dev -p $SERVICE_PORT",
"build": "next build",
"start": "next start -p $SERVICE_PORT"
}- Cree un directorio
pagesy, dentro de él, añada un archivo llamadoindex.js:
mkdir pages
cat <<EOF > pages/index.js
export async function getServerSideProps() {
return {
props: {
nodeVersion: process.version,
port: process.env.SERVICE_PORT || 3000,
},
};
}
export default function Home({ nodeVersion, port }) {
return (
<div style={{
fontFamily: 'sans-serif',
textAlign: 'center',
marginTop: '20vh'
}}>
<h1>✅ It works!</h1>
<p>Next.js app running on Node.js {nodeVersion}</p>
<p>Port: {port}</p>
</div>
);
}
EOF- Ejecute la compilación del proyecto.
yarn20.19.4 build- En el panel de control, vaya a "ajustes del sitio" -> "Backend"
- Seleccione el controlador Standalone o PM2.
- Elija la versión de Node.js deseada.
- En el campo Comando de inicio, introduzca:
yarn run start. - Guarde. Espere a que la aplicación se compile (la información aparecerá en los registros). Compruebe el sitio web
Información adicional
En el modo Standalone, se inicia un proceso Node.js para ejecutar sus scripts.
En el modo PM2, se utiliza el gestor de procesos PM2 para administrar procesos Node.js, registros y carga del sistema.
Este modo también le permite especificar el número de workers, es decir, el número de procesos Node.js que manejan las solicitudes entrantes al servidor.
Además, este modo proporciona la opción Enable file watch — PM2 reinicia automáticamente su aplicación cuando se modifica un archivo en el directorio actual o en sus subdirectorios. Tenga en cuenta que este modo introduce una carga adicional en el sistema y no se recomienda para entornos de producción.
De forma similar, puede configurar la aplicación si requiere YARN en lugar de NPM
Puede instalar las dependencias de su proyecto listadas en package.json usando YARN o NPM directamente desde FASTPANEL®. Para ello, abra la tarjeta del sitio web y vaya a la sección Servicios:
Registros
Una aplicación Node.js puede generar registros. En FASTPANEL®, se encuentran en el panel del sitio, en la sección Registros, en la pestaña "Registro del Backend"
Comandos de consola
Después de instalar Node.js en FASTPANEL®, los usuarios pueden trabajar con sus proyectos usando comandos de consola como:
- pm2
- yarn20.15.1
- npx20.15.1
- npm20.15.1
- node20.15.1
Ejemplo:
$ npm20.15.1 list
node-socket-port-server@1.0.0 /var/www/node_user/data/www/node.site
└── express@4.21.2$ pm2 ls
┌────┬─────────────┬─────────────┬─────────┬─────────┬──────────┬────────┬──────┬───────────┬──────────┬──────────┬──────────┬──────────┐
│ id │ name │ namespace │ version │ mode │ pid │ uptime │ ↺ │ status │ cpu │ mem │ user │ watching │
├────┼─────────────┼─────────────┼─────────┼─────────┼──────────┼────────┼──────┼───────────┼──────────┼──────────┼──────────┼──────────┤
│ 0 │ amazing_site│ default │ 1.0.0 │ cluster │ 9355 │ 2m │ 0 │ online │ 0% │ 62.4mb │ user │ disabled │
│ 1 │ amazing_site│ default │ 1.0.0 │ cluster │ 9362 │ 2m │ 0 │ online │ 0% │ 62.5mb │ user │ disabled │
└────┴─────────────┴─────────────┴─────────┴─────────┴──────────┴────────┴──────┴───────────┴──────────┴──────────┴──────────┴──────────┘Cada nombre de comando incluye el número de versión de Node.js que se instaló. En este ejemplo, la versión disponible es Node.js 20.15.1.
FASTPANEL Extended
FASTPANEL Extended está habilitada de forma predeterminada para todos los usuarios. No es necesario activar una licencia.
Personalización de la marca
En esta página
La sección Marca en FASTPANEL® permite personalizar la apariencia visual y el estilo del panel de control. Este menú se encuentra en "Configuración" → "Principal" → "Marca".
Esquemas de color
Vaya a la pestaña "Esquemas de color" para cambiar el tema de color principal del panel. Elija entre una variedad de paletas de colores predefinidas (p. ej., azul, naranja, rojo, verde).
Ajuste el Tema:
- Claro: Use un tema claro
- Oscuro: Cambie al modo oscuro
- Como en el dispositivo: Se adapta automáticamente a la configuración del dispositivo del usuario
Personalización del logotipo
La pestaña "Logotipo" permite cargar un logotipo personalizado para diferentes áreas del panel.
Pantalla de inicio de sesión
Se pueden cargar logotipos separados para los temas Claro y Oscuro.
Use el botón Cargar para añadir un nuevo logotipo o Restablecer para volver al predeterminado.
- Formatos compatibles: jpeg, png, svg, webp
- Resolución máxima: 256x100 píxeles
- Tamaño máximo de archivo: 5 MB
Logotipo del encabezado
Se muestra en el encabezado del panel de control.
- Formatos compatibles: jpeg, png, svg, webp
- Resolución máxima: 200x22 píxeles
- Tamaño máximo de archivo: 5 MB
Personalización del favicon
La pestaña "Favicon" permite cargar un favicon, que se muestra en las pestañas del navegador y en los resultados de búsqueda.
Use el botón Cargar para añadir un favicon o Restablecer para volver al predeterminado.
- Formato compatible: ico
- Tamaño máximo de archivo: 1 MB
Personalización de enlaces
La pestaña "Enlaces" proporciona campos para personalizar los enlaces en el menú lateral.
- Base de conocimientos: URL para acceder a la base de conocimientos
Después de modificar los enlaces, haga clic en Guardar para aplicar los cambios.
Notificaciones del servidor
FASTPANEL Extended está habilitada de forma predeterminada para todos los usuarios. No es necesario activar una licencia.
FASTPANEL® permite monitorear métricas clave del servidor: carga de CPU, Load Average 5, uso de disco y consumo de RAM. Cuando una métrica supera su umbral, las alertas se envían automáticamente a Telegram o Slack. La configuración se encuentra en "Ajustes" → "Notificaciones".
Este artículo explica cómo configurar canales de entrega y ajustar parámetros de notificación, incluidos umbrales y disparadores.
Configuración del canal
Telegram
- Cree un nuevo bot usando el bot oficial de Telegram @BotFather. Siga el enlace y haga clic en el botón "Start"
- Escriba
/newboty presione Enter. - Introduzca el nombre deseado para su bot y presione Enter.
- Introduzca el nombre de usuario deseado para su bot. Debe terminar con
bot, luego presione Enter. - Recibirá un mensaje que comienza con:
Done! Congratulations on your new bot. - Haga clic en la línea azul después de
Use this token to access the HTTP API:(difuminada en la captura de pantalla) para copiar el token API de su bot al portapapeles. Mantenga el token seguro, ya que cualquiera que lo tenga puede controlar su bot
El token API se almacena en @BotFather. Si lo olvida, envíe el comando /mybots, seleccione su bot y haga clic en el botón "API Token".
- Abra FASTPANEL® y vaya a "Ajustes" → "Notificaciones".
- Haga clic en el botón "Crear canal"
- Rellene los siguientes campos:
- Nombre — Introduzca un nombre para el canal para distinguirlo visualmente
- Canal — Elija "Telegram"
- Token del bot — Pegue el token del bot copiado en el paso 6
- Período del problema — Establezca el intervalo de tiempo (en minutos) tras el cual se enviará una notificación si el problema persiste. El valor mínimo es 1 minuto
- Intervalo de repetición de notificaciones — Establezca el intervalo entre notificaciones consecutivas para el mismo problema
- Notificar sobre problemas resueltos — Active esta opción para recibir una notificación cuando el problema se resuelva
- Añadir disparadores básicos — Active esta opción para crear automáticamente disparadores para todas las unidades, RAM y CPU
- Haga clic en el botón "Guardar".
- En la siguiente pantalla, haga clic en el botón "Invitar" para invitar a su bot al chat o al chat grupal
- Se abrirá un enlace en una nueva pestaña. Confirme la redirección a la aplicación Telegram Desktop
- Haga clic en el botón "Start" para activar su bot
- Para verificar que la configuración es correcta, vuelva a la pestaña de FASTPANEL® y haga clic en el botón del avión de papel
- Si todo está configurado correctamente, se enviará una notificación de prueba al chat con su bot
- Para ajustar la configuración del canal más tarde, haga clic en el icono del lápiz junto al canal
- A continuación se muestra un ejemplo de una notificación generada cuando se activa un disparador
Slack
- Inicie sesión en su cuenta y cree una aplicación de Slack mediante la página de aplicaciones.
- Seleccione "From scratch".
- Introduzca un App Name, elija el espacio de trabajo donde se creará la aplicación y haga clic en “Create app”.
- En la sección “Features”, abra “Incoming Webhooks” y active la función
- En la parte inferior de la misma página, haga clic en “Add New Webhook”
- En la siguiente pantalla, seleccione el canal al que se enviarán las notificaciones. Se recomienda crear un canal dedicado para las alertas. Luego haga clic en “Allow”.
- Será redirigido de nuevo a la página de webhooks. Desplácese hacia abajo y haga clic en “Copy” para copiar la URL del webhook
- Abra FASTPANEL® y vaya a "Ajustes" → "Notificaciones".
- Haga clic en el botón "Crear canal"
- Rellene los siguientes campos:
- Nombre — Introduzca un nombre para el canal para distinguirlo visualmente
- Canal — Elija "Slack"
- URL del webhook — Pegue la URL del webhook copiada en el paso 7
- Período del problema — Establezca el intervalo de tiempo (en minutos) tras el cual se enviará una notificación si el problema persiste. El valor mínimo es 1 minuto
- Intervalo de repetición de notificaciones — Establezca el intervalo entre notificaciones consecutivas para el mismo problema
- Notificar sobre problemas resueltos — Active esta opción para recibir una notificación cuando el problema se resuelva
- Añadir disparadores básicos — Active esta opción para crear automáticamente disparadores para todas las unidades, RAM y CPU
- Haga clic en el botón "Guardar".
- Para verificar que la configuración es correcta, haga clic en el botón del avión de papel
- Si todo está configurado correctamente, se enviará una notificación de prueba al canal seleccionado en el paso 6
- Para ajustar la configuración del canal más tarde, haga clic en el icono del lápiz junto al canal
- A continuación se muestra un ejemplo de una notificación generada cuando se activa un disparador
Configuración de disparadores
Para configurar los disparadores, haga clic en el icono de engranaje en la fila del canal que desea editar
En la sección abierta, puede:
- Desactivar los disparadores innecesarios usando el interruptor de la izquierda.
- Crear un nuevo disparador de uno de los siguientes tipos: CPU, Disk (para cada disco individualmente), Load Average 5 (carga promedio del sistema durante los últimos 5 minutos), RAM.
- Editar disparadores existentes
Los umbrales para CPU, Disk y RAM se establecen en porcentajes. El umbral para Load Average 5 se establece en valores enteros.
Como regla general, un valor normal de Load Average 5 es aproximadamente igual al número de núcleos de CPU en el servidor, o hasta el doble de ese número.
Prometheus
En esta página
FASTPANEL Extended está habilitada de forma predeterminada para todos los usuarios. No es necesario activar una licencia.
Integración de FASTPANEL con Prometheus para la recopilación de métricas
FASTPANEL® ahora admite la integración con Prometheus para recopilar métricas del sistema. Esta guía le mostrará los pasos necesarios para agregar su instancia de FASTPANEL® a Prometheus, lo que le permitirá recopilar y supervisar métricas del sistema en tiempo real.
Crear un token
Para permitir que Prometheus recopile métricas, necesita crear un token especial con acceso limitado:
-
Conéctese a su servidor FASTPANEL® mediante SSH.
-
Ejecute el siguiente comando para crear un token:
mogwai users tokens add -n metrics_test_token -s read_only -s metrics_only- metrics_test_token es un nombre personalizado para el token; puede elegir cualquier nombre
- Al token se le otorgarán los siguientes alcances:
- read_only — acceso de solo lectura
- metrics_only — acceso restringido a las métricas
Agregar un trabajo a Prometheus
Una vez creado el token, debe configurar Prometheus para que comience a recopilar métricas de su instancia de FASTPANEL®.
Abra su archivo de configuración de Prometheus y agregue un nuevo trabajo:
- job_name: "fastpanel2"
scheme: https
static_configs:
- targets: ["$IP:8888"]
metrics_path: /api/metrics
tls_config:
insecure_skip_verify: true
bearer_token: I_AM_TOKEN
scrape_interval: 60s- job_name — un nombre personalizado para el trabajo
- targets — la dirección IP y el puerto de su servidor FASTPANEL®. Reemplace
$IPcon la dirección IP de su servidor - metrics_path — el endpoint de la API desde el que se obtienen las métricas
- bearer_token — reemplácelo con el token generado (metrics_test_token)
- scrape_interval — con qué frecuencia Prometheus debe recopilar las métricas (configurado en 60 segundos en este caso)
Configurar el panel de monitoreo
Después de agregar correctamente su instancia de FASTPANEL® a Prometheus, puede configurar su primer panel para visualizar las métricas recopiladas.
Para importar el panel, siga esta guía.
Ahora Prometheus comenzará a recopilar métricas de su instancia de FASTPANEL®, lo que le permitirá supervisar el rendimiento del sistema en tiempo real.
FASTPANEL