ssl-server

一个Sumor Cloud 工具。
更多文档

带有 Express 的 SSL Web 服务器，支持 HTTP/2

安装

npm i @sumor/ssl-server --save

先决条件

Node.JS 版本

需要 Node.JS 版本 18.x 或以上

需要 Node.JS ES 模块

由于此包是用 ES 模块编写的，请在您的 package.json 文件中更改以下代码：

{
  "type": "module"
}

用法

托管一个简单的服务器

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

// 默认情况下监听端口 443，如果没有指定，则重定向 80 到 https 443
await app.listen()

console.log('服务器运行在 https://localhost:443/')

添加 SSL 文件

请将 SSL 文件添加到名为 ssl 的根文件夹中，并使用以下名称:

• domain.crt
• domain.key
• ca.crt（可选，将附加到证书链）

如果找不到这些文件，服务器将生成自签名证书。
如果 SSL 文件发生更改，将自动重新加载。

特性

它支持所有 express 的特性，唯一的区别在于 listen 和 close 方法。请参考下面的示例了解更多详情。

添加中间件和路由

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

// 您可以添加任何 express 中间件
app.use(bodyParser.json())

// 添加路由
app.get('/', (req, res) => {
  res.send('Hello World!')
})

// listen 是异步函数
await app.listen()

强制关闭服务器

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

// listen 是异步函数
await app.listen()
// close 是异步函数
await app.close()

监听自定义端口

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

// listen 是异步函数
await app.listen(8443, 8080)
console.log(`服务器正在运行在 https://localhost:8443/`)
console.log(`重定向服务器正在运行在 http://localhost:8080/`)

使用自定义应用程序

默认情况下，ssl 服务器将使用最新的 express 长期支持版本。您可以通过将其传递给 createApp 函数来使用您自己的 express 应用程序。

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

const expressApp = express()
expressApp.get('/', (req, res) => {
  res.send('Hello World!')
})

const app = createApp(expressApp)

// listen 是异步函数
await app.listen()

console.log('服务器运行在 https://localhost:443/')