SSL证书申请与HTTPS加密实战:通配符证书防劫持、Nginx/Apache配置及iOS微信小程序兼容
问题背景与根因:HTTP 明文、通配符证书与移动端兼容
网站仍用 http:// 时,登录表单、Cookie、API 请求都以明文经过运营商、公共 Wi-Fi 或代理节点,容易被插入广告、劫持下载链接或篡改支付跳转。HTTPS 通过 TLS 加密和证书身份校验解决传输安全,但“装了证书”不等于“全站安全”:浏览器地址栏出现三角警告,常见根因是页面混用 http:// 的 JS/CSS/图片;iOS 与微信小程序报错,常见根因是证书链不完整、TLS 版本过低或域名不在合法域名列表。
通配符证书 *.example.com 只覆盖同一级子域名,例如 api.example.com、m.example.com,不覆盖 example.com 本身,也不覆盖 a.b.example.com;因此申请时通常同时写入 example.com 与 *.example.com 两个 SAN。通配符必须用 DNS-01 验证,CA 会检查 _acme-challenge.example.com 的 TXT 记录。当前公开信任证书单张有效期上限为 398 天,Let’s Encrypt 为 90 天,证书签发后进入 Certificate Transparency 日志,域名写错通常无法撤回。检查现状可执行:
curl -I http://example.com
openssl s_client -connect example.com:443 -servername example.com -tls1_2 </dev/null
curl -I https://example.com
若第一条没有 301/308 跳转、第二条握手失败、第三条报证书错误,就应先修证书与 TLS 配置,再处理混合内容和小程序域名白名单。
申请前准备:域名、DNS、服务器与证书选型
先确认三件事:域名解析可控、服务器有 80/443 入站权限、Web 服务器支持 SNI。传统 CA 需要 CSR,ACME 自动化可省略 CSR;无论哪种方式,私钥都必须在自己的服务器生成并保管,不要发给客服或第三方。检查环境:
openssl version
nginx -V 2>&1 | grep -E 'TLS|ssl'
apache2ctl -M | grep ssl
java -version
dig +short A example.com
dig +short AAAA example.com
建议使用 RSA 2048 或 ECDSA P-256;RSA 兼容性最好,ECDSA 握手更快但老 Android/iOS 需评估。若用传统 CA,生成 CSR 与私钥:
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'
openssl req -in example.com.csr -noout -text | grep -A1 'Subject Alternative Name'
CSR 的 CN 只写一个域名,实际覆盖范围以 SAN 为准,通配符申请要把 example.com 和 *.example.com 都写入 SAN。DNS 验证需要能添加 TXT 记录;使用阿里云、腾讯云、Cloudflare 等 API 时,建议创建仅限该域名 DNS 编辑权限的子账号,不要把主账号密钥写进脚本。服务器侧先备份 Nginx/Apache 配置,确认 443 未被防火墙拦截:firewall-cmd --add-service=https --permanent 或 ufw allow 443/tcp。
完整实操步骤:用 acme.sh 申请通配符证书并自动续期
以阿里云 DNS API 为例,先安装 acme.sh 并切换 Let’s Encrypt。不要把密钥提交到 Git;生产前可加 --staging 测试,避免触发速率限制。
curl https://get.acme.sh | sh -s email=admin@example.com
source ~/.bashrc
export Ali_Key='你的AccessKeyId'
export Ali_Secret='你的AccessKeySecret'
~/.acme.sh/acme.sh --set-default-ca --server letsencrypt
~/.acme.sh/acme.sh --issue --dns dns_ali -d example.com -d '*.example.com' --keylength ec-256
签发过程中 acme.sh 会自动写入 _acme-challenge.example.com 的 TXT 记录并等待传播。若失败,先查解析:
dig +short TXT _acme-challenge.example.com
~/.acme.sh/acme.sh --issue --dns dns_ali -d example.com -d '*.example.com' --debug
成功后安装到固定路径,并让 Nginx 重载。Let’s Encrypt 有效期 90 天,acme.sh 会安装 cron 自动续期,续期后通过 reloadcmd 生效:
mkdir -p /etc/nginx/ssl
~/.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 'nginx -s reload'
crontab -l | grep acme.sh
单域名站点也可用 Certbot HTTP-01:certbot certonly --webroot -w /var/www/html -d www.example.com --email admin@example.com --agree-tos --no-eff-email。HTTP-01 不能签通配符;通配符必须 DNS-01。传统 CA 的 HTML 文件验证只证明目录可控,签发后同样要检查 SAN、有效期和证书链。
配置示例:Nginx、Apache 与 Tomcat/IIS 证书转换
Nginx 必须同时写 example.com 和 *.example.com,否则主域名会落到默认站点。证书文件用 fullchain,不要只用叶子证书。示例:
server {
listen 80;
server_name example.com *.example.com;
return 301 https://$host$request_uri;
}
server {
listen 443 ssl http2;
server_name example.com *.example.com;
ssl_certificate /etc/nginx/ssl/example.com.fullchain.pem;
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_stapling on;
ssl_stapling_verify on;
ssl_trusted_certificate /etc/nginx/ssl/example.com.fullchain.pem;
add_header Strict-Transport-Security 'max-age=31536000; includeSubDomains' always;
root /var/www/html;
index index.html;
}
Apache 关键指令:SSLEngine on、SSLCertificateFile 指向 fullchain、SSLCertificateKeyFile 指向私钥,并关闭 TLS 1.0/1.1:
<VirtualHost *:443>
ServerName example.com
ServerAlias *.example.com
SSLEngine on
SSLCertificateFile /etc/httpd/ssl/example.com.fullchain.pem
SSLCertificateKeyFile /etc/httpd/ssl/example.com.key
SSLProtocol all -SSLv3 -TLSv1 -TLSv1.1
SSLCipherSuite HIGH:!aNULL:!MD5:!3DES
Header always set Strict-Transport-Security 'max-age=31536000; includeSubDomains'
</VirtualHost>
Tomcat/IIS 使用同一张证书转换格式:openssl pkcs12 -export -out example.com.pfx -inkey example.com.key -in example.com.fullchain.pem -passout pass:ChangeMe123;Tomcat 可用 PKCS12 或 keytool -importkeystore 转 JKS。IIS 导入 PFX 后在“站点绑定”中选择 HTTPS 并勾选 SNI。配置完先 nginx -t 或 apachectl configtest,再 reload。
证书类型、验证方式与有效期对比
选证书不要只看价格,先看覆盖范围与验证方式。下表可用于选型和验收:
| 类型 | 覆盖范围 | 验证方式 | 有效期/续期 | 适用场景 |
|---|---|---|---|---|
| 单域名 DV | www.example.com 或 example.com 一个主机名 | HTTP-01 或 DNS-01 | 最长 398 天;LE 90 天自动续 | 单站点、测试环境 |
| 通配符 DV | *.example.com 一级子域名,不含主域名和三级域名 | 必须 DNS-01 | 最长 398 天;LE 90 天 | 多子域 API、后台、活动页 |
| 多域名 SAN | 一张证书写多个不同域名,通常 2-100 个 | HTTP-01/DNS-01 | 最长 398 天 | 多品牌、多主域 |
| OV/EV | 单域或多域,含组织审核 | 组织资料+域名验证 | 最长 398 天 | 金融、政企展示 |
| Let’s Encrypt | 单域、多域、通配符 | HTTP-01/DNS-01 | 90 天,建议提前 30 天续 | 自动化、成本敏感 |
验收时重点看 SAN 是否包含主域名、证书链是否完整、TLS 是否至少 1.2。通配符证书不能跨域,也不能覆盖 example.com;如果小程序请求 https://api.example.com,证书 SAN 必须有 api.example.com 或匹配的 *.example.com。Let’s Encrypt 速率限制按“完全相同域名集合”计算,频繁删建会触发 too many certificates already issued for exact set of domains,应先用 staging 测试。
常见错误排查:真实报错与修复命令
先分清是证书问题、链问题还是混合内容。以下报错在浏览器、curl、Nginx 和 ACME 客户端中很常见:
| 报错/现象 | 根因 | 修复 |
|---|---|---|
| curl: (60) SSL: no alternative certificate subject name matches target host name | SAN 不含当前域名,或通配符层级不匹配 | 重新签发并把主域名与 *.example.com 写入 SAN;检查 openssl x509 -noout -ext subjectAltName |
| NET::ERR_CERT_AUTHORITY_INVALID / unable to get local issuer certificate | 只部署了叶子证书,缺少中间证书 | Nginx 用 fullchain.pem;用 openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null 检查链 |
| nginx: [emerg] SSL_CTX_use_PrivateKey_file … key values mismatch | 证书与私钥不配对 | 比对 modulus:openssl x509 -noout -modulus -in cert.pem | openssl md5 与私钥结果一致 |
| Mixed Content: The page at https://… was loaded over HTTPS, but requested an insecure script http://… | 页面引用 HTTP 资源 | 改为 https:// 或协议相对 //;F12 Console 逐条清理 |
| DNS problem: NXDOMAIN looking up TXT for _acme-challenge.example.com | TXT 未添加、加错主机记录或未传播 | dig +short TXT _acme-challenge.example.com;等待 TTL 后重试 |
| request:fail url not in domain list | 微信小程序后台未配置合法域名,或使用了未备案/非 HTTPS 域名 | 在小程序后台添加 request 合法域名,使用 443 端口和受信任证书 |
Nginx 配置错误先执行 nginx -t;Apache 执行 apachectl configtest。若浏览器提示 ERR_SSL_VERSION_OR_CIPHER_MISMATCH,检查是否只开了 TLS 1.0 或证书算法不被客户端支持。iOS 老设备对 SHA-1、1024 位 RSA 和 TLS 1.0 不兼容,应使用 SHA-256、RSA 2048 以上并启用 TLS 1.2。
效果验证:命令行、浏览器与微信/iOS 实测
不要只放一个 https.html 能打开就认为完成,那只能证明 443 可访问。按下面顺序验收:
curl -I http://example.com
curl -I https://example.com
curl -v https://example.com 2>&1 | grep -E 'SSL connection|TLS'
openssl s_client -connect example.com:443 -servername example.com -showcerts /dev/null | openssl x509 -noout -subject -issuer -dates -ext subjectAltName
openssl s_client -connect example.com:443 -servername example.com -tls1_2 /dev/null | grep 'Protocol'
curl -sI https://example.com | grep -i strict-transport-security
curl -I https://api.example.com
第一条应返回 301 或 308 并指向 https;第二条返回 200;subjectAltName 应包含 example.com 与 *.example.com;TLS 1.2 握手应成功;HSTS 头应存在。再用 openssl s_client -connect example.com:443 -servername example.com -status </dev/null | grep -A1 'OCSP response' 查看 OCSP Stapling 是否为 successful。浏览器 F12 的 Console 不应出现 Mixed Content,Security 面板应显示证书有效、连接安全。
微信小程序在开发者工具中调用 wx.request({url:'https://api.example.com/health'}),真机预览再测一次;后台 request 合法域名需逐个子域配置,不能填 *.example.com(以平台当前规则为准),且不能使用 IP、localhost 或自签证书。iOS 端重点看 ATS:证书需受信任、SHA-256、TLS 1.2 以上、完整链。最后用 SSL Labs 或 testssl.sh https://example.com 做外部扫描,确认没有 TLS 1.0/1.1、弱套件和证书链缺失。
常见问题
通配符证书能覆盖主域名和三级域名吗?
不能。*.example.com 只匹配一级子域名,如 api.example.com;不匹配 example.com,也不匹配 a.b.example.com。申请时把 example.com 与 *.example.com 一起写入 SAN;三级域名要单独加入或再签一张 *.b.example.com。证书有效期最长 398 天,Let’s Encrypt 为 90 天,需自动续期。
证书签发后还能退款或换域名吗?
公开信任证书签发后会写入 Certificate Transparency 日志,通常无法撤回或退款。域名写错应重新签发。建议先用 Let’s Encrypt staging 或 acme.sh –staging 验证 DNS API、TXT 记录和 Web 服务器配置,再跑生产签发。
HTTPS 会影响速度和稳定性吗?
现代服务器上 TLS 1.3、会话复用和 OCSP Stapling 带来的 CPU 开销很小。真正导致“变慢或变形”的通常是混合内容、外链 HTTP JS/CSS、证书链不完整或 TLS 版本不兼容。启用 HTTP/2、压缩和缓存后,HTTPS 通常不比 HTTP 慢。
微信小程序和 iOS 需要什么证书?
使用受信任 CA 签发的 DV 证书即可,不要求 OV/EV;必须 HTTPS、TLS 1.2 以上、SHA-256、证书链完整。小程序后台配置 request 合法域名,不能使用自签证书、IP 或未备案域名;iOS ATS 会拒绝明文 HTTP 和弱 TLS。
如何自动续期并避免过期?
acme.sh 安装时会写 cron,Let’s Encrypt 证书 90 天有效,建议到期前 30 天续。执行 ~/.acme.sh/acme.sh --cron --home ~/.acme.sh 可手动测试;Certbot 用 certbot renew --dry-run。续期后必须 reload Nginx/Apache,否则新证书不会加载。
Tomcat、IIS 能用同一张证书吗?
可以。Nginx/Apache 用 PEM 私钥和 fullchain;Tomcat/IIS 用 PFX:openssl pkcs12 -export -out example.com.pfx -inkey example.com.key -in example.com.fullchain.pem -passout pass:ChangeMe123。Tomcat 也可用 keytool 转 JKS。导入后绑定 443 并启用 SNI,再用 openssl s_client 验证证书链和域名。