当前位置：首页 > news >正文

Nginx 配置 SSL（HTTPS）详解

news 来源：原创 2025/7/21 2:55:19

Nginx作为一款高性能的HTTP和反向代理服务器，自然支持SSL/TLS加密通信。本文将详细介绍如何在Nginx中配置SSL，实现HTTPS的访问。

随着互联网安全性的日益重要，HTTPS协议逐渐成为网站加密通信的标配。Nginx作为一款高性能的HTTP和反向代理服务器，自然支持SSL/TLS加密通信。本文将详细介绍如何在Nginx中配置SSL，实现HTTPS的访问。

使用Nginx进行反向代理的时候，对于正常的http；流量使用 location 块并且配置 proxy_pass 转发即可，但是如果是https的流量，使用Nginx进行反向代理的时候，直接使用 proxy_pass 会出现各种报错的情况，包括不限于：

502 Bad Getway
ERR_SSL_PROTOCOL_ERROR
ERR_CONNECTION_RESET

我本身遇到的ERR_SSL_PROTOCOL_ERROR错误比较多，这是因为在配置Nginx的时候，对于443端口本身的侦听没有带上 ssl 关键字，所以会报SSL协议错误，但是如果加上ssl，没有给证书位置，也是不行

对于转发到8080端口，如果配置不对(比如后端服务是http，结果配置了https)，会出现502 Bad Getway

proxy_pass后边的要写IP地址，不能写域名，否则还要解决域名解析的问题，有据称如果写localhost的，访问速度会变慢，是因为需要访问host文件解析localhost
响应8080端口的server块，也要注意，也要写成侦听ssl，配置好证书位置

upstream plan-uat {
server 10.202.159.74:8080 max_fails=3 fail_timeout=10 weight=1;
}

server {
server_name plan-uat.ztoky.cn;
listen 443 ssl ;
ssl_certificate ssl/ztoky.cn.crt;
ssl_certificate_key ssl/ztoky.cn.key;
access_log logs/plan-uat.ztoky.cn.access.log json;
```
    location /plan/ {proxy_pass      http://plan-uat/;include         proxy.conf;}
```
}

检查 linux 服务器上的 nginx 是否安装 ssl 模块
nginx 安装目录，下面有个 sbin 文件夹，来到 sbin 目录下执行 ./nginx -V命令，注意是大写的 V，小写的 v 只会展示 nginx 的版本号信息。执行完出现下图圈红的这些信息说明 ssl 模块已经安装过了。可以忽略下文的 ssl 模块安装的相关内容，直接看 nginx 配置的内容。

cd /usr/local/nginx/sbin
./nginx -V

为 nginx 安装 ssl 模块
如果没有安装 ssl 模块，即使你成功的配置好 https 的相关配置，网站也依旧不能使用 https，会提示诸如：无法提供安全连接、TLS协议不支持等问题。ssl 模块的安装是为了能让后端接口得以使用 https 的方式调用。找到我们的 nginx 安装解压包，我这里是放在 /usr/local/software 目录下，然后执行如下命令进入到 nginx-1.18.0 目录下。

cd /usr/local/nginx-1.18.0

来到 ngixn-1.18.0 目录然后依次执行如下这命令，配置了 ssl 模块，使用 make 命令重新编译

./configure --with-http_ssl_module
make

进入 objs 目录，会看到 nginx 的可执行文件

注意，不能使用 make install 命令，这样会导致重新安装 nginx，此时当前目录就会出现 objs 目录

替换 nginx 可执行文件，我们使用这个新的 nginx 可执行文件替换 sbin 目录下的 nginx 可执行文件

cp ./nginx /usr/local/nginx/sbin/

系统会询问你是否覆盖，输入 y 即可，如果覆盖失败，多半是因为你的 nginx 还在启动中，先将 nginx 关闭即可，再次检验是否安装 ssl 模块，进入 nginx 目录

cd /usr/local/nginx/sbin/

执行命令

./nginx -V

此时就能看到 ssl 模块已经安装成功了

准备SSL证书

首先，我们需要准备SSL证书。你可以选择从证书颁发机构（CA）购买商业证书，也可以自己生成自签名证书。自签名证书虽然免费，但不会被浏览器信任，仅适用于测试环境。

如果你选择购买商业证书，通常会获得以下文件：

证书文件（例如：example.com.crt）
私钥文件（例如：example.com.key）
中间证书文件（如果有的话）

配置Nginx SSL 启用443端口

(1) 打开Nginx配置文件，通常位于/etc/nginx/nginx.conf或/etc/nginx/conf.d/default.conf。

(2) 在http块中，配置SSL相关参数。示例如下：

http {...server {listen 443 ssl;server_name example.com;ssl_certificate /path/to/example.com.crt;  # 证书文件路径ssl_certificate_key /path/to/example.com.key;  # 私钥文件路径# 如果有中间证书，也需要配置ssl_trusted_certificate /path/to/intermediate.crt;# 其他SSL配置参数ssl_session_cache    shared:SSL:1m;ssl_session_timeout  5m;ssl_protocols TLSv1.2 TLSv1.3;  # 支持的协议版本ssl_ciphers ECDH:AESGCM:HIGH:!RC4:!DH:!MD5:!aNULL:!eNULL;  # 使用此加密套件ssl_prefer_server_ciphers on;  # 优先使用服务器端的加密套件# 其他server配置...}...
}

测试HTTPS访问

现在，你的Nginx服务器已经配置了SSL，可以通过HTTPS协议访问了。在浏览器中输入https://example.com，检查是否能够成功访问并显示安全的连接标识（如绿色锁头）。

此外，你还可以使用命令行工具（如openssl或curl）来测试HTTPS连接和证书的有效性。

配置代理

使用proxy_pass指令来配置代理。以下是一个示例配置，将HTTPS请求代理到另一个HTTPS服务器：(注意这里的后端是HTTPS的服务)

后端服务是https类型的proxy_pass https://your.backend.server;

后端服务是http类型的 proxy_pass http://your.backend.server;

server {??# 监听443端口，处理所有HTTPS请求
??listen 443 ssl;??server_name your.domain.com;??# SSL配置 
? ssl_certificate /path/to/your/cert.pem;
??ssl_certificate_key /path/to/your/private.key;
??ssl_protocols TLSv1 TLSv1.1 TLSv1.2;
??ssl_ciphers HIGH:!aNULL:!MD5;??# 代理配置，将HTTPS请求代理到另一个HTTPS服务器
??location / {
????proxy_pass https://your.backend.server;
??}
}

以上配置假设您的域名是your.domain.com，代理目标是您的后端HTTPS服务器（例如https://your.backend.server）。请记住将路径和参数适当地配置为您的特定场景。

准备SSL证书

配置Nginx SSL 启用443端口

测试HTTPS访问

配置代理

相关文章：