ssl-server

Uma ferramenta Sumor Cloud.
Documentação Adicional

Servidor Web SSL com Express, Suporte a HTTP/2

Instalação

npm i @sumor/ssl-server --save

Pré-requisitos

Versão Node.JS

Requer a versão Node.JS 18.x ou superior

Requer o módulo ES do 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

Hospedando um servidor simples

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

// ouça na porta 443 por padrão se não especificado, e redirecione 80 para o https 443
await app.listen()

console.log('Servidor rodando em https://localhost:443/')

Adicionando 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, ele será recarregado automaticamente.

Recursos

Ele suporta todos os recursos do express, a única diferença é o método listen e close. Por favor, consulte o exemplo abaixo para obter mais detalhes.

Adicionando middlewares e rotas

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

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

// adicione rotas
app.get('/', (req, res) => {
  res.send('Olá Mundo!')
})

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

Forçar fechamento do servidor

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()

Ouvindo 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 rodando em https://localhost:8443/`)
console.log(`Servidor de redirecionamento rodando em http://localhost:8080/`)

Ouvindo apenas o http

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

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

Usar um app personalizado

Por padrão, o servidor SSL usará a versão mais recente de suporte de longo prazo do express. Você pode usar seu próprio aplicativo express passando-o para a função createApp.

import createApp from '@sumor/ssl-server'
import express from 'express'

const expressApp = express()
expressApp.get('/', (req, res) => {
  res.send('Olá Mundo!')
})

const app = createApp(expressApp)

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

console.log('Servidor rodando em https://localhost:443/')