HTTPS 证书配置完整指南:从 CSR 生成到 Nginx/Apache 部署与故障排查
为什么现在必须上 HTTPS:问题背景与根因
HTTP 协议以明文传输,数据在每一跳路由、代理、公共 Wi-Fi 上都可能被读取或篡改。运营商劫持插入广告、DNS 劫持跳转到钓鱼站、公共热点嗅探账号密码,本质上都是因为缺少传输层加密与身份认证。TLS(SSL 的继任协议)位于 TCP 与应用层之间,提供三件事:身份认证(确认你连的是 example.com 而不是伪造服务器)、数据加密(AES-GCM/ChaCha20 对称加密)、完整性校验(HMAC/AEAD 防止中途篡改)。
从 2018 年起 Chrome、Firefox、Safari 已对 HTTP 页面在地址栏标注”不安全”;搜索引擎对 HTTPS 站点给予抓取与排名优先;苹果 ATS、微信小程序、支付宝开放平台、iOS 应用内支付回调都强制要求 HTTPS 且证书链完整。也就是说,HTTPS 早已不是”加分项”,而是上线的前置条件。
很多运营同学反馈”配置完 HTTPS 后页面样式全乱、图片加载不出来”,这不是证书配置错误,而是页面内硬编码了 http:// 资源链接,浏览器在 HTTPS 页面中会拦截这些”混合内容(Mixed Content)”。定位方法:打开 Chrome DevTools → Console,会看到 Mixed Content: The page at 'https://example.com/' was loaded over HTTPS, but requested an insecure image 'http://cdn.example.com/a.png'. This request has been blocked. 解决方式是把模板里的资源地址改为相对路径或 //cdn.example.com/... 协议相对地址,必要时在 Nginx 层做 301 跳转兜底。
还有一条容易踩坑的规则变化:CA/Browser Forum 规定,自 2020 年 9 月 1 日起,所有公开信任的 TLS 证书最长有效期不得超过 398 天;Let’s Encrypt 免费证书有效期固定为 90 天,必须依赖 ACME 自动续期。任何”一次配置管三年”的旧方案都已失效,证书到期导致的全站不可用是最常见的线上事故之一。
证书类型、有效期新规与选型对比
选证书先看三件事:验证等级、覆盖范围、密钥算法。验证等级决定审核流程与信任展示,覆盖范围决定要买几张,密钥算法决定性能与兼容性。
| 类型 | 验证内容 | 签发时长 | 地址栏表现 | 参考价格 | 适用场景 |
|---|---|---|---|---|---|
| DV 域名验证型 | 仅验证域名控制权(DNS TXT / HTTP 文件 / 管理员邮箱) | 1 分钟 – 1 小时 | 锁标 | 0 – 300 元/年 | 博客、API 网关、内部系统、测试环境 |
| OV 组织验证型 | 域名 + 企业工商信息人工核验 | 1 – 3 个工作日 | 锁标,点开证书可见企业名 | 1000 – 3000 元/年 | 企业官网、电商、SaaS |
| EV 扩展验证型 | 最严格的法律实体核验 | 3 – 7 个工作日 | 锁标(Chrome 77+ 已取消绿色公司名展示) | 3000 – 8000 元/年 | 金融、支付、需要合规审计的场景 |
覆盖范围上:单域名证书只保护 example.com;通配符证书(*.example.com)保护 www.example.com、api.example.com,但不保护裸域 example.com,也不保护 a.b.example.com;多域名 SAN 证书可在一张证书里放最多 100 个不同域名,适合域名分散的站群。
密钥算法方面,RSA 2048 位兼容性最好;ECDSA P-256 握手更快、证书体积更小,但不支持 Windows XP / Android 4.x 等老客户端。生产环境常见做法是双证书(RSA + ECDSA)由 Nginx 自动协商。无论哪种,单张证书有效期上限都是 398 天,续期必须做成自动化流程。
第一步:生成私钥与 CSR(可直接执行的命令)
CSR(Certificate Signing Request)是提交给 CA 的证书签名请求,包含公钥与主体信息。私钥必须在本机生成,绝不要通过聊天工具传给任何人。
# 1. 创建目录并生成 RSA 2048 私钥 + CSR(OpenSSL 1.1.1+ 支持 -addext 写入 SAN)
mkdir -p /etc/nginx/ssl && cd /etc/nginx/ssl
openssl req -new -newkey rsa:2048 -nodes
-keyout example.com.key -out example.com.csr
-subj "/C=CN/ST=Zhejiang/L=Hangzhou/O=Example Co Ltd/CN=example.com"
-addext "subjectAltName=DNS:example.com,DNS:www.example.com"
# 2. 确认 CSR 中的 SAN 是否包含全部需要保护的域名(最常见错误来源)
openssl req -in example.com.csr -noout -text | grep -A1 "Subject Alternative Name"
# 3. 生成 ECDSA P-256 私钥(可选,性能更优)
openssl ecparam -genkey -name prime256v1 -out example.com.ec.key
openssl req -new -key example.com.ec.key -out example.com.ec.csr
-subj "/CN=example.com" -addext "subjectAltName=DNS:example.com,DNS:www.example.com"
注意 -nodes 表示私钥不加密(便于 Nginx 自动加载),因此文件权限必须收紧:chmod 600 example.com.key && chown root:root example.com.key。
拿到 CA 签发的证书后,务必校验私钥与证书是否匹配,这是后面 nginx: [emerg] key values mismatch 报错的根本原因:
openssl x509 -noout -modulus -in example.com.crt | openssl md5
openssl rsa -noout -modulus -in example.com.key | openssl md5
# 两行输出的 MD5 必须完全一致
# 查看证书包含的域名与有效期
openssl x509 -in example.com.crt -noout -subject -issuer -dates -ext subjectAltName
如果 CA 只给了 example.com.crt 而没有中间证书,需要自行下载对应的中间链(如 DigiCert Global G2、Sectigo RSA DV CA),按”服务器证书 + 中间证书”顺序拼接成 fullchain.pem,顺序颠倒会直接导致 Android 与 curl 校验失败。
第二步:Nginx / Apache / Tomcat 配置示例
Nginx(1.25.1+ 用 http2 on; 旧版本用 listen 443 ssl http2;)
server {
listen 443 ssl;
http2 on;
server_name example.com www.example.com;
ssl_certificate /etc/nginx/ssl/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/chain.pem;
add_header Strict-Transport-Security "max-age=31536000; includeSubDomains" always;
location / { proxy_pass http://127.0.0.1:8080; }
}
server {
listen 80;
server_name example.com www.example.com;
return 301 https://$host$request_uri;
}
Apache 2.4
<VirtualHost *:443>
ServerName example.com
SSLEngine on
SSLCertificateFile /etc/httpd/ssl/fullchain.pem
SSLCertificateKeyFile /etc/httpd/ssl/example.com.key
SSLProtocol all -SSLv3 -TLSv1 -TLSv1.1
SSLCipherSuite HIGH:!aNULL:!MD5:!3DES
Header always set Strict-Transport-Security "max-age=31536000"
</VirtualHost>
Tomcat 9/10:把证书转成 PKCS#12,再在 conf/server.xml 中配置:
openssl pkcs12 -export -out /opt/tomcat/conf/example.p12
-inkey example.com.key -in fullchain.pem -name tomcat -passout pass:ChangeMe123
<Connector port="8443" protocol="org.apache.coyote.http11.Http11NioProtocol"
SSLEnabled="true" maxThreads="200" scheme="https" secure="true"
keystoreFile="/opt/tomcat/conf/example.p12"
keystoreType="PKCS12" keystorePass="ChangeMe123"
sslProtocol="TLS" sslEnabledProtocols="TLSv1.2,TLSv1.3" />
改完配置统一执行 nginx -t && nginx -s reload 或 apachectl configtest && systemctl reload httpd。若后端是 Spring Boot,注意 server.forward-headers-strategy=framework,否则应用生成的跳转链接仍是 http,形成重定向循环。
证书文件格式与部署位置对比
CA 下发的文件扩展名五花八门,同名不同格式是最容易搞混的地方。判断方法:head -1 cert.cer,若输出 -----BEGIN CERTIFICATE----- 就是 PEM 文本,否则是 DER 二进制。
| 格式 | 常见扩展名 | 编码 | 是否含私钥 | 典型用途 | 转换命令 |
|---|---|---|---|---|---|
| PEM | .pem / .crt / .cer | Base64 文本 | 否 | Nginx、Apache、HAProxy | — |
| DER | .der / .cer | 二进制 | 否 | Java KeyStore 导入源、Windows | openssl x509 -in cert.pem -outform der -out cert.der |
| PKCS#12 | .pfx / .p12 | 二进制 | 是 | IIS、Tomcat、Windows 导入 | openssl pkcs12 -export -out a.pfx -inkey a.key -in fullchain.pem |
| JKS | .jks | 二进制 | 是 | Tomcat、WebLogic、Kafka | keytool -importkeystore -srckeystore a.pfx -srcstoretype PKCS12 -destkeystore a.jks -deststoretype JKS |
从 PFX 反向拆出 PEM:openssl pkcs12 -in a.pfx -nodes -out all.pem,再用 openssl x509 -in all.pem -out cert.pem 提取证书、openssl rsa -in all.pem -out key.pem 提取私钥。常见误区是把 cert.pem(仅站点证书)配给 Nginx,而把 chain.pem 忘在压缩包里,结果桌面浏览器正常(会自行补链),但 Android App、Java 客户端、curl 全部报 unable to get local issuer certificate。
常见报错排查:从 nginx 启动失败到浏览器告警
1) 私钥与证书不匹配
- 代购 SSL 证书 · DigiCert / GeoTrust / RapidSSL 单域名与通配符
- HTTPS证书申请 · SSL证书安装部署 · 证书续费
- SSL域名证书申请 · 小程序证书 · 国外SSL证书
nginx: [emerg] SSL_CTX_use_PrivateKey_file("/etc/nginx/ssl/example.com.key") failed
(SSL: error:0B080074:x509 certificate routines:X509_check_private_key:key values mismatch)
用前文的 -modulus | openssl md5 两条命令比对,不一致说明 CSR 生成后私钥被覆盖,只能重新签发。
2) 证书文件读不到或格式错误
nginx: [emerg] cannot load certificate "/etc/nginx/ssl/fullchain.pem":
PEM_read_bio_X509_AUFILE() failed (SSL: error:0909006C:PEM routines:get_name:no start line)
三种原因:文件是 DER 二进制(用 openssl x509 -inform der -in x.cer -out x.pem 转换)、SELinux 拦截(setenforce 0 验证,或 chcon -t httpd_sys_content_t)、路径写错。
3) 浏览器域名不匹配:NET::ERR_CERT_COMMON_NAME_INVALID / Firefox 的 SSL_ERROR_BAD_CERT_DOMAIN。现代浏览器只看 SAN 不看 CN,用 openssl x509 -noout -ext subjectAltName -in cert.pem 确认访问的域名在列表中;通配符 *.example.com 不覆盖裸域和二级子域。
4) 证书链不完整:NET::ERR_CERT_AUTHORITY_INVALID,命令行表现为 curl: (60) SSL certificate problem: unable to get local issuer certificate。补全中间证书即可。
5) 协议或端口错配:ERR_SSL_PROTOCOL_ERROR 常见于把 HTTPS 请求打到了纯 HTTP 端口(如 8080),或客户端只支持 TLS 1.0 而服务端已禁用。用 openssl s_client -connect host:443 -tls1_2 逐版本测试。
6) 证书过期:NET::ERR_CERT_DATE_INVALID,服务器时间偏差也会触发,先 timedatectl 校时。注意 398 天上限与 90 天免费证书的续期节奏。
7) 页面错乱:Console 报 Mixed Content 或 net::ERR_BLOCKED_BY_CLIENT,属于页面资源引用问题,见第一节的处理方式。
效果验证:命令、检查项与上线清单
配置完成不等于生效,必须逐项验证。
# 1. 抓取线上证书链,确认站点证书与中间证书都在
openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null 2>/dev/null | grep -E "s:|i:"
# 2. 查看主题、签发者、有效期
openssl s_client -connect example.com:443 -servername example.com </dev/null 2>/dev/null
| openssl x509 -noout -subject -issuer -dates
# 3. 验证协议与加密套件
openssl s_client -connect example.com:443 -servername example.com -tls1_3 </dev/null
nmap --script ssl-enum-ciphers -p 443 example.com
# 4. 验证 HTTP 跳转与 HSTS 头
curl -sI http://example.com | grep -Ei "^HTTP|^location"
curl -sI https://example.com | grep -i strict-transport-security
# 5. 检查证书剩余天数(用于监控脚本)
echo | openssl s_client -servername example.com -connect example.com:443 2>/dev/null
| openssl x509 -noout -checkend 604800 && echo OK || echo "7 天内到期"
上线检查清单:① 80 端口 301 跳转到 443,且跳转目标用 $host 而非硬编码域名;② 只启用 TLS 1.2/1.3,禁用 SSLv3、TLS 1.0/1.1;③ 开启 HSTS 前先在测试环境跑通,includeSubDomains 会影响所有子域;④ 混合内容全部清零,DevTools Console 无红色告警;⑤ 证书链完整,Android 与 Java 客户端可正常访问;⑥ 用 SSL Labs(https://www.ssllabs.com/ssltest/analyze.html?d=example.com)跑分达到 A 及以上,检查 OCSP Stapling 是否生效。
证书生命周期自动化:ACME 续期与到期监控
398 天上限和 90 天免费证书意味着续期必须自动化,人工续期迟早出事。
# 方式一:certbot(Let's Encrypt,90 天有效期)
apt install certbot -y
certbot certonly --webroot -w /var/www/html
-d example.com -d www.example.com
--email ops@example.com --agree-tos --no-eff-email
certbot renew --dry-run # 演练,确认续期链路可用
systemctl list-timers | grep certbot
# 方式二:acme.sh(支持 DNS API 自动验证,适合通配符)
curl https://get.acme.sh | sh -s email=ops@example.com
~/.acme.sh/acme.sh --issue -d example.com -d '*.example.com' --dns dns_ali
~/.acme.sh/acme.sh --install-cert -d example.com
--key-file /etc/nginx/ssl/example.com.key
--fullchain-file /etc/nginx/ssl/fullchain.pem
--reloadcmd "nginx -t && nginx -s reload"
acme.sh 默认安装 cron 任务(0 0 * * *)在到期前 30 天自动续期,--reloadcmd 保证续期后服务重载。商业证书没有 ACME 通道,需要把到期日录入监控:Prometheus 的 blackbox_exporter 提供 probe_ssl_earliest_cert_expiry 指标,配一条告警规则 (probe_ssl_earliest_cert_expiry - time()) / 86400 < 21 即可提前三周预警。Zabbix 可用 web.certificate.get 监控项。核心原则:证书到期必须是监控项,而不是靠人记日历。
常见问题
证书最长有效期到底是多久?为什么不能买三年的?
CA/Browser Forum 规定,2020 年 9 月 1 日起签发的公开信任 TLS 证书有效期上限为 398 天(约 13 个月),这是行业强制标准,任何 CA 都无法签发更长期限的证书。市面上所谓”三年期”产品,实际是购买三年服务、CA 每年自动为你重签一次。Let’s Encrypt 等免费证书有效期为 90 天,续期频率更高。因此无论商业证书还是免费证书,都必须建立自动续期或到期监控机制。
配置 HTTPS 后页面样式错乱、图片不显示,是证书装错了吗?
不是。这是典型的混合内容(Mixed Content)问题:HTTPS 页面中引用了 http:// 开头的 JS、CSS、图片或接口,浏览器出于安全策略会拦截。打开 Chrome DevTools → Console,会看到 Mixed Content: The page at 'https://...' was loaded over HTTPS, but requested an insecure ... This request has been blocked.。解决办法是修改程序模板与数据库中的资源地址,改用相对路径、//cdn.example.com/x.png 协议相对地址或全站 https 绝对地址;也可在 Nginx 层加 Content-Security-Policy: upgrade-insecure-requests 响应头做兜底,但这只是缓解,根治仍需改代码。
一张通配符证书能覆盖 www 和裸域吗?
不能。*.example.com 只匹配一级子域,如 www.example.com、api.example.com,既不匹配裸域 example.com,也不匹配 a.b.example.com。正确做法是把通配符和裸域一起申请为多域名(SAN)证书,即 SAN 列表写成 example.com + *.example.com,这样一张证书可覆盖主域与所有一级子域。
证书装好后桌面浏览器正常,但 App 和 curl 报 unable to get local issuer certificate,为什么?
因为你只部署了站点证书(leaf certificate),没有部署中间证书(intermediate CA)。桌面浏览器有 AIA 自动补链机制会自行下载中间证书,而 Android、Java、Python requests、curl 等客户端不会,于是校验失败。解决方法是把”站点证书 + 中间证书”按顺序拼接为 fullchain.pem,在 Nginx 的 ssl_certificate 中指向该文件。可用 openssl s_client -connect example.com:443 -showcerts 查看服务器实际返回了几张证书,正常应至少两张。
开启 HSTS 有什么风险?什么时候该开?
HSTS(Strict-Transport-Security: max-age=31536000; includeSubDomains)会强制浏览器在指定时间内只用 HTTPS 访问该域名,一旦回退到 HTTP 会直接被拦截。风险在于:如果配置了 includeSubDomains 而某个子域尚未支持 HTTPS,该子域会直接不可访问,且浏览器端无法快速撤销。建议先设置较短的 max-age=300 观察一至两周,确认全站与所有子域均可用 HTTPS 后,再逐步提升到 31536000,并在加入 includeSubDomains 前确认子域清单。
免费证书和付费证书在安全性上有区别吗?
加密强度没有区别:Let’s Encrypt 的 DV 证书同样是 RSA 2048/ECDSA P-256、支持 TLS 1.2/1.3,浏览器信任链完全相同,SSL Labs 同样可以跑出 A+。差别在于:免费证书只有 DV 验证、有效期 90 天、无商业 SLA 与人工客服、无通配符以外的赔付条款;付费 OV/EV 证书提供企业身份核验、更高赔付额度、7×24 技术支持,并且部分金融、支付行业的合规审计明确要求 OV 及以上证书。个人站与内部系统用免费证书完全够用,企业对外业务按合规要求选型即可。