本文目录
一、下载证书
二、在Nginx(或Tengine)服务器上安装证书
1. 前提条件
2. 背景信息
3. 在Nginx类型的服务器上安装证书
步骤1:使用远程登录工具(例如PuTTY、Xshell)登录服务器。
步骤2:执行以下命令,在Nginx安装目录(/usr/local/nginx/conf)下创建一个用于存放证书的目录(命名为cert)。
步骤3:将本地证书文件和密钥文件上传到Nginx服务器的证书目录(示例中为/usr/local/nginx/conf/cert)。如下图所示:
步骤4:编辑Nginx配置文件(nginx.conf),修改与证书相关的配置内容。
步骤5:验证是否安装成功
SSL证书服务支持下载证书并将其安装到您的Web服务器。证书安装完成后,该证书绑定的网站使用SSL协议通信,从而保证您网站数据传输的安全。本文档介绍了nginx服务器类型证书的下载与安装操作。
一、下载证书
1. 登录阿里云SSL证书控制台。
2. 在SSL证书页面,定位到需要下载的证书并单击证书卡片右下角的下载。如下图所示
3. 定位到您需要安装证书的服务器类型并单击右侧操作栏的下载,将证书压缩包下载到本地。如下图所示:
备注:截止到2020年底,阿里云SSL证书支持安装到以下类型的Web服务器:Tomcat、Apache、Nginx、IIS、GlassFish、JBoss和Jetty服务器类型。.
二、在Nginx(或Tengine)服务器上安装证书
1. 前提条件
- 已经通过SSL证书服务完成证书签发。
- 已准备好远程登录工具(例如PuTTY、Xshell),用于登录您的Web服务器。
2. 背景信息
本文以CentOS 7操作系统、Nginx 1.16.2服务器系统为例进行说明。由于服务器系统版本不同,您在操作过程中使用的命令可能会略有区别。
本文中出现证书文件名称的地方,统一使用cert-file-name为例进行描述。例如,本文中用到的证书文件为cert-file-name.pem、证书密钥文件为cert-file-name.key。
3. 在Nginx类型的服务器上安装证书
说白了,Nginx类型的服务器就是客户端通过nginx服务访问你的项目,nginx服务在首先进行了一层拦截和过滤。以下默认为您的Nginx安装目录为/usr/local/nginx/,可根据您自己的实际安装目录进行修改。
步骤1:使用远程登录工具(例如PuTTY、Xshell)登录服务器。
步骤2:执行以下命令,在Nginx安装目录(/usr/local/nginx/conf)下创建一个用于存放证书的目录(命名为cert)。
cd /usr/local/nginx/conf #进入Nginx默认安装目录。如果您修改过默认安装目录,请根据实际配置进行调整。
mkdir cert #创建证书目录,命名为cert。
步骤3:将本地证书文件和密钥文件上传到Nginx服务器的证书目录(示例中为/usr/local/nginx/conf/cert)。如下图所示:
步骤4:编辑Nginx配置文件(nginx.conf),修改与证书相关的配置内容。
- 执行以下命令,打开配置文件。使用示例命令前,请注意:nginx.conf默认保存在/usr/local/nginx/conf目录下。如果您修改过nginx.conf的位置,请将
/usr/local/nginx/conf/nginx.conf
- 替换成修改后的位置。
vim /usr/local/nginx/conf/nginx.conf
- 按i键进入编辑模式。
- 在配置文件中定位到HTTP协议代码片段(
http{}
- ),并在HTTP协议代码里面添加以下server配置(如果server配置已存在,按照以下注释内容修改相应配置即可)。使用示例代码前,请注意替换以下内容:
yourdomain.com
- :替换成证书绑定的域名。 如果您购买的是单域名证书,需要修改为单域名(例如
www.aliyun.com
);如果您购买的是通配符域名证书,则需要修改为通配符域名(例如*.aliyun.com
)。
cert-file-name.pem
- :替换成您在步骤3上传的证书文件的名称。
cert-file-name.key
- :替换成您在步骤3上传的证书密钥文件的名称。
#以下属性中,以ssl开头的属性表示与证书配置有关。 server { listen 443 ssl; #配置HTTPS的默认访问端口为443。 #如果未在此处配置HTTPS的默认访问端口,可能会造成Nginx无法启动。 #如果您使用Nginx 1.15.0及以上版本,请使用listen 443 ssl代替listen 443和ssl on。 server_name yourdomain.com; #需要将yourdomain.com替换成证书绑定的域名。 root html; index index.html index.htm; ssl_certificate cert/cert-file-name.pem; #需要将cert-file-name.pem替换成已上传的证书文件的名称。 ssl_certificate_key cert/cert-file-name.key; #需要将cert-file-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; #表示使用的TLS协议的类型。 ssl_prefer_server_ciphers on; location / { root html; #站点目录。 index index.html index.htm; } }
- 可选:设置HTTP请求自动跳转HTTPS。 如果您希望所有的HTTP访问自动跳转到HTTPS页面,则可以在需要跳转的HTTP站点下添加以下
rewrite
语句。
使用示例代码前,请注意将yourdomain.com
替换成证书绑定的域名。- 修改完成后,按Esc键、输入:wq!并按Enter键,保存修改后的配置文件并退出编辑模式。
- 执行以下命令,重启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_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/cert-file-name.pem
最前面的/
,使用正确的相对路径cert/cert-file-name.pem
。
- 验证证书是否安装成功,参考步骤5。
步骤5:验证是否安装成功
证书安装完成后,您可通过访问证书的绑定域名验证该证书是否安装成功。
https://yourdomain.com #需要将yourdomain.com替换成证书绑定的域名。
如果网页地址栏出现小锁标志,表示证书已经安装成功。
不同类型证书安装成功后的效果不同,具体如下:
参考资料:阿里官方帮助文档:如何在Nginx或Tengine服务器上安装证书_数字证书管理服务(原SSL证书)-阿里云帮助中心
完结!