HTTPS 配置 SSL 证书完整指南:从 CSR 到 Nginx/Apache 安装排错
问题背景:HTTPS 配置失败到底卡在哪
SSL/TLS 位于 TCP/IP 与 HTTP 等应用层之间,通过记录协议封装、压缩、加密数据,通过握手协议完成身份认证、算法协商和密钥交换。HTTPS 不是把证书文件上传到服务器就结束,浏览器会校验证书链、域名 SAN、有效期、签名算法、SNI 与私钥匹配,任何一项不满足都会中断。常见根因包括:只部署叶子证书未带中间证书,导致 NET::ERR_CERT_AUTHORITY_INVALID;证书 SAN 不包含 www 或子域名,触发 SSL_ERROR_BAD_CERT_DOMAIN;私钥与证书不匹配,Nginx 报 key values mismatch;安全组未放行 443,curl 超时;页面仍写死 http:// 资源,出现混合内容。证书有效期规则也要注意:公有 CA 签发的 SSL/TLS 证书最长有效期 398 天,Let’s Encrypt 免费证书有效期为 90 天,建议到期前 30 天续签并自动化。如果购买的是证书安装配置服务,通常只包含部署与排错,不直接提供证书,证书需自行购买或申请。排查先从 openssl s_client 和 curl -v 入手,不要先改业务代码。
准备工作:域名、证书与私钥的硬性检查
先确认域名 A/AAAA 记录已指向服务器,80 和 443 端口在防火墙与安全组均放行。生成 CSR 与 2048 位 RSA 私钥:
openssl req -new -newkey rsa:2048 -nodes -keyout example.com.key -out example.com.csr -subj '/CN=example.com' -addext 'subjectAltName=DNS:example.com,DNS:www.example.com'
SAN 必须覆盖所有访问域名。拿到证书后检查私钥匹配:
openssl x509 -noout -modulus -in fullchain.pem | openssl md5
openssl rsa -noout -modulus -in example.com.key | openssl md5
两条输出的 MD5 必须一致。再查 SAN、有效期和证书链:
openssl x509 -in fullchain.pem -noout -text | grep -A1 'Subject Alternative Name'
openssl x509 -in fullchain.pem -noout -dates
openssl verify -CAfile chain.pem fullchain.pem
fullchain.pem 应为服务器证书加中间证书,顺序不能反;私钥权限设为 600,属主为 nginx 或 root。Let’s Encrypt 证书 90 天有效,certbot 默认自动续期,但要用 certbot renew –dry-run 验证定时任务。证书安装配置服务一般只负责部署,不直接提供证书;用户需自行购买或申请证书,并在交付前确认私钥由自己保管。
Nginx 安装配置:443、HTTP/2 与证书链
把 fullchain.pem 和私钥放到 /etc/nginx/ssl/,配置 80 跳转与 443 服务:
server {
listen 80;
server_name example.com www.example.com;
return 301 https://$host$request_uri;
}
server {
listen 443 ssl http2;
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 HIGH:!aNULL:!MD5;
ssl_session_cache shared:SSL:10m;
ssl_session_timeout 10m;
add_header Strict-Transport-Security 'max-age=31536000' always;
location / { root /var/www/html; index index.html; }
}
执行 nginx -t 检查语法,再 systemctl reload nginx。若报 nginx: [emerg] cannot load certificate … PEM_read_bio_X509,优先检查路径、文件权限和 fullchain 是否完整;若报 SSL_CTX_use_PrivateKey … key values mismatch,说明证书与私钥不匹配。不要同时启用已淘汰的 TLSv1.0/TLSv1.1。HTTP/2 在 Nginx 1.25.1 后建议使用 listen 443 ssl; http2 on;,旧写法仍可兼容但需关注版本。配置后访问 https://example.com 应返回 200,http 应 301 到 https。
Apache 安装配置:SSLCertificateFile 与链文件顺序
Apache 2.4 使用 mod_ssl。Debian/Ubuntu 执行 a2enmod ssl,CentOS/RHEL 确认 mod_ssl 已安装。虚拟主机示例:
<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
SSLHonorCipherOrder on
Header always set Strict-Transport-Security 'max-age=31536000'
</VirtualHost>
SSLCertificateFile 在 Apache 2.4.8 及以上可直接放 fullchain.pem;老版本需用 SSLCertificateChainFile 指向中间证书。链顺序必须是叶子证书在前、中间证书在后,根证书不要放入。执行 apachectl configtest 或 httpd -t,输出 Syntax OK 后 systemctl reload httpd 或 apache2。若报 AH02572: Failed to configure at least one certificate and key,通常是证书路径错误或私钥权限不足;若浏览器提示证书链不完整,用 openssl s_client -connect example.com:443 -servername example.com -showcerts 查看返回的证书层级。80 端口同样配置 Redirect permanent / https://example.com/。
证书类型与部署方式对比表
选证书不要只看价格,要看验证方式、域名覆盖和续期成本。下表按常见场景对比:
| 类型 | 典型有效期 | 验证方式 | 适用场景 | 部署注意 |
|---|---|---|---|---|
| Let’s Encrypt DV | 90 天 | DNS/HTTP 文件验证 | 个人站、测试、API | 必须自动续期,certbot renew –dry-run |
| 商业 DV | 最长 398 天 | 域名控制权 | 中小企业官网 | 确认 SAN 数量与链文件 |
| OV 企业型 | 最长 398 天 | 企业资质核验 | 电商、金融、SaaS | 主体信息变更需重签 |
| 通配符证书 | 最长 398 天 | DNS 验证 | 多子域名统一入口 | 只覆盖一级,*.example.com 不含 a.b.example.com |
| 多域名 SAN | 最长 398 天 | 按域名验证 | 多品牌域名 | 上线前核对全部 SAN |
部署方式上,Nginx 用 ssl_certificate 指向 fullchain.pem,Apache 用 SSLCertificateFile 指向 fullchain.pem;IIS 导入 PFX 时需包含私钥并选择个人存储。无论哪种方式,证书最长有效期 398 天、Let’s Encrypt 90 天的规则都不变,续期后必须重载服务,否则新证书不会生效。
常见错误排查:从报错到命令定位
先看真实报错,再对症处理:curl: (60) SSL certificate problem: unable to get local issuer certificate 表示服务端未发送中间证书或本地 CA 库过旧;浏览器 NET::ERR_CERT_AUTHORITY_INVALID 多半是链不完整;SSL_ERROR_BAD_CERT_DOMAIN 是 SAN 不匹配;nginx: [emerg] PEM_read_bio_X509 是证书文件损坏或路径错;key values mismatch 是私钥与证书不配对。定位命令:
curl -Iv https://example.com
openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null
openssl s_client -connect example.com:443 -servername example.com -tls1_2 </dev/null
ss -lntp | grep ':443'
nginx -t
apachectl configtest
若 s_client 返回 Verify return code: 0 (ok) 且证书链完整,说明 TLS 层正常;若 curl 仍报错,检查系统时间、CA 证书包和代理。页面布局错乱通常是混合内容:按 F12 查看 Console 的 Mixed Content 警告,把 http:// 的图片、JS、CSS 改为 https:// 或协议相对地址,必要时加 Content-Security-Policy: upgrade-insecure-requests。443 不通时用 ss 和 telnet 检查监听与安全组,不要只改 Nginx 配置。
效果验证与上线检查清单
配置完成后按清单验收:1)curl -I https://example.com 返回 HTTP/2 200 或 HTTP/1.1 200;2)openssl s_client -connect example.com:443 -servername example.com </dev/null 输出 Verify return code: 0 (ok),协议为 TLSv1.2 或 TLSv1.3;3)openssl x509 -in fullchain.pem -noout -dates 确认 notAfter 未过期;4)浏览器地址栏锁标志正常,无混合内容警告;5)http:// 自动 301 到 https://;6)HSTS 头存在且 max-age 合理;7)证书链包含中间证书。续期验证命令:
certbot renew --dry-run
systemctl list-timers | grep certbot
openssl s_client -connect example.com:443 -servername example.com </dev/null | openssl x509 -noout -subject -issuer -dates
最后用 SSL Labs 或 testssl.sh 做外部扫描,重点看证书链、协议版本、弱套件和到期时间。上线后保留回滚配置,监控证书到期告警,至少提前 30 天续期。对于电商、支付、邮箱、金融等高私密性站点,HTTPS 是底线;搜索引擎优先抓取 HTTPS,也能降低劫持、镜像和广告注入风险。
常见问题
公有 CA 签发的 SSL/TLS 证书最长有效期为 398 天;Let’s Encrypt 免费证书为 90 天,必须用 certbot 自动续期,并在到期前 30 天执行 certbot renew –dry-run 验证,不要依赖手动续期。
多数是混合内容:页面仍引用 http:// 的图片、JS 或 CSS。用浏览器 Console 查 Mixed Content,把资源改为 https:// 或加 CSP upgrade-insecure-requests,这不是证书安装失败,而是程序里写死了 http 链接。
cert.pem 通常只有服务器叶子证书,fullchain.pem 还包含中间证书。Nginx/Apache 应优先用 fullchain.pem,并按叶子在前、中间在后的顺序部署,否则浏览器可能报 NET::ERR_CERT_AUTHORITY_INVALID。
可以。Let’s Encrypt DV 证书适合大多数网站,但有效期仅 90 天,必须配置自动续期和到期监控;金融、电商如需 OV 企业信息展示,可选商业证书,注意最长有效期 398 天。
先执行 ss -lntp | grep ‘:443’ 看服务是否监听,再用 curl -Iv https://域名 和 openssl s_client 查 TLS 握手;若监听正常,检查云安全组、本机防火墙、SNI 和证书链,不要只重启 Nginx。