HTTPS 与证书
本合集目录
本章目录
单册说明:本文件是卷 7 的第 6 章,可独立阅读。前置:第 5 章(域名与 DNS)、第 4 章(Nginx 反代)。本章申请一张 90 天有效期的免费证书,把 80 跳转到 443,并让自动续期真的能跑起来。
| 项 | 内容 |
|---|---|
| 所属卷 | 卷 7 · 上线与运维(第 6 / 8 章) |
| 前置章节 | 7.5 域名、备案与 DNS;7.4 Nginx 反向代理 |
| 本章产出 | 一个 https://你的域名 可访问的站点 + 一条 301 跳转 + 一次 renew --dry-run 通过 |
| 对应代码 | /etc/nginx/sites-available/dudao 的 443 段(见 7.6.3) |
| 配图 | 无(后续统一制图) |
| 读完的判定 | curl -I http://你的域名 返回 301 且 Location 是 https,curl -I https://你的域名 返回 200 |
7.6.1 一句话结论:证书只解决"是不是它",不解决"它好不好"
先看两个高频现场。
现场一:站点上线三个月,一切正常。某天早上用户发来截图,浏览器整页红色警告:
NET::ERR_CERT_DATE_INVALID
您的连接不是私密连接
攻击者可能会试图从 dudao.example.com 窃取您的信息(例如:密码、通讯内容或信用卡信息)。
证书过期了。你去服务器上看,certbot renew 的定时任务确实存在,但上一次执行是 89 天前——它一直在失败,没人知道。
现场二:你第一次申请证书,等了半分钟,得到:
Certbot failed to authenticate some domains (authenticator: nginx).
The Certificate Authority reported these problems:
Domain: dudao.example.com
Type: connection
Detail: 203.0.113.10: Fetching http://dudao.example.com/.well-known/acme-challenge/xxx:
Timeout during connect (likely firewall problem)
likely firewall problem 是签发方给的猜测,真正原因可能是安全组、可能是备案、也可能是你把 80 全站 301 到了 https——最后这种最常见,也最讽刺:为了安全做的跳转,把签发证书的路堵死了。
这一章要把这两件事都解决:一次签对,并且让它自己续下去。
7.6.2 原理与方法
① TLS 握手在解决两件事
https 比 http 多的那一步,目的只有两个:
| 要解决的问题 | 手段 | 没有它会怎样 |
|---|---|---|
| 机密性:中间人能不能看懂内容 | 握手时协商出一把只有双方知道的对称密钥 | 同一 WiFi 下的人能抓到你的密码和 Cookie |
| 身份:对面是不是真的它 | 服务器出示证书,浏览器验到受信根 | 攻击者可以伪装成你的站点,用户看不出来 |
两件事的分工要记清:加密不等于可信。 一个自签名证书也能加密,浏览器照样报警,因为它无法证明"持有者就是这个域名的主人"。证书的作用是让"身份"这件事有一个可验证的链条。
② 证书链:为什么必须发 fullchain
证书不是一张,是三张:
| 层级 | 谁签发 | 在浏览器里 | 文件 |
|---|---|---|---|
| 叶子证书(leaf) | 中间 CA | 你域名的那张 | cert.pem |
| 中间证书(intermediate) | 根 CA | 用来把叶子接回根 | chain.pem |
| 根证书(root) | 自己签自己 | 预装在系统/浏览器里 | 不需要你提供 |
服务器要发的是 叶子 + 中间,也就是 fullchain.pem。只发叶子会怎样:
- 桌面 Chrome/Firefox 通常还能自己补齐中间证书,看起来正常;
- 部分 Android 应用、
curl、Java 客户端会报:
curl: (60) SSL certificate problem: unable to get local issuer certificate
这个故障最坑的地方是"我这里好好的"——因为桌面浏览器太聪明,掩盖了服务端的配置缺陷。发 fullchain.pem 是唯一正确做法。
签发方在 /etc/letsencrypt/live/你的域名/ 下已经准备好了四个文件:
| 文件 | 内容 | 配到哪 |
|---|---|---|
fullchain.pem |
叶子 + 中间 | ssl_certificate |
privkey.pem |
私钥 | ssl_certificate_key |
cert.pem |
只有叶子 | 不要直接用 |
chain.pem |
只有中间 | 很少直接用 |
不要在 Nginx 里写 cert.pem。 这是新手配 HTTPS 最常见的错误,而且它有一半时间不报错。
③ Let's Encrypt 怎么确认域名是你的
它用 ACME 协议,核心是一个挑战:签发方要从公网验证你确实控制着这个域名。 三种方式:
| 方式 | 怎么验 | 优点 | 限制 |
|---|---|---|---|
| HTTP-01 | 你在 http://域名/.well-known/acme-challenge/<token> 放一段指定内容,它来取 |
配置简单 | 80 必须公网可达;不能签通配符 |
| DNS-01 | 你在 DNS 里加一条指定的 TXT 记录 | 不需要开 80;可签通配符 | 要能改 DNS,生效有延迟 |
| TLS-ALPN-01 | 在 443 上用特殊 ALPN 协议应答 | 只需 443 | 支持面窄,本书不用 |
本书用 HTTP-01,因为它和现有架构最贴。代价是80 端口必须保持可达——这一点在续期时会再次咬人。
证书有效期 90 天,官方建议在剩 30 天时续。这个设计的用意是推动自动化:手工续期一定会忘,忘了就是现场一。
④ 80 端口在证书体系里的双重身份
配好 HTTPS 之后,80 通常只干一件事:把所有请求 301 到 443。但签发和续期需要 80 上的一个特定路径保持明文可访问。
于是正确的 80 配置长这样:
location /.well-known/acme-challenge/ {
root /var/www/certbot;
}
location / {
return 301 https://$host$request_uri;
}
顺序很重要:/.well-known/ 的 location 必须存在,且不能被全站跳转吃掉。用 certbot --nginx 时它会自己处理这段;用 certonly --webroot 时要自己写。
一个真实翻车:有人在 80 的 server 块里写了 return 301 https://$host$request_uri; 放在最外层(server 级),所有 location 都被它短路。结果续期时签发方请求 http://.../.well-known/...,收到 301 跳到 https,跟过去发现证书正好过期——死循环。
⑤ 443 的配置
server {
listen 443 ssl;
listen [::]:443 ssl;
server_name dudao.example.com;
ssl_certificate /etc/letsencrypt/live/dudao.example.com/fullchain.pem;
ssl_certificate_key /etc/letsencrypt/live/dudao.example.com/privkey.pem;
ssl_protocols TLSv1.2 TLSv1.3;
ssl_session_cache shared:SSL:10m;
ssl_session_timeout 1d;
...
}
| 指令 | 作用 | 建议 |
|---|---|---|
ssl_certificate |
证书链 | 必须 fullchain.pem |
ssl_certificate_key |
私钥 | privkey.pem,权限 600 |
ssl_protocols |
允许的协议版本 | 只留 TLSv1.2 和 TLSv1.3 |
ssl_ciphers |
加密套件 | 交给 certbot 生成的配置,别手抄过时清单 |
ssl_session_cache |
会话复用,减少握手 | shared:SSL:10m 够用 |
ssl_ciphers 这条值得多说一句:网上大量"SSL 最优配置"文章里的套件列表已经过时,抄进去可能反而禁掉了现代客户端用的套件。certbot 生成的配置里已经包含合理的默认值,非必要不要手改。
HTTP/2 的写法在版本之间变过,需要按你的 Nginx 版本选:
| Nginx 版本 | 写法 |
|---|---|
| 1.24 及更早(Ubuntu 24.04 自带的版本) | listen 443 ssl http2; |
| 1.25.1 及更新 | http2 on; + listen 443 ssl; |
用 nginx -v 确认。写错会得到:
nginx: [emerg] unknown directive "http2" in /etc/nginx/sites-enabled/dudao:14
[emerg] 表示配置直接拒绝加载,reload 会失败但旧配置还在跑——这也是"必须 nginx -t 再 reload"的又一个理由。
⑥ 自动续期:要验的不是"配了",是"能成"
certbot 装好后自带一个 systemd timer,每天跑两次 certbot renew。但"timer 存在"和"续期能成功"是两件事。
必须做的一次验证:
sudo certbot renew --dry-run
--dry-run 用测试环境完整走一遍申请流程,不发真证书,也不消耗速率限制。它通过,才说明"80 可达 + webroot 正确 + 配置能被解析"这三件事同时成立。
Congratulations, all simulated renewals succeeded:
/etc/letsencrypt/live/dudao.example.com/fullchain.pem (success)
续期成功后,Nginx 还在用内存里的旧证书——必须 reload 才会加载新文件。用钩子自动做:
sudo tee /etc/letsencrypt/renewal-hooks/deploy/reload-nginx.sh >/dev/null <<'EOF'
#!/bin/sh
systemctl reload nginx
EOF
sudo chmod +x /etc/letsencrypt/renewal-hooks/deploy/reload-nginx.sh
deploy 目录下的脚本在每次成功签发/续期后执行,失败时不会跑。这比在 cron 里写 certbot renew && systemctl reload nginx 更可靠。
⑦ 混合内容:为什么页面"半坏"
HTTPS 页面里如果还引用了 http:// 的资源,浏览器会拦截。控制台的原话是:
Mixed Content: The page at 'https://dudao.example.com/' was loaded over HTTPS,
but requested an insecure element 'http://example.com/cover.jpg'.
This request has been blocked.
"半坏"的典型表现:HTML 出来了、文字能看,但样式全丢、图片是破图、按钮点了没反应。因为 CSS 和 JS 被拦了。
三类常见来源:
| 来源 | 现象 | 修法 |
|---|---|---|
源码里写死 http:// |
图片裂、字体不加载 | 改成 https:// 或站内相对路径 |
| 后端返回的资源地址是 http | 前端拿到就渲染,Console 报警 | 用 X-Forwarded-Proto 判断协议(7.4 传过这个头) |
| 第三方接口只支持 http | 整个组件不工作 | 换服务,或由后端代理转发 |
第三条是设计约束,不是配置能修的。前两条都是代码问题,改一次就好。
一个粗暴但有效的兜底:
add_header Content-Security-Policy "upgrade-insecure-requests" always;
它让浏览器把页面里的 http 资源自动升级成 https 再请求。这是缓解,不是修复:如果对方根本没有 https,升级后照样失败,只是报错从"被拦截"变成"连接失败"。
⑧ HSTS:开之前想清楚
Strict-Transport-Security 告诉浏览器:"以后访问我这个域名,一律直接用 https,不要再试 http。"
add_header Strict-Transport-Security "max-age=31536000" always;
好处是消除第一次访问的明文窗口,也能防 SSL 剥离攻击。代价是它是单向门:
| 参数 | 含义 | 风险 |
|---|---|---|
max-age=300 |
5 分钟内强制 https | 可以先试这个 |
max-age=31536000 |
一年 | 一年内无法回退到 http |
includeSubDomains |
所有子域一起 | 某个子域没证书,就直接打不开 |
preload |
申请加入浏览器内置列表 | 基本不可逆,移除要等几个月 |
本书的建议:先用 max-age=300 跑一周,确认全站没有残留的 http 依赖,再逐步加到一年。不要一上来就 includeSubDomains; preload——那等于把自己的退路焊死。
⑨ 证书过期是最常见的事故,所以要有监控
90 天有效期意味着一年要续四次。任何一次失败都不该等到用户发现。最低成本的监控是"到期前 14 天告警":
echo | openssl s_client -connect dudao.example.com:443 -servername dudao.example.com 2>/dev/null \
| openssl x509 -noout -enddate
notAfter=Feb 15 04:00:00 2027 GMT
把这个日期和今天比,少于 14 天就去看 certbot renew --dry-run 为什么失败。7.8 会把它做进健康检查。
7.6.3 动手:申请、验证、dry-run、看 301 与 200
第一步:确认 80 真的通
证书申请失败的第一大原因是 80 不通,所以先验:
curl -I http://dudao.example.com/
要在你自己的电脑上跑,不是在服务器上。服务器上 curl 127.0.0.1 永远通,证明不了公网可达。
预期看到 HTTP/1.1 200 OK(或 301)。如果是超时,先回 7.5 查 DNS 与备案,别往下走。
第二步:装 certbot
Ubuntu 用 snap 装(官方推荐,版本新、自动更新):
sudo apt remove -y certbot # 如果之前用 apt 装过,先卸掉,避免两套并存
sudo apt install -y snapd
sudo snap install core
sudo snap refresh core
sudo snap install --classic certbot
sudo ln -sf /snap/bin/certbot /usr/bin/certbot
certbot --version
--classic 是必须的:certbot 需要访问系统路径,不能跑在严格沙箱里。
第三步:先给 80 加一个挑战路径
certbot 要把挑战文件写到 /var/www/certbot,而签发方是从 http://你的域名/.well-known/acme-challenge/<token> 来取的。所以这个路径必须先能通过 Nginx 访问到。
在最前面加一段(其余内容保持 7.4 的样子不动):
server {
listen 80;
listen [::]:80;
server_name dudao.example.com www.dudao.example.com;
location /.well-known/acme-challenge/ {
root /var/www/certbot;
}
location / {
return 301 https://$host$request_uri;
}
}
sudo mkdir -p /var/www/certbot
sudo chown -R www-data:www-data /var/www/certbot
sudo nginx -t && sudo systemctl reload nginx
顺序不能反:先有 location,再发证。反过来做,签发方拿不到挑战文件,你会看到 Invalid response ... 404,然后误以为是 DNS 问题。
第四步:只发证,不改配置
sudo certbot certonly --webroot -w /var/www/certbot \
-d dudao.example.com -d www.dudao.example.com \
--email [email protected] --agree-tos --no-eff-email
参数含义:
| 参数 | 作用 |
|---|---|
certonly |
只申请证书,不动 Nginx 配置 |
--webroot -w |
用 HTTP-01,把挑战文件写到这个目录 |
-d |
域名,可以写多个,都会进同一张证书 |
--agree-tos |
同意服务条款(非交互必需) |
--no-eff-email |
不订阅邮件列表 |
成功时输出形如:
Successfully received certificate.
Certificate is saved at: /etc/letsencrypt/live/dudao.example.com/fullchain.pem
Key is saved at: /etc/letsencrypt/live/dudao.example.com/privkey.pem
This certificate expires on 2027-02-15.
在这一步之前先自测一次挑战路径是通的:
curl -I http://dudao.example.com/.well-known/acme-challenge/test
预期是 404——文件不存在,但请求确实到了 Nginx。如果返回 301,说明跳转规则盖住了它,回去检查 location 的顺序。
第五步:改 Nginx,加 443 与跳转
sudo tee /etc/nginx/sites-available/dudao >/dev/null <<'EOF'
server {
listen 80;
listen [::]:80;
server_name dudao.example.com www.dudao.example.com;
location /.well-known/acme-challenge/ {
root /var/www/certbot;
}
location / {
return 301 https://$host$request_uri;
}
}
server {
listen 443 ssl;
listen [::]:443 ssl;
server_name dudao.example.com www.dudao.example.com;
ssl_certificate /etc/letsencrypt/live/dudao.example.com/fullchain.pem;
ssl_certificate_key /etc/letsencrypt/live/dudao.example.com/privkey.pem;
ssl_protocols TLSv1.2 TLSv1.3;
ssl_session_cache shared:SSL:10m;
ssl_session_timeout 1d;
root /srv/dudao/web;
index index.html;
access_log /var/log/nginx/dudao.access.log;
error_log /var/log/nginx/dudao.error.log;
client_max_body_size 10m;
# 先用 5 分钟试水,确认全站没有 http 依赖后再加到一年
add_header Strict-Transport-Security "max-age=300" always;
location /api/ {
proxy_pass http://127.0.0.1:8000;
proxy_http_version 1.1;
proxy_set_header Connection "";
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
proxy_connect_timeout 5s;
proxy_send_timeout 30s;
proxy_read_timeout 30s;
}
location / {
try_files $uri $uri.html $uri/ =404;
}
}
EOF
sudo nginx -t
sudo systemctl reload nginx
如果 nginx -t 报:
nginx: [emerg] cannot load certificate "/etc/letsencrypt/live/dudao.example.com/fullchain.pem"
说明证书还没签发成功,或者域名写错了(live/ 下的目录名必须和 -d 的第一个域名完全一致)。不要用 mkdir 手工造这个目录——/etc/letsencrypt/live/ 里全是符号链接,指向 ../../archive/,手工建的一定是死链。
上面的 listen 443 ssl; 没有开 HTTP/2。要开的话按版本改:1.24 及更早写成 listen 443 ssl http2;,1.25.1 及更新则在 server 块里加一行 http2 on;。不确定就先不开,它不影响证书。
第六步:验证 301 与 200
curl -I http://dudao.example.com/
HTTP/1.1 301 Moved Permanently
Server: nginx/1.24.0 (Ubuntu)
Location: https://dudao.example.com/
curl -I https://dudao.example.com/
HTTP/1.1 200 OK
Server: nginx/1.24.0 (Ubuntu)
Content-Type: text/html
Strict-Transport-Security: max-age=300
两件事同时成立才算成:http 会跳,https 能开。
第七步:检查证书链和有效期
echo | openssl s_client -connect dudao.example.com:443 -servername dudao.example.com 2>/dev/null \
| openssl x509 -noout -subject -issuer -dates
预期:
subject=CN = dudao.example.com
issuer=C = US, O = Let's Encrypt, CN = R11
notBefore=Nov 17 04:20:00 2026 GMT
notAfter=Feb 15 04:20:00 2027 GMT
issuer 里带 CN = R11(或 R10、E5 之类)说明拿到的是完整链条的一环。如果 issuer 和 subject 一样(自签名),说明你配错了文件。
再看链条完整性:
echo | openssl s_client -connect dudao.example.com:443 -servername dudao.example.com 2>/dev/null | grep -E 'Verify return code|depth'
Verify return code: 0 (ok) 是唯一可接受的结果。
第八步:跑一次 dry-run
sudo certbot renew --dry-run
预期结尾:
Congratulations, all simulated renewals succeeded:
/etc/letsencrypt/live/dudao.example.com/fullchain.pem (success)
这一步必须通过。 它不通过,90 天后一定过期。
第九步:确认 timer 与钩子
systemctl list-timers | grep certbot
systemctl status certbot.timer --no-pager | head -n 6
预期能看到 certbot.timer 且 NEXT 列有未来时间。再确认钩子可执行:
ls -l /etc/letsencrypt/renewal-hooks/deploy/
第十步:看浏览器
打开 https://dudao.example.com/,地址栏应该是锁形图标。点开证书,能看到有效期和签发者。
再看 Console 有没有 Mixed Content 报警。有的话按 7.6.2 第 ⑦ 节处理——这一步不能跳过,混合内容会让页面在用户那边"半坏",而你自己的浏览器可能因为缓存看着正常。
7.6.4 三个坑
坑 1:HTTP-01 失败,Timeout during connect
症状:
Type: connection
Detail: 203.0.113.10: Fetching http://dudao.example.com/.well-known/acme-challenge/xxx:
Timeout during connect (likely firewall problem)
成因:四种,按概率排。
| 成因 | 判断 |
|---|---|
| 80 端口没放行(安全组 / ufw) | 外网 curl -I http://域名 超时 |
| 大陆服务器未备案 | 80 被链路阻断,服务器日志空白 |
| 全站 301 到 https | 挑战请求被跳走,跟过去证书还不存在 |
/.well-known/ 被别的 server 块抢走 |
nginx -T 里搜这个路径,看命中哪个 |
修法:先用外网 curl 证明 80 通,再看 Nginx 里有没有把 /.well-known/ 短路。
curl -I http://dudao.example.com/.well-known/acme-challenge/test
这条应该返回 404(文件不存在是正常的),不能是 301。如果返回 301,说明跳转规则盖住了挑战路径,把 /.well-known/ 的 location 放到前面,或者把 return 301 收进 location / 里而不是放在 server 级。
坑 2:只配了 cert.pem,部分客户端不信任
症状:Chrome 正常,手机 App 或 curl 报:
curl: (60) SSL certificate problem: unable to get local issuer certificate
成因:ssl_certificate 指向了 cert.pem(只有叶子证书),中间证书没发。桌面浏览器有补链机制,掩盖了问题;不支持的客户端就直说"找不到签发者"。
修法:
ssl_certificate /etc/letsencrypt/live/dudao.example.com/fullchain.pem;
改完 nginx -t → reload,再用 openssl s_client 的 Verify return code: 0 (ok) 确认。
顺带说一句:不要手工把证书文件复制到别处。 /etc/letsencrypt/live/ 下是符号链接,续期时 archive/ 里的新文件会被创建,live/ 自动指向最新的。复制走的那份永远不会更新,90 天后就过期了,而且你会以为是"续期没生效"。
坑 3:续期静默失败,90 天后突然过期
症状:certbot.timer 一直在跑,journalctl -u certbot 里每次都是 failed,但没人看。到期当天全站报警。
NET::ERR_CERT_DATE_INVALID
成因:续期比首次签发更脆弱,因为它依赖的条件在这三个月里可能已经变了:
| 变化 | 后果 |
|---|---|
| 安全组被收紧,80 关了 | HTTP-01 无法完成 |
| 80 的 server 块被改成全站 301 | 挑战路径被跳走 |
webroot 目录权限变了 |
挑战文件写不进去 |
| 服务器换了 IP,DNS 没更新 | 签发方访问到旧机器 |
| 备案掉了 | 80 被阻断 |
修法:把"验证"变成常规动作,而不是一次性动作。
# 每周跑一次,或放进 7.8 的健康检查
sudo certbot renew --dry-run
再看真实续期日志:
sudo journalctl -u certbot --since "7 days ago" --no-pager | grep -E 'error|failed|Congratulations'
--dry-run 的价值在于它每次都用测试环境完整走一遍,能提前发现上面这五种变化。它不消耗速率限制,可以放心天天跑。
| 坑 | 关键报错 | 一句话修法 |
|---|---|---|
| HTTP-01 失败 | Timeout during connect |
外网验 80 通,再确认 /.well-known/ 没被 301 吃掉 |
| 部分客户端不信任 | unable to get local issuer certificate |
ssl_certificate 改 fullchain.pem |
| 续期静默失败 | 90 天后 ERR_CERT_DATE_INVALID |
每周 renew --dry-run,并监控到期日 |
本章验收
-
curl -I http://你的域名返回 301,Location指向 https -
curl -I https://你的域名返回 200,内容是自己的首页 -
openssl s_client的Verify return code是0 (ok) -
ssl_certificate指向的是fullchain.pem,不是cert.pem -
certbot renew --dry-run输出all simulated renewals succeeded -
systemctl list-timers | grep certbot能看到下一次执行时间,deploy 钩子存在且可执行
自测
Q1:为什么 80 端口在上了 HTTPS 之后还不能关?
看答案
两个原因。一是 HTTP-01 验证要靠 80 明文取挑战文件,关了就无法签发和续期;二是用户手输域名或点旧链接时,80 上的 301 能把他带到 https,关了会得到连接失败而不是跳转。如果确实要关 80,就必须改用 DNS-01 验证,否则 90 天后证书无法续期。Q2:ssl_certificate 写成 cert.pem 和 fullchain.pem,区别在哪?为什么前者有时看不出问题?
看答案
fullchain 包含叶子证书和中间证书,cert 只有叶子。桌面浏览器内置了大量中间证书,能自己补齐链条,所以看起来正常;而 curl、部分 Android 应用、Java 客户端不会补,直接报 unable to get local issuer certificate。这类"我这儿好着呢"的故障,根源往往是服务端少发了一个文件。Q3:HSTS 的 preload 为什么被认为是不可逆的?
看答案
preload 是把域名写进浏览器内置的强制 HTTPS 列表,随浏览器版本分发。要移除,得向列表提交移除申请,再等各大浏览器的新版本发布并被用户更新,周期以月计。在此期间,你的域名在所有装了新浏览器的设备上都不能用 http 访问,包括某些内网调试场景。所以它适合确定长期只走 HTTPS 的站点,不适合还在试验的阶段。下一步
证书有了,站点已经在公网上跑起来了。但你对它一无所知:谁在访问、慢在哪、有没有人在扫你的后台。下一章把日志变成可读的信息。