部署运维

个人站 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 端口的临时配置:

nginx
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 两个域名:

Bash
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:

nginx
# 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:

nginx
listen 443 ssl;
http2 on;

这个独立的 http2 指令是 nginx 1.25.1 才加入的。不少发行版软件源里的 nginx 还早于这个版本,配置检查会直接报错:

Text
nginx: [emerg] unknown directive "http2" in /etc/nginx/conf.d/site.conf:39

老版本要写在 listen 后面:

nginx
listen 443 ssl http2;

好在我的发布脚本会先 nginx -t 检查配置,检查不过就自动换回旧配置,线上没有受到影响。改 nginx 配置之前先 nginx -t,这是一个值得养成的习惯。

坑二:location 里的 add_header 会吞掉外层的头

给静态资源加缓存时,很自然会写成这样:

nginx
location /assets/ {
    add_header Cache-Control "public, max-age=2592000";
}

但 nginx 的规则是:只要某一层写了 add_header,就不再继承上一层的所有 add_header。结果 /assets/ 下面的文件就丢掉了 server 级的 HSTS 等安全头。

改用 expires 就没有这个问题,它会自动生成 Cache-Control 和 Expires 两个头,也不影响外层的 add_header:

nginx
location /assets/ {
    expires 30d;
    access_log off;
}

验证

最后用 curl 把几种访问方式都走一遍:

Bash
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 就算上线了。