Résumé: Before Node.js applications can be hosted in Plesk, Node.js support must be enabled.

In this topic, you will learn how to enable the support for Node.js hosting in Plesk. You will also learn how to control which Node.js versions are available, whether Node.js is available to customers, and also how to make Node.js applications” logs visible or invisible to customers.

If you want to learn how to host and manage Node.js applications in Plesk, read the Hosting Node.js Applications topic instead.

Activation de la prise en charge Node.js

Before your customers and resellers can host Node.js applications, the free Node.js Toolkit extension must be installed on the Plesk server from the Extensions Catalog <installing-extensions>`.

Gestion des versions de Node.js

Plesk prend en charge les dernières versions et révisions LTS stables de Node.js, avec les restrictions suivantes :

  • (Plesk for Linux) Multiple Node.js versions can be installed simultaneously, and Node.js applications on different domains can use any available Node.js version.
  • (Plesk pour Windows) Une seule version de Node.js peut être installée à la fois, et utilisée pour servir toutes les applications Node.js sur le serveur.

To see what Node.js versions are installed on the server, go to Extensions, open the « My Extensions » tab, and then click Open next to the « Node.js Toolkit » extension.

image nodejs versions

Here you can see the Node.js versions installed on the server. Versions marked with the image enabled icon icon are enabled, and those marked with the image disabled icon are disabled. You can also see the paths to their corresponding binaries, and also the number of domains using a particular Node.js version. In Plesk for Linux, you may also see one or more Node.js versions available for installation.

Disabling or enabling a Node.js version:

  1. Connectez-vous à Plesk.
  2. Go to to Extensions, open the « My Extensions » tab, and then click Open next to the « Node.js Toolkit » extension.
  3. Click the image enabled icon icon for an enabled Node.js version to disable it.
  4. Click the image disabled icon icon for a disabled Node.js version to enable it.

Disabling a Node.js version has the following effects:

  • La version de Node.js ne peut plus être sélectionnée lors de la gestion d’applications Node.js de domaines.
  • Les applications Node.js existantes passent à une autre version activée de Node.js (si possible).
  • Toutes les versions de Node.js sur le serveur sont désactivées, toutes les applications Node.js existantes sont arrêtées et la fonction de gestion des applications Node.js de domaines est supprimée jusqu’à réactivation d’au moins une version de Node.js.

(Plesk for Linux) Installing or uninstalling a Node.js version:

  1. Connectez-vous à Plesk.
  2. Go to to Extensions, open the « My Extensions » tab, and then click Open next to the « Node.js Toolkit » extension.
  3. If the Node.js version you want to uninstall is enabled, click the image enabled icon icon to disable it first.
  4. Click Uninstall for a disabled Node.js version to uninstall it.
  5. Click Install for a Node.js version that is not installed to install it.

(Plesk for Windows) Changing the installed Node.js version:

  1. Connectez-vous à Plesk.
  2. Go to Tools & Settings, click Updates (under « Plesk »), and then click Add/Remove Components.
  3. Expand the « Node.js hosting features » section, select the desired Node.js version under the « Node.js Engine » component, and then click Continue.

Contrôle de la disponibilité de Node.js pour les clients

L’activation de la prise en charge Node.js ajoute les droits suivants aux packs de services et abonnements, que vous pouvez utiliser pour réguler l’accès des clients à la fonctionnalité Node.js :

  • « Node.js support management » permet aux clients d’activer la prise en charge Node.js pour leurs domaines.
  • « Node.js state management » permet aux clients de modifier le mode applicatif de leurs applications.
  • « Node.js version management » permet aux clients de modifier la version de Node.js de leurs applications.

Gérer la visibilité des journaux des applications Node.js

Les applications Node.js enregistrent leurs fichiers (y compris les sorties de consoles de l’application) aux emplacements suivants :

  • (Plesk pour Linux) /var/log/passenger/passenger.log
  • (Plesk pour Windows) %plesk_vhosts%<webspace_name>\logs\iisnode

Vous pouvez consulter ces fichiers notamment lorsque vous avez besoin de résoudre un problème lié à une application Node.js.

Par défaut, vous, vos clients et vos revendeurs pouvez voir les journaux des applications Node.js dans l”Explorateur de journaux du domaine. Vous pouvez gérer la visibilité de ces journaux dans l’Explorateur de journaux du domaine via le fichier panel.ini.

Pour gérer la visibilité des journaux des applications Node.js dans l’Explorateur de journaux du domaine :

  1. Ouvrez le fichier panel.ini pour le modifier. Ce fichier est disponible ici :

    • (Plesk pour Linux) /usr/local/psa/admin/conf/panel.ini
    • (Plesk pour Windows) %plesk_dir%admin\conf\panel.ini

    Vous pouvez également modifier le fichier depuis l’interface de Plesk à l’aide de l’extension Panel.ini Editor.

  2. Sous [ext-nodejs], ajoutez la ligne suivante et enregistrez le fichier :

    • (Pour afficher les journaux) showApplicationLogs = true
    • (Pour masquer les journaux) showApplicationLogs = false