Nginx或Tengine服务器上安装证书

## 前提条件
- 已经通过数字证书管理服务控制台签发证书。具体操作，请参见购买SSL证书和提交证书申请。
- 已准备好远程登录工具（例如PuTTY、Xshell），用于登录您的Nginx或Tengine服务器。
>**重要** 本文以CentOS 8操作系统、Nginx 1.14.1服务器系统为例进行说明。由于服务器系统版本不同，您在操作过程中使用的命令可能会略有区别。

## 步骤一：下载证书到本地
1. 登录数字证书管理服务控制台。
2. 在左侧导航栏，单击SSL证书。
3. 在SSL证书页面，定位到目标证书，在操作列，单击下载。
4. 在证书下载面板，单击Nginx服务器操作列的下载。
该操作会将Nginx服务器证书压缩包下载到本地，并保存在浏览器的默认下载位置。
5. 打开浏览器的默认下载位置，解压已下载的Nginx服务器证书压缩包文件。
解压后您将会获得以下文件：证书文件

![](/media/202303/2023-03-22_110832.png)

>**重要** 本文中出现证书文件名称的地方，统一使用cert-file-name为例进行描述。例如，本文中用到的证书文件为cert-file-name.pem，证书私钥文件为cert-file-name.key。在实际操作过程中，您必须使用真实的证书文件名称替换示例代码中的cert-file-name。

- PEM格式的证书文件。
PEM格式的证书文件是采用Base64编码的文本文件，您可以根据需要将证书文件修改成其他格式。关于证书格式转换的具体操作，请参见证书格式转换。

- KEY格式的证书私钥文件。
>**重要** 如果您在申请证书时将CSR生成方式设置为手动填写，则下载的证书文件压缩包中不会包含KEY文件，您需要手动创建证书私钥文件。具体操作，请参见创建私钥。

## 步骤二：在Nginx服务器上安装证书
在Nginx独立服务器、Nginx虚拟主机上安装证书的具体操作不同，请根据您的实际环境，选择对应的安装步骤。

### 在Nginx独立服务器上安装证书
1. 使用远程登录工具，登录Nginx服务器。
2. 执行以下命令，在Nginx安装目录（默认为/usr/local/nginx/conf）下创建一个用于存放证书的目录。
>cd /usr/local/nginx/conf  #进入Nginx默认安装目录。如果您修改过默认安装目录，请根据实际配置调整。
mkdir cert  #创建证书目录，命名为cert。

3. 使用远程登录工具附带的本地文件上传功能，将证书文件和私钥文件上传到Nginx服务器的证书目录（示例中为/usr/local/nginx/conf/cert）。
>**重要** 如果您在申请证书时将CSR生成方式设置为手动填写，请将您手动创建的证书私钥文件上传至/usr/local/nginx/conf/cert目录下。

4. 编辑Nginx配置文件nginx.conf，修改与证书相关的配置。
	a. 执行以下命令，打开配置文件。
>vim /usr/local/nginx/conf/nginx.conf

>**重要** nginx.conf默认保存在/usr/local/nginx/conf目录下。如果您修改过nginx.conf的位置，请将/usr/local/nginx/conf/nginx.conf替换成修改后的位置。您可以执行nginx -t，查看nginx的配置文件路径。

b. 按i键进入编辑模式。
	c.在nginx.conf中定位到HTTP协议代码片段（http{}），并在HTTP协议代码里，按照以下代码示例，修改server属性配置。
```php
#以下属性中，以ssl开头的属性表示与证书配置有关。
server {
    #配置HTTPS的默认访问端口为443。
    #如果未在此处配置HTTPS的默认访问端口，可能会造成Nginx无法启动。
    #如果您使用Nginx 1.15.0及以上版本，请使用listen 443 ssl代替listen 443和ssl on。
    listen 443 ssl;

#填写证书绑定的域名
    server_name <yourdomain>;
    root html;
    index index.html index.htm;

#填写证书文件名称
    ssl_certificate cert/<cert-file-name>.pem;
    #填写证书私钥文件名称  
    ssl_certificate_key cert/<cert-file-name>.key;

ssl_session_timeout 5m;
    #表示使用的加密套件的类型
    ssl_ciphers ECDHE-RSA-AES128-GCM-SHA256:ECDHE:ECDH:AES:HIGH:!NULL:!aNULL:!MD5:!ADH:!RC4;
    #表示使用的TLS协议的类型，您需要自行评估是否配置TLSv1.1协议。
    ssl_protocols TLSv1.1 TLSv1.2 TLSv1.3;

ssl_prefer_server_ciphers on;
    location / {
        #Web网站程序存放目录
        root html;
        index index.html index.htm;
    }
}
```
d. **可选：**设置HTTP请求自动跳转HTTPS。
如果您希望所有的HTTP访问自动跳转到HTTPS页面，则可以在需要跳转的HTTP站点下添加以下rewrite语句。
>**重要 **以下代码片段需要放置在nginx.conf文件中server {}代码段后面，即设置HTTP请求自动跳转HTTPS后，nginx.conf文件中会存在两个server {}代码段。
```php
server {
    listen 80;
    #填写证书绑定的域名
    server_name <yourdomain>;
    #将所有HTTP请求通过rewrite指令重定向到HTTPS。
    rewrite ^(.*)$ https://$host$1;
    location / {
        index index.html index.htm;
    }
}
```

> **重要** 配置放行80端口和443端口，否则网站访问可能出现异常。

e. 修改完成后，按Esc键、输入:wq!并按Enter键，保存修改后的配置文件并退出编辑模式。
5. 执行以下命令，重启Nginx服务。
>cd /usr/local/nginx/sbin  #进入Nginx服务的可执行目录。
./nginx -s reload  #重新载入配置文件。

如果重启Nginx服务时收到报错，您可以使用以下方法进行排查：
- 报错the "ssl" parameter requires ngx_http_ssl_module：您需要重新编译Nginx并在编译安装的时候加上--with-http_ssl_module配置。
- 报错""/cert/3970497_demo.aliyundoc.com.pem":BIO_new_file() failed (SSL: error:02001002:library:fopen library: No such file or directory:fopen('/cert/3970497_demo.aliyundoc.com.pem','r') error:2006D080:BIO routines:BIO_new_file:no such file)：您需要去掉证书相对路径最前面的/。例如，您需要去掉/cert/cert-file-name.pem最前面的/，使用正确的相对路径cert/cert-file-name.pem。

## 步骤三：验证是否安装成功
证书安装完成后，您可通过访问证书的绑定域名验证该证书是否安装成功。
>https://yourdomain   #需要将yourdomain替换成证书绑定的域名。

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

如果验证时出现访问异常，请参照下表进行排查。

| 异常现象 | 可能原因 | 处理方法 |
| --- | --- | --- |
| 通过HTTPS无法正常访问您的网站。 | 安装证书的Nginx服务器的443端口未开放或被其他工具拦截。 |配置开放443端口。  |
| 收到网站提示“您与网站之间的连接未完全安全”。  | 您的网站代码中调用的是HTTP协议。 | 您需要在网站代码中把HTTP协议修改为HTTPS协议。 |
|  收到网站提示“该网站未根据工信部相关法律进行备案”。| 您的网站未完成备案，未在接入商处完成备案接入。您的网站内容与备案信息不符、备案信息不准确、网站存在不适宜传播的内容等。| 请前往备案服务商的系统进行网站备案。 |