SSL证书申请、安装与配置实战:从域名验证到微信小程序HTTPS上线
问题背景与根因:证书买了却“装不上”,问题出在哪
在云市场里,“SSL 证书安装配置”长期被当成一个纯人工服务项:按域名个数计费、按套餐分档、工作日 9:00-18:00 交付。但从运维视角看,交付标准从来不是“文件传过去了”,而是整条 HTTPS 链路能被浏览器与客户端验证通过。实际工单里八成“装不上”,都可以归到下面五类根因。
- 域名验证未通过:DNS-01 的 TXT 记录没生效或 TTL 未过期;HTTP-01 的
/.well-known/acme-challenge/被 WAF、301 跳转或伪静态规则拦截,CA 侧状态一直是 pending。 - 证书链不完整:只部署了 leaf(服务器证书),没带 intermediate(中间证书)。桌面 Chrome 有 AIA 补链能“自愈”,Android、Java、curl 直接报
unable to get local issuer certificate。 - 私钥与证书不匹配:重签后私钥没同步替换,Nginx 直接启动失败。
- 协议与套件过旧:仍开着 TLS 1.0/1.1,或只配了 CBC 套件,微信小程序与 iOS ATS 直接握手失败。
- 域名与 SAN 不匹配:通配符证书
*.example.com不覆盖裸域example.com,也不覆盖a.b.example.com。
微信小程序侧的硬性要求更明确:必须 HTTPS、必须 443 端口、必须是受信任 CA 签发的证书(自签名一律无效)、TLS 版本不低于 1.2、域名必须完成 ICP 备案并配置到小程序后台的 request 合法域名,且不支持 IP 地址直连。这就是为什么很多站点“浏览器能打开”,小程序却报 request:fail ssl hand shake error。
申请前准备:私钥、CSR 与证书类型怎么定
证书申请的第一步不是填表,而是生成一对只属于你的密钥。私钥永远不要离开自己的服务器,也不要用在线 CSR 生成器——那等于把私钥交给了第三方。
# RSA 2048(兼容性最好)
openssl genrsa -out example.com.key 2048
# 或 ECC P-256(握手更快,现代客户端全支持)
openssl ecparam -name prime256v1 -genkey -noout -out example.com.key
chmod 600 example.com.key
# 生成 CSR,SAN 必须写全,CN 已不再被现代校验逻辑依赖
openssl req -new -sha256 -key example.com.key -out example.com.csr
-subj "/C=CN/ST=Zhejiang/L=Hangzhou/O=Example Ltd/CN=example.com"
-addext "subjectAltName=DNS:example.com,DNS:www.example.com,DNS:api.example.com"
# 回读确认 SAN 与签名
openssl req -in example.com.csr -noout -text | grep -A1 "Subject Alternative Name"
openssl req -in example.com.csr -noout -verify
选型上,单域名证书只保护一个 FQDN;通配符证书保护 *.example.com 这一级,不包含裸域,通常要额外加一个 SAN;多域名(SAN/UCC)证书按域名个数计费——这正是原文“通配符、多域名按具体域名个数付费”的技术原因。IP 证书只有少数 CA 提供,用于保护纯 IP 访问,但微信小程序不支持,做了也没用。
有效期方面,公有 CA 签发的 TLS 服务器证书单张最长 398 天(2020 年 9 月起执行),Let’s Encrypt 免费证书固定 90 天。CA/B Forum 已通过 SC-081 决议,后续将逐步缩短至 200 天(2026-03)、100 天(2027-03)、47 天(2029-03),所以自动续期不是可选项,而是必备能力。
域名验证:DNS-01 与 HTTP-01 实操
CA 必须先确认你控制该域名。三种方式里 DNS-01 最稳(支持通配符、不需要开 80 端口),HTTP-01 最快,文件验证本质与 HTTP-01 相同。
DNS-01 关键点:记录名是 _acme-challenge.example.com,类型 TXT,值由 CA 给出。同一域名同时申请多张证书(比如裸域与通配符)会出现两条同名 TXT,必须合并而不是覆盖。验证前先自查:
dig +short TXT _acme-challenge.example.com @8.8.8.8
dig +short TXT _acme-challenge.example.com @223.5.5.5 # 确认各地递归一致
dig +short CAA example.com # 有 CAA 时必须放行所用 CA
CAA 记录是高频坑:域名下存在 example.com. CAA 0 issue "digicert.com" 时,Let’s Encrypt 会直接拒绝签发,控制台报 CAA record prevents issuance。
HTTP-01 要求在 http://example.com/.well-known/acme-challenge/<token> 返回 token 明文,注意三点:不能被 301 跳到 https(部分 CA 不跟随)、不能返回 404 页面模板、内容必须与 token 完全一致。
用 acme.sh 一条命令走完申请与部署:
curl https://get.acme.sh | sh -s email=ops@example.com
# 方式一:webroot 文件验证
acme.sh --issue -d example.com -d www.example.com --webroot /data/www/example
# 方式二:DNS API 自动验证(以阿里云为例)
export Ali_Key="xxx" Ali_Secret="yyy"
acme.sh --issue -d example.com -d "*.example.com" --dns dns_ali
# 安装到指定路径并设置续期后重载
acme.sh --install-cert -d example.com
--key-file /etc/nginx/ssl/example.com.key
--fullchain-file /etc/nginx/ssl/fullchain.pem
--reloadcmd "nginx -t && nginx -s reload"
安装与配置示例:Nginx / Apache / Tomcat
核心原则:ssl_certificate 指向 fullchain(leaf + 中间证书),ssl_certificate_key 指向私钥,TLS 版本只保留 1.2 与 1.3。
server {
listen 443 ssl http2;
server_name example.com www.example.com;
ssl_certificate /etc/nginx/ssl/fullchain.pem;
ssl_certificate_key /etc/nginx/ssl/example.com.key;
ssl_trusted_certificate /etc/nginx/ssl/chain.pem; # OCSP Stapling 用
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_stapling on;
ssl_stapling_verify on;
resolver 223.5.5.5 8.8.8.8 valid=300s;
add_header Strict-Transport-Security "max-age=31536000" always;
}
server {
listen 80;
server_name example.com www.example.com;
return 301 https://$host$request_uri;
}
Apache 用 SSLCertificateFile(填 fullchain)、SSLCertificateKeyFile、SSLCertificateChainFile(2.4.8+ 可省略),并写 SSLProtocol -all +TLSv1.2 +TLSv1.3。Tomcat 在 server.xml 的 <SSLHostConfig> 中配置 certificateFile、certificateKeyFile、caCertificateFile,协议用 org.apache.coyote.http11.Http11NioProtocol。
同机多站点依赖 SNI:每个 server 块配自己的证书即可,若有极老客户端(XP 时代)会拿到默认证书并报域名不匹配,这类流量现在可以放弃。改完先 nginx -t 再 nginx -s reload,不要 restart,避免连接中断。
证书链:为什么“电脑正常、手机报错”
这是最典型的“半成功”状态。浏览器访问正常,是因为 Chrome 会顺着证书里的 AIA 地址去下载中间证书;Android WebView、Java 的 HttpClient、部分 curl 版本不做这件事,于是报错。
# 拼接顺序:服务器证书在前,中间证书在后,根证书不要放
cat server.crt intermediate.crt > fullchain.pem
# 校验链是否闭合
openssl verify -CAfile /etc/ssl/certs/ca-certificates.crt
-untrusted intermediate.crt server.crt
# 期望输出:server.crt: OK
# 直接看线上到底发了几张证书
openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null 2>/dev/null | grep -c "BEGIN CERTIFICATE"
返回 1 说明只部署了 leaf,必须补中间证书;返回 2 或 3 属正常。把根证书一起下发是另一个常见错误:握手包变大,部分客户端反而认为链有问题。
排查顺序固定为:先用 openssl s_client 看服务端究竟发了什么,再用 openssl verify 判断链是否闭合,最后才怀疑客户端。若站点前面有 CDN 或 WAF(阿里云、腾讯云、Cloudflare),证书要在控制台上传,源站证书对终端用户不可见,改源站不解决问题。
选型对比:验证等级、覆盖范围与验证方式
选型决策可以拆成三个正交维度:验证等级、覆盖范围、验证方式。下面三张表可以直接对照自己的场景取交集。
| 类型 | 验证内容 | 签发时长 | 浏览器表现 | 适用场景 |
|---|---|---|---|---|
| DV 域名型 | 仅验证域名控制权 | 分钟级~1 小时 | 锁图标 | 小程序、API、内部系统、个人站点 |
| OV 组织型 | 域名 + 企业工商信息 | 1~3 个工作日 | 锁图标,点开可见企业名 | 企业官网、电商、对外门户 |
| EV 扩展型 | 域名 + 企业 + 严格人工核验 | 3~7 个工作日 | 主流浏览器已不再显示绿色地址栏 | 金融、支付等强合规场景 |
| 覆盖类型 | 保护范围 | 是否覆盖裸域 | 计费口径 |
|---|---|---|---|
| 单域名 | example.com | 是(仅此一个) | 1 个域名 |
| 通配符 | *.example.com | 否,需额外加 SAN | 1 个域名(不含裸域) |
| 多域名 SAN | 多个不同 FQDN | 按配置 | 按实际域名个数 |
| IP 证书 | https://1.2.3.4 | — | 按 IP 个数 |
| 验证方式 | 需开 80 端口 | 支持通配符 | 失败高发原因 |
|---|---|---|---|
| DNS-01(TXT) | 否 | 是 | TXT 未合并、TTL 未过期、CAA 拦截 |
| HTTP-01 | 是 | 否 | 301 跳转、WAF 拦截、伪静态规则 |
| 文件验证 | 是 | 否 | 上传目录错误、权限 403 |
再补一组免费与商业的取舍:Let’s Encrypt 有效期 90 天、免费、支持通配符、无赔付;商业 DV 通常 1 年(受 398 天上限约束)、带签发错误赔付与工单支持;OV/EV 才有企业身份信息。小程序只校验“受信任 CA 签发 + TLS 版本”,DV 完全够用,不必为图标多花钱。
常见错误排查:真实报错与定位命令
下面这些报错都来自真实工单,按出现频率排序,附定位命令。
1. Nginx 启动失败
nginx: [emerg] cannot load certificate "/etc/nginx/ssl/fullchain.pem": BIO_new_file() failed (SSL: error:0200100D:system library:fopen:Permission denied)
多为 SELinux 或文件权限问题:chmod 644 fullchain.pem; chmod 600 example.com.key;SELinux 环境执行 restorecon -Rv /etc/nginx/ssl 或 chcon -t httpd_cert_t /etc/nginx/ssl/*。
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)
对比两者模数 MD5:openssl x509 -noout -modulus -in fullchain.pem | openssl md5 与 openssl rsa -noout -modulus -in example.com.key | openssl md5,不一致说明换了证书没换私钥。
3. curl 报证书链问题
curl: (60) SSL certificate problem: unable to get local issuer certificate
服务端没发中间证书,按上一节拼接 fullchain 后 reload。
4. 域名不匹配
curl: (60) SSL: no alternative certificate subject name matches target host name 'api.example.com'
用 openssl x509 -in fullchain.pem -noout -text | grep -A1 "Subject Alternative Name" 核对 SAN,注意通配符只覆盖一级。
5. 浏览器 NET::ERR_CERT_DATE_INVALID / NET::ERR_CERT_AUTHORITY_INVALID
前者是证书过期或服务器时间错误(date -u 与 NTP 同步检查),后者是自签名或根证书不受信。
6. 小程序 request:fail ssl hand shake error
依次检查:TLS 是否 ≥1.2(openssl s_client -connect example.com:443 -tls1_2 能否成功)、证书链是否完整、域名是否在 request 合法域名中、是否误用了 IP 或非 443 端口。
效果验证与自动化续期
# 看证书主体、签发者、有效期
openssl s_client -connect example.com:443 -servername example.com </dev/null 2>/dev/null | openssl x509 -noout -subject -issuer -dates
# 强制 TLS1.2 握手,验证小程序兼容性
openssl s_client -connect example.com:443 -servername example.com -tls1_2 </dev/null 2>&1 | grep "Protocol|Cipher"
# HTTP 跳转与 HSTS
curl -sI http://example.com | head -3
curl -sI https://example.com | grep -i strict-transport-security
# 剩余天数监控(30 天内返回非 0 则告警)
openssl s_client -connect example.com:443 -servername example.com </dev/null 2>/dev/null | openssl x509 -noout -checkend 2592000
自动化续期:certbot 先用 certbot renew --dry-run 演练,再配 --deploy-hook "nginx -s reload";acme.sh 安装时已写入 crontab(用 crontab -l | grep acme 确认),并靠 --reloadcmd 在续期后自动重载。证书更新后别忘了同步 CDN、WAF、负载均衡上的证书,否则源站换了、边缘还是旧的。
最后用 SSL Labs 打分复核:curl "https://api.ssllabs.com/api/v3/analyze?host=example.com&publish=off&startNew=on",目标 A 及以上;出现 Chain issues: Incomplete 就是链没拼好。
常见问题
SSL 证书最长能用多久?
公有 CA 签发的 TLS 服务器证书单张最长 398 天,Let’s Encrypt 固定 90 天。CA/B Forum 的 SC-081 决议将逐步缩短到 200 天(2026-03)、100 天(2027-03)、47 天(2029-03),所以必须把续期做成自动化,而不是靠人工记日期。
通配符证书能保护二级子域名吗?
不能。*.example.com 只匹配 a.example.com 这一级,不匹配 a.b.example.com,也不包含裸域 example.com。要覆盖裸域需要额外加一个 SAN;要覆盖多级子域名只能分别申请或使用多域名证书。
微信小程序对证书有什么硬性要求?
四点:必须是受信任 CA 签发的证书(自签名、私有 CA 无效);TLS 版本不低于 1.2;必须走 443 端口且证书链完整;域名已完成 ICP 备案并配置到小程序后台的 request 合法域名,不支持 IP 直连。DV 证书即可满足,无需 OV/EV。
为什么电脑上访问正常,手机或小程序却报证书错误?
九成是证书链不完整。桌面浏览器会通过 AIA 自动补中间证书,Android WebView、Java 客户端不会。用 openssl s_client -showcerts 看返回的证书数量,只有 1 张就把中间证书拼进 fullchain 再 reload。
更换证书后需要重启 Web 服务吗?
不需要重启,nginx -t && nginx -s reload 平滑重载即可,连接不会中断。但 CDN、WAF、SLB 上的证书必须在各自控制台上单独更新,否则边缘节点仍在用旧证书。
IP 地址可以申请 SSL 证书吗?
可以,部分 CA 提供 IP 证书,用于保护纯 IP 的 HTTPS 访问。但微信小程序不支持 IP 直连,若目标是小程序,必须使用域名证书并完成备案。