FASTPANELWIKI

Extendedi funktsioonid

Brändingu kohandamine

Sellel lehel

Jaotis Branding rakenduses FASTPANEL® võimaldab kohandada juhtpaneeli visuaalset välimust ja stiili. See menüü asub jaotises "Settings" → "Main" → "Branding".

Värviskeemid

Juhtpaneeli peamise värviteema muutmiseks avage vahekaart "Color schemes". Valige mitmesuguste eelmääratud värvipalettide hulgast (nt sinine, oranž, punane, roheline).

Kohandage Theme-i:

  • Light: kasutage heledat teemat
  • Dark: lülituge tumedale režiimile
  • Like on the device: kohandub automaatselt kasutaja seadme sätetega

Logo kohandamine

Vahekaart "Logo" võimaldab laadida üles kohandatud logo paneeli eri alade jaoks.

Login Screen
Eraldi logosid saab üles laadida teemade Light ja Dark jaoks.
Uue logo lisamiseks kasutage nuppu Upload või vaikimisi seadete taastamiseks nuppu Reset.

  • Toetatud vormingud: jpeg, png, svg, webp
  • Maksimaalne eraldusvõime: 256x100 pikslit
  • Maksimaalne failisuurus: 5 MB

Header Logo
Kuvatakse juhtpaneeli päises.

  • Toetatud vormingud: jpeg, png, svg, webp
  • Maksimaalne eraldusvõime: 200x22 pikslit
  • Maksimaalne failisuurus: 5 MB

Faviconi kohandamine

Vahekaart "Favicon" võimaldab laadida üles faviconi, mida kuvatakse brauseri vahekaartidel ja otsingutulemustes.
Faviconi lisamiseks kasutage nuppu Upload või vaikimisi seadete taastamiseks nuppu Reset.

  • Toetatud vorming: ico
  • Maksimaalne failisuurus: 1 MB

Linkide kohandamine

Vahekaart "Links" pakub välju külgmenüü linkide kohandamiseks.

  • Knowledge base: URL teadmusbaasile juurdepääsuks

Pärast linkide muutmist klõpsake muudatuste rakendamiseks nuppu Save.

E-posti statistika

Sellel lehel
teave

FASTPANEL Extended on kõigile vaikimisi sisse lülitatud. Litsentsi pole vaja aktiveerida.

FASTPANEL® sisaldab funktsiooni E-posti statistika, mis võimaldab teil hõlpsalt jälgida väljaminevate e-kirjade tegevust kogu domeeni või üksikute postkastide lõikes. Saate kiiresti näha, kui palju sõnumeid saadeti, kohale toimetati või tagasi põrkas, ning vaadata üksikasjalikke SMTP veakoode koos soovitustega, mis selgitavad, miks teatud e-kirjad tagasi lükati.

Automaatse statistika kogumise seadistamine

  1. Automaatse e-posti statistika kogumise lubamiseks avage "Seaded" → "E-post" → "Statistika" ja lülitage sisse valik "Luba statistika kogumine".

Kui eelistate andmeid mitte automaatselt koguda, keelake see valik. Seejärel peate andmete värskendamiseks statistika vaates käsitsi klõpsama nuppu "Värskenda" (vt järgmist jaotist).

  1. Saate määrata, kui sageli statistikat automaatselt uuendatakse — alates igast 1 tunnist kuni iga 24 tunnini.

  2. Seadete salvestamiseks ärge unustage klõpsata nupul "Salvesta".

Statistika vaade

Statistika vaatamiseks avage "Haldus" → "E-post" ja klõpsake analüüsitava domeeni kõrval oleval graafikuikoonil.

Statistika vaade on jagatud kolmeks peamiseks jaotiseks, mida kirjeldatakse üksikasjalikult allpool.

Statistikagraafik

Kuvab valitud ajavahemiku jooksul saadetud, kohale toimetatud ja tagasi põrganud sõnumite koguarvu. Graafik aitab teil ühe pilguga tuvastada trende ja kohaletoimetamise probleeme.

Saate kuvatavaid andmeid kohandada järgmiselt:

  1. E-posti domeeni valimine.

  2. Kogu domeeni või konkreetse postkasti statistika valimine.

  3. Aruande ajavahemiku valimine — alates viimasest 24 tunnist kuni viimase kuuni.

  4. Nupu "Värskenda" klõpsamine statistika käsitsi värskendamiseks ja uusimate andmete toomiseks.

Peamised tagasipõrke põhjused

Loetleb sõnumite kohaletoimetamise nurjumiste kõige sagedasemad põhjused koos vastavate SMTP veakoodidega. See võimaldab teil korduvaid probleeme mõista ja lahendada.

Väljaminevate teadete veaüritused

Pakub üksikasjalikku teavet iga tagasi lükatud või kohale toimetamata sõnumi kohta koos soovitatud tegevustega probleemide lahendamiseks.

Iga kirje kohta kuvatakse järgmised üksikasjad:

  • Kuupäev/kellaaeg — täpne aeg, millal kohaletoimetamise katse toimus

  • Queue ID — sõnumi kordumatu identifikaator e-posti järjekorras

  • From / From domain / To — saatja ja adressaadi aadressid ning lähte-domeen

  • SMTP code — vastuvõtja e-posti serveri tagastatud vastusekood (näiteks 550-5.7.26)

  • Advice — probleemi lühike selgitus ja soovitatud tegevus (nt „Gmail lükkas sõnumi tagasi: SPF/DKIM autentimine puudub või ebaõnnestus“)

  • Detail — täielik SMTP vastusetekst, mis võib sisaldada linki vastuvõtja serveri välisele dokumentatsioonile (näiteks Gmaili tugilehed)

  • Unknown code — näitab, kas SMTP vastust ei olnud võimalik klassifitseerida

  • Bytes — e-kirja sõnumi suurus

  • Retry count — kohaletoimetamise katsete arv enne, kui sõnum lõplikult tagasi lükati

  • Last try — viimase kohaletoimetamise katse ajatempel

  • Spam score — rämpsposti hinnangu tulemus, kui see on kohaldatav

Need andmed annavad põhjaliku ülevaate väljaminevate sõnumite kohaletoimetamise probleemidest, aidates teil diagnoosida autentimise, maine või konfiguratsiooniga seotud probleeme.

Kettakasutuse statistika

teave

FASTPANEL Extended on kõigile vaikimisi sisse lülitatud. Litsentsi pole vaja aktiveerida.

FASTPANEL® sisaldab funktsiooni Disk Usage Statistics, mis võimaldab teil kiiresti näha, millised failid ja kataloogid võtavad ruumi teie veebisaitide kasutajakataloogides.

Selle funktsiooni kasutamiseks avage "Management" → "File Manager" ja klõpsake paremas ülanurgas ümmargust ikooni

Järgmisel ekraanil näete üksikasjalikku kettakasutuse statistikat, sealhulgas Directories, Top large files ja Extension statistics.

  1. Failihaldurisse naasmiseks klõpsake paremas ülanurgas kaustaikooni.
  2. Andmete uuesti laadimiseks klõpsake paremas ülanurgas värskendusikooni (ringikujulised nooled).
  3. Erinevate kasutajate kodukataloogide vahel lülitumiseks klõpsake vasakus ülanurgas kasutajanimel; statistika uueneb vastavalt.

Node.js

Sellel lehel
teave

FASTPANEL Extended on kõigile vaikimisi sisse lülitatud. Litsentsi pole vaja aktiveerida.

Sissejuhatus

Node.js on serveriplatvorm, mis käitab JavaScriptis kirjutatud rakendusi.

Kõigepealt peate installima Node.js-i:

  • Minge menüüsse "Settings" -> "Applications"
  • Klõpsake vajaliku Node.js versiooni juures nuppu "Install"

Looge veebisait:

  • Valige Node.js veebisaidi mall
  • Määrake domeen ja seotud parameetrid. Seadistamise etapis saate muuta DB-d, FTP-kasutajat ja Backendit
  • Laadige rakenduse failid üles veebisaidi kataloogi
  • Sõltuvuste installimiseks käivitage Terminalis npm20.15.1 install (selleks on vaja installida ttyd rakendus FASTPANEL® jaoks)
  • Taaskäivitage Node.js, minnes saidi töölauale ja avades seejärel jaotise "Services".

Express raamistik

Loome Express raamistiku näitel lihtsa veebiserveri:

  • Ühenduge serveriga SSH kaudu saidi omanikust kasutajana (võite kasutada ka ttyd rakendust FASTPANEL® jaoks)
  • Looge veebisaidi kataloogis fail app.js ja täitke see järgmise koodiga:
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}`);
});
  • Käivitage veebisaidi kataloogis käsk expressi installimiseks
npm20.15.1 install express
  • Minge saidi töölauale, seejärel jaotisse Services
  • Taaskäivitage teenus
  • Kontrollige veebisaiti

Docusaurus

Seadistame sätted Docusauruse veebirakenduse näitel:

  • Ühenduge serveriga SSH kaudu saidi omanikust kasutajana (võite kasutada ka ttyd rakendust FASTPANEL® jaoks)
  • Käivitage veebisaidi kataloogis Docusauruse installimine
npx20.15.1 create-docusaurus -j ./docs
  • Kui teil palutakse valida mall, vastake classic (recommended)

  • Pärast installimist asendage failis docs/package.json üks rida

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

$SERVICE_PORT on süsteemimuutuja, mis on määratud FASTPANEL®-is

  • Juhtpaneelis minge menüüsse "site settings" -> "Backend"

  • Valige Standalone või PM2 töötleja.

  • Valige soovitud Node.js versioon.

  • Määrake töökataloog docs

  • Väljale Launch command sisestage: npm run start

  • Salvestage. Oodake, kuni rakendus kompileeritakse (teave ilmub logidesse). Kontrollige veebisaiti

Next.js

Kasutades näitena Next.js-i koos Node.js 20.19-ga, loome lihtsa veebiserveri:

  • Ühenduge serveriga SSH kaudu veebisaidi omanikust kasutajana (võite kasutada ka ttyd rakendust FASTPANEL®-is).
  • Käivitage veebisaidi kataloogis projekti lähtestamise käsk:
yarn20.19.4 init -y
yarn20.19.4 add next react react-dom
  • Lisage faili package.json plokk scripts:
"scripts": {
  "dev": "next dev -p $SERVICE_PORT",
  "build": "next build",
  "start": "next start -p $SERVICE_PORT"
}
  • Looge kataloog pages ja lisage selle sisse fail nimega 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
  • Käivitage projekti build.
yarn20.19.4 build
  • Juhtpaneelis minge menüüsse "site settings" -> "Backend"
  • Valige Standalone või PM2 töötleja.
  • Valige soovitud Node.js versioon.
  • Väljale Launch command sisestage: yarn run start.
  • Salvestage. Oodake, kuni rakendus kompileeritakse (teave ilmub logidesse). Kontrollige veebisaiti

Lisateave

Režiimis Standalone käivitatakse teie skriptide täitmiseks Node.js protsess.

Režiimis PM2 kasutatakse Node.js protsesside, logide ja süsteemikoormuse haldamiseks PM2 protsessihaldurit.
See režiim võimaldab määrata ka worker'ite arvu — see tähendab serverisse saabuvate päringute töötlemisega tegelevate Node.js protsesside arvu.
Lisaks pakub see režiim valikut Enable file watch — PM2 taaskäivitab teie rakenduse automaatselt, kui praeguses kataloogis või selle alamkataloogides muudetakse faili. Pange tähele, et see režiim tekitab täiendavat süsteemikoormust ega ole tootmiskeskkondades soovitatav.

Samamoodi saate rakenduse seadistada ka siis, kui see nõuab YARN-i NPM-i asemel

Saate oma projekti package.json-is loetletud sõltuvused installida YARN-i või NPM-i abil otse FASTPANEL®-ist. Selleks avage veebisaidi kaart ja minge jaotisse Services:

Logid

Node.js rakendus võib genereerida logisid. FASTPANEL®-is asuvad need saidi töölaual, jaotises Logs, vahekaardi "Backend log" all

Konsoolikäsklused

Pärast Node.js-i installimist FASTPANEL®-is saavad kasutajad oma projektidega töötada, kasutades selliseid konsoolikäsklusi nagu:

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

Näide:

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

Iga käsu nimi sisaldab installitud Node.js versiooni numbrit. Selles näites on saadaval Node.js versioon 20.15.1.

Prometheus

Sellel lehel
teave

FASTPANEL Extended on kõigile vaikimisi sisse lülitatud. Litsentsi pole vaja aktiveerida.

FASTPANELi integreerimine Prometheusega meetrikate kogumiseks

FASTPANEL® toetab nüüd süsteemi meetrikate kogumiseks integreerimist Prometheusega. See juhend selgitab samm-sammult, kuidas lisada oma FASTPANEL®i eksemplar Prometheusesse, et saaksite süsteemi meetrikaid reaalajas koguda ja jälgida.

Loo token

Et lubada Prometheusel meetrikaid koguda, peate looma piiratud juurdepääsuga spetsiaalse tokeni:

  1. Ühenduge oma FASTPANEL®i serveriga SSH kaudu.

  2. Käivitage tokeni loomiseks järgmine käsk:

mogwai users tokens add -n metrics_test_token -s read_only -s metrics_only
  • metrics_test_token on tokeni kohandatud nimi; võite valida ükskõik millise nime
  • Tokenile antakse järgmised skoopid:
    • read_only — kirjutuskaitstud juurdepääs
    • metrics_only — juurdepääs on piiratud meetrikatega

Lisage Prometheusesse job

Kui token on loodud, peate Prometheuse seadistama nii, et see hakkaks teie FASTPANEL®i eksemplarist meetrikaid kraapima.

Avage oma Prometheuse konfiguratsioonifail ja lisage uus 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 — jobi kohandatud nimi
  • targets — teie FASTPANEL®i serveri IP-aadress ja port. Asendage $IP oma serveri IP-aadressiga
  • metrics_path — API lõpp-punkt, kust meetrikaid tuua
  • bearer_token — asendage see oma loodud tokeniga (metrics_test_token)
  • scrape_interval — kui tihti Prometheus peaks meetrikaid kraapima (antud juhul on selleks määratud 60 sekundit)

Seadistage monitooringu töölaud

Pärast oma FASTPANEL®i eksemplari edukat lisamist Prometheusesse saate seadistada oma esimese töölaua kogutud meetrikate visualiseerimiseks.

Töölaua importimiseks järgige palun seda juhendit.

Nüüd hakkab Prometheus teie FASTPANEL®i eksemplarist meetrikaid koguma, võimaldades teil süsteemi jõudlust reaalajas jälgida.

Serveri teavitused

Sellel lehel
teave

FASTPANEL Extended on kõigile vaikimisi sisse lülitatud. Litsentsi pole vaja aktiveerida.

FASTPANEL® võimaldab jälgida serveri peamisi mõõdikuid: CPU load, Load Average 5, disk usage ja RAM consumption. Kui mõõdik ületab oma läve, saadetakse teavitused automaatselt Telegrami või Slacki. Seadistus asub jaotises "Settings" → "Notifications".

See artikkel selgitab, kuidas seadistada edastuskanaleid ja konfigureerida teavituste parameetreid, sealhulgas lävesid ja triggereid.

Kanali seadistamine

Telegram

  1. Looge ametliku Telegrami botti @BotFather abil uus bott. Järgige linki ja klõpsake nuppu "Start"
  1. Sisestage /newbot ja vajutage Enter.
  2. Sisestage oma botti soovitud nimi ja vajutage Enter.
  3. Sisestage oma botti soovitud kasutajanimi. See peab lõppema kujul bot, seejärel vajutage Enter.
  4. Saate sõnumi, mis algab järgmiselt:
    Done! Congratulations on your new bot.
  5. Klõpsake pärast Use this token to access the HTTP API: olevat sinist rida (ekraanipildil hägustatud), et kopeerida oma botti API token lõikelauale. Hoidke token turvaliselt, sest igaüks, kellel see on, saab teie botti juhtida
märkus

API token on salvestatud @BotFather sisse. Kui te selle unustate, saatke käsk /mybots, valige oma bott ja klõpsake nuppu "API Token".

  1. Avage FASTPANEL® ja minge jaotisse "Settings" → "Notifications".
  2. Klõpsake nuppu "Create channel"
  1. Täitke järgmised väljad:
  • Name — Sisestage kanalile nimi, et seda visuaalselt eristada
  • Channel — Valige "Telegram"
  • Bot token — Kleepige 6. sammus kopeeritud botti token
  • Problem period — Määrake ajavahemik (minutites), mille järel saadetakse teavitus, kui probleem püsib. Minimaalne väärtus on 1 minut
  • Notification repeat interval — Määrake järjestikuste teavituste vahe sama probleemi korral
  • Notify about solved problems — Lubage see valik, et saada teavitus, kui probleem on lahendatud
  • Add basic triggers — Lubage see valik, et luua automaatselt triggerid kõigi ketaste, RAM-i ja CPU jaoks
  1. Klõpsake nuppu "Save".
  2. Järgmisel ekraanil klõpsake nuppu "Invite", et kutsuda oma bott vestlusse või grupivestlusse
  1. Link avaneb uuel vahelehel. Kinnitage ümbersuunamine rakendusse Telegram Desktop
  1. Klõpsake nuppu "Start", et oma bott aktiveerida
  1. Seadistuse õigsuse kontrollimiseks minge tagasi FASTPANEL® vahekaardile ja klõpsake paberlennuki nuppu
  1. Kui kõik on õigesti seadistatud, saadetakse teie bottiga vestlusse testteavitus
  1. Kanali seadete hilisemaks muutmiseks klõpsake kanali kõrval pliiatsiikooni
  1. Allpool on näide triggeri aktiveerumisel loodud teavitusest

Slack

  1. Logige oma kontole sisse ja looge Slacki rakendus rakenduste lehe kaudu.
  2. Valige "From scratch".
  3. Sisestage App Name, valige tööruum, kuhu rakendus luuakse, ja klõpsake “Create app”.
  4. Jaotises “Features” avage “Incoming Webhooks” ja lubage see funktsioon
  1. Sama lehe allosas klõpsake “Add New Webhook”
  1. Järgmisel ekraanil valige kanal, kuhu teavitused saadetakse. Soovitatav on luua teavituste jaoks eraldi kanal. Seejärel klõpsake “Allow”.
  2. Teid suunatakse tagasi webhookide lehele. Kerige alla ja klõpsake “Copy”, et kopeerida webhooki URL
  1. Avage FASTPANEL® ja minge jaotisse "Settings" → "Notifications".
  2. Klõpsake nuppu "Create channel"
  1. Täitke järgmised väljad:
  • Name — Sisestage kanalile nimi, et seda visuaalselt eristada
  • Channel — Valige "Slack"
  • Webhook url — Kleepige 7. sammus kopeeritud webhooki URL
  • Problem period — Määrake ajavahemik (minutites), mille järel saadetakse teavitus, kui probleem püsib. Minimaalne väärtus on 1 minut
  • Notification repeat interval — Määrake järjestikuste teavituste vahe sama probleemi korral
  • Notify about solved problems — Lubage see valik, et saada teavitus, kui probleem on lahendatud
  • Add basic triggers — Lubage see valik, et luua automaatselt triggerid kõigi ketaste, RAM-i ja CPU jaoks
  1. Klõpsake nuppu "Save".
  2. Seadistuse õigsuse kontrollimiseks klõpsake paberlennuki nuppu
  1. Kui kõik on õigesti seadistatud, saadetakse testteavitus 6. sammus valitud kanalisse
  1. Kanali seadete hilisemaks muutmiseks klõpsake kanali kõrval pliiatsiikooni
  1. Allpool on näide triggeri aktiveerumisel loodud teavitusest

Triggerite seadistamine

Triggerite seadistamiseks klõpsake muudetava kanali real hammasratta ikooni

Avatud jaotises saate:

  1. Keelata mittevajalikud triggerid vasakul oleva lüliti abil.
  2. Luua uue triggeri ühte järgmistest tüüpidest: CPU, Disk (iga ketta jaoks eraldi), Load Average 5 (süsteemi keskmine koormus viimase 5 minuti jooksul), RAM.
  3. Muuta olemasolevaid triggereid

CPU, Disk ja RAM läved määratakse protsentides. Load Average 5 lävi määratakse täisarvuliste väärtustena.

märkus

Üldjuhul on normaalne Load Average 5 väärtus ligikaudu võrdne serveri CPU tuumade arvuga või kuni kaks korda suurem sellest.

FASTPANEL Extended