Serveur web Nginx

Nginx est le serveur web utilisé par la plateforme Navixy pour exécuter le site. C'est un logiciel gratuit conçu pour fonctionner sous Linux et il est également compatible avec Windows.

Logo Nginx

Nginx est utilisé à la fois pour la solution Navixy On-premise et pour les serveurs Navixy PaaS. C'est le seul type de serveur web dont la compatibilité avec la plateforme est garantie. Aucun autre serveur web (Apache, IIS, etc.) n'est pris en charge.

Si vous avez d'autres applications web installées sur votre serveur en parallèle avec Navixy On-premise, vous pouvez utiliser un logiciel de serveur web différent simultanément avec Nginx pour ces produits. Dans ce cas, il est crucial d'effectuer une séparation des ports pour ces serveurs web afin d'éviter les conflits de ports sur les mêmes ports.

Configurations Nginx

L'utilisation d'un serveur web implique de le configurer pour que votre site fonctionne comme prévu. La configuration spécifie des éléments importants tels que :

  • Domaine(s) de votre site

  • Protocole (HTTP/HTTPS)

  • Certificats SSL

  • L'emplacement du contenu du site

Et d'autres paramètres nécessaires au bon fonctionnement de la page web.

Configurations Linux

La version actuelle de la plateforme Navixy On-premise est installée automatiquement sur Linux, soit en utilisant des scripts d'installation automatique, soit en déployant des conteneurs docker. Dans les deux cas, la configuration Nginx est effectuée automatiquement lors de l'installation et vous n'avez pas besoin d'y apporter des modifications, elle est entièrement prête pour une utilisation ultérieure.

Si votre instance a été déployée en mode manuel dans le passé, les configurations précédemment effectuées restent pleinement fonctionnelles et n'ont pas besoin d'être modifiées, sauf si vous prévoyez d'appliquer des changements fondamentaux au site (par ex. changer le domaine ou activer/désactiver le SSL). Si des modifications sont requises, veuillez contacter le support technique Navixy pour obtenir des instructions supplémentaires.

Configurations Windows

Dans le cas de Windows, toute l'installation et la configuration de la plateforme Navixy On-premise se font manuellement et il n'existe aucune automatisation. Par conséquent, Nginx doit également être configuré manuellement.

Pour faciliter le processus de configuration, des modèles de configuration sont fournis et peuvent être utilisés après avoir simplement remplacé les variables par les valeurs réelles du domaine et des noms des certificats SSL.

Les modèles se trouvent dans \windows\nginx dossier de navixy-package (build de distribution décompressé de la plateforme Navixy On-premise). Les fichiers sont :

  • navixy.conf - fichier de configuration pour le site de la plateforme ouvert en HTTP, sans protection SSL.

  • navixy_ssl.conf - fichier de configuration pour le site protégé par SSL.

Choisissez le fichier en fonction de la manière dont vous prévoyez de configurer le site.

Les valeurs des variables sont indiquées par un signe dollar et entre accolades - ces caractères identifient la variable. Par exemple : ${service_domain} Lors du remplacement de la variable par la valeur réelle, ces caractères doivent être supprimés. Par exemple : ${service_domain} devient my.domain.com

HTTP, sans protection SSL

C'est l'option la plus simple pour configurer le site de la plateforme Navixy, vous avez seulement besoin d'un ou plusieurs domaines enregistrés pointant vers votre serveur.

Éditez le fichier navixy.conf situé dans C:\nginx\conf\conf.d. Remplacez les valeurs suivantes :

  • ${service_domain} - domaine de l'interface utilisateur dans une installation à trois domaines ou domaine principal de votre plateforme dans une installation à domaine unique.

  • ${api_domain} - le domaine pour l'API dans une installation à trois domaines. Pour une installation à domaine unique, supprimez la variable mais conservez le reste de la ligne.

  • ${panel_domain} - le domaine pour le panneau d'administration dans une installation à trois domaines. Pour une installation à domaine unique, supprimez la variable mais conservez le reste de la ligne.

Enregistrez le fichier et redémarrez Nginx. Votre site Navixy doit être disponible sur le(s) domaine(s) spécifié(s).

En cas d'installation à domaine unique, le panneau d'administration sera disponible sur /panel chemin (par ex. http://my.domain.com/panel), et l'API sera disponible sur /api chemin (par ex. http://my.domain.com/api).

HTTPS, protégé par SSL

Pour configurer un site sécurisé par SSL, vous avez besoin non seulement d'un domaine enregistré, mais aussi d'un certificat SSL valide et de sa clé privée.

Pour plus d'informations sur les certificats SSL, veuillez consulter la page correspondante des instructions.

Placez le(s) certificat(s) SSL et la(les) clé(s) privée(s) dans C:\nginx\ssl dossier. Créez-le s'il n'existe pas.

Éditez le fichier navixy_ssl.conf situé dans C:\nginx\conf\conf.d. Remplacez les valeurs suivantes :

  • ${service_domain} - domaine de l'interface utilisateur dans une installation à trois domaines ou domaine principal de votre plateforme dans une installation à domaine unique.

  • ${api_domain} - le domaine pour l'API dans une installation à trois domaines. Pour une installation à domaine unique, supprimez la variable mais conservez le reste de la ligne.

  • ${panel_domain} - le domaine pour le panneau d'administration dans une installation à trois domaines. Pour une installation à domaine unique, supprimez la variable mais conservez le reste de la ligne.

  • ${certificate_name} - nom du fichier du certificat avec extension. Doit être le certificat émis pour le domaine.

  • ${private_key_name} - nom du fichier de la clé privée avec extension. La clé doit correspondre au certificat.

Enregistrez le fichier et redémarrez Nginx. Votre site Navixy doit être disponible sur le(s) domaine(s) spécifié(s).

En cas d'installation à domaine unique, le panneau d'administration sera disponible sur le chemin /panel (par ex. https://my.domain.com/panel), et l'API sera disponible sur le chemin /api (par ex. https://my.domain.com/api).

Redirection HTTP-HTTPS

Lorsque vous utilisez HTTPS, vous pouvez souhaiter que vos utilisateurs puissent accéder à la plateforme même s'ils ouvrent l'adresse via HTTP. Pour ce faire, vous devez avoir navixy.conf (config HTTP) appliquée avec navixy_ssl.conf (config HTTPS).

Configurez navixy.conf comme spécifié ci‑dessus dans la section « HTTP » puis décommentez la ligne suivante (supprimez le caractère # ):

Enregistrez le fichier et redémarrez Nginx pour appliquer les modifications. Désormais, les requêtes HTTP seront redirigées vers HTTPS.

Mis à jour

Ce contenu vous a-t-il été utile ?