nginx服务器证书安装

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 进行访问。

**操作过程如果出现问题,请您 联系我们 ** 如果浏览器地址栏显示安全锁标识,则说明证书安装成功。如下图所示: