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

参考 阿里云 搜索 SSL证书服务
申请单域名

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

2020年5月20日 16:08:59

<main role="main" style="box-sizing: border-box; display: block;">

<article role="article" aria-labelledby="title_tkn_f31_ku7" style="box-sizing: border-box; display: block;">

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

前提条件

您的Nginx或Tengine服务器需具备以下条件：

• 服务器已开启了443端口（HTTPS服务的默认端口）。
• 服务器上已安装了http_ssl_module模块（启用SSL功能）。

背景信息

• 本文档以CentOS 7、Nginx 1.15.6为例。
• 本文档证书名称以domain name为示例，如证书文件名称为domain name.pem，证书密钥文件名称为domain name.key。
• 下载的Nginx证书压缩文件解压后包含：
  • .pem：证书文件。PEM文件的扩展名为CRT格式。
  • .key：证书的密钥文件。申请证书时如果未选择自动创建CRS，则下载的证书文件压缩包中不会包含.key文件，需要您将自己手动创建的密钥文件拷贝到cert目录下。

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

操作步骤

1. 在证书下载侧页面中定位到Nginx服务器，并单击右侧操作栏的下载，将Nginx服务器证书压缩包下载到本地。

2. 解压已下载保存到本地的Nginx证书压缩包文件。

   解压后的文件夹中有2个文件：

   • 证书文件：以.pem为后缀或文件类型。
   • 密钥文件：以.key为后缀或文件类型。
   证书文件

3. 登录您的Nginx服务器，在Nginx安装目录（默认Nginx安装目录为/usr/local/nginx/conf）下创建cert目录，并将下载的证书文件和密钥文件拷贝到cert目录中。

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

4. 修改Nginx安装目录/conf/nginx.conf文件。

   找到以下配置信息：

   放大查看

   
   # HTTPS server
     server {
     listen 443;
     server_name localhost;
     ssl on;
     ssl_certificate cert.pem;
     ssl_certificate_key cert.key;
     ssl_session_timeout 5m;
     ssl_protocols TLSv1 TLSv1.1 TLSv1.2;
     ssl_ciphers ALL:!ADH:!EXPORT56:RC4+RSA:+HIGH:+MEDIUM:+LOW:+SSLv2:+EXP;
     ssl_prefer_server_ciphers on;
     location / {
   
   

   按照下文中注释内容修改nginx.conf文件：

   放大查看

   
   # 以下属性中以ssl开头的属性代表与证书配置有关，其他属性请根据自己的需要进行配置。
   server {
   listen 443 ssl;   #SSL协议访问端口号为443。此处如未添加ssl，可能会造成Nginx无法启动。
   server_name localhost;  #将localhost修改为您证书绑定的域名，例如：www.example.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;   
   }
   }                     
   

5. 保存nginx.conf文件后退出。

6. 执行以下命令重启Nginx服务器。

   放大查看

   nginx -s stop
   nginx -s start
   

   说明 如果重启Nginx出现报错“the "ssl" parameter requires ngx_http_ssl_module”，您需要重新编译Nginx并在编译安装的时候加上--with-http_ssl_module配置。

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

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

   放大查看

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

虚拟主机配置SSL证书

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

2. 打开虚拟主机配置文件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;
   }
   

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

4. 可选：设置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。
   

5. 重启虚拟主机。

后续操作

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

放大查看

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

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

• DV或OV SSL数字证书部署在服务器上后，用户浏览器访问网站时，展示如下： DV/OV证书安装效果图
• EV SSL数字证书部署在服务器上后，用户浏览器访问网站时，展示如下： EV证书安装效果图

证书安装完成后，如果网站无法通过https正常访问，需确认您安装证书的服务器443端口是否已开启或被其他工具拦截。如果您使用的是阿里云ECS服务器，请前往ECS控制台安全组页面配置放行443端口。

相关文档

安装证书相关文档：

• 在Tomcat服务器上安装SSL证书
• 在Apache服务器上安装SSL证书
• Ubuntu系统Apache 2部署SSL证书
• 我获取到的数字证书如何配置在自己的Apache中？
• 在IIS服务器上安装SSL证书
• CentOS系统Tomcat 8.5或9部署SSL证书
• 在Jetty服务器上安装SSL证书

</article>

</main>