Node.js中配置SSL证书的完整指南
海外云服务器 40个地区可选 亚太云服务器 香港 日本 韩国
云虚拟主机 个人和企业网站的理想选择 俄罗斯电商外贸虚拟主机 赠送SSL证书
美国云虚拟主机 助力出海企业低成本上云 WAF网站防火墙 为您的业务网站保驾护航
本文详细介绍了在Node.js中配置SSL证书的完整步骤，需获取SSL证书（如从CA申请或使用自签名证书），然后通过Node.js的HTTPS模块创建安全服务器，配置过程中需要指定证书文件路径和私钥，并确保使用正确的端口（如443），还提到了如何结合Express框架进行配置，并建议使用工具如OpenSSL生成自签名证书以供测试。
SSL（Secure Sockets Layer）证书是一种用于验证网站身份并建立加密通信的数字证书，它通过 SSL/TLS 协议在客户端和服务器之间建立安全连接，有效防止数据在传输过程中被窃取或篡改，对于使用 Node.js 搭建的 Web 启用 HTTPS（HTTP over SSL/TLS）是实现数据传输安全的必要措施。
SSL 证书通常由受信任的第三方证书颁发机构（CA）签发，Let's Encrypt、DigiCert、GoDaddy 等，证书中包含公钥、证书持有者信息、证书有效期以及签发机构的相关信息，商业证书的有效期一般为一至三年，而 Let's Encrypt 提供的免费证书有效期为 90 天，需定期续签。
Node.js 中配置 SSL 证书的准备工作
在正式配置 SSL 证书之前，需要完成以下几项准备工作：
- 域名：SSL 证书是基于域名签发的，因此必须拥有一个合法且已备案的域名。
- 服务器环境：确保 Node.js 环境已部署完成，并且可以通过域名正常访问服务器。
- SSL 证书文件：
- 证书文件（通常为 .crt 或 .pem 格式）
- 私钥文件（通常为 .key 格式）
- 中间证书（如适用，用于构建完整的证书链）
SSL 证书可以通过购买商业证书获取，也可以使用免费的证书颁发机构如 Let's Encrypt 来申请，Let's Encrypt 是一个开源、免费、自动化的证书颁发机构，其证书被全球主流浏览器广泛信任，是个人项目和中小企业的首选。
使用 Let's Encrypt 免费获取 SSL 证书
Let's Encrypt 提供了自动化获取和管理证书的机制，主要通过 Certbot 工具实现，以下是使用 Certbot 获取证书的基本流程：
-
安装 Certbot
根据服务器操作系统安装 Certbot，例如在 Ubuntu 系统中可使用以下命令：sudo apt update sudo apt install certbot
-
获取 SSL 证书
在执行命令前，确保 Web 服务正在运行，并且可以通过 80 端口访问目标域名。sudo certbot certonly --standalone -d yourdomain.com
执行完成后,Certbot 会自动生成并保存证书文件，通常位于
/etc/letsencrypt/live/yourdomain.com/目录下，包括：fullchain.pem：完整的证书链文件privkey.pem：私钥文件
-
配置自动续签
Let's Encrypt 的证书有效期为 90 天，因此必须配置自动续签机制，Certbot 默认会配置一个定时任务（cron job），你也可以手动测试续签是否成功：sudo certbot renew --dry-run
Node.js 服务器配置 HTTPS
在获得 SSL 证书后，接下来需要在 Node.js 项目中配置 HTTPS 服务，Node.js 内置了 https 模块，可以轻松创建 HTTPS 服务器。
引入必要的模块
const https = require('https');
const fs = require('fs');
加载 SSL 证书和私钥
const options = {
key: fs.readFileSync('/path/to/privkey.pem'),
cert: fs.readFileSync('/path/to/fullchain.pem')
};
请根据实际证书路径进行替换,并确保 Node.js 进程具有读取这些文件的权限。
创建 HTTPS 服务器
https.createServer(options, (req, res) => {
res.writeHead(200);
res.end("Hello, secure world!");
}).listen(443, () => {
console.log("HTTPS server is running on port 443");
});
Node.js 服务部署在 Nginx 或 Apache 等反向代理服务器之后，可以在反向代理层配置 SSL，Node.js 服务则继续监听 HTTP 内部端口即可。
将 HTTP 请求重定向到 HTTPS
为了确保所有访问都通过 HTTPS 协议进行，通常会将 HTTP 请求自动重定向到 HTTPS 版本，以下是几种常见实现方式：
在 Node.js 中创建 HTTP 服务器并进行重定向
const http = require('http');
http.createServer((req, res) => {
res.writeHead(301, { "Location": "https://" + req.headers['host'] + req.url });
res.end();
}).listen(80, () => {
console.log("HTTP redirect server is running on port 80");
});
使用 Nginx 配置重定向
如果你使用 Nginx 作为反向代理，可以在其配置文件中添加如下内容：
server {
listen 80;
server_name yourdomain.com;
location / {
return 301 https://$host$request_uri;
}
}
部署与测试
完成 SSL 证书配置后，建议进行以下步骤以确保服务正常运行：
- 检查防火墙设置：确认服务器的 443 端口已开放，允许外部访问。
- 测试 HTTPS 访问：在浏览器中访问
https://yourdomain.com，确认可以正常加载页面，并查看浏览器地址栏是否显示绿色锁图标。 - 使用在线工具检测 SSL 配置：推荐使用 SSL Labs 工具，全面评估 SSL/TLS 配置的安全性和兼容性。
常见问题与解决方案
证书路径错误导致服务器启动失败
请确保 fs.readFileSync() 中指定的路径正确无误，Node.js 有权限读取证书文件，建议使用绝对路径。
证书未被信任
若浏览器提示证书不受信任,可能是证书链不完整，请确保使用的是完整的证书链文件，如 Let's Encrypt 提供的 fullchain.pem。
Node.js 无法绑定 443 端口
在 Linux 系统中，非 root 用户无法绑定 1024 以下的端口，解决方法包括：
- 使用
sudo启动 Node.js 应用 - 通过
iptables将 80/443 端口转发到高版本端口（如 8080）
证书过期
务必配置自动续签机制,并定期检查证书有效期，避免因证书过期导致服务中断。
通过本文的介绍,我们了解了 SSL 证书的基本概念、如何使用 Let's Encrypt 获取免费证书、如何在 Node.js 中配置 HTTPS 服务器，以及如何将 HTTP 请求重定向到 HTTPS。
随着 HTTPS 成为现代 Web 服务的标准，掌握 Node.js 中 SSL 证书的配置方法对于开发者来说尤为重要，希望本文能够帮助你顺利完成 Node.js
