跳到主要内容
ssl证书按装

CA证书 HTTPS 配置服务实战:小程序 HTTPS、301 跳转与 Nginx/Apache 部署续期指南

CA证书 HTTPS 配置服务实战:小程序 HTTPS、301 跳转与 Nginx/Apache 部署续期指南 — CA证书 HTTPS 配置服务实战:小程序 HTTPS、301 跳转与 Nginx/Apache 部署续期指南

问题背景与根因:小程序、苹果 ATS 与证书有效期规则

微信小程序要求 request 合法域名使用 HTTPS,且服务端 TLS 版本不低于 1.2;iOS 的 ATS 默认拦截明文 HTTP。原文把证书描述为“默认一年”,这在公共信任 CA 场景已不准确:2020-09-01 后签发的公共 SSL/TLS 证书最长有效期 398 天,Let’s Encrypt 默认 90 天,必须靠自动续期而不是手工年检。HTTPS 配置失败的根因通常不是“证书没买”,而是域名解析、TXT/HTTP 验证、证书链、443 安全组、TLS 版本五类问题叠加。先做基线检查:dig +short A domain.com、curl -I http://domain.com、openssl s_client -connect domain.com:443 -servername domain.com -tls1_2 </dev/null。云上 ECS 要在安全组入方向放行 TCP 80 和 443,80 用于 ACME 验证与 301 跳转,443 用于业务 HTTPS;系统防火墙还要执行 firewall-cmd --add-service=https --permanent; firewall-cmd --reload 或 ufw allow 443/tcp。若只开 443 不开 80,HTTP-01 验证会超时;若证书链缺中间证书,浏览器可能正常而小程序报 request:fail ssl handshake error。广告劫持多发生在明文 HTTP 或弱 TLS 配置上,启用 HTTPS、301 跳转与 HSTS 后才能显著降低注入面。本节先建立“域名—端口—TLS—证书链”的排查顺序,后续再落地申请与配置。

证书类型与选型对比:DV、OV、EV、单域名、多域名、通配符

原文的 DV/OV/EV 分类仍成立,但 EV 的浏览器地址栏公司名展示已弱化,主流浏览器不再普遍显示绿色企业名,金融电商不必为“地址栏公司名”盲目上 EV。DV 只验证域名控制权,常用 DNS TXT 或 HTTP 文件,分钟级签发,适合小程序、个人站、API;OV 验证企业工商信息,通常 3-5 个工作日,证书详情含企业信息;EV 验证更严格,价格和周期更高。有效期方面,公共信任 CA 证书最长 398 天,Let’s Encrypt 90 天,商业 CA 也需按 398 天上限签发。覆盖范围要分清:单域名只保护一个 FQDN;多域名 SAN 可放多个域名;通配符 *.domain.com 只覆盖一级子域,不覆盖 domain.com 和多级 a.b.domain.com,通常要加 SAN。选型表如下。

类型 验证内容 签发周期 浏览器展示 适用场景
DV 域名控制权(TXT/HTTP) 分钟级 普通锁标志 小程序、个人站、API
OV 企业工商信息 3-5 个工作日 锁+证书详情企业信息 企业门户、官网
EV 扩展严格验证 更长 公司名展示已弱化 金融、电商合规场景
证书 覆盖示例 不覆盖
单域名 domain.com www.domain.com
多域名 SAN domain.com、www.domain.com、api.domain.com 未列出的域名
通配符 *.domain.com domain.com、a.b.domain.com

检查 CSR 中的 SAN:openssl req -text -noout -in domain.csr | grep DNS;查 TXT:dig +short TXT _acme-challenge.domain.com。建议:小程序/个人站选 DV 单域名或通配符;企业门户选 OV;银行等按合规要求选 EV。证书最长 398 天,必须规划自动续期。

申请前准备与域名验证:域名、TXT、CSR、安全组

购买或申请 CA 证书前,准备三样:域名管理权限(能加 TXT 解析)、服务器操作系统与 Web 软件版本(Nginx/Apache/IIS/Tomcat 及版本)、ECS 安全组和系统防火墙。中国大陆服务器还需确认域名备案与解析生效。先验证解析:dig +short A domain.com、dig +short A www.domain.com;TXT 验证要查 dig +short TXT _acme-challenge.domain.com,TTL 建议 600,传播期间不要删除旧记录。商业 CA 需要 CSR,可用 OpenSSL 生成私钥和 CSR:openssl req -new -newkey rsa:2048 -nodes -keyout domain.key -out domain.csr -subj '/C=CN/ST=Guangdong/L=Shenzhen/O=Example/CN=domain.com' -addext 'subjectAltName=DNS:domain.com,DNS:www.domain.com';检查 CSR:openssl req -text -noout -in domain.csr。私钥权限设为 600,CSR 交给 CA 签发,私钥绝不上传。Let’s Encrypt 可跳过手工 CSR,用 acme.sh 或 certbot 自动完成 HTTP-01/DNS-01。HTTP-01 要求 80 端口可访问且 /.well-known/acme-challenge/ 返回 200;DNS-01 适合通配符,需在域名商添加 TXT。ECS 安全组入方向放行 80/443,源地址按业务最小化;系统防火墙同步放行。验证命令:curl -I http://domain.com/.well-known/acme-challenge/test 应返回 404 或 200 而不是连接超时。

Nginx 完整实操:acme.sh 申请、安装证书、301 跳转与 TLS 优化

以 Let’s Encrypt DV 证书为例,用 acme.sh 的 webroot 模式,证书默认 90 天,后续自动续期。安装并注册账户:curl https://get.acme.sh | sh -s email=ops@example.com;签发双域名:~/.acme.sh/acme.sh --issue -d domain.com -d www.domain.com --webroot /var/www/html --keylength ec-256;安装到 Nginx 路径并设置重载:~/.acme.sh/acme.sh --install-cert -d domain.com --key-file /etc/nginx/ssl/domain.key --fullchain-file /etc/nginx/ssl/fullchain.pem --reloadcmd 'systemctl reload nginx'。必须使用 fullchain,否则缺中间证书。Nginx 配置示例:

server {
 listen 80;
 server_name domain.com www.domain.com;
 location /.well-known/acme-challenge/ { root /var/www/html; }
 location / { return 301 https://$host$request_uri; }
}
server {
 listen 443 ssl http2;
 server_name domain.com www.domain.com;
 ssl_certificate /etc/nginx/ssl/fullchain.pem;
 ssl_certificate_key /etc/nginx/ssl/domain.key;
 ssl_protocols TLSv1.2 TLSv1.3;
 ssl_ciphers 'ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-ECDSA-AES256-GCM-SHA384:ECDHE-RSA-AES256-GCM-SHA384';
 ssl_prefer_server_ciphers on;
 ssl_session_cache shared:SSL:10m;
 add_header Strict-Transport-Security 'max-age=31536000; includeSubDomains' always;
 location / { root /var/www/html; index index.html; }
}

执行 nginx -t 通过后 systemctl reload nginx。私钥权限 chmod 600 /etc/nginx/ssl/domain.key。HSTS 首次上线建议 max-age 先 86400,确认全站 HTTPS 后再加到 31536000。301 跳转只放在 80 的 server 块,443 内不要再跳 https,否则循环。

Apache、IIS、Tomcat 配置示例与差异

Apache 的 80 跳转与 443 配置:<VirtualHost *:80> Redirect permanent / https://domain.com/ </VirtualHost>;443 虚拟主机启用 SSLEngine on、SSLCertificateFile /etc/httpd/ssl/fullchain.pem、SSLCertificateKeyFile /etc/httpd/ssl/domain.key,协议设为 SSLProtocol all -SSLv3 -TLSv1 -TLSv1.1,并加 Header always set Strict-Transport-Security 'max-age=31536000';改完执行 apachectl configtest; systemctl reload httpd。IIS 需要导入含私钥的 PFX,PFX 要包含中间证书,站点绑定 443 并勾选 SNI;用 netsh http show sslcert 核对绑定,HTTP 跳转用 URL Rewrite 或单独 80 站点。Tomcat 用 JKS/PKCS12:keytool -importkeystore -srckeystore domain.pfx -srcstoretype PKCS12 -destkeystore domain.jks -deststoretype JKS;server.xml 的 Connector 设置 port='8443' SSLEnabled='true' scheme='https' secure='true' keystoreFile='/opt/tomcat/conf/domain.jks' keystorePass='***' SSLProtocol='TLSv1.2,TLSv1.3',重启 Tomcat。差异表:Nginx 用 PEM fullchain + reload;Apache 用 PEM fullchain + configtest;IIS 用 PFX + netsh;Tomcat 用 JKS/PKCS12 + 重启。常见坑:IIS 只导叶子证书导致链不完整;Tomcat 把 fullchain 当私钥;Apache 未加载 ssl_module。

常见错误排查:真实报错与定位命令

报错 1:nginx: [emerg] SSL_CTX_use_PrivateKey_file('/etc/nginx/ssl/domain.key') failed (SSL: error:0B080074:x509 certificate routines:X509_check_private_key:key values mismatch),说明证书与私钥不匹配。分别取模比对:openssl x509 -noout -modulus -in fullchain.pem | openssl md5 与 openssl rsa -noout -modulus -in domain.key | openssl md5,两个 MD5 必须一致。报错 2:curl: (60) SSL certificate problem: unable to get local issuer certificate,是证书链不完整,Nginx 改用 fullchain.pem,IIS 重新导出含中间证书的 PFX。报错 3:Verify error:Invalid response from http://domain.com/.well-known/acme-challenge/xxx: 404,检查 webroot 是否指向站点根、Nginx 是否放行 /.well-known/acme-challenge/,用 curl -I http://domain.com/.well-known/acme-challenge/test 复现。报错 4:curl: (7) Failed to connect to domain.com port 443: Connection timed out,查安全组、ss -lntp | grep 443、firewall-cmd --list-ports。报错 5:小程序 request:fail ssl handshake error,用 openssl s_client -connect domain.com:443 -servername domain.com -tls1_2 </dev/null 验证 TLS1.2,并检查 SAN 是否含请求域名。报错 6:301 循环,检查 443 server 块是否又 return 301 https://...,反代时看 X-Forwarded-Proto。排查顺序:端口通→TLS 握手→证书链→域名匹配→应用层。

效果验证与自动续期:openssl、curl、HSTS 与监控

验证 301:curl -I http://domain.com 应返回 301 且 Location: https://domain.com/;验证 HTTPS:curl -I https://domain.com 返回 200。查看证书主体、签发者、有效期:openssl s_client -connect domain.com:443 -servername domain.com -showcerts </dev/null 2>/dev/null | openssl x509 -noout -subject -issuer -dates。验证 TLS1.2 可用:echo | openssl s_client -connect domain.com:443 -servername domain.com -tls1_2;验证 TLS1.1 应失败:echo | openssl s_client -connect domain.com:443 -servername domain.com -tls1_1。续期:acme.sh 安装时会写 cron,执行 ~/.acme.sh/acme.sh --cron 测试;certbot 用 certbot renew --dry-run。监控剩余天数:openssl x509 -checkend 2592000 -noout -in /etc/nginx/ssl/fullchain.pem; echo $?,返回 0 表示 30 天内不过期,返回 1 应告警。HSTS 用 add_header Strict-Transport-Security 'max-age=31536000; includeSubDomains' always;,上线前确认所有子域 HTTPS 可用。OCSP stapling 可选:ssl_stapling on; ssl_stapling_verify on;。最后把证书到期、443 探测、301 检查纳入监控。

常见问题

原文说证书默认一年,现在还能签发一年吗?

不能按公共信任 CA 的旧规则理解。2020-09-01 后公共 SSL/TLS 证书最长有效期 398 天,Let’s Encrypt 为 90 天,商业 CA 也受上限约束。应使用 acme.sh/certbot 自动续期,并监控剩余 30 天。

小程序提示 request:fail ssl handshake error 怎么排查?

先确认域名已加入小程序 request 合法域名且为 HTTPS;用 openssl s_client -connect domain.com:443 -servername domain.com -tls1_2 </dev/null 验证 TLS1.2;再查 fullchain 是否含中间证书、SAN 是否匹配请求域名、ECS 安全组 443 是否放行。

通配符证书能覆盖哪些域名?

*.domain.com 覆盖 www.domain.com、api.domain.com 等一级子域,不覆盖 domain.com,也不覆盖 a.b.domain.com。需要把主域名加入 SAN,多级子域另配证书或多域名 SAN。

免费 DV 与付费 OV/EV 怎么选?

小程序、个人站、API 用 DV 即可,Let’s Encrypt 可自动化;企业门户需要证书详情展示企业信息可选 OV;银行、金融按合规要求选 EV,但不要期待主流浏览器继续显示绿色公司名。

301 跳转配置后为什么 HTTPS 也跳转或循环?

检查 443 的 server 块是否又写了 return 301 https://...;反代场景检查后端是否强制跳转、X-Forwarded-Proto 是否传递;只应在 80 的 server 块做 HTTP 到 HTTPS 的 301。

ECS 安全组已开 443 仍超时怎么办?

继续查系统防火墙 firewall-cmd --list-ports 或 ufw status、Nginx 是否监听 0.0.0.0:443(ss -lntp | grep 443)、负载均衡/NAT 回源端口、域名解析是否指向该 ECS 公网 IP。

内容审核

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