SSL 证书安装与全站 HTTPS 配置实战:从 CSR 生成、Nginx/Apache/IIS 部署到报错排查
一、问题背景:证书买了却装不上,根因只有这几类
证书服务工单里最常见的描述是“证书已经签发并上传,但 https 打不开”。真正的验收标准应当只有一条:通过域名访问能成功加载对应的 SSL 证书,浏览器无任何告警。文件传上去不等于装好了。把历年故障归因,90% 落在下面七类:
- 域名覆盖不全:证书只签了 example.com,用户却访问 www.example.com,SAN 中没有该域名,直接触发域名不匹配。
- 证书链不完整:只部署了叶子证书,缺少中间 CA。PC 端因为缓存过中间证书可能正常,手机端和 curl 直接失败。
- 私钥与证书不匹配:多套证书混用、复制时拷错文件,Nginx 启动即报 key values mismatch。
- 有效期问题:自 2020 年 9 月起,公有 CA 签发的证书最长有效期被限制为 398 天;Let’s Encrypt 免费证书固定 90 天,续期失败不会有任何提示,过期当天才炸。
- 协议与套件过时:仍开启 TLSv1.0/1.1,或使用已被主流浏览器移除的 3DES、RSA 密钥交换套件。
- 混合内容:页面本身走 HTTPS,但图片、JS、接口仍写死 http://,地址栏依旧显示“不安全”。
- 网络层未放行:安全组、firewalld、iptables 未开放 443,表现为连接超时而不是证书报错,很容易误判成证书问题。
下面按“准备 → 安装 → 配置 → 排错 → 验证”的顺序给出可直接复制执行的命令,覆盖 Linux(Nginx / Apache / Tomcat)与 Windows(IIS)两类环境。
二、前置准备:CSR 生成、SAN 声明与证书链自检
建议在本地生成私钥与 CSR,而不是使用 CA 控制台下发的私钥,便于后续迁移与备份。OpenSSL 1.1.1 及以上可直接用 -addext 写入 SAN:
openssl version
openssl req -new -newkey rsa:2048 -nodes
-keyout example.com.key -out example.com.csr
-subj "/C=CN/ST=Beijing/L=Beijing/O=Example/CN=example.com"
-addext "subjectAltName=DNS:example.com,DNS:www.example.com"
chmod 600 example.com.key
OpenSSL 1.0.2 没有 -addext,需要写配置文件 csr.cnf 后引用:
[req]
distinguished_name = dn
req_extensions = v3_req
[dn]
[v3_req]
subjectAltName = @alt
[alt]
DNS.1 = example.com
DNS.2 = www.example.com
# openssl req -new -newkey rsa:2048 -nodes -keyout example.com.key -out example.com.csr -config csr.cnf
拿到证书文件后先做三项自检,比直接上生产快得多:
# 1. 私钥与证书是否匹配,两个 md5 必须完全一致
openssl x509 -noout -modulus -in example.com.crt | openssl md5
openssl rsa -noout -modulus -in example.com.key | openssl md5
# 2. 确认 SAN 与有效期
openssl x509 -in example.com.crt -noout -subject -dates -ext subjectAltName
# 3. 拼装完整链:叶子证书在前,中间证书在后,顺序不能反
cat example.com.crt intermediate.crt > fullchain.crt
域名验证二选一:DNS 验证在解析处添加一条 TXT 记录,等待 TTL 生效(一般 10 分钟内);文件验证必须保证 http://example.com/.well-known/pki-validation/xxx.txt 能被公网直接访问,不能被 301 跳转、Basic 鉴权或 CDN 缓存拦截,否则 CA 一直显示“验证中”。
三、实操:Nginx 安装证书与全站 301 强制跳转
先确认版本与目录,证书文件放在 700 权限的独立目录,避免私钥被其他站点进程读取:
nginx -v
mkdir -p /etc/nginx/ssl && chmod 700 /etc/nginx/ssl
cp fullchain.crt example.com.key /etc/nginx/ssl/ && chmod 600 /etc/nginx/ssl/*
站点配置拆成两个 server 块,80 端口只做跳转,443 端口承载业务:
server {
listen 80;
server_name example.com www.example.com;
return 301 https://$host$request_uri;
}
server {
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/fullchain.crt;
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;
add_header Strict-Transport-Security "max-age=31536000" always;
location / {
root /var/www/html;
index index.html;
}
}
生效与放行:
nginx -t && systemctl reload nginx
firewall-cmd --permanent --add-service=https && firewall-cmd --reload
ss -lntp | grep ':443'
注意 ssl_certificate 必须指向 fullchain(叶子+中间证书),只写叶子证书在部分安卓与 Java 客户端上会直接握手失败;ssl_certificate_key 权限不对时 Nginx 会以 13: Permission denied 报错。
四、实操:Apache、Tomcat 与 Windows IIS 配置示例
Apache(httpd 2.4):2.4.8 之后中间证书合并进 SSLCertificateFile,不再需要 SSLCertificateChainFile(该指令在 2.4.8+ 已废弃)。
<VirtualHost *:443>
ServerName example.com
SSLEngine on
SSLCertificateFile /etc/httpd/ssl/fullchain.crt
SSLCertificateKeyFile /etc/httpd/ssl/example.com.key
SSLProtocol -all +TLSv1.2 +TLSv1.3
SSLCipherSuite HIGH:!aNULL:!MD5:!3DES
Header always set Strict-Transport-Security "max-age=31536000"
</VirtualHost>
# httpd -t && systemctl reload httpd
Tomcat(9/10):先把 PEM 转成 PKCS12,再在 server.xml 中启用 443 连接器:
openssl pkcs12 -export -in fullchain.crt -inkey example.com.key
-out example.com.p12 -name tomcat -passout pass:changeit
<Connector port="443" protocol="org.apache.coyote.http11.Http11NioProtocol"
SSLEnabled="true" scheme="https" secure="true" maxThreads="200">
<SSLHostConfig protocols="TLSv1.2,TLSv1.3">
<Certificate certificateKeystoreFile="/opt/tomcat/conf/example.com.p12"
certificateKeystoreType="PKCS12"
certificateKeystorePassword="changeit" type="RSA" />
</SSLHostConfig>
</Connector>
Windows IIS:导入 .pfx(含私钥)→ 站点“绑定”→ 添加 https、端口 443 → 必须勾选“服务器名称指示(SNI)”,否则同 IP 多站点会串证书。命令行核查绑定:
netsh http show sslcert
certutil -store My
IIS 无内置自动续期,建议用 win-acme 计划任务,续期后自动执行 iisreset /noforce。
五、实操:Let’s Encrypt 自动签发与 90 天续期
免费证书适合个人站与测试环境,有效期固定 90 天,必须自动化续期:
- SSL证书申请 · SSL证书购买 · SSL证书安装配置
- 代购 SSL 证书 · DigiCert / GeoTrust / RapidSSL 单域名与通配符
- SSL域名证书申请 · 小程序证书 · 国外SSL证书
apt install -y certbot python3-certbot-nginx
certbot --nginx -d example.com -d www.example.com
--deploy-hook "systemctl reload nginx"
# 模拟续期,不消耗真实额度
certbot renew --dry-run
# 确认定时器已生效
systemctl list-timers | grep certbot
certbot certificates
纯静态或无 Nginx 插件的场景用 webroot 模式:
certbot certonly --webroot -w /var/www/html -d example.com -d www.example.com
泛域名必须走 DNS-01,通配符不能使用文件验证:
certbot certonly --manual --preferred-challenges dns -d "*.example.com" -d example.com
手动 DNS 无法自动续期,建议接入云厂商 DNS API 插件(如 certbot-dns-aliyun)实现全自动。证书路径固定为 /etc/letsencrypt/live/example.com/fullchain.pem,续期后只需 reload 即可生效,无需改配置。若使用 CDN,还需把新证书同步上传到 CDN 控制台,否则源站更新、边缘节点仍是旧证书。
六、对比表格:证书类型与各服务器配置项对照
选型先看验证方式与有效期,再看部署差异。下表为当前主流规格(有效期上限以公有 CA 的 398 天规则为准):
| 类型 | 验证方式 | 有效期上限 | 签发时长 | 浏览器地址栏 | 适用场景 |
|---|---|---|---|---|---|
| DV 域名型 | DNS TXT / 文件 | 398 天 | 分钟级 | 锁标志 | 个人站、API、内部测试 |
| OV 组织型 | 域名 + 企业资质核验 | 398 天 | 1–3 个工作日 | 锁标志(可查组织) | 企业官网、电商 |
| EV 增强型 | 严格人工核验 | 398 天 | 3–7 个工作日 | 锁标志(主流浏览器已不显示绿色公司名) | 金融、政务 |
| Let’s Encrypt | 域名(ACME 自动) | 90 天 | 秒级 | 锁标志 | 可自动化的站点、测试环境 |
| 通配符 | 必须 DNS-01 | 398 / 90 天 | 视 CA | 锁标志 | 多子域统一管理(仅覆盖一级) |
同一张证书在不同服务器上的关键配置项差异:
| 服务器 | 证书指令 | 私钥指令 | 协议指令 | 重载命令 |
|---|---|---|---|---|
| Nginx | ssl_certificate(fullchain) | ssl_certificate_key | ssl_protocols | nginx -t && systemctl reload nginx |
| Apache | SSLCertificateFile(fullchain) | SSLCertificateKeyFile | SSLProtocol | httpd -t && systemctl reload httpd |
| Tomcat | certificateKeystoreFile(PKCS12) | certificateKeystorePassword | SSLHostConfig protocols | systemctl restart tomcat |
| IIS | 图形界面导入 .pfx | 随 pfx 导入 | 注册表 / 工具禁用旧协议 | iisreset /noforce |
七、常见错误排查:真实报错与处理动作
下面每条报错都来自实际工单,按“现象 → 根因 → 处理”执行即可:
- NET::ERR_CERT_COMMON_NAME_INVALID / SSL_ERROR_BAD_CERT_DOMAIN:访问域名不在 SAN 中。执行
openssl x509 -in fullchain.crt -noout -ext subjectAltName核对,缺失则重新签发多域名或通配符证书。 - curl: (60) SSL certificate problem: unable to get local issuer certificate:证书链不完整。把中间证书拼进 fullchain 后重载;用
openssl s_client -connect example.com:443 -servername example.com -showcerts查看是否返回 2 张以上证书。 - 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 比对,换回正确私钥。
- nginx: [emerg] cannot load certificate … PEM_read_bio_X509_AUX() failed:文件是 PKCS7/PFX 或含 BOM。执行
openssl x509 -in old.crt -out new.crt转成 PEM。 - ERR_SSL_VERSION_OR_CIPHER_MISMATCH:协议或套件不匹配,多见于关闭 TLSv1.2 只留 1.3,或未启用 SNI 导致返回默认站点证书。检查
ssl_protocols与多站点server_name。 - Mixed Content: The page at ‘https://…’ was loaded over HTTPS, but requested an insecure element ‘http://…’:资源写死 http。全局替换为
//或 https,并在 Nginx 加add_header Content-Security-Policy "upgrade-insecure-requests";。 - ERR_CERT_DATE_INVALID:证书过期或服务器时间漂移。先
timedatectl/chronyc sources校时,再certbot renew续期。 - 连接超时而非证书错误:443 未放行。查安全组、
firewall-cmd --list-all、iptables -L -n。
八、效果验证:五条命令确认全站 HTTPS 真正生效
部署完成后不要只看浏览器,按下列命令逐项核对:
# 1. 握手与证书链(重点看 return code 是否为 0,以及证书张数)
openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null 2>/dev/null | openssl x509 -noout -subject -issuer -dates
# 2. 协议与套件
openssl s_client -connect example.com:443 -servername example.com </dev/null 2>/dev/null | grep -i "protocol|cipher"
# 3. 旧协议必须握手失败
openssl s_client -connect example.com:443 -tls1_1 </dev/null 2>&1 | grep -i "alert|error"
# 4. 强制跳转是否生效
curl -sSI http://example.com | grep -i "^location"
# 5. HSTS 是否下发
curl -sSI https://example.com | grep -i strict-transport-security
再补两项人工核查:浏览器 F12 控制台确认无 Mixed Content 警告;用 SSL Labs 跑一次评分,A 及以上为合格,注意“证书链不完整”“不支持 TLS 1.3”“未启用 HSTS”三类扣分项。
| 检查项 | 期望结果 | 不达标处理 |
|---|---|---|
| 证书链 | 返回 2 张及以上证书 | 拼接中间证书为 fullchain |
| 协议版本 | 仅 TLSv1.2 / TLSv1.3 | 调整 ssl_protocols 或 SSLProtocol |
| 80 端口 | 301 到 https | 补 return 301 / RewriteRule |
| HSTS | max-age=31536000 | add_header 增加响应头 |
| 到期时间 | 剩余 > 30 天 | 配置自动续期与提醒 |
常见问题
按 CA/B 论坛规则,公有 CA 签发的证书最长有效期为 398 天;Let’s Encrypt 免费证书固定 90 天。建议在到期前 30 天完成续期并 reload,不要等到过期再处理。
不建议。只部署叶子证书时,PC 浏览器可能因缓存过中间证书而正常,但手机、Java 客户端、curl 会报 unable to get local issuer certificate。应把叶子证书与中间证书拼成 fullchain 后部署。
常见三个原因:证书链不完整、手机访问的是未包含在 SAN 中的域名(如 m.example.com)、服务器未启用 SNI 或只支持旧协议。用 openssl s_client 加 -servername 复现即可定位。
单域名证书 1 个;多域名证书(SAN)通常可绑 1–100 个域名,按套餐而定。通配符 *.example.com 只覆盖一级子域,不包含 example.com 本身,也不覆盖 a.b.example.com。
加密强度没有区别,都是同等 TLS 加密。差异在有效期(90 天 vs 398 天)、是否含组织信息(OV/EV)、保险赔付额度、技术支持与吊销响应速度。对外经营站点建议 OV 及以上。
Nginx 执行 nginx -t 后 reload 即可,不断连接;Apache 用 systemctl reload httpd;Tomcat 需重启;IIS 重新绑定或执行 iisreset /noforce。若前面有 CDN,还要把新证书同步到 CDN 节点。