Funkcje wersji Extended
- Branding
- Powiadomienia serwera
- Prometheus
- Statystyki poczty
- Statystyki użycia dysku
- FASTPANEL Extended
- Zainstaluj aplikację Node.js
Dostosowywanie brandingu
Sekcja Branding w FASTPANEL® umożliwia dostosowanie wyglądu wizualnego i stylu panelu sterowania. To menu znajduje się w „Ustawienia” → „Główne” → „Branding”.
Schematy kolorów
Przejdź do karty „Schematy kolorów”, aby zmienić główny motyw kolorystyczny panelu. Wybierz spośród różnych predefiniowanych palet kolorów (np. niebieskiej, pomarańczowej, czerwonej, zielonej).
Dostosuj Motyw:
- Jasny: Użyj jasnego motywu
- Ciemny: Przełącz na tryb ciemny
- Jak na urządzeniu: Automatycznie dostosowuje się do ustawień urządzenia użytkownika
Dostosowywanie logo
Karta „Logo” umożliwia przesyłanie niestandardowego logo dla różnych obszarów panelu.
Ekran logowania
Można przesłać osobne logo dla motywów Jasny i Ciemny.
Użyj przycisku Prześlij, aby dodać nowe logo, lub Resetuj, aby przywrócić domyślne.
- Obsługiwane formaty: jpeg, png, svg, webp
- Maksymalna rozdzielczość: 256x100 pikseli
- Maksymalny rozmiar pliku: 5 MB
Logo nagłówka
Wyświetlane w nagłówku panelu sterowania.
- Obsługiwane formaty: jpeg, png, svg, webp
- Maksymalna rozdzielczość: 200x22 piksele
- Maksymalny rozmiar pliku: 5 MB
Dostosowywanie favicon
Karta „Favicon” umożliwia przesłanie favicon, wyświetlanej na kartach przeglądarki i w wynikach wyszukiwania.
Użyj przycisku Prześlij, aby dodać favicon, lub Resetuj, aby przywrócić domyślną.
- Obsługiwany format: ico
- Maksymalny rozmiar pliku: 1 MB
Dostosowywanie linków
Karta „Linki” udostępnia pola do dostosowania linków w menu bocznym.
- Baza wiedzy: URL umożliwiający dostęp do bazy wiedzy
Po zmodyfikowaniu linków kliknij Zapisz, aby zastosować zmiany.
Powiadomienia serwera
Na tej stronie
FASTPANEL Extended jest domyślnie włączony dla wszystkich użytkowników. Aktywacja licencji nie jest wymagana.
FASTPANEL® umożliwia monitorowanie kluczowych metryk serwera: obciążenia CPU, Load Average 5, wykorzystania dysku oraz zużycia RAM. Gdy metryka przekroczy swój próg, alerty są wysyłane automatycznie do Telegram lub Slack. Konfiguracja znajduje się w sekcji "Ustawienia" → "Powiadomienia".
W tym artykule wyjaśniono, jak skonfigurować kanały dostarczania i ustawić parametry powiadomień, w tym progi oraz wyzwalacze.
Konfiguracja kanału
Telegram
- Utwórz nowego bota za pomocą oficjalnego bota Telegram @BotFather. Przejdź pod link i kliknij przycisk "Start"
- Wpisz
/newboti naciśnij Enter. - Wprowadź żądaną nazwę swojego bota i naciśnij Enter.
- Wprowadź żądaną nazwę użytkownika swojego bota. Musi kończyć się na
bot, a następnie naciśnij Enter. - Otrzymasz wiadomość zaczynającą się od:
Done! Congratulations on your new bot. - Kliknij niebieską linię po
Use this token to access the HTTP API:(rozmytą na zrzucie ekranu), aby skopiować token API swojego bota do schowka. Przechowuj token w bezpiecznym miejscu, ponieważ każda osoba, która go posiada, może kontrolować Twojego bota
Token API jest przechowywany w @BotFather. Jeśli go zapomnisz, wyślij polecenie /mybots, wybierz swojego bota i kliknij przycisk "API Token".
- Otwórz FASTPANEL® i przejdź do "Ustawienia" → "Powiadomienia".
- Kliknij przycisk "Utwórz kanał"
- Wypełnij następujące pola:
- Nazwa — Wprowadź nazwę kanału, aby odróżnić go wizualnie
- Kanał — Wybierz "Telegram"
- Token bota — Wklej token bota skopiowany w kroku 6
- Okres problemu — Ustaw przedział czasu (w minutach), po którym zostanie wysłane powiadomienie, jeśli problem będzie się utrzymywał. Minimalna wartość to 1 minuta
- Interwał powtarzania powiadomień — Ustaw interwał między kolejnymi powiadomieniami dotyczącymi tego samego problemu
- Powiadamiaj o rozwiązanych problemach — Włącz tę opcję, aby otrzymać powiadomienie po rozwiązaniu problemu
- Dodaj podstawowe wyzwalacze — Włącz tę opcję, aby automatycznie utworzyć wyzwalacze dla wszystkich dysków, RAM i CPU
- Kliknij przycisk "Zapisz".
- Na następnym ekranie kliknij przycisk "Zaproś", aby zaprosić swojego bota do czatu lub czatu grupowego
- Link otworzy się w nowej karcie. Potwierdź przekierowanie do aplikacji Telegram Desktop
- Kliknij przycisk "Start", aby aktywować swojego bota
- Aby sprawdzić, czy konfiguracja jest poprawna, wróć do karty FASTPANEL® i kliknij przycisk samolotu papierowego
- Jeśli wszystko jest skonfigurowane prawidłowo, do czatu z Twoim botem zostanie wysłane testowe powiadomienie
- Aby później dostosować ustawienia kanału, kliknij ikonę ołówka obok kanału
- Poniżej znajduje się przykład powiadomienia wygenerowanego po aktywacji wyzwalacza
Slack
- Zaloguj się na swoje konto i utwórz aplikację Slack na stronie aplikacji.
- Wybierz "From scratch".
- Wprowadź App Name, wybierz obszar roboczy, w którym aplikacja zostanie utworzona, i kliknij “Create app”.
- W sekcji “Features” otwórz “Incoming Webhooks” i włącz tę funkcję
- Na dole tej samej strony kliknij “Add New Webhook”
- Na następnym ekranie wybierz kanał, do którego będą wysyłane powiadomienia. Zaleca się utworzenie dedykowanego kanału dla alertów. Następnie kliknij “Allow”.
- Zostaniesz przekierowany z powrotem na stronę webhooków. Przewiń w dół i kliknij “Copy”, aby skopiować adres URL webhooka
- Otwórz FASTPANEL® i przejdź do "Ustawienia" → "Powiadomienia".
- Kliknij przycisk "Utwórz kanał"
- Wypełnij następujące pola:
- Nazwa — Wprowadź nazwę kanału, aby odróżnić go wizualnie
- Kanał — Wybierz "Slack"
- Webhook url — Wklej adres URL webhooka skopiowany w kroku 7
- Okres problemu — Ustaw przedział czasu (w minutach), po którym zostanie wysłane powiadomienie, jeśli problem będzie się utrzymywał. Minimalna wartość to 1 minuta
- Interwał powtarzania powiadomień — Ustaw interwał między kolejnymi powiadomieniami dotyczącymi tego samego problemu
- Powiadamiaj o rozwiązanych problemach — Włącz tę opcję, aby otrzymać powiadomienie po rozwiązaniu problemu
- Dodaj podstawowe wyzwalacze — Włącz tę opcję, aby automatycznie utworzyć wyzwalacze dla wszystkich dysków, RAM i CPU
- Kliknij przycisk "Zapisz".
- Aby sprawdzić, czy konfiguracja jest poprawna, kliknij przycisk samolotu papierowego
- Jeśli wszystko jest skonfigurowane poprawnie, testowe powiadomienie zostanie wysłane do kanału wybranego w kroku 6
- Aby później dostosować ustawienia kanału, kliknij ikonę ołówka obok kanału
- Poniżej znajduje się przykład powiadomienia wygenerowanego po aktywacji wyzwalacza
Konfiguracja wyzwalaczy
Aby skonfigurować wyzwalacze, kliknij ikonę koła zębatego w wierszu kanału, który chcesz edytować
W otwartej sekcji możesz:
- Wyłączyć niepotrzebne wyzwalacze za pomocą przełącznika po lewej stronie.
- Utworzyć nowy wyzwalacz jednego z następujących typów: CPU, Dysk (dla każdego dysku osobno), Load Average 5 (średnie obciążenie systemu z ostatnich 5 minut), RAM.
- Edytować istniejące wyzwalacze
Progi dla CPU, Dysku i RAM są ustawiane w procentach. Próg dla Load Average 5 jest ustawiany w wartościach całkowitych.
Ogólnie rzecz biorąc, normalna wartość Load Average 5 jest w przybliżeniu równa liczbie rdzeni CPU na serwerze lub wynosi maksymalnie dwukrotność tej liczby.
Prometheus
Na tej stronie
FASTPANEL Extended jest domyślnie włączony dla wszystkich użytkowników. Aktywacja licencji nie jest wymagana.
Integracja FASTPANEL z Prometheus do zbierania metryk
FASTPANEL® obsługuje teraz integrację z Prometheus do zbierania metryk systemowych. Ten przewodnik przeprowadzi Cię przez kroki niezbędne do dodania instancji FASTPANEL® do Prometheus, co umożliwi zbieranie i monitorowanie metryk systemowych w czasie rzeczywistym.
Utwórz token
Aby umożliwić Prometheus zbieranie metryk, musisz utworzyć specjalny token z ograniczonym dostępem:
-
Połącz się z serwerem FASTPANEL® przez SSH.
-
Uruchom następujące polecenie, aby utworzyć token:
mogwai users tokens add -n metrics_test_token -s read_only -s metrics_only- metrics_test_token to niestandardowa nazwa tokenu; możesz wybrać dowolną nazwę
- Token otrzyma następujące zakresy:
- read_only — dostęp tylko do odczytu
- metrics_only — dostęp ograniczony do metryk
Dodaj zadanie do Prometheus
Po utworzeniu tokenu musisz skonfigurować Prometheus, aby rozpocząć pobieranie metryk z instancji FASTPANEL®.
Otwórz plik konfiguracyjny Prometheus i dodaj nowe zadanie:
- 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 — niestandardowa nazwa zadania
- targets — adres IP i port serwera FASTPANEL®. Zastąp
$IPadresem IP swojego serwera - metrics_path — endpoint API, z którego mają być pobierane metryki
- bearer_token — zastąp to wygenerowanym tokenem (metrics_test_token)
- scrape_interval — jak często Prometheus ma pobierać metryki (w tym przypadku ustawiono 60 sekund)
Skonfiguruj pulpit monitorowania
Po pomyślnym dodaniu instancji FASTPANEL® do Prometheus możesz skonfigurować swój pierwszy pulpit, aby wizualizować zebrane metryki.
Aby zaimportować pulpit, postępuj zgodnie z tym przewodnikiem.
Od tej chwili Prometheus będzie zbierać metryki z instancji FASTPANEL®, umożliwiając monitorowanie wydajności systemu w czasie rzeczywistym.
Statystyki poczty
Na tej stronie
FASTPANEL Extended jest domyślnie włączony dla wszystkich użytkowników. Aktywacja licencji nie jest wymagana.
FASTPANEL® zawiera funkcję Statystyki poczty, która umożliwia łatwe monitorowanie aktywności wychodzących wiadomości e-mail dla całej domeny lub poszczególnych skrzynek pocztowych. Możesz szybko sprawdzić, ile wiadomości zostało wysłanych, dostarczonych lub odrzuconych, a także wyświetlić szczegółowe kody błędów SMTP wraz z zaleceniami wyjaśniającymi, dlaczego niektóre wiadomości e-mail zostały odrzucone.
Skonfiguruj automatyczne zbieranie statystyk
- Aby włączyć automatyczne zbieranie statystyk poczty, przejdź do "Ustawienia" → "Poczta" → "Statystyki" i włącz opcję "Włącz zbieranie statystyk".
Jeśli wolisz nie zbierać danych automatycznie, wyłącz tę opcję. Następnie konieczne będzie ręczne kliknięcie przycisku "Aktualizuj" w widoku statystyk (zobacz następną sekcję), aby odświeżyć dane.
-
Możesz określić, jak często statystyki są automatycznie aktualizowane — od co 1 godzinę do co 24 godziny.
-
Aby zapisać ustawienia, nie zapomnij kliknąć przycisku "Zapisz".
Widok statystyk
Aby wyświetlić statystyki, przejdź do "Zarządzanie" → "Poczta" i kliknij ikonę wykresu obok domeny, którą chcesz przeanalizować.
Widok statystyk jest podzielony na trzy główne sekcje, które zostały szczegółowo opisane poniżej.
Wykres statystyk
Wyświetla łączną liczbę wysłanych, dostarczonych i odrzuconych wiadomości w wybranym okresie. Wykres pomaga szybko identyfikować trendy i problemy z dostarczaniem.
Możesz dostosować wyświetlane dane poprzez:
-
Wybranie domeny pocztowej.
-
Wybranie statystyk dla całej domeny lub określonej skrzynki pocztowej.
-
Wybranie zakresu czasu dla raportu — od ostatnich 24 godzin do ostatniego miesiąca.
-
Kliknięcie przycisku "Aktualizuj", aby ręcznie odświeżyć statystyki i pobrać najnowsze dane.
Najczęstsze przyczyny odrzuceń
Wyświetla najczęstsze przyczyny niepowodzeń dostarczania wiadomości wraz z odpowiadającymi im kodami błędów SMTP. Pozwala to zrozumieć i rozwiązywać powtarzające się problemy.
Zdarzenia błędów poczty wychodzącej
Zapewnia szczegółowe informacje o każdej odrzuconej lub niedostarczonej wiadomości wraz z zalecanymi działaniami umożliwiającymi rozwiązanie problemów.
Dla każdego rekordu wyświetlane są następujące szczegóły:
-
Data/godzina — dokładny czas, kiedy miała miejsce próba dostarczenia
-
ID kolejki — unikalny identyfikator wiadomości w kolejce pocztowej
-
Od / Domena nadawcy / Do — adresy nadawcy i odbiorcy, a także domena źródłowa
-
Kod SMTP — kod odpowiedzi zwrócony przez serwer pocztowy odbiorcy (na przykład 550-5.7.26)
-
Porada — krótkie wyjaśnienie problemu i zalecane działanie (np. „Wiadomość odrzucona przez Gmaila: brak uwierzytelnienia SPF/DKIM lub błąd uwierzytelnienia SPF/DKIM”)
-
Szczegóły — pełny tekst odpowiedzi SMTP, który może zawierać łącze do zewnętrznej dokumentacji serwera odbiorcy (na przykład stron pomocy Gmaila)
-
Nieznany kod — wskazuje, czy odpowiedź SMTP nie mogła zostać sklasyfikowana
-
Bajty — rozmiar wiadomości e-mail
-
Liczba ponowień — liczba prób dostarczenia podjętych przed trwałym odrzuceniem wiadomości
-
Ostatnia próba — znacznik czasu ostatniej próby dostarczenia
-
Wynik spamu — wynik oceny spamu, jeśli dotyczy
Te dane zapewniają kompleksowy przegląd problemów z dostarczaniem poczty wychodzącej, pomagając diagnozować problemy z uwierzytelnianiem, reputacją lub konfiguracją.
Statystyki użycia dysku
FASTPANEL Extended jest domyślnie włączony dla wszystkich użytkowników. Aktywacja licencji nie jest wymagana.
FASTPANEL® zawiera funkcję Statystyki użycia dysku, która pozwala szybko sprawdzić, które pliki i katalogi zajmują miejsce w katalogach użytkowników Twoich witryn.
Aby skorzystać z tej funkcji, otwórz "Zarządzanie" → "Menedżer plików" i kliknij okrągłą ikonę w prawym górnym rogu
Na następnym ekranie zobaczysz szczegółowe statystyki użycia dysku, w tym Katalogi, Największe pliki oraz Statystyki rozszerzeń.
- Kliknij ikonę folderu w prawym górnym rogu, aby wrócić do menedżera plików.
- Kliknij ikonę odświeżania (okrężne strzałki) w prawym górnym rogu, aby ponownie wczytać dane.
- Kliknij nazwę użytkownika w lewym górnym rogu, aby przełączać się między katalogami domowymi różnych użytkowników; statystyki zostaną odpowiednio zaktualizowane.
FASTPANEL Extended
FASTPANEL Extended jest domyślnie włączony dla wszystkich użytkowników. Aktywacja licencji nie jest wymagana.
Node.js
Na tej stronie
FASTPANEL Extended jest domyślnie włączony dla wszystkich użytkowników. Aktywacja licencji nie jest wymagana.
Wprowadzenie
Node.js to platforma serwerowa uruchamiająca aplikacje napisane w JavaScript.
Najpierw musisz zainstalować Node.js:
- Przejdź do "Ustawienia" -> "Aplikacje"
- Kliknij przycisk "Install" dla wymaganej wersji Node.js
Utwórz witrynę internetową:
- Wybierz szablon dla witryny internetowej Node.js
- Określ domenę i powiązane parametry. Na etapie konfiguracji możesz zmienić DB, użytkownika FTP i Backend
- Prześlij pliki aplikacji do katalogu witryny internetowej
- Aby zainstalować zależności, uruchom
npm20.15.1 installw Terminalu (wymagana jest instalacja aplikacji ttyd dla FASTPANEL®)
- Uruchom ponownie Node.js, przechodząc do panelu witryny, a następnie otwierając sekcję "Usługi".
Framework Express
Używając frameworka Express jako przykładu, utwórzmy prosty serwer WWW:
- Połącz się z serwerem przez SSH jako użytkownik będący właścicielem witryny (możesz użyć aplikacji ttyd dla FASTPANEL®)
- Utwórz plik
app.jsw katalogu witryny internetowej i wypełnij go następującym kodem:
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}`);
});
- W katalogu witryny internetowej uruchom polecenie instalacji express
npm20.15.1 install express- Przejdź do panelu witryny, a następnie do sekcji Usługi
- Uruchom ponownie usługę
- Sprawdź witrynę internetową
Docusaurus
Na przykładzie aplikacji internetowej Docusaurus skonfigurujmy ustawienia:
- Połącz się z serwerem przez SSH jako użytkownik będący właścicielem witryny (możesz użyć aplikacji ttyd dla FASTPANEL®)
- W katalogu witryny internetowej uruchom instalację Docusaurus
npx20.15.1 create-docusaurus -j ./docs-
Gdy pojawi się pytanie o wybór szablonu, odpowiedz classic (recommended)
-
Po instalacji zamień jedną linię w pliku
docs/package.json
"start": "docusaurus start",
# replace with
"start": "docusaurus start --port $SERVICE_PORT",$SERVICE_PORT to zmienna systemowa ustawiona w FASTPANEL®
-
W panelu sterowania przejdź do "ustawienia witryny" -> "Backend"
-
Wybierz handler Standalone lub PM2.
-
Wybierz żądaną wersję Node.js.
-
Określ folder roboczy
docs -
W polu Launch command wpisz:
npm run start -
Zapisz. Poczekaj na skompilowanie aplikacji (informacje pojawią się w logach). Sprawdź witrynę internetową
Next.js
Używając Next.js z Node.js 20.19 jako przykładu, utwórzmy prosty serwer WWW:
- Połącz się z serwerem przez SSH jako użytkownik będący właścicielem witryny internetowej (możesz również użyć aplikacji ttyd w FASTPANEL®).
- W katalogu witryny internetowej uruchom polecenie inicjalizacji projektu:
yarn20.19.4 init -y
yarn20.19.4 add next react react-dom- Dodaj blok scripts do pliku
package.json:
"scripts": {
"dev": "next dev -p $SERVICE_PORT",
"build": "next build",
"start": "next start -p $SERVICE_PORT"
}- Utwórz katalog
pagesi dodaj w nim plik o nazwieindex.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- Uruchom kompilację projektu.
yarn20.19.4 build- W panelu sterowania przejdź do "ustawienia witryny" -> "Backend"
- Wybierz handler Standalone lub PM2.
- Wybierz żądaną wersję Node.js.
- W polu Launch command wpisz:
yarn run start. - Zapisz. Poczekaj na skompilowanie aplikacji (informacje pojawią się w logach). Sprawdź witrynę internetową
Dodatkowe informacje
W trybie Standalone uruchamiany jest proces Node.js do wykonywania Twoich skryptów.
W trybie PM2 do zarządzania procesami Node.js, logami i obciążeniem systemu używany jest menedżer procesów PM2.
Ten tryb pozwala także określić liczbę workerów — czyli liczbę procesów Node.js obsługujących przychodzące żądania do serwera.
Dodatkowo ten tryb udostępnia opcję Enable file watch — PM2 automatycznie uruchomi ponownie Twoją aplikację po zmodyfikowaniu pliku w bieżącym katalogu lub jego podkatalogach. Pamiętaj, że ten tryb powoduje dodatkowe obciążenie systemu i nie jest zalecany dla środowisk produkcyjnych.
W podobny sposób możesz skonfigurować aplikację, jeśli wymaga ona YARN zamiast NPM
Możesz zainstalować zależności projektu wymienione w package.json przy użyciu YARN lub NPM bezpośrednio z FASTPANEL®. Aby to zrobić, otwórz kartę witryny internetowej i przejdź do sekcji Usługi:
Logi
Aplikacja Node.js może generować logi. W FASTPANEL® znajdują się one w panelu witryny, w sekcji Logi, na karcie "Backend log"
Polecenia konsoli
Po zainstalowaniu Node.js w FASTPANEL® użytkownicy mogą pracować ze swoimi projektami przy użyciu poleceń konsoli, takich jak:
- pm2
- yarn20.15.1
- npx20.15.1
- npm20.15.1
- node20.15.1
Przykład:
$ 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 │
└────┴─────────────┴─────────────┴─────────┴─────────┴──────────┴────────┴──────┴───────────┴──────────┴──────────┴──────────┴──────────┘Każda nazwa polecenia zawiera numer wersji zainstalowanego Node.js. W tym przykładzie dostępną wersją jest Node.js 20.15.1.
FASTPANEL