FASTPANELWIKI

Funzionalità di Extended

Node.js

In questa pagina
informazione

FASTPANEL Extended è abilitata per impostazione predefinita per tutti gli utenti. Non è necessario attivare una licenza.

Introduzione

Node.js è una piattaforma server che esegue applicazioni scritte in JavaScript.

Per prima cosa, devi installare Node.js:

  • Vai a "Settings" -> "Applications"
  • Fai clic sul pulsante "Install" per la versione di Node.js richiesta

Crea un sito web:

  • Seleziona un modello per un sito web Node.js
  • Specifica il dominio e i parametri correlati. Nella fase di configurazione puoi modificare il DB, l'utente FTP e il Backend
  • Carica i file dell'applicazione nella directory del sito web
  • Per installare le dipendenze, esegui npm20.15.1 install nel Terminale (è necessario installare l'applicazione ttyd per FASTPANEL®)
  • Riavvia Node.js andando nella dashboard del sito e quindi aprendo la sezione "Services".

Framework Express

Usando il framework Express come esempio, creiamo un semplice server web:

  • Connettiti al server tramite SSH come utente proprietario del sito (puoi usare l'applicazione ttyd per FASTPANEL®)
  • Crea un file app.js nella directory del sito web e inserisci il codice seguente:
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}`);
});
  • Nella directory del sito web, esegui il comando per installare express
npm20.15.1 install express
  • Vai alla dashboard del sito, quindi alla sezione Services
  • Riavvia il servizio
  • Controlla il sito web

Docusaurus

Usando l'applicazione web Docusaurus come esempio, configuriamo le impostazioni:

  • Connettiti al server tramite SSH come utente proprietario del sito (puoi usare l'applicazione ttyd per FASTPANEL®)
  • Nella directory del sito web, esegui l'installazione di Docusaurus
npx20.15.1 create-docusaurus -j ./docs
  • Quando ti viene chiesto di selezionare un modello, rispondi classic (recommended)

  • Dopo l'installazione, sostituisci una riga nel file docs/package.json

"start": "docusaurus start",
# replace with 
"start": "docusaurus start --port $SERVICE_PORT",

$SERVICE_PORT è una variabile di sistema impostata in FASTPANEL®

  • Nel pannello di controllo, vai a "site settings" -> "Backend"

  • Seleziona il gestore Standalone o PM2.

  • Scegli la versione di Node.js desiderata.

  • Specifica la cartella di lavoro docs

  • Nel campo Launch command, inserisci: npm run start

  • Salva. Attendi la compilazione dell'applicazione (le informazioni appariranno nei log). Controlla il sito web

Next.js

Usando Next.js con Node.js 20.19 come esempio, creiamo un semplice server web:

  • Connettiti al server tramite SSH come utente proprietario del sito web (puoi anche usare l'applicazione ttyd in FASTPANEL®).
  • Nella directory del sito web, esegui il comando di inizializzazione del progetto:
yarn20.19.4 init -y
yarn20.19.4 add next react react-dom
  • Aggiungi un blocco scripts al file package.json:
"scripts": {
  "dev": "next dev -p $SERVICE_PORT",
  "build": "next build",
  "start": "next start -p $SERVICE_PORT"
}
  • Crea una directory pages e al suo interno aggiungi un file chiamato index.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
  • Esegui la build del progetto.
yarn20.19.4 build
  • Nel pannello di controllo, vai a "site settings" -> "Backend"
  • Seleziona il gestore Standalone o PM2.
  • Scegli la versione di Node.js desiderata.
  • Nel campo Launch command, inserisci: yarn run start.
  • Salva. Attendi la compilazione dell'applicazione (le informazioni appariranno nei log). Controlla il sito web

Informazioni aggiuntive

In modalità Standalone, viene avviato un processo Node.js per eseguire i tuoi script.

In modalità PM2, viene utilizzato il gestore di processi PM2 per gestire i processi Node.js, i log e il carico di sistema.
Questa modalità ti consente anche di specificare il numero di worker, cioè il numero di processi Node.js che gestiscono le richieste in arrivo al server.
Inoltre, questa modalità fornisce l'opzione Enable file watch — PM2 riavvia automaticamente la tua applicazione quando un file viene modificato nella directory corrente o nelle sue sottodirectory. Tieni presente che questa modalità introduce un carico di sistema aggiuntivo e non è consigliata per gli ambienti di produzione.

Allo stesso modo, puoi configurare l'applicazione se richiede YARN invece di NPM

Puoi installare le dipendenze del tuo progetto elencate in package.json usando YARN o NPM direttamente da FASTPANEL®. Per farlo, apri la scheda del sito web e vai alla sezione Services:

Log

Un'applicazione Node.js può generare log. In FASTPANEL®, si trovano nella dashboard del sito, nella sezione Logs, nella scheda "Backend log"

Comandi della console

Dopo aver installato Node.js in FASTPANEL®, gli utenti possono lavorare con i propri progetti usando comandi della console come:

  • pm2
  • yarn20.15.1
  • npx20.15.1
  • npm20.15.1
  • node20.15.1

Esempio:

$ 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 │
└────┴─────────────┴─────────────┴─────────┴─────────┴──────────┴────────┴──────┴───────────┴──────────┴──────────┴──────────┴──────────┘

Ogni nome di comando include il numero di versione di Node.js installato. In questo esempio, la versione disponibile è Node.js 20.15.1.

FASTPANEL Extended

FASTPANEL Extended è abilitata per impostazione predefinita per tutti gli utenti. Non è necessario attivare una licenza.

Notifiche del server

In questa pagina
informazione

FASTPANEL Extended è abilitata per impostazione predefinita per tutti gli utenti. Non è necessario attivare una licenza.

FASTPANEL® consente di monitorare le metriche chiave del server: carico della CPU, Load Average 5, utilizzo del disco e consumo della RAM. Quando una metrica supera la sua soglia, gli avvisi vengono inviati automaticamente a Telegram o Slack. La configurazione si trova in "Impostazioni" → "Notifiche".

Questo articolo spiega come configurare i canali di consegna e impostare i parametri di notifica, incluse soglie e trigger.

Configurazione del canale

Telegram

  1. Crea un nuovo bot utilizzando il bot ufficiale di Telegram @BotFather. Segui il link e fai clic sul pulsante "Start"
  1. Digita /newbot e premi Invio.
  2. Inserisci il nome desiderato per il tuo bot e premi Invio.
  3. Inserisci il nome utente desiderato per il tuo bot. Deve terminare con bot, quindi premi Invio.
  4. Riceverai un messaggio che inizia con:
    Done! Congratulations on your new bot.
  5. Fai clic sulla riga blu dopo Use this token to access the HTTP API: (sfocata nello screenshot) per copiare il token API del tuo bot negli appunti. Mantieni il token al sicuro, poiché chiunque ne sia in possesso può controllare il tuo bot
nota

Il token API è memorizzato in @BotFather. Se lo dimentichi, invia il comando /mybots, seleziona il tuo bot e fai clic sul pulsante "API Token".

  1. Apri FASTPANEL® e vai a "Impostazioni" → "Notifiche".
  2. Fai clic sul pulsante "Create channel"
  1. Compila i seguenti campi:
  • Name — Inserisci un nome per il canale per distinguerlo visivamente
  • Channel — Scegli "Telegram"
  • Bot token — Incolla il token del bot copiato nel passaggio 6
  • Problem period — Imposta l'intervallo di tempo (in minuti) dopo il quale verrà inviata una notifica se il problema persiste. Il valore minimo è 1 minuto
  • Notification repeat interval — Imposta l'intervallo tra notifiche consecutive per lo stesso problema
  • Notify about solved problems — Abilita questa opzione per ricevere una notifica quando il problema viene risolto
  • Add basic triggers — Abilita questa opzione per creare automaticamente trigger per tutte le unità, la RAM e la CPU
  1. Fai clic sul pulsante "Save".
  2. Nella schermata successiva, fai clic sul pulsante "Invite" per invitare il tuo bot nella chat o nella chat di gruppo
  1. Si aprirà un link in una nuova scheda. Conferma il reindirizzamento all'applicazione Telegram Desktop
  1. Fai clic sul pulsante "Start" per attivare il tuo bot
  1. Per verificare che la configurazione sia corretta, torna alla scheda di FASTPANEL® e fai clic sul pulsante con l'aeroplanino di carta
  1. Se tutto è configurato correttamente, verrà inviata una notifica di prova alla chat con il tuo bot
  1. Per modificare in seguito le impostazioni del canale, fai clic sull'icona della matita accanto al canale
  1. Di seguito è riportato un esempio di notifica generata quando viene attivato un trigger

Slack

  1. Accedi al tuo account e crea un'app Slack tramite la pagina delle app.
  2. Seleziona "From scratch".
  3. Inserisci un App Name, scegli lo spazio di lavoro in cui verrà creata l'app e fai clic su “Create app”.
  4. Nella sezione “Features”, apri “Incoming Webhooks” e abilita la funzionalità
  1. In fondo alla stessa pagina, fai clic su “Add New Webhook”
  1. Nella schermata successiva, seleziona il canale al quale verranno inviate le notifiche. Si consiglia di creare un canale dedicato agli avvisi. Quindi fai clic su “Allow”.
  2. Verrai reindirizzato nuovamente alla pagina dei webhook. Scorri verso il basso e fai clic su “Copy” per copiare l'URL del webhook
  1. Apri FASTPANEL® e vai a "Impostazioni" → "Notifiche".
  2. Fai clic sul pulsante "Create channel"
  1. Compila i seguenti campi:
  • Name — Inserisci un nome per il canale per distinguerlo visivamente
  • Channel — Scegli "Slack"
  • Webhook url — Incolla l'URL del webhook copiato nel passaggio 7
  • Problem period — Imposta l'intervallo di tempo (in minuti) dopo il quale verrà inviata una notifica se il problema persiste. Il valore minimo è 1 minuto
  • Notification repeat interval — Imposta l'intervallo tra notifiche consecutive per lo stesso problema
  • Notify about solved problems — Abilita questa opzione per ricevere una notifica quando il problema viene risolto
  • Add basic triggers — Abilita questa opzione per creare automaticamente trigger per tutte le unità, la RAM e la CPU
  1. Fai clic sul pulsante "Save".
  2. Per verificare che la configurazione sia corretta, fai clic sul pulsante con l'aeroplanino di carta
  1. Se tutto è configurato correttamente, verrà inviata una notifica di prova al canale selezionato nel passaggio 6
  1. Per modificare in seguito le impostazioni del canale, fai clic sull'icona della matita accanto al canale
  1. Di seguito è riportato un esempio di notifica generata quando viene attivato un trigger

Configurazione dei trigger

Per configurare i trigger, fai clic sull'icona ingranaggio nella riga del canale che desideri modificare

Nella sezione aperta, puoi:

  1. Disabilitare i trigger non necessari utilizzando l'interruttore a sinistra.
  2. Creare un nuovo trigger di uno dei seguenti tipi: CPU, Disk (per ogni disco singolarmente), Load Average 5 (carico medio del sistema negli ultimi 5 minuti), RAM.
  3. Modificare i trigger esistenti

Le soglie per CPU, Disk e RAM sono impostate in percentuali. La soglia per Load Average 5 è impostata in valori interi.

nota

Come regola generale, un valore normale di Load Average 5 è approssimativamente uguale al numero di core della CPU sul server, o fino al doppio di tale numero.

Personalizzazione del marchio

In questa pagina

La sezione Branding in FASTPANEL® consente di personalizzare l'aspetto visivo e lo stile del pannello di controllo. Questo menu si trova in "Impostazioni" → "Principale" → "Branding".

Schemi di colore

Vai alla scheda "Schemi di colore" per modificare il tema colore principale del pannello. Scegli tra una varietà di tavolozze di colori predefinite (ad es. blu, arancione, rosso, verde).

Regola il Tema:

  • Chiaro: Usa un tema chiaro
  • Scuro: Passa alla modalità scura
  • Come sul dispositivo: Si adatta automaticamente alle impostazioni del dispositivo dell’utente

La scheda "Logo" consente di caricare un logo personalizzato per diverse aree del pannello.

Schermata di accesso
È possibile caricare loghi separati per i temi Chiaro e Scuro.
Usa il pulsante Carica per aggiungere un nuovo logo oppure Reimposta per ripristinare quello predefinito.

  • Formati supportati: jpeg, png, svg, webp
  • Risoluzione massima: 256x100 pixel
  • Dimensione massima del file: 5 MB

Logo dell'intestazione
Visualizzato nell'intestazione del pannello di controllo.

  • Formati supportati: jpeg, png, svg, webp
  • Risoluzione massima: 200x22 pixel
  • Dimensione massima del file: 5 MB

Personalizzazione della favicon

La scheda "Favicon" consente di caricare una favicon, visualizzata nelle schede del browser e nei risultati di ricerca.
Usa il pulsante Carica per aggiungere una favicon oppure Reimposta per ripristinare quella predefinita.

  • Formato supportato: ico
  • Dimensione massima del file: 1 MB

La scheda "Link" fornisce i campi per personalizzare i link nel menu laterale.

  • Base di conoscenza: URL per accedere alla base di conoscenza

Dopo aver modificato i link, fai clic su Salva per applicare le modifiche.

Prometheus

In questa pagina
informazione

FASTPANEL Extended è abilitata per impostazione predefinita per tutti gli utenti. Non è necessario attivare una licenza.

Integrazione di FASTPANEL con Prometheus per la raccolta delle metriche

FASTPANEL® ora supporta l'integrazione con Prometheus per la raccolta delle metriche di sistema. Questa guida ti illustrerà i passaggi necessari per aggiungere la tua istanza di FASTPANEL® a Prometheus, consentendoti di raccogliere e monitorare le metriche di sistema in tempo reale.

Creare un token

Per consentire a Prometheus di raccogliere le metriche, devi creare uno speciale token con accesso limitato:

  1. Connettiti al tuo server FASTPANEL® tramite SSH.

  2. Esegui il seguente comando per creare un token:

mogwai users tokens add -n metrics_test_token -s read_only -s metrics_only
  • metrics_test_token è un nome personalizzato per il token; puoi scegliere qualsiasi nome
  • Al token verranno concessi i seguenti ambiti:
    • read_only — accesso in sola lettura
    • metrics_only — accesso limitato alle metriche

Aggiungere un job a Prometheus

Una volta creato il token, devi configurare Prometheus per iniziare a raccogliere le metriche dalla tua istanza di FASTPANEL®.

Apri il file di configurazione di Prometheus e aggiungi un nuovo job:

- 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 nome personalizzato per il job
  • targets — l'indirizzo IP e la porta del tuo server FASTPANEL®. Sostituisci $IP con l'indirizzo IP dei tuoi server
  • metrics_path — l'endpoint API da cui recuperare le metriche
  • bearer_token — sostituiscilo con il token generato (metrics_test_token)
  • scrape_interval — con quale frequenza Prometheus deve raccogliere le metriche (in questo caso impostato su 60 secondi)

Configurare la dashboard di monitoraggio

Dopo aver aggiunto correttamente la tua istanza di FASTPANEL® a Prometheus, puoi configurare la tua prima dashboard per visualizzare le metriche raccolte.

Per importare la dashboard, segui questa guida.

Ora Prometheus inizierà a raccogliere le metriche dalla tua istanza di FASTPANEL®, consentendoti di monitorare le prestazioni del sistema in tempo reale.

Statistiche della posta

In questa pagina
informazione

FASTPANEL Extended è abilitata per impostazione predefinita per tutti gli utenti. Non è necessario attivare una licenza.

FASTPANEL® include una funzionalità di Statistiche della posta che consente di monitorare facilmente l'attività delle email in uscita per un intero dominio o per singole caselle di posta. Puoi vedere rapidamente quanti messaggi sono stati inviati, consegnati o respinti, e visualizzare codici di errore SMTP dettagliati con raccomandazioni che spiegano perché alcune email sono state rifiutate.

Configurare la raccolta automatica delle statistiche

  1. Per abilitare la raccolta automatica delle statistiche della posta, vai su "Impostazioni" → "Posta" → "Statistiche" e attiva l'opzione "Abilita raccolta statistiche".

Se preferisci non raccogliere i dati automaticamente, disabilita questa opzione. Dovrai quindi fare clic manualmente sul pulsante "Aggiorna" nella vista delle statistiche (vedi la sezione successiva) per aggiornare i dati.

  1. Puoi definire con quale frequenza le statistiche vengono aggiornate automaticamente — da ogni 1 ora fino a ogni 24 ore.

  2. Per salvare le impostazioni, non dimenticare di fare clic sul pulsante "Salva".

Vista delle statistiche

Per visualizzare le statistiche, vai su "Gestione" → "Posta" e fai clic sull'icona del grafico accanto al dominio che desideri analizzare.

La vista delle statistiche è suddivisa in tre sezioni principali, descritte in dettaglio di seguito.

Grafico delle statistiche

Mostra il numero totale di messaggi inviati, consegnati e respinti nel periodo di tempo selezionato. Il grafico ti aiuta a identificare a colpo d'occhio tendenze e problemi di consegna.

Puoi personalizzare i dati visualizzati in questi modi:

  1. Selezionando un dominio di posta.

  2. Selezionando le statistiche per l'intero dominio o per una casella di posta specifica.

  3. Scegliendo l'intervallo di tempo per il report — dalle ultime 24 ore fino all'ultimo mese.

  4. Facendo clic sul pulsante "Aggiorna" per aggiornare manualmente le statistiche e recuperare i dati più recenti.

Principali motivi di rimbalzo

Elenca le cause più frequenti degli errori di consegna dei messaggi, insieme ai corrispondenti codici di errore SMTP. Questo ti consente di comprendere e risolvere i problemi ricorrenti.

Eventi di errore in uscita

Fornisce informazioni dettagliate su ciascun messaggio rifiutato o non consegnato, con azioni consigliate per risolvere i problemi.

Per ogni record vengono visualizzati i seguenti dettagli:

  • Data/Ora — l'ora esatta in cui si è verificato il tentativo di consegna

  • ID coda — l'identificatore univoco del messaggio nella coda di posta

  • Da / Dominio mittente / A — indirizzi del mittente e del destinatario, nonché il dominio di origine

  • Codice SMTP — il codice di risposta restituito dal server di posta del destinatario (ad esempio, 550-5.7.26)

  • Consiglio — una breve spiegazione del problema e un'azione consigliata (ad es., “Messaggio rifiutato da Gmail: autenticazione SPF/DKIM mancante o non riuscita”)

  • Dettaglio — il testo completo della risposta SMTP, che può includere un collegamento alla documentazione esterna del server del destinatario (ad esempio, le pagine di supporto di Gmail)

  • Codice sconosciuto — indica se la risposta SMTP non ha potuto essere classificata

  • Byte — dimensione del messaggio email

  • Numero di tentativi — numero di tentativi di consegna effettuati prima che il messaggio venisse rifiutato in modo permanente

  • Ultimo tentativo — timestamp del tentativo finale di consegna

  • Punteggio spam — risultato della valutazione dello spam, se applicabile

Questi dati forniscono una panoramica completa dei problemi di consegna in uscita, aiutandoti a diagnosticare problemi di autenticazione, reputazione o configurazione.

Statistiche sull'utilizzo del disco

informazione

FASTPANEL Extended è abilitata per impostazione predefinita per tutti gli utenti. Non è necessario attivare una licenza.

FASTPANEL® include una funzionalità Statistiche sull'utilizzo del disco che ti consente di vedere rapidamente quali file e directory consumano spazio nelle directory utente dei tuoi siti web.

Per utilizzare questa funzionalità, apri "Management" → "File Manager" e fai clic sull'icona rotonda nell'angolo in alto a destra

Nella schermata successiva vedrai statistiche dettagliate sull'utilizzo del disco, incluse Directories, Top large files e Extension statistics.

  1. Fai clic sull'icona della cartella nell'angolo in alto a destra per tornare al file manager.
  2. Fai clic sull'icona di aggiornamento (frecce circolari) nell'angolo in alto a destra per ricaricare i dati.
  3. Fai clic sul nome utente nell'angolo in alto a sinistra per passare tra le directory home di utenti diversi; le statistiche si aggiorneranno di conseguenza.