FASTPANELWIKI

Возможности Extended

Prometheus

На этой странице
информация

FASTPANEL Extended включена по умолчанию для всех пользователей. Активировать лицензию не требуется.

Интеграция FASTPANEL с Prometheus для сбора метрик

FASTPANEL® теперь поддерживает интеграцию с Prometheus для сбора системных метрик. Это руководство поможет вам выполнить шаги, необходимые для добавления вашего экземпляра FASTPANEL® в Prometheus, чтобы вы могли собирать и отслеживать системные метрики в реальном времени.

Создайте токен

Чтобы разрешить Prometheus собирать метрики, необходимо создать специальный токен с ограниченным доступом:

  1. Подключитесь к вашему серверу FASTPANEL® по SSH.

  2. Выполните следующую команду, чтобы создать токен:

mogwai users tokens add -n metrics_test_token -s read_only -s metrics_only
  • metrics_test_token — это пользовательское имя токена; вы можете выбрать любое имя
  • Токену будут назначены следующие области доступа:
    • read_only — доступ только для чтения
    • metrics_only — доступ только к метрикам

Добавьте задание в Prometheus

После создания токена необходимо настроить Prometheus, чтобы он начал собирать метрики с вашего экземпляра FASTPANEL®.

Откройте файл конфигурации Prometheus и добавьте новое задание:

- 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 — пользовательское имя задания
  • 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® включает функцию Статистика использования диска, которая позволяет быстро увидеть, какие файлы и каталоги занимают место в пользовательских каталогах ваших веб-сайтов.

Чтобы использовать эту функцию, откройте "Управление" → "Файловый менеджер" и нажмите круглую иконку в правом верхнем углу

На следующем экране вы увидите подробную статистику использования диска, включая Каталоги, Крупнейшие файлы и Статистику расширений.

  1. Нажмите на иконку папки в правом верхнем углу, чтобы вернуться в файловый менеджер.
  2. Нажмите на иконку обновления (круговые стрелки) в правом верхнем углу, чтобы перезагрузить данные.
  3. Нажмите на имя пользователя в левом верхнем углу, чтобы переключаться между домашними каталогами разных пользователей; статистика будет обновляться соответствующим образом.

Статистика почты

На этой странице
информация

FASTPANEL Extended включена по умолчанию для всех пользователей. Активировать лицензию не требуется.

FASTPANEL® включает функцию Статистика почты, которая позволяет легко отслеживать активность исходящих электронных писем для всего домена или отдельных почтовых ящиков. Вы можете быстро увидеть, сколько сообщений было отправлено, доставлено или отклонено, а также просмотреть подробные коды ошибок SMTP с рекомендациями, объясняющими, почему некоторые письма были отклонены.

Настройка автоматического сбора статистики

  1. Чтобы включить автоматический сбор статистики почты, перейдите в "Настройки" → "Почта" → "Статистика" и включите опцию "Включить сбор статистики".

Если вы предпочитаете не собирать данные автоматически, отключите эту опцию. Тогда вам нужно будет вручную нажимать кнопку "Обновить" в представлении статистики (см. следующий раздел), чтобы обновить данные.

  1. Вы можете определить, как часто статистика будет обновляться автоматически — от каждого 1 часа до каждых 24 часов.

  2. Чтобы сохранить настройки, не забудьте нажать кнопку "Сохранить".

Представление статистики

Чтобы просмотреть статистику, перейдите в "Управление" → "Почта" и нажмите на значок графика рядом с доменом, который вы хотите проанализировать.

Представление статистики разделено на три основных раздела, которые подробно описаны ниже.

График статистики

Отображает общее количество отправленных, доставленных и отклонённых сообщений за выбранный период времени. График помогает с первого взгляда выявлять тенденции и проблемы с доставкой.

Вы можете настроить отображаемые данные следующим образом:

  1. Выбрать почтовый домен.

  2. Выбрать статистику для всего домена или конкретного почтового ящика.

  3. Выбрать диапазон времени для отчёта — от последних 24 часов до последнего месяца.

  4. Нажать кнопку "Обновить", чтобы вручную обновить статистику и получить последние данные.

Основные причины отклонения

Перечисляет наиболее частые причины сбоев доставки сообщений вместе с соответствующими кодами ошибок SMTP. Это позволяет понять и устранить повторяющиеся проблемы.

События ошибок исходящей почты

Предоставляет подробную информацию о каждом отклонённом или недоставленном сообщении с рекомендуемыми действиями для устранения проблем.

Для каждой записи отображаются следующие сведения:

  • Дата/время — точное время, когда произошла попытка доставки

  • ID очереди — уникальный идентификатор сообщения в почтовой очереди

  • От / Домен отправителя / Кому — адреса отправителя и получателя, а также домен-источник

  • Код SMTP — код ответа, возвращённый почтовым сервером получателя (например, 550-5.7.26)

  • Совет — краткое объяснение проблемы и рекомендуемое действие (например, «Сообщение отклонено Gmail: отсутствует или не проходит аутентификация SPF/DKIM»)

  • Подробности — полный текст ответа SMTP, который может включать ссылку на внешнюю документацию сервера получателя (например, страницы поддержки Gmail)

  • Неизвестный код — указывает, не удалось ли классифицировать ответ SMTP

  • Байты — размер сообщения электронной почты

  • Количество повторных попыток — число попыток доставки, выполненных до того, как сообщение было окончательно отклонено

  • Последняя попытка — метка времени последней попытки доставки

  • Оценка спама — результат проверки на спам, если применимо

Эти данные предоставляют всесторонний обзор проблем с исходящей доставкой и помогают диагностировать проблемы аутентификации, репутации или конфигурации.

Уведомления сервера

На этой странице
информация

FASTPANEL Extended включена по умолчанию для всех пользователей. Активировать лицензию не требуется.

FASTPANEL® позволяет отслеживать ключевые метрики сервера: нагрузку CPU, Load Average 5, использование диска и потребление RAM. Когда метрика превышает свой порог, оповещения автоматически отправляются в Telegram или Slack. Настройка находится в разделе "Настройки" → "Уведомления".

В этой статье объясняется, как настроить каналы доставки и параметры уведомлений, включая пороги и триггеры.

Настройка канала

Telegram

  1. Создайте нового бота с помощью официального бота Telegram @BotFather. Перейдите по ссылке и нажмите кнопку "Start"
  1. Введите /newbot и нажмите Enter.
  2. Введите желаемое имя для вашего бота и нажмите Enter.
  3. Введите желаемое имя пользователя для вашего бота. Оно должно заканчиваться на bot, затем нажмите Enter.
  4. Вы получите сообщение, начинающееся с:
    Done! Congratulations on your new bot.
  5. Нажмите на синюю строку после Use this token to access the HTTP API: (размыта на скриншоте), чтобы скопировать API-токен вашего бота в буфер обмена. Храните токен в безопасности, так как любой, у кого он есть, может управлять вашим ботом
примечание

API-токен хранится в @BotFather. Если вы его забыли, отправьте команду /mybots, выберите своего бота и нажмите кнопку "API Token".

  1. Откройте FASTPANEL® и перейдите в раздел "Настройки" → "Уведомления".
  2. Нажмите кнопку "Создать канал"
  1. Заполните следующие поля:
  • Name — Введите название канала, чтобы визуально отличать его
  • Channel — Выберите "Telegram"
  • Bot token — Вставьте токен бота, скопированный на шаге 6
  • Problem period — Укажите интервал времени (в минутах), по истечении которого будет отправлено уведомление, если проблема сохраняется. Минимальное значение — 1 минута
  • Notification repeat interval — Укажите интервал между последовательными уведомлениями об одной и той же проблеме
  • Notify about solved problems — Включите эту опцию, чтобы получать уведомление, когда проблема будет решена
  • Add basic triggers — Включите эту опцию, чтобы автоматически создать триггеры для всех дисков, RAM и CPU
  1. Нажмите кнопку "Сохранить".
  2. На следующем экране нажмите кнопку "Invite", чтобы пригласить бота в чат или групповой чат
  1. Ссылка откроется в новой вкладке. Подтвердите переход в приложение Telegram Desktop
  1. Нажмите кнопку "Start", чтобы активировать вашего бота
  1. Чтобы убедиться, что настройка выполнена правильно, вернитесь на вкладку FASTPANEL® и нажмите кнопку с бумажным самолётиком
  1. Если всё настроено правильно, тестовое уведомление будет отправлено в чат с вашим ботом
  1. Чтобы позже изменить настройки канала, нажмите значок карандаша рядом с каналом
  1. Ниже приведён пример уведомления, созданного при срабатывании триггера

Slack

  1. Войдите в свою учётную запись и создайте приложение Slack через страницу приложений.
  2. Выберите "From scratch".
  3. Введите App Name, выберите рабочее пространство, в котором будет создано приложение, и нажмите “Create app”.
  4. В разделе “Features” откройте “Incoming Webhooks” и включите эту функцию
  1. Внизу этой же страницы нажмите “Add New Webhook”
  1. На следующем экране выберите канал, в который будут отправляться уведомления. Рекомендуется создать отдельный канал для оповещений. Затем нажмите “Allow”.
  2. Вы будете перенаправлены обратно на страницу вебхуков. Прокрутите вниз и нажмите “Copy”, чтобы скопировать URL вебхука
  1. Откройте FASTPANEL® и перейдите в раздел "Настройки" → "Уведомления".
  2. Нажмите кнопку "Создать канал"
  1. Заполните следующие поля:
  • Name — Введите название канала, чтобы визуально отличать его
  • Channel — Выберите "Slack"
  • Webhook url — Вставьте URL вебхука, скопированный на шаге 7
  • Problem period — Укажите интервал времени (в минутах), по истечении которого будет отправлено уведомление, если проблема сохраняется. Минимальное значение — 1 минута
  • Notification repeat interval — Укажите интервал между последовательными уведомлениями об одной и той же проблеме
  • Notify about solved problems — Включите эту опцию, чтобы получать уведомление, когда проблема будет решена
  • Add basic triggers — Включите эту опцию, чтобы автоматически создать триггеры для всех дисков, RAM и CPU
  1. Нажмите кнопку "Сохранить".
  2. Чтобы убедиться, что настройка выполнена правильно, нажмите кнопку с бумажным самолётиком
  1. Если всё настроено правильно, тестовое уведомление будет отправлено в канал, выбранный на шаге 6
  1. Чтобы позже изменить настройки канала, нажмите значок карандаша рядом с каналом
  1. Ниже приведён пример уведомления, созданного при срабатывании триггера

Настройка триггеров

Чтобы настроить триггеры, нажмите значок шестерёнки в строке канала, который вы хотите изменить

В открывшемся разделе вы можете:

  1. Отключить ненужные триггеры с помощью переключателя слева.
  2. Создать новый триггер одного из следующих типов: CPU, Disk (для каждого диска отдельно), Load Average 5 (средняя нагрузка на систему за последние 5 минут), RAM.
  3. Редактировать существующие триггеры

Пороги для CPU, Disk и RAM задаются в процентах. Порог для Load Average 5 задаётся в целых значениях.

примечание

Как правило, нормальное значение Load Average 5 примерно равно количеству ядер CPU на сервере или до двухкратного значения этого количества.

Node.js

На этой странице
информация

FASTPANEL Extended включена по умолчанию для всех пользователей. Активировать лицензию не требуется.

Введение

Node.js — это серверная платформа, которая запускает приложения, написанные на JavaScript.

Сначала необходимо установить Node.js:

  • Перейдите в "Настройки" -> "Приложения"
  • Нажмите кнопку "Установить" для нужной версии Node.js

Создайте веб-сайт:

  • Выберите шаблон для веб-сайта Node.js
  • Укажите домен и связанные параметры. На этапе конфигурации вы можете изменить БД, 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
  • Перейдите в карточку сайта, затем в раздел Сервисы
  • Перезапустите сервис
  • Проверьте веб-сайт

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

  • В поле команды запуска введите: 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.
  • В поле команды запуска введите: yarn run start.
  • Сохраните. Дождитесь компиляции приложения (информация появится в логах). Проверьте веб-сайт

Дополнительная информация

В режиме Standalone запускается процесс Node.js для выполнения ваших скриптов.

В режиме PM2 для управления процессами Node.js, логами и системной нагрузкой используется менеджер процессов PM2.
Этот режим также позволяет указать количество workers — то есть число процессов Node.js, обрабатывающих входящие запросы к серверу.
Кроме того, в этом режиме доступна опция Enable file watch — PM2 автоматически перезапускает ваше приложение при изменении файла в текущей директории или её поддиректориях. Обратите внимание, что этот режим создаёт дополнительную нагрузку на систему и не рекомендуется для production-окружений.

Аналогично можно настроить приложение, если ему требуется YARN вместо NPM

Вы можете установить зависимости вашего проекта, перечисленные в package.json, с помощью YARN или NPM напрямую из FASTPANEL®. Для этого откройте карточку веб-сайта и перейдите в раздел Сервисы:

Логи

Приложение Node.js может создавать логи. В FASTPANEL® они находятся в карточке сайта, в разделе Логи, на вкладке "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.