Функции на Extended
- Prometheus
- Брандиране
- FASTPANEL Extended
- Известия за сървъра
- Инсталиране на Node.js приложение
- Статистика за използването на диска
- Статистика на пощата
Prometheus
На тази страница
FASTPANEL Extended е включена по подразбиране за всички потребители. Не е необходимо активиране на лиценз.
Интеграция на FASTPANEL с Prometheus за събиране на метрики
FASTPANEL® вече поддържа интеграция с Prometheus за събиране на системни метрики. Това ръководство ще ви преведе през стъпките, необходими за добавяне на вашия екземпляр на FASTPANEL® към Prometheus, което ви позволява да събирате и наблюдавате системни метрики в реално време.
Създаване на токен
За да позволите на Prometheus да събира метрики, трябва да създадете специален токен с ограничен достъп:
-
Свържете се с вашия FASTPANEL® сървър чрез SSH.
-
Изпълнете следната команда, за да създадете токен:
mogwai users tokens add -n metrics_test_token -s read_only -s metrics_only- metrics_test_token е персонализирано име за токена; можете да изберете всяко име
- На токена ще бъдат предоставени следните обхвати:
- read_only — достъп само за четене
- metrics_only — достъп, ограничен само до метрики
Добавяне на job към Prometheus
След като токенът бъде създаден, трябва да конфигурирате Prometheus, за да започне да извлича метрики от вашия екземпляр на FASTPANEL®.
Отворете конфигурационния файл на Prometheus и добавете нов 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 — персонализирано име за job-а
- targets — IP адресът и портът на вашия FASTPANEL® сървър. Заменете
$IPс IP адреса на вашия сървър - metrics_path — API крайната точка, от която се извличат метриките
- bearer_token — заменете това с генерирания от вас токен (metrics_test_token)
- scrape_interval — колко често Prometheus трябва да извлича метриките (в този случай е зададено на 60 секунди)
Конфигуриране на таблото за наблюдение
След като успешно добавите вашия екземпляр на FASTPANEL® към Prometheus, можете да настроите първото си табло, за да визуализирате събраните метрики.
За импортиране на таблото, моля, следвайте това ръководство.
Сега Prometheus ще започне да събира метрики от вашия екземпляр на FASTPANEL®, което ви позволява да наблюдавате производителността на системата в реално време.
Персонализиране на брандирането
На тази страница
Разделът Branding в FASTPANEL® позволява да персонализирате визуалния облик и стила на контролния панел. Това меню се намира в "Settings" → "Main" → "Branding".
Цветови схеми
Отидете в раздела "Color schemes", за да промените основната цветова тема на панела. Изберете от разнообразие от предварително зададени цветови палитри (напр. синя, оранжева, червена, зелена).
Настройте Theme:
- Light: Използвайте светла тема
- Dark: Превключете към тъмен режим
- Like on the device: Автоматично се адаптира към настройките на устройството на потребителя
Персонализиране на логото
Разделът "Logo" позволява качване на персонализирано лого за различни области на панела.
Login Screen
Могат да бъдат качени отделни лога за темите Light и Dark.
Използвайте бутона Upload, за да добавите ново лого, или Reset, за да върнете настройката по подразбиране.
- Поддържани формати: jpeg, png, svg, webp
- Максимална резолюция: 256x100 пиксела
- Максимален размер на файла: 5 MB
Header Logo
Показва се в заглавната част на контролния панел.
- Поддържани формати: jpeg, png, svg, webp
- Максимална резолюция: 200x22 пиксела
- Максимален размер на файла: 5 MB
Персонализиране на favicon
Разделът "Favicon" позволява качване на favicon, който се показва в разделите на браузъра и в резултатите от търсенето.
Използвайте бутона Upload, за да добавите favicon, или Reset, за да върнете настройката по подразбиране.
- Поддържан формат: ico
- Максимален размер на файла: 1 MB
Персонализиране на връзките
Разделът "Links" предоставя полета за персонализиране на връзките в страничното меню.
- Knowledge base: URL адрес за достъп до базата знания
След като промените връзките, щракнете върху Save, за да приложите промените.
FASTPANEL Extended
FASTPANEL Extended е включена по подразбиране за всички потребители. Не е необходимо активиране на лиценз.
Известия за сървъра
На тази страница
FASTPANEL Extended е включена по подразбиране за всички потребители. Не е необходимо активиране на лиценз.
FASTPANEL® позволява наблюдение на ключови показатели на сървъра: натоварване на CPU, Load Average 5, използване на диска и използване на RAM. Когато даден показател надвиши праговата си стойност, известията се изпращат автоматично до Telegram или Slack. Конфигурацията се намира в "Settings" → "Notifications".
Тази статия обяснява как да настроите канали за доставка и да конфигурирате параметрите на известията, включително прагове и тригери.
Настройка на канали
Telegram
- Създайте нов бот чрез официалния бот на Telegram @BotFather. Следвайте връзката и натиснете бутона "Start"
- Въведете
/newbotи натиснете Enter. - Въведете желаното име за вашия бот и натиснете Enter.
- Въведете желаното потребителско име за вашия бот. То трябва да завършва с
bot, след което натиснете Enter. - Ще получите съобщение, започващо с:
Done! Congratulations on your new bot. - Натиснете синия ред след
Use this token to access the HTTP API:(замъглен на екранната снимка), за да копирате API токена на вашия бот в клипборда. Пазете токена в безопасност, тъй като всеки, който го притежава, може да управлява вашия бот
API токенът се съхранява в @BotFather. Ако го забравите, изпратете командата /mybots, изберете вашия бот и натиснете бутона "API Token".
- Отворете FASTPANEL® и отидете в "Settings" → "Notifications".
- Натиснете бутона "Create channel"
- Попълнете следните полета:
- Name — Въведете име на канала, за да го различавате визуално
- Channel — Изберете "Telegram"
- Bot token — Поставете токена на бота, копиран в стъпка 6
- Problem period — Задайте интервала от време (в минути), след който ще бъде изпратено известие, ако проблемът продължава. Минималната стойност е 1 минута
- Notification repeat interval — Задайте интервала между последователните известия за един и същ проблем
- Notify about solved problems — Активирайте тази опция, за да получавате известие, когато проблемът бъде отстранен
- Add basic triggers — Активирайте тази опция, за да се създадат автоматично тригери за всички дискове, RAM и CPU
- Натиснете бутона "Save".
- На следващия екран натиснете бутона "Invite", за да поканите вашия бот в чата или груповия чат
- Ще се отвори връзка в нов раздел. Потвърдете пренасочването към приложението Telegram Desktop
- Натиснете бутона "Start", за да активирате вашия бот
- За да проверите дали настройката е правилна, върнете се в раздела FASTPANEL® и натиснете бутона със самолетче
- Ако всичко е конфигурирано правилно, в чата с вашия бот ще бъде изпратено тестово известие
- За да коригирате настройките на канала по-късно, натиснете иконата с молив до канала
- По-долу е даден пример за известие, генерирано при активиране на тригер
Slack
- Влезте в акаунта си и създайте приложение в Slack чрез страницата за приложения.
- Изберете "From scratch".
- Въведете App Name, изберете workspace, в което ще бъде създадено приложението, и натиснете “Create app”.
- В секцията “Features” отворете “Incoming Webhooks” и активирайте функцията
- В долната част на същата страница натиснете “Add New Webhook”
- На следващия екран изберете канала, в който ще се изпращат известията. Препоръчително е да създадете отделен канал за известия. След това натиснете “Allow”.
- Ще бъдете пренасочени обратно към страницата с webhooks. Превъртете надолу и натиснете “Copy”, за да копирате webhook URL адреса
- Отворете FASTPANEL® и отидете в "Settings" → "Notifications".
- Натиснете бутона "Create channel"
- Попълнете следните полета:
- Name — Въведете име на канала, за да го различавате визуално
- Channel — Изберете "Slack"
- Webhook url — Поставете webhook URL адреса, копиран в стъпка 7
- Problem period — Задайте интервала от време (в минути), след който ще бъде изпратено известие, ако проблемът продължава. Минималната стойност е 1 минута
- Notification repeat interval — Задайте интервала между последователните известия за един и същ проблем
- Notify about solved problems — Активирайте тази опция, за да получавате известие, когато проблемът бъде отстранен
- Add basic triggers — Активирайте тази опция, за да се създадат автоматично тригери за всички дискове, RAM и CPU
- Натиснете бутона "Save".
- За да проверите дали настройката е правилна, натиснете бутона със самолетче
- Ако всичко е конфигурирано правилно, тестово известие ще бъде изпратено в канала, избран в стъпка 6
- За да коригирате настройките на канала по-късно, натиснете иконата с молив до канала
- По-долу е даден пример за известие, генерирано при активиране на тригер
Конфигуриране на тригери
За да конфигурирате тригерите, натиснете иконата зъбно колело на реда на канала, който искате да редактирате
В отворената секция можете да:
- Деактивирате ненужните тригери чрез превключвателя вляво.
- Създадете нов тригер от един от следните типове: CPU, Disk (за всеки диск поотделно), Load Average 5 (средно натоварване на системата за последните 5 минути), RAM.
- Редактирате съществуващите тригери
Праговете за CPU, Disk и RAM се задават в проценти. Прагът за Load Average 5 се задава в цели числа.
Като общо правило нормалната стойност на Load Average 5 е приблизително равна на броя на CPU ядрата на сървъра или до два пъти този брой.
Node.js
На тази страница
FASTPANEL Extended е включена по подразбиране за всички потребители. Не е необходимо активиране на лиценз.
Въведение
Node.js е сървърна платформа, която изпълнява приложения, написани на JavaScript.
Първо трябва да инсталирате Node.js:
- Отидете в "Настройки" -> "Приложения"
- Щракнете върху бутона "Инсталиране" за необходимата версия на Node.js
Създайте уебсайт:
- Изберете шаблон за уебсайт на Node.js
- Посочете домейна и свързаните параметри. На етапа на конфигуриране можете да промените DB, FTP потребителя и Backend
- Качете файловете на приложението в директорията на уебсайта
- За да инсталирате зависимостите, изпълнете
npm20.15.1 installв Terminal (необходимо е да инсталирате приложението ttyd за FASTPANEL®)
- Рестартирайте Node.js, като отидете в таблото за управление на сайта и след това отворите раздела "Услуги".
Фреймуърк Express
Нека, използвайки фреймуърка Express като пример, създадем прост уеб сървър:
- Свържете се със сървъра чрез SSH като потребителя, който притежава сайта (можете да използвате приложението ttyd за FASTPANEL®)
- Създайте файл
app.jsв директорията на уебсайта и го попълнете със следния код:
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}`);
});
- В директорията на уебсайта изпълнете командата за инсталиране на express
npm20.15.1 install express- Отидете в таблото за управление на сайта, след това в раздела Services
- Рестартирайте услугата
- Проверете уебсайта
Docusaurus
Нека, използвайки уеб приложението Docusaurus като пример, конфигурираме настройките:
- Свържете се със сървъра чрез SSH като потребителя, който притежава сайта (можете да използвате приложението ttyd за FASTPANEL®)
- В директорията на уебсайта стартирайте инсталирането на Docusaurus
npx20.15.1 create-docusaurus -j ./docs-
Когато бъдете подканени да изберете шаблон, отговорете classic (recommended)
-
След инсталирането заменете един ред във файла
docs/package.json
"start": "docusaurus start",
# replace with
"start": "docusaurus start --port $SERVICE_PORT",$SERVICE_PORT е системна променлива, зададена във FASTPANEL®
-
В контролния панел отидете в "настройки на сайта" -> "Backend"
-
Изберете обработчика Standalone или PM2.
-
Изберете желаната версия на Node.js.
-
Посочете работната папка
docs -
В полето Launch command въведете:
npm run start -
Запазете. Изчакайте приложението да се компилира (информация ще се появи в логовете). Проверете уебсайта
Next.js
Използвайки Next.js с Node.js 20.19 като пример, нека създадем прост уеб сървър:
- Свържете се със сървъра чрез SSH като потребителя, който притежава уебсайта (можете също да използвате приложението ttyd в FASTPANEL®).
- В директорията на уебсайта изпълнете командата за инициализиране на проекта:
yarn20.19.4 init -y
yarn20.19.4 add next react react-dom- Добавете блок scripts към файла
package.json:
"scripts": {
"dev": "next dev -p $SERVICE_PORT",
"build": "next build",
"start": "next start -p $SERVICE_PORT"
}- Създайте директория
pagesи в нея добавете файл с име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- Стартирайте компилацията на проекта.
yarn20.19.4 build- В контролния панел отидете в "настройки на сайта" -> "Backend"
- Изберете обработчика Standalone или PM2.
- Изберете желаната версия на Node.js.
- В полето Launch command въведете:
yarn run start. - Запазете. Изчакайте приложението да се компилира (информация ще се появи в логовете). Проверете уебсайта
Допълнителна информация
В режим Standalone се стартира процес на Node.js за изпълнение на вашите скриптове.
В режим PM2 се използва мениджърът на процеси PM2 за управление на процесите на Node.js, логовете и системното натоварване.
Този режим също така ви позволява да посочите броя на работните процеси — тоест броя на процесите на Node.js, които обработват входящите заявки към сървъра.
Освен това този режим предоставя опцията Enable file watch — PM2 автоматично рестартира вашето приложение, когато файл бъде променен в текущата директория или нейните поддиректории. Моля, имайте предвид, че този режим води до допълнително системно натоварване и не се препоръчва за производствени среди.
По подобен начин можете да конфигурирате приложението, ако то изисква YARN вместо NPM
Можете да инсталирате зависимостите на вашия проект, изброени в package.json, като използвате YARN или NPM директно от FASTPANEL®. За да направите това, отворете картата на уебсайта и отидете в раздела Services:
Логове
Приложение на Node.js може да генерира логове. В FASTPANEL® те се намират в таблото за управление на сайта, в раздела Logs, под таба "Backend log"
Команди в конзолата
След инсталиране на Node.js в FASTPANEL® потребителите могат да работят по своите проекти, използвайки команди в конзолата като:
- pm2
- yarn20.15.1
- npx20.15.1
- npm20.15.1
- node20.15.1
Пример:
$ 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 │
└────┴─────────────┴─────────────┴─────────┴─────────┴──────────┴────────┴──────┴───────────┴──────────┴──────────┴──────────┴──────────┘Името на всяка команда включва номера на версията на инсталирания Node.js. В този пример наличната версия е Node.js 20.15.1.
Статистика за използването на диска
FASTPANEL Extended е включена по подразбиране за всички потребители. Не е необходимо активиране на лиценз.
FASTPANEL® включва функцията Статистика за използването на диска, която ви позволява бързо да видите кои файлове и директории заемат място в потребителските директории на вашите уебсайтове.
За да използвате тази функция, отворете "Управление" → "Файлов мениджър" и щракнете върху кръглата икона в горния десен ъгъл
На следващия екран ще видите подробна статистика за използването на диска, включително Директории, Най-големи файлове и Статистика по разширения.
- Щракнете върху иконата на папка в горния десен ъгъл, за да се върнете към файловия мениджър.
- Щракнете върху иконата за опресняване (кръгови стрелки) в горния десен ъгъл, за да презаредите данните.
- Щракнете върху потребителското име в горния ляв ъгъл, за да превключвате между началните директории на различни потребители; статистиката ще се актуализира съответно.
Статистика на пощата
На тази страница
FASTPANEL Extended е включена по подразбиране за всички потребители. Не е необходимо активиране на лиценз.
FASTPANEL® включва функцията Статистика на пощата, която ви позволява лесно да наблюдавате активността на изходящите имейли за цял домейн или отделни пощенски кутии. Можете бързо да видите колко съобщения са били изпратени, доставени или върнати, както и да прегледате подробни SMTP кодове за грешки с препоръки, обясняващи защо определени имейли са били отхвърлени.
Конфигуриране на автоматичното събиране на статистика
- За да активирате автоматичното събиране на статистика за пощата, отидете на "Настройки" → "Поща" → "Статистика" и превключете опцията "Активиране на събирането на статистика".
Ако предпочитате да не събирате данни автоматично, деактивирайте тази опция. След това ще трябва ръчно да щракнете върху бутона "Актуализиране" в изгледа за статистика (вижте следващия раздел), за да обновите данните.
-
Можете да определите колко често статистиката да се актуализира автоматично — от всеки 1 час до всеки 24 часа.
-
За да запазите настройките си, не забравяйте да щракнете върху бутона "Запазване".
Изглед за статистика
За да прегледате статистиката, отидете на "Управление" → "Поща" и щракнете върху иконата на графика до домейна, който искате да анализирате.
Изгледът за статистика е разделен на три основни секции, които са описани подробно по-долу.
Графика на статистиката
Показва общия брой изпратени, доставени и върнати съобщения за избрания период от време. Графиката ви помага да идентифицирате тенденции и проблеми с доставката с един поглед.
Можете да персонализирате показаните данни чрез:
-
Избиране на пощенски домейн.
-
Избиране на статистика за целия домейн или конкретна пощенска кутия.
-
Избор на времеви диапазон за отчета — от последните 24 часа до последния месец.
-
Щракване върху бутона "Актуализиране" за ръчно обновяване на статистиката и извличане на най-новите данни.
Най-чести причини за върнати съобщения
Изброява най-честите причини за неуспешно доставяне на съобщения, заедно със съответните им SMTP кодове за грешки. Това ви позволява да разберете и отстраните повтарящи се проблеми.
Събития при изходящи грешки
Предоставя подробна информация за всяко отхвърлено или недоставено съобщение с препоръчителни действия за разрешаване на проблемите.
За всеки запис се показват следните подробности:
-
Дата/Час — точният момент, когато е направен опитът за доставка
-
Queue ID — уникалният идентификатор на съобщението в пощенската опашка
-
From / From domain / To — адреси на подателя и получателя, както и домейнът на произход
-
SMTP code — кодът за отговор, върнат от пощенския сървър на получателя (например 550-5.7.26)
-
Advice — кратко обяснение на проблема и препоръчително действие (напр. “Съобщението е отхвърлено от Gmail: липсваща или неуспешна SPF/DKIM автентикация”)
-
Detail — пълният текст на SMTP отговора, който може да включва връзка към външна документация от сървъра на получателя (например страниците за поддръжка на Gmail)
-
Unknown code — показва дали SMTP отговорът не е могъл да бъде класифициран
-
Bytes — размер на имейл съобщението
-
Retry count — брой опити за доставка, направени преди съобщението да бъде окончателно отхвърлено
-
Last try — времеви отпечатък на последния опит за доставка
-
Spam score — резултат от оценката за спам, ако е приложимо
Тези данни предоставят цялостен преглед на проблемите с изходящата доставка, като ви помагат да диагностицирате проблеми с автентикацията, репутацията или конфигурацията.
FASTPANEL