如何在本地创建HTTPS服务器？

什么时候我们需要在本地使用HTTPS？

问题

在大多数情况下，我们在本地开发应用时不需要HTTPS。但是，如果你的应用需要与第三方进行身份验证，或者需要监听来自其他应用的webhooks...而这些第三方要求你的应用必须使用HTTPS才能接收他们的请求，那该怎么办呢？

当然，在生产环境中会使用HTTPS，但如何在本地开发应用时建立安全连接呢？

我们有几个选择，比如使用PageKite或ngrok来创建指向你的localhost的HTTPS隧道，但这些服务有一些缺点：

免费计划中可同时使用的隧道/请求数量有限。
无法使用特定的域名，每次开发应用时都会不同，我们必须重新配置应用的环境变量。
而且它们非常慢，这会浪费大量开发/测试应用的时间。

如果你遇到类似的问题，这里有解决方案

解决方案

这里的解决方案是使用OpenSSL生成SSL证书，并使用这些证书创建HTTPS服务器。

生成根SSL证书

首先，我们需要创建一个根SSL证书来签署我们将用于localhost的任何证书。

使用以下命令创建一个key，用于在下一步生成根SSL证书：

openssl genrsa -des3 -out rootCA.key 2048

系统会要求你输入一个密码短语来生成密钥，只需输入一个随机字符串并验证即可。

请记住这个密码短语，因为在接下来的步骤中还会用到！

生成的密钥将保存在rootCA.key文件中，使用以下命令用它来生成根SSL证书：

openssl req -x509 -new -nodes -key rootCA.key -sha256 -days 7300 -out rootCA.pem

填写所需信息（密码短语必须与第一步生成rootCA.key时使用的密码相匹配！）

此证书将保存在rootCA.pem文件中。

信任根SSL证书

要使用根SSL证书生成的证书，我们需要告诉操作系统信任这个根证书。

打开钥匙串访问应用程序(MacOS)，选择证书标签：

通过拖拽或导航到**文件 / 导入项目...**来导入rootCA.pem。

然后在导入的证书上右键点击 / 显示简介（或双击）

展开信任标签，在第一个设置中选择始终信任，然后保存。

钥匙串访问随后会显示类似**"此证书被标记为此帐户信任"的消息，这意味着你已成功信任了根SSL证书** 。

创建本地SSL证书

现在，我们将使用已信任的根SSL证书来生成用于localhost的SSL证书。

第1步

创建一个名为server.csr.cnf的配置文件，内容如下。OpenSSL将使用此文件生成证书密钥：

server.csr.cnf

[req]
default_bits = 2048
prompt = no
default_md = sha256
distinguished_name = dn
 
[dn]
C=US
ST=RandomState
L=RandomCity
O=RandomOrganization
OU=RandomOrganizationUnit
emailAddress=hello@example.com
CN = localhost

使用上述配置创建证书密钥并保存到server.key文件：

server.js

let Koa = require('koa');
let app = new Koa();
 
app.use(async ctx => {
  ctx.body = 'Hello World';
});
 
module.exports = app

在你的应用中创建一个名为 certs/ 的目录，然后将 server.key 和 server.crt 移动到该目录中。

使用 https 模块加载证书文件并创建 HTTPS 服务器：

index.js

let app = require('./server')
let https = require('https')
let fs = require('fs')
let path = require('path')
 
let certOptions = null
try {
  certOptions = {
    key: fs.readFileSync(path.resolve('certs/server.key')),
    cert: fs.readFileSync(path.resolve('certs/server.crt'))
  }
} catch(err) {
  console.log('No certificate files found!')
}
 
let host = process.env.APP_URL || 'localhost'
let isLocal = host === 'localhost'
let enableHTTPSInLocal = Boolean(isLocal && certOptions)
 
let port = enableHTTPSInLocal ? 443 : process.env.PORT || 3434
let protocol = (isLocal && !certOptions) ? "http" : "https"
 
let url = `${protocol}://${host}${isLocal ? `:${port}` : ''}`
 
let callback = () => {
  console.log(`App start successfully at ${url}`)
}
 
if (enableHTTPSInLocal) {
  https
    .createServer(certOptions || {}, app.callback())
    .listen(port, callback)
} else {
  app.listen(port, callback)
}