Web 服务器与网关 / 系统课时

为整个站点启用 HTTPS

为整个站点启用 HTTPS

统一入口的页面、资源和 API 都应沿一致的域名与 TLS 策略访问。本篇在回环端口为 app.test 生成实验凭据,配置固定目标的 HTTP 跳转和完整 HTTPS 路由,再说明公开部署还需证书签发、DNS 与实际客户端信任验证。

学习目标

  • 为同一域名配置 TLS 并保留页面与 API 路由。
  • 验证 HTTP 跳转保留路径、参数且最终 TLS 验证通过。
  • 区分本机实验凭据与公开受信任证书。

准备域名对应的实验凭据

需要 Linux、OpenSSL 3、Nginx 1.28、curl、前两课的静态文件和两个运行中的后端,以及空闲回环 8080、8443。以下完整命令创建专用本机证书,不能用于公开信任部署:

bash
set -eu
umask 077
mkdir -p /tmp/nginx-entry-tls
openssl req -x509 -newkey rsa:2048 -nodes -days 2 \
  -subj '/CN=app.test' \
  -addext 'subjectAltName=DNS:app.test' \
  -addext 'basicConstraints=critical,CA:FALSE' \
  -addext 'extendedKeyUsage=serverAuth' \
  -keyout /tmp/nginx-entry-tls/key.pem \
  -out /tmp/nginx-entry-tls/cert.pem

预期结果:生成 SAN 包含 app.test 的证书及私钥,OpenSSL 可能输出随机密钥生成进度。命令不能随意重复覆盖正在使用的凭据;正式环境沿用证书更新与版本管理流程。

使用固定域名完成跳转

以下片段示例位于 http,替换本章前面的独立站点与同名 upstream;不能重复定义。实验 HTTPS 使用 8443,生产标准端口及证书路径应单独调整。

nginx
upstream entry_api {
    server 127.0.0.1:9001;
    server 127.0.0.1:9002;
}
server {
    listen 127.0.0.1:8080 default_server;
    server_name _;
    return 404;
}
server {
    listen 127.0.0.1:8080;
    server_name app.test;
    return 308 https://app.test:8443$request_uri;
}
server {
    listen 127.0.0.1:8443 ssl;
    server_name app.test;
    ssl_certificate /tmp/nginx-entry-tls/cert.pem;
    ssl_certificate_key /tmp/nginx-entry-tls/key.pem;
    ssl_protocols TLSv1.2 TLSv1.3;
    root /tmp/nginx-web-entry;
    types { text/html html; application/javascript js; }
    default_type application/octet-stream;
    location = /index.html { add_header Cache-Control "no-cache"; }
    location ^~ /assets/ {
        try_files $uri =404;
        add_header Cache-Control "public, max-age=31536000, immutable";
    }
    location = /api { return 308 /api/$is_args$args; }
    location ^~ /api/ { proxy_pass http://entry_api; }
    location / { try_files $uri $uri/ /index.html; }
}

HTTP 目标域名写死,避免未知 Host 被拼入跳转。页面、资源与 API 在 HTTPS server 中仍各走自己的规则,不因为开启 TLS 就改变路径约定。

HTTP 固定目标跳转后,HTTPS 内继续分流页面、资源和 API

验证真实的 TLS 名称和跳转

检查并重载后执行完整命令:

bash
curl --noproxy '*' --resolve app.test:8080:127.0.0.1 -sS -D - -o /dev/null 'http://app.test:8080/account?from=lab'
curl --noproxy '*' --cacert /tmp/nginx-entry-tls/cert.pem --resolve app.test:8080:127.0.0.1 --resolve app.test:8443:127.0.0.1 -L -sS -o /dev/null -w 'final=%{http_code}\n' 'http://app.test:8080/account?from=lab'

预期结果:第一条状态 308,Location 为 https://app.test:8443/account?from=lab;第二条 final=200,且证书验证没有被关闭。还要直接验证 HTTPS API、实际脚本、缺失脚本和未知 HTTP Host。

公开部署还需要哪些条件

公开域名应使用客户端信任的证书、正确完整链和受控私钥权限,确认所有入口地址均部署同一策略,并验证续期、HTTP 跳转及端到端请求。相关证书链机制见 官方 HTTPS 说明。

本机 --cacert 仅让这次 curl 信任实验凭据,不会自动给浏览器安装信任,也不是公共 CA 签发。代理后方还要正确传递原始协议,避免应用重新跳回 HTTP;HSTS 应在 HTTPS 长期可靠后按域名范围谨慎启用。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

为整个站点启用 HTTPS

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通