个人站 HTTPS 上线小记:nginx + Let's Encrypt
给个人站配 HTTPS 的完整过程:先用临时配置签证书,再换正式配置;拒绝用 IP 直接访问;顺便记下老版本 nginx 不认识 http2 on、location 里 add_header 会吞掉安全头这两个坑。
备案通过后,给个人站配上 HTTPS:Web 服务器用系统软件源里的 nginx,证书用 Let's Encrypt 的免费证书,签发和续期交给 certbot。文中的目录、配置文件名都用示例值代替。
第一步:先让 80 端口能通过验证
certbot 的 webroot 方式会在网站目录下放一个临时文件,再由 Let's Encrypt 通过 http://域名/.well-known/acme-challenge/ 来访问它,以此证明你控制着这个域名。所以签证书之前,要先有一个只开 80 端口的临时配置:
server {
listen 80;
server_name zita.net.cn www.zita.net.cn;
root /var/www/site;
location ^~ /.well-known/acme-challenge/ {
default_type text/plain;
}
}然后一条命令签发,同时覆盖带 www 和不带 www 两个域名:
certbot certonly --webroot -w /var/www/site \
-d zita.net.cn -d www.zita.net.cn \
--key-type ecdsa --deploy-hook "systemctl reload nginx"--deploy-hook 很重要:证书自动续期成功后 reload 一下 nginx,新证书才会生效。用系统包管理器装的 certbot 一般自带 certbot.timer,每天检查两次,到期前 30 天自动续期。可以用 certbot renew --dry-run 演练一遍——它连的是 Let's Encrypt 的测试环境,会比较慢,耐心等一会儿。
第二步:换成正式配置
签好证书后换成正式配置,思路是:
- 80 端口只保留证书验证路径,其余请求一律 301 跳到
https://zita.net.cn; www.zita.net.cn也跳到不带www的地址,全站只有一个规范地址;- 加上 HSTS 等几个安全响应头。
拒绝用 IP 直接访问
服务器的 80、443 对全网开放后,扫描器会直接用 IP 来访问。我不希望用 IP 或者其他没登记的域名能打开这个站,就加了两个兜底的 default_server:
# 80:直接断开连接,不返回任何内容
server {
listen 80 default_server;
server_name _;
return 444;
}
# 443:在 TLS 握手阶段就拒绝,连证书都不给对方看
server {
listen 443 ssl http2 default_server;
server_name _;
ssl_reject_handshake on;
}444 是 nginx 特有的状态码,意思是不发响应、直接关闭连接。ssl_reject_handshake 从 nginx 1.19.4 开始支持,不用为兜底服务器准备一张证书。
坑一:老版本 nginx 不认识 http2 on;
网上很多新教程这样开启 HTTP/2:
listen 443 ssl;
http2 on;这个独立的 http2 指令是 nginx 1.25.1 才加入的。不少发行版软件源里的 nginx 还早于这个版本,配置检查会直接报错:
nginx: [emerg] unknown directive "http2" in /etc/nginx/conf.d/site.conf:39老版本要写在 listen 后面:
listen 443 ssl http2;好在我的发布脚本会先 nginx -t 检查配置,检查不过就自动换回旧配置,线上没有受到影响。改 nginx 配置之前先 nginx -t,这是一个值得养成的习惯。
坑二:location 里的 add_header 会吞掉外层的头
给静态资源加缓存时,很自然会写成这样:
location /assets/ {
add_header Cache-Control "public, max-age=2592000";
}但 nginx 的规则是:只要某一层写了 add_header,就不再继承上一层的所有 add_header。结果 /assets/ 下面的文件就丢掉了 server 级的 HSTS 等安全头。
改用 expires 就没有这个问题,它会自动生成 Cache-Control 和 Expires 两个头,也不影响外层的 add_header:
location /assets/ {
expires 30d;
access_log off;
}验证
最后用 curl 把几种访问方式都走一遍:
curl -sI https://zita.net.cn/ # 200
curl -sI http://zita.net.cn/ # 301 → https://zita.net.cn/
curl -sI https://www.zita.net.cn/ # 301 → https://zita.net.cn/
curl -sI http://<服务器IP>/ # 连接被断开
curl -sI -H 'Accept-Encoding: gzip' https://zita.net.cn/assets/style.css # gzip + 30 天缓存全部符合预期,HTTPS 就算上线了。