SSL证书申请、安装与续期实战:小程序 HTTPS 部署与排错指南
围绕 SSL 证书代购、过期续费、HTTPS 证书安装配置部署服务,本文按可执行步骤讲清申请、部署、续期和排错。
问题背景与根因:为什么小程序和现代浏览器强制 HTTPS
微信小程序、Apple ATS、主流浏览器和搜索引擎都在收紧 HTTP 入口。小程序要求请求域名使用 HTTPS,证书必须被系统信任,域名需加入小程序后台合法域名;iOS ATS 默认要求 TLS 1.2 及以上。HTTP 明文还会带来登录态、支付回调、下载包被劫持和插入广告的风险。很多“证书装了但打不开”的根因不是证书本身,而是:只开了 80 未开 443、安全组/防火墙拦截、证书链不完整、SAN 未包含 www、私钥与证书不匹配、HTTP 未 301 到 HTTPS、TLS 版本过低或域名未备案/未加入合法域名。排查时先用 curl -I http://example.com 看是否 301,再用 curl -vI https://example.com 看握手和证书链,最后检查 ss -lntp | grep 443 与云安全组。证书是信任入口,部署链路任何一环缺失都会表现为浏览器告警或小程序 request:fail。
证书类型与选型:DV/OV/EV、单域名/多域名/通配符及有效期
公网受信任 TLS 证书自 2020-09-01 起最长有效期 398 天,Let’s Encrypt 免费证书为 90 天,必须自动化续期。按验证等级分:DV 仅验证域名控制权,几分钟签发;OV 验证企业身份,通常 1-5 个工作日;EV 执行更严格组织验证,但现代浏览器已取消地址栏绿色公司名展示,EV 主要用于合规和品牌信任,不应再宣传“地址栏显示公司名”。按覆盖范围分:单域名只保护一个 FQDN;多域名/SAN 可在一张证书放多个域名;通配符 *.example.com 只覆盖同一级子域名,不覆盖 a.b.example.com。选型上,个人站、API、小程序后端先用 DV;企业门户、需要组织信息展示选 OV;金融、电商若合同要求可选 EV。不要为“看起来高级”牺牲自动化,续期失败比等级更致命。
| 类型 | 验证内容 | 签发时间 | 适用场景 |
|---|---|---|---|
| DV | 域名控制权 | 几分钟到数小时 | 个人站、API、小程序后端 |
| OV | 企业身份+域名 | 1-5 个工作日 | 企业门户、SaaS |
| EV | 严格组织验证 | 数天到数周 | 金融、电商合规场景 |
申请前准备:域名、DNS、CSR、安全组与服务器信息
申请前确认域名解析指向目标服务器,80 和 443 在云安全组与系统防火墙均放行;HTTP-01 验证需要 80 可访问,DNS-01 需要能添加 TXT 记录,TLS-ALPN-01 使用 443。准备域名管理权限、服务器操作系统与 Web 软件版本(Nginx/Apache/IIS/Tomcat)、联系人邮箱。若手工生成 CSR,使用 SAN 而非只写 CN:
openssl req -new -newkey rsa:2048 -nodes -keyout example.com.key -out example.com.csr -subj '/CN=example.com' -addext 'subjectAltName=DNS:example.com,DNS:www.example.com'
检查 CSR:openssl req -in example.com.csr -noout -text | grep -A2 SubjectAltName。云上 ECS 还要确认 443 入方向规则来源为 0.0.0.0/0 或业务所需网段,IPv6 用户同时检查 ::/0。若使用 CDN/WAF,证书应上传到 CDN 节点并在源站配置回源协议,否则只改源站会出现边缘证书与源站证书不一致。
完整实操步骤:用 Certbot 或 acme.sh 申请并自动续期
以 Nginx + Ubuntu/Debian 为例,先安装并申请。Webroot 方式要求站点根目录可写验证文件:
sudo apt update && sudo apt install -y certbot python3-certbot-nginx
sudo certbot certonly --webroot -w /var/www/html -d example.com -d www.example.com --email admin@example.com --agree-tos --no-eff-email
sudo certbot renew --dry-run
若用 acme.sh,可免 root 安装并自动部署:
curl https://get.acme.sh | sh -s email=admin@example.com
~/.acme.sh/acme.sh --issue -d example.com -d www.example.com --webroot /var/www/html
~/.acme.sh/acme.sh --install-cert -d example.com --key-file /etc/nginx/ssl/example.com.key --fullchain-file /etc/nginx/ssl/example.com.fullchain.pem --reloadcmd 'systemctl reload nginx'
Let’s Encrypt 证书 90 天,Certbot 的 systemd timer 会每日检查并在到期前 30 天续期;acme.sh 默认安装 cron。不要只申请不验证续期,执行 systemctl list-timers | grep certbot 和 crontab -l 确认任务存在。DNS-01 适合通配符:acme.sh –issue –dns dns_ali -d example.com -d ‘*.example.com’,需先在服务商 API 配置密钥。
Nginx/Apache 配置示例与 HTTP 301 跳转
Nginx 将 80 强制跳转 443,并加载 fullchain 与私钥:
server {
listen 80;
server_name example.com www.example.com;
return 301 https://$host$request_uri;
}
server {
listen 443 ssl http2;
server_name example.com www.example.com;
ssl_certificate /etc/letsencrypt/live/example.com/fullchain.pem;
ssl_certificate_key /etc/letsencrypt/live/example.com/privkey.pem;
ssl_protocols TLSv1.2 TLSv1.3;
ssl_ciphers HIGH:!aNULL:!MD5;
add_header Strict-Transport-Security max-age=31536000 always;
root /var/www/html;
index index.html;
}
Apache 需启用 ssl、headers 模块:
<VirtualHost *:80>
ServerName example.com
Redirect permanent / https://example.com/
</VirtualHost>
<VirtualHost *:443>
SSLEngine on
SSLCertificateFile /etc/letsencrypt/live/example.com/fullchain.pem
SSLCertificateKeyFile /etc/letsencrypt/live/example.com/privkey.pem
SSLProtocol all -SSLv3 -TLSv1 -TLSv1.1
Header always set Strict-Transport-Security max-age=31536000
</VirtualHost>
改完执行 nginx -t && systemctl reload nginx 或 apachectl configtest && systemctl reload apache2。HSTS 先短 max-age 验证,确认全站 HTTPS 后再加长;不要在还有 HTTP 资源的站点直接上长周期 HSTS。
证书部署、续期与云上配置对比表
不同部署方式的关键差异如下。手工上传适合 IIS、Tomcat 和 CDN;ACME 客户端适合 Nginx/Apache 自动化;云厂商托管证书适合负载均衡和 WAF,但要注意私钥托管与自动续期。安全组至少放行 80(HTTP-01 和跳转)与 443;仅开 443 会导致 HTTP-01 失败,仅开 80 会导致 HTTPS 超时。CDN 场景要同时检查边缘证书、回源协议和源站证书。若采用 SSL 证书代购或托管服务,交付物应包含证书链、私钥、到期日、续期方式和部署验证报告。
| 方式 | 适用 | 续期 | 主要风险 |
|---|---|---|---|
| 手工上传 | IIS、Tomcat、CDN | 人工提醒 | 过期、链不全 |
| Certbot | Nginx/Apache | systemd timer | 80 被占用、路径错 |
| acme.sh | 通配符、多 DNS | cron+install-cert | API 密钥权限过大 |
| 云托管 | SLB/WAF/CDN | 平台自动 | 边缘与源站不一致 |
常见错误排查(含真实报错)
按报错定位比反复重装有效。1)curl: (60) SSL certificate problem: unable to get local issuer certificate:多为只部署了站点证书,未部署中间证书,Nginx 用 fullchain.pem,Apache 用 SSLCertificateChainFile 或 fullchain。2)NET::ERR_CERT_COMMON_NAME_INVALID 或 SSL_ERROR_BAD_CERT_DOMAIN:SAN 不含当前域名,重新签发时同时加 example.com 和 www.example.com。3)nginx: [emerg] SSL_CTX_use_PrivateKey(…) failed (SSL: … key values mismatch):证书与私钥不匹配,用 openssl x509 -noout -modulus -in cert.pem | openssl md5 与 openssl rsa -noout -modulus -in key.pem | openssl md5 比对。4)certbot: Problem binding to port 80: Could not bind to IPv4 or IPv6:80 被 Nginx 占用,改用 –webroot 或 –nginx。5)acme.sh: DNS problem: NXDOMAIN looking up TXT for _acme-challenge.example.com:TXT 未生效或域名写错,dig TXT _acme-challenge.example.com +short 检查。6)小程序 request:fail url not in domain list:后台合法域名未配置或证书链不受信任。
效果验证与上线检查清单
部署后依次验证证书、跳转、端口和业务。查看证书主题、签发者、有效期和 SAN:
openssl s_client -connect example.com:443 -servername example.com </dev/null 2>/dev/null | openssl x509 -noout -subject -issuer -dates -ext subjectAltName
curl -I https://example.com
curl -I http://example.com
ss -lntp | grep 443
预期结果:openssl 输出 notAfter 在有效期内且 SAN 含两个域名;https 返回 200/301;http 返回 301 且 Location 为 https;443 处于 LISTEN。再用浏览器开发者工具看 Security 是否无混合内容,用 SSL Labs 或 myssl 检查链、协议和评级。小程序需在后台配置 request 合法域名,真机走一遍登录、支付回调、文件下载。续期演练执行 certbot renew –dry-run,并确认 reload 命令生效;最后检查 HSTS、TLS 1.0/1.1 已关闭、旧证书文件无残留。
常见问题
SSL 证书还能买一年吗?
公网受信任证书单张最长 398 天,Let’s Encrypt 为 90 天。所谓“一年服务”通常是托管服务期,不等于单张证书有效期,必须配置自动续期。
免费 DV 和付费 DV 有区别吗?
加密强度没有本质区别,都使用相同 TLS 协议。差异主要在品牌信任、赔付条款、技术支持、签发方式和被拦截率;业务关键系统建议同时做好监控和自动续期。
通配符证书能覆盖三级域名吗?
不能。*.example.com 覆盖 a.example.com,不覆盖 a.b.example.com。三级域名需要单独写入 SAN 或再签一张通配符。
换证书后需要重启服务器吗?
不需要重启整机。Nginx 用 nginx -t 后 systemctl reload nginx,Apache 用 apachectl configtest 后 systemctl reload apache2;IIS 可重新绑定证书。重载前务必备份旧配置。
为什么 HTTP 能开、HTTPS 打不开?
优先查 443 安全组、系统防火墙、Web 服务是否 listen 443、证书路径权限和证书链。用 ss -lntp | grep 443 与 curl -vI https://域名 定位。
小程序只配 HTTPS 就够吗?
不够。域名需加入小程序后台合法域名,国内服务器通常需 ICP 备案,证书需被系统信任,TLS 建议 1.2 及以上,且不能使用 IP 或未配置端口。