Node.js中HTTPS模块应用详解

news2025/3/15 17:23:45

1. HTTPS 模块的概念

HTTPS（Hypertext Transfer Protocol Secure）是 HTTP 的安全版本，通过 SSL/TLS 协议对数据进行加密，确保数据在传输过程中不被窃取或篡改。在 Node.js 中，https 模块提供了创建 HTTPS 服务器和客户端的功能。

2. HTTPS 模块的定义

https 模块是 Node.js 的核心模块之一，用于处理 HTTPS 请求和响应。它基于 http 模块，但在其基础上增加了 SSL/TLS 加密功能。

3. HTTPS 模块的应用方法

3.1 创建 HTTPS 服务器

要创建一个 HTTPS 服务器，首先需要生成或获取 SSL/TLS 证书和私钥。通常，证书和私钥文件分别以 .crt 和 .key 为扩展名。

const https = require('https');
const fs = require('fs');

// 读取证书和私钥文件
const options = {
  key: fs.readFileSync('server.key'),
  cert: fs.readFileSync('server.crt')
};

// 创建 HTTPS 服务器
https.createServer(options, (req, res) => {
  res.writeHead(200);
  res.end('Hello, HTTPS!');
}).listen(443, () => {
  console.log('HTTPS server running on port 443');
});

3.2 发起 HTTPS 请求

https 模块也可以用于发起 HTTPS 请求，类似于 http 模块的 http.request 方法。

const https = require('https');

const options = {
  hostname: 'example.com',
  port: 443,
  path: '/',
  method: 'GET'
};

const req = https.request(options, (res) => {
  console.log(`statusCode: ${res.statusCode}`);

  res.on('data', (d) => {
    process.stdout.write(d);
  });
});

req.on('error', (error) => {
  console.error(error);
});

req.end();

4. 结合代码示例

4.1 创建自签名证书

在本地开发环境中，可以使用 OpenSSL 生成自签名证书：

openssl req -x509 -newkey rsa:4096 -keyout server.key -out server.crt -days 365 -nodes

4.2 完整的 HTTPS 服务器示例

const https = require('https');
const fs = require('fs');

// 读取证书和私钥文件
const options = {
  key: fs.readFileSync('server.key'),
  cert: fs.readFileSync('server.crt')
};

// 创建 HTTPS 服务器
https.createServer(options, (req, res) => {
  res.writeHead(200, { 'Content-Type': 'text/plain' });
  res.end('Hello, HTTPS!');
}).listen(443, () => {
  console.log('HTTPS server running on port 443');
});

4.3 发起 HTTPS 请求示例

const https = require('https');

const options = {
  hostname: 'example.com',
  port: 443,
  path: '/',
  method: 'GET'
};

const req = https.request(options, (res) => {
  console.log(`statusCode: ${res.statusCode}`);

  res.on('data', (d) => {
    process.stdout.write(d);
  });
});

req.on('error', (error) => {
  console.error(error);
});

req.end();