跳到主要内容
ssl证书按装

SSL证书安装服务实战指南:Nginx/Apache/IIS 配置、排错与续期

SSL证书安装服务实战指南:Nginx/Apache/IIS 配置、排错与续期 — SSL证书安装服务实战指南:Nginx/Apache/IIS 配置、排错与续期

SSL证书安装服务的目标不是“把证书文件传上去”,而是让域名在 443 端口完成可信 TLS 握手,并让页面资源全部走 HTTPS。本文按 5×8 安装与运行保障场景,给出 Nginx、Apache、IIS 的可执行配置、格式转换、真实报错排查与续期检查。证书需由你提供,服务方负责安装、配置与验证;证书申请、页面内 http 链接改造不属于安装本身。

问题背景与根因:HTTPS 失败通常不是证书文件本身

一次完整的 TLS 握手至少要满足五件事:证书域名与访问域名一致(优先看 SAN)、证书在有效期内、证书链能追到受信任根、服务器持有匹配私钥、客户端与服务器有共同 TLS 版本和密码套件。生产环境最常见根因是只上传了叶子证书,未安装中间证书,浏览器提示证书链不完整;其次是证书与私钥不匹配,Nginx 直接报 key values mismatch;第三是只给主域名签发,访问 www 时触发 NET::ERR_CERT_COMMON_NAME_INVALID。多站点还会遇到 SNI 问题:Windows Server 2012/IIS 8 起支持 SNI,Windows Server 2008/IIS 7/7.5 对多站点 HTTPS 支持有限,常需独立 IP 或升级系统。另有 443 安全组未放行、CDN 回源仍用 HTTP、页面混用 http 图片/JS 等,都会表现为“证书装了但 HTTPS 不正常”。公开可信证书最长有效期 398 天,Let’s Encrypt 为 90 天,安装前就要规划续期。

安装前检查:域名、证书链、私钥与服务器环境

先收集域名、证书文件、私钥、中间证书或 PFX 密码、服务器公网 IP、SSH/RDP 登录信息、Web 服务器类型与版本。不要只传一个 .crt;用 OpenSSL 确认证书内容与私钥匹配。以下命令可直接执行:

openssl x509 -in cert.pem -noout -subject -issuer -dates -ext subjectAltName
openssl pkey -in privkey.pem -check
openssl x509 -in cert.pem -pubkey -noout | openssl pkey -pubin -outform pem | sha256sum
openssl pkey -in privkey.pem -pubout -outform pem | sha256sum
openssl verify -untrusted chain.pem cert.pem

两个 sha256sum 输出必须一致;不一致说明证书和私钥不是一对。subjectAltName 必须包含实际访问域名,例如 example.com 和 www.example.com。fullchain 的顺序是叶子证书在前、中间证书在后,不能把根证书塞进链里。私钥权限设为 600,属主为 root 或 Web 运行用户。确认 80/443 监听与防火墙:ss -lntp | grep -E ':80|:443',云服务器还要检查安全组。若使用 CDN/负载均衡,证书应装在边缘节点,回源协议也要改为 HTTPS,否则会出现重定向循环或混合内容。

Nginx 完整实操:上传、合并链、配置 443 与跳转

将文件上传到 /etc/nginx/ssl,合并 fullchain 并收紧权限:

mkdir -p /etc/nginx/ssl
cat cert.pem chain.pem > /etc/nginx/ssl/fullchain.pem
install -m 600 privkey.pem /etc/nginx/ssl/privkey.pem
nginx -t
systemctl reload nginx

站点配置示例,80 端口强制跳转,443 只启用 TLS 1.2/1.3:

server {
    listen 80;
    server_name www.example.com example.com;
    return 301 https://$host$request_uri;
}
server {
    listen 443 ssl;
    server_name www.example.com example.com;
    ssl_certificate /etc/nginx/ssl/fullchain.pem;
    ssl_certificate_key /etc/nginx/ssl/privkey.pem;
    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 1.25.1 及以上如需 HTTP/2,使用 http2 on;;旧版才用 listen 443 ssl http2;。HSTS 只在全站及子域都确定 HTTPS 后开启,首次建议 max-age 先设 300 秒验证。reload 后若配置报 cannot load certificate,先检查 PEM 是否被加密或混入私钥;若报 key values mismatch,回到上一节核对公钥哈希。多域名可放同一证书 SAN,也可分 server 块,但必须确保 SNI 生效。

Apache 与 IIS 配置示例:多站点 HTTPS 的关键差异

Apache 2.4.8 及以上把 fullchain 直接给 SSLCertificateFile,不再单独配链文件;老版本才使用 SSLCertificateChainFile。配置后执行 apachectl configtest 或 httpd -t,通过后 reload:

<VirtualHost *:443>
ServerName www.example.com
SSLEngine on
SSLCertificateFile /etc/httpd/ssl/fullchain.pem
SSLCertificateKeyFile /etc/httpd/ssl/privkey.pem
</VirtualHost>

IIS 使用 PFX 最省事:以管理员打开 PowerShell,导入到本地计算机个人存储,再在 IIS 站点绑定 443。Windows Server 2012/IIS 8 及以上勾选 SNI 即可多站点共用 443;Windows Server 2008/IIS 7/7.5 多站点 HTTPS 支持有限,通常需要独立 IP 或升级。命令示例:

Import-PfxCertificate -FilePath C:/ssl/site.pfx -CertStoreLocation Cert:LocalMachineMy

IIS 绑定后若出现“证书配置对服务器名称无效”,检查主机头与证书 SAN 是否一致。Tomcat 则把 PFX 配到 8443/443 Connector,设置 keystoreType=PKCS12、keystoreFile、keystorePass。无论哪种环境,都不要把私钥放在 Web 根目录;PFX 密码通过工单传递后应及时更换。多站点场景先确认是否支持 SNI,再决定是否增加公网 IP,否则会出现“一个站点正常、另一个站点串证书”。

证书格式与部署方式对比:PEM、PFX、DER 怎么选

不同 Web 服务器吃不同格式,装错格式比证书本身错误更常见。PEM 是 Base64 文本,Nginx/Apache 常用;PFX/P12 是二进制容器,含私钥、证书和链,IIS/Tomcat 常用;DER 是二进制单证书,Java 或旧设备可能要求。转换命令如下:

openssl pkcs12 -export -out site.pfx -inkey privkey.pem -in cert.pem -certfile chain.pem
openssl pkcs12 -in site.pfx -nodes -out all.pem
格式/文件 包含内容 适用环境 注意点
PEM .pem/.crt Base64 证书或链 Nginx、Apache Nginx 用 fullchain,叶子在前
KEY .key 私钥 Nginx、Apache 权限 600,勿泄露
PFX/P12 私钥+证书+链 IIS、Tomcat、Java 需密码,导入后备份
DER .der 二进制单证书 Java、旧设备 不含私钥和链
CER .cer 可能是 PEM 或 DER 视内容而定 用 file/openssl 确认

部署位置也要对比:Nginx/Apache 直接终止 TLS 最可控;IIS 适合 Windows 生态;云负载均衡/CDN 把证书托管在边缘,源站需同步改 HTTPS 回源;Tomcat 等应用服务器终止 TLS 时要注意 Connector 与线程模型。选择原则是“证书格式匹配服务器、私钥不落地到公开目录、链完整、续期可自动化”。如果只拿到 .cer 且 openssl 报 PEM_read_bio_X509_AUX 失败,先执行 file cert.cer 判断是 PEM 还是 DER,再决定是否转换。

常见错误排查:真实报错与修复动作

按“浏览器提示→curl 输出→服务器日志”三层定位,能快速区分证书、链路和应用问题。

  • curl: (60) SSL certificate problem: unable to get local issuer certificate:缺中间证书。把 leaf+intermediate 合并为 fullchain,Nginx 指向 fullchain,Apache 2.4.8+ 指向 fullchain。
  • NET::ERR_CERT_COMMON_NAME_INVALID:域名不在 SAN。重新签发包含主域名和 www 的证书,或调整访问域名。
  • NET::ERR_CERT_AUTHORITY_INVALID:根不受信任、自签名或链错。用 openssl s_client -showcerts 检查链顺序。
  • nginx: [emerg] SSL_CTX_use_PrivateKey ... key values mismatch:证书与私钥不匹配,用公钥 sha256 对比。
  • SSL_ERROR_RX_RECORD_TOO_LONG:把 HTTP 请求发到 HTTPS 端口,或反代协议错。检查 listen、proxy_pass 与回源协议。
  • Mixed Content: The page at https://... was loaded over HTTPS, but requested an insecure resource http://...:页面内 http 链接导致错乱、图片不加载,这属于程序调用问题,不是证书配置问题;改 https 或协议相对 URL,并用 CSP 的 upgrade-insecure-requests 兜底。

IIS 常见 AH01909: RSA certificate configured for ... does not include an ID which matches the server name,检查站点绑定主机头与证书 SAN;Apache 报 Unable to configure RSA server private key,检查 key 权限和格式。所有修改先 nginx -t 或 httpd -t,再 reload,避免直接重启造成全站中断。

效果验证与上线检查清单

安装完成不等于交付完成。先验证证书链、有效期、SAN 和 TLS 版本,再验证跳转与页面资源。命令可直接执行:

openssl s_client -connect www.example.com:443 -servername www.example.com -showcerts </dev/null | openssl x509 -noout -subject -dates -ext subjectAltName
curl -I https://www.example.com
curl -I http://www.example.com
ss -lntp | grep :443
tail -n 50 /var/log/nginx/error.log

预期结果:https 返回 200 或业务正常状态码;http 返回 301/308 并跳到 https;s_client 输出的颁发者链完整,Verify return code 为 0;证书 notAfter 覆盖续期窗口;浏览器地址栏锁标正常,DevTools 的 Security 面板无混合内容。再检查 HSTS 是否只在确认后开启、OCSP/CRL 是否可达、CDN 回源是否 HTTPS、旧 TLS 1.0/1.1 是否关闭。多站点要分别用每个域名执行 openssl s_client -servername,否则容易只验证了默认站点。5×8 运行保障服务应记录安装时间、证书到期日、变更内容和回滚文件,建议至少提前 30 天触发续期。

证书生命周期与自动化续期:398 天与 90 天规则

公开可信 CA 签发的 TLS 证书最长有效期 398 天,Let’s Encrypt 为 90 天,且续期窗口更短。不要等过期再处理,安装服务交付时应同时配置自动续期和到期监控。Certbot 常用检查:

certbot certificates
certbot renew --dry-run
certbot renew --deploy-hook 'systemctl reload nginx'
systemctl list-timers | grep certbot
openssl x509 -in /etc/nginx/ssl/fullchain.pem -noout -checkend 2592000

-checkend 2592000 表示剩余不足 30 天时返回非 0,可接入 Zabbix/Prometheus/云监控告警。Nginx/Apache 续期后必须 reload 才会加载新证书;IIS 导入新 PFX 后要更新绑定;CDN/负载均衡要在控制台更新证书并确认回源。若使用商业证书,记录签发 CA、订单号、联系人;若使用 Let’s Encrypt,保留 80 或 DNS-01 验证通道。每次续期后复查 SAN 是否仍覆盖新增域名,私钥权限是否仍为 600,fullchain 是否仍为叶子在前。证书过期不是安装问题,但缺少续期机制就是运维问题。

常见问题

不包含。你需要提供已签发的证书、私钥、中间证书或 PFX 密码,以及服务器登录信息;服务方负责安装配置与验证。证书可自行购买或使用 Let’s Encrypt,后者有效期 90 天,需配置自动续期。

先看浏览器 Console 是否报 Mixed Content。若页面里仍有 http:// 的图片、JS、CSS,属于程序调用问题,不是证书配置问题;把资源改为 https 或协议相对 URL,必要时加 CSP upgrade-insecure-requests。

通常只安装了叶子证书,缺少中间证书。Nginx 应把叶子证书和中间证书合并为 fullchain 并指向该文件;Apache 2.4.8+ 也使用 fullchain。可用 curl 检查,若报 unable to get local issuer certificate 就是链不完整。

支持有限。Windows Server 2012/IIS 8 起支持 SNI,多站点可共用 443;Windows Server 2008/IIS 7/7.5 通常需要独立 IP 或升级系统。购买前先确认服务器版本和是否支持 SNI。

公开可信证书最长有效期 398 天,Let’s Encrypt 为 90 天。建议用 certbot renew –dry-run 验证自动续期,并配置到期监控;续期后 Nginx/Apache 要 reload,IIS 要更新绑定。

需要域名、证书文件、私钥、中间证书或 PFX 密码、服务器公网 IP、SSH/RDP 登录信息、Web 服务器类型与版本,并确认 80/443 已放行。若使用 CDN 或负载均衡,还要提供控制台权限或回源配置。

内容审核

长期从事 SSL/TLS 证书部署与 HTTPS 运维,负责本站证书选型、安装配置与故障排查内容的编写与审核。