HTTPS 配置完整指南:域名备案、SSL 证书申请、Nginx/Apache 部署与排错
一、问题背景与根因:HTTPS 配置为什么总在三处翻车
生产环境里“HTTPS 打不开”常被笼统归因为“证书有问题”,但真实根因通常落在三层:证书本身、服务端配置、域名合规与解析。
第一类,证书链不完整。服务商只给一张 example.com.crt(叶子证书),运维直接把 ssl_certificate 指过去。桌面 Chrome 能通过 AIA 补齐中间证书所以显示正常,而 Android 旧版本、Java 客户端、微信小程序、curl 会直接失败:
curl: (60) SSL certificate problem: unable to get local issuer certificate
第二类,域名覆盖不全。证书 SAN 里只有 example.com,用户访问 www.example.com 就报 NET::ERR_CERT_COMMON_NAME_INVALID;或者买了 *.example.com 泛域名证书,却以为它能覆盖 a.b.example.com(实际只匹配一级)。
第三类,有效期。按 CA/Browser Forum 规定,公网信任的 SSL 证书最长有效期已被限制为 398 天(2020 年 9 月 1 日起生效),Let’s Encrypt 免费证书固定 90 天。任何“装完就不管”的做法,最终都会在某个周一早上变成 NET::ERR_CERT_DATE_INVALID。
第四类,备案与解析。中国大陆节点的 80/443 对未备案域名会被运营商阻断,表现不是证书错误,而是 curl: (7) Failed to connect ... Connection timed out。这类问题换十张证书也没用。
三条快速定位命令,建议先跑再动手:
curl -vI https://example.com 2>&1 | head -40
openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null 2>&1 | head -60
dig +short example.com A; dig +short example.com AAAA
第一条看 TLS 握手与 HTTP 状态,第二条看服务端实际下发的证书链,第三条确认解析是否指向正确 IP——尤其 AAAA 记录指向未配置 IPv6 的机器,是最容易被忽略的坑。
二、前置条件:ICP 备案、DNS 解析与端口放行
动手前先把五件事落实,能省掉一半返工。
(1) 备案。服务器在中国大陆(含阿里云、腾讯云、华为云大陆地域)时,域名必须先完成 ICP 备案且接入商与云厂商一致,否则 80/443 被阻断。备案与证书签发是两件独立的事:DV 证书只验证域名控制权,走 DNS-01 甚至不需要网站可访问;但“证书签发成功”不等于“网站能打开”。香港及海外节点无需备案。
(2) 解析。确认 A 记录指向源站或 CDN:
dig +short example.com A
dig +short www.example.com A
dig +short example.com AAAA
若 AAAA 有值但服务器没有 IPv6 出口,客户端会优先走 IPv6 并超时。排查阶段先删掉 AAAA 记录。
(3) 端口与防火墙。三层都要放行:云安全组、主机防火墙、应用监听地址。
ss -lntp | grep -E ':80|:443'
# firewalld
firewall-cmd --permanent --add-service=http --add-service=https
firewall-cmd --reload
# ufw
ufw allow 80/tcp && ufw allow 443/tcp
# 本机自测,绕开 DNS 与 CDN
curl -kI --resolve example.com:443:127.0.0.1 https://example.com
--resolve 可以在证书尚未配好时直接验证源站,避免 DNS 生效延迟干扰判断。
(4) 时间同步。TLS 握手依赖系统时间,时钟偏差过大会直接握手失败。用 timedatectl status 确认 System clock synchronized: yes,必要时执行 chronyc makestep 强制校准。
(5) 配置备份。cp -a /etc/nginx /etc/nginx.bak.$(date +%F),改坏了能秒回滚。
三、生成私钥与 CSR:OpenSSL 命令与参数详解
CSR(Certificate Signing Request)包含公钥与主体信息,私钥必须本地生成且绝不外传。RSA 2048 兼容性最好:
mkdir -p /etc/nginx/ssl && cd /etc/nginx/ssl
openssl req -new -newkey rsa:2048 -sha256 -nodes
-keyout example.com.key
-out example.com.csr
-subj "/C=CN/ST=Beijing/L=Beijing/O=Example Technology Co.,Ltd/CN=example.com"
-addext "subjectAltName=DNS:example.com,DNS:www.example.com,DNS:*.example.com"
参数说明:-nodes 表示私钥不加密(服务进程启动时无法交互输入密码);-sha256 指定摘要算法,SHA-1 已被所有 CA 拒绝;-addext 在 OpenSSL 1.1.1+ 可用,直接写入 SAN,比手写 openssl.cnf 省事。OpenSSL 1.0.2 需用 -config 配合 [v3_req] 段。
ECDSA P-256 性能更好,是 TLS 1.3 的首选:
openssl ecparam -genkey -name prime256v1 -out example.com.ec.key
openssl req -new -key example.com.ec.key -sha256 -out example.com.ec.csr
-subj "/CN=example.com"
-addext "subjectAltName=DNS:example.com,DNS:www.example.com"
生成后必须自检三件事:
# 1. CSR 中的 SAN 是否正确
openssl req -in example.com.csr -noout -text | grep -A1 "Subject Alternative Name"
# 2. 私钥是否完好
openssl rsa -in example.com.key -check -noout
# 3. 私钥与 CSR 是否配对(两行 MD5 必须一致)
openssl rsa -in example.com.key -noout -modulus | openssl md5
openssl req -in example.com.csr -noout -modulus | openssl md5
chmod 600 example.com.key && chown root:root example.com.key
常见坑:只写 CN 忘了 SAN——现代浏览器完全忽略 CN,只看 SAN;泛域名 *.example.com 必须显式写进 SAN,且不覆盖裸域和多级子域。
四、申请与签发:ACME 自动化与商业证书
DV 证书强烈推荐 ACME 全自动。Let’s Encrypt 有效期 90 天,官方建议每 60 天续期一次。acme.sh 支持泛域名,走 DNS-01:
curl https://get.acme.sh | sh -s email=ops@example.com
export Ali_Key="LTAI***"; export Ali_Secret="***"
~/.acme.sh/acme.sh --issue -d example.com -d '*.example.com' --dns dns_ali --keylength ec-256
~/.acme.sh/acme.sh --install-cert -d example.com --ecc
--key-file /etc/nginx/ssl/example.com.key
--fullchain-file /etc/nginx/ssl/example.com.fullchain.pem
--reloadcmd "nginx -t && nginx -s reload"
certbot 适合单域名/多域名,走 HTTP-01:
certbot certonly --webroot -w /var/www/html
-d example.com -d www.example.com --email ops@example.com --agree-tos -n
certbot renew --dry-run
HTTP-01 要求 http://example.com/.well-known/acme-challenge/<token> 返回纯文本 token,Nginx 需放行:
location ^~ /.well-known/acme-challenge/ { root /var/www/html; default_type text/plain; }
若站点已全站 301 到 HTTPS,务必把该 location 放在 80 端口 server 块中且不被跳转规则拦截,否则报 Type: unauthorized Detail: Invalid response from http://...: 404。泛域名只能走 DNS-01,CA 无法为 *.example.com 提供 HTTP 校验。商业 OV/EV 证书走人工审核,需提交营业执照与组织信息,签发后同样受 398 天上限约束,且已不再提供“绿色地址栏”视觉差异。
五、配置示例:Nginx 与 Apache(含 301 跳转与 HSTS)
Nginx 完整配置,80 只做跳转与 ACME 校验,443 承载业务:
server {
listen 80;
listen [::]:80;
server_name example.com www.example.com;
location ^~ /.well-known/acme-challenge/ { root /var/www/html; default_type text/plain; }
location / { return 301 https://$host$request_uri; }
}
server {
listen 443 ssl;
listen [::]:443 ssl;
http2 on; # nginx >= 1.25.1;旧版本写 listen 443 ssl http2;
server_name example.com www.example.com;
ssl_certificate /etc/nginx/ssl/example.com.fullchain.pem;
ssl_certificate_key /etc/nginx/ssl/example.com.key;
ssl_protocols TLSv1.2 TLSv1.3;
ssl_ciphers ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-ECDSA-CHACHA20-POLY1305:ECDHE-RSA-CHACHA20-POLY1305;
ssl_prefer_server_ciphers off;
ssl_session_cache shared:SSL:10m;
ssl_session_timeout 1d;
ssl_session_tickets off;
ssl_stapling on;
ssl_stapling_verify on;
ssl_trusted_certificate /etc/nginx/ssl/example.com.chain.pem;
add_header Strict-Transport-Security "max-age=31536000; includeSubDomains" always;
add_header X-Content-Type-Options nosniff always;
}
要点:ssl_certificate 必须指向 fullchain(叶子+中间证书),ssl_certificate_key 指私钥;HSTS 先不要加 preload,确认全站 HTTPS 且所有子域可用后再提交预加载列表,否则回滚成本极高。
Apache 对应配置:
<VirtualHost *:80>
ServerName example.com
Redirect permanent / https://example.com/
</VirtualHost>
<VirtualHost *:443>
SSLEngine on
SSLCertificateFile /etc/httpd/ssl/example.com.crt
SSLCertificateKeyFile /etc/httpd/ssl/example.com.key
SSLCertificateChainFile /etc/httpd/ssl/example.com.chain.pem
SSLProtocol -all +TLSv1.2 +TLSv1.3
Header always set Strict-Transport-Security "max-age=31536000"
</VirtualHost>
Apache 2.4.8 之后也可以让 SSLCertificateFile 直接指向 fullchain 而省略 SSLCertificateChainFile。改完先 nginx -t 或 apachectl configtest 再 reload,不要直接 restart 生产。
六、方案对比:证书类型与校验方式怎么选
先按用途选证书类型:
| 类型 | 校验方式 | 有效期上限 | 泛域名 | 浏览器信任 | 适用场景 |
|---|---|---|---|---|---|
| Let’s Encrypt DV | 域名控制权 | 90 天 | 支持(DNS-01) | 是 | 个人站、API、内部服务 |
| 商业 DV | 域名控制权 | 398 天 | 支持 | 是 | 不便做自动化的业务 |
| OV | 企业资质人工审核 | 398 天 | 支持 | 是 | 金融、政企对外站点 |
| EV | 严格人工审核 | 398 天 | 支持 | 是(无绿色地址栏) | 品牌背书需求 |
| 自签名 | 无 | 自定义 | 支持 | 否 | 内网、测试环境 |
再按网络环境选校验方式:
| 校验方式 | 端口要求 | 泛域名 | 常用工具 | 典型失败原因 |
|---|---|---|---|---|
| HTTP-01 | 80 可公网访问 | 不支持 | certbot / acme.sh | 301 拦截、WAF 拦截、404 |
| DNS-01 | 无 | 支持 | acme.sh + DNS API | TXT 未生效、API 权限不足 |
| TLS-ALPN-01 | 443 | 不支持 | 部分 ACME 客户端 | 端口被其他进程占用 |
内网服务无法暴露 80/443 时选 DNS-01;站点挂在 CDN 后面时,要么保证回源能读到 challenge 文件,要么直接用 DNS-01 绕开。有效期方面,CA/Browser Forum 已通过 SC-081 决议,计划分阶段把最长有效期从 398 天压到 200 天、100 天直至 47 天,长期看自动化续期不是可选项而是必需项。
七、常见报错排查:从 curl 60 到 Cloudflare 526
1. curl: (60) SSL certificate problem: unable to get local issuer certificate:缺中间证书。用 openssl s_client -showcerts 数一下证书张数,只有一张就是这个问题,改用 fullchain 即可。
2. NET::ERR_CERT_COMMON_NAME_INVALID:SAN 不含当前访问的域名,常见于只签裸域却用 www 访问。
3. NET::ERR_CERT_DATE_INVALID:证书过期,或客户端/服务端系统时间错误。
4. ERR_TOO_MANY_REDIRECTS:301 循环。多见于 CDN 开启了“HTTP→HTTPS 跳转”又回源到同样做跳转的源站,或应用层拿不到 X-Forwarded-Proto 再跳一次。排查:curl -I http://example.com 逐跳看 Location。
5. ERR_SSL_PROTOCOL_ERROR / SSL_ERROR_RX_RECORD_TOO_LONG:用 https 访问了 http 端口,或 Nginx 未监听 443、证书路径读错导致握手中断。
6. nginx: [emerg] cannot load certificate ... PEM_read_bio_X509_AUX() failed:证书文件为空、把 DER 当 PEM,或 fullchain 拼接顺序错。检查 head -1 cert.pem 应为 -----BEGIN CERTIFICATE-----。
7. Cloudflare 526 Invalid SSL certificate:回源证书不受信任(自签或过期)。把 SSL/TLS 模式改为 Full (strict) 并在源站部署有效证书;临时可用 Full 应急,但不建议长期。
8. 混合内容:控制台报 Mixed Content: The page at 'https://...' was loaded over HTTPS, but requested an insecure resource。把资源改为相对协议或 HTTPS,并加 Content-Security-Policy: upgrade-insecure-requests。
排查命令合集:
openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null 2>&1 | grep -E "s:|i:|Verify return code"
echo | openssl s_client -connect example.com:443 -servername example.com 2>/dev/null | openssl x509 -noout -subject -issuer -dates
curl -I http://example.com
curl -sI https://example.com | grep -i strict-transport
八、效果验证与自动化续期监控
验证四步,缺一不可:
# 1. 信任链验证,必须为 0 (ok)
echo | openssl s_client -connect example.com:443 -servername example.com 2>/dev/null | grep "Verify return code"
# 2. 证书张数应 >= 2(叶子 + 中间)
openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null 2>&1 | grep -c "BEGIN CERTIFICATE"
# 3. 跳转是否生效
curl -sI http://example.com | grep -iE "HTTP/|location"
# 4. 到期时间
openssl s_client -connect example.com:443 -servername example.com </dev/null 2>/dev/null | openssl x509 -noout -enddate
再用 SSL Labs 做整体评级:https://www.ssllabs.com/ssltest/analyze.html?d=example.com&all=done。拿 A+ 的条件是:禁用 TLS 1.0/1.1、无 RC4/3DES、启用 HSTS 且 max-age 足够长、支持 TLS 1.3。
续期自动化要确认定时任务真的在跑:
crontab -l | grep acme.sh
~/.acme.sh/acme.sh --cron --home ~/.acme.sh
systemctl list-timers | grep certbot
certbot renew --dry-run
到期告警脚本(剩余不足 30 天发信):
#!/bin/bash
DOMAIN=example.com
END=$(echo | openssl s_client -connect $DOMAIN:443 -servername $DOMAIN 2>/dev/null | openssl x509 -noout -enddate | cut -d= -f2)
LEFT=$(( ( $(date -d "$END" +%s) - $(date +%s) ) / 86400 ))
[ $LEFT -lt 30 ] && echo "WARN: $DOMAIN cert expires in $LEFT days" | mail -s "SSL 告警" ops@example.com
两个易踩点:一是续期成功后必须 reload 服务,否则 Nginx 仍持有旧证书,这是“续期成功但浏览器仍报过期”的第一大原因,用 --reloadcmd 或 certbot 的 deploy-hook 绑定;二是 Let’s Encrypt 已停止 OCSP 服务,对这类证书配置 ssl_stapling 无实际收益但不影响功能,日志里的 stapling 警告可忽略。
常见问题
可以。DV 证书只验证域名控制权,走 DNS-01 甚至不需要网站能访问,海外节点也不要求备案。但未备案域名解析到中国大陆服务器会被阻断 80/443,表现为连接超时而非证书错误,需先完成 ICP 备案。
公网信任证书最长 398 天,自 2020 年 9 月 1 日起生效。Let’s Encrypt 固定 90 天,建议 60 天续期。业界已通过决议分阶段缩短至 200/100/47 天,因此必须配置自动续期而非手动更换。
不能完全覆盖。*.example.com 只匹配一级子域如 a.example.com,不匹配裸域 example.com,也不匹配 a.b.example.com。裸域和 www 需单独写入 SAN,多级子域要另签 *.b.example.com 或多域名证书。
先看错误码:ERR_CERT_DATE_INVALID 是过期,COMMON_NAME_INVALID 是 SAN 不匹配,AUTHORITY_INVALID 多为缺中间证书。再用 openssl s_client -showcerts 确认下发链完整,最后检查页面是否加载了 http 资源造成混合内容。
用户从 http:// 进入时尚未建立 TLS 连接,只有 80 端口的 server 块能接收请求并返回 301。若 80 未监听或直接返回 404,跳转不会发生。同时要把 ACME 校验路径放在跳转规则之前,否则 HTTP-01 续期会失败。
可以。它是受信任的公共 CA,签发的 DV 证书与商业 DV 证书在浏览器信任度上没有差别,允许商业使用。区别在于只验证域名控制权,不提供 OV/EV 的组织信息背书和人工赔付条款。