Funcțiile versiunii Extended
- Instalare aplicație Node.js
- FASTPANEL Extended
- Notificări server
- Personalizare brand
- Prometheus
- Statistici email
- Statistici privind utilizarea discului
Node.js
Pe această pagină
FASTPANEL Extended este activată implicit pentru toți utilizatorii. Nu este necesară activarea unei licențe.
Introducere
Node.js este o platformă de server care rulează aplicații scrise în JavaScript.
Mai întâi, trebuie să instalați Node.js:
- Accesați "Setări" -> "Aplicații"
- Faceți clic pe butonul "Instalare" pentru versiunea Node.js necesară
Creați un site web:
- Selectați un șablon pentru un site web Node.js
- Specificați domeniul și parametrii aferenți. În etapa de configurare puteți modifica BD, utilizatorul FTP și Backend-ul
- Încărcați fișierele aplicației în directorul site-ului web
- Pentru a instala dependențele rulați
npm20.15.1 installîn Terminal (este necesară instalarea aplicației ttyd pentru FASTPANEL®)
- Reporniți Node.js accesând tabloul de bord al site-ului și apoi deschizând secțiunea "Servicii".
Framework-ul Express
Folosind framework-ul Express ca exemplu, să creăm un server web simplu:
- Conectați-vă la server prin SSH ca utilizatorul care deține site-ul (puteți folosi aplicația ttyd pentru FASTPANEL®)
- Creați un fișier
app.jsîn directorul site-ului web și completați-l cu următorul cod:
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}`);
});
- În directorul site-ului web, rulați comanda pentru a instala express
npm20.15.1 install express- Accesați tabloul de bord al site-ului, apoi secțiunea Servicii
- Reporniți serviciul
- Verificați site-ul web
Docusaurus
Folosind aplicația web Docusaurus ca exemplu, să configurăm setările:
- Conectați-vă la server prin SSH ca utilizatorul care deține site-ul (puteți folosi aplicația ttyd pentru FASTPANEL®)
- În directorul site-ului web, rulați instalarea Docusaurus
npx20.15.1 create-docusaurus -j ./docs-
Când vi se cere să selectați un șablon, răspundeți classic (recommended)
-
După instalare, înlocuiți o linie din fișierul
docs/package.json
"start": "docusaurus start",
# replace with
"start": "docusaurus start --port $SERVICE_PORT",$SERVICE_PORT este o variabilă de sistem setată în FASTPANEL®
-
În panoul de control, accesați "setările site-ului" -> "Backend"
-
Selectați handlerul Standalone sau PM2.
-
Alegeți versiunea Node.js dorită.
-
Specificați folderul de lucru
docs -
În câmpul Comandă de lansare, introduceți:
npm run start -
Salvați. Așteptați compilarea aplicației (informațiile vor apărea în jurnale). Verificați site-ul web
Next.js
Folosind Next.js cu Node.js 20.19 ca exemplu, să creăm un server web simplu:
- Conectați-vă la server prin SSH ca utilizatorul care deține site-ul web (puteți folosi și aplicația ttyd în FASTPANEL®).
- În directorul site-ului web, rulați comanda de inițializare a proiectului:
yarn20.19.4 init -y
yarn20.19.4 add next react react-dom- Adăugați un bloc scripts în fișierul
package.json:
"scripts": {
"dev": "next dev -p $SERVICE_PORT",
"build": "next build",
"start": "next start -p $SERVICE_PORT"
}- Creați un director
pagesși, în interiorul acestuia, adăugați un fișier numitindex.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- Rulați build-ul proiectului.
yarn20.19.4 build- În panoul de control, accesați "setările site-ului" -> "Backend"
- Selectați handlerul Standalone sau PM2.
- Alegeți versiunea Node.js dorită.
- În câmpul Comandă de lansare, introduceți:
yarn run start. - Salvați. Așteptați compilarea aplicației (informațiile vor apărea în jurnale). Verificați site-ul web
Informații suplimentare
În modul Standalone, este lansat un proces Node.js pentru a executa scripturile dvs.
În modul PM2, managerul de procese PM2 este utilizat pentru a gestiona procesele Node.js, jurnalele și încărcarea sistemului.
Acest mod vă permite, de asemenea, să specificați numărul de workeri — adică numărul de procese Node.js care gestionează cererile primite de server.
În plus, acest mod oferă opțiunea Enable file watch — PM2 repornește automat aplicația dvs. când un fișier este modificat în directorul curent sau în subdirectoarele sale. Rețineți că acest mod introduce încărcare suplimentară asupra sistemului și nu este recomandat pentru mediile de producție.
În mod similar, puteți configura aplicația dacă aceasta necesită YARN în loc de NPM
Puteți instala dependențele proiectului dvs. listate în package.json folosind YARN sau NPM direct din FASTPANEL®. Pentru a face acest lucru, deschideți cardul site-ului web și accesați secțiunea Servicii:
Jurnale
O aplicație Node.js poate genera jurnale. În FASTPANEL®, acestea se află în tabloul de bord al site-ului, în secțiunea Jurnale, sub fila "Jurnal Backend"
Comenzi de consolă
După instalarea Node.js în FASTPANEL®, utilizatorii pot lucra cu proiectele lor folosind comenzi de consolă precum:
- pm2
- yarn20.15.1
- npx20.15.1
- npm20.15.1
- node20.15.1
Exemplu:
$ 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 │
└────┴─────────────┴─────────────┴─────────┴─────────┴──────────┴────────┴──────┴───────────┴──────────┴──────────┴──────────┴──────────┘Fiecare nume de comandă include numărul versiunii de Node.js care a fost instalată. În acest exemplu, versiunea disponibilă este Node.js 20.15.1.
FASTPANEL Extended
FASTPANEL Extended este activată implicit pentru toți utilizatorii. Nu este necesară activarea unei licențe.
Notificări server
Pe această pagină
FASTPANEL Extended este activată implicit pentru toți utilizatorii. Nu este necesară activarea unei licențe.
FASTPANEL® permite monitorizarea principalelor metrici ale serverului: încărcarea CPU, Load Average 5, utilizarea discului și consumul de RAM. Când o metrică depășește pragul său, alertele sunt trimise automat către Telegram sau Slack. Configurarea se află în „Setări” → „Notificări”.
Acest articol explică modul de configurare a canalelor de livrare și configurarea parametrilor notificărilor, inclusiv pragurile și declanșatoarele.
Configurarea canalului
Telegram
- Creați un bot nou folosind botul oficial Telegram @BotFather. Accesați linkul și faceți clic pe butonul „Start”
- Introduceți
/newbotși apăsați Enter. - Introduceți numele dorit pentru botul dvs. și apăsați Enter.
- Introduceți numele de utilizator dorit pentru botul dvs. Acesta trebuie să se termine cu
bot, apoi apăsați Enter. - Veți primi un mesaj care începe cu:
Done! Congratulations on your new bot. - Faceți clic pe linia albastră de după
Use this token to access the HTTP API:(estompată în captură) pentru a copia tokenul API al botului dvs. în clipboard. Păstrați tokenul în siguranță, deoarece oricine îl are vă poate controla botul
Tokenul API este stocat în @BotFather. Dacă îl uitați, trimiteți comanda /mybots, selectați botul dvs. și faceți clic pe butonul „API Token”.
- Deschideți FASTPANEL® și navigați la „Setări” → „Notificări”.
- Faceți clic pe butonul „Create channel”
- Completați următoarele câmpuri:
- Name — Introduceți un nume pentru canal, pentru a-l distinge vizual
- Channel — Alegeți „Telegram”
- Bot token — Lipiți tokenul botului copiat la pasul 6
- Problem period — Setați intervalul de timp (în minute) după care va fi trimisă o notificare dacă problema persistă. Valoarea minimă este de 1 minut
- Notification repeat interval — Setați intervalul dintre notificările consecutive pentru aceeași problemă
- Notify about solved problems — Activați această opțiune pentru a primi o notificare atunci când problema este rezolvată
- Add basic triggers — Activați această opțiune pentru a crea automat declanșatoare pentru toate unitățile, RAM și CPU
- Faceți clic pe butonul „Save”.
- Pe următorul ecran, faceți clic pe butonul „Invite” pentru a vă invita botul în chat sau în chatul de grup
- Se va deschide un link într-o filă nouă. Confirmați redirecționarea către aplicația Telegram Desktop
- Faceți clic pe butonul „Start” pentru a vă activa botul
- Pentru a verifica dacă configurarea este corectă, reveniți la fila FASTPANEL® și faceți clic pe butonul cu avionul de hârtie
- Dacă totul este configurat corect, o notificare de test va fi trimisă în chatul cu botul dvs
- Pentru a ajusta ulterior setările canalului, faceți clic pe pictograma creion de lângă canal
- Mai jos este un exemplu de notificare generată atunci când este activat un declanșator
Slack
- Autentificați-vă în contul dvs. și creați o aplicație Slack prin pagina de aplicații.
- Selectați "From scratch".
- Introduceți un App Name, alegeți spațiul de lucru în care va fi creată aplicația și faceți clic pe „Create app”.
- În secțiunea „Features”, deschideți „Incoming Webhooks” și activați funcția
- În partea de jos a aceleiași pagini, faceți clic pe „Add New Webhook”
- Pe următorul ecran, selectați canalul în care vor fi trimise notificările. Se recomandă crearea unui canal dedicat pentru alerte. Apoi faceți clic pe „Allow”.
- Veți fi redirecționat înapoi la pagina webhook-urilor. Derulați în jos și faceți clic pe „Copy” pentru a copia URL-ul webhook-ului
- Deschideți FASTPANEL® și navigați la „Setări” → „Notificări”.
- Faceți clic pe butonul „Create channel”
- Completați următoarele câmpuri:
- Name — Introduceți un nume pentru canal, pentru a-l distinge vizual
- Channel — Alegeți „Slack”
- Webhook url — Lipiți URL-ul webhook-ului copiat la pasul 7
- Problem period — Setați intervalul de timp (în minute) după care va fi trimisă o notificare dacă problema persistă. Valoarea minimă este de 1 minut
- Notification repeat interval — Setați intervalul dintre notificările consecutive pentru aceeași problemă
- Notify about solved problems — Activați această opțiune pentru a primi o notificare atunci când problema este rezolvată
- Add basic triggers — Activați această opțiune pentru a crea automat declanșatoare pentru toate unitățile, RAM și CPU
- Faceți clic pe butonul „Save”.
- Pentru a verifica dacă configurarea este corectă, faceți clic pe butonul cu avionul de hârtie
- Dacă totul este configurat corect, o notificare de test va fi trimisă în canalul selectat la pasul 6
- Pentru a ajusta ulterior setările canalului, faceți clic pe pictograma creion de lângă canal
- Mai jos este un exemplu de notificare generată atunci când este activat un declanșator
Configurarea declanșatoarelor
Pentru a configura declanșatoarele, faceți clic pe pictograma rotiță din rândul canalului pe care doriți să îl editați
În secțiunea deschisă, puteți:
- Dezactiva declanșatoarele inutile folosind comutatorul din stânga.
- Crea un nou declanșator de unul dintre următoarele tipuri: CPU, Disk (pentru fiecare disc individual), Load Average 5 (încărcarea medie a sistemului în ultimele 5 minute), RAM.
- Edita declanșatoarele existente
Pragurile pentru CPU, Disk și RAM sunt setate în procente. Pragul pentru Load Average 5 este setat în valori întregi.
Ca regulă generală, o valoare normală pentru Load Average 5 este aproximativ egală cu numărul de nuclee CPU de pe server sau de până la două ori acest număr.
Personalizarea brandului
Pe această pagină
Secțiunea Branding din FASTPANEL® permite personalizarea aspectului vizual și a stilului panoului de control. Acest meniu se află în "Setări" → "Principal" → "Branding".
Scheme de culori
Accesați fila "Scheme de culori" pentru a modifica tema principală de culoare a panoului. Alegeți dintr-o varietate de palete de culori predefinite (de ex., albastru, portocaliu, roșu, verde).
Ajustați Tema:
- Deschisă: Utilizați o temă luminoasă
- Întunecată: Comutați la un mod întunecat
- Ca pe dispozitiv: Se adaptează automat la setările dispozitivului utilizatorului
Personalizarea logo-ului
Fila "Logo" permite încărcarea unui logo personalizat pentru diferite zone ale panoului.
Ecran de autentificare
Se pot încărca logo-uri separate pentru temele Deschisă și Întunecată.
Utilizați butonul Încărcare pentru a adăuga un logo nou sau Resetare pentru a reveni la cel implicit.
- Formate acceptate: jpeg, png, svg, webp
- Rezoluție maximă: 256x100 pixeli
- Dimensiune maximă a fișierului: 5 MB
Logo antet
Afișat în antetul panoului de control.
- Formate acceptate: jpeg, png, svg, webp
- Rezoluție maximă: 200x22 pixeli
- Dimensiune maximă a fișierului: 5 MB
Personalizarea faviconului
Fila "Favicon" permite încărcarea unui favicon, afișat în filele browserului și în rezultatele căutării.
Utilizați butonul Încărcare pentru a adăuga un favicon sau Resetare pentru a reveni la cel implicit.
- Format acceptat: ico
- Dimensiune maximă a fișierului: 1 MB
Personalizarea linkurilor
Fila "Linkuri" oferă câmpuri pentru personalizarea linkurilor din meniul lateral.
- Bază de cunoștințe: URL pentru accesarea bazei de cunoștințe
După modificarea linkurilor, faceți clic pe Salvare pentru a aplica modificările.
Prometheus
Pe această pagină
FASTPANEL Extended este activată implicit pentru toți utilizatorii. Nu este necesară activarea unei licențe.
Integrarea FASTPANEL cu Prometheus pentru colectarea metricilor
FASTPANEL® acceptă acum integrarea cu Prometheus pentru colectarea metricilor de sistem. Acest ghid vă va conduce prin pașii necesari pentru a adăuga instanța dvs. FASTPANEL® în Prometheus, permițându-vă să colectați și să monitorizați metricile de sistem în timp real.
Creați un token
Pentru a permite Prometheus să colecteze metrici, trebuie să creați un token special cu acces limitat:
-
Conectați-vă la serverul dvs. FASTPANEL® prin SSH.
-
Rulați următoarea comandă pentru a crea un token:
mogwai users tokens add -n metrics_test_token -s read_only -s metrics_only- metrics_test_token este un nume personalizat pentru token; puteți alege orice nume
- Tokenului i se vor acorda următoarele scope-uri:
- read_only — acces doar pentru citire
- metrics_only — acces restricționat la metrici
Adăugați un job în Prometheus
Odată ce tokenul este creat, trebuie să configurați Prometheus pentru a începe să colecteze metrici din instanța dvs. FASTPANEL®.
Deschideți fișierul de configurare Prometheus și adăugați un job 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 nume personalizat pentru job
- targets — adresa IP și portul serverului dvs. FASTPANEL®. Înlocuiți
$IPcu adresa IP a serverului dvs - metrics_path — endpoint-ul API de unde se preiau metricile
- bearer_token — înlocuiți aceasta cu tokenul generat de dvs. (metrics_test_token)
- scrape_interval — cât de des trebuie Prometheus să colecteze metricile (setat la 60 de secunde în acest caz)
Configurați tabloul de bord de monitorizare
După ce ați adăugat cu succes instanța dvs. FASTPANEL® în Prometheus, puteți configura primul dvs. tablou de bord pentru a vizualiza metricile colectate.
Pentru a importa tabloul de bord, urmați acest ghid.
Acum Prometheus va începe să colecteze metrici din instanța dvs. FASTPANEL®, permițându-vă să monitorizați performanța sistemului în timp real.
Statistici email
Pe această pagină
FASTPANEL Extended este activată implicit pentru toți utilizatorii. Nu este necesară activarea unei licențe.
FASTPANEL® include o funcție Statistici email care vă permite să monitorizați ușor activitatea emailurilor trimise pentru un întreg domeniu sau pentru căsuțe poștale individuale. Puteți vedea rapid câte mesaje au fost trimise, livrate sau respinse și puteți consulta coduri de eroare SMTP detaliate, împreună cu recomandări care explică de ce anumite emailuri au fost respinse.
Configurați colectarea automată a statisticilor
- Pentru a activa colectarea automată a statisticilor emailurilor, navigați la "Setări" → "Email" → "Statistici" și activați opțiunea "Activează colectarea statisticilor".
Dacă preferați să nu colectați date automat, dezactivați această opțiune. Apoi va trebui să faceți clic manual pe butonul "Actualizează" din vizualizarea statisticilor (vedeți secțiunea următoare) pentru a reîmprospăta datele.
-
Puteți defini cât de des sunt actualizate automat statisticile — de la fiecare 1 oră până la fiecare 24 de ore.
-
Pentru a salva setările, nu uitați să faceți clic pe butonul "Salvează".
Vizualizarea statisticilor
Pentru a vizualiza statisticile, navigați la "Gestionare" → "Email" și faceți clic pe pictograma graficului de lângă domeniul pe care doriți să îl analizați.
Vizualizarea statisticilor este împărțită în trei secțiuni principale, descrise în detaliu mai jos.
Graficul statisticilor
Afișează numărul total de mesaje trimise, livrate și respinse în perioada de timp selectată. Graficul vă ajută să identificați dintr-o privire tendințele și problemele de livrare.
Puteți personaliza datele afișate prin:
-
Selectarea unui domeniu de email.
-
Selectarea statisticilor pentru întregul domeniu sau pentru o anumită căsuță poștală.
-
Alegerea intervalului de timp pentru raport — de la ultimele 24 de ore până la ultima lună.
-
Făcând clic pe butonul "Actualizează" pentru a reîmprospăta manual statisticile și a prelua cele mai recente date.
Principalele motive de respingere
Listează cele mai frecvente cauze ale eșecurilor de livrare a mesajelor, împreună cu codurile de eroare SMTP corespunzătoare. Acest lucru vă permite să înțelegeți și să remediați problemele recurente.
Evenimente de eroare la trimitere
Oferă informații detaliate despre fiecare mesaj respins sau nelivrat, împreună cu acțiuni recomandate pentru rezolvarea problemelor.
Pentru fiecare înregistrare, sunt afișate următoarele detalii:
-
Dată/Oră — momentul exact în care a avut loc încercarea de livrare
-
ID coadă — identificatorul unic al mesajului în coada de emailuri
-
De la / Domeniu expeditor / Către — adresele expeditorului și destinatarului, precum și domeniul de origine
-
Cod SMTP — codul de răspuns returnat de serverul de email al destinatarului (de exemplu, 550-5.7.26)
-
Recomandare — o scurtă explicație a problemei și o acțiune recomandată (de ex., „Mesaj respins de Gmail: autentificare SPF/DKIM lipsă sau eșuată”)
-
Detaliu — textul complet al răspunsului SMTP, care poate include un link către documentație externă de la serverul destinatarului (de exemplu, paginile de asistență Gmail)
-
Cod necunoscut — indică dacă răspunsul SMTP nu a putut fi clasificat
-
Octeți — dimensiunea mesajului email
-
Număr de reîncercări — numărul de încercări de livrare efectuate înainte ca mesajul să fie respins definitiv
-
Ultima încercare — marcajul temporal al încercării finale de livrare
-
Scor spam — rezultatul evaluării spamului, dacă este cazul
Aceste date oferă o imagine de ansamblu cuprinzătoare asupra problemelor de livrare la trimitere, ajutându-vă să diagnosticați probleme de autentificare, reputație sau configurare.
Statistici privind utilizarea discului
FASTPANEL Extended este activată implicit pentru toți utilizatorii. Nu este necesară activarea unei licențe.
FASTPANEL® include o funcție Statistici privind utilizarea discului care îți permite să vezi rapid ce fișiere și directoare consumă spațiu în directoarele utilizatorilor site-urilor tale.
Pentru a utiliza această funcție, deschide "Management" → "File Manager" și fă clic pe pictograma rotundă din colțul din dreapta sus
Pe ecranul următor, vei vedea statistici detaliate privind utilizarea discului, inclusiv Directoare, Top fișiere mari și Statistici după extensie.
- Fă clic pe pictograma dosarului din colțul din dreapta sus pentru a reveni la managerul de fișiere.
- Fă clic pe pictograma de reîmprospătare (săgeți circulare) din colțul din dreapta sus pentru a reîncărca datele.
- Fă clic pe numele de utilizator din colțul din stânga sus pentru a comuta între directoarele home ale diferiților utilizatori; statisticile se vor actualiza în consecință.
FASTPANEL