Funkcije izdanja Extended
- Brendiranje
- Instalacija Node.js aplikacije
- Obaveštenja servera
- Prometheus
- Statistika iskorišćenosti diska
- Statistika pošte
- FASTPANEL Extended
Prilagođavanje brendiranja
Odeljak Branding u FASTPANEL® omogućava prilagođavanje vizuelnog izgleda i stila kontrolnog panela. Ovaj meni se nalazi u "Settings" → "Main" → "Branding".
Šeme boja
Idite na karticu "Color schemes" da biste promenili primarnu temu boja panela. Izaberite neku od različitih unapred definisanih paleta boja (npr. plava, narandžasta, crvena, zelena).
Prilagodite Theme:
- Light: Koristite svetlu temu
- Dark: Prebacite se na tamni režim
- Like on the device: Automatski se prilagođava podešavanjima uređaja korisnika
Prilagođavanje logotipa
Kartica "Logo" omogućava otpremanje prilagođenog logotipa za različite oblasti panela.
Login Screen
Zasebni logotipi mogu se otpremiti za teme Light i Dark.
Koristite dugme Upload da dodate novi logotip ili Reset da biste vratili podrazumevani.
- Podržani formati: jpeg, png, svg, webp
- Maksimalna rezolucija: 256x100 piksela
- Maksimalna veličina datoteke: 5 MB
Header Logo
Prikazuje se u zaglavlju kontrolnog panela.
- Podržani formati: jpeg, png, svg, webp
- Maksimalna rezolucija: 200x22 piksela
- Maksimalna veličina datoteke: 5 MB
Prilagođavanje favicon-a
Kartica "Favicon" omogućava otpremanje favicon-a, koji se prikazuje na karticama pregledača i u rezultatima pretrage.
Koristite dugme Upload da dodate favicon ili Reset da biste vratili podrazumevani.
- Podržani format: ico
- Maksimalna veličina datoteke: 1 MB
Prilagođavanje linkova
Kartica "Links" nudi polja za prilagođavanje linkova u bočnom meniju.
- Knowledge base: URL za pristup bazi znanja
Nakon izmene linkova, kliknite na Save da biste primenili promene.
Node.js
FASTPANEL Extended je podrazumevano uključen za sve korisnike. Licencu nije potrebno aktivirati.
Uvod
Node.js je serverska platforma koja pokreće aplikacije napisane u JavaScript-u.
Prvo je potrebno da instalirate Node.js:
- Idite na "Podešavanja" -> "Aplikacije"
- Kliknite na dugme "Install" za potrebnu Node.js verziju
Kreirajte veb-sajt:
- Izaberite šablon za Node.js veb-sajt
- Navedite domen i povezane parametre. U fazi konfiguracije možete promeniti DB, FTP korisnika i Backend
- Otpremite fajlove aplikacije u direktorijum veb-sajta
- Da biste instalirali zavisnosti, pokrenite
npm20.15.1 installu Terminalu (potrebno je instalirati ttyd aplikaciju za FASTPANEL®)
- Restartujte Node.js tako što ćete otići na kontrolnu tablu sajta, a zatim otvoriti odeljak "Services".
Express okvir
Koristeći Express okvir kao primer, napravićemo jednostavan veb-server:
- Povežite se sa serverom putem SSH-a kao korisnik koji je vlasnik sajta (možete koristiti ttyd aplikaciju za FASTPANEL®)
- Kreirajte fajl
app.jsu direktorijumu veb-sajta i popunite ga sledećim kodom:
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}`);
});
- U direktorijumu veb-sajta pokrenite komandu za instalaciju express-a
npm20.15.1 install express- Idite na kontrolnu tablu sajta, zatim u odeljak Services
- Restartujte servis
- Proverite veb-sajt
Docusaurus
Koristeći Docusaurus veb-aplikaciju kao primer, podesićemo podešavanja:
- Povežite se sa serverom putem SSH-a kao korisnik koji je vlasnik sajta (možete koristiti ttyd aplikaciju za FASTPANEL®)
- U direktorijumu veb-sajta pokrenite instalaciju Docusaurus-a
npx20.15.1 create-docusaurus -j ./docs-
Kada se od vas zatraži da izaberete šablon, odgovorite classic (recommended)
-
Nakon instalacije, zamenite jednu liniju u fajlu
docs/package.json
"start": "docusaurus start",
# replace with
"start": "docusaurus start --port $SERVICE_PORT",$SERVICE_PORT je sistemska promenljiva podešena u FASTPANEL®
-
U kontrolnoj tabli idite na "site settings" -> "Backend"
-
Izaberite rukovalac Standalone ili PM2.
-
Izaberite željenu Node.js verziju.
-
Navedite radni direktorijum
docs -
U polje Launch command unesite:
npm run start -
Sačuvajte. Sačekajte da se aplikacija kompajlira (informacije će se pojaviti u logovima). Proverite veb-sajt
Next.js
Koristeći Next.js sa Node.js 20.19 kao primer, hajde da kreiramo jednostavan veb server:
- Povežite se sa serverom putem SSH-a kao korisnik koji je vlasnik veb-sajta (možete koristiti i ttyd aplikaciju u FASTPANEL®).
- U direktorijumu veb-sajta pokrenite komandu za inicijalizaciju projekta:
yarn20.19.4 init -y
yarn20.19.4 add next react react-dom- Dodajte blok scripts u fajl
package.json:
"scripts": {
"dev": "next dev -p $SERVICE_PORT",
"build": "next build",
"start": "next start -p $SERVICE_PORT"
}- Kreirajte direktorijum
pagesi u njemu dodajte fajl pod nazivomindex.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- Pokrenite izgradnju projekta.
yarn20.19.4 build- U kontrolnoj tabli idite na "site settings" -> "Backend"
- Izaberite rukovalac Standalone ili PM2.
- Izaberite željenu Node.js verziju.
- U polje Launch command unesite:
yarn run start. - Sačuvajte. Sačekajte da se aplikacija kompajlira (informacije će se pojaviti u logovima). Proverite veb-sajt
Dodatne informacije
U režimu Standalone, pokreće se Node.js proces za izvršavanje vaših skripti.
U režimu PM2, koristi se PM2 menadžer procesa za upravljanje Node.js procesima, logovima i opterećenjem sistema.
Ovaj režim vam takođe omogućava da navedete broj radnika — odnosno broj Node.js procesa koji obrađuju dolazne zahteve serveru.
Pored toga, ovaj režim pruža opciju Enable file watch — PM2 automatski restartuje vašu aplikaciju kada se fajl izmeni u trenutnom direktorijumu ili njegovim poddirektorijumima. Imajte na umu da ovaj režim uvodi dodatno opterećenje sistema i ne preporučuje se za produkciona okruženja.
Na sličan način možete konfigurisati aplikaciju ako zahteva YARN umesto NPM
Možete instalirati zavisnosti vašeg projekta navedene u package.json koristeći YARN ili NPM direktno iz FASTPANEL®. Da biste to uradili, otvorite karticu veb-sajta i idite u odeljak Services:
Logovi
Node.js aplikacija može generisati logove. U FASTPANEL®, oni se nalaze na kontrolnoj tabli sajta, u odeljku Logs, pod karticom "Backend log"
Komande konzole
Nakon instalacije Node.js u FASTPANEL®, korisnici mogu raditi sa svojim projektima koristeći komande konzole kao što su:
- pm2
- yarn20.15.1
- npx20.15.1
- npm20.15.1
- node20.15.1
Primer:
$ 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 │
└────┴─────────────┴─────────────┴─────────┴─────────┴──────────┴────────┴──────┴───────────┴──────────┴──────────┴──────────┴──────────┘Naziv svake komande uključuje broj verzije Node.js koja je instalirana. U ovom primeru, dostupna verzija je Node.js 20.15.1.
Obaveštenja servera
Na ovoj stranici
FASTPANEL Extended je podrazumevano uključen za sve korisnike. Licencu nije potrebno aktivirati.
FASTPANEL® omogućava praćenje ključnih metrika servera: CPU load, Load Average 5, iskorišćenost diska i potrošnja RAM-a. Kada metrika premaši svoj prag, upozorenja se automatski šalju na Telegram ili Slack. Konfiguracija se nalazi u okviru "Settings" → "Notifications".
Ovaj članak objašnjava kako da podesite kanale isporuke i konfigurišete parametre obaveštenja, uključujući pragove i okidače.
Podešavanje kanala
Telegram
- Kreirajte novog bota pomoću zvaničnog Telegram bota @BotFather. Pratite link i kliknite na dugme "Start"
- Unesite
/newboti pritisnite Enter. - Unesite željeno ime za svog bota i pritisnite Enter.
- Unesite željeno korisničko ime za svog bota. Mora da se završava sa
bot, a zatim pritisnite Enter. - Dobićete poruku koja počinje sa:
Done! Congratulations on your new bot. - Kliknite na plavu liniju posle
Use this token to access the HTTP API:(zamućena na snimku ekrana) da biste kopirali API token svog bota u privremenu memoriju. Čuvajte token bezbedno, jer svako ko ga ima može da kontroliše vašeg bota
API token se čuva u @BotFather. Ako ga zaboravite, pošaljite komandu /mybots, izaberite svog bota i kliknite na dugme "API Token".
- Otvorite FASTPANEL® i idite na "Settings" → "Notifications".
- Kliknite na dugme "Create channel"
- Popunite sledeća polja:
- Name — Unesite ime za kanal da biste ga vizuelno razlikovali
- Channel — Izaberite "Telegram"
- Bot token — Nalepite token bota kopiran u 6. koraku
- Problem period — Podesite vremenski interval (u minutima) nakon kog će obaveštenje biti poslato ako problem i dalje postoji. Minimalna vrednost je 1 minut
- Notification repeat interval — Podesite interval između uzastopnih obaveštenja za isti problem
- Notify about solved problems — Omogućite ovu opciju da biste primili obaveštenje kada problem bude rešen
- Add basic triggers — Omogućite ovu opciju da biste automatski kreirali okidače za sve diskove, RAM i CPU
- Kliknite na dugme "Save".
- Na sledećem ekranu kliknite na dugme "Invite" da biste pozvali svog bota u ćaskanje ili grupno ćaskanje
- Link će se otvoriti u novom tabu. Potvrdite preusmeravanje na aplikaciju Telegram Desktop
- Kliknite na dugme "Start" da biste aktivirali svog bota
- Da biste proverili da li je podešavanje ispravno, vratite se na karticu FASTPANEL® i kliknite na dugme sa ikonom papirnog aviona
- Ako je sve ispravno podešeno, test obaveštenje će biti poslato u ćaskanje sa vašim botom
- Da biste kasnije prilagodili podešavanja kanala, kliknite na ikonu olovke pored kanala
- Ispod je primer obaveštenja generisanog kada se aktivira okidač
Slack
- Prijavite se na svoj nalog i kreirajte Slack aplikaciju putem stranice za aplikacije.
- Izaberite "From scratch".
- Unesite App Name, izaberite workspace u kojem će aplikacija biti kreirana i kliknite na “Create app”.
- U odeljku “Features” otvorite “Incoming Webhooks” i omogućite funkciju
- Na dnu iste stranice kliknite na “Add New Webhook”
- Na sledećem ekranu izaberite kanal u koji će se slati obaveštenja. Preporučuje se da kreirate namenski kanal za upozorenja. Zatim kliknite na “Allow”.
- Bićete preusmereni nazad na stranicu sa webhook-ovima. Pomerite se nadole i kliknite na “Copy” da biste kopirali webhook URL
- Otvorite FASTPANEL® i idite na "Settings" → "Notifications".
- Kliknite na dugme "Create channel"
- Popunite sledeća polja:
- Name — Unesite ime za kanal da biste ga vizuelno razlikovali
- Channel — Izaberite "Slack"
- Webhook url — Nalepite webhook URL kopiran u 7. koraku
- Problem period — Podesite vremenski interval (u minutima) nakon kog će obaveštenje biti poslato ako problem i dalje postoji. Minimalna vrednost je 1 minut
- Notification repeat interval — Podesite interval između uzastopnih obaveštenja za isti problem
- Notify about solved problems — Omogućite ovu opciju da biste primili obaveštenje kada problem bude rešen
- Add basic triggers — Omogućite ovu opciju da biste automatski kreirali okidače za sve diskove, RAM i CPU
- Kliknite na dugme "Save".
- Da biste proverili da li je podešavanje ispravno, kliknite na dugme sa ikonom papirnog aviona
- Ako je sve ispravno podešeno, test obaveštenje će biti poslato u kanal izabran u 6. koraku
- Da biste kasnije prilagodili podešavanja kanala, kliknite na ikonu olovke pored kanala
- Ispod je primer obaveštenja generisanog kada se aktivira okidač
Konfiguracija okidača
Da biste konfigurisali okidače, kliknite na ikonu zupčanika u redu kanala koji želite da izmenite
U otvorenom odeljku možete:
- Onemogućiti nepotrebne okidače pomoću prekidača sa leve strane.
- Kreirati novi okidač jednog od sledećih tipova: CPU, Disk (za svaki disk pojedinačno), Load Average 5 (prosečno opterećenje sistema u poslednjih 5 minuta), RAM.
- Izmeniti postojeće okidače
Pragovi za CPU, Disk i RAM podešavaju se u procentima. Prag za Load Average 5 podešava se u celobrojnim vrednostima.
Kao opšte pravilo, normalna vrednost Load Average 5 približno je jednaka broju CPU jezgara na serveru, ili do dvostruko veća od tog broja.
Prometheus
Na ovoj stranici
FASTPANEL Extended je podrazumevano uključen za sve korisnike. Licencu nije potrebno aktivirati.
Integracija FASTPANEL-a sa Prometheus-om za prikupljanje metrika
FASTPANEL® sada podržava integraciju sa Prometheus-om za prikupljanje sistemskih metrika. Ovaj vodič će vas provesti kroz korake potrebne da dodate svoju FASTPANEL® instancu u Prometheus, što vam omogućava da prikupljate i nadgledate sistemske metrike u realnom vremenu.
Kreiranje tokena
Da biste omogućili da Prometheus prikuplja metrike, potrebno je da kreirate poseban token sa ograničenim pristupom:
-
Povežite se sa svojim FASTPANEL® serverom putem SSH-a.
-
Pokrenite sledeću komandu da kreirate token:
mogwai users tokens add -n metrics_test_token -s read_only -s metrics_only- metrics_test_token je prilagođeno ime za token; možete izabrati bilo koje ime
- Tokenu će biti dodeljeni sledeći scope-ovi:
- read_only — pristup samo za čitanje
- metrics_only — pristup ograničen samo na metrike
Dodajte job u Prometheus
Kada je token kreiran, potrebno je da konfigurišete Prometheus da počne da preuzima metrike sa vaše FASTPANEL® instance.
Otvorite svoju Prometheus konfiguracionu datoteku i dodajte novi 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 — prilagođeno ime za job
- targets — IP adresa i port vašeg FASTPANEL® servera. Zamenite
$IPIP adresom svog servera - metrics_path — API endpoint za preuzimanje metrika
- bearer_token — zamenite ovo svojim generisanim tokenom (metrics_test_token)
- scrape_interval — koliko često Prometheus treba da preuzima metrike (u ovom slučaju podešeno na 60 sekundi)
Konfigurišite kontrolnu tablu za nadzor
Nakon što uspešno dodate svoju FASTPANEL® instancu u Prometheus, možete podesiti svoju prvu kontrolnu tablu za vizuelizaciju prikupljenih metrika.
Za uvoz kontrolne table, pratite ovaj vodič.
Sada će Prometheus početi da prikuplja metrike sa vaše FASTPANEL® instance, omogućavajući vam da pratite performanse sistema u realnom vremenu.
Statistika iskorišćenosti diska
FASTPANEL Extended je podrazumevano uključen za sve korisnike. Licencu nije potrebno aktivirati.
FASTPANEL® uključuje funkciju Statistika iskorišćenosti diska koja vam omogućava da brzo vidite koje datoteke i direktorijumi zauzimaju prostor u korisničkim direktorijumima vaših veb-sajtova.
Da biste koristili ovu funkciju, otvorite "Management" → "File Manager" i kliknite na okruglu ikonu u gornjem desnom uglu
Na sledećem ekranu videćete detaljnu statistiku iskorišćenosti diska, uključujući Direktorijume, Najveće datoteke i Statistiku ekstenzija.
- Kliknite na ikonu fascikle u gornjem desnom uglu da biste se vratili u upravljač datotekama.
- Kliknite na ikonu za osvežavanje (kružne strelice) u gornjem desnom uglu da biste ponovo učitali podatke.
- Kliknite na korisničko ime u gornjem levom uglu da biste se prebacivali između matičnih direktorijuma različitih korisnika; statistika će se ažurirati u skladu s tim.
Statistika pošte
Na ovoj stranici
FASTPANEL Extended je podrazumevano uključen za sve korisnike. Licencu nije potrebno aktivirati.
FASTPANEL® uključuje funkciju Statistika pošte koja vam omogućava da lako pratite aktivnost odlaznih e-poruka za ceo domen ili pojedinačne poštanske sandučiće. Možete brzo da vidite koliko je poruka poslato, isporučeno ili odbijeno, kao i da pregledate detaljne SMTP kodove grešaka sa preporukama koje objašnjavaju zašto su određene e-poruke odbijene.
Konfigurišite automatsko prikupljanje statistike
- Da biste omogućili automatsko prikupljanje statistike pošte, idite na "Podešavanja" → "Pošta" → "Statistika" i uključite opciju "Omogući prikupljanje statistike".
Ako ne želite da se podaci prikupljaju automatski, onemogućite ovu opciju. Tada ćete morati ručno da kliknete na dugme "Ažuriraj" u prikazu statistike (pogledajte sledeći odeljak) da biste osvežili podatke.
-
Možete definisati koliko često se statistika automatski ažurira — od svakog 1 sata do svakih 24 sata.
-
Da biste sačuvali podešavanja, ne zaboravite da kliknete na dugme "Sačuvaj".
Prikaz statistike
Da biste pregledali statistiku, idite na "Upravljanje" → "Pošta" i kliknite na ikonu grafikona pored domena koji želite da analizirate.
Prikaz statistike je podeljen na tri glavna odeljka, koja su detaljno opisana u nastavku.
Grafikon statistike
Prikazuje ukupan broj poslatih, isporučenih i odbijenih poruka tokom izabranog vremenskog perioda. Grafikon vam pomaže da na prvi pogled prepoznate trendove i probleme sa isporukom.
Možete prilagoditi prikazane podatke na sledeće načine:
-
Izborom domena pošte.
-
Izborom statistike za ceo domen ili određeni poštanski sandučić.
-
Odabirom vremenskog opsega za izveštaj — od poslednja 24 sata do poslednjeg meseca.
-
Klikom na dugme "Ažuriraj" da biste ručno osvežili statistiku i preuzeli najnovije podatke.
Najčešći razlozi odbijanja
Navodi najčešće uzroke neuspešne isporuke poruka, zajedno sa odgovarajućim SMTP kodovima grešaka. To vam omogućava da razumete i rešite probleme koji se ponavljaju.
Događaji odlaznih grešaka
Pruža detaljne informacije o svakoj odbijenoj ili neisporučenoj poruci, sa preporučenim radnjama za rešavanje problema.
Za svaki zapis prikazuju se sledeći detalji:
-
Datum/Vreme — tačno vreme kada je došlo do pokušaja isporuke
-
Queue ID — jedinstveni identifikator poruke u redu pošte
-
From / From domain / To — adrese pošiljaoca i primaoca, kao i izvorni domen
-
SMTP code — kod odgovora koji vraća server pošte primaoca (na primer, 550-5.7.26)
-
Advice — kratko objašnjenje problema i preporučena radnja (npr. „Poruku je odbio Gmail: nedostaje ili nije uspela SPF/DKIM autentifikacija“)
-
Detail — kompletan tekst SMTP odgovora, koji može da sadrži vezu ka eksternoj dokumentaciji sa servera primaoca (na primer, stranice podrške Gmail-a)
-
Unknown code — označava da li SMTP odgovor nije mogao biti klasifikovan
-
Bytes — veličina e-poruke
-
Retry count — broj pokušaja isporuke pre nego što je poruka trajno odbijena
-
Last try — vremenska oznaka poslednjeg pokušaja isporuke
-
Spam score — rezultat procene neželjene pošte, ako je primenljivo
Ovi podaci pružaju sveobuhvatan pregled problema sa odlaznom isporukom, pomažući vam da dijagnostikujete probleme sa autentifikacijom, reputacijom ili konfiguracijom.
FASTPANEL Extended
FASTPANEL Extended je podrazumevano uključen za sve korisnike. Licencu nije potrebno aktivirati.
FASTPANEL