Fonctionnalités d’Extended
- Installer une application Node.js
- FASTPANEL Extended
- Notifications du serveur
- Personnalisation de marque
- Prometheus
- Statistiques d'utilisation du disque
- Statistiques des e-mails
Node.js
Sur cette page
FASTPANEL Extended est activée par défaut pour tout le monde. Aucune activation de licence n’est nécessaire.
Introduction
Node.js est une plateforme serveur qui exécute des applications écrites en JavaScript.
Tout d’abord, vous devez installer Node.js :
- Allez dans "Paramètres" -> "Applications"
- Cliquez sur le bouton "Installer" pour la version requise de Node.js
Créez un site web :
- Sélectionnez un modèle pour un site web Node.js
- Indiquez le domaine et les paramètres associés. À l’étape de configuration, vous pouvez modifier la BD, l’utilisateur FTP et le Backend
- Téléversez les fichiers de l’application dans le répertoire du site web
- Pour installer les dépendances, exécutez
npm20.15.1 installdans le Terminal (il faut installer l’application ttyd pour FASTPANEL®)
- Redémarrez Node.js en accédant au tableau de bord du site puis en ouvrant la section "Services".
Framework Express
En prenant le framework Express comme exemple, créons un serveur web simple :
- Connectez-vous au serveur via SSH en tant qu’utilisateur propriétaire du site (vous pouvez utiliser l’application ttyd pour FASTPANEL®)
- Créez un fichier
app.jsdans le répertoire du site web et remplissez-le avec le code suivant :
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}`);
});
- Dans le répertoire du site web, exécutez la commande pour installer express
npm20.15.1 install express- Allez dans le tableau de bord du site, puis dans la section Services
- Redémarrez le service
- Vérifiez le site web
Docusaurus
En prenant l’application web Docusaurus comme exemple, configurons les paramètres :
- Connectez-vous au serveur via SSH en tant qu’utilisateur propriétaire du site (vous pouvez utiliser l’application ttyd pour FASTPANEL®)
- Dans le répertoire du site web, lancez l’installation de Docusaurus
npx20.15.1 create-docusaurus -j ./docs-
Lorsqu’il vous est demandé de sélectionner un modèle, répondez classic (recommended)
-
Après l’installation, remplacez une ligne dans le fichier
docs/package.json
"start": "docusaurus start",
# replace with
"start": "docusaurus start --port $SERVICE_PORT",$SERVICE_PORT est une variable système définie dans FASTPANEL®
-
Dans le panneau de contrôle, allez dans "paramètres du site" -> "Backend"
-
Sélectionnez le gestionnaire Standalone ou PM2.
-
Choisissez la version souhaitée de Node.js.
-
Indiquez le dossier de travail
docs -
Dans le champ Commande de lancement, saisissez :
npm run start -
Enregistrez. Attendez que l’application soit compilée (les informations apparaîtront dans les journaux). Vérifiez le site web
Next.js
En prenant Next.js avec Node.js 20.19 comme exemple, créons un serveur web simple :
- Connectez-vous au serveur via SSH en tant qu’utilisateur propriétaire du site web (vous pouvez également utiliser l’application ttyd dans FASTPANEL®).
- Dans le répertoire du site web, exécutez la commande d’initialisation du projet :
yarn20.19.4 init -y
yarn20.19.4 add next react react-dom- Ajoutez un bloc scripts au fichier
package.json:
"scripts": {
"dev": "next dev -p $SERVICE_PORT",
"build": "next build",
"start": "next start -p $SERVICE_PORT"
}- Créez un répertoire
pageset, à l’intérieur, ajoutez un fichier nommé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- Lancez la construction du projet.
yarn20.19.4 build- Dans le panneau de contrôle, allez dans "paramètres du site" -> "Backend"
- Sélectionnez le gestionnaire Standalone ou PM2.
- Choisissez la version souhaitée de Node.js.
- Dans le champ Commande de lancement, saisissez :
yarn run start. - Enregistrez. Attendez que l’application soit compilée (les informations apparaîtront dans les journaux). Vérifiez le site web
Informations supplémentaires
En mode Standalone, un processus Node.js est lancé pour exécuter vos scripts.
En mode PM2, le gestionnaire de processus PM2 est utilisé pour gérer les processus Node.js, les journaux et la charge système.
Ce mode vous permet également de spécifier le nombre de workers — c’est-à-dire le nombre de processus Node.js traitant les requêtes entrantes vers le serveur.
De plus, ce mode fournit l’option Activer la surveillance des fichiers — PM2 redémarre automatiquement votre application lorsqu’un fichier est modifié dans le répertoire actuel ou dans ses sous-répertoires. Veuillez noter que ce mode entraîne une charge système supplémentaire et n’est pas recommandé pour les environnements de production.
De la même manière, vous pouvez configurer l’application si elle nécessite YARN au lieu de NPM
Vous pouvez installer les dépendances de votre projet répertoriées dans package.json à l’aide de YARN ou de NPM directement depuis FASTPANEL®. Pour ce faire, ouvrez la fiche du site web et accédez à la section Services :
Journaux
Une application Node.js peut générer des journaux. Dans FASTPANEL®, ils se trouvent dans le tableau de bord du site, dans la section Journaux, sous l’onglet "Journal Backend"
Commandes de console
Après l’installation de Node.js dans FASTPANEL®, les utilisateurs peuvent travailler avec leurs projets à l’aide de commandes de console telles que :
- pm2
- yarn20.15.1
- npx20.15.1
- npm20.15.1
- node20.15.1
Exemple :
$ 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 │
└────┴─────────────┴─────────────┴─────────┴─────────┴──────────┴────────┴──────┴───────────┴──────────┴──────────┴──────────┴──────────┘Chaque nom de commande inclut le numéro de version de Node.js qui a été installé. Dans cet exemple, la version disponible est Node.js 20.15.1.
FASTPANEL Extended
FASTPANEL Extended est activée par défaut pour tout le monde. Aucune activation de licence n’est nécessaire.
Notifications du serveur
FASTPANEL Extended est activée par défaut pour tout le monde. Aucune activation de licence n’est nécessaire.
FASTPANEL® permet de surveiller les métriques clés du serveur : charge CPU, Load Average 5, utilisation du disque et consommation de RAM. Lorsqu’une métrique dépasse son seuil, des alertes sont envoyées automatiquement à Telegram ou Slack. La configuration se trouve dans "Paramètres" → "Notifications".
Cet article explique comment configurer les canaux de livraison et les paramètres de notification, y compris les seuils et les déclencheurs.
Configuration du canal
Telegram
- Créez un nouveau bot à l’aide du bot officiel Telegram @BotFather. Suivez le lien et cliquez sur le bouton "Start"
- Saisissez
/newbotet appuyez sur Entrée. - Saisissez le nom souhaité pour votre bot et appuyez sur Entrée.
- Saisissez le nom d’utilisateur souhaité pour votre bot. Il doit se terminer par
bot, puis appuyez sur Entrée. - Vous recevrez un message commençant par :
Done! Congratulations on your new bot. - Cliquez sur la ligne bleue après
Use this token to access the HTTP API:(floutée sur la capture d’écran) pour copier le jeton API de votre bot dans le presse-papiers. Conservez le jeton en lieu sûr, car toute personne en sa possession peut contrôler votre bot
Le jeton API est stocké dans @BotFather. Si vous l’oubliez, envoyez la commande /mybots, sélectionnez votre bot et cliquez sur le bouton "API Token".
- Ouvrez FASTPANEL® et accédez à "Paramètres" → "Notifications".
- Cliquez sur le bouton "Create channel"
- Remplissez les champs suivants :
- Name — Saisissez un nom pour le canal afin de le distinguer visuellement
- Channel — Choisissez "Telegram"
- Bot token — Collez le jeton du bot copié à l’étape 6
- Problem period — Définissez l’intervalle de temps (en minutes) après lequel une notification sera envoyée si le problème persiste. La valeur minimale est de 1 minute
- Notification repeat interval — Définissez l’intervalle entre les notifications consécutives pour le même problème
- Notify about solved problems — Activez cette option pour recevoir une notification lorsque le problème est résolu
- Add basic triggers — Activez cette option pour créer automatiquement des déclencheurs pour tous les disques, la RAM et le CPU
- Cliquez sur le bouton "Save".
- Sur l’écran suivant, cliquez sur le bouton "Invite" pour inviter votre bot dans le chat ou le chat de groupe
- Un lien s’ouvrira dans un nouvel onglet. Confirmez la redirection vers l’application Telegram Desktop
- Cliquez sur le bouton "Start" pour activer votre bot
- Pour vérifier que la configuration est correcte, revenez à l’onglet FASTPANEL® et cliquez sur le bouton en forme d’avion en papier
- Si tout est correctement configuré, une notification de test sera envoyée au chat avec votre bot
- Pour ajuster les paramètres du canal ultérieurement, cliquez sur l’icône en forme de crayon à côté du canal
- Vous trouverez ci-dessous un exemple de notification générée lorsqu’un déclencheur est activé
Slack
- Connectez-vous à votre compte et créez une application Slack via la page des applications.
- Sélectionnez "From scratch".
- Saisissez un App Name, choisissez l’espace de travail dans lequel l’application sera créée, puis cliquez sur “Create app”.
- Dans la section “Features”, ouvrez “Incoming Webhooks” et activez la fonctionnalité
- En bas de la même page, cliquez sur “Add New Webhook”
- Sur l’écran suivant, sélectionnez le canal vers lequel les notifications seront envoyées. Il est recommandé de créer un canal dédié aux alertes. Cliquez ensuite sur “Allow”.
- Vous serez redirigé vers la page des webhooks. Faites défiler vers le bas et cliquez sur “Copy” pour copier l’URL du webhook
- Ouvrez FASTPANEL® et accédez à "Paramètres" → "Notifications".
- Cliquez sur le bouton "Create channel"
- Remplissez les champs suivants :
- Name — Saisissez un nom pour le canal afin de le distinguer visuellement
- Channel — Choisissez "Slack"
- Webhook url — Collez l’URL du webhook copiée à l’étape 7
- Problem period — Définissez l’intervalle de temps (en minutes) après lequel une notification sera envoyée si le problème persiste. La valeur minimale est de 1 minute
- Notification repeat interval — Définissez l’intervalle entre les notifications consécutives pour le même problème
- Notify about solved problems — Activez cette option pour recevoir une notification lorsque le problème est résolu
- Add basic triggers — Activez cette option pour créer automatiquement des déclencheurs pour tous les disques, la RAM et le CPU
- Cliquez sur le bouton "Save".
- Pour vérifier que la configuration est correcte, cliquez sur le bouton en forme d’avion en papier
- Si tout est correctement configuré, une notification de test sera envoyée au canal sélectionné à l’étape 6
- Pour ajuster les paramètres du canal ultérieurement, cliquez sur l’icône en forme de crayon à côté du canal
- Vous trouverez ci-dessous un exemple de notification générée lorsqu’un déclencheur est activé
Configuration des déclencheurs
Pour configurer les déclencheurs, cliquez sur l’icône engrenage dans la ligne du canal que vous souhaitez modifier
Dans la section ouverte, vous pouvez :
- Désactiver les déclencheurs inutiles à l’aide du bouton bascule situé à gauche.
- Créer un nouveau déclencheur de l’un des types suivants : CPU, Disk (pour chaque disque individuellement), Load Average 5 (charge système moyenne au cours des 5 dernières minutes), RAM.
- Modifier les déclencheurs existants
Les seuils pour CPU, Disk et RAM sont définis en pourcentages. Le seuil pour Load Average 5 est défini en valeurs entières.
En règle générale, une valeur normale de Load Average 5 est approximativement égale au nombre de cœurs CPU du serveur, ou jusqu’à deux fois ce nombre.
Personnalisation de la marque
Sur cette page
La section Branding de FASTPANEL® permet de personnaliser l’apparence visuelle et le style du panneau de contrôle. Ce menu se trouve dans "Settings" → "Main" → "Branding".
Schémas de couleurs
Accédez à l’onglet "Color schemes" pour modifier le thème de couleur principal du panneau. Choisissez parmi une variété de palettes de couleurs prédéfinies (par exemple, bleu, orange, rouge, vert).
Ajustez le Theme :
- Light : utiliser un thème clair
- Dark : passer en mode sombre
- Like on the device : s’adapte automatiquement aux paramètres de l’appareil de l’utilisateur
Personnalisation du logo
L’onglet "Logo" permet de téléverser un logo personnalisé pour différentes zones du panneau.
Login Screen
Des logos distincts peuvent être téléversés pour les thèmes Light et Dark.
Utilisez le bouton Upload pour ajouter un nouveau logo ou Reset pour revenir à la valeur par défaut.
- Formats pris en charge : jpeg, png, svg, webp
- Résolution maximale : 256x100 pixels
- Taille maximale du fichier : 5 MB
Header Logo
Affiché dans l’en-tête du panneau de contrôle.
- Formats pris en charge : jpeg, png, svg, webp
- Résolution maximale : 200x22 pixels
- Taille maximale du fichier : 5 MB
Personnalisation du favicon
L’onglet "Favicon" permet de téléverser un favicon, affiché dans les onglets du navigateur et les résultats de recherche.
Utilisez le bouton Upload pour ajouter un favicon ou Reset pour revenir à la valeur par défaut.
- Format pris en charge : ico
- Taille maximale du fichier : 1 MB
Personnalisation des liens
L’onglet "Links" fournit des champs permettant de personnaliser les liens dans le menu latéral.
- Knowledge base : URL pour accéder à la base de connaissances
Après avoir modifié les liens, cliquez sur Save pour appliquer les changements.
Prometheus
Sur cette page
FASTPANEL Extended est activée par défaut pour tout le monde. Aucune activation de licence n’est nécessaire.
Intégration de FASTPANEL à Prometheus pour la collecte de métriques
FASTPANEL® prend désormais en charge l'intégration avec Prometheus pour la collecte des métriques système. Ce guide vous accompagnera à travers les étapes nécessaires pour ajouter votre instance FASTPANEL® à Prometheus, afin de vous permettre de collecter et de surveiller les métriques système en temps réel.
Créer un jeton
Pour permettre à Prometheus de collecter des métriques, vous devez créer un jeton spécial avec un accès limité :
-
Connectez-vous à votre serveur FASTPANEL® via SSH.
-
Exécutez la commande suivante pour créer un jeton :
mogwai users tokens add -n metrics_test_token -s read_only -s metrics_only- metrics_test_token est un nom personnalisé pour le jeton ; vous pouvez choisir n'importe quel nom
- Le jeton se verra accorder les portées suivantes :
- read_only — accès en lecture seule
- metrics_only — accès limité aux métriques
Ajouter un job à Prometheus
Une fois le jeton créé, vous devez configurer Prometheus pour qu'il commence à récupérer les métriques depuis votre instance FASTPANEL®.
Ouvrez votre fichier de configuration Prometheus et ajoutez un nouveau 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 — un nom personnalisé pour le job
- targets — l'adresse IP et le port de votre serveur FASTPANEL®. Remplacez
$IPpar l'adresse IP de votre serveur - metrics_path — le point de terminaison API depuis lequel récupérer les métriques
- bearer_token — remplacez ceci par votre jeton généré (metrics_test_token)
- scrape_interval — la fréquence à laquelle Prometheus doit récupérer les métriques (définie à 60 secondes dans ce cas)
Configurer le tableau de bord de surveillance
Après avoir ajouté avec succès votre instance FASTPANEL® à Prometheus, vous pouvez configurer votre premier tableau de bord pour visualiser les métriques collectées.
Pour importer le tableau de bord, veuillez suivre ce guide.
Prometheus commencera maintenant à collecter les métriques depuis votre instance FASTPANEL®, vous permettant de surveiller les performances du système en temps réel.
Statistiques d'utilisation du disque
FASTPANEL Extended est activée par défaut pour tout le monde. Aucune activation de licence n’est nécessaire.
FASTPANEL® inclut une fonctionnalité de Statistiques d'utilisation du disque qui vous permet de voir rapidement quels fichiers et répertoires consomment de l'espace dans les répertoires utilisateur de vos sites web.
Pour utiliser cette fonctionnalité, ouvrez "Gestion" → "Gestionnaire de fichiers" et cliquez sur l'icône ronde dans le coin supérieur droit
Sur l'écran suivant, vous verrez des statistiques détaillées d'utilisation du disque, y compris les Répertoires, les Principaux fichiers volumineux et les Statistiques des extensions.
- Cliquez sur l'icône de dossier dans le coin supérieur droit pour revenir au gestionnaire de fichiers.
- Cliquez sur l'icône d'actualisation (flèches circulaires) dans le coin supérieur droit pour recharger les données.
- Cliquez sur le nom d'utilisateur dans le coin supérieur gauche pour basculer entre les répertoires personnels des différents utilisateurs ; les statistiques se mettront à jour en conséquence.
Statistiques des e-mails
Sur cette page
FASTPANEL Extended est activée par défaut pour tout le monde. Aucune activation de licence n’est nécessaire.
FASTPANEL® comprend une fonctionnalité Statistiques des e-mails qui vous permet de surveiller facilement l’activité des e-mails sortants pour un domaine entier ou des boîtes mail individuelles. Vous pouvez rapidement voir combien de messages ont été envoyés, distribués ou rejetés, et consulter les codes d’erreur SMTP détaillés avec des recommandations expliquant pourquoi certains e-mails ont été rejetés.
Configurer la collecte automatique des statistiques
- Pour activer la collecte automatique des statistiques des e-mails, accédez à "Paramètres" → "Mail" → "Statistiques" et activez l’option "Activer la collecte des statistiques".
Si vous préférez ne pas collecter les données automatiquement, désactivez cette option. Vous devrez alors cliquer manuellement sur le bouton "Mettre à jour" dans la vue des statistiques (voir la section suivante) pour actualiser les données.
-
Vous pouvez définir la fréquence de mise à jour automatique des statistiques — de 1 heure à 24 heures.
-
Pour enregistrer vos paramètres, n’oubliez pas de cliquer sur le bouton "Enregistrer".
Vue des statistiques
Pour consulter les statistiques, accédez à "Gestion" → "Mail", puis cliquez sur l’icône de graphique à côté du domaine que vous souhaitez analyser.
La vue des statistiques est divisée en trois sections principales, décrites en détail ci-dessous.
Graphique des statistiques
Affiche le nombre total de messages envoyés, distribués et rejetés sur la période sélectionnée. Le graphique vous aide à identifier les tendances et les problèmes de distribution en un coup d’œil.
Vous pouvez personnaliser les données affichées en :
-
Sélection d’un domaine de messagerie.
-
Sélection des statistiques pour l’ensemble du domaine ou pour une boîte mail spécifique.
-
Choix de la plage temporelle du rapport — des dernières 24 heures au dernier mois.
-
Clic sur le bouton "Mettre à jour" pour actualiser manuellement les statistiques et récupérer les données les plus récentes.
Principales raisons de rejet
Liste les causes les plus fréquentes des échecs de distribution des messages, ainsi que leurs codes d’erreur SMTP correspondants. Cela vous permet de comprendre et de traiter les problèmes récurrents.
Événements d’erreur sortants
Fournit des informations détaillées sur chaque message rejeté ou non distribué, avec des actions recommandées pour résoudre les problèmes.
Pour chaque enregistrement, les détails suivants sont affichés :
-
Date/Heure — l’heure exacte à laquelle la tentative de distribution a eu lieu
-
ID de file d’attente — l’identifiant unique du message dans la file d’attente de messagerie
-
De / Domaine d’origine / À — adresses de l’expéditeur et du destinataire, ainsi que le domaine d’origine
-
Code SMTP — le code de réponse renvoyé par le serveur de messagerie du destinataire (par exemple, 550-5.7.26)
-
Conseil — une brève explication du problème et une action recommandée (par exemple, “Message rejeté par Gmail : authentification SPF/DKIM manquante ou défaillante”)
-
Détail — le texte complet de la réponse SMTP, qui peut inclure un lien vers une documentation externe du serveur destinataire (par exemple, les pages d’assistance de Gmail)
-
Code inconnu — indique si la réponse SMTP n’a pas pu être classée
-
Octets — taille du message électronique
-
Nombre de tentatives — nombre de tentatives de distribution effectuées avant que le message ne soit définitivement rejeté
-
Dernière tentative — horodatage de la dernière tentative de distribution
-
Score de spam — résultat de l’évaluation du spam, le cas échéant
Ces données fournissent une vue d’ensemble complète des problèmes de distribution sortante, vous aidant à diagnostiquer les problèmes d’authentification, de réputation ou de configuration.
FASTPANEL