HTTPS SSL 证书安装配置全流程:从证书申请、Nginx 与宝塔部署到过期预警
为什么“一键 HTTPS”经常失败:现象背后的五类根因
在宝塔、wdcp 等面板上点完“一键 HTTPS”后,最常见的三类反馈是:Chrome 地址栏报 NET::ERR_CERT_AUTHORITY_INVALID;微信小程序后台保存 request 合法域名时提示域名校验失败;iOS App 在 ATS 校验下直接拒绝连接。这些现象并不都是“证书没签发成功”,多数是部署链路中的细节问题。
第一类根因是证书链不完整:服务器只下发了叶证书(leaf certificate),没有拼接中间证书(intermediate CA)。桌面浏览器通常能靠 AIA 扩展自动补齐,但 Android 旧版本、微信内置 WebView、Java 客户端、iOS ATS 往往补不齐,于是直接判定证书不可信。第二类是私钥与证书不匹配,常见于重复申请后把新证书配到了旧私钥上。第三类是域名覆盖不全:只签了 example.com 却同时解析了 www.example.com,或者买了 *.example.com 却不知道通配符不覆盖裸域,也不覆盖 a.b.example.com 这类二级子域。第四类是混合内容(Mixed Content):页面本身 HTTPS 了,但引用的图片、JS、iframe 仍是 http://,浏览器依旧标记为不安全。第五类是系统时间偏差或 SNI 未开启,时间偏差会导致 certificate is not yet valid,多站点共用 IP 未开 SNI 则会返回默认站点的证书。
动手前先跑三条诊断命令,能定位八成问题:
# 1. 查看服务端实际下发的证书链、有效期与颁发者
openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null 2>/dev/null
| openssl x509 -noout -subject -issuer -dates
# 2. 校验证书与私钥是否配对(两条输出的 MD5 必须完全一致)
openssl x509 -noout -modulus -in /etc/nginx/ssl/example.com.pem | openssl md5
openssl rsa -noout -modulus -in /etc/nginx/ssl/example.com.key | openssl md5
# 3. 从客户端视角看握手结果,ssl_verify_result 为 0 才正常
curl -sS -o /dev/null -w "%{http_code} %{ssl_verify_result}n" https://example.com
如果第 1 条命令只输出一张证书、issuer 是中间 CA 而不是根 CA,基本可确认链不完整。此时把 fullchain 文件(叶证书 + 中间证书,顺序不能颠倒)配到 ssl_certificate 即可。注意不要把根证书也拼进去:多拼根证书会增大握手包体积,部分客户端还会因为链中出现自签根而告警。
证书选型:DV、OV、通配符与 398 天有效期规则
选证书先看三个维度:验证等级、域名覆盖、有效期。验证等级上,DV(域名验证)只校验域名控制权,签发快;OV(组织验证)需要企业营业执照与电话核验,证书详情里带企业名称,适合电商、支付、政企门户;EV 证书的浏览器地址栏特殊标识已被主流浏览器移除,其实际价值主要体现在合规审计上。域名覆盖上,单域名证书只保护一个 FQDN;多域名(SAN)证书可在一张证书里放 10~100 个域名;通配符证书保护 *.example.com 这一级的所有子域,但不包含裸域 example.com,也不包含 a.b.example.com,实际采购时建议做成 example.com + *.example.com 的组合。
有效期是容易被忽视的合规点:按 CA/B 论坛规定,自 2020 年 9 月 1 日起,所有公有信任 CA 签发的 SSL/TLS 证书最长有效期不得超过 398 天,市面上所谓“买三年”只是签发一张 398 天证书加两次免费重签。Let’s Encrypt 的免费证书有效期固定为 90 天,必须依赖自动续期,人工续期必然出事。这也是免费证书与付费证书最大的运维差异。
无论走哪种渠道,最终都要生成一对私钥和 CSR。推荐用 ECDSA P-256(握手更快、包更小),兼容性要求高时用 RSA 2048:
# ECDSA P-256 私钥 + CSR(含 SAN,OpenSSL 1.1.1+ 支持 -addext)
openssl ecparam -genkey -name prime256v1 -out example.com.key
openssl req -new -key example.com.key -out example.com.csr
-subj "/C=CN/ST=Zhejiang/L=Hangzhou/O=Example Tech/CN=*.example.com"
-addext "subjectAltName=DNS:*.example.com,DNS:example.com"
# 提交给 CA 前自检 SAN 是否正确
openssl req -in example.com.csr -noout -text | grep -A1 "Subject Alternative Name"
CSR 里只包含公钥和主体信息,私钥始终留在自己服务器上,任何要求你上传私钥的“代购”都应立即拒绝。证书签发完成后,务必索要 fullchain(完整链)而非单张 crt。
实操一:用 acme.sh 申请 Let’s Encrypt 通配符证书并自动续期
免费证书的正确用法是“申请一次,之后永不手动干预”。acme.sh 是当前最稳妥的 ACME v2 客户端,支持 HTTP-01 与 DNS-01 两种验证。关键规则:签通配符只能用 DNS-01,因为 Let’s Encrypt 无法对 *.example.com 做文件验证。
# 1. 安装(自动写入 cron,每天 00:00 检查续期)
curl https://get.acme.sh | sh -s email=ops@example.com
source ~/.bashrc
# 2A. 单域名/多域名:HTTP-01 文件验证,需 80 端口可访问
acme.sh --issue -d example.com -d www.example.com -w /www/wwwroot/example.com
# 2B. 通配符:DNS-01 验证,以阿里云 DNS 为例(其他厂商换成 dns_dgon / dns_cf / dns_dp)
export Ali_Key="LTAI5t********"
export Ali_Secret="****************"
acme.sh --issue --dns dns_ali -d example.com -d "*.example.com" --keylength ec-256
# 3. 把证书安装到固定路径,并设置续期成功后自动 reload
acme.sh --install-cert -d example.com --ecc
--key-file /etc/nginx/ssl/example.com.key
--fullchain-file /etc/nginx/ssl/example.com.fullchain.pem
--reloadcmd "nginx -t && systemctl reload nginx"
# 4. 查看托管列表与到期时间,必要时强制重签
acme.sh --list
acme.sh --renew -d example.com --force --ecc
三个坑要提前避开:其一,DNS API 的 AccessKey 建议使用只有 DNS 解析权限的 RAM 子账号,不要用主账号密钥;其二,--install-cert 是必须的,只有执行过它,续期后新证书才会被复制到 Nginx 目录并触发 reload,否则续期成功但线上仍是旧证书;其三,acme.sh 默认使用 ZeroSSL 作为 CA,如需固定 Let’s Encrypt 可加 --server letsencrypt。验证续期链路是否真的通,用 acme.sh --renew -d example.com --force 手动跑一次,然后看 openssl s_client 输出的 notAfter 是否变化。
实操二:Nginx 与 Apache 的生产级配置示例
证书装好只是第一步,协议版本与加密套件决定了 SSL Labs 评级和客户端的兼容性。下面这份 Nginx 配置开启了 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; # Nginx 1.25.1+ 写法;旧版本用 listen 443 ssl http2;
server_name example.com www.example.com;
ssl_certificate /etc/nginx/ssl/example.com.fullchain.pem; # 必须是 fullchain
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;
ssl_session_tickets off;
ssl_stapling on;
ssl_stapling_verify on;
ssl_trusted_certificate /etc/nginx/ssl/example.com.fullchain.pem;
resolver 223.5.5.5 119.29.29.29 valid=300s;
add_header Strict-Transport-Security "max-age=31536000; includeSubDomains" always;
add_header X-Content-Type-Options nosniff always;
}
Apache 2.4.8 及以上版本不再需要单独的 SSLCertificateChainFile,直接把 fullchain 指向 SSLCertificateFile 即可:
<VirtualHost *:443>
ServerName example.com
SSLEngine on
SSLCertificateFile /etc/httpd/ssl/example.com.fullchain.pem
SSLCertificateKeyFile /etc/httpd/ssl/example.com.key
SSLProtocol -all +TLSv1.2 +TLSv1.3
SSLCipherSuite ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256
SSLHonorCipherOrder off
Header always set Strict-Transport-Security "max-age=31536000"
</VirtualHost>
两个参数要特别注意:ssl_stapling 必须配合 ssl_trusted_certificate 和可用的 resolver,否则 Nginx 会打印 "ssl_stapling" ignored, issuer certificate not found 并静默失效;HSTS 的 max-age 首次上线建议先用 300 秒试跑一周,确认全站子域都支持 HTTPS 后再改到 31536000,否则一旦有子域只有 HTTP,回滚会非常痛苦。改完配置务必 nginx -t && nginx -s reload,热加载不会中断现有连接。
实操三:宝塔面板部署与微信小程序、iOS ATS 的对接验证
宝塔面板的路径是:网站 → 设置 → SSL → Let’s Encrypt → 选择验证方式。单域名可用“文件验证”,通配符必须选“DNS 验证”,且要提前在面板设置 → API 接口里配置好 DNS 服务商密钥。签发成功后证书落在 /www/server/panel/vhost/cert/example.com/,其中 fullchain.pem 与 privkey.pem 就是 Nginx 需要的两个文件。面板的“强制 HTTPS”本质是往 vhost 里写 301 跳转,但不会自动补 HSTS 和 OCSP,需要手工在配置里加。续期方面,宝塔的计划任务里会生成一条 acme_v2.py 的定时任务,务必确认它处于启用状态。
微信小程序与 iOS App 对证书的要求比浏览器严格得多。微信公众平台 → 开发管理 → 开发设置 → 服务器域名 → request 合法域名,要求:必须是 HTTPS、TLS 版本 ≥ 1.2、证书由受信任 CA 签发(自签名一律不行)、证书链完整、域名不能是 IP、端口默认为 443。iOS 的 ATS(App Transport Security)还额外要求前向保密套件(ECDHE)和 SHA-256 以上签名算法。用下面两条命令模拟客户端视角检查:
# 检查 TLS 1.2 是否可用、协商出的套件是否为 ECDHE + AES-GCM
openssl s_client -connect example.com:443 -servername example.com -tls1_2 </dev/null 2>/dev/null
| grep -E "Protocol|Cipher"
# 检查完整链是否能被系统信任库验证通过(返回 0 即通过)
curl -sS -o /dev/null -w "%{http_code} %{ssl_verify_result}n" https://example.com/
如果浏览器正常但小程序仍报错,九成是链不完整或中间证书缺失,可把域名丢进 SSL Labs 看 Chain Issues 一栏是否显示 Incomplete。另一个高频问题是 CDN:源站换了新证书但 CDN 回源仍是旧证书,或 CDN 边缘节点证书未同步,此时需要在 CDN 控制台重新上传证书并刷新。最后别忘了检查页面里的混合内容,可用浏览器控制台过滤 Mixed Content,或在 Nginx 里加 add_header Content-Security-Policy "upgrade-insecure-requests" always; 强制升级。
- SSL域名证书申请 · 小程序证书 · 国外SSL证书
- HTTPS证书申请 · SSL证书安装部署 · 证书续费
- 代购 SSL 证书 · DigiCert / GeoTrust / RapidSSL 单域名与通配符
方案对比:免费 DV、商业通配符与代维安装怎么选
把成本、有效期、运维投入放在一起对比,选型就没有争议了。下表价格为市场参考区间,实际以 CA 与代理商报价为准:
| 方案 | 典型有效期 | 验证方式 | 域名覆盖 | 参考价格 | 适用场景 |
|---|---|---|---|---|---|
| Let’s Encrypt DV | 90 天(自动续期) | HTTP-01 / DNS-01 | 单域名、多域名 SAN、通配符 | 0 元 | 个人站、测试环境、内部系统 |
| 商业 DV 单域名 | 最长 398 天 | DNS / 文件 | 1 个 FQDN | 100–300 元/年 | 不想维护 ACME 脚本的小站 |
| 商业通配符 DV | 最长 398 天 | DNS | *.example.com 一级子域 | 950 元/年(含安装配置) | 多子域业务、SaaS 平台 |
| OV 企业型 | 最长 398 天 | 企业实名核验 | 单域名 / 多域名 | 1000–3000 元/年 | 电商、支付、政企门户 |
| 代维安装与配置 | — | — | — | 300 元/次 | 无运维人力、迁移割接 |
再看部署方式的差异,这决定了长期运维成本:
| 部署方式 | 上手难度 | 续期方式 | 是否支持通配符 | 风险点 |
|---|---|---|---|---|
| 面板一键部署 | 低 | 面板计划任务 | 需先配 DNS 接口 | 面板升级可能覆盖 vhost 配置 |
| acme.sh 脚本 | 中 | cron 自动 + reloadcmd | 支持(DNS-01) | 忘记 –install-cert 导致续期不生效 |
| 手动 CSR + 商业证书 | 高 | 人工重签 | 支持 | 398 天到期遗忘,直接全站不可用 |
结论很直接:只要服务器能跑 shell,优先 acme.sh + 通配符,成本为零且续期全自动;如果业务方要求证书主体显示企业名称(合规审计、招投标),再上 OV;如果确实没有运维人力,花 300 元买一次代维安装并让对方把自动续期和过期预警一起配好,比每年到期前手忙脚乱要划算得多。
常见报错排查:从报错原文到修复命令
下面这些报错是 SSL 部署现场出现频率最高的,按原文对照即可定位:
curl: (60) SSL certificate problem: unable to get local issuer certificate—— 证书链不完整。修复:ssl_certificate改指向 fullchain 文件,用cat example.com.crt intermediate.crt > fullchain.pem拼接,顺序必须是叶证书在前。nginx: [emerg] SSL_CTX_use_PrivateKey_file("/etc/nginx/ssl/a.key") failed (SSL: error:0B080074:x509 certificate routines:X509_check_private_key:key values mismatch)—— 私钥与证书不配对。用前文的 modulus 命令比对,不匹配就重新签发,不要试图“修”证书。nginx: [emerg] cannot load certificate "/etc/nginx/ssl/a.pem": BIO_new_file() failed (SSL: error:0200100D:system library:fopen:Permission denied)—— 文件权限问题。执行chmod 600 a.key && chown root:root a.key,并确保 nginx worker 用户对证书目录有读权限(SELinux 开启时还需chcon -t httpd_config_t)。Problem binding to port 80: Could not bind to IPv4 or IPv6.—— acme.sh 用 standalone 模式时 80 端口被 Nginx 占用。改用-w文件验证,或临时systemctl stop nginx后签发。Error creating new order :: too many failed authorizations recently: see https://letsencrypt.org/docs/rate-limits/—— 触发 Let’s Encrypt 限流,同一账户对同一域名每小时失败 5 次即封禁 1 小时。等待后先用--dry-run演练。nginx: [warn] "ssl_stapling" ignored, issuer certificate not found for certificate—— 缺ssl_trusted_certificate或resolver。补上 fullchain 路径和resolver 223.5.5.5 valid=300s;。NET::ERR_CERT_DATE_INVALID—— 证书过期或服务器时间错误。用timedatectl status检查,chronyc makestep强制校时。curl: (51) SSL: no alternative certificate subject name matches target host name 'www.example.com'—— 域名不在 SAN 列表里。重新签发时把裸域与 www 都加进-d参数。
排查顺序建议固定为:先 openssl s_client 看服务端发了什么 → 再 curl -vI 看客户端验证结果 → 最后查 Nginx error.log。切忌一上来就重装证书,很多时候重装会把本来正确的私钥覆盖掉,反而制造新问题。
效果验证:评级、协议探测与过期预警脚本
配置完成后不能只看浏览器绿锁,要做三层验证。第一层是协议与套件探测:
# TLS 1.3 是否可用
openssl s_client -connect example.com:443 -servername example.com -tls1_3 </dev/null 2>/dev/null | grep Protocol
# 枚举所有支持的加密套件,确认没有 RC4/3DES/CBC 等弱套件
nmap --script ssl-enum-ciphers -p 443 example.com
# 检查 HSTS 与证书链完整性评级
curl -sI https://example.com | grep -i strict-transport-security
curl -s "https://api.ssllabs.com/api/v3/analyze?host=example.com&all=done&publish=off"
| jq -r '.endpoints[] | "(.ipAddress) (.grade)"'
目标是 SSL Labs 评级 A 及以上,出现 Chain issues: Incomplete 或 This server supports weak Diffie-Hellman 必须处理。第二层是业务侧验证:小程序后台保存域名、iOS 真机首启、支付宝开放平台回调地址都要各测一遍,因为它们的信任库和协议要求与桌面浏览器不同。
第三层,也是长期最关键的一层:过期预警。证书过期导致的全站不可用属于典型的“零容错事故”,用一段十行的脚本挂到 crontab 每天跑一次即可:
#!/bin/bash
# /usr/local/bin/ssl_check.sh —— 每天 09:00 执行,剩余不足 15 天告警
for d in example.com www.example.com api.example.com; do
end=$(echo | openssl s_client -servername "$d" -connect "$d":443 2>/dev/null
| openssl x509 -noout -enddate | cut -d= -f2)
left=$(( ( $(date -d "$end" +%s) - $(date +%s) ) / 86400 ))
echo "$d 剩余 ${left} 天,到期时间:$end"
[ "$left" -lt 15 ] && echo "WARN: $d 证书将在 ${left} 天后过期" | mail -s "SSL 到期告警" ops@example.com
done
如果已有 Prometheus,用 blackbox_exporter 的 probe_ssl_earliest_cert_expiry 指标配合 (probe_ssl_earliest_cert_expiry - time()) / 86400 < 15 规则更规范。预警阈值建议设三级:30 天提醒、15 天警告、7 天升级到值班群,确保在证书失效前一定有人处理。
常见问题
免费证书和付费证书在浏览器里显示有区别吗?
没有区别。Chrome、Safari、Edge 对所有公有 CA 签发的证书一律显示同样的锁形标识,EV 证书的绿色公司名展示已被主流浏览器取消。真正的差异在有效期(Let’s Encrypt 90 天 vs 商业证书最长 398 天)、保障赔付、验证等级(DV/OV)、是否提供人工技术支持。选择时应该看运维能力和合规要求,而不是看浏览器图标。
买了 *.example.com 通配符证书,为什么访问 example.com 还报证书错误?
通配符只匹配一级子域,不匹配裸域,也不匹配 a.b.example.com。解决办法是在签发时把裸域一起加进 SAN,例如 acme.sh --issue --dns dns_ali -d example.com -d "*.example.com",这样一张证书同时覆盖裸域和所有一级子域。如果还需要二级子域,得单独再加 *.api.example.com 这样的条目。
Let’s Encrypt 只有 90 天,能不能申请更长的免费证书?
不能。ACME 协议下的免费证书有效期由 CA 策略固定为 90 天,且业界趋势是继续缩短。正确做法不是找“更长”的免费证书,而是把续期完全自动化:acme.sh 安装时会自动写入 cron,配合 --install-cert 的 --reloadcmd,续期、拷贝、热加载全链路无人值守。真正需要长有效期的场景(如嵌入式设备、无法跑脚本的设备)才考虑 398 天的商业证书。
证书装好后浏览器仍提示“此页面部分内容不安全”怎么办?
这是混合内容问题,不是证书问题。打开开发者工具 Console,过滤 Mixed Content 就能看到具体是哪些 http 资源。修复方式:把页面内的图片、JS、CSS、iframe 地址全部改成相对协议或 https;在 Nginx 加 add_header Content-Security-Policy "upgrade-insecure-requests" always; 让浏览器自动升级请求;数据库里存的历史 http 链接用 SQL 批量替换 http:// 为 https://。
服务器换 IP 或迁移机房,需要重新签发证书吗?
不需要。SSL 证书绑定的是域名,与 IP 无关。迁移时只需把私钥文件与 fullchain 文件一起复制到新服务器,保持路径一致后 reload 即可。唯一要注意的是:如果原服务器还在运行,先停掉再切 DNS,避免两台机器上的 acme.sh 定时任务同时续期造成 DNS 记录冲突;迁移完成后记得在新机器上重新执行一次 acme.sh --install-cert 以重建 cron 与 reloadcmd。
一台服务器上有多个不同域名,可以共用一张证书吗?
可以,用多域名 SAN 证书,把多个 FQDN 写进同一张证书的 SAN 列表,Nginx 里配置一个 server 块或多个 server 块引用同一对证书文件即可。但要注意两点:SAN 数量越多,单次握手传输的证书体积越大;更重要的是证书与域名是公开可见的,把不相关的业务域名塞进同一张证书会泄露资产清单,安全上并不推荐,按业务线拆分成多张通配符证书更合适。