Nginx服务证书安装(Linux)
操作场景
- 本文档指导您如何在 Nginx 服务器中安装 SSL 证书。以证书名称 ubn.cn通配符证书,域名test.ubn.cn为例。
- Nginx 版本以 nginx/1.18.0 为例。
- 当前服务器的操作系统为 CentOS 7,由于操作系统的版本不同,详细操作步骤略有区别。
- 安装 SSL 证书前,请您在 Nginx 服务器上开启 HTTPS 默认端口 443,避免证书安装后无法启用 HTTPS。
- SSL 证书文件上传至服务器方法可参考 如何将本地文件拷贝到云服务器。
前提条件
已准备文件远程拷贝软件,例如 WinSCP(建议从官方网站获取最新版本)。 已准备远程登录工具,例如 PuTTY 或者 Xshell(建议从官方网站获取最新版本)。 已在当前服务器中安装配置含有 http_ssl_module 模块的 Nginx 服务(默认yum或apt安装的均默认安装)。
操作步骤
1.登录网站控制中心下载证书,可参考帮助文档中,证书下载。
2.解压缩ssl证书压缩包
- 解压后文件夹内容:
文件名称路径 | 作用 | 使用类型 |
---|---|---|
ubn_cn.key | 证书私钥 | iis/apache/nginx通用私钥 |
Apache/ubn_cn.crt | 证书文件 | apache使用 |
IIS/ubn_cn.pfx | 证书文件 | iis使用 |
Nginx/ubn_cn.crt | 证书文件 | nginx、防火墙、cdn、负载均衡、对象存储等通用 |
- 解压后文件示例:
3.使用 “WinSCP”(即本地与远程计算机间的复制文件工具)登录 Apache 服务器,可参考如何上传文件到云服务器
4.将已获取到的 Nginx目录下的ubn_cn.crt 证书文件和 ubn_cn.key 私钥文件从本地目录拷贝到 Nginx 服务器的 /etc/nginx 目录(此处为 Nginx 默认安装目录,请根据实际情况操作)下。
5.远程登录 Nginx 服务器。例如,使用 “PuTTY” 工具 ,xshell等工具登录。
编辑 Nginx 根目录下的 nginx.conf 文件(默认安装配置文件路径/etc/nginx/nginx.conf)。修改内容如下:
-
说明 如找不到以下内容,可以手动添加。可执行命令 nginx -t ,找到nginx的配置文件路径。
如下图所示:: 此操作可通过执行 vim /etc/nginx/nginx.conf 命令行编辑该文件。
由于版本问题,配置文件可能存在不同的写法。例如:Nginx 版本为 nginx/1.15.0 以上请使用 listen 443 ssl 代替 listen 443 和 ssl on。
server {
#SSL 默认访问端口号为 443
listen 443 ss1;
#请填写绑定证书的域名
server_name test.ubn.cn;
#请填写证书文件的相对路径或绝对路径
ssl_certificate ubn_cn.crt;
#请填写私钥文件的相对路径或绝对路径
ssl_certificate_key ubn_cn.key;
ssl_session_timeout 5m;
#请按照以下协议配置
ssl_protocols TLSv1.2 TLSv1.3;
#请按照以下套件配置,配置加密套件,写法遵循openssl标准。
ssl_ciphers ECDHE-RSA-AES128-GCM-SHA256:HIGH: !aNULL: !MD5: !RC4: !DHE;
ssl_prefer_server_ciphers on;
location / {
#网站主页路径。此路径仅供参考,具体请您按照实际目录操作。
#例如,您的网站主页在Nginx服务器的/etc/wnaw目录下,则请修改root后面的 html为/etc/wnv。
root html;
index index.html index.htm;
}
}
6.通过执行以下命令验证配置文件问题。
nginx -t
- 若存在,请您重新配置或者根据提示修改存在问题。
- 若不存在,请执行 步骤7。
7.通过执行以下命令重载 Nginx。
nginx -s reload
8.重载成功,即可使用 https://test.ubn.cn 进行访问。:
HTTP 自动跳转 HTTPS 的安全配置(可选)
如果您需要将 HTTP 请求自动重定向到 HTTPS。您可以通过以下操作设置:
1. 根据实际需求,选择以下配置方式:
- 在页面中添加 JS 脚本。
- 在后端程序中添加重定向。
- 通过 Web 服务器实现跳转。
- Nginx 支持 rewrite 功能
若您在编译时没有去掉 pcre,您可在 HTTP 的 server 中增加 return 301 https://$host$request_uri;,即可将默认80端口的请求重定向为 HTTPS。修改如下内容:
- 说明:
未添加注释的配置语句,您按照下述配置即可。 由于版本问题,配置文件可能存在不同的写法。例如:Nginx 版本为 nginx/1.15.0 以上请使用 listen 443 ssl 代替 listen 443 和 ssl on。
server {
#SSL默认访问端口号为 443
listen 443 ssl;
#请填写绑定证书的域名
server_name test.ubn.cn;
#请填写证书文件的相对路径或绝对路径
ssl_certificate ubn_cn.crt;
#请填写私钥文件的相对路径或绝对路径
ssl_certificate_key ubn_cn.key;
ssl_session_timeout 5m;
#请按照以下套件配置,配置加密套件,写法遵循openssl标准。
ssl_ciphers ECDHE-RSA-AES128-GCM-SHA256:ECDHE:ECDH:AES:HIGH:!NULL: !aNULL: !MD5: !ADH: !RC4;
#请按照以下协议配置 ssl_protocols TLSv1.2 TLSv1.3;
ssl_prefer_server_ciphers on;
location /{
#网站主页路径。此路径仅供参考,具体请您按照实际目录操作。
#例如,您的网站主页在Nginx服务器的/etc/www目录下,则请修改 root后面的html为/etc/www。
root html;
index index.html index.htm;
}
}
server {
listen 80;
#请填写绑定证书的域名
server_name test.ubn.cn;
#把http的域名请求转成
https return 301 https://$host$request_uri;
}
}
2.通过执行以下命令验证配置文件问题。
nginx -t
3.通过执行以下命令重载 Nginx。
nginx -s reload
**4.重载成功,即可使用 https://test.ubn.cn 进行访问。**操作过程如果出现问题,请您 联系我们 如果浏览器地址栏显示安全锁标识,则说明证书安装成功。如下图所示:
Nginx服务证书安装(Windows)
操作场景
本文档指导您如何在 Windows 操作系统上 安装nginx SSL 证书。
说明
- 本文以证书名称 ubn.cn通配符证书,域名test.ubn.cn为例。
- Nginx 版本以 nginx/1.24.0 为例。
- 当前服务器的操作系统为 Windows Server 2022,由于操作系统的版本不同,详细操作步骤略有区别。
- 安装 SSL 证书前,请您在服务器上开启 HTTPS 默认端口 443,避免证书安装后无法启用 HTTPS。
操作步骤
1.登录网站控制中心下载证书,可参考帮助文档证书下载。
2.下载解压证书压缩包
- 解压后文件夹内容:
文件名称路径 | 作用 | 使用类型 |
---|---|---|
ubn_cn.key | 证书私钥 | iis/apache/nginx通用私钥 |
Apache/ubn_cn.crt | 证书文件 | apache使用 |
IIS/ubn_cn.pfx | 证书文件 | iis使用 |
Nginx/ubn_cn.crt | 证书文件 | nginx、防火墙、cdn、负载均衡、对象存储等通用 |
- 解压后文件示例:
3.通过RDP登录nginx服务器。可参考如何将本地文件拷贝到云服务器
将已获取到的 nginx目录下的ubn_cn.crt证书文件和 ubn_cn.key 私钥文件从本地目录复制到服务器的 C:\nginx\ 目录下(可以为任意不含中文字符和空格的目录,请根据实际情况操作)。
4.编辑 nginx.exe 所在目录下的 conf\nginx.conf 文件。修改内容如下:
server {
#SSL默认访问端口号为 443
listen 443 ssl;
#请填写绑定证书的域名
server_name test.ubn.cn;
#请填写证书文件的绝对路径。此路径仅供参考,具体请您按照实际目录操作
ssl_certificate C: \\nginx\\certificates\\ubn_cn.crt;
#请填写私钥文件的绝对路径。此路径仅供参考,具体请您按照实际目录操作
ssl_certificate_key C:\\nginx\\certificates\\ubn_cn.key;
ssl_session_timeout 5m;
#请按照以下协议配置
ssl_protocols TLSv1.2 TLSv1.3;
#请按照以下套件配置,配置加密套件,写法遵循openssl标准。
ss1_ciphers ECDHE-RSA-AES128-GCM-SHA256:HIGH: !aNULL: !MD5: !RC4: !DHE;
ssl_prefer_server_ciphers on;
location / {
#网站主页路径。此路径仅供参考,具体请您按照实际目录操作。
root C:\\html;
index index.html index.htm;
}
}
5.通过执行以下命令验证配置文件问题。
.\nginx.exe -t
- 若存在,请您重新配置或者根据提示修改存在问题。
- 若不存在,请执行 步骤6。
6.以下命令启动 Nginx。
start .\nginx.exe -t
7.重新启动 Apache 服务器,即可使用 https://test.ubn.cn 进行访问。
如果浏览器地址栏显示安全锁标识,则说明证书安装成功。如下图所示:
7.重载成功,即可使用 https://test.ubn.cn 进行访问。
**操作过程如果出现问题,请您 联系我们 ** 如果浏览器地址栏显示安全锁标识,则说明证书安装成功。如下图所示: