npm 包 buenos-https 使用教程-JavaScript中文网-JavaScript教程资源分享门户

在前端开发中，http 协议是常用的协议之一。然而，由于 http 协议传输的数据是明文的，容易被窃取和篡改，因此 https 协议成为了更加安全和可靠的选择。buenos-https 就是一款基于 Node.js 的 npm 包，用于在本地搭建 https 服务器，是前端开发中十分实用的工具。

安装

全局安装

可以使用以下命令进行全局安装：
```
npm install -g buenos-https
```
项目内安装

进入项目根目录，使用以下命令进行安装：
```
npm install buenos-https
```

使用

生成密钥文件

使用 buenos-https 前，需要先生成一个密钥文件。可以使用以下命令生成：

openssl req -newkey rsa:2048 -new -nodes -x509 -days 3650 -keyout key.pem -out cert.pem

执行命令后，会生成两个文件 key.pem 和 cert.pem，这两个文件即为生成的密钥文件。

在项目中使用

在项目中引入 buenos-https

如果是全局安装 buenos-https，可以直接引入。
```
const buenosHttps = require('buenos-https');
```
如果是项目内安装 buenos-https，在项目对应的文件中引入。
```
const buenosHttps = require('buenos-https');
```

设置增加 https 协议支持

buenosHttps({
  key: fs.readFileSync('key.pem'),
  cert: fs.readFileSync('cert.pem')
}).listen(3000);

其中，传入的参数是生成的密钥文件。

设置增加 http 协议支持

const http = require('http');

http.createServer((req, res) => {
  res.writeHead(302, {'Location': 'https://' + req.headers.host + req.url});
  res.end();
}).listen(80);

注意：此段代码是指将所有的 http 请求自动重定向到 https。如需要自定义，在此处可以实现。

启动 https 服务器

执行 node app.js 或者 npm start 启动服务，其中 app.js 为项目的入口文件。

在浏览器中访问

在浏览器中访问 https://localhost:3000，即可看到 https 服务器已经成功启动了。

深度理解

buenos-https 是基于 Node.js 实现的 https 服务器，其技术原理主要有以下几点：

Node.js 的 https 模块

buenos-https 使用了 Node.js 的 https 模块来实现 https 服务器的功能。
密钥文件

buenos-https 在启动服务器的时候需要指定一个密钥文件。密钥文件是 https 安全连接的基石，必须是机密的，并且在传输过程中不允许被篡改。在 Node.js 中，可以使用 fs 模块的 readFileSync 方法读取密钥文件。
自动重定向

buenos-https 在启动时会同时增加 http 和 https 的支持。如果用户访问了 http 的链接，buenos-https 会自动将其重定向到 https 链接，从而保障数据的安全性。

总结

buenos-https 是一款基于 Node.js 的 npm 包，用于在本地搭建 https 服务器，可以有效地保障数据的安全性。在使用过程中，需要了解 npm 包的安装和使用方法，以及生成密钥文件的方法，并了解其技术原理。

来源：JavaScript中文网，转载请注明来源 https://www.javascriptcn.com/post/60066c8dccdc64669dde55a1