ssl-server

Un outil Sumor Cloud.
Plus de Documentation

Serveur Web SSL avec Express, Supporte HTTP/2

Installation

npm i @sumor/ssl-server --save

Prérequis

Version de Node.JS

Nécessite la version 16.x ou supérieure de Node.JS

Nécessite le module ES de Node.JS

Comme ce package est écrit en module ES, veuillez modifier le code suivant dans votre fichier package.json :

{
  "type": "module"
}

Utilisation

Héberger un serveur simple

import createApp from '@sumor/ssl-server'
const app = createApp()

// écoute sur le port 443 par défaut, et redirige le port 80 vers le HTTPS 443
await app.listen()

Ajouter des fichiers SSL

Veuillez ajouter les fichiers SSL dans le dossier racine ssl avec les noms suivants :

• domain.crt
• domain.key
• ca.crt (Optionnel, il sera ajouté à la chaîne de certificats)

S'ils ne sont pas trouvés, le serveur générera un certificat auto-signé.
En cas de modification des fichiers SSL, le serveur se rechargera automatiquement.

Fonctionnalités

Il prend en charge toutes les fonctionnalités d'express, la seule différence étant la méthode listen et close. Veuillez consulter l'exemple ci-dessous pour plus de détails.

Ajouter des middlewares et des routes

import createApp from '@sumor/ssl-server'
const app = createApp()
import bodyParser from 'body-parser'

// vous pouvez ajouter n'importe quel middleware express
app.use(bodyParser.json())

// ajouter des routes
app.get('/', (req, res) => {
  res.send('Bonjour le Monde !')
})

// listen est une fonction asynchrone
await app.listen()

Forcer la fermeture du serveur

import createApp from '@sumor/ssl-server'
const app = createApp()

// listen est une fonction asynchrone
await app.listen()
// close est une fonction asynchrone
await app.close()

Écouter sur un port personnalisé

import createApp from '@sumor/ssl-server'
const app = createApp()

// listen est une fonction asynchrone
await app.listen(8443, 8080)
console.log(`Le serveur fonctionne sur https://localhost:8443/`)
console.log(`Le serveur de redirection fonctionne sur http://localhost:8080/`)