Nginx配置HTTPS教程

文章导读
配置 HTTPS 时,真正容易失败的是三件事:证书文件本身对不对、你改的那个文件是不是 Nginx 真正加载的文件、以及转发到后端时请求头有没有带上协议信息;listen 443 ssl 这一行本身通常不会出问题。所以建议按“先确认版本和生效配置 → 再确认证书与私钥 → 最后确认转发头”的顺序处理,每一步都用命令看到结果再往下走,不要一次改完再 reload。
📋 目录
  1. A Nginx配置HTTPS转发最新版本更新内容是
  2. B Nginx配置HTTPS反向代理
  3. C Nginx:先把能核对的事实摆清楚
  4. D Nginx最容易搞错的一点
  5. E Nginx:一个照着就能做完的做法
A A

配置 HTTPS 时,真正容易失败的是三件事:证书文件本身对不对、你改的那个文件是不是 Nginx 真正加载的文件、以及转发到后端时请求头有没有带上协议信息;listen 443 ssl 这一行本身通常不会出问题。所以建议按“先确认版本和生效配置 → 再确认证书与私钥 → 最后确认转发头”的顺序处理,每一步都用命令看到结果再往下走,不要一次改完再 reload。

常见失败点集中在证书链不完整、指令写在了没被 include 的文件里、以及后端应用拿不到 X-Forwarded-Proto 而反复重定向。先用 nginx -v 和 nginx -T 固定版本与真实配置路径,再用 openssl 核对证书与私钥是否配对、是否带中间证书;每次改完先 nginx -t,通过后再 reload。后端仍是 HTTP 时,转发头要显式设置,否则前端看起来是 HTTPS,后端判断却是 HTTP。

Nginx配置HTTPS转发最新版本更新内容是

这个问题在排查里对应第一步:确认机器上跑的 Nginx 是哪个版本、哪条指令真正生效。版本差异不能凭印象,要落到具体输出上。

  • nginx -v:输出形如 nginx version: nginx/1.24.0,这是你后面所有判断的基准。
  • nginx -V:输出编译参数,检查是否含 --with-http_ssl_module。缺少该模块时,配置里出现 ssl_certificate 会直接报 unknown directive。
  • nginx -T:打印主配置和所有被 include 的文件,每段前有 # configuration file /etc/nginx/conf.d/xxx.conf: 这样的行,这是判断“我改的文件到底有没有被加载”的唯一可靠依据。老版本没有 -T 时,用 nginx -t 输出的 the configuration file /etc/nginx/nginx.conf syntax is ok 确认主配置路径,再顺着 include 逐层看。
  • 包来源与版本:Debian/Ubuntu 用 dpkg-query -W -f='${Version}\n' nginx,RHEL 系用 rpm -q nginx。

拿到版本号后,去 nginx.org 的 CHANGES 页面对照该版本改了什么,这是可核对的位置。例如 http2 on; 这种独立指令在较早版本会报 unknown directive "http2",那些版本仍写在 listen 443 ssl http2; 里——到底该用哪种写法,以 nginx -v 打出来的版本号为准,不要照抄网上配置。

Nginx配置HTTPS反向代理

这一段对应 server 块中 location 里的 proxy_pass,作用是 TLS 在 Nginx 这一层终止,再转给后端。

确认是不是它,用 nginx -T | grep -n "proxy_pass",输出会带文件名和行号,能直接看出命中的是哪个配置文件、哪一行。请求进来后,看 access log 里的 $upstream_addr、$upstream_status——这两个变量需要在 log_format 里显式加上才会记录,默认格式里没有;临时排查也可以在 error.log 里看 upstream 相关行,路径通常是 /var/log/nginx/error.log。

两个容易忽略的细节:proxy_pass http://127.0.0.1:8080; 与 proxy_pass http://127.0.0.1:8080/; 在带路径的 location 下转发结果不同,结尾斜杠会替换掉匹配到的前缀;另外 proxy_pass 写 http:// 时,Nginx 到后端就是明文,与客户端是否走 HTTPS 无关。

Nginx:先把能核对的事实摆清楚

先不下结论,把下面几项挨个跑一遍,把输出贴出来再判断:

Nginx配置HTTPS教程
  1. 证书与私钥是否配对:openssl x509 -in /etc/nginx/ssl/example.com.crt -noout -modulus | openssl md5 与 openssl rsa -in /etc/nginx/ssl/example.com.key -noout -modulus | openssl md5 结果应一致;ECC 私钥改用 openssl pkey -in ... -pubout | openssl md5 和 openssl x509 -in ... -pubkey -noout | openssl md5 比对。
  2. 证书覆盖的域名与有效期:openssl x509 -in /etc/nginx/ssl/example.com.crt -noout -subject -dates -ext subjectAltName。
  3. 证书链是否完整:openssl s_client -connect example.com:443 -servername example.com -showcerts ,看返回的证书张数和 Verify return code。
  4. 端口有没有在听:ss -lntp | grep -E ':443|:80',能看到 nginx 进程占着 443。
  5. 配置语法与加载路径:nginx -t,再用 nginx -T 确认 ssl_certificate 指向的路径与文件一致。
  6. 日志位置:/var/log/nginx/access.log、/var/log/nginx/error.log,reload 失败的信息会出现在 error.log 或 systemctl status nginx 的输出里。

这六项都属于可核对的事实。哪一项没过,问题范围就缩到那一步,不需要再猜。

Nginx最容易搞错的一点

最常见的误解是:以为在 server 里写了 listen 443 ssl,整条链路就都是 HTTPS 了。实际上它只表示客户端到 Nginx 这段加密,Nginx 到 upstream 默认仍是 HTTP。

分界线在于:后端应用根据什么判断请求协议。如果应用读的是 X-Forwarded-Proto,而配置里没设置这个头,应用会认为自己收到的是 HTTP,于是把页面重定向到 https 地址;浏览器再请求一次,又走同一个循环,表现出来就是“打开首页一直在转圈”或 ERR_TOO_MANY_REDIRECTS。

能把两种情况区分开的检查动作:在 Nginx 日志格式里临时加上 $scheme 和 $http_x_forwarded_proto,访问一次页面后看这两列的值;同时在浏览器里用 curl -sS -o /dev/null -w "%{http_code} %{num_redirects}\n" https://example.com/ 看跳转次数——num_redirects 明显不为 0 而最终状态码仍是 301/302,基本就是头没传或传错。

Nginx:一个照着就能做完的做法

以下以域名 example.com、后端 127.0.0.1:8080 为例,路径按自己环境替换。

  1. 放证书,确认属主可读:sudo install -m 644 example.com.fullchain.crt /etc/nginx/ssl/,私钥 sudo install -m 600 example.com.key /etc/nginx/ssl/。fullchain 是“站点证书 + 中间证书”,只放站点证书在某些客户端上会校验失败。
  2. 写配置到 /etc/nginx/conf.d/example.com.conf(先确认主配置里有 include /etc/nginx/conf.d/*.conf;,用 nginx -T 可验证):
server {
    listen 443 ssl;
    server_name example.com;

    ssl_certificate     /etc/nginx/ssl/example.com.fullchain.crt;
    ssl_certificate_key /etc/nginx/ssl/example.com.key;
    ssl_protocols       TLSv1.2 TLSv1.3;

    location / {
        proxy_pass http://127.0.0.1:8080;
        proxy_set_header Host              $host;
        proxy_set_header X-Real-IP         $remote_addr;
        proxy_set_header X-Forwarded-For   $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}

server {
    listen 80;
    server_name example.com;
    return 301 https://$host$request_uri;
}
  1. 语法检查:sudo nginx -t,必须看到 syntax is ok 与 test is successful 两行;只出现前者说明配置读到了但还有警告,需要一并看清楚。
  2. 重载:sudo systemctl reload nginx(或 sudo nginx -s reload)。失败时看 systemctl status nginx 与 /var/log/nginx/error.log。
  3. 验证:curl -sSI https://example.com/ | head -n 5 应返回 HTTP/2 200 或 HTTP/1.1 200;curl -sSI http://example.com/ 应返回 301 且 Location: https://example.com/。
  4. 验证链路:openssl s_client -connect example.com:443 -servername example.com /dev/null | grep "Verify return code",返回 0 (ok) 说明证书链在 OpenSSL 侧可通过;浏览器能打开不代表这一点,移动端和命令行客户端更容易暴露缺中间证书。

每一步都看到对应输出再往下走。如果第 5 步状态码对但后端行为异常,回到 X-Forwarded-Proto 和 proxy_pass 结尾斜杠这两处检查,通常就在这两行上。