ssl-server

Ein Sumor Cloud Tool.
Weitere Dokumentation

SSL-Webserver mit Express, Unterstützung von HTTP/2

Installation

npm i @sumor/ssl-server --save

Voraussetzungen

Node.JS-Version

Erfordert Node.JS-Version 16.x oder höher

Erforderliches Node.JS-ES-Modul

Da dieses Paket in ES-Modul geschrieben ist, ändern Sie bitte den folgenden Code in Ihrer package.json-Datei:

{
  "type": "module"
}

Verwendung

Einen einfachen Server hosten

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

// standardmäßig auf Port 443 lauschen und 80 auf HTTPS 443 umleiten
await app.listen()

SSL-Dateien hinzufügen

Bitte fügen Sie SSL-Dateien in den Stammordner ssl mit den folgenden Namen hinzu:

• domain.crt
• domain.key
• ca.crt (Optional, wird an die Zertifikatkette angehängt)

Wenn nicht gefunden, generiert der Server ein selbstsigniertes Zertifikat.
Bei Änderungen an den SSL-Dateien wird automatisch neu geladen.

Funktionen

Es unterstützt alle Express-Funktionen, der einzige Unterschied besteht in den Methoden listen und close. Bitte beachten Sie das folgende Beispiel für weitere Details.

Middleware und Routen hinzufügen

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

// Sie können jede Express-Middleware hinzufügen
app.use(bodyParser.json())

// Routen hinzufügen
app.get('/', (req, res) => {
  res.send('Hallo Welt!')
})

// listen ist eine asynchrone Funktion
await app.listen()

Server zwangsweise schließen

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

// listen ist eine asynchrone Funktion
await app.listen()
// close ist eine asynchrone Funktion
await app.close()

Auf benutzerdefiniertem Port lauschen

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

// listen ist eine asynchrone Funktion
await app.listen(8443, 8080)
console.log(`Server läuft unter https://localhost:8443/`)
console.log(`Weiterleitungsserver läuft unter http://localhost:8080/`)