Funcions d’Extended
- Estadístiques d'ús del disc
- Estadístiques de correu
- Instal·la l'aplicació Node.js
- FASTPANEL Extended
- Marca blanca
- Notificacions del servidor
- Prometheus
Estadístiques d'ús del disc
FASTPANEL Extended està habilitada per defecte per a tothom. No cal activar cap llicència.
FASTPANEL® inclou una funció d'Estadístiques d'ús del disc que us permet veure ràpidament quins fitxers i directoris consumeixen espai als directoris d'usuari dels vostres llocs web.
Per utilitzar aquesta funció, obriu "Management" → "File Manager" i feu clic a la icona rodona de la cantonada superior dreta
A la pantalla següent, veureu estadístiques detallades d'ús del disc, incloent-hi Directoris, Fitxers grans principals i Estadístiques d'extensions.
- Feu clic a la icona de carpeta de la cantonada superior dreta per tornar al gestor de fitxers.
- Feu clic a la icona d'actualització (fletxes circulars) de la cantonada superior dreta per tornar a carregar les dades.
- Feu clic al nom d'usuari de la cantonada superior esquerra per canviar entre els directoris personals de diferents usuaris; les estadístiques s'actualitzaran en conseqüència.
Estadístiques de correu
En aquesta pàgina
FASTPANEL Extended està habilitada per defecte per a tothom. No cal activar cap llicència.
FASTPANEL® inclou una funció d'Estadístiques de correu que us permet supervisar fàcilment l'activitat dels correus electrònics sortints d'un domini complet o de bústies de correu individuals. Podeu veure ràpidament quants missatges s'han enviat, lliurat o retornat, i consultar codis d'error SMTP detallats amb recomanacions que expliquen per què s'han rebutjat determinats correus electrònics.
Configurar la recopilació automàtica d'estadístiques
- Per activar la recopilació automàtica d'estadístiques de correu, aneu a "Configuració" → "Correu" → "Estadístiques" i activeu l'opció "Activa la recopilació d'estadístiques".
Si preferiu no recopilar dades automàticament, desactiveu aquesta opció. Aleshores haureu de fer clic manualment al botó "Actualitza" a la vista d'estadístiques (vegeu la secció següent) per actualitzar les dades.
-
Podeu definir amb quina freqüència s'actualitzen automàticament les estadístiques, des d'1 hora fins a cada 24 hores.
-
Per desar la configuració, no oblideu fer clic al botó "Desa".
Vista d'estadístiques
Per veure les estadístiques, aneu a "Gestió" → "Correu" i feu clic a la icona del gràfic al costat del domini que vulgueu analitzar.
La vista d'estadístiques es divideix en tres seccions principals, que es descriuen detalladament a continuació.
Gràfic d'estadístiques
Mostra el nombre total de missatges enviats, lliurats i retornats durant el període de temps seleccionat. El gràfic us ajuda a identificar tendències i problemes de lliurament d'un cop d'ull.
Podeu personalitzar les dades mostrades de les maneres següents:
-
Seleccionant un domini de correu.
-
Seleccionant estadístiques per a tot el domini o per a una bústia de correu específica.
-
Triant l'interval de temps de l'informe, des de les últimes 24 hores fins a l'últim mes.
-
Fent clic al botó "Actualitza" per actualitzar manualment les estadístiques i recuperar les dades més recents.
Principals motius de rebot
Enumera les causes més freqüents dels errors de lliurament de missatges, juntament amb els seus codis d'error SMTP corresponents. Això us permet entendre i abordar problemes recurrents.
Esdeveniments d'error sortints
Proporciona informació detallada sobre cada missatge rebutjat o no lliurat, amb accions recomanades per resoldre els problemes.
Per a cada registre, es mostren els detalls següents:
-
Data/Hora — l'hora exacta en què es va produir l'intent de lliurament
-
ID de cua — l'identificador únic del missatge a la cua de correu
-
De / Domini del remitent / A — adreces del remitent i del destinatari, així com el domini d'origen
-
Codi SMTP — el codi de resposta retornat pel servidor de correu del destinatari (per exemple, 550-5.7.26)
-
Consell — una breu explicació del problema i una acció recomanada (p. ex., “Missatge rebutjat per Gmail: autenticació SPF/DKIM absent o fallida”)
-
Detall — el text complet de la resposta SMTP, que pot incloure un enllaç a documentació externa del servidor receptor (per exemple, pàgines d'ajuda de Gmail)
-
Codi desconegut — indica si la resposta SMTP no s'ha pogut classificar
-
Bytes — mida del missatge de correu electrònic
-
Nombre de reintents — nombre d'intents de lliurament fets abans que el missatge fos rebutjat permanentment
-
Últim intent — marca temporal de l'intent final de lliurament
-
Puntuació de correu brossa — resultat de l'avaluació de correu brossa, si escau
Aquestes dades proporcionen una visió general completa dels problemes de lliurament sortint i us ajuden a diagnosticar problemes d'autenticació, reputació o configuració.
Node.js
En aquesta pàgina
FASTPANEL Extended està habilitada per defecte per a tothom. No cal activar cap llicència.
Introducció
Node.js és una plataforma de servidor que executa aplicacions escrites en JavaScript.
Primer, heu d'instal·lar Node.js:
- Aneu a "Configuració" -> "Aplicacions"
- Feu clic al botó "Instal·lar" per a la versió requerida de Node.js
Creeu un lloc web:
- Seleccioneu una plantilla per a un lloc web Node.js
- Especifiqueu el domini i els paràmetres relacionats. A l'etapa de configuració podeu canviar la BD, l'usuari FTP i el Backend
- Pugeu els fitxers de l'aplicació al directori del lloc web
- Per instal·lar les dependències, executeu
npm20.15.1 installal Terminal (cal instal·lar l'aplicació ttyd per a FASTPANEL®)
- Reinicieu Node.js anant al tauler del lloc i després obrint la secció "Serveis".
Framework Express
Utilitzant el framework Express com a exemple, creem un servidor web senzill:
- Connecteu-vos al servidor mitjançant SSH com l'usuari propietari del lloc (podeu utilitzar l'aplicació ttyd per a FASTPANEL®)
- Creeu un fitxer
app.jsal directori del lloc web i ompliu-lo amb el codi següent:
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}`);
});
- Al directori del lloc web, executeu l'ordre per instal·lar express
npm20.15.1 install express- Aneu al tauler del lloc i després a la secció Serveis
- Reinicieu el servei
- Comproveu el lloc web
Docusaurus
Utilitzant l'aplicació web Docusaurus com a exemple, configurem els paràmetres:
- Connecteu-vos al servidor mitjançant SSH com l'usuari propietari del lloc (podeu utilitzar l'aplicació ttyd per a FASTPANEL®)
- Al directori del lloc web, executeu la instal·lació de Docusaurus
npx20.15.1 create-docusaurus -j ./docs-
Quan se us demani que seleccioneu una plantilla, responeu classic (recommended)
-
Després de la instal·lació, substituïu una línia del fitxer
docs/package.json
"start": "docusaurus start",
# replace with
"start": "docusaurus start --port $SERVICE_PORT",$SERVICE_PORT és una variable del sistema establerta a FASTPANEL®
-
Al tauler de control, aneu a "configuració del lloc" -> "Backend"
-
Seleccioneu el gestor Standalone o PM2.
-
Trieu la versió de Node.js desitjada.
-
Especifiqueu la carpeta de treball
docs -
Al camp de l'ordre d'inici, introduïu:
npm run start -
Desa. Espereu que l'aplicació es compili (la informació apareixerà als registres). Comproveu el lloc web
Next.js
Utilitzant Next.js amb Node.js 20.19 com a exemple, creem un servidor web senzill:
- Connecteu-vos al servidor mitjançant SSH com l'usuari propietari del lloc web (també podeu utilitzar l'aplicació ttyd a FASTPANEL®).
- Al directori del lloc web, executeu l'ordre d'inicialització del projecte:
yarn20.19.4 init -y
yarn20.19.4 add next react react-dom- Afegiu un bloc scripts al fitxer
package.json:
"scripts": {
"dev": "next dev -p $SERVICE_PORT",
"build": "next build",
"start": "next start -p $SERVICE_PORT"
}- Creeu un directori
pagesi, a dins, afegiu-hi un fitxer anomenatindex.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- Executeu la compilació del projecte.
yarn20.19.4 build- Al tauler de control, aneu a "configuració del lloc" -> "Backend"
- Seleccioneu el gestor Standalone o PM2.
- Trieu la versió de Node.js desitjada.
- Al camp de l'ordre d'inici, introduïu:
yarn run start. - Desa. Espereu que l'aplicació es compili (la informació apareixerà als registres). Comproveu el lloc web
Informació addicional
En mode Standalone, s'inicia un procés de Node.js per executar els vostres scripts.
En mode PM2, s'utilitza el gestor de processos PM2 per gestionar els processos de Node.js, els registres i la càrrega del sistema.
Aquest mode també us permet especificar el nombre de workers, és a dir, el nombre de processos de Node.js que gestionen les sol·licituds entrants al servidor.
A més, aquest mode proporciona l'opció Enable file watch — PM2 reinicia automàticament la vostra aplicació quan es modifica un fitxer al directori actual o als seus subdirectoris. Tingueu en compte que aquest mode introdueix una càrrega addicional al sistema i no es recomana per a entorns de producció.
De la mateixa manera, podeu configurar l'aplicació si requereix YARN en lloc de NPM
Podeu instal·lar les dependències del vostre projecte que figuren a package.json utilitzant YARN o NPM directament des de FASTPANEL®. Per fer-ho, obriu la targeta del lloc web i aneu a la secció Serveis:
Registres
Una aplicació Node.js pot generar registres. A FASTPANEL®, es troben al tauler del lloc, a la secció Registres, a la pestanya "Registre del Backend"
Ordres de consola
Després d'instal·lar Node.js a FASTPANEL®, els usuaris poden treballar amb els seus projectes utilitzant ordres de consola com ara:
- pm2
- yarn20.15.1
- npx20.15.1
- npm20.15.1
- node20.15.1
Exemple:
$ 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 nom d'ordre inclou el número de versió del Node.js instal·lat. En aquest exemple, la versió disponible és Node.js 20.15.1.
FASTPANEL Extended
FASTPANEL Extended està habilitada per defecte per a tothom. No cal activar cap llicència.
Personalització de la marca blanca
En aquesta pàgina
La secció Marca blanca del FASTPANEL® permet personalitzar l'aparença visual i l'estil del tauler de control. Aquest menú es troba a "Configuració" → "Principal" → "Marca blanca".
Esquemes de colors
Aneu a la pestanya "Esquemes de colors" per canviar el tema de color principal del panell. Trieu entre una varietat de paletes de colors predefinides (p. ex., blau, taronja, vermell, verd).
Ajusteu el Tema:
- Clar: Utilitza un tema clar
- Fosc: Canvia al mode fosc
- Com al dispositiu: S'adapta automàticament a la configuració del dispositiu de l'usuari
Personalització del logotip
La pestanya "Logotip" permet pujar un logotip personalitzat per a diferents àrees del panell.
Pantalla d'inici de sessió
Es poden pujar logotips separats per als temes Clar i Fosc.
Utilitzeu el botó Puja per afegir un logotip nou o Restableix per tornar al valor predeterminat.
- Formats admesos: jpeg, png, svg, webp
- Resolució màxima: 256x100 píxels
- Mida màxima del fitxer: 5 MB
Logotip de la capçalera
Es mostra a la capçalera del tauler de control.
- Formats admesos: jpeg, png, svg, webp
- Resolució màxima: 200x22 píxels
- Mida màxima del fitxer: 5 MB
Personalització del favicon
La pestanya "Favicon" permet pujar un favicon, que es mostra a les pestanyes del navegador i als resultats de cerca.
Utilitzeu el botó Puja per afegir un favicon o Restableix per tornar al valor predeterminat.
- Format admès: ico
- Mida màxima del fitxer: 1 MB
Personalització dels enllaços
La pestanya "Enllaços" proporciona camps per personalitzar els enllaços del menú lateral.
- Base de coneixement: URL per accedir a la base de coneixement
Després de modificar els enllaços, feu clic a Desa per aplicar els canvis.
Notificacions del servidor
En aquesta pàgina
FASTPANEL Extended està habilitada per defecte per a tothom. No cal activar cap llicència.
FASTPANEL® permet supervisar mètriques clau del servidor: càrrega de la CPU, Load Average 5, ús del disc i consum de RAM. Quan una mètrica supera el seu llindar, les alertes s'envien automàticament a Telegram o Slack. La configuració es troba a "Configuració" → "Notificacions".
Aquest article explica com configurar els canals de lliurament i els paràmetres de notificació, inclosos els llindars i els activadors.
Configuració del canal
Telegram
- Creeu un bot nou mitjançant el bot oficial de Telegram @BotFather. Seguiu l'enllaç i feu clic al botó "Start"
- Escriviu
/newboti premeu Retorn. - Introduïu el nom desitjat per al vostre bot i premeu Retorn.
- Introduïu el nom d'usuari desitjat per al vostre bot. Ha d'acabar amb
boti, a continuació, premeu Retorn. - Rebreu un missatge que començarà amb:
Done! Congratulations on your new bot. - Feu clic a la línia blava després de
Use this token to access the HTTP API:(difuminada a la captura de pantalla) per copiar el token de l'API del vostre bot al porta-retalls. Manteniu el token en un lloc segur, ja que qualsevol persona que el tingui pot controlar el vostre bot
El token de l'API s'emmagatzema a @BotFather. Si l'oblideu, envieu l'ordre /mybots, seleccioneu el vostre bot i feu clic al botó "API Token".
- Obriu FASTPANEL® i aneu a "Configuració" → "Notificacions".
- Feu clic al botó "Crea un canal"
- Empleneu els camps següents:
- Nom — Introduïu un nom per al canal per distingir-lo visualment
- Canal — Trieu "Telegram"
- Token del bot — Enganxeu el token del bot copiat al pas 6
- Període del problema — Establiu l'interval de temps (en minuts) després del qual s'enviarà una notificació si el problema persisteix. El valor mínim és 1 minut
- Interval de repetició de la notificació — Establiu l'interval entre notificacions consecutives per al mateix problema
- Notifica sobre problemes resolts — Activeu aquesta opció per rebre una notificació quan el problema es resolgui
- Afegeix activadors bàsics — Activeu aquesta opció per crear automàticament activadors per a totes les unitats, la RAM i la CPU
- Feu clic al botó "Desa".
- A la pantalla següent, feu clic al botó "Convida" per convidar el vostre bot al xat o al xat de grup
- S'obrirà un enllaç en una pestanya nova. Confirmeu la redirecció a l'aplicació Telegram Desktop
- Feu clic al botó "Start" per activar el vostre bot
- Per verificar que la configuració és correcta, torneu a la pestanya de FASTPANEL® i feu clic al botó de l'avió de paper
- Si tot està configurat correctament, s'enviarà una notificació de prova al xat amb el vostre bot
- Per ajustar la configuració del canal més endavant, feu clic a la icona del llapis al costat del canal
- A continuació es mostra un exemple d'una notificació generada quan s'activa un activador
Slack
- Inicieu sessió al vostre compte i creeu una aplicació de Slack mitjançant la pàgina d'aplicacions.
- Seleccioneu "From scratch".
- Introduïu un App Name, trieu l'espai de treball on es crearà l'aplicació i feu clic a “Create app”.
- A la secció “Features”, obriu “Incoming Webhooks” i activeu la funció
- A la part inferior de la mateixa pàgina, feu clic a “Add New Webhook”
- A la pantalla següent, seleccioneu el canal on s'enviaran les notificacions. Es recomana crear un canal dedicat per a les alertes. A continuació, feu clic a “Allow”.
- Se us redirigirà de nou a la pàgina de webhooks. Desplaceu-vos cap avall i feu clic a “Copy” per copiar l'URL del webhook
- Obriu FASTPANEL® i aneu a "Configuració" → "Notificacions".
- Feu clic al botó "Crea un canal"
- Empleneu els camps següents:
- Nom — Introduïu un nom per al canal per distingir-lo visualment
- Canal — Trieu "Slack"
- URL del webhook — Enganxeu l'URL del webhook copiat al pas 7
- Període del problema — Establiu l'interval de temps (en minuts) després del qual s'enviarà una notificació si el problema persisteix. El valor mínim és 1 minut
- Interval de repetició de la notificació — Establiu l'interval entre notificacions consecutives per al mateix problema
- Notifica sobre problemes resolts — Activeu aquesta opció per rebre una notificació quan el problema es resolgui
- Afegeix activadors bàsics — Activeu aquesta opció per crear automàticament activadors per a totes les unitats, la RAM i la CPU
- Feu clic al botó "Desa".
- Per verificar que la configuració és correcta, feu clic al botó de l'avió de paper
- Si tot està configurat correctament, s'enviarà una notificació de prova al canal seleccionat al pas 6
- Per ajustar la configuració del canal més endavant, feu clic a la icona del llapis al costat del canal
- A continuació es mostra un exemple d'una notificació generada quan s'activa un activador
Configuració dels activadors
Per configurar els activadors, feu clic a la icona de l'engranatge a la fila del canal que voleu editar
A la secció oberta, podeu:
- Desactivar els activadors innecessaris mitjançant l'interruptor de l'esquerra.
- Crear un activador nou d'un dels tipus següents: CPU, Disk (per a cada disc individualment), Load Average 5 (càrrega mitjana del sistema durant els darrers 5 minuts), RAM.
- Editar els activadors existents
Els llindars de CPU, Disk i RAM s'estableixen en percentatges. El llindar de Load Average 5 s'estableix en valors enters.
Com a regla general, un valor normal de Load Average 5 és aproximadament igual al nombre de nuclis de CPU del servidor, o fins a dues vegades aquest nombre.
Prometheus
En aquesta pàgina
FASTPANEL Extended està habilitada per defecte per a tothom. No cal activar cap llicència.
Integració de FASTPANEL amb Prometheus per a la recopilació de mètriques
FASTPANEL® ara admet la integració amb Prometheus per recopilar mètriques del sistema. Aquesta guia us guiarà pels passos necessaris per afegir la vostra instància de FASTPANEL® a Prometheus, cosa que us permetrà recopilar i supervisar les mètriques del sistema en temps real.
Crear un testimoni
Per permetre que Prometheus recopili mètriques, heu de crear un testimoni especial amb accés limitat:
-
Connecteu-vos al vostre servidor FASTPANEL® mitjançant SSH.
-
Executeu l'ordre següent per crear un testimoni:
mogwai users tokens add -n metrics_test_token -s read_only -s metrics_only- metrics_test_token és un nom personalitzat per al testimoni; podeu triar qualsevol nom
- Al testimoni se li concediran els àmbits següents:
- read_only — accés de només lectura
- metrics_only — accés restringit a les mètriques
Afegir un treball a Prometheus
Un cop creat el testimoni, heu de configurar Prometheus perquè comenci a recopilar mètriques de la vostra instància de FASTPANEL®.
Obriu el fitxer de configuració de Prometheus i afegiu-hi un treball nou:
- 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 nom personalitzat per al treball
- targets — l'adreça IP i el port del vostre servidor FASTPANEL®. Substituïu
$IPper l'adreça IP dels vostres servidors - metrics_path — el punt de connexió de l'API des d'on obtenir les mètriques
- bearer_token — substituïu-ho pel vostre testimoni generat (metrics_test_token)
- scrape_interval — amb quina freqüència Prometheus ha de recopilar les mètriques (en aquest cas, s'estableix en 60 segons)
Configurar el tauler de supervisió
Després d'afegir correctament la vostra instància de FASTPANEL® a Prometheus, podeu configurar el vostre primer tauler per visualitzar les mètriques recopilades.
Per importar el tauler, seguiu aquesta guia.
Ara Prometheus començarà a recopilar mètriques de la vostra instància de FASTPANEL®, cosa que us permetrà supervisar el rendiment del sistema en temps real.
FASTPANEL