跳到主要内容
ssl证书按装

SSL 证书安装与全站 HTTPS 配置实战:从 CSR 生成、Nginx/Apache/IIS 部署到报错排查

SSL 证书安装与全站 HTTPS 配置实战:从 CSR 生成、Nginx/Apache/IIS 部署到报错排查 — 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 天,必须自动化续期:

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 节点。

内容审核

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