https 模块

https 模块是 Node.js 提供的一个用于创建 HTTPS 服务器和发起 HTTPS 请求的核心模块。它基于 http 模块，并添加了 SSL/TLS 加密层，确保数据传输的安全性。以下是关于如何使用 https 模块创建安全的 Web 服务器和客户端的详细介绍。

创建 HTTPS 服务器

为了创建一个 HTTPS 服务器，你需要提供 SSL/TLS 证书和私钥。这些文件通常是由受信任的证书颁发机构（CA）签发的，也可以自签名用于测试环境。

示例：创建一个简单的 HTTPS 服务器

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

// 加载 SSL 证书和私钥
const options = {
  key: fs.readFileSync("/path/to/server-key.pem"),
  cert: fs.readFileSync("/path/to/server-cert.pem"),
};

// 创建 HTTPS 服务器
const server = https.createServer(options, (req, res) => {
  res.writeHead(200, { "Content-Type": "text/plain" });
  res.end("Hello Secure World\n");
});

// 监听端口
server.listen(3000, () => {
  console.log("HTTPS Server running at https://localhost:3000/");
});

处理请求和响应

与 http 模块类似，https 模块也提供了 IncomingMessage 和 ServerResponse 对象来处理请求和构建响应。你可以通过检查 req.url、req.method 等属性来实现路由逻辑。

示例：处理不同的 HTTP 方法和路由

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

const options = {
  key: fs.readFileSync("/path/to/server-key.pem"),
  cert: fs.readFileSync("/path/to/server-cert.pem"),
};

const server = https.createServer(options, (req, res) => {
  const url = req.url;
  const method = req.method;

  if (url === "/") {
    if (method === "GET") {
      res.writeHead(200, { "Content-Type": "text/html" });
      res.end("<h1>Home Page</h1>");
    } else {
      res.writeHead(405, { Allow: "GET" });
      res.end(`Method ${method} Not Allowed`);
    }
  } else if (url === "/about") {
    res.writeHead(200, { "Content-Type": "text/html" });
    res.end("<h1>About Page</h1>");
  } else {
    res.writeHead(404, { "Content-Type": "text/plain" });
    res.end("Not Found");
  }
});

server.listen(3000, () => {
  console.log("HTTPS Server is running on port 3000");
});

创建 HTTPS 客户端

要发起 HTTPS 请求，可以使用 https.get() 或 https.request() 方法。对于 HTTPS 请求，你可能需要指定代理设置或忽略无效的 SSL 证书（仅限于测试环境）。

使用 https.get() 发起 GET 请求

const https = require("https");

https
  .get("https://jsonplaceholder.typicode.com/posts/1", (resp) => {
    let data = "";

    // 接收数据
    resp.on("data", (chunk) => {
      data += chunk;
    });

    // 数据接收完毕
    resp.on("end", () => {
      console.log(JSON.parse(data));
    });
  })
  .on("error", (err) => {
    console.log("Error: " + err.message);
  });

使用 https.request() 发起 POST 请求

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

const postData = JSON.stringify({
  title: "foo",
  body: "bar",
  userId: 1,
});

const options = {
  hostname: "jsonplaceholder.typicode.com",
  path: "/posts",
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Content-Length": Buffer.byteLength(postData),
  },
  // 忽略 SSL 证书验证（仅用于测试）
  rejectUnauthorized: false,
};

const req = https.request(options, (res) => {
  console.log(`STATUS: ${res.statusCode}`);
  console.log(`HEADERS: ${JSON.stringify(res.headers)}`);
  res.setEncoding("utf8");
  res.on("data", (chunk) => {
    console.log(`BODY: ${chunk}`);
  });
  res.on("end", () => {
    console.log("No more data in response.");
  });
});

req.on("error", (e) => {
  console.error(`problem with request: ${e.message}`);
});

// 写入数据到请求体
req.write(postData);
req.end();

注意事项

• SSL/TLS 证书：在生产环境中，必须使用由受信任的 CA 签发的有效证书。自签名证书适用于开发和测试，但在实际部署时可能会导致浏览器警告。

• 性能优化：HTTPS 连接的建立比 HTTP 更加耗费资源，因为涉及加密操作。考虑使用负载均衡器或缓存机制来提高性能。

• 安全配置：确保正确配置 SSL/TLS 参数以防止已知的安全漏洞，例如选择强加密套件、禁用过时的协议版本等。

• 错误处理：总是为网络请求添加适当的错误处理逻辑，特别是当涉及到外部 API 调用时。

总结

https 模块扩展了 http 模块的功能，增加了对 SSL/TLS 协议的支持，从而保证了数据传输的安全性。无论是创建安全的 Web 应用程序还是作为客户端发起安全的 HTTP 请求，https 模块都提供了必要的工具和支持。