CA 证书与 HTTPS 配置实战指南:Nginx/Apache/Tomcat/IIS/Caddy 全流程部署与排错
一、HTTPS 配置为什么总是“证书没问题、访问还是报错”
绝大多数 HTTPS 配置失败,不是证书买错了,而是四个根因之一:域名绑定关系不对、证书链不完整、私钥与证书不匹配、服务器 TLS 版本或 SNI 支持不足。前两个占八成以上。
- 域名绑定错误:证书的 SAN(subjectAltName)里没有实际访问的域名。典型场景是只申请了 example.com,却用 www.example.com 访问;或只申请主域,却在二级域 api.example.com 上部署。
- 证书链不完整:只下发了服务器证书,没带中间证书。桌面浏览器会自动补链,所以“我这看着是绿的”,但旧版 Android、Java 客户端、部分 curl 发行版、小程序会直接握手失败。
- 私钥不匹配:CSR 与私钥不是同一对,或复制粘贴时漏了换行、混入了多余空格。
- 协议过旧:仍启用 TLS 1.0/1.1 或 SHA-1 签名算法,现代浏览器直接拒绝握手。
还有一条容易被忽略的运维事实:公网可信 TLS 证书的最长有效期自 2020-09-01 起被压缩到 398 天;CA/Browser Forum 的 SC-081 决议进一步要求 2026-03-15 起降到 200 天、2027-03-15 起 100 天、2029-03-15 起 47 天。Let’s Encrypt 免费证书则固定 90 天。这意味着“配一次管三年”的做法已经不可行,续期自动化必须和首次部署一起做完。
动手前先用三条命令做体检,能省掉一半排查时间:
openssl x509 -in fullchain.pem -noout -subject -dates -ext subjectAltName
openssl x509 -in cert.pem -noout -modulus | openssl md5
openssl rsa -in example.com.key -noout -modulus | openssl md5
两条 md5 输出必须完全一致,否则就是私钥与证书不配套;subjectAltName 里必须能看到你准备访问的每一个域名。
二、准备工作:域名核对、CSR 生成与证书链拼接
部署前先把三件事做对:DNS、CSR、证书链。
1)DNS 核对。证书只对“域名”负责,不对 IP 负责。先确认解析已生效,且记录指向的就是要部署证书的那台机器:
dig +short example.com A
dig +short www.example.com A
dig +short example.com AAAA
同时放行 443 端口,否则外网永远连不上:firewall-cmd --add-service=https --permanent && firewall-cmd --reload,云主机还需在安全组中放行 TCP 443。
2)生成私钥与 CSR。推荐 2048 位 RSA 或 ECDSA P-256;RSA 兼容性最好,ECDSA 握手更快但老 Android 4.x 可能不支持。一条命令同时生成私钥和带 SAN 的 CSR(OpenSSL 1.1.1 及以上):
openssl req -new -newkey rsa:2048 -nodes
-keyout example.com.key -out example.com.csr
-subj '/C=CN/ST=Zhejiang/L=Hangzhou/O=Example/CN=example.com'
-addext 'subjectAltName=DNS:example.com,DNS:www.example.com,DNS:api.example.com'
私钥权限必须收紧:chmod 600 example.com.key && chown root:root example.com.key。私钥一旦泄露只能吊销重签,不能“改回来”。
3)拼接完整证书链。CA 一般下发服务器证书与中间证书(可能不止一张),根证书不要拼进去。Nginx/Apache 需要的是“服务器证书 + 中间证书”:
cat example.com.crt intermediate.crt > fullchain.pem
openssl verify -CAfile root.crt -untrusted intermediate.crt example.com.crt
输出 example.com.crt: OK 才算合格。若报 unable to get local issuer certificate,说明中间证书缺失或顺序反了。最后验证线上实际下发的链路:
openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null
在返回的 Certificate chain 中,除第 0 张(站点证书)外应至少还有一张中间证书。
三、Nginx 与 Apache 配置示例(可直接复制)
Nginx 最小可用配置,含 HTTP 跳转、TLS 1.2/1.3、HSTS 与 OCSP Stapling:
server {
listen 80;
server_name example.com www.example.com;
return 301 https://$host$request_uri;
}
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-RSA-AES256-GCM-SHA384;
ssl_prefer_server_ciphers off;
ssl_session_cache shared:SSL:10m;
ssl_session_timeout 1d;
ssl_stapling on;
ssl_stapling_verify on;
ssl_trusted_certificate /etc/nginx/ssl/chain.pem;
add_header Strict-Transport-Security "max-age=31536000" always;
root /var/www/example;
index index.html;
}
校验并热加载:nginx -t && nginx -s reload。注意 http2 on; 是 Nginx 1.25.1 之后的写法,老版本仍用 listen 443 ssl http2;。
Apache 2.4 对应配置(/etc/httpd/conf.d/ssl.conf):
<VirtualHost *:443>
ServerName example.com
SSLEngine on
SSLCertificateFile /etc/httpd/ssl/fullchain.pem
SSLCertificateKeyFile /etc/httpd/ssl/example.com.key
SSLCertificateChainFile /etc/httpd/ssl/chain.pem
SSLProtocol all -SSLv3 -TLSv1 -TLSv1.1
SSLCipherSuite ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256
SSLHonorCipherOrder off
Header always set Strict-Transport-Security "max-age=31536000"
</VirtualHost>
执行 apachectl configtest 看到 Syntax OK 后再 systemctl reload httpd(Debian/Ubuntu 为 apache2)。Apache 2.4.8 之后 SSLCertificateFile 也可直接指向含中间证书的 fullchain 文件,此时 SSLCertificateChainFile 可省略。
两个细节最容易被漏掉:一是 ssl_trusted_certificate 指向的必须是中间证书(chain.pem),指向站点证书会导致 stapling 失效;二是 HTTP 跳转要放在独立 server 块里,别在同一个 443 块中做 if 判断,否则会踩到 rewrite 循环。
四、Tomcat、IIS、Caddy 的部署要点
Tomcat 只认 JKS 或 PKCS#12,必须转换。先转 PKCS#12,再导入 JKS:
openssl pkcs12 -export -in fullchain.pem -inkey example.com.key
-out example.com.p12 -name tomcat -passout pass:changeit
keytool -importkeystore -srckeystore example.com.p12 -srcstoretype PKCS12
-srcstorepass changeit -destkeystore example.com.jks -deststoretype JKS
-deststorepass changeit -alias tomcat
然后在 conf/server.xml 的 Connector 中引用:
<Connector port="8443" protocol="org.apache.coyote.http11.Http11NioProtocol"
maxThreads="200" SSLEnabled="true" scheme="https" secure="true">
<SSLHostConfig>
<Certificate certificateKeystoreFile="/opt/tomcat/conf/example.com.jks"
certificateKeystorePassword="changeit" type="RSA" />
</SSLHostConfig>
</Connector>
IIS:用 certlm.msc 把 PFX 导入“个人”存储,站点绑定 443 时务必勾选 SNI(同 IP 多站点必须勾)。命令行可用 certutil -importPFX -p 密码 example.pfx。续期建议用 win-acme:wacs.exe --target iis --installation iis --siteid 1,它会自动创建续期计划任务。
Caddy 最省事,自动申请与续期:
example.com, www.example.com {
encode gzip
root * /var/www/example
file_server
}
执行 caddy validate --config Caddyfile 后 systemctl reload caddy。Caddy 默认用 80/443 做 ACME HTTP-01 校验,端口被占用或前面还有 SLB/CDN 时会失败,此时改用 DNS-01 插件。
前提提醒:以上操作都要求你有可远程登录、有操作界面的云服务器(ECS/轻量应用服务器)。虚拟主机只能上传网站目录,无法安装证书、无法修改 Web 服务器配置,这类环境只能走主机商的一键 SSL,或把证书托管到 CDN 做 HTTPS 卸载。
五、证书类型与部署方式对比
选型先看验证等级和域名数量,再看预算。常见方案横向对比如下:
| 方案 | 有效期 | 验证方式 | 参考成本 | 续期自动化 | 适用场景 |
|---|---|---|---|---|---|
| DV 单域名(商业 CA) | 最长 398 天 | DNS TXT / HTTP 文件 | 100–500 元/年 | 需 API 或手动 | 普通官网、测试环境 |
| DV 通配符 | 最长 398 天 | DNS TXT | 800–2000 元/年 | 需 DNS API | 多子域、SaaS 平台 |
| OV / EV | 最长 398 天 | 企业实名核验 | 1000–5000 元/年 | 以手动为主 | 金融、政企、支付回调 |
| Let’s Encrypt | 90 天 | HTTP-01 / DNS-01 | 0 元 | certbot 全自动 | 绝大多数公网站点 |
| 自签名 | 自定义 | 无 | 0 元 | 脚本签发 | 仅内网、开发联调 |
再按“谁来干”对比工作量。若没有专职运维,把配置外包是常见选择,市场参考价大致如下(以单站点、单证书、标准 Web 中间件计):
| 服务形态 | 包含内容 | 参考价格 | 交付周期 |
|---|---|---|---|
| 标准 HTTPS 配置 | 已有证书,负责部署、301 跳转、TLS 参数调优 | 300 元 | 0.5–1 个工作日 |
| 含 Let’s Encrypt 免费证书 | 签发 + 部署 + 自动续期定时任务 | 350 元 | 1 个工作日 |
| 非标准化镜像环境 | 非 Websoft9 等标准镜像,目录与进程自定义 | 500 元 | 1–2 个工作日 |
| 复杂场景 | 多域名、多中间件、集群与 SLB/CDN 回源改造 | 800 元起 | 按评估 |
判断标准很简单:能 SSH 登录、能改 Web 服务器配置、能加定时任务,就自己用 certbot;只要有一条不满足(虚拟主机、托管面板、无人运维),就买服务或直接用 CDN 证书托管。切忌“买了 OV 证书但域名绑定关系写错”,证书本身救不回配置错误。
六、常见错误排查:真实报错与修复
下面这些报错覆盖了绝大多数工单,按“报错 → 根因 → 修复”对照即可:
| 报错信息 | 根因 | 修复动作 |
|---|---|---|
nginx: [emerg] SSL_CTX_use_PrivateKey_file() failed (SSL: error:0B080074:x509 certificate routines:X509_check_private_key:key values mismatch) |
私钥与证书不配套 | 用 modulus md5 比对,重新申请或找回对应私钥 |
nginx: [emerg] PEM_read_bio_X509_AUX() failed (SSL: error:0909006C:PEM routines:get_name:no start line) |
证书文件格式错误,如把 DER 当 PEM、误粘网页 HTML | 首行须为 -----BEGIN CERTIFICATE-----;DER 转 PEM:openssl x509 -inform der -in cert.der -out cert.pem |
curl: (60) SSL certificate problem: unable to get local issuer certificate |
证书链不完整,缺中间证书 | 拼接为 fullchain.pem 后重载服务 |
ERR_CERT_COMMON_NAME_INVALID |
SAN 不含当前域名,常见 www 与裸域不一致 | 重新签发包含全部域名的证书 |
NET::ERR_CERT_DATE_INVALID |
证书过期或服务器时间漂移 | timedatectl set-ntp true 校时,再查 openssl x509 -noout -dates |
java.security.cert.PKIXBuilderException: unable to find valid certification path to requested target |
服务端未下发中间证书,或 JDK 信任库缺根证书 | 补全链路;必要时 keytool -importcert -alias ca -file root.crt -keystore $JAVA_HOME/lib/security/cacerts |
sslv3 alert handshake failure |
协议或套件不匹配,一方仅支持 TLS 1.0 / RSA 密钥交换 | 服务端启用 TLS 1.2/1.3 与 ECDHE 套件 |
AH02217: ssl_stapling_init_cert: can't retrieve issuer certificate! |
Apache 缺少 SSLCertificateChainFile |
补上中间证书路径后 apachectl configtest |
还有一类“不报错但更难查”的问题:锁标正常、部分资源却加载失败,这是混合内容(Mixed Content)。用一条命令扫出来:
curl -s https://example.com/ | grep -oE 'http://[^ ]+' | sort -u
把结果里的 http 资源改为 https 或协议相对地址;若第三方接口不支持 HTTPS,只能由后端代理转发,不能在前端硬改。
七、效果验证:五条命令确认部署成功
配置重载不等于生效,必须从外部验证。按顺序执行:
curl -I http://example.com
curl -I https://example.com
openssl s_client -connect example.com:443 -servername example.com -tls1_2 </dev/null | grep -E 'Protocol|Cipher|Verify'
echo | openssl s_client -connect example.com:443 -servername example.com 2>/dev/null | openssl x509 -noout -dates -subject
openssl x509 -in /etc/nginx/ssl/fullchain.pem -noout -checkend 2592000
预期结果:第一条返回 301 且 Location 指向 https;第二条返回 200;第三条能看到 Protocol: TLSv1.2、Cipher: ECDHE-RSA-AES128-GCM-SHA256 与 Verify return code: 0 (ok);第四条显示正确域名与到期时间;第五条在 30 天内到期时返回非 0 退出码,可直接接告警脚本。
续期自动化用 cron 或 systemd timer。certbot 官方建议每天跑两次带随机延迟的续期,上线前先做一次 dry-run:
certbot renew --dry-run
echo '17 3 * * * root certbot renew --quiet --deploy-hook "systemctl reload nginx"' >> /etc/crontab
最后做外部评级:Qualys SSL Labs 拿到 A 及以上,说明协议版本、套件顺序、证书链、HSTS 均合格。评级为 B 通常是仍支持 TLS 1.0/1.1 或使用 1024 位 RSA;评级为 T 则是证书链不受信任,回到第二节检查中间证书。
别忘了业务侧回归:登录、支付回调、WebSocket(wss://)、小程序域名白名单、CDN 回源协议,都要在 HTTPS 生效后各测一遍。很多“配置成功但业务异常”的案例,最后都出在回源仍是 http,或后端接口写死了 http 地址。
常见问题
公网 TLS 证书最长能签多久,398 天还是 90 天?
两者都对,但对象不同。自 2020-09-01 起,所有公共信任 CA 签发的 TLS 证书最长有效期为 398 天;Let’s Encrypt 作为免费 CA,自行把有效期固定为 90 天以推动自动化。按 CA/Browser Forum SC-081 排期,公共证书上限将逐步缩短为 2026-03-15 起 200 天、2027-03-15 起 100 天、2029-03-15 起 47 天。结论明确:不要依赖长有效期,把续期做成自动化。
虚拟主机能不能自己安装 SSL 证书?
取决于控制面板权限。传统虚拟主机只能上传网站目录文件,无法修改 Web 服务器配置、无法绑定 443 端口,因此不能自行安装证书,只能用主机商的一键 SSL 功能。只有具备远程登录能力、可修改 Nginx/Apache/Tomcat/IIS 配置的云服务器才支持手工部署。若使用 CDN,也可把证书上传到 CDN 做 HTTPS 卸载,源站继续走 HTTP。
浏览器小锁正常,但 Java 或 Android 客户端报证书错误,为什么?
典型的证书链不完整。桌面浏览器内置 AIA 自动补链,缺中间证书也能显示正常;而 Java 的 PKIX 校验、旧版 Android、部分 curl 发行版不会自动补链,直接抛 unable to find valid certification path to requested target。解决办法是把“服务器证书 + 中间证书”拼成 fullchain 一起配置,再用 openssl s_client -showcerts 确认服务端确实下发了中间证书。
一张证书能同时保护 example.com、www 和多个子域吗?
能,但要写进 SAN。单域名证书只保护一个 FQDN;多域名证书(SAN/UCC)最多可放数十个域名;通配符证书 *.example.com 只匹配一级子域,既不匹配 example.com 本身,也不匹配 a.b.example.com。实践中最省事的组合是把“通配符 + 裸域”放进同一张证书。
部署 HTTPS 后样式丢失、接口 404 或跨域报错怎么办?
先查混合内容:浏览器 F12 的 Console 里搜 Mixed Content,或用 curl -s https://example.com/ | grep -oE 'http://[^ ]+' | sort -u 列出全部 http 引用。其次查反向代理头:Nginx 需配置 proxy_set_header X-Forwarded-Proto $scheme;,否则后端框架仍认为请求是 http,会生成 http 的静态资源地址或做错误重定向。最后检查 CDN 回源协议与 WebSocket 是否改为 wss。
Let’s Encrypt 续期失败最常见的原因是什么?
一是 HTTP-01 校验被挡:80 端口未放行、站点根目录 /.well-known/acme-challenge/ 被重写规则拦截、或前面有 CDN/SLB 导致校验请求打不到源站;二是 DNS-01 的 API 凭据过期。排查命令:certbot renew --dry-run --debug。报 Timeout during connect (likely firewall problem) 是 80 端口不通;报 Invalid response ... 404 是校验路径被拦截。