跳到主要内容
Comodo SSL证书

SSL证书申请、安装与HTTPS配置实战:Nginx/Apache/IIS、微信小程序与证书链排错

SSL证书申请、安装与HTTPS配置实战:Nginx/Apache/IIS、微信小程序与证书链排错 — SSL证书申请、安装与HTTPS配置实战:Nginx/Apache/IIS、微信小程序与证书链排错

问题背景与根因

微信小程序、iOS ATS 和现代浏览器都把 HTTPS 作为基础能力。小程序 request 合法域名必须是 HTTPS 域名,不能使用 IP、localhost 或自签名证书;真机报错常见为 request:fail ssl hand shake error。根因通常不是没装证书,而是证书链不完整、域名与 SAN 不匹配、TLS 版本过低、证书过期或服务器时间错误。公开信任的 TLS 证书由受信任 CA 签发,客户端只信任内置根证书库,所以服务器必须下发服务器证书和中间证书。Nginx 用 fullchain.pem,Apache 用 SSLCertificateChainFile 或 fullchain。自 2020 年起,主流浏览器要求公开 TLS 证书有效期不超过 398 天;Let’s Encrypt 免费证书有效期为 90 天。所谓二年证书通常是多年度订阅,到期前需重新签发并替换,不能把单张证书用到两年。快速判断:openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null。

证书类型、有效期与选型对比表

SSL 域名数字证书按验证级别分为 DV、OV、EV:DV 只验证域名控制权,签发快,适合个人站点、API 和小程序后端;OV 验证组织加域名,适合企业门户;EV 验证更严格,但现代浏览器已不再在地址栏展示绿色公司名,不能把 EV 当作 UI 卖点。按覆盖范围分为单域名、多域名 SAN 和通配符。通配符 *.example.com 只覆盖一级,不覆盖 example.com 和 a.b.example.com,需要额外加 SAN。公开证书最长 398 天,Let’s Encrypt 为 90 天,多年度产品应按订阅理解。

类型 验证内容 典型签发 地址栏表现 适用场景 有效期
DV 域名控制权 分钟级 锁标识 博客、小程序 API 不超过 398 天
OV 组织加域名 1-5 工作日 锁标识 企业门户 不超过 398 天
EV 严格组织审核 3-7 工作日 不再显示绿色公司名 金融、电商 不超过 398 天
Let’s Encrypt DV 域名控制权 自动 锁标识 自动化、测试 90 天

申请与域名验证完整实操

先在服务器生成私钥和 CSR,SAN 必须写全主域名和 www。OpenSSL 1.1.1+ 可直接用 -addext,老版本需写配置文件。命令如下:

openssl version
mkdir -p /etc/ssl/private/example.com
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'
openssl req -in example.com.csr -noout -text | grep -A1 'Subject Alternative Name'
chmod 600 example.com.key

在 CA 控制台提交 CSR 后做 DNS TXT 验证。商业 CA 常用 _dnsauth,Let’s Encrypt 用 _acme-challenge。用公共 DNS 检查记录是否生效,并等待 TTL:

dig +short TXT _dnsauth.example.com @8.8.8.8
dig +short TXT _acme-challenge.example.com @8.8.8.8

签发后下载服务器证书和中间证书,按“服务器证书在前、中间证书在后”合并,并检查有效期与 SAN:

cat example.com.crt intermediate.crt > fullchain.pem
openssl x509 -in fullchain.pem -noout -dates -subject -issuer -ext subjectAltName

Nginx 配置示例与 HTTPS 跳转

Nginx 必须让 ssl_certificate 指向 fullchain.pem,ssl_certificate_key 指向私钥。80 端口强制跳转 443,TLS 只开 1.2 和 1.3。Nginx 1.25.1+ 建议用 http2 on;,旧版可用 listen 443 ssl http2;。HSTS 要等全站和子域都 HTTPS 后再加。

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/nginx/ssl/fullchain.pem;
    ssl_certificate_key /etc/nginx/ssl/example.com.key;
    ssl_protocols TLSv1.2 TLSv1.3;
    ssl_ciphers HIGH:!aNULL:!MD5;
    ssl_session_cache shared:SSL:10m;
    ssl_session_timeout 10m;
    add_header Strict-Transport-Security max-age=31536000 always;
    location / {
        proxy_pass http://127.0.0.1:8080;
    }
}

执行 nginx -t && systemctl reload nginx 后,用 curl -I https://example.com 和 openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null 检查握手与证书链。若返回 301 到 https 且 s_client 输出至少两张证书,说明基本配置正确。

Apache、IIS、Tomcat 配置示例

Apache 2.4 典型配置如下,SSLCertificateFile 放服务器证书,SSLCertificateChainFile 放中间证书;2.4.8+ 也可把 fullchain 放进 SSLCertificateFile 并省略 ChainFile。修改后执行 apachectl configtest && systemctl reload httpd。

<VirtualHost *:443>
    ServerName example.com
    SSLEngine on
    SSLCertificateFile /etc/httpd/ssl/example.com.crt
    SSLCertificateKeyFile /etc/httpd/ssl/example.com.key
    SSLCertificateChainFile /etc/httpd/ssl/intermediate.crt
    Protocols h2 http/1.1
</VirtualHost>

IIS 在 certlm.msc 导入 PFX,确认中间证书进入“中间证书颁发机构”,再在站点绑定 443 并勾选 SNI。Tomcat 用 keytool 转 JKS 或直接配 PKCS12,Connector 示例:

keytool -importkeystore -srckeystore example.com.pfx -srcstoretype PKCS12 -destkeystore example.com.jks -deststoretype JKS
<Connector port='443' protocol='org.apache.coyote.http11.Http11NioProtocol' SSLEnabled='true' scheme='https' secure='true' keystoreFile='/opt/tomcat/conf/example.com.jks' keystorePass='***' clientAuth='false' sslProtocol='TLS'/>

微信小程序 HTTPS 与证书链要求

微信小程序 HTTPS 解决的核心不是“买最贵证书”,而是域名、证书链、TLS 版本三项同时达标。request 合法域名必须在微信公众平台配置,使用 HTTPS 域名,不能填 IP 或 localhost;证书必须由受信任 CA 签发,SAN 包含请求域名,服务器下发完整中间链;TLS 至少 1.2,禁用 1.0/1.1。开发者工具可临时关闭校验,但真机不会放宽。排查时执行:

openssl s_client -connect api.example.com:443 -servername api.example.com -tls1_2 </dev/null
curl -vI https://api.example.com

若 s_client 只输出一张证书,通常缺中间证书;若报 hostname mismatch,检查 SAN 是否包含 api.example.com;若报 handshake failure,检查 TLS 版本和加密套件。iOS ATS 还要求 TLS 1.2 与前向保密套件,建议启用 ECDHE-RSA-AES128-GCM-SHA256 等等价套件。

常见错误排查(含真实报错)

curl: (60) SSL certificate problem: unable to get local issuer certificate:缺中间证书或链顺序错误,把 fullchain.pem 配到 Nginx,Apache 补 SSLCertificateChainFile。NET::ERR_CERT_COMMON_NAME_INVALID 或 SSL_ERROR_BAD_CERT_DOMAIN:SAN 不含当前域名,重新签发并加入 www 或 api。nginx: [emerg] PEM_read_bio_X509_AUX(…) while loading certificate:证书不是 PEM、文件为空或私钥不匹配,用 openssl x509 -in fullchain.pem -noout -subject 检查。x509: certificate has expired or is not yet valid:证书过期或服务器时间错误,执行 date -u 并校时。ERR_SSL_VERSION_OR_CIPHER_MISMATCH:客户端只支持旧 TLS 或套件不匹配,检查 ssl_protocols 与 ssl_ciphers。request:fail ssl hand shake error:小程序侧优先查域名配置、证书链和 TLS 1.2。统一用 openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null 与 curl -vI https://example.com 定位。

效果验证与自动化续期

验证分三层:HTTP 状态、证书链、证书内容。命令如下:

curl -sS -o /dev/null -w '%{http_code} %{ssl_verify_result}' https://example.com
echo | openssl s_client -connect example.com:443 -servername example.com 2>/dev/null | openssl x509 -noout -dates -subject -issuer -ext subjectAltName
echo | openssl s_client -connect example.com:443 -servername example.com -showcerts 2>/dev/null | grep -c 'BEGIN CERTIFICATE'
curl -sI https://example.com | grep -i strict-transport-security

证书数量建议大于等于 2,ssl_verify_result 为 0 表示校验通过。Let’s Encrypt 用 certbot 自动续期:certbot renew --dry-run,生产环境加部署钩子 certbot renew --deploy-hook 'systemctl reload nginx'。Let’s Encrypt 90 天有效期,建议剩余 30 天前续期;商业证书不超过 398 天,多年度订阅也要在到期前重新签发替换。最后用 SSL Labs 或 openssl s_client 复测,确保无过期、无缺链、无协议过低。

常见问题

微信小程序必须使用 OV 或 EV 证书吗?

不需要。DV 证书只要由受信任 CA 签发、SAN 匹配、证书链完整、TLS 1.2+,小程序即可正常请求。OV/EV 主要增加组织验证,不解决技术握手问题。

SSL 证书最长有效期是多久?

公开信任的 TLS 证书自 2020 年起最长不超过 398 天,Let’s Encrypt 为 90 天。所谓二年证书通常是多年度订阅,需按 CA 要求重新签发,不能把单张证书连续使用两年。

通配符证书能覆盖几级域名?

*.example.com 只覆盖 www.example.com、api.example.com 等一级子域,不覆盖 example.com,也不覆盖 a.b.example.com。主域名和二级子域要额外加入 SAN。

浏览器显示证书有效,为什么小程序仍握手失败?

常见原因是中间证书缺失、TLS 1.0/1.1 未关闭、请求域名未加入小程序合法域名、服务器时间错误。用 openssl s_client 检查证书数量和握手协议。

证书安装后需要重启 Web 服务器吗?

Nginx 用 nginx -t 检查后 systemctl reload nginx 即可;Apache 用 apachectl configtest 后 graceful 或 reload。只有更换监听端口、模块等结构性变更才需要重启。

如何快速检查证书链是否完整?

执行 openssl s_client -connect 域名:443 -servername 域名 -showcerts,输出应包含服务器证书和中间证书;再用 curl -vI 或 SSL Labs 复测,ssl_verify_result 应为 0。

内容审核

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