为本地站点启用 HTTPS
🎯 引言
前面一直用 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; 下面。
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.test | curl 仍连接同一个端口,但证书上的名称对不上,验证失败 |
如果 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 入口访问学习笔记站的首页和接口了。
