ssl-server

Uma Sumor Cloud Tool.
Documentação Adicional

Servidor Web SSL com Express, Suporte HTTP/2

Instalação

npm i @sumor/ssl-server --save

Pré-requisitos

Versão Node.JS

Requer Node.JS na versão 16.x ou superior

Requer módulo ES Node.JS

Como este pacote é escrito em módulo ES, por favor altere o seguinte código em seu arquivo package.json:

{
  "type": "module"
}

Uso

Hospedar um servidor simples

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

// escuta na porta 443 por padrão e redireciona 80 para https 443
await app.listen()

Adicionar arquivos SSL

Por favor, adicione arquivos SSL na pasta raiz ssl com os seguintes nomes:

• domain.crt
• domain.key
• ca.crt (Opcional, será anexado à cadeia de certificados)

Se não encontrados, o servidor irá gerar um certificado autoassinado.
Se os arquivos SSL forem alterados, eles serão recarregados automaticamente.

Recursos

Suporta todos os recursos do express, a única diferença é o método listen e close. Consulte o exemplo abaixo para mais detalhes.

Adicionar middlewares e rotas

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

// você pode adicionar qualquer middleware express
app.use(bodyParser.json())

// adicionar rotas
app.get('/', (req, res) => {
  res.send('Hello World!')
})

// listen é uma função assíncrona
await app.listen()

Encerrar o servidor forçosamente

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

// listen é uma função assíncrona
await app.listen()
// close é uma função assíncrona
await app.close()

Escutar em uma porta personalizada

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

// listen é uma função assíncrona
await app.listen(8443, 8080)
console.log(`Servidor está rodando em https://localhost:8443/`)
console.log(`Servidor de redirecionamento está rodando em http://localhost:8080/`)