在Nginx或Tengine服务器上安装证书_证书下载和安装_SSL证书

阿里云SSL证书服务支持下载证书并安装到Nginx、Tengine服务器上。本文介绍了安装证书的具体操作。

前提条件

已准备好远程登录工具，例如PuTTY或者Xshell。

背景信息

本文以CentOS 8、Nginx 1.14.1为例进行说明。由于版本不同，您在操作过程中的命令可能会略有区别。
本文中证书名称以domain name为例，例如，证书文件名称为domain name.pem、证书密钥文件名称为domain name.key。
下载的Nginx证书压缩文件解压后包含：
- PEM证书文件。
- KEY证书密钥文件。申请证书时如果未选择自动创建CRS，则下载的证书文件压缩包中不会包含KEY文件，需要您自己手动创建证书密钥文件。

说明 PEM证书文件是采用Base64编码的文本文件，您可根据需要修改成其他扩展名。关于证书格式的详细内容，请参见主流数字证书都有哪些格式。

操作步骤

登录阿里云SSL证书控制台。
在左侧导航栏，单击概览。
在SSL证书页面，定位到需要下载的证书实例，单击下载。
在证书下载页面，定位到Nginx服务器，单击右侧操作列的下载，将Nginx服务器证书压缩包下载到本地。
解压已下载保存到本地的Nginx证书压缩包文件。
解压后的文件夹中有2个文件：
- 证书文件：文件类型为PEM。
- 密钥文件：文件类型为KEY。

登录您的Nginx服务器，在Nginx安装目录（默认为/usr/local/nginx/conf）执行以下命令，创建cert目录：

cd /usr/local/nginx/conf  #进入Nginx默认安装目录。此处为Nginx默认安装目录，请您根据实际配置情况操作。
mkdir cert  #创建cert证书目录。

使用远程登录工具（例如PuTTY或者Xshell）附带的本地文件上传功能，将下载的证书文件和密钥文件上传到Nginx服务器的cert目录下。

说明如果您在申请证书时选择手动创建CSR文件，请将您自己手动创建的证书密钥文件上传到cert目录下，并命名为domain name.key。

执行以下命令，打开Nginx安装目录/conf/nginx.conf配置文件并进行编辑。

vim /usr/local/nginx/conf/nginx.conf #打开配置文件。此处为Nginx默认配置文件目录，请您根据实际配置情况操作。

按i键进入编辑模式，在配置文件中找到HTTP协议代码片段，在HTTP协议代码里面新增以下server配置示例。如果server配置已存在，按照以下注释内容修改相应的配置即可。

#以下属性中以ssl开头的属性代表与证书配置有关，其他属性请根据自己的需要进行配置。
server {
         listen 443 ssl; #配置HTTPS的默认访问端口号为443。此处如果未配置HTTPS的默认访问端口，可能会造成Nginx无法启动。Nginx 1.15.0以上版本请使用listen 443 ssl代替listen 443和ssl on。
         server_name www.certificatestests.com; #将www.certificatestests.com修改为您证书绑定的域名，例如：www.example.com。如果您购买的是通配符域名证书，要修改为通配符域名，例如：*.aliyun.com。
         root html;
         index index.html index.htm;
         ssl_certificate cert/domain name.pem;  #将domain name.pem替换成您证书的文件名称。
         ssl_certificate_key cert/domain name.key; #将domain name.key替换成您证书的密钥文件名称。
         ssl_session_timeout 5m;
         ssl_ciphers ECDHE-RSA-AES128-GCM-SHA256:ECDHE:ECDH:AES:HIGH:!NULL:!aNULL:!MD5:!ADH:!RC4; #使用此加密套件。
         ssl_protocols TLSv1 TLSv1.1 TLSv1.2; #使用该协议进行配置。
         ssl_prefer_server_ciphers on;
         location / {
         root html;  #站点目录。
         index index.html index.htm;
                    }
      }

配置文件修改完毕之后，按Esc键后输入:wq！，然后按Enter键保存修改的配置文件并退出编辑模式。

执行以下命令，进入Nginx服务器的可执行目录sbin并重启Nginx服务器。
```
cd /usr/local/nginx/sbin  #进入Nginx服务器的可执行目录sbin。
./nginx -s reload  #重启Nginx服务器。
```
说明
- 如果重启Nginx服务器出现the "ssl" parameter requires ngx_http_ssl_module报错，您需要重新编译Nginx并在编译安装的时候加上--with-http_ssl_module配置。
- 如果重启Nginx服务器出现"/cert/3970497_pic.certificatestests.com.pem":BIO_new_file() failed (SSL: error:02001002:system library:fopen:No such file or directory:fopen('/cert/3970497_pic.certificatestests.com.pem','r') error:2006D080:BIO routines:BIO_new_file:no such file)报错，您需要去掉证书相对路径最前面的/。例如，您需要去掉/cert/3970497_pic.certificatestests.com.pem最前面的/，使用正确的相对路径cert/3970497_pic.certificatestests.com.pem。

可选：设置HTTP请求自动跳转HTTPS。

在需要跳转的HTTP站点下添加以下rewrite语句，实现HTTP访问自动跳转到HTTPS页面。

server {
 listen 443 ssl;
 server_name www.certificatestests.com; #将www.certificatestests.com修改为您证书绑定的域名，例如：www.example.com。
rewrite ^(.*)$ https://$host$1 permanent;   #将所有HTTP请求通过rewrite重定向到HTTPS。
 location / {
index index.html index.htm;
}
}

虚拟主机配置SSL证书

登录您的虚拟机，在Web目录下创建cert目录，并将下载的证书文件和密钥文件拷贝到cert目录中。

打开虚拟主机配置文件vhost.conf或*.conf，复制以下内容粘贴到文件末尾、将端口改为443（HTTPS默认端口）并增加证书相关配置。

server {
 listen 80;
 server_name localhost ;
 location / {
index index.html index.htm;
}
server {
listen 443 ssl;
server_name localhost;
root html;
index index.html index.htm;
ssl_certificate cert/domain name.pem;   #将domain name.pem替换成您证书的文件名。
ssl_certificate_key cert/domain name.key;   #将domain name.key替换成您证书的密钥文件名。
ssl_session_timeout 5m;
ssl_ciphers ECDHE-RSA-AES128-GCM-SHA256:ECDHE:ECDH:AES:HIGH:!NULL:!aNULL:!MD5:!ADH:!RC4;
ssl_protocols TLSv1 TLSv1.1 TLSv1.2;
ssl_prefer_server_ciphers on;
location / {
index index.html index.htm;
}

保存vhost.conf或*.conf文件后退出。

可选：设置HTTP请求自动跳转HTTPS。

在Web目录下打开.htaccess文件（如果没有，需新建该文件），添加以下rewrite语句，实现HTTP访问自动跳转到HTTPS页面。

RewriteEngine On
RewriteCond %{HTTP:From-Https} !^on$ [NC]
RewriteCond %{HTTP_HOST} ^(www.)?yourdomain.com$ [NC]                # 将yourdomain.com修改为您证书绑定的域名，例如：example.com。
RewriteRule ^(.*)$ https://www.yourdomain.com/$1 [R=301,L]           # 将yourdomain.com修改为您证书绑定的域名，例如：example.com。

重启虚拟主机。

说明证书安装成功后，需要在虚拟主机上配置伪静态规则，您的网站才能全站都支持HTTPS，否则只有网站的主页支持HTTPS，网站的子目录将不支持HTTPS。

后续操作

证书安装完成后，您可通过登录证书的绑定域名验证该证书是否安装成功。

https://domain name   #domain name替换成证书绑定的域名。

如果网页地址栏出现小锁标志，表示证书安装成功。

DV SSL、OV SSL数字证书部署在服务器上后，您的浏览器访问网站时，展示以下效果： DV/OV证书安装效果图

证书安装完成后，异常现象的处理方法，请参见下表：


异常现象	可能原因	处理方法
通过HTTPS无法正常访问您的网站。	您安装证书的Nginx服务器443端口未开启或被其他工具拦截。	如果您使用的是阿里云ECS服务器，请前往ECS管理控制台的安全组页面配置放行443端口。
您的网站显示“您与网站之间的链接未完全安全”。	您的网站代码中调用的是HTTP协议。	需要您在网站代码中把HTTP协议修改为HTTPS协议。说明不同网站代码的实现逻辑可能存在差异，请您根据具体情况进行修改。
您的网站显示“该网站未根据工信部相关法律进行备案”。	您的网站未完成备案，未在接入商完成备案接入。您的网站内容与备案信息不符、备案信息不准确、网站存在不适宜传播的内容等。	如果您使用的是阿里云备案系统，请前往阿里云备案系统进行网站备案。

在Nginx或Tengine服务器上安装证书

前提条件

背景信息

操作步骤

虚拟主机配置SSL证书

后续操作

相关文档