ssl-server

Ein Sumor Cloud Tool.
Weitere Dokumentation

SSL-Webserver mit Express, Unterstützung für 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, ersetzen 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 hören und 80 zu https 443 umleiten
await app.listen()

SSL-Dateien hinzufügen

Fügen Sie bitte 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 Funktionen von express, der einzige Unterschied liegt 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 hart beenden

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 hören

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

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