文档

Node.js环境安装SSL证书

更新时间:
重要

本文中含有需要您注意的重要提示信息,忽略该信息可能对您的业务造成影响,请务必仔细阅读。

如果轻量应用服务器已绑定了域名,可以为域名设置HTTPS加密访问,以较低的成本将数据传输协议从HTTP转换成HTTPS,实现网站的身份验证和数据加密传输,防止数据在传输过程中被篡改或信息泄露。本文以部署Node.js环境的轻量应用服务器为例,介绍如何在服务器中安装SSL证书,并开启HTTPS加密访问。

前提条件

  • 已购买域名。通过阿里云购买域名的操作,请参见注册通用域名

  • 如果您的轻量应用服务器部署在中国内地,需要确保域名已备案。更多信息,请参见什么是ICP备案

  • 域名已经绑定到轻量应用服务器并完成域名解析。具体操作,请参见绑定并解析域名

背景信息

Node.js是一个基于Chrome V8引擎的JavaScript运行环境,用于方便地搭建响应速度快、易于扩展的网络应用。Node.js使用事件驱动,非阻塞I/O模型而得以轻量和高效,非常适合在分布式设备上运行数据密集型的实时应用。更多信息,请参见Node.js官网

通过数字证书管理服务(Certificate Management Service)完成证书购买、申请,并将证书部署到您的Web服务器后,Web服务将会通过HTTPS加密协议来传输数据。HTTPS加密传输协议可激活客户端浏览器到网站服务器之间的SSL加密通道(SSL协议),从而实现高强度单向加密传输,防止传输数据被泄露或篡改。HTTPS加密传输为手机App、小程序应用、代码程序、控件等上线应用市场或应用生态必备特征。HTTPS加密传输可为网站带来以下优势:

  • 安全合规:满足对应App市场或应用生态的要求。

  • 加密传输网络数据:加密网站用户与网站间的数据通信,实现传输数据的防劫持、防篡改、防监听,保障数据传输安全。

  • 提升网站安全性:规避钓鱼事件发生。网站用户在访问网站时浏览器提示安全可信,可以提升网站的可信度、访问流量和搜索排名。

更多信息,请参见什么是数字证书管理服务

步骤一:创建Node.js轻量应用服务器

  1. 登录轻量应用服务器管理控制台

  2. 在左侧导航栏,单击服务器

  3. 在轻量应用服务器售卖页,完成资源配置。

    创建轻量应用服务器的具体操作,请参见创建轻量应用服务器

    其中,您需要在镜像区域,选择应用镜像为Node.js 14.15.2

步骤二:申请SSL证书

阿里云支持申请免费证书、付费证书或者在其他服务商申请的证书均可。免费证书建议用于测试、个人试用等场景,org、jp等特殊域名存在无法申请的情况,正式环境建议使用付费证书,本步骤以申请免费证书为例。如果您需要申请付费证书,具体操作,请参见购买SSL证书

领取免费证书额度

每个阿里云个人或企业用户(以实名认证为准)每个自然年可以一次性申请20张免费证书(每个自然年仅限领取1次)自然年是每年的01月01日~12月31日,免费领取的证书资源包在每个自然年末将未申请的额度清零(每年12月31日24:00:00),您需要等到第二年的1月1日00:00:00后申请领取当年的免费证书资源包。更多关于免费证书适用场景、领取规则和使用限制说明,请参见免费SSL证书概述

说明

如果一个自然年内20张免费证书的额度已用完,您可以购买付费SSL证书、升级12个月有效期的SSL证书或使用HTTPS加速网关,以获得更长的证书服务时间、更高的安全等级以及技术服务支持。具体操作,请参见购买SSL证书免费版SSL证书升级指南

  1. 访问免费证书购买页

  2. 保持默认配置,单击立即购买并完成支付。

提交免费证书申请

  1. 登录数字证书管理服务控制台

  2. 在左侧导航栏,选择证书管理 > SSL证书管理

  3. SSL证书页面的免费证书页签,单击创建证书

  4. 证书申请面板,按照下表配置证书参数,选中快捷签发,并单击提交审核

    配置项

    说明

    证书类型

    选择默认证书

    证书剩余数量/总数

    表示剩余可申请的证书个数/总共可申请的证书个数。只有当剩余可申请的证书个数不为0时,您才可以创建证书。

    域名名称

    填写轻量服务器绑定的域名。此处只可以填写一个单域名,例如aliyundoc.com

    数量

    证书申请数量,默认为1,不支持增加。

    快捷签发

    域名验证方式

    • 如果您当前的阿里云账号与域名的DNS云解析服务所在账号一致,申请SSL证书时,阿里云数字证书管理服务将会自动识别,并默认选择自动DNS验证方式,且不支持修改,提交审核后,系统会自动进行DNS验证,您仅需等待证书签发即可。

    • 如果您当前的阿里云账号与域名的DNS云解析服务所在账号不一致,您可以选择以下任意一种方式进行域名所有权验证。

      • 手工DNS验证:您需要手动在对应的DNS域名解析服务商,添加一条TXT类型的解析记录用于域名所有权验证。

      • 文件验证:您需要手动从数字证书管理服务控制台下载一个专用的验证文件,然后将该文件上传到站点服务器的指定验证目录。

    联系人

    在下拉列表中,单击新建联系人,新建本次证书申请的联系人。如果已创建过联系人,可以直接选择已有的联系人。

    请您务必确保联系人信息准确且有效。

    所在地

    选择您所在的城市或地区。

    密钥算法

    SSL证书使用的密钥算法。默认选择为RSA,且不支持修改。RSA算法是目前全球广泛应用的非对称加密算法,具有良好的兼容性。

    CSR生成方式

    CSR(Certificate Signing Request)文件是SSL证书的请求文件,包含服务器信息和单位信息,需要提交给CA中心审核。

    您选择系统生成即可,表示由数字证书管理服务自动使用您在密钥算法指定的加密算法生成CSR文件。

  5. 如果域名验证方式自动DNS验证,系统会自动完成DNS验证,您仅需等待证书签发即可;如果域名验证方式选择手动DNS验证文件验证,您需要按照验证信息中的提示,完成域名所有权的验证。更多信息和常见报错,请参见域名所有权验证

    提交免费SSL证书申请后,CA中心一般会在30分钟左右完成审核和签发,请您耐心等待。SSL证书签发后,SSL证书状态将变更为已签发

步骤三:配置SSL证书

证书签发后,证书状态将变更为已签发,您需要下载和配置证书。关于证书下载和安装的更多信息,请参见SSL证书安装指南

  1. 下载证书。

    1. 在证书所在行的操作列,单击下载

      image

    2. 证书下载对话框中,根据服务器类型下载证书。

      本示例使用Nginx做转发,所以下载Nginx版本。

      警告

      下载证书后,请妥善保存,避免证书泄露导致您的网站被攻击。

      image

    3. 压缩包解压之后会得到2个文件,具体如下图所示。

      image

  2. 使用WinSCP、Xshell等工具上传.key证书文件和.pem证书私钥文件到轻量应用服务器的指定目录,例如:/home。

  3. 远程连接轻量应用服务器。具体操作,请参见远程连接Linux服务器

  4. 执行以下命令,新建https_server_test.js项目文件。

    cd /home
    sudo touch https_server_test.js
  5. 执行以下命令,修改https_server_test.js文件。

    vim https_server_test.js

    i键进入编辑模式,并将以下内容添加至https_server_test.js文件中。内容如下所示:

    // 启动https服务需要https包
    // 读取文件需要fs包
    const https = require('https');
    const fs = require('fs');
    
    // 将两个证书文件读取放到options对象中
    // 使用readFileSync()方法,顺序地执行读文件和启动服务操作
    const options = {
        key: fs.readFileSync('/home/cert-file-name.key'),
        cert: fs.readFileSync('/home/cert-file-name.pem')
    };
    
    // 创建服务器,启动服务器,设置监听端口号
    https.createServer(options, (req, res) => {
        res.end('hello world\n');
    }).listen(443);

    说明如下:

    • /home/cert-file-name.key:需替换为实际上传私钥文件的绝对路径。

    • /home/cert-file-name.pem:您需要输入实际上传SSL证书文件的绝对路径。

    重要

    证书文件的路径需要配置正确,否则证书配置失败,无法使用HTTPS访问。

  6. 添加完成后,按Esc键退出编辑模式,并输入:wq后按Enter键,保存并退出文件。

  7. 执行以下命令,使SSL证书生效。

    sudo node https_server_test.js
  8. 使用浏览器访问https://轻量应用服务器对应的域名

    • 如果浏览器地址栏中出现小锁标志,表示证书已经安装成功。sda

    • 如果网站无法通过HTTPS正常访问,需确认您安装证书的轻量应用服务器443端口是否已开启或被其他工具拦截。放行443端口的具体操作,请参见管理防火墙

  • 本页导读 (1)