为本地站点启用 HTTPS

给学习笔记站添加 HTTPS,用 curl 验证证书信任和域名匹配。

🎯 引言

前面一直用 HTTP 打开学习笔记站。将来如果要通过网络提交登录信息,HTTP 本身不会加密这些数据。HTTPS 用 TLS(传输层安全协议)加密客户端与服务器之间的通信,还让客户端检查自己连到的是不是网址里写的站点。

这次保留 8080 上的 HTTP 入口,再给同一个站点加上 https://notes.test:8443/。用 curl 验证成功后,你还会看到证书不受信任和域名不匹配分别是什么样子。


🧱 证书和私钥各负责什么

  • 证书(.crt) 可以公开,里面有站点名、公钥和有效期。客户端会检查证书是否可信、是否在有效期内,以及证书覆盖的名称是否与网址一致。
  • 私钥(.key) 由服务器保管。Nginx 在建立 TLS 连接时用它证明自己持有与证书公钥配对的私钥。

公开网站的证书一般由客户端信任的证书颁发机构(CA)签发。本次用 OpenSSL 自己签发一份证书,所以它叫自签证书。curl 默认不会信任它,稍后只为本次请求指定这份证书。 Nginx HTTPS 配置说明


🛠 第一步:生成 notes.test 的证书

继续使用前面搭建学习笔记站的 Ubuntu Bash 终端。执行 cd "$HOME/nginx-course",再用 curl -i http://127.0.0.1:8080/ 确认站点能返回首页。

在当前目录生成实验所需的证书和私钥。

mkdir -p certs
chmod 700 certs
openssl req -x509 -newkey rsa:2048 -nodes -days 7 \
    -keyout certs/notes.key \
    -out certs/notes.crt \
    -subj '/CN=notes.test' \
    -addext 'subjectAltName=DNS:notes.test'
chmod 600 certs/notes.key

-x509 让 OpenSSL 直接生成自签证书,-days 7 设置七天的有效期。最后一行 OpenSSL 参数把 notes.test 写进证书的主题备用名称(SAN),供客户端核对网址中的域名。这个名称只覆盖 notes.test。 OpenSSL req 文档

-nodes 生成不带密码的私钥,Nginx 无需输入密码即可读取。这里用目录和文件权限保护它。把私钥留在 certs/,不要放进公开的 html/ 或提交到仓库。OpenSSL 生成密钥时的进度输出随版本而异。

🛠 第二步:在原站点增加 HTTPS 监听

打开 conf/servers/site.conf,在已有的 server { ... } 中,把这四行加在原有的 listen 127.0.0.1:8080 default_server; 下面。

conf/servers/site.conf
listen 127.0.0.1:8443 ssl;
ssl_certificate ../certs/notes.crt;
ssl_certificate_key ../certs/notes.key;
ssl_protocols TLSv1.2 TLSv1.3;

两个端口共用同一个 server 里的页面和代理规则。ssl 让 8443 使用 TLS,ssl_protocols 指定允许的 TLS 版本。这里的证书路径从主配置文件所在的 conf/ 算起,../certs/ 正好指向课程目录里的 certs/。

在已定义 ngx 函数的终端中检查并重载。

ngx -t && ngx -s reload

如果检查报错,先确认提示中的证书或私钥路径指向刚生成的文件。 Nginx HTTPS 配置说明


✅ 第三步:用 curl 验证加密连接和站点名称

在课程目录发起请求。

curl --resolve notes.test:8443:127.0.0.1 \
    --cacert certs/notes.crt \
    -i https://notes.test:8443/

--resolve 告诉这一次 curl 去 127.0.0.1:8443 连接 notes.test,相当于为这次请求指定了域名对应的地址。网址里的名字仍然是 notes.test。--cacert 告诉 curl 用刚生成的证书验证连接。看到 200 和“我的学习笔记”,就说明证书验证通过,Nginx 也返回了首页。 curl 参数说明

在成功命令的基础上,每次只改一个条件,观察区别。

怎么改预期结果
去掉 --cacert certs/notes.crt默认信任列表里没有这份自签证书,curl 报证书不受信任
保留 --cacert,把 --resolve 和网址里的 notes.test 都改成 wrong.testcurl 仍连接同一个端口,但证书上的名称对不上,验证失败

如果 curl 提示连接失败,先查 8443 的监听配置是否重载成功。做验收时保留证书验证,-k 会跳过这两项检查。 curl 证书验证说明


🌐 换成公网 HTTPS 要准备什么

公开访问时,需要一个你能管理的域名,用 DNS 记录把它指向服务器,并让访问者能连到 HTTPS 通常使用的 443 端口。向客户端信任的证书颁发机构申请覆盖该域名的证书,按签发方的说明部署证书链和私钥。证书续期后,检查配置并重载,让运行中的 Nginx 读取新文件。

如果还需要把 HTTP 跳转到 HTTPS,先验收 HTTPS 入口,再在只监听 80 的独立 server 中设置跳转。给同时处理两种协议的 server 加无条件跳转,会让 HTTPS 请求也收到跳转。 Nginx HTTPS 配置说明 · Nginx 重载机制


❓ 知识问答

为什么用 --resolve 连接本机,网址还要写 notes.test?

127.0.0.1 决定请求送到哪台机器,notes.test 是 curl 要用证书核对的站点名。这个实验的证书只覆盖后者。


🧪 小练习

沿用第三步的参数,把 URL 的路径换成 /api/notes。确认状态码为 200,正文是包含 "instance":"a" 或 "instance":"b" 的 JSON。若请求分到了实例 a,还能看到 X-Seen-Proto: https,这是模拟后台回显的入口协议。实例 b 只返回实例标记。


🎉 现在可以用同一个 HTTPS 入口访问学习笔记站的首页和接口了。