TOP

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

作者: admin编辑
日期: 2020-04-19
<p>文章来源:&nbsp;<a href="https://help.aliyun.com/document_detail/98728.html?spm=a2c4g.11186623.2.12.f795625adak8U8#concept-n45-21x-yfb" target="_blank">在Nginx/Tengine服务器上安装证书</a></p><p>阿里云SSL证书服务支持下载证书安装到Nginx/Tengine服务器上,本文介绍了证书安装的具体操作。</p><h2>背景信息</h2><ul><li>本文档以CentOS 7、Nginx 1.15.6为例。</li><li>本文档证书名称以domain name为示例,如证书文件名称为domain name.pem,证书密钥文件名称为domain name.key。</li><li>下载的Nginx证书压缩文件解压后包含:<ul><li>.pem:证书文件。PEM文件的扩展名为CRT格式。</li><li>.key:证书的密钥文件。申请证书时如果未选择自动创建CRS,则下载的证书文件压缩包中不会包含.key文件,需要您将自己手动创建的密钥文件拷贝到cert目录下。</li></ul></li></ul><p><br></p><p>说明&nbsp;.pem扩展名的证书文件采用Base64-encoded的PEM格式文本文件,您可根据需要修改成其他扩展名。 证书格式详细内容,请参见<a href="https://help.aliyun.com/document_detail/42214.html?spm=a2c4g.11186623.2.12.730f45ea3fYOez#concept-a4g-mbv-ydb">主流数字证书都有哪些格式?</a></p><h2>操作步骤</h2><ol><li>登录阿里云<a href="https://yundunnext.console.aliyun.com/?spm=a2c4g.11186623.2.13.730f45ea3fYOez&amp;p=cas#/overview/cn-hangzhou" target="_blank">SSL证书控制台</a>。</li><li>在SSL证书页面,单击已签发标签,定位到需要下载的证书并单击证书卡片右下角的下载。<img src="https://static-aliyun-doc.oss-cn-hangzhou.aliyuncs.com/assets/img/zh-CN/8400591851/p39167.jpg" alt="下载"><br></li><li>在证书下载侧页面中定位到Nginx服务器,并单击右侧操作栏的下载,将Nginx服务器证书压缩包下载到本地。</li><li>解压已下载保存到本地的Nginx证书压缩包文件。解压后的文件夹中有2个文件:<ul><li>证书文件:以.pem为后缀或文件类型。</li><li>密钥文件:以.key为后缀或文件类型。</li></ul><img src="https://static-aliyun-doc.oss-cn-hangzhou.aliyuncs.com/assets/img/zh-CN/8400591851/p33690.png" width="400" alt="证书文件"><br><br></li><li>登录您的Nginx服务器,在Nginx安装目录(默认Nginx安装目录为/usr/local/nginx/conf)下创建cert目录,并将下载的证书文件和密钥文件拷贝到cert目录中。<br>说明&nbsp;如果您在申请证书时选择手动创建CSR文件,请将对应的密钥文件放到cert目录中,并命名为domain name.key。<br><br><br></li><li>修改Nginx安装目录/conf/nginx.conf文件。找到以下配置信息:<br><pre><code> <span class="hljs-comment" style="color: rgb(119, 105, 119);"># HTTPS server</span> <span class="hljs-section" style="color: rgb(81, 106, 236);">server</span> { <span class="hljs-attribute" style="color: rgb(202, 64, 43);">listen</span> <span class="hljs-number" style="color: rgb(166, 89, 38);">443</span>; <span class="hljs-attribute" style="color: rgb(202, 64, 43);">server_name</span> localhost; <span class="hljs-attribute" style="color: rgb(202, 64, 43);">ssl</span> <span class="hljs-literal" style="color: rgb(166, 89, 38);">on</span>; <span class="hljs-attribute" style="color: rgb(202, 64, 43);">ssl_certificate</span> cert.pem; <span class="hljs-attribute" style="color: rgb(202, 64, 43);">ssl_certificate_key</span> cert.key; <span class="hljs-attribute" style="color: rgb(202, 64, 43);">ssl_session_timeout</span> <span class="hljs-number" style="color: rgb(166, 89, 38);">5m</span>; <span class="hljs-attribute" style="color: rgb(202, 64, 43);">ssl_protocols</span> TLSv1 TLSv1.<span class="hljs-number" style="color: rgb(166, 89, 38);">1</span> TLSv1.<span class="hljs-number" style="color: rgb(166, 89, 38);">2</span>; <span class="hljs-attribute" style="color: rgb(202, 64, 43);">ssl_ciphers</span> ALL:!ADH:!EXPORT56:RC4+RSA:+HIGH:+MEDIUM:+LOW:+SSLv2:+EXP; <span class="hljs-attribute" style="color: rgb(202, 64, 43);">ssl_prefer_server_ciphers</span> <span class="hljs-literal" style="color: rgb(166, 89, 38);">on</span>; <span class="hljs-attribute" style="color: rgb(202, 64, 43);">location</span> / { </code></pre><br><p>按照下文中注释内容修改nginx.conf文件:</p><br><pre><code> # 以下属性中以ssl开头的属性代表与证书配置有关,其他属性请根据自己的需要进行配置。 server { listen <span class="hljs-number" style="color: rgb(166, 89, 38);">443</span> ssl; #SSL协议访问端口号为<span class="hljs-number" style="color: rgb(166, 89, 38);">443</span>。此处如未添加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 <span class="hljs-number" style="color: rgb(166, 89, 38);">5</span>m; 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; } } </code></pre><br><br></li><li>保存nginx.conf文件后退出。</li><li>执行以下命令重启Nginx服务器。<br><pre><code>nginx -s stop nginx -s start</code></pre><br><br>说明&nbsp;如果您有配置多个虚拟主机Include conf/vhost ,更多操作请参见<a href="https://help.aliyun.com/document_detail/98728.html?spm=a2c4g.11186623.2.12.f795625adak8U8#section-wy0-022-q1s">虚拟主机配置SSL证书</a>进行配置。<br><br><br></li><li>可选:&nbsp;设置HTTP请求自动跳转HTTPS。在需要跳转的HTTP站点下添加以下rewrite语句,实现HTTP访问自动跳转到HTTPS页面。<br><pre><code><span class="hljs-section" style="color: rgb(81, 106, 236);">server</span> { <span class="hljs-attribute" style="color: rgb(202, 64, 43);">listen</span> <span class="hljs-number" style="color: rgb(166, 89, 38);">80</span>; <span class="hljs-attribute" style="color: rgb(202, 64, 43);">server_name</span> localhost; <span class="hljs-comment" style="color: rgb(119, 105, 119);">#将localhost修改为您证书绑定的域名,例如:www.example.com。</span> <span class="hljs-attribute" style="color: rgb(202, 64, 43);">rewrite</span><span class="hljs-regexp" style="color: rgb(202, 64, 43);"> ^(.*)$</span> https://<span class="hljs-variable" style="color: rgb(202, 64, 43);">$host</span><span class="hljs-variable" style="color: rgb(202, 64, 43);">$1</span> <span class="hljs-literal" style="color: rgb(166, 89, 38);">permanent</span>; <span class="hljs-comment" style="color: rgb(119, 105, 119);">#将所有http请求通过rewrite重定向到https。</span> <span class="hljs-attribute" style="color: rgb(202, 64, 43);">location</span> / { <span class="hljs-attribute" style="color: rgb(202, 64, 43);">index</span> index.html index.htm; } }</code></pre><br><br></li></ol><h2>虚拟主机配置SSL证书</h2><ol><li>登录您的虚拟机,在Web目录下创建cert目录,并将下载的证书文件和密钥文件拷贝到cert目录中。</li><li>打开虚拟主机配置文件vhost.conf或*.conf,复制以下内容粘贴到下方位置、将端口改为443(https默认端口)并增加证书相关配置。<br><pre><code><span class="hljs-keyword" style="font-weight: 700; color: rgb(123, 89, 192);">server</span> { <span class="hljs-keyword" style="font-weight: 700; color: rgb(123, 89, 192);">listen</span> <span class="hljs-number" style="color: rgb(166, 89, 38);">80</span>; server_name localhost ; <span class="hljs-keyword" style="font-weight: 700; color: rgb(123, 89, 192);">location</span> / { <span class="hljs-keyword" style="font-weight: 700; color: rgb(123, 89, 192);">index</span> <span class="hljs-keyword" style="font-weight: 700; color: rgb(123, 89, 192);">index</span>.html <span class="hljs-keyword" style="font-weight: 700; color: rgb(123, 89, 192);">index</span>.htm; } <span class="hljs-keyword" style="font-weight: 700; color: rgb(123, 89, 192);">server</span> { <span class="hljs-keyword" style="font-weight: 700; color: rgb(123, 89, 192);">listen</span> <span class="hljs-number" style="color: rgb(166, 89, 38);">443</span> ssl; server_name localhost; root html; <span class="hljs-keyword" style="font-weight: 700; color: rgb(123, 89, 192);">index</span> <span class="hljs-keyword" style="font-weight: 700; color: rgb(123, 89, 192);">index</span>.html <span class="hljs-keyword" style="font-weight: 700; color: rgb(123, 89, 192);">index</span>.htm; ssl_certificate cert/<span class="hljs-keyword" data-spm-anchor-id="a2c4g.11186623.2.i27.730f45ea3fYOez" style="font-weight: 700; color: rgb(123, 89, 192);">domain</span> <span class="hljs-type" data-spm-anchor-id="a2c4g.11186623.2.i25.730f45ea3fYOez" style="font-weight: 700; color: rgb(166, 89, 38);">name</span>.pem; #将<span class="hljs-keyword" style="font-weight: 700; color: rgb(123, 89, 192);">domain</span> <span class="hljs-type" style="font-weight: 700; color: rgb(166, 89, 38);">name</span>.pem替换成您证书的文件名。 ssl_certificate_key cert/<span class="hljs-keyword" style="font-weight: 700; color: rgb(123, 89, 192);">domain</span> <span class="hljs-type" style="font-weight: 700; color: rgb(166, 89, 38);">name</span>.key; #将<span class="hljs-keyword" style="font-weight: 700; color: rgb(123, 89, 192);">domain</span> <span class="hljs-type" style="font-weight: 700; color: rgb(166, 89, 38);">name</span>.key替换成您证书的密钥文件名。 ssl_session_timeout <span class="hljs-number" style="color: rgb(166, 89, 38);">5</span>m; ssl_ciphers ECDHE-RSA-AES128-GCM-SHA256:ECDHE:ECDH:AES:HIGH:!<span class="hljs-keyword" style="font-weight: 700; color: rgb(123, 89, 192);">NULL</span>:!aNULL:!MD5:!ADH:!RC4; ssl_protocols TLSv1 TLSv1<span class="hljs-number" style="color: rgb(166, 89, 38);">.1</span> TLSv1<span class="hljs-number" style="color: rgb(166, 89, 38);">.2</span>; ssl_prefer_server_ciphers <span class="hljs-keyword" style="font-weight: 700; color: rgb(123, 89, 192);">on</span>; <span class="hljs-keyword" style="font-weight: 700; color: rgb(123, 89, 192);">location</span> / { <span class="hljs-keyword" style="font-weight: 700; color: rgb(123, 89, 192);">index</span> <span class="hljs-keyword" style="font-weight: 700; color: rgb(123, 89, 192);">index</span>.html <span class="hljs-keyword" style="font-weight: 700; color: rgb(123, 89, 192);">index</span>.htm; }</code></pre><br><br></li><li>保存vhost.conf或*.conf文件后退出。</li><li>可选:&nbsp;设置HTTP请求自动跳转HTTPS。在Web目录下打开.htaccess文件(如没有,需新建该文件),添加以下rewrite语句,实现HTTP访问自动跳转到HTTPS页面。<br><pre><code>RewriteEngine&nbsp;On RewriteCond&nbsp;<span class="hljs-string" style="color: rgb(136, 136, 255);">%{HTTP:From-Https}</span>&nbsp;!^on$&nbsp;[NC] RewriteCond&nbsp;<span class="hljs-string" style="color: rgb(136, 136, 255);">%{HTTP_HOST}</span>&nbsp;^(www.)?yourdomain.com$&nbsp;[NC]&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="hljs-comment" style="color: rgb(119, 105, 119);">#&nbsp;将yourdomain.com修改为您证书绑定的域名,例如:example.com。</span> RewriteRule&nbsp;^(.*)$&nbsp;<span class="hljs-symbol" style="color: rgb(136, 0, 0);">https:</span>/<span class="hljs-regexp" style="color: rgb(202, 64, 43);">/www.yourdomain.com/</span>$1&nbsp;[R=<span class="hljs-number" style="color: rgb(166, 89, 38);">301</span>,L] <span class="hljs-comment" style="color: rgb(119, 105, 119);">#&nbsp;将yourdomain.com修改为您证书绑定的域名,例如:example.com。</span></code></pre><br><br></li><li>重启虚拟主机。</li></ol><h2>后续操作</h2><p>证书安装完成后,可通过登录证书的绑定域名验证该证书是否安装成功。</p><pre><code>https://<span class="hljs-keyword" style="font-weight: 700; color: rgb(123, 89, 192);">domain</span> <span class="hljs-type" style="font-weight: 700; color: rgb(166, 89, 38);">name</span> #<span class="hljs-keyword" style="font-weight: 700; color: rgb(123, 89, 192);">domain</span> <span class="hljs-type" style="font-weight: 700; color: rgb(166, 89, 38);">name</span>替换成证书绑定的域名。</code></pre><p>如果网页地址栏出现小锁标志,表示证书安装成功。</p><ul><li>DV/OV SSL数字证书部署在服务器上后,用户浏览器访问网站时,展示如下:<img src="https://static-aliyun-doc.oss-cn-hangzhou.aliyuncs.com/assets/img/zh-CN/8400591851/p70469.png" alt="阿里云OV和EV证书展示效果"></li><li>EV SSL数字证书部署在服务器上后,用户浏览器访问网站时,展示如下:<img src="https://static-aliyun-doc.oss-cn-hangzhou.aliyuncs.com/assets/img/zh-CN/8400591851/p70468.png" alt="阿里云EV证书展示效果"></li></ul><p>证书安装完成后,如果网站无法通过https正常访问,需确认您安装证书的服务器443端口是否已开启或被其他工具拦截。如果您使用的是阿里云ECS服务器,请前往ECS控制台安全组页面配置放行443端口。</p>